aws-sdk-imagebuilder 1.27.0 → 1.31.0

data/lib/aws-sdk-imagebuilder/types.rb

@@ -12,9 +12,10 @@ module Aws::Imagebuilder
 
     # In addition to your infrastruction configuration, these settings
     # provide an extra layer of control over your build instances. For
-    # instances where Image Builder installs the SSM agent, you can choose
-    # whether to keep it for the AMI that you create. You can also specify
-    # commands to run on launch for all of your build instances.
+    # instances where Image Builder installs the Systems Manager agent, you
+    # can choose whether to keep it for the AMI that you create. You can
+    # also specify commands to run on launch for all of your build
+    # instances.
     #
     # @note When making an API call, you may pass AdditionalInstanceConfiguration
     #   data as a hash:
@@ -27,7 +28,8 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] systems_manager_agent
-    #   Contains settings for the SSM agent on your build instance.
+    #   Contains settings for the Systems Manager agent on your build
+    #   instance.
     #   @return [Types::SystemsManagerAgent]
     #
     # @!attribute [rw] user_data_override
@@ -35,10 +37,10 @@ module Aws::Imagebuilder
     #   when you launch your build instance.
     #
     #   <note markdown="1"> The userDataOverride property replaces any commands that Image
-    #   Builder might have added to ensure that SSM is installed on your
-    #   Linux build instance. If you override the user data, make sure that
-    #   you add commands to install SSM, if it is not pre-installed on your
-    #   source image.
+    #   Builder might have added to ensure that Systems Manager is installed
+    #   on your Linux build instance. If you override the user data, make
+    #   sure that you add commands to install Systems Manager, if it is not
+    #   pre-installed on your base image.
     #
     #    </note>
     #   @return [String]
@@ -55,7 +57,7 @@ module Aws::Imagebuilder
     # Details of an Amazon EC2 AMI.
     #
     # @!attribute [rw] region
-    #   The Region of the Amazon EC2 AMI.
+    #   The Amazon Web Services Region of the Amazon EC2 AMI.
     #   @return [String]
     #
     # @!attribute [rw] image
@@ -112,7 +114,7 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] name
-    #   The name of the distribution configuration.
+    #   The name of the output AMI.
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -133,8 +135,8 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] launch_permission
-    #   Launch permissions can be used to configure which accounts can use
-    #   the AMI to launch instances.
+    #   Launch permissions can be used to configure which Amazon Web
+    #   Services accounts can use the AMI to launch instances.
     #   @return [Types::LaunchPermissionConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/AmiDistributionConfiguration AWS API Documentation
@@ -266,9 +268,14 @@ module Aws::Imagebuilder
     # @!attribute [rw] supported_os_versions
     #   The operating system (OS) version supported by the component. If the
     #   OS information is available, a prefix match is performed against the
-    #   parent image OS version during image recipe creation.
+    #   base image OS version during image recipe creation.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] state
+    #   Describes the current status of the component. This is used for
+    #   components that are no longer active.
+    #   @return [Types::ComponentState]
+    #
     # @!attribute [rw] parameters
     #   Contains parameter details for each of the parameters that are
     #   defined for the component.
@@ -309,6 +316,7 @@ module Aws::Imagebuilder
       :type,
       :platform,
       :supported_os_versions,
+      :state,
       :parameters,
       :owner,
       :data,
@@ -411,6 +419,26 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
+    # A group of fields that describe the current status of components that
+    # are no longer active.
+    #
+    # @!attribute [rw] status
+    #   The current state of the component.
+    #   @return [String]
+    #
+    # @!attribute [rw] reason
+    #   Describes how or why the component changed state.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ComponentState AWS API Documentation
+    #
+    class ComponentState < Struct.new(
+      :status,
+      :reason)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A high-level summary of a component.
     #
     # @!attribute [rw] arn
