aws-sdk-imagebuilder 1.26.0 → 1.30.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 source 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
@@ -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
@@ -269,6 +271,11 @@ module Aws::Imagebuilder
     #   parent 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
@@ -435,6 +463,10 @@ module Aws::Imagebuilder
     #   parent 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 source 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]
@@ -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 source 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]
@@ -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
@@ -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
@@ -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
@@ -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",
     #         },
@@ -1674,9 +1707,21 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] instance_types
-    #   The instance types of the infrastructure configuration. You can
-    #   specify one or more instance types to use for this build. The
-    #   service will pick one of these instance types based on availability.
+    #   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 [Array<String>]
     #
     # @!attribute [rw] instance_profile_name
@@ -1699,7 +1744,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 +1763,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 +1793,7 @@ module Aws::Imagebuilder
       :terminate_instance_on_failure,
       :sns_topic_arn,
       :resource_tags,
+      :instance_metadata_options,
       :tags,
       :client_token)
       SENSITIVE = []
@@ -1966,7 +2017,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 +2034,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 +2266,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 +2297,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 +2311,8 @@ module Aws::Imagebuilder
       :kms_key_id,
       :snapshot_id,
       :volume_size,
-      :volume_type)
+      :volume_type,
+      :throughput)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2767,21 +2827,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 source 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]
@@ -3276,21 +3333,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 source 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 +3416,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 source 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 +3579,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 +3605,7 @@ module Aws::Imagebuilder
       :date_created,
       :date_updated,
       :resource_tags,
+      :instance_metadata_options,
       :tags)
       SENSITIVE = []
       include Aws::Structure
@@ -3624,6 +3681,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",
@@ -3675,6 +3733,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 +3761,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 +3914,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 +4048,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 +4141,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 +4213,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 +4281,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 +4417,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 +4484,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 +4567,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 +4647,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 +4701,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 source 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 +4742,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
@@ -5119,7 +5283,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 +5294,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 +5638,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 +5679,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 +5705,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 +5737,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