aws-sdk-ecs 1.193.0 → 1.194.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87c40760ea45c679271d1afac3dda39cf978f54202b3e5abde8a9f1656448002
-  data.tar.gz: d3742aeb3ba24251dded9a117f1ea98b613130112d05d44884a7d2e1981282d2
+  metadata.gz: ee3ea98304c30b7f4a951642bcdcaefe62f892514bde76debabd1cc01542237f
+  data.tar.gz: fe6518043d1024c569ad19f76723a3a3b95d7667e6e38315d66524e7073bb7e1
 SHA512:
-  metadata.gz: 13cc472445993c3bfcbc09b54971ba8105a595b80df567cfe2397805b197117deeb2770c28f213f0aebca6e11ec90e48aab7c00a9bdd8962a7d4d46a5105d32f
-  data.tar.gz: f0eae285ed5a9dba8fb274f4915526c7c76228381ebf21a603040e97723c928083d638396e129f0e6b65d5b2f363cc0a14e0d70daa8e571f84c2a0dd84495abb
+  metadata.gz: 7704db613a2eca8b7668508b4996940bf720a46514f7ca11683649af8fd766b616aa933d35addf1da7c1b203458f250ca8ef6ada66e18f0d3e024483fd8c1573
+  data.tar.gz: 6d6bda55d509d52b8fda932bba887c24bb8b2fc0e464958661f8aa04a95617ec129983bb3faea99ccab99089bab0c971deab289eaff2538d6b3eb9271c556dc2

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.194.0 (2025-06-12)
+------------------
+
+* Feature - This Amazon ECS  release supports updating the capacityProviderStrategy parameter in update-service.
+
 1.193.0 (2025-06-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.193.0
+1.194.0

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

@@ -11457,31 +11457,20 @@ module Aws::ECS
     #   Zone (based on the previous steps), favoring container instances
     #   with the largest number of running tasks for this service.
     #
-    # <note markdown="1"> You must have a service-linked role when you update any of the
-    # following service properties:
-    #
-    #  * `loadBalancers`,
-    #
-    # * `serviceRegistries`
-    #
-    #  For more information about the role see the `CreateService` request
-    # parameter [ `role` ][5].
-    #
-    #  </note>
-    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html#ebs-volume-types
     # [2]: https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
     # [3]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html
     # [4]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html
-    # [5]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html#ECS-CreateService-request-role
     #
     # @option params [String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster that
     #   your service runs on. If you do not specify a cluster, the default
     #   cluster is assumed.
     #
+    #   You can't change the cluster name.
+    #
     # @option params [required, String] :service
     #   The name of the service to update.
     #
@@ -11498,41 +11487,39 @@ module Aws::ECS
     #   after the new version is running.
     #
     # @option params [Array<Types::CapacityProviderStrategyItem>] :capacity_provider_strategy
-    #   The capacity provider strategy to update the service to use.
+    #   The details of a capacity provider strategy. You can set a capacity
+    #   provider when you create a cluster, run a task, or update a service.
     #
-    #   if the service uses the default capacity provider strategy for the
-    #   cluster, the service can be updated to use one or more capacity
-    #   providers as opposed to the default capacity provider strategy.
-    #   However, when a service is using a capacity provider strategy that's
-    #   not the default capacity provider strategy, the service can't be
-    #   updated to use the cluster's default capacity provider strategy.
+    #   When you use Fargate, the capacity providers are `FARGATE` or
+    #   `FARGATE_SPOT`.
     #
-    #   A capacity provider strategy consists of one or more capacity
-    #   providers along with the `base` and `weight` to assign to them. A
-    #   capacity provider must be associated with the cluster to be used in a
-    #   capacity provider strategy. The [PutClusterCapacityProviders][1] API
-    #   is used to associate a capacity provider with a cluster. Only capacity
-    #   providers with an `ACTIVE` or `UPDATING` status can be used.
+    #   When you use Amazon EC2, the capacity providers are Auto Scaling
+    #   groups.
     #
-    #   If specifying a capacity provider that uses an Auto Scaling group, the
-    #   capacity provider must already be created. New capacity providers can
-    #   be created with the [CreateClusterCapacityProvider][2] API operation.
+    #   You can change capacity providers for rolling deployments and
+    #   blue/green deployments.
     #
-    #   To use a Fargate capacity provider, specify either the `FARGATE` or
-    #   `FARGATE_SPOT` capacity providers. The Fargate capacity providers are
-    #   available to all accounts and only need to be associated with a
-    #   cluster to be used.
+    #   The following list provides the valid transitions:
     #
-    #   The [PutClusterCapacityProviders][1]API operation is used to update
-    #   the list of available capacity providers for a cluster after the
-    #   cluster is created.
+    #   * Update the Fargate launch type to an EC2 capacity provider.
     #
+    #   * Update the Amazon EC2 launch type to a Fargate capacity provider.
     #
+    #   * Update the Fargate capacity provider to an EC2 capacity provider.
     #
+    #   * Update the Amazon EC2 capacity provider to a Fargate capacity
+    #     provider.
     #
+    #   * Update the EC2 or Fargate capacity provider back to the launch type.
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
-    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateClusterCapacityProvider.html
+    #     Pass an empty list in the `capacityProvider` parameter.
+    #
+    #   For information about Amazon Web Services CDK considerations, see
+    #   [Amazon Web Services CDK considerations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-parameters.html
     #
     # @option params [Types::DeploymentConfiguration] :deployment_configuration
     #   Optional deployment parameters that control how many tasks run during
@@ -11629,6 +11616,10 @@ module Aws::ECS
     #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
     #
     # @option params [Array<Types::LoadBalancer>] :load_balancers
+    #   <note markdown="1"> You must have a service-linked role when you update this property
+    #
+    #    </note>
+    #
     #   A list of Elastic Load Balancing load balancer objects. It contains
     #   the load balancer name, the container name, and the container port to
     #   access from the load balancer. The container name is as it appears in
@@ -11675,8 +11666,15 @@ module Aws::ECS
     #   that Amazon ECS starts new tasks with the updated tags.
     #
     # @option params [Array<Types::ServiceRegistry>] :service_registries
+    #   <note markdown="1"> You must have a service-linked role when you update this property.
+    #
+    #    For more information about the role see the `CreateService` request
+    #   parameter [ `role` ][1].
+    #
+    #    </note>
+    #
     #   The details for the service discovery registries to assign to this
-    #   service. For more information, see [Service Discovery][1].
+    #   service. For more information, see [Service Discovery][2].
     #
     #   When you add, update, or remove the service registries configuration,
     #   Amazon ECS starts new tasks with the updated service registries
@@ -11687,7 +11685,8 @@ module Aws::ECS
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html#ECS-CreateService-request-role
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
     #
     # @option params [Types::ServiceConnectConfiguration] :service_connect_configuration
     #   The configuration for this service to discover and connect to
@@ -12563,7 +12562,7 @@ module Aws::ECS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.193.0'
+      context[:gem_version] = '1.194.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -5382,6 +5382,45 @@ module Aws::ECS
     # are part of a service, if the task reports as unhealthy then the task
     # will be stopped and the service scheduler will replace it.
     #
+    # When a container health check fails for a task that is part of a
+    # service, the following process occurs:
+    #
+    # 1.  The task is marked as `UNHEALTHY`.
+    #
+    # 2.  The unhealthy task will be stopped, and during the stopping
+    #     process, it will go through the following states:
+    #
+    #     * `DEACTIVATING` - In this state, Amazon ECS performs additional
+    #       steps before stopping the task. For example, for tasks that are
+    #       part of services configured to use Elastic Load Balancing target
+    #       groups, target groups will be deregistered in this state.
+    #
+    #     * `STOPPING` - The task is in the process of being stopped.
+    #
+    #     * `DEPROVISIONING` - Resources associated with the task are being
+    #       cleaned up.
+    #
+    #     * `STOPPED` - The task has been completely stopped.
+    # 3.  After the old task stops, a new task will be launched to ensure
+    #     service operation, and the new task will go through the following
+    #     lifecycle:
+    #
+    #     * `PROVISIONING` - Resources required for the task are being
+    #       provisioned.
+    #
+    #     * `PENDING` - The task is waiting to be placed on a container
+    #       instance.
+    #
+    #     * `ACTIVATING` - In this state, Amazon ECS pulls container images,
+    #       creates containers, configures task networking, registers load
+    #       balancer target groups, and configures service discovery status.
+    #
+    #     * `RUNNING` - The task is running and performing its work.
+    #
+    # For more detailed information about task lifecycle states, see [Task
+    # lifecycle][1] in the *Amazon Elastic Container Service Developer
+    # Guide*.
+    #
     # The following are notes about container health check support:
     #
     # * If the Amazon ECS container agent becomes disconnected from the
@@ -5396,25 +5435,26 @@ module Aws::ECS
     #
     # * Container health checks require version `1.17.0` or greater of the
     #   Amazon ECS container agent. For more information, see [Updating the
-    #   Amazon ECS container agent][1].
+    #   Amazon ECS container agent][2].
     #
     # * Container health checks are supported for Fargate tasks if you're
     #   using platform version `1.1.0` or greater. For more information, see
-    #   [Fargate platform versions][2].
+    #   [Fargate platform versions][3].
     #
     # * 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
+    # dependency][4] 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
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-lifecycle-explanation.html
+    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html
+    # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
+    # [4]: 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
@@ -13352,6 +13392,8 @@ module Aws::ECS
     #   The short name or full Amazon Resource Name (ARN) of the cluster
     #   that your service runs on. If you do not specify a cluster, the
     #   default cluster is assumed.
+    #
+    #   You can't change the cluster name.
     #   @return [String]
     #
     # @!attribute [rw] service
@@ -13373,44 +13415,40 @@ module Aws::ECS
     #   @return [String]
     #
     # @!attribute [rw] capacity_provider_strategy
-    #   The capacity provider strategy to update the service to use.
+    #   The details of a capacity provider strategy. You can set a capacity
+    #   provider when you create a cluster, run a task, or update a service.
     #
-    #   if the service uses the default capacity provider strategy for the
-    #   cluster, the service can be updated to use one or more capacity
-    #   providers as opposed to the default capacity provider strategy.
-    #   However, when a service is using a capacity provider strategy
-    #   that's not the default capacity provider strategy, the service
-    #   can't be updated to use the cluster's default capacity provider
-    #   strategy.
+    #   When you use Fargate, the capacity providers are `FARGATE` or
+    #   `FARGATE_SPOT`.
     #
-    #   A capacity provider strategy consists of one or more capacity
-    #   providers along with the `base` and `weight` to assign to them. A
-    #   capacity provider must be associated with the cluster to be used in
-    #   a capacity provider strategy. The [PutClusterCapacityProviders][1]
-    #   API is used to associate a capacity provider with a cluster. Only
-    #   capacity providers with an `ACTIVE` or `UPDATING` status can be
-    #   used.
+    #   When you use Amazon EC2, the capacity providers are Auto Scaling
+    #   groups.
     #
-    #   If specifying a capacity provider that uses an Auto Scaling group,
-    #   the capacity provider must already be created. New capacity
-    #   providers can be created with the [CreateClusterCapacityProvider][2]
-    #   API operation.
+    #   You can change capacity providers for rolling deployments and
+    #   blue/green deployments.
     #
-    #   To use a Fargate capacity provider, specify either the `FARGATE` or
-    #   `FARGATE_SPOT` capacity providers. The Fargate capacity providers
-    #   are available to all accounts and only need to be associated with a
-    #   cluster to be used.
+    #   The following list provides the valid transitions:
     #
-    #   The [PutClusterCapacityProviders][1]API operation is used to update
-    #   the list of available capacity providers for a cluster after the
-    #   cluster is created.
+    #   * Update the Fargate launch type to an EC2 capacity provider.
     #
+    #   * Update the Amazon EC2 launch type to a Fargate capacity provider.
     #
+    #   * Update the Fargate capacity provider to an EC2 capacity provider.
     #
+    #   * Update the Amazon EC2 capacity provider to a Fargate capacity
+    #     provider.
     #
+    #   * Update the EC2 or Fargate capacity provider back to the launch
+    #     type.
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
-    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateClusterCapacityProvider.html
+    #     Pass an empty list in the `capacityProvider` parameter.
+    #
+    #   For information about Amazon Web Services CDK considerations, see
+    #   [Amazon Web Services CDK considerations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-parameters.html
     #   @return [Array<Types::CapacityProviderStrategyItem>]
     #
     # @!attribute [rw] deployment_configuration
@@ -13522,6 +13560,10 @@ module Aws::ECS
     #   @return [Boolean]
     #
     # @!attribute [rw] load_balancers
+    #   <note markdown="1"> You must have a service-linked role when you update this property
+    #
+    #    </note>
+    #
     #   A list of Elastic Load Balancing load balancer objects. It contains
     #   the load balancer name, the container name, and the container port
     #   to access from the load balancer. The container name is as it
@@ -13570,8 +13612,15 @@ module Aws::ECS
     #   @return [String]
     #
     # @!attribute [rw] service_registries
+    #   <note markdown="1"> You must have a service-linked role when you update this property.
+    #
+    #    For more information about the role see the `CreateService` request
+    #   parameter [ `role` ][1].
+    #
+    #    </note>
+    #
     #   The details for the service discovery registries to assign to this
-    #   service. For more information, see [Service Discovery][1].
+    #   service. For more information, see [Service Discovery][2].
     #
     #   When you add, update, or remove the service registries
     #   configuration, Amazon ECS starts new tasks with the updated service
@@ -13583,7 +13632,8 @@ module Aws::ECS
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html#ECS-CreateService-request-role
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
     #   @return [Array<Types::ServiceRegistry>]
     #
     # @!attribute [rw] service_connect_configuration

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.193.0'
+  GEM_VERSION = '1.194.0'
 
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ecs
 version: !ruby/object:Gem::Version
-  version: 1.193.0
+  version: 1.194.0
 platform: ruby
 authors:
 - Amazon Web Services