aws-sdk-imagebuilder 1.72.0 → 1.74.0

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

@@ -324,8 +324,7 @@ module Aws::Imagebuilder
     #   @return [Array<String>]
     #
     # @!attribute [rw] state
-    #   Describes the current status of the component. This is used for
-    #   components that are no longer active.
+    #   Describes the current status of the component.
     #   @return [Types::ComponentState]
     #
     # @!attribute [rw] parameters
@@ -368,6 +367,11 @@ module Aws::Imagebuilder
     #   operations.
     #   @return [Boolean]
     #
+    # @!attribute [rw] product_codes
+    #   Contains product codes that are used for billing purposes for Amazon
+    #   Web Services Marketplace components.
+    #   @return [Array<Types::ProductCodeListItem>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/Component AWS API Documentation
     #
     class Component < Struct.new(
@@ -388,7 +392,8 @@ module Aws::Imagebuilder
       :date_created,
       :tags,
       :publisher,
-      :obfuscate)
+      :obfuscate,
+      :product_codes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -647,6 +652,15 @@ module Aws::Imagebuilder
     #   The date that the component was created.
     #   @return [String]
     #
+    # @!attribute [rw] status
+    #   Describes the current status of the component version.
+    #   @return [String]
+    #
+    # @!attribute [rw] product_codes
+    #   Contains product codes that are used for billing purposes for Amazon
+    #   Web Services Marketplace components.
+    #   @return [Array<Types::ProductCodeListItem>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ComponentVersion AWS API Documentation
     #
     class ComponentVersion < Struct.new(
@@ -658,7 +672,9 @@ module Aws::Imagebuilder
       :supported_os_versions,
       :type,
       :owner,
-      :date_created)
+      :date_created,
+      :status,
+      :product_codes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1101,7 +1117,7 @@ module Aws::Imagebuilder
     #   @return [Types::TargetContainerRepository]
     #
     # @!attribute [rw] kms_key_id
-    #   Identifies which KMS key is used to encrypt the container image.
+    #   Identifies which KMS key is used to encrypt the Dockerfile template.
     #   @return [String]
     #
     # @!attribute [rw] client_token
@@ -1625,7 +1641,9 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] resource_tags
-    #   The tags attached to the resource created by Image Builder.
+    #   The metadata tags to assign to the Amazon EC2 instance that Image
+    #   Builder launches during the build process. Tags are formatted as key
+    #   value pairs.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] instance_metadata_options
@@ -1634,9 +1652,16 @@ module Aws::Imagebuilder
     #   @return [Types::InstanceMetadataOptions]
     #
     # @!attribute [rw] tags
-    #   The tags of the infrastructure configuration.
+    #   The metadata tags to assign to the infrastructure configuration
+    #   resource that Image Builder creates as output. Tags are formatted as
+    #   key value pairs.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] placement
+    #   The instance placement settings that define where the instances that
+    #   are launched from your image will run.
+    #   @return [Types::Placement]
+    #
     # @!attribute [rw] client_token
     #   Unique, case-sensitive identifier you provide to ensure idempotency
     #   of the request. For more information, see [Ensuring idempotency][1]
@@ -1666,6 +1691,7 @@ module Aws::Imagebuilder
       :resource_tags,
       :instance_metadata_options,
       :tags,
+      :placement,
       :client_token)
       SENSITIVE = []
       include Aws::Structure
@@ -2460,8 +2486,8 @@ module Aws::Imagebuilder
     #
     # @!attribute [rw] container_tags
     #   Tags for Image Builder to apply to the output container image that
-    #   &amp;INS; scans. Tags can help you identify and manage your scanned
-    #   images.
+    #   Amazon Inspector scans. Tags can help you identify and manage your
+    #   scanned images.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/EcrConfiguration AWS API Documentation
@@ -2981,6 +3007,55 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
+    # @!attribute [rw] resource_type
+    #   Specifies which type of Amazon Web Services Marketplace resource
+    #   Image Builder retrieves.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies an Amazon
+    #   Web Services Marketplace resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_location
+    #   The bucket path that you can specify to download the resource from
+    #   Amazon S3.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/GetMarketplaceResourceRequest AWS API Documentation
+    #
+    class GetMarketplaceResourceRequest < Struct.new(
+      :resource_type,
+      :resource_arn,
+      :resource_location)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] resource_arn
+    #   The Amazon Resource Name (ARN) for the Amazon Web Services
+    #   Marketplace resource that was requested.
+    #   @return [String]
+    #
+    # @!attribute [rw] url
+    #   The obfuscated S3 URL to download the component artifact from.
+    #   @return [String]
+    #
+    # @!attribute [rw] data
+    #   Returns obfuscated data that contains the YAML content of the
+    #   component.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/GetMarketplaceResourceResponse AWS API Documentation
+    #
+    class GetMarketplaceResourceResponse < Struct.new(
+      :resource_arn,
+      :url,
+      :data)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] workflow_execution_id
     #   Use the unique identifier for a runtime instance of the workflow to
     #   get runtime details.
