aws-sdk-ecs 1.131.0 → 1.132.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd17f1e96153338ba22930d8515bf665cf7b7e8c173a9a46590b3cfa6a4e0125
-  data.tar.gz: 29d3ac3597bbc14d5ad9f16a08c2b6bb454758cf8298abacd1e4500016cac6c0
+  metadata.gz: f5afd949b55e070bf5f8a67f10a0e327978673863391c39c8fa0f52c4fa4e853
+  data.tar.gz: a757989985ae8d40eecb35acf59a64ec0e1a602bd2cc6efdcf5c5c38029bb42c
 SHA512:
-  metadata.gz: '0860585a980ad315b8163803b7f30bbf90e14aed2acf44d6a942f508469fa31930559fcbd09ca5a29f8898eb0e9c2279802c898bf617379491b021f843132599'
-  data.tar.gz: 879bd85d459640b803946299845711e5c85216236ce5751799ef0be31293c36cb38f1ba92f7057b811ee3e4f56016f62e096a9ae64ffebfefa2709cfbc740dc4
+  metadata.gz: 79340759d24324526b48e1566f04b26fb1fd6a10d4c9412fa6df9f4ec7126b78366b5baafabe071fb5c5e7e041661cd7bbc38781b69da16b2a783f28e462a61d
+  data.tar.gz: 057f62d07a55e79d47dadd978cdb4bc3812eb6728c7fd20296c40c5a93d200c199ccce1e1f5719010646aa781a9fc756356282cef8bf4c13a0dfd786b3b8b0ab

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.132.0 (2023-11-13)
+------------------
+
+* Feature - Adds a Client Token parameter to the ECS RunTask API. The Client Token parameter allows for idempotent RunTask requests.
+
 1.131.0 (2023-10-17)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.131.0
+1.132.0

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

@@ -974,8 +974,8 @@ module Aws::ECS
     #
     # @option params [String] :client_token
     #   An identifier that you provide to ensure the idempotency of the
-    #   request. It must be unique and is case sensitive. Up to 32 ASCII
-    #   characters are allowed.
+    #   request. It must be unique and is case sensitive. Up to 36 ASCII
+    #   characters in the range of 33-126 (inclusive) are allowed.
     #
     # @option params [String] :launch_type
     #   The infrastructure that you run your service on. For more information,
@@ -1704,9 +1704,9 @@ module Aws::ECS
     #   and keep running in the task set.
     #
     # @option params [String] :client_token
-    #   The identifier that you provide to ensure the idempotency of the
-    #   request. It's case sensitive and must be unique. It can be up to 32
-    #   ASCII characters are allowed.
+    #   An identifier that you provide to ensure the idempotency of the
+    #   request. It must be unique and is case sensitive. Up to 36 ASCII
+    #   characters in the range of 33-126 (inclusive) are allowed.
     #
     # @option params [Array<Types::Tag>] :tags
     #   The metadata that you apply to the task set to help you categorize and
@@ -7144,7 +7144,7 @@ module Aws::ECS
     #   apply a unique identifier for that job to your task with the
     #   `startedBy` parameter. You can then identify which tasks belong to
     #   that job by filtering the results of a ListTasks call with the
-    #   `startedBy` value. Up to 36 letters (uppercase and lowercase),
+    #   `startedBy` value. Up to 128 letters (uppercase and lowercase),
     #   numbers, hyphens (-), and underscores (\_) are allowed.
     #
     #   If a task is started by an Amazon ECS service, then the `startedBy`
@@ -7212,6 +7212,20 @@ module Aws::ECS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-resources
     #
+    # @option params [String] :client_token
+    #   An identifier that you provide to ensure the idempotency of the
+    #   request. It must be unique and is case sensitive. Up to 64 characters
+    #   are allowed. The valid characters are characters in the range of
+    #   33-126, inclusive. For more information, see [Ensuring
+    #   idempotency][1].
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/ECS_Idempotency.html
+    #
     # @return [Types::RunTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::RunTaskResponse#tasks #tasks} => Array&lt;Types::Task&gt;
@@ -7343,6 +7357,7 @@ module Aws::ECS
     #       },
     #     ],
     #     task_definition: "String", # required
+    #     client_token: "String",
     #   })
     #
     # @example Response structure
@@ -9808,7 +9823,7 @@ module Aws::ECS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.131.0'
+      context[:gem_version] = '1.132.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -60,6 +60,7 @@ module Aws::ECS
     Clusters = Shapes::ListShape.new(name: 'Clusters')
     Compatibility = Shapes::StringShape.new(name: 'Compatibility')
     CompatibilityList = Shapes::ListShape.new(name: 'CompatibilityList')
+    ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     Connectivity = Shapes::StringShape.new(name: 'Connectivity')
     Container = Shapes::StructureShape.new(name: 'Container')
     ContainerCondition = Shapes::StringShape.new(name: 'ContainerCondition')
@@ -266,6 +267,7 @@ module Aws::ECS
     RepositoryCredentials = Shapes::StructureShape.new(name: 'RepositoryCredentials')
     RequiresAttributes = Shapes::ListShape.new(name: 'RequiresAttributes')
     Resource = Shapes::StructureShape.new(name: 'Resource')
+    ResourceIds = Shapes::ListShape.new(name: 'ResourceIds')
     ResourceInUseException = Shapes::StructureShape.new(name: 'ResourceInUseException')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResourceRequirement = Shapes::StructureShape.new(name: 'ResourceRequirement')
@@ -501,6 +503,9 @@ module Aws::ECS
 
     CompatibilityList.member = Shapes::ShapeRef.new(shape: Compatibility)
 
+    ConflictException.add_member(:resource_ids, Shapes::ShapeRef.new(shape: ResourceIds, location_name: "resourceIds"))
+    ConflictException.struct_class = Types::ConflictException
+
     Container.add_member(:container_arn, Shapes::ShapeRef.new(shape: String, location_name: "containerArn"))
     Container.add_member(:task_arn, Shapes::ShapeRef.new(shape: String, location_name: "taskArn"))
     Container.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
@@ -1327,6 +1332,8 @@ module Aws::ECS
     Resource.add_member(:string_set_value, Shapes::ShapeRef.new(shape: StringList, location_name: "stringSetValue"))
     Resource.struct_class = Types::Resource
 
+    ResourceIds.member = Shapes::ShapeRef.new(shape: String)
+
     ResourceInUseException.struct_class = Types::ResourceInUseException
 
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
@@ -1356,6 +1363,7 @@ module Aws::ECS
     RunTaskRequest.add_member(:started_by, Shapes::ShapeRef.new(shape: String, location_name: "startedBy"))
     RunTaskRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
     RunTaskRequest.add_member(:task_definition, Shapes::ShapeRef.new(shape: String, required: true, location_name: "taskDefinition"))
+    RunTaskRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: String, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
     RunTaskRequest.struct_class = Types::RunTaskRequest
 
     RunTaskResponse.add_member(:tasks, Shapes::ShapeRef.new(shape: Tasks, location_name: "tasks"))