@@ -432,9 +460,13 @@ module Aws::Imagebuilder
     # @!attribute [rw] supported_os_versions
     #   The operating system (OS) version supported by the component. If the
     #   OS information is available, a prefix match is performed against the
-    #   parent image OS version during image recipe creation.
+    #   base image OS version during image recipe creation.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] state
+    #   Describes the current status of the component.
+    #   @return [Types::ComponentState]
+    #
     # @!attribute [rw] type
     #   The type of the component denotes whether the component is used to
     #   build the image or only to test it.
@@ -468,6 +500,7 @@ module Aws::Imagebuilder
       :version,
       :platform,
       :supported_os_versions,
+      :state,
       :type,
       :owner,
       :description,
@@ -478,8 +511,8 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
-    # The defining characteristics of a specific version of an TOE
-    # component.
+    # The defining characteristics of a specific version of an Amazon Web
+    # Services TOE component.
     #
     # @!attribute [rw] arn
     #   The Amazon Resource Name (ARN) of the component.
@@ -514,21 +547,18 @@ module Aws::Imagebuilder
     #    **Assignment:** For the first three nodes you can assign any
     #   positive integer value, including zero, with an upper limit of
     #   2^30-1, or 1073741823 for each node. Image Builder automatically
-    #   assigns the build number, and that is not open for updates.
+    #   assigns the build number to the fourth node.
     #
     #    **Patterns:** You can use any numeric pattern that adheres to the
     #   assignment requirements for the nodes that you can assign. For
     #   example, you might choose a software version pattern, such as 1.0.0,
     #   or a date, such as 2021.01.01.
     #
-    #    **Filtering:** When you retrieve or reference a resource with a
-    #   semantic version, you can use wildcards (x) to filter your results.
-    #   When you use a wildcard in any node, all nodes to the right of the
-    #   first wildcard must also be wildcards. For example, specifying
-    #   "1.2.x", or "1.x.x" works to filter list results, but neither
-    #   "1.x.2", nor "x.2.x" will work. You do not have to specify the
-    #   build - Image Builder automatically uses a wildcard for that, if
-    #   applicable.
+    #    **Filtering:** With semantic versioning, you have the flexibility to
+    #   use wildcards (x) to specify the most recent versions or nodes when
+    #   selecting the base image or components for your recipe. When you use
+    #   a wildcard in any node, all nodes to the right of the first wildcard
+    #   must also be wildcards.
     #
     #    </note>
     #   @return [String]
@@ -544,7 +574,7 @@ module Aws::Imagebuilder
     # @!attribute [rw] supported_os_versions
     #   he operating system (OS) version supported by the component. If the
     #   OS information is available, a prefix match is performed against the
-    #   parent image OS version during image recipe creation.
+    #   base image OS version during image recipe creation.
     #   @return [Array<String>]
     #
     # @!attribute [rw] type
@@ -685,21 +715,18 @@ module Aws::Imagebuilder
     #    **Assignment:** For the first three nodes you can assign any
     #   positive integer value, including zero, with an upper limit of
     #   2^30-1, or 1073741823 for each node. Image Builder automatically
-    #   assigns the build number, and that is not open for updates.
+    #   assigns the build number to the fourth node.
     #
     #    **Patterns:** You can use any numeric pattern that adheres to the
     #   assignment requirements for the nodes that you can assign. For
     #   example, you might choose a software version pattern, such as 1.0.0,
     #   or a date, such as 2021.01.01.
     #
-    #    **Filtering:** When you retrieve or reference a resource with a
-    #   semantic version, you can use wildcards (x) to filter your results.
-    #   When you use a wildcard in any node, all nodes to the right of the
-    #   first wildcard must also be wildcards. For example, specifying
-    #   "1.2.x", or "1.x.x" works to filter list results, but neither
-    #   "1.x.2", nor "x.2.x" will work. You do not have to specify the
-    #   build - Image Builder automatically uses a wildcard for that, if
-    #   applicable.
+    #    **Filtering:** With semantic versioning, you have the flexibility to
+    #   use wildcards (x) to specify the most recent versions or nodes when
+    #   selecting the base image or components for your recipe. When you use
+    #   a wildcard in any node, all nodes to the right of the first wildcard
+    #   must also be wildcards.
     #
     #    </note>
     #   @return [String]