@@ -3469,15 +3544,16 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
-    # Represents a package installed on an Image Builder image.
+    # A software package that's installed on top of the base image to
+    # create a customized image.
     #
     # @!attribute [rw] package_name
-    #   The name of the package as reported to the operating system package
-    #   manager.
+    #   The name of the package that's reported to the operating system
+    #   package manager.
     #   @return [String]
     #
     # @!attribute [rw] package_version
-    #   The version of the package as reported to the operating system
+    #   The version of the package that's reported to the operating system
     #   package manager.
     #   @return [String]
     #
@@ -4075,7 +4151,7 @@ module Aws::Imagebuilder
     # @!attribute [rw] timeout_minutes
     #   The maximum time in minutes that tests are permitted to run.
     #
-    #   <note markdown="1"> The timeoutMinutes attribute is not currently active. This value is
+    #   <note markdown="1"> The timeout attribute is not currently active. This value is
     #   ignored.
     #
     #    </note>
@@ -4502,6 +4578,11 @@ module Aws::Imagebuilder
     #   The tags of the infrastructure configuration.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] placement
+    #   The instance placement settings that define where the instances that
+    #   are launched from your image will run.
+    #   @return [Types::Placement]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/InfrastructureConfiguration AWS API Documentation
     #
     class InfrastructureConfiguration < Struct.new(
@@ -4520,7 +4601,8 @@ module Aws::Imagebuilder
       :date_updated,
       :resource_tags,
       :instance_metadata_options,
-      :tags)
+      :tags,
+      :placement)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4563,6 +4645,11 @@ module Aws::Imagebuilder
     #   The instance profile of the infrastructure configuration.
     #   @return [String]
     #
+    # @!attribute [rw] placement
+    #   The instance placement settings that define where the instances that
+    #   are launched from your image will run.
+    #   @return [Types::Placement]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/InfrastructureConfigurationSummary AWS API Documentation
     #
     class InfrastructureConfigurationSummary < Struct.new(
@@ -4574,7 +4661,8 @@ module Aws::Imagebuilder
       :resource_tags,
       :tags,
       :instance_types,
-      :instance_profile_name)
+      :instance_profile_name,
+      :placement)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6790,6 +6878,80 @@ module Aws::Imagebuilder
       include Aws::Structure
     end
 