@@ -2389,6 +2397,7 @@ module Aws::ECS
         o.errors << Shapes::ShapeRef.new(shape: PlatformTaskDefinitionIncompatibilityException)
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: BlockedException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
 
       api.add_operation(:start_task, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-ecs/errors.rb

@@ -35,6 +35,7 @@ module Aws::ECS
   # * {ClusterContainsServicesException}
   # * {ClusterContainsTasksException}
   # * {ClusterNotFoundException}
+  # * {ConflictException}
   # * {InvalidParameterException}
   # * {LimitExceededException}
   # * {MissingVersionException}
@@ -144,6 +145,21 @@ module Aws::ECS
       end
     end
 
+    class ConflictException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ECS::Types::ConflictException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def resource_ids
+        @data[:resource_ids]
+      end
+    end
+
     class InvalidParameterException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -419,7 +419,7 @@ module Aws::ECS
 
     # These errors are usually caused by a client action. This client action
     # might be using an action or resource on behalf of a user that doesn't
-    # have permissions to use the action or resource,. Or, it might be
+    # have permissions to use the action or resource. Or, it might be
     # specifying an identifier that isn't valid.
     #
     # @!attribute [rw] message
@@ -817,6 +817,31 @@ module Aws::ECS
       include Aws::Structure
     end
 
+    # The `RunTask` request could not be processed due to conflicts. The
+    # provided `clientToken` is already in use with a different `RunTask`
+    # request. The `resourceIds` are the existing task ARNs which are
+    # already associated with the `clientToken`.
+    #
+    # To fix this issue:
+    #
+    # * Run `RunTask` with a unique `clientToken`.
+    #
+    # * Run `RunTask` with the `clientToken` and the original set of
+    #   parameters
+    #
+    # @!attribute [rw] resource_ids
+    #   The existing task ARNs which are already associated with the
+    #   `clientToken`.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ConflictException AWS API Documentation
+    #
+    class ConflictException < Struct.new(
+      :resource_ids)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A Docker container that's part of a task.
     #
     # @!attribute [rw] container_arn
@@ -2677,8 +2702,8 @@ module Aws::ECS
     #
     # @!attribute [rw] client_token
     #   An identifier that you provide to ensure the idempotency of the
-    #   request. It must be unique and is case sensitive. Up to 32 ASCII
-    #   characters are allowed.
+    #   request. It must be unique and is case sensitive. Up to 36 ASCII
+    #   characters in the range of 33-126 (inclusive) are allowed.
     #   @return [String]
     #
     # @!attribute [rw] launch_type
@@ -3099,9 +3124,9 @@ module Aws::ECS
     #   @return [Types::Scale]
     #
     # @!attribute [rw] client_token
-    #   The identifier that you provide to ensure the idempotency of the
-    #   request. It's case sensitive and must be unique. It can be up to 32
-    #   ASCII characters are allowed.
+    #   An identifier that you provide to ensure the idempotency of the
+    #   request. It must be unique and is case sensitive. Up to 36 ASCII
+    #   characters in the range of 33-126 (inclusive) are allowed.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -7071,7 +7096,9 @@ module Aws::ECS
     #
     # @!attribute [rw] protocol
     #   The protocol used for the port mapping. Valid values are `tcp` and
-    #   `udp`. The default is `tcp`.
+    #   `udp`. The default is `tcp`. `protocol` is immutable in a Service
+    #   Connect service. Updating this field requires a service deletion and
+    #   redeployment.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -7103,6 +7130,9 @@ module Aws::ECS
     #   However, Amazon ECS doesn't add protocol-specific telemetry for
     #   TCP.
     #
+    #   `appProtocol` is immutable in a Service Connect service. Updating
+    #   this field requires a service deletion and redeployment.
+    #
     #   Tasks that run in a namespace can use short names to connect to
     #   services in the namespace. Tasks can connect to services across all
     #   of the clusters in the namespace. Tasks connect through a managed
@@ -8328,7 +8358,7 @@ module Aws::ECS
     #   could apply a unique identifier for that job to your task with the
     #   `startedBy` parameter. You can then identify which tasks belong to
     #   that job by filtering the results of a ListTasks call with the
-    #   `startedBy` value. Up to 36 letters (uppercase and lowercase),
+    #   `startedBy` value. Up to 128 letters (uppercase and lowercase),
     #   numbers, hyphens (-), and underscores (\_) are allowed.
     #
     #   If a task is started by an Amazon ECS service, then the `startedBy`
@@ -8399,6 +8429,21 @@ module Aws::ECS
     #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-resources
     #   @return [String]
     #
+    # @!attribute [rw] client_token
+    #   An identifier that you provide to ensure the idempotency of the
+    #   request. It must be unique and is case sensitive. Up to 64
+    #   characters are allowed. The valid characters are characters in the
+    #   range of 33-126, inclusive. For more information, see [Ensuring
+    #   idempotency][1].
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/ECS_Idempotency.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/RunTaskRequest AWS API Documentation
     #
     class RunTaskRequest < Struct.new(
@@ -8418,7 +8463,8 @@ module Aws::ECS
       :reference_id,
       :started_by,
       :tags,
-      :task_definition)
+      :task_definition,
+      :client_token)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-ecs.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-ecs/customizations'
 # @!group service
 module Aws::ECS
 
-  GEM_VERSION = '1.131.0'
+  GEM_VERSION = '1.132.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ecs
 version: !ruby/object:Gem::Version
-  version: 1.131.0
+  version: 1.132.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-17 00:00:00.000000000 Z
+date: 2023-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core