aws-sdk-imagebuilder 1.107.0 → 1.108.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d4c2823ae22ffa510bcb905aad6f60f27208f9ee5f8d3c2a1156e18513548cf
-  data.tar.gz: 9e97a1336d054e9646e2199ea006f2f097b3aa17427820a5997a1e4481c2cc15
+  metadata.gz: 778424d35315adab825fdae777a8d8428f8bc623ac99f461b13b8929014b3560
+  data.tar.gz: eb78e4a013a1bdfc5abcb8795cf7374abf10929fc93d8b5b5237666f37ab40ed
 SHA512:
-  metadata.gz: 2ee1df5779fb9fb9d81fb2c764febf10de2480270c119683282cedba3dd045671f4c6501c729680060646e295fec8be0e5e78125d1140b9d16dde2462d73c1a9
-  data.tar.gz: 6a32755423dcdd71139b0ceba0e8bd22cfb4f14d42369d9b65f113f4957e45e4628dbfa797130c3c9dc0cb1b22c77d68b4ec46c294f5323bc923a759ec883aa4
+  metadata.gz: 570a9ddc212aa72f235d02c4013b4927b20795431e59671da20973f6505b9f7db48e0969733385f5a87565dcc62a944c311e5a9ffdc0162785e069ff1e9bddc2
+  data.tar.gz: cbf6239fc38280c2dd013c3235e9e2c7a887b8ff8ddf7e11ba4b1f7ba984168374ce9a3feb977c129f8a0805264a4d61064d49fd0e97d35d37feb1209e0adddf

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.108.0 (2026-06-29)
+------------------
+
+* Feature - Adds support for AMI watermarks in Image Builder.
+
 1.107.0 (2026-05-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.107.0
+1.108.0

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

@@ -1190,7 +1190,12 @@ module Aws::Imagebuilder
     #   that grants Image Builder access to perform workflow actions.
     #
     # @option params [Types::PipelineLoggingConfiguration] :logging_configuration
-    #   Define logging configuration for the image build process.
+    #   Specifies the logging configuration for the image pipeline. Use this
+    #   to define custom CloudWatch Logs log groups for your pipeline
+    #   execution logs and image build logs. The service manages log groups
+    #   with names starting with `/aws/imagebuilder/` using the service-linked
+    #   role. For custom log group names outside of this prefix, you must also
+    #   provide an `executionRole`.
     #
     # @return [Types::CreateImagePipelineResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1336,6 +1341,17 @@ module Aws::Imagebuilder
     #   Tags that are applied to the AMI that Image Builder creates during the
     #   Build phase prior to image distribution.
     #
+    # @option params [Array<String>] :ami_watermarks
+    #   The AMI watermark names to attach to the output AMI from this recipe.
+    #   AMI watermarks are lineage markers. They automatically propagate to
+    #   derivative AMIs when the source AMI is copied or distributed across
+    #   Regions or accounts.
+    #
+    #   <note markdown="1"> AMI watermarks are supported only for image recipes. AMIs with
+    #   watermarks cannot be made public.
+    #
+    #    </note>
+    #
     # @option params [required, String] :client_token
     #   Unique, case-sensitive identifier you provide to ensure idempotency of
     #   the request. For more information, see [Ensuring idempotency][1] in
@@ -1403,6 +1419,7 @@ module Aws::Imagebuilder
     #     ami_tags: {
     #       "TagKey" => "TagValue",
     #     },
+    #     ami_watermarks: ["AmiWatermarkName"],
     #     client_token: "ClientToken", # required
     #   })
     #
@@ -2097,18 +2114,25 @@ module Aws::Imagebuilder
       req.send_request(options)
     end
 
-    # DistributeImage distributes existing AMIs to additional regions and
-    # accounts without rebuilding the image.
+    # Distributes an existing AMI to target Regions and accounts without
+    # running the full image build process. This operation only runs the
+    # distribution phase on an image that has already been built.
     #
     # @option params [required, String] :source_image
-    #   The source image Amazon Resource Name (ARN) to distribute.
+    #   The source image to distribute. Specify an AMI identifier, SSM
+    #   parameter path, or Image Builder image Amazon Resource Name (ARN).
+    #   When you specify an Image Builder image Amazon Resource Name (ARN),
+    #   the image must be in the `AVAILABLE` state.
     #
     # @option params [required, String] :distribution_configuration_arn
-    #   The Amazon Resource Name (ARN) of the distribution configuration to
-    #   use.
+    #   The Amazon Resource Name (ARN) of the distribution configuration. The
+    #   configuration defines target Regions, accounts, and AMI settings. The
+    #   distribution configuration must be in the same Region as this
+    #   operation.
     #
     # @option params [required, String] :execution_role
-    #   The IAM role to use for the distribution.
+    #   The name or Amazon Resource Name (ARN) of the IAM role that Image
+    #   Builder assumes to distribute the image.
     #
     # @option params [Hash<String,String>] :tags
     #   The tags to apply to the distributed image.
@@ -2503,6 +2527,8 @@ module Aws::Imagebuilder
     #   resp.image.image_recipe.additional_instance_configuration.user_data_override #=> String
     #   resp.image.image_recipe.ami_tags #=> Hash
     #   resp.image.image_recipe.ami_tags["TagKey"] #=> String
+    #   resp.image.image_recipe.ami_watermarks #=> Array
+    #   resp.image.image_recipe.ami_watermarks[0] #=> String
     #   resp.image.container_recipe.arn #=> String
     #   resp.image.container_recipe.container_type #=> String, one of "DOCKER"
     #   resp.image.container_recipe.name #=> String
@@ -2827,6 +2853,8 @@ module Aws::Imagebuilder
     #   resp.image_recipe.additional_instance_configuration.user_data_override #=> String
     #   resp.image_recipe.ami_tags #=> Hash
     #   resp.image_recipe.ami_tags["TagKey"] #=> String
+    #   resp.image_recipe.ami_watermarks #=> Array
+    #   resp.image_recipe.ami_watermarks[0] #=> String
     #   resp.latest_version_references.latest_version_arn #=> String
     #   resp.latest_version_references.latest_major_version_arn #=> String
     #   resp.latest_version_references.latest_minor_version_arn #=> String
@@ -5333,15 +5361,20 @@ module Aws::Imagebuilder
     #   Uniquely identifies the workflow step that sent the step action.
     #
     # @option params [required, String] :image_build_version_arn
-    #   The Amazon Resource Name (ARN) of the image build version to send
-    #   action for.
+    #   The Amazon Resource Name (ARN) of the image build version associated
+    #   with the workflow step execution. This value must match the image that
+    #   owns the waiting step. If the ARN does not correspond to the image
+    #   running the workflow, then the request fails with a validation error.
     #
     # @option params [required, String] :action
-    #   The action for the image creation process to take while a workflow
-    #   `WaitForAction` step waits for an asynchronous action to complete.
+    #   The action to perform on the paused workflow step. The workflow step
+    #   must be in a waiting state to accept an action. The request fails if
+    #   the step has already timed out or been actioned.
     #
     # @option params [String] :reason
-    #   The reason why this action is sent.
+    #   The reason for the action. This value is stored with the step
+    #   execution record and is accessible in subsequent workflow steps via
+    #   step output references.
     #
     # @option params [required, String] :client_token
     #   Unique, case-sensitive identifier you provide to ensure idempotency of
@@ -5443,26 +5476,38 @@ module Aws::Imagebuilder
     # specified image resources.
     #
     # @option params [required, String] :resource_arn
-    #   The Amazon Resource Name (ARN) of the Image Builder resource that is
-    #   updated. The state update might also impact associated resources.
+    #   The Amazon Resource Name (ARN) of the image build version to update.
+    #   The image must be in one of these terminal states: `AVAILABLE`,
+    #   `DEPRECATED`, `DISABLED`, `FAILED`, or `CANCELLED`. Images with
+    #   `FAILED` or `CANCELLED` status can transition only to `DELETED`.
     #
     # @option params [required, Types::ResourceState] :state
-    #   Indicates the lifecycle action to take for this request.
+    #   Specifies the lifecycle action to take for this request. For AMI-based
+    #   images, valid values are `AVAILABLE`, `DEPRECATED`, `DISABLED`, and
+    #   `DELETED`. For container-based images, only `DELETED` is supported.
     #
     # @option params [String] :execution_role
     #   The name or Amazon Resource Name (ARN) of the IAM role that’s used to
     #   update image state.
     #
     # @option params [Types::ResourceStateUpdateIncludeResources] :include_resources
-    #   A list of image resources to update state for.
+    #   Specifies which image resources to include in the state update. When
+    #   specified, the lifecycle action applies to underlying resources. These
+    #   resources include AMIs, snapshots, and containers in addition to the
+    #   Image Builder image resource. Requires `executionRole` to also be
+    #   specified. To delete an image and its underlying resources, you must
+    #   specify `includeResources`. To delete only the Image Builder image
+    #   record without affecting underlying resources, use the `DeleteImage`
+    #   API instead.
     #
     # @option params [Types::ResourceStateUpdateExclusionRules] :exclusion_rules
     #   Skip action on the image resource and associated resources if
     #   specified exclusion rules are met.
     #
     # @option params [Time,DateTime,Date,Integer,String] :update_at
-    #   The timestamp that indicates when resources are updated by a lifecycle
-    #   action.
+    #   Specifies the timestamp when the state transition takes effect. Use
+    #   this parameter only when the target status is `DEPRECATED`. The value
+    #   must be a future time.
     #
     # @option params [required, String] :client_token
     #   Unique, case-sensitive identifier you provide to ensure idempotency of
@@ -6123,7 +6168,7 @@ module Aws::Imagebuilder
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-imagebuilder'
-      context[:gem_version] = '1.107.0'
+      context[:gem_version] = '1.108.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -23,6 +23,8 @@ module Aws::Imagebuilder
     AmiDistributionConfiguration = Shapes::StructureShape.new(name: 'AmiDistributionConfiguration')
     AmiList = Shapes::ListShape.new(name: 'AmiList')
     AmiNameString = Shapes::StringShape.new(name: 'AmiNameString')
+    AmiWatermarkName = Shapes::StringShape.new(name: 'AmiWatermarkName')
+    AmiWatermarksList = Shapes::ListShape.new(name: 'AmiWatermarksList')
     Arn = Shapes::StringShape.new(name: 'Arn')
     AutoDisableFailureCount = Shapes::IntegerShape.new(name: 'AutoDisableFailureCount')
     AutoDisablePolicy = Shapes::StructureShape.new(name: 'AutoDisablePolicy')
@@ -525,6 +527,8 @@ module Aws::Imagebuilder
 
     AmiList.member = Shapes::ShapeRef.new(shape: Ami)
 
+    AmiWatermarksList.member = Shapes::ShapeRef.new(shape: AmiWatermarkName)
+
     AutoDisablePolicy.add_member(:failure_count, Shapes::ShapeRef.new(shape: AutoDisableFailureCount, required: true, location_name: "failureCount"))
     AutoDisablePolicy.struct_class = Types::AutoDisablePolicy
 
@@ -763,6 +767,7 @@ module Aws::Imagebuilder
     CreateImageRecipeRequest.add_member(:working_directory, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "workingDirectory"))
     CreateImageRecipeRequest.add_member(:additional_instance_configuration, Shapes::ShapeRef.new(shape: AdditionalInstanceConfiguration, location_name: "additionalInstanceConfiguration"))
     CreateImageRecipeRequest.add_member(:ami_tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "amiTags"))