+    # By default, EC2 instances run on shared tenancy hardware. This means
+    # that multiple Amazon Web Services accounts might share the same
+    # physical hardware. When you use dedicated hardware, the physical
+    # server that hosts your instances is dedicated to your Amazon Web
+    # Services account. Instance placement settings contain the details for
+    # the physical hardware where instances that Image Builder launches
+    # during image creation will run.
+    #
+    # @!attribute [rw] availability_zone
+    #   The Availability Zone where your build and test instances will
+    #   launch.
+    #   @return [String]
+    #
+    # @!attribute [rw] tenancy
+    #   The tenancy of the instance. An instance with a tenancy of
+    #   `dedicated` runs on single-tenant hardware. An instance with a
+    #   tenancy of `host` runs on a Dedicated Host.
+    #
+    #   If tenancy is set to `host`, then you can optionally specify one
+    #   target for placement – either host ID or host resource group ARN. If
+    #   automatic placement is enabled for your host, and you don't specify
+    #   any placement target, Amazon EC2 will try to find an available host
+    #   for your build and test instances.
+    #   @return [String]
+    #
+    # @!attribute [rw] host_id
+    #   The ID of the Dedicated Host on which build and test instances run.
+    #   This only applies if `tenancy` is `host`. If you specify the host
+    #   ID, you must not specify the resource group ARN. If you specify
+    #   both, Image Builder returns an error.
+    #   @return [String]
+    #
+    # @!attribute [rw] host_resource_group_arn
+    #   The Amazon Resource Name (ARN) of the host resource group in which
+    #   to launch build and test instances. This only applies if `tenancy`
+    #   is `host`. If you specify the resource group ARN, you must not
+    #   specify the host ID. If you specify both, Image Builder returns an
+    #   error.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/Placement AWS API Documentation
+    #
+    class Placement < Struct.new(
+      :availability_zone,
+      :tenancy,
+      :host_id,
+      :host_resource_group_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Information about a single product code.
+    #
+    # @!attribute [rw] product_code_id
+    #   For Amazon Web Services Marketplace components, this contains the
+    #   product code ID that can be stamped onto an EC2 AMI to ensure that
+    #   components are billed correctly. If this property is empty, it might
+    #   mean that the component is not published.
+    #   @return [String]
+    #
+    # @!attribute [rw] product_code_type
+    #   The owner of the product code that's billed. If this property is
+    #   empty, it might mean that the component is not published.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ProductCodeListItem AWS API Documentation
+    #
+    class ProductCodeListItem < Struct.new(
+      :product_code_id,
+      :product_code_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] component_arn
     #   The Amazon Resource Name (ARN) of the component that this policy
     #   should be applied to.
@@ -7513,6 +7675,7 @@ module Aws::Imagebuilder
     # @!attribute [rw] repository_name
     #   The name of the container repository where the output container
     #   image is stored. This name is prefixed by the repository location.
+    #   For example, `<repository location url>/repository_name`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/TargetContainerRepository AWS API Documentation
@@ -7783,19 +7946,6 @@ module Aws::Imagebuilder
     #    </note>
     #   @return [String]
     #
-    # @!attribute [rw] client_token
-    #   Unique, case-sensitive identifier you provide to ensure idempotency
-    #   of the request. For more information, see [Ensuring idempotency][1]
-    #   in the *Amazon EC2 API Reference*.
-    #
-    #   **A suitable default value is auto-generated.** You should normally
-    #   not need to pass this option.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html
-    #   @return [String]
-    #
     # @!attribute [rw] resource_tags
     #   The tags attached to the resource created by Image Builder.
     #   @return [Hash<String,String>]
@@ -7818,6 +7968,24 @@ module Aws::Imagebuilder
     #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/configuring-instance-metadata-options.html
     #   @return [Types::InstanceMetadataOptions]
     #
+    # @!attribute [rw] placement
+    #   The instance placement settings that define where the instances that
+    #   are launched from your image will run.
+    #   @return [Types::Placement]
+    #
+    # @!attribute [rw] client_token
+    #   Unique, case-sensitive identifier you provide to ensure idempotency
+    #   of the request. For more information, see [Ensuring idempotency][1]
+    #   in the *Amazon EC2 API Reference*.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/UpdateInfrastructureConfigurationRequest AWS API Documentation
     #
     class UpdateInfrastructureConfigurationRequest < Struct.new(
@@ -7831,9 +7999,10 @@ module Aws::Imagebuilder
       :key_pair,
       :terminate_instance_on_failure,
       :sns_topic_arn,
-      :client_token,
       :resource_tags,
-      :instance_metadata_options)
+      :instance_metadata_options,
+      :placement,
+      :client_token)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-imagebuilder.rb

@@ -54,7 +54,7 @@ module Aws::Imagebuilder
   autoload :EndpointProvider, 'aws-sdk-imagebuilder/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-imagebuilder/endpoints'
 
-  GEM_VERSION = '1.72.0'
+  GEM_VERSION = '1.74.0'
 
 end
 

data/sig/client.rbs

@@ -111,7 +111,7 @@ module Aws
                               semantic_version: ::String,
                               ?description: ::String,
                               ?change_description: ::String,
-                              platform: ("Windows" | "Linux"),
+                              platform: ("Windows" | "Linux" | "macOS"),
                               ?supported_os_versions: Array[::String],
                               ?data: ::String,
                               ?uri: ::String,
@@ -166,7 +166,7 @@ module Aws
                                      },
                                      ?dockerfile_template_data: ::String,
                                      ?dockerfile_template_uri: ::String,
-                                     ?platform_override: ("Windows" | "Linux"),
+                                     ?platform_override: ("Windows" | "Linux" | "macOS"),
                                      ?image_os_version_override: ::String,
                                      parent_image: ::String,
                                      ?tags: Hash[::String, ::String],
@@ -425,6 +425,12 @@ module Aws
                                                    http_put_response_hop_limit: ::Integer?
                                                  },
                                                  ?tags: Hash[::String, ::String],
