aws-sdk-ecs 1.176.0 → 1.178.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37ad1f87862b811f03b27b2153d17aa2092171b8e3d818769419cfdc563c7f8a
-  data.tar.gz: 183f4b702240c30642d6f214e0a598baed9c26751f4ea86871484385fc01636b
+  metadata.gz: 1b4561a5807e5fe903700e0cde47ec9fc125537abe216cf24d038f9543d89232
+  data.tar.gz: e4f72015685fa1cc9766ec5c62a861ca2da949c79aa961ce635753bfb6e47dcb
 SHA512:
-  metadata.gz: 6da1093de9dc124ae8808e674c29fd04bc7729155dd76e455ac94c291a952cd14157aeeeb993d015498db3acab759674490a14536685c53bf63db446bf48f3f7
-  data.tar.gz: 5463f0d4355275a25b64a5c830894983c34a7a2747ed393c1b0115476553f5a3dedd7ce7323fed38b2c3fb3edb22c94b4433fb5145b0ad5f9092db2403205824
+  metadata.gz: 8605768a2833dee137709afec9e59d44857e0173b6a8af100d5637157666f0239377e41625ea6d6fa11b1d9143e47291f8e42dcf9b951593d24991bed4a3b6e6
+  data.tar.gz: 9282fae9b60bdd0aa378ea1ee0dd976af7fc40e74150b99f391b3c7730b96d8c2717bc17c59cdac8f4a7a06cfb0411bf9e598ef7f9667f867784ef824f30136d

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.178.0 (2025-02-13)
+------------------
+
+* Feature - This is a documentation only release to support migrating Amazon ECS service ARNs to the long ARN format.
+
+1.177.0 (2025-02-06)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.176.0 (2025-01-16)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.176.0
+1.178.0

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

@@ -1040,8 +1040,8 @@ module Aws::ECS
     #   service.
     #
     #   For more information, see [Balancing an Amazon ECS service across
-    #   Availability Zones][1] in the *Amazon Elastic Container Service
-    #   Developer Guide*.
+    #   Availability Zones][1] in the <i> <i>Amazon Elastic Container Service
+    #   Developer Guide</i> </i>.
     #
     #
     #
@@ -9635,7 +9635,7 @@ module Aws::ECS
     #   cluster is assumed.
     #
     # @option params [required, String] :task
-    #   The task ID of the task to stop.
+    #   Thefull Amazon Resource Name (ARN) of the task.
     #
     # @option params [String] :reason
     #   An optional message specified when a task is stopped. For example, if
@@ -10065,6 +10065,25 @@ module Aws::ECS
     #   Currently, the supported resources are Amazon ECS capacity providers,
     #   tasks, services, task definitions, clusters, and container instances.
     #
+    #   In order to tag a service that has the following ARN format, you need
+    #   to migrate the service to the long ARN. For more information, see
+    #   [Migrate an Amazon ECS short service ARN to a long ARN][1] in the
+    #   *Amazon Elastic Container Service Developer Guide*.
+    #
+    #   `arn:aws:ecs:region:aws_account_id:service/service-name`
+    #
+    #   After the migration is complete, the service has the long ARN format,
+    #   as shown below. Use this ARN to tag the service.
+    #
+    #   `arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name`
+    #
+    #   If you try to tag a service with a short ARN, you receive an
+    #   `InvalidParameterException` error.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-arn-migration.html
+    #
     # @option params [required, Array<Types::Tag>] :tags
     #   The tags to add to the resource. A tag is an array of key-value pairs.
     #
@@ -11411,8 +11430,8 @@ module Aws::ECS
     #   service.
     #
     #   For more information, see [Balancing an Amazon ECS service across
-    #   Availability Zones][1] in the *Amazon Elastic Container Service
-    #   Developer Guide*.
+    #   Availability Zones][1] in the <i> <i>Amazon Elastic Container Service
+    #   Developer Guide</i> </i>.
     #
     #
     #
@@ -12429,7 +12448,7 @@ module Aws::ECS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.176.0'
+      context[:gem_version] = '1.178.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -10,40 +10,36 @@
 module Aws::ECS
   class EndpointProvider
     def resolve_endpoint(parameters)