+    CreateImageRecipeRequest.add_member(:ami_watermarks, Shapes::ShapeRef.new(shape: AmiWatermarksList, location_name: "amiWatermarks"))
     CreateImageRecipeRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, required: true, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
     CreateImageRecipeRequest.struct_class = Types::CreateImageRecipeRequest
 
@@ -1263,6 +1268,7 @@ module Aws::Imagebuilder
     ImageRecipe.add_member(:working_directory, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "workingDirectory"))
     ImageRecipe.add_member(:additional_instance_configuration, Shapes::ShapeRef.new(shape: AdditionalInstanceConfiguration, location_name: "additionalInstanceConfiguration"))
     ImageRecipe.add_member(:ami_tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "amiTags"))
+    ImageRecipe.add_member(:ami_watermarks, Shapes::ShapeRef.new(shape: AmiWatermarksList, location_name: "amiWatermarks"))
     ImageRecipe.struct_class = Types::ImageRecipe
 
     ImageRecipeSummary.add_member(:arn, Shapes::ShapeRef.new(shape: ImageBuilderArn, location_name: "arn"))

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

@@ -1423,7 +1423,12 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] logging_configuration
-    #   Define logging configuration for the image build process.
+    #   Specifies the logging configuration for the image pipeline. Use this
+    #   to define custom CloudWatch Logs log groups for your pipeline
+    #   execution logs and image build logs. The service manages log groups
+    #   with names starting with `/aws/imagebuilder/` using the
+    #   service-linked role. For custom log group names outside of this
+    #   prefix, you must also provide an `executionRole`.
     #   @return [Types::PipelineLoggingConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/CreateImagePipelineRequest AWS API Documentation