+                                                 ?placement: {
+                                                   availability_zone: ::String?,
+                                                   tenancy: ("default" | "dedicated" | "host")?,
+                                                   host_id: ::String?,
+                                                   host_resource_group_arn: ::String?
+                                                 },
                                                  client_token: ::String
                                                ) -> _CreateInfrastructureConfigurationResponseSuccess
                                              | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateInfrastructureConfigurationResponseSuccess
@@ -744,6 +750,19 @@ module Aws
                                 ) -> _GetLifecyclePolicyResponseSuccess
                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetLifecyclePolicyResponseSuccess
 
+      interface _GetMarketplaceResourceResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetMarketplaceResourceResponse]
+        def resource_arn: () -> ::String
+        def url: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Imagebuilder/Client.html#get_marketplace_resource-instance_method
+      def get_marketplace_resource: (
+                                      resource_type: ("COMPONENT_DATA" | "COMPONENT_ARTIFACT"),
+                                      resource_arn: ::String,
+                                      ?resource_location: ::String
+                                    ) -> _GetMarketplaceResourceResponseSuccess
+                                  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetMarketplaceResourceResponseSuccess
+
       interface _GetWorkflowResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetWorkflowResponse]
         def workflow: () -> Types::Workflow
@@ -817,7 +836,7 @@ module Aws
                               ?change_description: ::String,
                               type: ("BUILD" | "TEST"),
                               format: ("SHELL"),
-                              platform: ("Windows" | "Linux"),
+                              platform: ("Windows" | "Linux" | "macOS"),
                               ?data: ::String,
                               ?uri: ::String,
                               ?kms_key_id: ::String,
@@ -837,7 +856,7 @@ module Aws
                              name: ::String,
                              semantic_version: ::String,
                              ?description: ::String,
-                             platform: ("Windows" | "Linux"),
+                             platform: ("Windows" | "Linux" | "macOS"),
                              ?os_version: ::String,
                              vm_import_task_id: ::String,
                              ?tags: Hash[::String, ::String],
@@ -867,7 +886,7 @@ module Aws
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Imagebuilder/Client.html#list_components-instance_method
       def list_components: (
-                             ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty"),
+                             ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty" | "AWSMarketplace"),
                              ?filters: Array[
                                {
                                  name: ::String?,
@@ -888,7 +907,7 @@ module Aws
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Imagebuilder/Client.html#list_container_recipes-instance_method
       def list_container_recipes: (
-                                    ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty"),
+                                    ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty" | "AWSMarketplace"),
                                     ?filters: Array[
                                       {
                                         name: ::String?,
@@ -1000,7 +1019,7 @@ module Aws
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Imagebuilder/Client.html#list_image_recipes-instance_method
       def list_image_recipes: (
-                                ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty"),
+                                ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty" | "AWSMarketplace"),
                                 ?filters: Array[
                                   {
                                     name: ::String?,
@@ -1056,7 +1075,7 @@ module Aws
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Imagebuilder/Client.html#list_images-instance_method
       def list_images: (
-                         ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty"),
+                         ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty" | "AWSMarketplace"),
                          ?filters: Array[
                            {
                              name: ::String?,
@@ -1212,7 +1231,7 @@ module Aws
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Imagebuilder/Client.html#list_workflows-instance_method
       def list_workflows: (
-                            ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty"),
+                            ?owner: ("Self" | "Shared" | "Amazon" | "ThirdParty" | "AWSMarketplace"),
                             ?filters: Array[
                               {
                                 name: ::String?,
@@ -1498,12 +1517,18 @@ module Aws
                                                  ?key_pair: ::String,
                                                  ?terminate_instance_on_failure: bool,
                                                  ?sns_topic_arn: ::String,
-                                                 client_token: ::String,
                                                  ?resource_tags: Hash[::String, ::String],
                                                  ?instance_metadata_options: {
                                                    http_tokens: ::String?,
                                                    http_put_response_hop_limit: ::Integer?
-                                                 }
+                                                 },
+                                                 ?placement: {
+                                                   availability_zone: ::String?,
+                                                   tenancy: ("default" | "dedicated" | "host")?,
+                                                   host_id: ::String?,
+                                                   host_resource_group_arn: ::String?
+                                                 },
+                                                 client_token: ::String
                                                ) -> _UpdateInfrastructureConfigurationResponseSuccess
                                              | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateInfrastructureConfigurationResponseSuccess