Package com.pulumi.aws.ec2.inputs

Class GetAmiArgs

  • public final class GetAmiArgs
extends com.pulumi.resources.InvokeArgs

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  GetAmiArgs.Builder  

      • Nested classes/interfaces inherited from class com.pulumi.resources.InputArgs

        com.pulumi.resources.InputArgs.InputArgsInternal

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static GetAmiArgs Empty  

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> allowUnsafeFilter()  
      static GetAmiArgs.Builder builder()  
      static GetAmiArgs.Builder builder​(GetAmiArgs defaults)  
      java.util.Optional<com.pulumi.core.Output<java.util.List<java.lang.String>>> executableUsers()  
      java.util.Optional<com.pulumi.core.Output<java.util.List<GetAmiFilterArgs>>> filters()  
      java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> includeDeprecated()  
      java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> mostRecent()  
      java.util.Optional<com.pulumi.core.Output<java.lang.String>> nameRegex()  
      java.util.Optional<com.pulumi.core.Output<java.util.List<java.lang.String>>> owners()  
      java.util.Optional<com.pulumi.core.Output<java.lang.String>> region()  
      java.util.Optional<com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>>> tags()  
      java.util.Optional<com.pulumi.core.Output<java.lang.String>> uefiData()  

      • Methods inherited from class com.pulumi.resources.InvokeArgs

        validateMember

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Method Detail

      • allowUnsafeFilter

        public java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> allowUnsafeFilter()
        Returns:
        If true, allow unsafe filter values. With unsafe filters and `mostRecent` set to `true`, a third party may introduce a new image which will be returned by this data source. Consider filtering by owner or image ID rather than setting this argument.

      • executableUsers

        public java.util.Optional<com.pulumi.core.Output<java.util.List<java.lang.String>>> executableUsers()
        Returns:
        Limit search to users with *explicit* launch permission on the image. Valid items are the numeric account ID or `self`.

      • filters

        public java.util.Optional<com.pulumi.core.Output<java.util.List<GetAmiFilterArgs>>> filters()
        Returns:
        One or more name/value pairs to filter off of. There are several valid keys, for a full reference, check out [describe-images in the AWS CLI reference](http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html). See `filter` below.

      • includeDeprecated

        public java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> includeDeprecated()
        Returns:
        If true, all deprecated AMIs are included in the response. If false, no deprecated AMIs are included in the response. If no value is specified, the default value is false.

      • mostRecent

        public java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> mostRecent()
        Returns:
        If more than one result is returned, use the most recent AMI.

      • nameRegex

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> nameRegex()
        Returns:
        Regex string to apply to the AMI list returned by AWS. This allows more advanced filtering not supported from the AWS API. This filtering is done locally on what AWS returns, and could have a performance impact if the result is large. Combine this with other options to narrow down the list AWS returns.

      • owners

        public java.util.Optional<com.pulumi.core.Output<java.util.List<java.lang.String>>> owners()
        Returns:
        List of AMI owners to limit search. Valid values: an AWS account ID, `self` (the current account), or an AWS owner alias (e.g., `amazon`, `aws-marketplace`, `microsoft`).

      • region

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> region()
        Returns:
        Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.

      • tags

        public java.util.Optional<com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>>> tags()
        Returns:
        Any tags assigned to the image.

      • uefiData

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> uefiData()
        Returns:
        Base64 representation of the non-volatile UEFI variable store. > **NOTE:** If more or less than a single match is returned by the search, this call will fail. Ensure that your search is specific enough to return a single AMI ID only, or use `mostRecent` to choose the most recent one. If you want to match multiple AMIs, use the `aws.ec2.getAmiIds` data source instead.