@@ -1547,6 +1552,18 @@ module Aws::Imagebuilder
     #   the Build phase prior to image distribution.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] ami_watermarks
+    #   The AMI watermark names to attach to the output AMI from this
+    #   recipe. AMI watermarks are lineage markers. They automatically
+    #   propagate to derivative AMIs when the source AMI is copied or
+    #   distributed across Regions or accounts.
+    #
+    #   <note markdown="1"> AMI watermarks are supported only for image recipes. AMIs with
+    #   watermarks cannot be made public.
+    #
+    #    </note>
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] client_token
     #   Unique, case-sensitive identifier you provide to ensure idempotency
     #   of the request. For more information, see [Ensuring idempotency][1]
@@ -1573,6 +1590,7 @@ module Aws::Imagebuilder
       :working_directory,
       :additional_instance_configuration,
       :ami_tags,
+      :ami_watermarks,
       :client_token)
       SENSITIVE = []
       include Aws::Structure
@@ -2439,16 +2457,22 @@ module Aws::Imagebuilder
     end
 
     # @!attribute [rw] source_image
-    #   The source image Amazon Resource Name (ARN) to distribute.
+    #   The source image to distribute. Specify an AMI identifier, SSM
+    #   parameter path, or Image Builder image Amazon Resource Name (ARN).
+    #   When you specify an Image Builder image Amazon Resource Name (ARN),
+    #   the image must be in the `AVAILABLE` state.
     #   @return [String]
     #
     # @!attribute [rw] distribution_configuration_arn