@@ -732,7 +759,7 @@ module Aws::Imagebuilder
     #   @return [Boolean]
     #
     # @!attribute [rw] parent_image
-    #   The source image for the container recipe.
+    #   The base image for the container recipe.
     #   @return [String]
     #
     # @!attribute [rw] date_created
@@ -798,7 +825,7 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] parent_image
-    #   The source image for the container recipe.
+    #   The base image for the container recipe.
     #   @return [String]
     #
     # @!attribute [rw] date_created
@@ -858,7 +885,7 @@ module Aws::Imagebuilder
     #    **Assignment:** For the first three nodes you can assign any
     #   positive integer value, including zero, with an upper limit of
     #   2^30-1, or 1073741823 for each node. Image Builder automatically
-    #   assigns the build number, and that is not open for updates.
+    #   assigns the build number to the fourth node.
     #
     #    **Patterns:** You can use any numeric pattern that adheres to the
     #   assignment requirements for the nodes that you can assign. For
@@ -886,7 +913,7 @@ module Aws::Imagebuilder
     # @!attribute [rw] supported_os_versions
     #   The operating system (OS) version supported by the component. If the
     #   OS information is available, a prefix match is performed against the
-    #   parent image OS version during image recipe creation.
+    #   base image OS version during image recipe creation.
     #   @return [Array<String>]
     #
     # @!attribute [rw] data
@@ -991,6 +1018,7 @@ module Aws::Imagebuilder
     #                 snapshot_id: "NonEmptyString",
     #                 volume_size: 1,
     #                 volume_type: "standard", # accepts standard, io1, io2, gp2, gp3, sc1, st1
+    #                 throughput: 1,
     #               },
     #               virtual_name: "NonEmptyString",
     #               no_device: "EmptyString",
@@ -1037,7 +1065,7 @@ module Aws::Imagebuilder
     #    **Assignment:** For the first three nodes you can assign any
     #   positive integer value, including zero, with an upper limit of
     #   2^30-1, or 1073741823 for each node. Image Builder automatically
-    #   assigns the build number, and that is not open for updates.
+    #   assigns the build number to the fourth node.
     #
     #    **Patterns:** You can use any numeric pattern that adheres to the
     #   assignment requirements for the nodes that you can assign. For
@@ -1068,16 +1096,16 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] platform_override
-    #   Specifies the operating system platform when you use a custom source
+    #   Specifies the operating system platform when you use a custom base
     #   image.
     #   @return [String]
     #
     # @!attribute [rw] image_os_version_override
-    #   Specifies the operating system version for the source image.
+    #   Specifies the operating system version for the base image.
     #   @return [String]
     #
     # @!attribute [rw] parent_image
-    #   The source image for the container recipe.
+    #   The base image for the container recipe.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -1411,6 +1439,7 @@ module Aws::Imagebuilder
     #               snapshot_id: "NonEmptyString",
     #               volume_size: 1,
     #               volume_type: "standard", # accepts standard, io1, io2, gp2, gp3, sc1, st1
+    #               throughput: 1,
     #             },
     #             virtual_name: "NonEmptyString",
     #             no_device: "EmptyString",
@@ -1448,7 +1477,7 @@ module Aws::Imagebuilder
     #    **Assignment:** For the first three nodes you can assign any
     #   positive integer value, including zero, with an upper limit of
     #   2^30-1, or 1073741823 for each node. Image Builder automatically
-    #   assigns the build number, and that is not open for updates.
+    #   assigns the build number to the fourth node.
     #
     #    **Patterns:** You can use any numeric pattern that adheres to the
     #   assignment requirements for the nodes that you can assign. For
@@ -1463,8 +1492,8 @@ module Aws::Imagebuilder
     #   @return [Array<Types::ComponentConfiguration>]
     #
     # @!attribute [rw] parent_image
-    #   The parent image of the image recipe. The value of the string can be
-    #   the ARN of the parent image or an AMI ID. The format for the ARN
+    #   The base image of the image recipe. The value of the string can be
+    #   the ARN of the base image or an AMI ID. The format for the ARN
     #   follows this example:
     #   `arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x`.
     #   You can provide the specific version that you want to use, or you
@@ -1659,6 +1688,10 @@ module Aws::Imagebuilder
     #         resource_tags: {
     #           "TagKey" => "TagValue",
     #         },
+    #         instance_metadata_options: {
+    #           http_tokens: "HttpTokens",
+    #           http_put_response_hop_limit: 1,
+    #         },
     #         tags: {
     #           "TagKey" => "TagValue",
     #         },
@@ -1699,7 +1732,7 @@ module Aws::Imagebuilder
     #   @return [Types::Logging]
     #
     # @!attribute [rw] key_pair
-    #   The key pair of the infrastructure configuration. This can be used
+    #   The key pair of the infrastructure configuration. You can use this
     #   to log on to and debug the instance used to create your image.
     #   @return [String]
     #
@@ -1718,6 +1751,11 @@ module Aws::Imagebuilder
     #   The tags attached to the resource created by Image Builder.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] instance_metadata_options
+    #   The instance metadata options that you can set for the HTTP requests
+    #   that pipeline builds use to launch EC2 build and test instances.
+    #   @return [Types::InstanceMetadataOptions]
+    #
     # @!attribute [rw] tags
     #   The tags of the infrastructure configuration.
     #   @return [Hash<String,String>]
@@ -1743,6 +1781,7 @@ module Aws::Imagebuilder
       :terminate_instance_on_failure,
       :sns_topic_arn,
       :resource_tags,
+      :instance_metadata_options,
       :tags,
       :client_token)
       SENSITIVE = []
@@ -1966,7 +2005,8 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] image_build_version_arn
-    #   The Amazon Resource Name (ARN) of the image to delete.
+    #   The Amazon Resource Name (ARN) of the Image Builder image resource
+    #   to delete.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/DeleteImageRequest AWS API Documentation
@@ -1982,7 +2022,8 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] image_build_version_arn
-    #   The Amazon Resource Name (ARN) of the image that was deleted.
+    #   The Amazon Resource Name (ARN) of the Image Builder image resource
+    #   that was deleted.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/DeleteImageResponse AWS API Documentation
@@ -2213,6 +2254,7 @@ module Aws::Imagebuilder
     #         snapshot_id: "NonEmptyString",
     #         volume_size: 1,
     #         volume_type: "standard", # accepts standard, io1, io2, gp2, gp3, sc1, st1
+    #         throughput: 1,
     #       }
     #
     # @!attribute [rw] encrypted
@@ -2243,6 +2285,11 @@ module Aws::Imagebuilder
     #   Use to override the device's volume type.
     #   @return [String]
     #
+    # @!attribute [rw] throughput
+    #   **For GP3 volumes only** – The throughput in MiB/s that the volume
+    #   supports.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/EbsInstanceBlockDeviceSpecification AWS API Documentation
     #
     class EbsInstanceBlockDeviceSpecification < Struct.new(
@@ -2252,7 +2299,8 @@ module Aws::Imagebuilder
       :kms_key_id,
       :snapshot_id,
       :volume_size,
-      :volume_type)
+      :volume_type,
+      :throughput)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2767,21 +2815,18 @@ module Aws::Imagebuilder
     #    **Assignment:** For the first three nodes you can assign any
     #   positive integer value, including zero, with an upper limit of
     #   2^30-1, or 1073741823 for each node. Image Builder automatically
-    #   assigns the build number, and that is not open for updates.
+    #   assigns the build number to the fourth node.
     #
     #    **Patterns:** You can use any numeric pattern that adheres to the
     #   assignment requirements for the nodes that you can assign. For
     #   example, you might choose a software version pattern, such as 1.0.0,
     #   or a date, such as 2021.01.01.
     #
-    #    **Filtering:** When you retrieve or reference a resource with a
-    #   semantic version, you can use wildcards (x) to filter your results.
-    #   When you use a wildcard in any node, all nodes to the right of the
-    #   first wildcard must also be wildcards. For example, specifying
-    #   "1.2.x", or "1.x.x" works to filter list results, but neither
-    #   "1.x.2", nor "x.2.x" will work. You do not have to specify the
-    #   build - Image Builder automatically uses a wildcard for that, if
-    #   applicable.
+    #    **Filtering:** With semantic versioning, you have the flexibility to
+    #   use wildcards (x) to specify the most recent versions or nodes when
+    #   selecting the base image or components for your recipe. When you use
+    #   a wildcard in any node, all nodes to the right of the first wildcard
+    #   must also be wildcards.
     #
     #    </note>
     #   @return [String]
@@ -3030,7 +3075,7 @@ module Aws::Imagebuilder
     #   @return [Array<Types::ComponentConfiguration>]
     #
     # @!attribute [rw] parent_image
-    #   The parent image of the image recipe.
+    #   The base image of the image recipe.
     #   @return [String]
     #
     # @!attribute [rw] block_device_mappings
@@ -3098,7 +3143,7 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] parent_image
-    #   The parent image of the image recipe.
+    #   The base image of the image recipe.
     #   @return [String]
     #
     # @!attribute [rw] date_created
@@ -3276,21 +3321,18 @@ module Aws::Imagebuilder
     #    **Assignment:** For the first three nodes you can assign any
     #   positive integer value, including zero, with an upper limit of
     #   2^30-1, or 1073741823 for each node. Image Builder automatically
-    #   assigns the build number, and that is not open for updates.
+    #   assigns the build number to the fourth node.
     #
     #    **Patterns:** You can use any numeric pattern that adheres to the
     #   assignment requirements for the nodes that you can assign. For
     #   example, you might choose a software version pattern, such as 1.0.0,
     #   or a date, such as 2021.01.01.
     #
-    #    **Filtering:** When you retrieve or reference a resource with a
-    #   semantic version, you can use wildcards (x) to filter your results.
-    #   When you use a wildcard in any node, all nodes to the right of the
-    #   first wildcard must also be wildcards. For example, specifying
-    #   "1.2.x", or "1.x.x" works to filter list results, but neither
-    #   "1.x.2", nor "x.2.x" will work. You do not have to specify the
-    #   build - Image Builder automatically uses a wildcard for that, if
-    #   applicable.
+    #    **Filtering:** With semantic versioning, you have the flexibility to
+    #   use wildcards (x) to specify the most recent versions or nodes when
+    #   selecting the base image or components for your recipe. When you use
+    #   a wildcard in any node, all nodes to the right of the first wildcard
+    #   must also be wildcards.
     #
     #    </note>
     #   @return [String]
@@ -3362,14 +3404,11 @@ module Aws::Imagebuilder
     #   &lt;major&gt;.&lt;minor&gt;.&lt;patch&gt;/&lt;build&gt;. You can
     #   assign values for the first three, and can filter on all of them.
     #
-    #    **Filtering:** When you retrieve or reference a resource with a
-    #   semantic version, you can use wildcards (x) to filter your results.
-    #   When you use a wildcard in any node, all nodes to the right of the
-    #   first wildcard must also be wildcards. For example, specifying
-    #   "1.2.x", or "1.x.x" works to filter list results, but neither
-    #   "1.x.2", nor "x.2.x" will work. You do not have to specify the
-    #   build - Image Builder automatically uses a wildcard for that, if
-    #   applicable.
+    #    **Filtering:** With semantic versioning, you have the flexibility to
+    #   use wildcards (x) to specify the most recent versions or nodes when
+    #   selecting the base image or components for your recipe. When you use
+    #   a wildcard in any node, all nodes to the right of the first wildcard
+    #   must also be wildcards.
     #
     #    </note>
     #   @return [String]
@@ -3528,6 +3567,11 @@ module Aws::Imagebuilder
     #   The tags attached to the resource created by Image Builder.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] instance_metadata_options
+    #   The instance metadata option settings for the infrastructure
+    #   configuration.
+    #   @return [Types::InstanceMetadataOptions]
+    #
     # @!attribute [rw] tags
     #   The tags of the infrastructure configuration.
     #   @return [Hash<String,String>]
@@ -3549,6 +3593,7 @@ module Aws::Imagebuilder
       :date_created,
       :date_updated,
       :resource_tags,
+      :instance_metadata_options,
       :tags)
       SENSITIVE = []
       include Aws::Structure
@@ -3624,6 +3669,7 @@ module Aws::Imagebuilder
     #           snapshot_id: "NonEmptyString",
     #           volume_size: 1,
     #           volume_type: "standard", # accepts standard, io1, io2, gp2, gp3, sc1, st1
+    #           throughput: 1,
     #         },
     #         virtual_name: "NonEmptyString",
     #         no_device: "EmptyString",
@@ -3642,7 +3688,7 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] no_device
-    #   Use to remove a mapping from the parent image.
+    #   Use to remove a mapping from the base image.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/InstanceBlockDeviceMapping AWS API Documentation
@@ -3656,7 +3702,7 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
-    # Defines a custom source AMI and block device mapping configurations of
+    # Defines a custom base AMI and block device mapping configurations of
     # an instance used for building and testing container images.
     #
     # @note When making an API call, you may pass InstanceConfiguration
@@ -3675,6 +3721,7 @@ module Aws::Imagebuilder
     #               snapshot_id: "NonEmptyString",
     #               volume_size: 1,
     #               volume_type: "standard", # accepts standard, io1, io2, gp2, gp3, sc1, st1
+    #               throughput: 1,
     #             },
     #             virtual_name: "NonEmptyString",
     #             no_device: "EmptyString",
@@ -3702,6 +3749,57 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
+    # The instance metadata options that apply to the HTTP requests that
+    # pipeline builds use to launch EC2 build and test instances. For more
+    # information about instance metadata options, see [Configure the
+    # instance metadata options][1] in the <i> <i>Amazon EC2 User Guide</i>
+    # </i> for Linux instances, or [Configure the instance metadata
+    # options][2] in the <i> <i>Amazon EC2 Windows Guide</i> </i> for
+    # Windows instances.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html
+    # [2]: https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/configuring-instance-metadata-options.html
+    #
+    # @note When making an API call, you may pass InstanceMetadataOptions
+    #   data as a hash:
+    #
+    #       {
+    #         http_tokens: "HttpTokens",
+    #         http_put_response_hop_limit: 1,
+    #       }
+    #
+    # @!attribute [rw] http_tokens
+    #   Indicates whether a signed token header is required for instance
+    #   metadata retrieval requests. The values affect the response as
+    #   follows:
+    #
+    #   * **required** – When you retrieve the IAM role credentials, version
+    #     2.0 credentials are returned in all cases.
+    #
+    #   * **optional** – You can include a signed token header in your
+    #     request to retrieve instance metadata, or you can leave it out. If
+    #     you include it, version 2.0 credentials are returned for the IAM
+    #     role. Otherwise, version 1.0 credentials are returned.
+    #
+    #   The default setting is **optional**.
+    #   @return [String]
+    #
+    # @!attribute [rw] http_put_response_hop_limit
+    #   Limit the number of hops that an instance metadata request can
+    #   traverse to reach its destination.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/InstanceMetadataOptions AWS API Documentation
+    #
+    class InstanceMetadataOptions < Struct.new(
+      :http_tokens,
+      :http_put_response_hop_limit)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # You have provided an invalid pagination token in your request.
     #
     # @!attribute [rw] message