-      region = parameters.region
-      use_dual_stack = parameters.use_dual_stack
-      use_fips = parameters.use_fips
-      endpoint = parameters.endpoint
-      if Aws::Endpoints::Matchers.set?(endpoint)
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+      if Aws::Endpoints::Matchers.set?(parameters.endpoint)
+        if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true)
           raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+        if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
           raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
         end
-        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+        return Aws::Endpoints::Endpoint.new(url: parameters.endpoint, headers: {}, properties: {})
       end
-      if Aws::Endpoints::Matchers.set?(region)
-        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+      if Aws::Endpoints::Matchers.set?(parameters.region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(parameters.region))
+          if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
             if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-              return Aws::Endpoints::Endpoint.new(url: "https://ecs-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+              return Aws::Endpoints::Endpoint.new(url: "https://ecs-fips.#{parameters.region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+          if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true)
             if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
-              return Aws::Endpoints::Endpoint.new(url: "https://ecs-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+              return Aws::Endpoints::Endpoint.new(url: "https://ecs-fips.#{parameters.region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
           end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+          if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
             if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-              return Aws::Endpoints::Endpoint.new(url: "https://ecs.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+              return Aws::Endpoints::Endpoint.new(url: "https://ecs.#{parameters.region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          return Aws::Endpoints::Endpoint.new(url: "https://ecs.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+          return Aws::Endpoints::Endpoint.new(url: "https://ecs.#{parameters.region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
       end
       raise ArgumentError, "Invalid Configuration: Missing Region"

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

@@ -2650,8 +2650,8 @@ module Aws::ECS
     #   service.
     #
     #   For more information, see [Balancing an Amazon ECS service across
-    #   Availability Zones][1] in the *Amazon Elastic Container Service
-    #   Developer Guide*.
+    #   Availability Zones][1] in the <i> <i>Amazon Elastic Container
+    #   Service Developer Guide</i> </i>.
     #
     #
     #
@@ -5415,10 +5415,16 @@ module Aws::ECS
     # * Container health checks aren't supported for tasks that are part of
     #   a service that's configured to use a Classic Load Balancer.
     #
+    # For an example of how to specify a task definition with multiple
+    # containers where container dependency is specified, see [Container
+    # dependency][3] in the *Amazon Elastic Container Service Developer
+    # Guide*.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html
     # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
+    # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/example_task_definitions.html#example_task_definition-containerdependency
     #
     # @!attribute [rw] command
     #   A string array representing the command that the container runs to
@@ -5445,26 +5451,29 @@ module Aws::ECS
     # @!attribute [rw] interval
     #   The time period in seconds between each health check execution. You
     #   may specify between 5 and 300 seconds. The default value is 30
-    #   seconds.
+    #   seconds. This value applies only when you specify a `command`.
     #   @return [Integer]
     #
     # @!attribute [rw] timeout
     #   The time period in seconds to wait for a health check to succeed
     #   before it is considered a failure. You may specify between 2 and 60
-    #   seconds. The default value is 5.
+    #   seconds. The default value is 5. This value applies only when you
+    #   specify a `command`.
     #   @return [Integer]
     #
     # @!attribute [rw] retries
     #   The number of times to retry a failed health check before the
     #   container is considered unhealthy. You may specify between 1 and 10
-    #   retries. The default value is 3.
+    #   retries. The default value is 3. This value applies only when you
+    #   specify a `command`.
     #   @return [Integer]
     #
     # @!attribute [rw] start_period
     #   The optional grace period to provide containers time to bootstrap
     #   before failed health checks count towards the maximum number of
     #   retries. You can specify between 0 and 300 seconds. By default, the
-    #   `startPeriod` is off.
+    #   `startPeriod` is off. This value applies only when you specify a
+    #   `command`.
     #
     #   <note markdown="1"> If a health check succeeds within the `startPeriod`, then the
     #   container is considered healthy and any subsequent failures count
@@ -5639,9 +5648,36 @@ module Aws::ECS
     # detailed information about these Linux capabilities, see the
     # [capabilities(7)][1] Linux manual page.
     #
+    # The following describes how Docker processes the Linux capabilities
+    # specified in the `add` and `drop` request parameters. For information
+    # about the latest behavior, see [Docker Compose: order of cap\_drop and
+    # cap\_add][2] in the Docker Community Forum.
+    #
+    # * When the container is a privleged container, the container
+    #   capabilities are all of the default Docker capabilities. The
+    #   capabilities specified in the `add` request parameter, and the
+    #   `drop` request parameter are ignored.
+    #
+    # * When the `add` request parameter is set to ALL, the container
+    #   capabilities are all of the default Docker capabilities, excluding
+    #   those specified in the `drop` request parameter.
+    #
+    # * When the `drop` request parameter is set to ALL, the container
+    #   capabilities are the capabilities specified in the `add` request
+    #   parameter.
+    #
+    # * When the `add` request parameter and the `drop` request parameter
+    #   are both empty, the capabilities the container capabilities are all
+    #   of the default Docker capabilities.
+    #
+    # * The default is to first drop the capabilities specified in the
+    #   `drop` request parameter, and then add the capabilities specified in
+    #   the `add` request parameter.
+    #
     #
     #
     # [1]: http://man7.org/linux/man-pages/man7/capabilities.7.html
+    # [2]: https://forums.docker.com/t/docker-compose-order-of-cap-drop-and-cap-add/97136/1
     #
     # @!attribute [rw] add
     #   The Linux capabilities for the container that have been added to the
@@ -7199,11 +7235,15 @@ module Aws::ECS
     # @!attribute [rw] kms_key_id
     #   Specify a Key Management Service key ID to encrypt the managed
     #   storage.
+    #
+    #   The key must be a single Region key.
     #   @return [String]
     #
     # @!attribute [rw] fargate_ephemeral_storage_kms_key_id
     #   Specify the Key Management Service key ID for the Fargate ephemeral
     #   storage.
+    #
+    #   The key must be a single Region key.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ManagedStorageConfiguration AWS API Documentation
@@ -9612,8 +9652,8 @@ module Aws::ECS
     #   service.
     #
     #   For more information, see [Balancing an Amazon ECS service across
-    #   Availability Zones][1] in the *Amazon Elastic Container Service
-    #   Developer Guide*.
+    #   Availability Zones][1] in the <i> <i>Amazon Elastic Container
+    #   Service Developer Guide</i> </i>.
     #
     #
     #
@@ -10993,7 +11033,7 @@ module Aws::ECS
     #   @return [String]
     #
     # @!attribute [rw] task
-    #   The task ID of the task to stop.
+    #   Thefull Amazon Resource Name (ARN) of the task.
     #   @return [String]
     #
     # @!attribute [rw] reason
@@ -11316,6 +11356,25 @@ module Aws::ECS
     #   Currently, the supported resources are Amazon ECS capacity
     #   providers, tasks, services, task definitions, clusters, and
     #   container instances.
+    #
+    #   In order to tag a service that has the following ARN format, you
+    #   need to migrate the service to the long ARN. For more information,
+    #   see [Migrate an Amazon ECS short service ARN to a long ARN][1] in
+    #   the *Amazon Elastic Container Service Developer Guide*.
+    #
+    #   `arn:aws:ecs:region:aws_account_id:service/service-name`
+    #
+    #   After the migration is complete, the service has the long ARN
+    #   format, as shown below. Use this ARN to tag the service.
+    #
+    #   `arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name`
+    #
+    #   If you try to tag a service with a short ARN, you receive an
+    #   `InvalidParameterException` error.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-arn-migration.html
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -13279,8 +13338,8 @@ module Aws::ECS
     #   service.
     #
     #   For more information, see [Balancing an Amazon ECS service across
-    #   Availability Zones][1] in the *Amazon Elastic Container Service
-    #   Developer Guide*.
+    #   Availability Zones][1] in the <i> <i>Amazon Elastic Container
+    #   Service Developer Guide</i> </i>.
     #
     #
     #

data/lib/aws-sdk-ecs.rb

@@ -55,7 +55,7 @@ module Aws::ECS
   autoload :EndpointProvider, 'aws-sdk-ecs/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-ecs/endpoints'
 
-  GEM_VERSION = '1.176.0'
+  GEM_VERSION = '1.178.0'
 
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ecs
 version: !ruby/object:Gem::Version
-  version: 1.176.0
+  version: 1.178.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-16 00:00:00.000000000 Z
+date: 2025-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core