-    #   The Amazon Resource Name (ARN) of the distribution configuration to
-    #   use.
+    #   The Amazon Resource Name (ARN) of the distribution configuration.
+    #   The configuration defines target Regions, accounts, and AMI
+    #   settings. The distribution configuration must be in the same Region
+    #   as this operation.
     #   @return [String]
     #
     # @!attribute [rw] execution_role
-    #   The IAM role to use for the distribution.
+    #   The name or Amazon Resource Name (ARN) of the IAM role that Image
+    #   Builder assumes to distribute the image.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -4142,6 +4166,12 @@ module Aws::Imagebuilder
     #   the Build phase prior to image distribution.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] ami_watermarks
+    #   The AMI watermark names attached to the output AMI from this recipe.
+    #   AMI watermarks are lineage markers that automatically propagate to
+    #   derivative AMIs when the source AMI is copied or distributed.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ImageRecipe AWS API Documentation
     #
     class ImageRecipe < Struct.new(
@@ -4159,7 +4189,8 @@ module Aws::Imagebuilder
       :tags,
       :working_directory,
       :additional_instance_configuration,
-      :ami_tags)
+      :ami_tags,
+      :ami_watermarks)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -7421,15 +7452,22 @@ module Aws::Imagebuilder
     # The logging configuration that's defined for pipeline execution.
     #
     # @!attribute [rw] image_log_group_name
-    #   The log group name that Image Builder uses for image creation. If
-    #   not specified, the log group name defaults to
-    #   `/aws/imagebuilder/image-name`.
+    #   Specifies the CloudWatch Logs log group name for image build logs.
+    #   The log group name can contain alphanumeric characters, hyphens,
+    #   underscores, forward slashes, and periods, up to 512 characters. Log
+    #   group names not starting with `/aws/imagebuilder/` require an
+    #   `executionRole` with CloudWatch Logs write permissions. If not
+    #   specified, defaults to `/aws/imagebuilder/image-name`.
     #   @return [String]
     #
     # @!attribute [rw] pipeline_log_group_name
-    #   The log group name that Image Builder uses for the log output during
-    #   creation of a new pipeline. If not specified, the pipeline log group
-    #   name defaults to `/aws/imagebuilder/pipeline/pipeline-name`.
+    #   Specifies the CloudWatch Logs log group name for pipeline execution
+    #   logs. The log group name can contain alphanumeric characters,
+    #   hyphens, underscores, forward slashes, and periods, up to 512
+    #   characters. Log group names not starting with `/aws/imagebuilder/`
+    #   require an `executionRole` with CloudWatch Logs write permissions.
+    #   If not specified, defaults to
+    #   `/aws/imagebuilder/pipeline/pipeline-name`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/PipelineLoggingConfiguration AWS API Documentation
@@ -8018,17 +8056,23 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] image_build_version_arn
-    #   The Amazon Resource Name (ARN) of the image build version to send
-    #   action for.
+    #   The Amazon Resource Name (ARN) of the image build version associated
+    #   with the workflow step execution. This value must match the image
+    #   that owns the waiting step. If the ARN does not correspond to the
+    #   image running the workflow, then the request fails with a validation
+    #   error.
     #   @return [String]
     #
     # @!attribute [rw] action