@@ -3804,7 +3902,7 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] user_ids
-    #   The account ID.
+    #   The Amazon Web Services account ID.
     #   @return [Array<String>]
     #
     # @!attribute [rw] user_groups
@@ -3938,7 +4036,19 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] filters
-    #   The filters.
+    #   Use the following filters to streamline results:
+    #
+    #   * `description`
+    #
+    #   * `name`
+    #
+    #   * `platform`
+    #
+    #   * `supportedOsVersion`
+    #
+    #   * `type`
+    #
+    #   * `version`
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] by_name
@@ -4019,8 +4129,15 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] filters
-    #   Request filters that are used to narrow the list of container images
-    #   that are returned.
+    #   Use the following filters to streamline results:
+    #
+    #   * `containerType`
+    #
+    #   * `name`
+    #
+    #   * `parentImage`
+    #
+    #   * `platform`
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] max_results
@@ -4084,11 +4201,7 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] filters
-    #   The filters.
-    #
-    #   * `name` - The name of this distribution configuration.
-    #
-    #   ^
+    #   You can filter on `name` to streamline results.
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] max_results
@@ -4156,7 +4269,17 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] filters
-    #   The filters.
+    #   Use the following filters to streamline results:
+    #
+    #   * `name`
+    #
+    #   * `osVersion`
+    #
+    #   * `platform`
+    #
+    #   * `type`
+    #
+    #   * `version`
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] max_results
@@ -4282,7 +4405,11 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] filters
-    #   The filters.
+    #   Use the following filters to streamline results:
+    #
+    #   * `name`
+    #
+    #   * `version`
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] max_results
@@ -4345,7 +4472,19 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] filters
-    #   The filters.
+    #   Use the following filters to streamline results:
+    #
+    #   * `description`
+    #
+    #   * `distributionConfigurationArn`
+    #
+    #   * `imageRecipeArn`
+    #
+    #   * `infrastructureConfigurationArn`
+    #
+    #   * `name`
+    #
+    #   * `status`
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] max_results
@@ -4416,7 +4555,13 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] filters
-    #   The filters.
+    #   Use the following filters to streamline results:
+    #
+    #   * `name`
+    #
+    #   * `parentImage`
+    #
+    #   * `platform`
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] max_results
@@ -4490,7 +4635,17 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] filters
-    #   The filters.
+    #   Use the following filters to streamline results:
+    #
+    #   * `name`
+    #
+    #   * `osVersion`
+    #
+    #   * `platform`
+    #
+    #   * `type`
+    #
+    #   * `version`
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] by_name
@@ -4534,14 +4689,11 @@ module Aws::Imagebuilder
     #   &lt;major&gt;.&lt;minor&gt;.&lt;patch&gt;/&lt;build&gt;. You can
     #   assign values for the first three, and can filter on all of them.
     #
-    #    **Filtering:** When you retrieve or reference a resource with a
-    #   semantic version, you can use wildcards (x) to filter your results.
-    #   When you use a wildcard in any node, all nodes to the right of the
-    #   first wildcard must also be wildcards. For example, specifying
-    #   "1.2.x", or "1.x.x" works to filter list results, but neither
-    #   "1.x.2", nor "x.2.x" will work. You do not have to specify the
-    #   build - Image Builder automatically uses a wildcard for that, if
-    #   applicable.
+    #    **Filtering:** With semantic versioning, you have the flexibility to
+    #   use wildcards (x) to specify the most recent versions or nodes when
+    #   selecting the base image or components for your recipe. When you use
+    #   a wildcard in any node, all nodes to the right of the first wildcard
+    #   must also be wildcards.
     #
     #    </note>
     #   @return [Array<Types::ImageVersion>]
