aws-sdk-ecs 1.75.0 → 1.76.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 392d9ad82de139ba254e8f660c6ba9b9ec96de7e5c7b38545debc4925a25c9cd
-  data.tar.gz: 8283d6687252baeee9c253b06ca04e3b3687023bd06f5ed5752cfa7affada868
+  metadata.gz: 174825452c22c1558f83709cc3f9317ed5f73b1c95dc292969fd152e3a395d3c
+  data.tar.gz: 98ada088a63296a732cf7ea0ef75d6538be65813d4d1eeb1140be84258ae8960
 SHA512:
-  metadata.gz: 75fdfcc378063165f8a7bf39ceefb8b8f1af205496210ae57203d85fa39efa5a998818526d7633e3d481e42c1c02f4b5fdd9ada33da8433d277f7761ee1f6152
-  data.tar.gz: a7480a0be0bc2edf3276420c86ff71fc54907b32795b0b0aafb70e5b3cdf60f20899251a5ab7b9d175d597b3f8f58c4110372b885370540ccafa7494ee499cbb
+  metadata.gz: 21b72b3e7879f9fec814b1f00dfedf70782b4be00c53bfdce1da72f1d272abc927e32a80f248955a900bec8d3e6bb7663b1521b859b844c8d2968ceddc215749
+  data.tar.gz: faf85ea430af07628e1e91980912e7926b7d4c9345b06218a9c8b539d5e7d4d9c081f96eef286d53d6135b766739fbc7b4a632396a7c134855ca78c49283548f

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.76.0 (2021-03-15)
+------------------
+
+* Feature - This is for ecs exec feature release which includes two new APIs - execute-command and update-cluster and an AWS CLI customization for execute-command API
+
 1.75.0 (2021-03-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.75.0
+1.76.0

data/lib/aws-sdk-ecs.rb

@@ -49,6 +49,6 @@ require_relative 'aws-sdk-ecs/customizations'
 # @!group service
 module Aws::ECS
 
-  GEM_VERSION = '1.75.0'
+  GEM_VERSION = '1.76.0'
 
 end

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

@@ -499,14 +499,20 @@ module Aws::ECS
     #   specified, it will override the `containerInsights` value set with
     #   PutAccountSetting or PutAccountSettingDefault.
     #
+    # @option params [Types::ClusterConfiguration] :configuration
+    #   The execute command configuration for the cluster.
+    #
     # @option params [Array<String>] :capacity_providers
     #   The short name of one or more capacity providers to associate with the
-    #   cluster.
+    #   cluster. A capacity provider must be associated with a cluster before
+    #   it can be included as part of the default capacity provider strategy
+    #   of the cluster or used in a capacity provider strategy when calling
+    #   the CreateService or RunTask actions.
     #
     #   If specifying a capacity provider that uses an Auto Scaling group, the
     #   capacity provider must already be created and not already associated
-    #   with another cluster. New capacity providers can be created with the
-    #   CreateCapacityProvider API operation.
+    #   with another cluster. New Auto Scaling group capacity providers can be
+    #   created with the CreateCapacityProvider API operation.
     #
     #   To use a AWS Fargate capacity provider, specify either the `FARGATE`
     #   or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
@@ -518,27 +524,11 @@ module Aws::ECS
     #   is created.
     #
     # @option params [Array<Types::CapacityProviderStrategyItem>] :default_capacity_provider_strategy
-    #   The capacity provider strategy to use by default for the cluster.
-    #
-    #   When creating a service or running a task on a cluster, if no capacity
-    #   provider or launch type is specified then the default capacity
-    #   provider strategy for the cluster is used.
-    #
-    #   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 API is
-    #   used to associate a capacity provider with a cluster. Only capacity
-    #   providers with an `ACTIVE` or `UPDATING` status can be used.
-    #
-    #   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 CreateCapacityProvider API operation.
-    #
-    #   To use a AWS Fargate capacity provider, specify either the `FARGATE`
-    #   or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
-    #   providers are available to all accounts and only need to be associated
-    #   with a cluster to be used.
+    #   The capacity provider strategy to set as the default for the cluster.
+    #   When a default capacity provider strategy is set for a cluster, when
+    #   calling the RunTask or CreateService APIs wtih no capacity provider
+    #   strategy or launch type specified, the default capacity provider
+    #   strategy for the cluster is used.
     #
     #   If a default capacity provider strategy is not defined for a cluster
     #   during creation, it can be defined later with the
@@ -586,6 +576,19 @@ module Aws::ECS
     #         value: "String",
     #       },
     #     ],
+    #     configuration: {
+    #       execute_command_configuration: {
+    #         kms_key_id: "String",
+    #         logging: "NONE", # accepts NONE, DEFAULT, OVERRIDE
+    #         log_configuration: {
+    #           cloud_watch_log_group_name: "String",
+    #           cloud_watch_encryption_enabled: false,
+    #           s3_bucket_name: "String",
+    #           s3_encryption_enabled: false,
+    #           s3_key_prefix: "String",
+    #         },
+    #       },
+    #     },
     #     capacity_providers: ["String"],
     #     default_capacity_provider_strategy: [
     #       {
@@ -600,6 +603,13 @@ module Aws::ECS
     #
     #   resp.cluster.cluster_arn #=> String
     #   resp.cluster.cluster_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
+    #   resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
     #   resp.cluster.status #=> String
     #   resp.cluster.registered_container_instances_count #=> Integer
     #   resp.cluster.running_tasks_count #=> Integer
@@ -790,7 +800,7 @@ module Aws::ECS
     #   Load Balancer, you must specify one or more target group ARNs to
     #   attach to the service. The service-linked role is required for
     #   services that make use of multiple target groups. For more
-    #   information, see [Using Service-Linked Roles for Amazon ECS][2] in the
+    #   information, see [Using service-linked roles for Amazon ECS][2] in the
     #   *Amazon Elastic Container Service Developer Guide*.
     #
     #   If the service is using the `CODE_DEPLOY` deployment controller, the
@@ -841,11 +851,11 @@ module Aws::ECS
     #
     # @option params [Array<Types::ServiceRegistry>] :service_registries
     #   The details of the service discovery registries to assign to this
-    #   service. For more information, see [Service Discovery][1].
+    #   service. For more information, see [Service discovery][1].
     #
     #   <note markdown="1"> Service discovery is supported for Fargate tasks if you are using
     #   platform version v1.1.0 or later. For more information, see [AWS
-    #   Fargate Platform Versions][2].
+    #   Fargate platform versions][2].
     #
     #    </note>
     #
@@ -867,9 +877,16 @@ module Aws::ECS
     #   idempotency of the request. Up to 32 ASCII characters are allowed.
     #
     # @option params [String] :launch_type
-    #   The launch type on which to run your service. For more information,
-    #   see [Amazon ECS Launch Types][1] in the *Amazon Elastic Container
-    #   Service Developer Guide*.
+    #   The launch type on which to run your service. The accepted values are
+    #   `FARGATE` and `EC2`. For more information, see [Amazon ECS launch
+    #   types][1] in the *Amazon Elastic Container Service Developer Guide*.
+    #
+    #   When a value of `FARGATE` is specified, your tasks are launched on AWS
+    #   Fargate On-Demand infrastructure. To use Fargate Spot, you must use a
+    #   capacity provider strategy with the `FARGATE_SPOT` capacity provider.
+    #
+    #   When a value of `EC2` is specified, your tasks are launched on Amazon
+    #   EC2 instances registered to your cluster.
     #
     #   If a `launchType` is specified, the `capacityProviderStrategy`
     #   parameter must be omitted.
@@ -881,37 +898,17 @@ module Aws::ECS
     # @option params [Array<Types::CapacityProviderStrategyItem>] :capacity_provider_strategy
     #   The capacity provider strategy to use for the service.
     #
-    #   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 API is
-    #   used to associate a capacity provider with a cluster. Only capacity
-    #   providers with an `ACTIVE` or `UPDATING` status can be used.
-    #
     #   If a `capacityProviderStrategy` is specified, the `launchType`
     #   parameter must be omitted. If no `capacityProviderStrategy` or
     #   `launchType` is specified, the `defaultCapacityProviderStrategy` for
     #   the cluster is used.
     #
-    #   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 CreateCapacityProvider API operation.
-    #
-    #   To use a AWS Fargate capacity provider, specify either the `FARGATE`
-    #   or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
-    #   providers are available to all accounts and only need to be associated
-    #   with a cluster to be used.
-    #
-    #   The PutClusterCapacityProviders API operation is used to update the
-    #   list of available capacity providers for a cluster after the cluster
-    #   is created.
-    #
     # @option params [String] :platform_version
     #   The platform version that your tasks in the service are running on. A
     #   platform version is specified only for tasks using the Fargate launch
     #   type. If one isn't specified, the `LATEST` platform version is used
-    #   by default. For more information, see [AWS Fargate Platform
-    #   Versions][1] in the *Amazon Elastic Container Service Developer
+    #   by default. For more information, see [AWS Fargate platform
+    #   versions][1] in the *Amazon Elastic Container Service Developer
     #   Guide*.
     #
     #
@@ -933,14 +930,14 @@ module Aws::ECS
     #   configured to use service discovery, an external deployment
     #   controller, multiple target groups, or Elastic Inference accelerators
     #   in which case you should not specify a role here. For more
-    #   information, see [Using Service-Linked Roles for Amazon ECS][1] in the
+    #   information, see [Using service-linked roles for Amazon ECS][1] in the
     #   *Amazon Elastic Container Service Developer Guide*.
     #
     #   If your specified role has a path other than `/`, then you must either
     #   specify the full role ARN (this is recommended) or prefix the role
     #   name with the path. For example, if a role with the name `bar` has a
     #   path of `/foo/` then you would specify `/foo/bar` as the role name.
-    #   For more information, see [Friendly Names and Paths][2] in the *IAM
+    #   For more information, see [Friendly names and paths][2] in the *IAM
     #   User Guide*.
     #
     #
@@ -966,7 +963,7 @@ module Aws::ECS
     #   The network configuration for the service. This parameter is required
     #   for task definitions that use the `awsvpc` network mode to receive
     #   their own elastic network interface, and it is not supported for other
-    #   network modes. For more information, see [Task Networking][1] in the
+    #   network modes. For more information, see [Task networking][1] in the
     #   *Amazon Elastic Container Service Developer Guide*.
     #
     #
@@ -1071,6 +1068,11 @@ module Aws::ECS
     #   within the service during service creation. To add tags to a task
     #   after service creation, use the TagResource API action.
     #
+    # @option params [Boolean] :enable_execute_command
+    #   Whether or not the execute command functionality is enabled for the
+    #   service. If `true`, this enables execute command functionality on all
+    #   containers in the service tasks.
+    #
     # @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateServiceResponse#service #service} => Types::Service
@@ -1267,6 +1269,7 @@ module Aws::ECS
     #     ],
     #     enable_ecs_managed_tags: false,
     #     propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
+    #     enable_execute_command: false,
     #   })
     #
     # @example Response structure
@@ -1390,6 +1393,7 @@ module Aws::ECS
     #   resp.service.created_by #=> String
     #   resp.service.enable_ecs_managed_tags #=> Boolean
     #   resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
+    #   resp.service.enable_execute_command #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateService AWS API Documentation
     #
@@ -1881,6 +1885,13 @@ module Aws::ECS
     #
     #   resp.cluster.cluster_arn #=> String
     #   resp.cluster.cluster_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
+    #   resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
     #   resp.cluster.status #=> String
     #   resp.cluster.registered_container_instances_count #=> Integer
     #   resp.cluster.running_tasks_count #=> Integer
@@ -2102,6 +2113,7 @@ module Aws::ECS
     #   resp.service.created_by #=> String
     #   resp.service.enable_ecs_managed_tags #=> Boolean
     #   resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
+    #   resp.service.enable_execute_command #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteService AWS API Documentation
     #
@@ -2695,7 +2707,7 @@ module Aws::ECS
     #
     #   resp = client.describe_clusters({
     #     clusters: ["String"],
-    #     include: ["ATTACHMENTS"], # accepts ATTACHMENTS, SETTINGS, STATISTICS, TAGS
+    #     include: ["ATTACHMENTS"], # accepts ATTACHMENTS, CONFIGURATIONS, SETTINGS, STATISTICS, TAGS
     #   })
     #
     # @example Response structure
@@ -2703,6 +2715,13 @@ module Aws::ECS
     #   resp.clusters #=> Array
     #   resp.clusters[0].cluster_arn #=> String
     #   resp.clusters[0].cluster_name #=> String
+    #   resp.clusters[0].configuration.execute_command_configuration.kms_key_id #=> String
+    #   resp.clusters[0].configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
+    #   resp.clusters[0].configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
+    #   resp.clusters[0].configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
+    #   resp.clusters[0].configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
+    #   resp.clusters[0].configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
+    #   resp.clusters[0].configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
     #   resp.clusters[0].status #=> String
     #   resp.clusters[0].registered_container_instances_count #=> Integer
     #   resp.clusters[0].running_tasks_count #=> Integer
@@ -3137,6 +3156,7 @@ module Aws::ECS
     #   resp.services[0].created_by #=> String
     #   resp.services[0].enable_ecs_managed_tags #=> Boolean
     #   resp.services[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
+    #   resp.services[0].enable_execute_command #=> Boolean
     #   resp.failures #=> Array
     #   resp.failures[0].arn #=> String
     #   resp.failures[0].reason #=> String
@@ -3640,6 +3660,11 @@ module Aws::ECS
     #   resp.tasks[0].containers[0].network_interfaces[0].private_ipv_4_address #=> String
     #   resp.tasks[0].containers[0].network_interfaces[0].ipv6_address #=> String
     #   resp.tasks[0].containers[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
+    #   resp.tasks[0].containers[0].managed_agents #=> Array
+    #   resp.tasks[0].containers[0].managed_agents[0].last_started_at #=> Time
+    #   resp.tasks[0].containers[0].managed_agents[0].name #=> String, one of "ExecuteCommandAgent"
+    #   resp.tasks[0].containers[0].managed_agents[0].reason #=> String
+    #   resp.tasks[0].containers[0].managed_agents[0].last_status #=> String
     #   resp.tasks[0].containers[0].cpu #=> String
     #   resp.tasks[0].containers[0].memory #=> String
     #   resp.tasks[0].containers[0].memory_reservation #=> String
@@ -3648,6 +3673,7 @@ module Aws::ECS
     #   resp.tasks[0].cpu #=> String
     #   resp.tasks[0].created_at #=> Time
     #   resp.tasks[0].desired_status #=> String
+    #   resp.tasks[0].enable_execute_command #=> Boolean
     #   resp.tasks[0].execution_stopped_at #=> Time
     #   resp.tasks[0].group #=> String
     #   resp.tasks[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
@@ -3760,6 +3786,66 @@ module Aws::ECS
       req.send_request(options)
     end
 
+    # Runs a command remotely on a container within a task.
+    #
+    # @option params [String] :cluster
+    #   The Amazon Resource Name (ARN) or short name of the cluster the task
+    #   is running in. If you do not specify a cluster, the default cluster is
+    #   assumed.
+    #
+    # @option params [String] :container
+    #   The name of the container to execute the command on. A container name
+    #   only needs to be specified for tasks containing multiple containers.
+    #
+    # @option params [required, String] :command
+    #   The command to run on the container.
+    #
+    # @option params [required, Boolean] :interactive
+    #   Use this flag to run your command in interactive mode.
+    #
+    # @option params [required, String] :task
+    #   The Amazon Resource Name (ARN) or ID of the task the container is part
+    #   of.
+    #
+    # @return [Types::ExecuteCommandResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ExecuteCommandResponse#cluster_arn #cluster_arn} => String
+    #   * {Types::ExecuteCommandResponse#container_arn #container_arn} => String
+    #   * {Types::ExecuteCommandResponse#container_name #container_name} => String
+    #   * {Types::ExecuteCommandResponse#interactive #interactive} => Boolean
+    #   * {Types::ExecuteCommandResponse#session #session} => Types::Session
+    #   * {Types::ExecuteCommandResponse#task_arn #task_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.execute_command({
+    #     cluster: "String",
+    #     container: "String",
+    #     command: "String", # required
+    #     interactive: false, # required
+    #     task: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cluster_arn #=> String
+    #   resp.container_arn #=> String
+    #   resp.container_name #=> String
+    #   resp.interactive #=> Boolean
+    #   resp.session.session_id #=> String
+    #   resp.session.stream_url #=> String
+    #   resp.session.token_value #=> String
+    #   resp.task_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ExecuteCommand AWS API Documentation
+    #
+    # @overload execute_command(params = {})
+    # @param [Hash] params ({})
+    def execute_command(params = {}, options = {})
+      req = build_request(:execute_command, params)
+      req.send_request(options)
+    end
+
     # Lists the account settings for a specified principal.
     #
     # @option params [String] :name
@@ -5005,6 +5091,13 @@ module Aws::ECS
     #
     #   resp.cluster.cluster_arn #=> String
     #   resp.cluster.cluster_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
+    #   resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
     #   resp.cluster.status #=> String
     #   resp.cluster.registered_container_instances_count #=> Integer
     #   resp.cluster.running_tasks_count #=> Integer
@@ -5350,9 +5443,9 @@ module Aws::ECS
     #
     # @option params [Array<String>] :requires_compatibilities
     #   The task launch type that Amazon ECS should validate the task
-    #   definition against. This ensures that the task definition parameters
-    #   are compatible with the specified launch type. If no value is
-    #   specified, it defaults to `EC2`.
+    #   definition against. A client exception is returned if the task
+    #   definition doesn't validate against the compatibilities specified. If
+    #   no value is specified, the parameter is omitted from the response.
     #
     # @option params [String] :cpu
     #   The number of CPU units used by the task. It can be expressed as an
@@ -5468,8 +5561,8 @@ module Aws::ECS
     #   risk of undesired process namespace expose. For more information, see
     #   [Docker security][2].
     #
-    #   <note markdown="1"> This parameter is not supported for Windows containers or tasks using
-    #   the Fargate launch type.
+    #   <note markdown="1"> This parameter is not supported for Windows containers or tasks run on
+    #   AWS Fargate.
     #
     #    </note>
     #
@@ -5507,8 +5600,8 @@ module Aws::ECS
     #   * For tasks that use the `task` IPC mode, IPC namespace related
     #     `systemControls` will apply to all containers within a task.
     #
-    #   <note markdown="1"> This parameter is not supported for Windows containers or tasks using
-    #   the Fargate launch type.
+    #   <note markdown="1"> This parameter is not supported for Windows containers or tasks run on
+    #   AWS Fargate.
     #
     #    </note>
     #
@@ -6037,31 +6130,11 @@ module Aws::ECS
     # @option params [Array<Types::CapacityProviderStrategyItem>] :capacity_provider_strategy
     #   The capacity provider strategy to use for the task.
     #
-    #   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 API is
-    #   used to associate a capacity provider with a cluster. Only capacity
-    #   providers with an `ACTIVE` or `UPDATING` status can be used.
-    #
     #   If a `capacityProviderStrategy` is specified, the `launchType`
     #   parameter must be omitted. If no `capacityProviderStrategy` or
     #   `launchType` is specified, the `defaultCapacityProviderStrategy` for
     #   the cluster is used.
     #
-    #   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 CreateCapacityProvider API operation.
-    #
-    #   To use a AWS Fargate capacity provider, specify either the `FARGATE`
-    #   or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
-    #   providers are available to all accounts and only need to be associated
-    #   with a cluster to be used.
-    #
-    #   The PutClusterCapacityProviders API operation is used to update the
-    #   list of available capacity providers for a cluster after the cluster
-    #   is created.
-    #
     # @option params [String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster on
     #   which to run your task. If you do not specify a cluster, the default
@@ -6080,15 +6153,27 @@ module Aws::ECS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
     #
+    # @option params [Boolean] :enable_execute_command
+    #   Whether or not to enable the execute command functionality for the
+    #   containers in this task. If `true`, this enables execute command
+    #   functionality on all containers in the task.
+    #
     # @option params [String] :group
     #   The name of the task group to associate with the task. The default
     #   value is the family name of the task definition (for example,
     #   family:my-family-name).
     #
     # @option params [String] :launch_type
-    #   The launch type on which to run your task. For more information, see
-    #   [Amazon ECS Launch Types][1] in the *Amazon Elastic Container Service
-    #   Developer Guide*.
+    #   The launch type on which to run your task. The accepted values are
+    #   `FARGATE` and `EC2`. For more information, see [Amazon ECS Launch
+    #   Types][1] in the *Amazon Elastic Container Service Developer Guide*.
+    #
+    #   When a value of `FARGATE` is specified, your tasks are launched on AWS
+    #   Fargate On-Demand infrastructure. To use Fargate Spot, you must use a
+    #   capacity provider strategy with the `FARGATE_SPOT` capacity provider.
+    #
+    #   When a value of `EC2` is specified, your tasks are launched on Amazon
+    #   EC2 instances registered to your cluster.
     #
     #   If a `launchType` is specified, the `capacityProviderStrategy`
     #   parameter must be omitted.
@@ -6260,6 +6345,7 @@ module Aws::ECS
     #     cluster: "String",
     #     count: 1,
     #     enable_ecs_managed_tags: false,
+    #     enable_execute_command: false,
     #     group: "String",
     #     launch_type: "EC2", # accepts EC2, FARGATE
     #     network_configuration: {
@@ -6374,6 +6460,11 @@ module Aws::ECS
     #   resp.tasks[0].containers[0].network_interfaces[0].private_ipv_4_address #=> String
     #   resp.tasks[0].containers[0].network_interfaces[0].ipv6_address #=> String
     #   resp.tasks[0].containers[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
+    #   resp.tasks[0].containers[0].managed_agents #=> Array
+    #   resp.tasks[0].containers[0].managed_agents[0].last_started_at #=> Time
+    #   resp.tasks[0].containers[0].managed_agents[0].name #=> String, one of "ExecuteCommandAgent"
+    #   resp.tasks[0].containers[0].managed_agents[0].reason #=> String
+    #   resp.tasks[0].containers[0].managed_agents[0].last_status #=> String
     #   resp.tasks[0].containers[0].cpu #=> String
     #   resp.tasks[0].containers[0].memory #=> String
     #   resp.tasks[0].containers[0].memory_reservation #=> String
@@ -6382,6 +6473,7 @@ module Aws::ECS
     #   resp.tasks[0].cpu #=> String
     #   resp.tasks[0].created_at #=> Time
     #   resp.tasks[0].desired_status #=> String
+    #   resp.tasks[0].enable_execute_command #=> Boolean
     #   resp.tasks[0].execution_stopped_at #=> Time
     #   resp.tasks[0].group #=> String
     #   resp.tasks[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
@@ -6473,6 +6565,11 @@ module Aws::ECS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
     #
+    # @option params [Boolean] :enable_execute_command
+    #   Whether or not the execute command functionality is enabled for the
+    #   task. If `true`, this enables execute command functionality on all
+    #   containers in the task.
+    #
     # @option params [String] :group
     #   The name of the task group to associate with the task. The default
     #   value is the family name of the task definition (for example,
@@ -6564,6 +6661,7 @@ module Aws::ECS
     #     cluster: "String",
     #     container_instances: ["String"], # required
     #     enable_ecs_managed_tags: false,
+    #     enable_execute_command: false,
     #     group: "String",
     #     network_configuration: {
     #       awsvpc_configuration: {
@@ -6664,6 +6762,11 @@ module Aws::ECS
     #   resp.tasks[0].containers[0].network_interfaces[0].private_ipv_4_address #=> String
     #   resp.tasks[0].containers[0].network_interfaces[0].ipv6_address #=> String
     #   resp.tasks[0].containers[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
+    #   resp.tasks[0].containers[0].managed_agents #=> Array
+    #   resp.tasks[0].containers[0].managed_agents[0].last_started_at #=> Time
+    #   resp.tasks[0].containers[0].managed_agents[0].name #=> String, one of "ExecuteCommandAgent"
+    #   resp.tasks[0].containers[0].managed_agents[0].reason #=> String
+    #   resp.tasks[0].containers[0].managed_agents[0].last_status #=> String
     #   resp.tasks[0].containers[0].cpu #=> String
     #   resp.tasks[0].containers[0].memory #=> String
     #   resp.tasks[0].containers[0].memory_reservation #=> String
@@ -6672,6 +6775,7 @@ module Aws::ECS
     #   resp.tasks[0].cpu #=> String
     #   resp.tasks[0].created_at #=> Time
     #   resp.tasks[0].desired_status #=> String
+    #   resp.tasks[0].enable_execute_command #=> Boolean
     #   resp.tasks[0].execution_stopped_at #=> Time
     #   resp.tasks[0].group #=> String
     #   resp.tasks[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
@@ -6821,6 +6925,11 @@ module Aws::ECS
     #   resp.task.containers[0].network_interfaces[0].private_ipv_4_address #=> String
     #   resp.task.containers[0].network_interfaces[0].ipv6_address #=> String
     #   resp.task.containers[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
+    #   resp.task.containers[0].managed_agents #=> Array
+    #   resp.task.containers[0].managed_agents[0].last_started_at #=> Time
+    #   resp.task.containers[0].managed_agents[0].name #=> String, one of "ExecuteCommandAgent"
+    #   resp.task.containers[0].managed_agents[0].reason #=> String
+    #   resp.task.containers[0].managed_agents[0].last_status #=> String
     #   resp.task.containers[0].cpu #=> String
     #   resp.task.containers[0].memory #=> String
     #   resp.task.containers[0].memory_reservation #=> String
@@ -6829,6 +6938,7 @@ module Aws::ECS
     #   resp.task.cpu #=> String
     #   resp.task.created_at #=> Time
     #   resp.task.desired_status #=> String
+    #   resp.task.enable_execute_command #=> Boolean
     #   resp.task.execution_stopped_at #=> Time
     #   resp.task.group #=> String
     #   resp.task.health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
@@ -7024,6 +7134,9 @@ module Aws::ECS
     # @option params [Array<Types::AttachmentStateChange>] :attachments
     #   Any attachments associated with the state change request.
     #
+    # @option params [Array<Types::ManagedAgentStateChange>] :managed_agents
+    #   The details for the managed agent associated with the task.
+    #
     # @option params [Time,DateTime,Date,Integer,String] :pull_started_at
     #   The Unix timestamp for when the container image pull began.
     #
@@ -7068,6 +7181,14 @@ module Aws::ECS
     #         status: "String", # required
     #       },
     #     ],
+    #     managed_agents: [
+    #       {
+    #         container_name: "String", # required
+    #         managed_agent_name: "ExecuteCommandAgent", # required, accepts ExecuteCommandAgent
+    #         status: "String", # required
+    #         reason: "String",
+    #       },
+    #     ],
     #     pull_started_at: Time.now,
     #     pull_stopped_at: Time.now,
     #     execution_stopped_at: Time.now,
@@ -7267,6 +7388,95 @@ module Aws::ECS
       req.send_request(options)
     end
 
+    # Updates the cluster.
+    #
+    # @option params [required, String] :cluster
+    #   The name of the cluster to modify the settings for.
+    #
+    # @option params [Array<Types::ClusterSetting>] :settings
+    #   The cluster settings for your cluster.
+    #
+    # @option params [Types::ClusterConfiguration] :configuration
+    #   The execute command configuration for the cluster.
+    #
+    # @return [Types::UpdateClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateClusterResponse#cluster #cluster} => Types::Cluster
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_cluster({
+    #     cluster: "String", # required
+    #     settings: [
+    #       {
+    #         name: "containerInsights", # accepts containerInsights
+    #         value: "String",
+    #       },
+    #     ],
+    #     configuration: {
+    #       execute_command_configuration: {
+    #         kms_key_id: "String",
+    #         logging: "NONE", # accepts NONE, DEFAULT, OVERRIDE
+    #         log_configuration: {
+    #           cloud_watch_log_group_name: "String",
+    #           cloud_watch_encryption_enabled: false,
+    #           s3_bucket_name: "String",
+    #           s3_encryption_enabled: false,
+    #           s3_key_prefix: "String",
+    #         },
+    #       },
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cluster.cluster_arn #=> String
+    #   resp.cluster.cluster_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
+    #   resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
+    #   resp.cluster.status #=> String
+    #   resp.cluster.registered_container_instances_count #=> Integer
+    #   resp.cluster.running_tasks_count #=> Integer
+    #   resp.cluster.pending_tasks_count #=> Integer
+    #   resp.cluster.active_services_count #=> Integer
+    #   resp.cluster.statistics #=> Array
+    #   resp.cluster.statistics[0].name #=> String
+    #   resp.cluster.statistics[0].value #=> String
+    #   resp.cluster.tags #=> Array
+    #   resp.cluster.tags[0].key #=> String
+    #   resp.cluster.tags[0].value #=> String
+    #   resp.cluster.settings #=> Array
+    #   resp.cluster.settings[0].name #=> String, one of "containerInsights"
+    #   resp.cluster.settings[0].value #=> String
+    #   resp.cluster.capacity_providers #=> Array
+    #   resp.cluster.capacity_providers[0] #=> String
+    #   resp.cluster.default_capacity_provider_strategy #=> Array
+    #   resp.cluster.default_capacity_provider_strategy[0].capacity_provider #=> String
+    #   resp.cluster.default_capacity_provider_strategy[0].weight #=> Integer
+    #   resp.cluster.default_capacity_provider_strategy[0].base #=> Integer
+    #   resp.cluster.attachments #=> Array
+    #   resp.cluster.attachments[0].id #=> String
+    #   resp.cluster.attachments[0].type #=> String
+    #   resp.cluster.attachments[0].status #=> String
+    #   resp.cluster.attachments[0].details #=> Array
+    #   resp.cluster.attachments[0].details[0].name #=> String
+    #   resp.cluster.attachments[0].details[0].value #=> String
+    #   resp.cluster.attachments_status #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateCluster AWS API Documentation
+    #
+    # @overload update_cluster(params = {})
+    # @param [Hash] params ({})
+    def update_cluster(params = {}, options = {})
+      req = build_request(:update_cluster, params)
+      req.send_request(options)
+    end
+
     # Modifies the settings to use for a cluster.
     #
     # @option params [required, String] :cluster
@@ -7298,6 +7508,13 @@ module Aws::ECS
     #
     #   resp.cluster.cluster_arn #=> String
     #   resp.cluster.cluster_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
+    #   resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
+    #   resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
     #   resp.cluster.status #=> String
     #   resp.cluster.registered_container_instances_count #=> Integer
     #   resp.cluster.running_tasks_count #=> Integer
@@ -7807,6 +8024,13 @@ module Aws::ECS
     #   prevent the ECS service scheduler from marking tasks as unhealthy and
     #   stopping them before they have time to come up.
     #
+    # @option params [Boolean] :enable_execute_command
+    #   If `true`, this enables execute command functionality on all task
+    #   containers.
+    #
+    #   If you do not want to override the value that was set when the service
+    #   was created, you can set this to `null` when performing this action.
+    #
     # @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateServiceResponse#service #service} => Types::Service
@@ -7882,6 +8106,7 @@ module Aws::ECS
     #     platform_version: "String",
     #     force_new_deployment: false,
     #     health_check_grace_period_seconds: 1,
+    #     enable_execute_command: false,
     #   })
     #
     # @example Response structure
@@ -8005,6 +8230,7 @@ module Aws::ECS
     #   resp.service.created_by #=> String
     #   resp.service.enable_ecs_managed_tags #=> Boolean
     #   resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
+    #   resp.service.enable_execute_command #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateService AWS API Documentation
     #
@@ -8210,7 +8436,7 @@ module Aws::ECS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.75.0'
+      context[:gem_version] = '1.76.0'
       Seahorse::Client::Request.new(handlers, context)
     end