-    #   The action for the image creation process to take while a workflow
-    #   `WaitForAction` step waits for an asynchronous action to complete.
+    #   The action to perform on the paused workflow step. The workflow step
+    #   must be in a waiting state to accept an action. The request fails if
+    #   the step has already timed out or been actioned.
     #   @return [String]
     #
     # @!attribute [rw] reason
-    #   The reason why this action is sent.
+    #   The reason for the action. This value is stored with the step
+    #   execution record and is accessible in subsequent workflow steps via
+    #   step output references.
     #   @return [String]
     #
     # @!attribute [rw] client_token
@@ -8244,12 +8288,17 @@ module Aws::Imagebuilder
     end
 
     # @!attribute [rw] resource_arn
-    #   The Amazon Resource Name (ARN) of the Image Builder resource that is
-    #   updated. The state update might also impact associated resources.
+    #   The Amazon Resource Name (ARN) of the image build version to update.
+    #   The image must be in one of these terminal states: `AVAILABLE`,
+    #   `DEPRECATED`, `DISABLED`, `FAILED`, or `CANCELLED`. Images with
+    #   `FAILED` or `CANCELLED` status can transition only to `DELETED`.
     #   @return [String]
     #
     # @!attribute [rw] state
-    #   Indicates the lifecycle action to take for this request.
+    #   Specifies the lifecycle action to take for this request. For
+    #   AMI-based images, valid values are `AVAILABLE`, `DEPRECATED`,
+    #   `DISABLED`, and `DELETED`. For container-based images, only
+    #   `DELETED` is supported.
     #   @return [Types::ResourceState]
     #
     # @!attribute [rw] execution_role
@@ -8258,7 +8307,14 @@ module Aws::Imagebuilder
     #   @return [String]
     #
     # @!attribute [rw] include_resources
-    #   A list of image resources to update state for.
+    #   Specifies which image resources to include in the state update. When
+    #   specified, the lifecycle action applies to underlying resources.
+    #   These resources include AMIs, snapshots, and containers in addition
+    #   to the Image Builder image resource. Requires `executionRole` to
+    #   also be specified. To delete an image and its underlying resources,
+    #   you must specify `includeResources`. To delete only the Image
+    #   Builder image record without affecting underlying resources, use the
+    #   `DeleteImage` API instead.
     #   @return [Types::ResourceStateUpdateIncludeResources]
     #
     # @!attribute [rw] exclusion_rules
@@ -8267,8 +8323,9 @@ module Aws::Imagebuilder
     #   @return [Types::ResourceStateUpdateExclusionRules]
     #
     # @!attribute [rw] update_at
-    #   The timestamp that indicates when resources are updated by a
-    #   lifecycle action.
+    #   Specifies the timestamp when the state transition takes effect. Use
+    #   this parameter only when the target status is `DEPRECATED`. The
+    #   value must be a future time.
     #   @return [Time]
     #
     # @!attribute [rw] client_token

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.107.0'
+  GEM_VERSION = '1.108.0'
 
 end
 

data/sig/client.rbs

@@ -305,6 +305,7 @@ module Aws
                                    user_data_override: ::String?
                                  },
                                  ?ami_tags: Hash[::String, ::String],
+                                 ?ami_watermarks: Array[::String],
                                  client_token: ::String
                                ) -> _CreateImageRecipeResponseSuccess
                              | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateImageRecipeResponseSuccess

data/sig/types.rbs

@@ -320,6 +320,7 @@ module Aws::Imagebuilder
       attr_accessor working_directory: ::String
       attr_accessor additional_instance_configuration: Types::AdditionalInstanceConfiguration
       attr_accessor ami_tags: ::Hash[::String, ::String]
+      attr_accessor ami_watermarks: ::Array[::String]
       attr_accessor client_token: ::String
       SENSITIVE: []
     end
@@ -972,6 +973,7 @@ module Aws::Imagebuilder
       attr_accessor working_directory: ::String
       attr_accessor additional_instance_configuration: Types::AdditionalInstanceConfiguration
       attr_accessor ami_tags: ::Hash[::String, ::String]
+      attr_accessor ami_watermarks: ::Array[::String]
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-imagebuilder
 version: !ruby/object:Gem::Version
-  version: 1.107.0
+  version: 1.108.0
 platform: ruby
 authors:
 - Amazon Web Services