@@ -4578,7 +4730,7 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] filters
-    #   The filters.
+    #   You can filter on `name` to streamline results.
     #   @return [Array<Types::Filter>]
     #
     # @!attribute [rw] max_results
@@ -4997,7 +5149,7 @@ module Aws::Imagebuilder
     #   The condition configures when the pipeline should trigger a new
     #   image build. When the `pipelineExecutionStartCondition` is set to
     #   `EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE`, and you use
-    #   semantic version filters on the source image or components in your
+    #   semantic version filters on the base image or components in your
     #   image recipe, EC2 Image Builder will build a new image only when
     #   there are new versions of the image or components in your recipe
     #   that match the semantic version filter. When it is set to
@@ -5119,7 +5271,8 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
-    # Contains settings for the SSM agent on your build instance.
+    # Contains settings for the Systems Manager agent on your build
+    # instance.
     #
     # @note When making an API call, you may pass SystemsManagerAgent
     #   data as a hash:
@@ -5129,11 +5282,11 @@ module Aws::Imagebuilder
     #       }
     #
     # @!attribute [rw] uninstall_after_build
-    #   Controls whether the SSM agent is removed from your final build
-    #   image, prior to creating the new AMI. If this is set to true, then
-    #   the agent is removed from the final image. If it's set to false,
-    #   then the agent is left in, so that it is included in the new AMI.
-    #   The default value is false.
+    #   Controls whether the Systems Manager agent is removed from your
+    #   final build image, prior to creating the new AMI. If this is set to
+    #   true, then the agent is removed from the final image. If it's set
+    #   to false, then the agent is left in, so that it is included in the
+    #   new AMI. The default value is false.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/SystemsManagerAgent AWS API Documentation
@@ -5473,6 +5626,10 @@ module Aws::Imagebuilder
     #         resource_tags: {
     #           "TagKey" => "TagValue",
     #         },
+    #         instance_metadata_options: {
+    #           http_tokens: "HttpTokens",
+    #           http_put_response_hop_limit: 1,
+    #         },
     #       }
     #
     # @!attribute [rw] infrastructure_configuration_arn
@@ -5510,7 +5667,7 @@ module Aws::Imagebuilder
     #   @return [Types::Logging]
     #
     # @!attribute [rw] key_pair
-    #   The key pair of the infrastructure configuration. This can be used
+    #   The key pair of the infrastructure configuration. You can use this
     #   to log on to and debug the instance used to create your image.
     #   @return [String]
     #
@@ -5536,6 +5693,24 @@ module Aws::Imagebuilder
     #   The tags attached to the resource created by Image Builder.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] instance_metadata_options
+    #   The instance metadata options that you can set for the HTTP requests
+    #   that pipeline builds use to launch EC2 build and test instances. For
+    #   more information about instance metadata options, see one of the
+    #   following links:
+    #
+    #   * [Configure the instance metadata options][1] in the <i> <i>Amazon
+    #     EC2 User Guide</i> </i> for Linux instances.
+    #
+    #   * [Configure the instance metadata options][2] in the <i> <i>Amazon
+    #     EC2 Windows Guide</i> </i> for Windows instances.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/configuring-instance-metadata-options.html
+    #   @return [Types::InstanceMetadataOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/UpdateInfrastructureConfigurationRequest AWS API Documentation
     #
     class UpdateInfrastructureConfigurationRequest < Struct.new(
@@ -5550,7 +5725,8 @@ module Aws::Imagebuilder
       :terminate_instance_on_failure,
       :sns_topic_arn,
       :client_token,
-      :resource_tags)
+      :resource_tags,
+      :instance_metadata_options)
       SENSITIVE = []
       include Aws::Structure
     end