aws-sdk-ecs 1.152.0 → 1.161.0

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

@@ -32,11 +32,10 @@ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/request_compression.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
+require 'aws-sdk-core/plugins/telemetry.rb'
 require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
-Aws::Plugins::GlobalConfiguration.add_identifier(:ecs)
-
 module Aws::ECS
   # An API client for ECS.  To construct a client, you need to configure a `:region` and `:credentials`.
   #
@@ -83,6 +82,7 @@ module Aws::ECS
     add_plugin(Aws::Plugins::RequestCompression)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
+    add_plugin(Aws::Plugins::Telemetry)
     add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
     add_plugin(Aws::ECS::Plugins::Endpoints)
@@ -128,13 +128,15 @@ module Aws::ECS
     #     locations will be searched for credentials:
     #
     #     * `Aws.config[:credentials]`
-    #     * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
-    #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
+    #     * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
+    #       `:account_id` options.
+    #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'],
+    #       ENV['AWS_SESSION_TOKEN'], and ENV['AWS_ACCOUNT_ID']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
     #       enable retries and extended timeouts. Instance profile credential
     #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
     #       to true.
@@ -153,6 +155,8 @@ module Aws::ECS
     #
     #   @option options [String] :access_key_id
     #
+    #   @option options [String] :account_id
+    #
     #   @option options [Boolean] :active_endpoint_cache (false)
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
@@ -337,6 +341,16 @@ module Aws::ECS
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
+    #     Allows you to provide a telemetry provider, which is used to
+    #     emit telemetry data. By default, uses `NoOpTelemetryProvider` which
+    #     will not record or emit any telemetry data. The SDK supports the
+    #     following telemetry providers:
+    #
+    #     * OpenTelemetry (OTel) - To use the OTel provider, install and require the
+    #     `opentelemetry-sdk` gem and then, pass in an instance of a
+    #     `Aws::Telemetry::OTelProvider` for telemetry provider.
+    #
     #   @option options [Aws::TokenProvider] :token_provider
     #     A Bearer Token Provider. This can be an instance of any one of the
     #     following classes:
@@ -364,7 +378,9 @@ module Aws::ECS
     #     sending the request.
     #
     #   @option options [Aws::ECS::EndpointProvider] :endpoint_provider
-    #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::ECS::EndpointParameters`
+    #     The endpoint provider used to resolve endpoints. Any object that responds to
+    #     `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to
+    #     `Aws::ECS::EndpointParameters`.
     #
     #   @option options [Float] :http_continue_timeout (1)
     #     The number of seconds to wait for a 100-continue response before sending the
@@ -420,6 +436,12 @@ module Aws::ECS
     #   @option options [String] :ssl_ca_store
     #     Sets the X509::Store to verify peer certificate.
     #
+    #   @option options [OpenSSL::X509::Certificate] :ssl_cert
+    #     Sets a client certificate when creating http connections.
+    #
+    #   @option options [OpenSSL::PKey] :ssl_key
+    #     Sets a client key when creating http connections.
+    #
     #   @option options [Float] :ssl_timeout
     #     Sets the SSL timeout in seconds
     #
@@ -538,23 +560,23 @@ module Aws::ECS
 
     # Creates a new Amazon ECS cluster. By default, your account receives a
     # `default` cluster when you launch your first container instance.
-    # However, you can create your own cluster with a unique name with the
-    # `CreateCluster` action.
-    #
-    # <note markdown="1"> When you call the CreateCluster API operation, Amazon ECS attempts to
-    # create the Amazon ECS service-linked role for your account. This is so
-    # that it can manage required resources in other Amazon Web Services
-    # services on your behalf. However, if the user that makes the call
-    # doesn't have permissions to create the service-linked role, it isn't
-    # created. For more information, see [Using service-linked roles for
-    # Amazon ECS][1] in the *Amazon Elastic Container Service Developer
-    # Guide*.
+    # However, you can create your own cluster with a unique name.
+    #
+    # <note markdown="1"> When you call the [CreateCluster][1] API operation, Amazon ECS
+    # attempts to create the Amazon ECS service-linked role for your
+    # account. This is so that it can manage required resources in other
+    # Amazon Web Services services on your behalf. However, if the user that
+    # makes the call doesn't have permissions to create the service-linked
+    # role, it isn't created. For more information, see [Using
+    # service-linked roles for Amazon ECS][2] in the *Amazon Elastic
+    # Container Service Developer Guide*.
     #
     #  </note>
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCluster.html
+    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
     #
     # @option params [String] :cluster_name
     #   The name of your cluster. If you don't specify a name for your
@@ -596,7 +618,12 @@ module Aws::ECS
     #   The setting to use when creating a cluster. This parameter is used to
     #   turn on CloudWatch Container Insights for a cluster. If this value is
     #   specified, it overrides the `containerInsights` value set with
-    #   PutAccountSetting or PutAccountSettingDefault.
+    #   [PutAccountSetting][1] or [PutAccountSettingDefault][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSetting.html
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSettingDefault.html
     #
     # @option params [Types::ClusterConfiguration] :configuration
     #   The `execute` command configuration for the cluster.
@@ -638,12 +665,13 @@ module Aws::ECS
     #
     #   If a default capacity provider strategy isn't defined for a cluster
     #   when it was created, it can be defined later with the
-    #   PutClusterCapacityProviders API operation.
+    #   [PutClusterCapacityProviders][3] API operation.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html
     #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html
+    #   [3]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
     #
     # @option params [Types::ClusterServiceConnectDefaultsRequest] :service_connect_defaults
     #   Use this parameter to set a default Service Connect namespace. After
@@ -794,8 +822,8 @@ module Aws::ECS
     # Runs and maintains your desired number of tasks from a specified task
     # definition. If the number of tasks running in a service drops below
     # the `desiredCount`, Amazon ECS runs another copy of the task in the
-    # specified cluster. To update an existing service, see the
-    # UpdateService action.
+    # specified cluster. To update an existing service, use
+    # [UpdateService][1].
     #
     # <note markdown="1"> On March 21, 2024, a change was made to resolve the task definition
     # revision before authorization. When a task definition revision is not
@@ -808,13 +836,13 @@ module Aws::ECS
     # you can optionally run your service behind one or more load balancers.
     # The load balancers distribute traffic across the tasks that are
     # associated with the service. For more information, see [Service load
-    # balancing][1] in the *Amazon Elastic Container Service Developer
+    # balancing][2] in the *Amazon Elastic Container Service Developer
     # Guide*.
     #
     # You can attach Amazon EBS volumes to Amazon ECS tasks by configuring
     # the volume when creating or updating a service. `volumeConfigurations`
     # is only supported for REPLICA service and not DAEMON service. For more
-    # infomation, see [Amazon EBS volumes][2] in the *Amazon Elastic
+    # infomation, see [Amazon EBS volumes][3] in the *Amazon Elastic
     # Container Service Developer Guide*.
     #
     # Tasks for services that don't use a load balancer are considered
@@ -829,7 +857,7 @@ module Aws::ECS
     #   service scheduler spreads tasks across Availability Zones. You can
     #   use task placement strategies and constraints to customize task
     #   placement decisions. For more information, see [Service scheduler
-    #   concepts][3] in the *Amazon Elastic Container Service Developer
+    #   concepts][4] in the *Amazon Elastic Container Service Developer
     #   Guide*.
     #
     # * `DAEMON` - The daemon scheduling strategy deploys exactly one task
@@ -840,16 +868,16 @@ module Aws::ECS
     #   constraints. When using this strategy, you don't need to specify a
     #   desired number of tasks, a task placement strategy, or use Service
     #   Auto Scaling policies. For more information, see [Service scheduler
-    #   concepts][3] in the *Amazon Elastic Container Service Developer
+    #   concepts][4] in the *Amazon Elastic Container Service Developer
     #   Guide*.
     #
     # You can optionally specify a deployment configuration for your
     # service. The deployment is initiated by changing properties. For
     # example, the deployment might be initiated by the task definition or
-    # by your desired count of a service. This is done with an UpdateService
-    # operation. The default value for a replica service for
-    # `minimumHealthyPercent` is 100%. The default value for a daemon
-    # service for `minimumHealthyPercent` is 0%.
+    # by your desired count of a service. You can use [UpdateService][1].
+    # The default value for a replica service for `minimumHealthyPercent` is
+    # 100%. The default value for a daemon service for
+    # `minimumHealthyPercent` is 0%.
     #
     # If a service uses the `ECS` deployment controller, the minimum healthy
     # percent represents a lower limit on the number of tasks in a service
@@ -895,13 +923,13 @@ module Aws::ECS
     # When creating a service that uses the `EXTERNAL` deployment
     # controller, you can specify only parameters that aren't controlled at
     # the task set level. The only required parameter is the service name.
-    # You control your services using the CreateTaskSet operation. For more
-    # information, see [Amazon ECS deployment types][4] in the *Amazon
+    # You control your services using the [CreateTaskSet][5]. For more
+    # information, see [Amazon ECS deployment types][6] in the *Amazon
     # Elastic Container Service Developer Guide*.
     #
     # When the service scheduler launches new tasks, it determines task
     # placement. For information about task placement and task placement
-    # strategies, see [Amazon ECS task placement][5] in the *Amazon Elastic
+    # strategies, see [Amazon ECS task placement][7] in the *Amazon Elastic
     # Container Service Developer Guide*
     #
     # Starting April 15, 2023, Amazon Web Services will not onboard new
@@ -915,11 +943,13 @@ module Aws::ECS
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html
-    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html#ebs-volume-types
-    # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html
-    # [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html
-    # [5]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement.html
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html
+    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html
+    # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html#ebs-volume-types
+    # [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html
+    # [5]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html
+    # [6]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html
+    # [7]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement.html
     #
     # @option params [String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -1749,7 +1779,7 @@ module Aws::ECS
     #
     #  </note>
     #
-    # For information about the maximum number of task sets and otther
+    # For information about the maximum number of task sets and other
     # quotas, see [Amazon ECS service quotas][2] in the *Amazon Elastic
     # Container Service Developer Guide*.
     #
@@ -1811,8 +1841,8 @@ module Aws::ECS
     #   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
+    #   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.
     #
     #   If a `capacityProviderStrategy` is specified, the `launchType`
@@ -1822,16 +1852,21 @@ module Aws::ECS
     #
     #   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.
+    #   be created with the [CreateCapacityProviderProvider][2]API operation.
     #
     #   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 PutClusterCapacityProviders API operation is used to update the
-    #   list of available capacity providers for a cluster after the cluster
-    #   is created.
+    #   The [PutClusterCapacityProviders][1] API operation is used to update
+    #   the list of available capacity providers for a cluster after the
+    #   cluster is created.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProviderProvider.html
     #
     # @option params [String] :platform_version
     #   The platform version that the tasks in the task set uses. A platform
@@ -2126,20 +2161,26 @@ module Aws::ECS
     #
     # <note markdown="1"> The `FARGATE` and `FARGATE_SPOT` capacity providers are reserved and
     # can't be deleted. You can disassociate them from a cluster using
-    # either the PutClusterCapacityProviders API or by deleting the cluster.
+    # either [PutCapacityProviderProviders][1] or by deleting the cluster.
     #
     #  </note>
     #
     # Prior to a capacity provider being deleted, the capacity provider must
     # be removed from the capacity provider strategy from all services. The
-    # UpdateService API can be used to remove a capacity provider from a
-    # service's capacity provider strategy. When updating a service, the
+    # [UpdateService][2] API can be used to remove a capacity provider from
+    # a service's capacity provider strategy. When updating a service, the
     # `forceNewDeployment` option can be used to ensure that any tasks using
     # the Amazon EC2 instance capacity provided by the capacity provider are
     # transitioned to use the capacity from the remaining capacity
     # providers. Only capacity providers that aren't associated with a
     # cluster can be deleted. To remove a capacity provider from a cluster,
-    # you can either use PutClusterCapacityProviders or delete the cluster.
+    # you can either use [PutCapacityProviderProviders][1] or delete the
+    # cluster.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProviderProviders.html
+    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html
     #
     # @option params [required, String] :capacity_provider
     #   The short name or full Amazon Resource Name (ARN) of the capacity
@@ -2191,8 +2232,13 @@ module Aws::ECS
     #
     # You must deregister all container instances from this cluster before
     # you may delete it. You can list the container instances in a cluster
-    # with ListContainerInstances and deregister them with
-    # DeregisterContainerInstance.
+    # with [ListContainerInstances][1] and deregister them with
+    # [DeregisterContainerInstance][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListContainerInstances.html
+    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeregisterContainerInstance.html
     #
     # @option params [required, String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster to
@@ -2286,18 +2332,19 @@ module Aws::ECS
     # if you have no running tasks in it and the desired task count is zero.
     # If the service is actively maintaining tasks, you can't delete it,
     # and you must update the service to a desired task count of zero. For
-    # more information, see UpdateService.
+    # more information, see [UpdateService][1].
     #
     # <note markdown="1"> When you delete a service, if there are still running tasks that
     # require cleanup, the service status moves from `ACTIVE` to `DRAINING`,
     # and the service is no longer visible in the console or in the
-    # ListServices API operation. After all tasks have transitioned to
+    # [ListServices][2] API operation. After all tasks have transitioned to
     # either `STOPPING` or `STOPPED` status, the service status moves from
     # `DRAINING` to `INACTIVE`. Services in the `DRAINING` or `INACTIVE`
-    # status can still be viewed with the DescribeServices API operation.
-    # However, in the future, `INACTIVE` services may be cleaned up and
-    # purged from Amazon ECS record keeping, and DescribeServices calls on
-    # those services return a `ServiceNotFoundException` error.
+    # status can still be viewed with the [DescribeServices][3] API
+    # operation. However, in the future, `INACTIVE` services may be cleaned
+    # up and purged from Amazon ECS record keeping, and
+    # [DescribeServices][3] calls on those services return a
+    # `ServiceNotFoundException` error.
     #
     #  </note>
     #
@@ -2305,6 +2352,12 @@ module Aws::ECS
     # existing service in either `ACTIVE` or `DRAINING` status, you receive
     # an error.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html
+    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListServices.html
+    # [3]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeServices.html
+    #
     # @option params [String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster that
     #   hosts the service to delete. If you do not specify a cluster, the
@@ -2596,6 +2649,10 @@ module Aws::ECS
     #   resp.task_definitions[0].container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
     #   resp.task_definitions[0].container_definitions[0].port_mappings[0].container_port_range #=> String
     #   resp.task_definitions[0].container_definitions[0].essential #=> Boolean
+    #   resp.task_definitions[0].container_definitions[0].restart_policy.enabled #=> Boolean
+    #   resp.task_definitions[0].container_definitions[0].restart_policy.ignored_exit_codes #=> Array
+    #   resp.task_definitions[0].container_definitions[0].restart_policy.ignored_exit_codes[0] #=> Integer
+    #   resp.task_definitions[0].container_definitions[0].restart_policy.restart_attempt_period #=> Integer
     #   resp.task_definitions[0].container_definitions[0].entry_point #=> Array
     #   resp.task_definitions[0].container_definitions[0].entry_point[0] #=> String
     #   resp.task_definitions[0].container_definitions[0].command #=> Array
@@ -3053,6 +3110,10 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
     #   resp.task_definition.container_definitions[0].port_mappings[0].container_port_range #=> String
     #   resp.task_definition.container_definitions[0].essential #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.enabled #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes #=> Array
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes[0] #=> Integer
+    #   resp.task_definition.container_definitions[0].restart_policy.restart_attempt_period #=> Integer
     #   resp.task_definition.container_definitions[0].entry_point #=> Array
     #   resp.task_definition.container_definitions[0].entry_point[0] #=> String
     #   resp.task_definition.container_definitions[0].command #=> Array
@@ -3999,6 +4060,10 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
     #   resp.task_definition.container_definitions[0].port_mappings[0].container_port_range #=> String
     #   resp.task_definition.container_definitions[0].essential #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.enabled #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes #=> Array
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes[0] #=> Integer
+    #   resp.task_definition.container_definitions[0].restart_policy.restart_attempt_period #=> Integer
     #   resp.task_definition.container_definitions[0].entry_point #=> Array
     #   resp.task_definition.container_definitions[0].entry_point[0] #=> String
     #   resp.task_definition.container_definitions[0].command #=> Array
@@ -5009,9 +5074,14 @@ module Aws::ECS
     # @option params [String] :status
     #   Filters the container instances by status. For example, if you specify
     #   the `DRAINING` status, the results include only container instances
-    #   that have been set to `DRAINING` using UpdateContainerInstancesState.
-    #   If you don't specify this parameter, the default is to include
-    #   container instances set to all states other than `INACTIVE`.
+    #   that have been set to `DRAINING` using
+    #   [UpdateContainerInstancesState][1]. If you don't specify this
+    #   parameter, the default is to include container instances set to all
+    #   states other than `INACTIVE`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateContainerInstancesState.html
     #
     # @return [Types::ListContainerInstancesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5719,9 +5789,6 @@ module Aws::ECS
     #     mode][3]. For more information on using IPv6 with tasks launched on
     #     Fargate, see [Using a VPC in dual-stack mode][4].
     #
-    #   * `fargateFIPSMode` - If you specify `fargateFIPSMode`, Fargate FIPS
-    #     140 compliance is affected.
-    #
     #   * `fargateTaskRetirementWaitPeriod` - When Amazon Web Services
     #     determines that a security or infrastructure update is needed for an
     #     Amazon ECS task hosted on Fargate, the tasks need to be stopped and
@@ -6024,12 +6091,13 @@ module Aws::ECS
     # Create or update an attribute on an Amazon ECS resource. If the
     # attribute doesn't exist, it's created. If the attribute exists, its
     # value is replaced with the specified value. To delete an attribute,
-    # use DeleteAttributes. For more information, see [Attributes][1] in the
-    # *Amazon Elastic Container Service Developer Guide*.
+    # use [DeleteAttributes][1]. For more information, see [Attributes][2]
+    # in the *Amazon Elastic Container Service Developer Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html#attributes
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeleteAttributes.html
+    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html#attributes
     #
     # @option params [String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -6084,10 +6152,10 @@ module Aws::ECS
     # has existing capacity providers associated with it, you must specify
     # all existing capacity providers in addition to any new ones you want
     # to add. Any existing capacity providers that are associated with a
-    # cluster that are omitted from a PutClusterCapacityProviders API call
-    # will be disassociated with the cluster. You can only disassociate an
-    # existing capacity provider from a cluster if it's not being used by
-    # any existing tasks.
+    # cluster that are omitted from a [PutClusterCapacityProviders][1] API
+    # call will be disassociated with the cluster. You can only disassociate
+    # an existing capacity provider from a cluster if it's not being used
+    # by any existing tasks.
     #
     # When creating a service or running a task on a cluster, if no capacity
     # provider or launch type is specified, then the cluster's default
@@ -6095,6 +6163,10 @@ module Aws::ECS
     # default capacity provider strategy for your cluster. However, you must
     # specify an empty array (`[]`) to bypass defining a default strategy.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
+    #
     # @option params [required, String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster to
     #   modify the capacity provider settings for. If you don't specify a
@@ -6106,13 +6178,17 @@ module Aws::ECS
     #
     #   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.
+    #   be created with the [CreateCapacityProvider][1] API operation.
     #
     #   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.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html
+    #
     # @option params [required, Array<Types::CapacityProviderStrategyItem>] :default_capacity_provider_strategy
     #   The capacity provider strategy to use by default for the cluster.
     #
@@ -6123,19 +6199,24 @@ module Aws::ECS
     #   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
+    #   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.
     #
     #   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.
+    #   be created with the [CreateCapacityProvider][2] API operation.
     #
     #   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.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html
+    #
     # @return [Types::PutClusterCapacityProvidersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::PutClusterCapacityProvidersResponse#cluster #cluster} => Types::Cluster
@@ -6405,20 +6486,18 @@ module Aws::ECS
     # Tasks][2] in the *Amazon Elastic Container Service Developer Guide*.
     #
     # You can specify a Docker networking mode for the containers in your
-    # task definition with the `networkMode` parameter. The available
-    # network modes correspond to those described in [Network settings][3]
-    # in the Docker run reference. If you specify the `awsvpc` network mode,
-    # the task is allocated an elastic network interface, and you must
-    # specify a NetworkConfiguration when you create a service or run a task
-    # with the task definition. For more information, see [Task
-    # Networking][4] in the *Amazon Elastic Container Service Developer
-    # Guide*.
+    # task definition with the `networkMode` parameter. If you specify the
+    # `awsvpc` network mode, the task is allocated an elastic network
+    # interface, and you must specify a [NetworkConfiguration][3] when you
+    # create a service or run a task with the task definition. For more
+    # information, see [Task Networking][4] in the *Amazon Elastic Container
+    # Service Developer Guide*.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html
     # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html
-    # [3]: https://docs.docker.com/engine/reference/run/#/network-settings
+    # [3]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_NetworkConfiguration.html
     # [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
     #
     # @option params [required, String] :family
@@ -6441,14 +6520,13 @@ module Aws::ECS
     # @option params [String] :execution_role_arn
     #   The Amazon Resource Name (ARN) of the task execution role that grants
     #   the Amazon ECS container agent permission to make Amazon Web Services
-    #   API calls on your behalf. The task execution IAM role is required
-    #   depending on the requirements of your task. For more information, see
-    #   [Amazon ECS task execution IAM role][1] in the *Amazon Elastic
-    #   Container Service Developer Guide*.
+    #   API calls on your behalf. For informationabout the required IAM roles
+    #   for Amazon ECS, see [IAM roles for Amazon ECS][1] in the *Amazon
+    #   Elastic Container Service Developer Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_execution_IAM_role.html
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security-ecs-iam-role-overview.html
     #
     # @option params [String] :network_mode
     #   The Docker networking mode to use for the containers in the task. The
@@ -6477,22 +6555,19 @@ module Aws::ECS
     #   non-root user.
     #
     #   If the network mode is `awsvpc`, the task is allocated an elastic
-    #   network interface, and you must specify a NetworkConfiguration value
-    #   when you create a service or run a task with the task definition. For
-    #   more information, see [Task Networking][1] in the *Amazon Elastic
-    #   Container Service Developer Guide*.
+    #   network interface, and you must specify a [NetworkConfiguration][1]
+    #   value when you create a service or run a task with the task
+    #   definition. For more information, see [Task Networking][2] in the
+    #   *Amazon Elastic Container Service Developer Guide*.
     #
     #   If the network mode is `host`, you cannot run multiple instantiations
     #   of the same task on a single container instance when port mappings are
     #   used.
     #
-    #   For more information, see [Network settings][2] in the *Docker run
-    #   reference*.
     #
     #
-    #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
-    #   [2]: https://docs.docker.com/engine/reference/run/#network-settings
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_NetworkConfiguration.html
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
     #
     # @option params [required, Array<Types::ContainerDefinition>] :container_definitions
     #   A list of container definitions in JSON format that describe the
@@ -6655,12 +6730,10 @@ module Aws::ECS
     #   the same process namespace.
     #
     #   If no value is specified, the default is a private namespace for each
-    #   container. For more information, see [PID settings][1] in the *Docker
-    #   run reference*.
+    #   container.
     #
     #   If the `host` PID mode is used, there's a heightened risk of
-    #   undesired process namespace exposure. For more information, see
-    #   [Docker security][2].
+    #   undesired process namespace exposure.
     #
     #   <note markdown="1"> This parameter is not supported for Windows containers.
     #
@@ -6672,11 +6745,6 @@ module Aws::ECS
     #
     #    </note>
     #
-    #
-    #
-    #   [1]: https://docs.docker.com/engine/reference/run/#pid-settings---pid
-    #   [2]: https://docs.docker.com/engine/security/security/
-    #
     # @option params [String] :ipc_mode
     #   The IPC resource namespace to use for the containers in the task. The
     #   valid values are `host`, `task`, or `none`. If `host` is specified,
@@ -6688,16 +6756,14 @@ module Aws::ECS
     #   private and not shared with other containers in a task or on the
     #   container instance. If no value is specified, then the IPC resource
     #   namespace sharing depends on the Docker daemon setting on the
-    #   container instance. For more information, see [IPC settings][1] in the
-    #   *Docker run reference*.
+    #   container instance.
     #
     #   If the `host` IPC mode is used, be aware that there is a heightened
-    #   risk of undesired IPC namespace expose. For more information, see
-    #   [Docker security][2].
+    #   risk of undesired IPC namespace expose.
     #
     #   If you are setting namespaced kernel parameters using `systemControls`
     #   for the containers in the task, the following will apply to your IPC
-    #   resource namespace. For more information, see [System Controls][3] in
+    #   resource namespace. For more information, see [System Controls][1] in
     #   the *Amazon Elastic Container Service Developer Guide*.
     #
     #   * For tasks that use the `host` IPC mode, IPC namespace related
@@ -6713,9 +6779,7 @@ module Aws::ECS
     #
     #
     #
-    #   [1]: https://docs.docker.com/engine/reference/run/#ipc-settings---ipc
-    #   [2]: https://docs.docker.com/engine/security/security/
-    #   [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html
     #
     # @option params [Types::ProxyConfiguration] :proxy_configuration
     #   The configuration details for the App Mesh proxy.
@@ -6852,6 +6916,11 @@ module Aws::ECS
     #           },
     #         ],
     #         essential: false,
+    #         restart_policy: {
+    #           enabled: false, # required
+    #           ignored_exit_codes: [1],
+    #           restart_attempt_period: 1,
+    #         },
     #         entry_point: ["String"],
     #         command: ["String"],
     #         environment: [
@@ -7084,6 +7153,10 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
     #   resp.task_definition.container_definitions[0].port_mappings[0].container_port_range #=> String
     #   resp.task_definition.container_definitions[0].essential #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.enabled #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes #=> Array
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes[0] #=> Integer
+    #   resp.task_definition.container_definitions[0].restart_policy.restart_attempt_period #=> Integer
     #   resp.task_definition.container_definitions[0].entry_point #=> Array
     #   resp.task_definition.container_definitions[0].entry_point[0] #=> String
     #   resp.task_definition.container_definitions[0].command #=> Array
@@ -7257,7 +7330,7 @@ module Aws::ECS
     # strategies. For more information, see [Scheduling Tasks][1] in the
     # *Amazon Elastic Container Service Developer Guide*.
     #
-    # Alternatively, you can use StartTask to use your own scheduler or
+    # Alternatively, you can use `StartTask` to use your own scheduler or
     # place tasks manually on specific container instances.
     #
     # Starting April 15, 2023, Amazon Web Services will not onboard new
@@ -7426,13 +7499,17 @@ module Aws::ECS
     #   Specifies whether to propagate the tags from the task definition to
     #   the task. If no value is specified, the tags aren't propagated. Tags
     #   can only be propagated to the task during task creation. To add tags
-    #   to a task after task creation, use the TagResource API action.
+    #   to a task after task creation, use the[TagResource][1] API action.
     #
     #   <note markdown="1"> An error will be received if you specify the `SERVICE` option when
     #   running a task.
     #
     #    </note>
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html
+    #
     # @option params [String] :reference_id
     #   The reference ID to use for the task. The reference ID can have a
     #   maximum length of 1024 characters.
@@ -7442,13 +7519,18 @@ module Aws::ECS
     #   automatically trigger a task to run a batch process job, you 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
+    #   that job by filtering the results of a [ListTasks][1] call with the
     #   `startedBy` value. Up to 128 letters (uppercase and lowercase),
-    #   numbers, hyphens (-), and underscores (\_) are allowed.
+    #   numbers, hyphens (-), forward slash (/), and underscores (\_) are
+    #   allowed.
     #
     #   If a task is started by an Amazon ECS service, then the `startedBy`
     #   parameter contains the deployment ID of the service that starts it.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListTasks.html
+    #
     # @option params [Array<Types::Tag>] :tags
     #   The metadata that you apply to the task to help you categorize and
     #   organize them. Each tag consists of a key and an optional value, both
@@ -7836,7 +7918,7 @@ module Aws::ECS
     # at least once during the past 30-day period are considered current
     # customers and will be able to continue using the service.
     #
-    # Alternatively, you can use RunTask to place tasks for you. For more
+    # Alternatively, you can use`RunTask` to place tasks for you. For more
     # information, see [Scheduling Tasks][1] in the *Amazon Elastic
     # Container Service Developer Guide*.
     #
@@ -7912,13 +7994,18 @@ module Aws::ECS
     #   automatically trigger a task to run a batch process job, you 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
+    #   that job by filtering the results of a [ListTasks][1] call with the
     #   `startedBy` value. Up to 36 letters (uppercase and lowercase),
-    #   numbers, hyphens (-), and underscores (\_) are allowed.
+    #   numbers, hyphens (-), forward slash (/), and underscores (\_) are
+    #   allowed.
     #
     #   If a task is started by an Amazon ECS service, the `startedBy`
     #   parameter contains the deployment ID of the service that starts it.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListTasks.html
+    #
     # @option params [Array<Types::Tag>] :tags
     #   The metadata that you apply to the task to help you categorize and
     #   organize them. Each tag consists of a key and an optional value, both
@@ -8195,7 +8282,7 @@ module Aws::ECS
     # Stops a running task. Any tags associated with the task will be
     # deleted.
     #
-    # When StopTask is called on a task, the equivalent of `docker stop` is
+    # When you call `StopTask` on a task, the equivalent of `docker stop` is
     # issued to the containers running in the task. This results in a
     # `SIGTERM` value and a default 30-second timeout, after which the
     # `SIGKILL` value is sent and the containers are forcibly stopped. If
@@ -8231,7 +8318,11 @@ module Aws::ECS
     #   An optional message specified when a task is stopped. For example, if
     #   you're using a custom scheduler, you can use this parameter to
     #   specify the reason for stopping the task here, and the message appears
-    #   in subsequent DescribeTasks API operations on this task.
+    #   in subsequent [DescribeTasks][1]&gt; API operations on this task.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeTasks.html
     #
     # @return [Types::StopTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -8891,7 +8982,7 @@ module Aws::ECS
     #   The setting to use by default for a cluster. This parameter is used to
     #   turn on CloudWatch Container Insights for a cluster. If this value is
     #   specified, it overrides the `containerInsights` value set with
-    #   PutAccountSetting or PutAccountSettingDefault.
+    #   [PutAccountSetting][1] or [PutAccountSettingDefault][2].
     #
     #   Currently, if you delete an existing cluster that does not have
     #   Container Insights turned on, and then create a new cluster with the
@@ -8900,6 +8991,11 @@ module Aws::ECS
     #   your existing cluster and turn on Container Insights, you must wait 7
     #   days before you can re-create it.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSetting.html
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSettingDefault.html
+    #
     # @return [Types::UpdateClusterSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateClusterSettingsResponse#cluster #cluster} => Types::Cluster
@@ -9108,7 +9204,7 @@ module Aws::ECS
     # state are stopped and replaced according to the service's deployment
     # configuration parameters, `minimumHealthyPercent` and
     # `maximumPercent`. You can change the deployment configuration of your
-    # service using UpdateService.
+    # service using [UpdateService][1].
     #
     # * If `minimumHealthyPercent` is below 100%, the scheduler can ignore
     #   `desiredCount` temporarily during task replacement. For example,
@@ -9135,12 +9231,17 @@ module Aws::ECS
     # manually.
     #
     # A container instance has completed draining when it has no more
-    # `RUNNING` tasks. You can verify this using ListTasks.
+    # `RUNNING` tasks. You can verify this using [ListTasks][2].
     #
     # When a container instance has been drained, you can set a container
     # instance to `ACTIVE` status and once it has reached that status the
     # Amazon ECS scheduler can begin scheduling tasks on the instance again.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html
+    # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListTasks.html
+    #
     # @option params [String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster that
     #   hosts the container instance to update. If you do not specify a
@@ -9281,7 +9382,7 @@ module Aws::ECS
     # propagate tags option, using this API. If the launch type, load
     # balancer, network configuration, platform version, or task definition
     # need to be updated, create a new task set For more information, see
-    # CreateTaskSet.
+    # [CreateTaskSet][3].
     #
     # You can add to or subtract from the number of instantiations of a task
     # definition in a service by specifying the cluster that the service is
@@ -9330,12 +9431,12 @@ module Aws::ECS
     #   the four older tasks (provided that the cluster resources required
     #   to do this are available).
     #
-    # When UpdateService stops a task during a deployment, the equivalent of
-    # `docker stop` is issued to the containers running in the task. This
-    # results in a `SIGTERM` and a 30-second timeout. After this, `SIGKILL`
-    # is sent and the containers are forcibly stopped. If the container
-    # handles the `SIGTERM` gracefully and exits within 30 seconds from
-    # receiving it, no `SIGKILL` is sent.
+    # When [UpdateService][4] stops a task during a deployment, the
+    # equivalent of `docker stop` is issued to the containers running in the
+    # task. This results in a `SIGTERM` and a 30-second timeout. After this,
+    # `SIGKILL` is sent and the containers are forcibly stopped. If the
+    # container handles the `SIGTERM` gracefully and exits within 30 seconds
+    # from receiving it, no `SIGKILL` is sent.
     #
     # When the service scheduler launches new tasks, it determines task
     # placement in your cluster with the following logic.
@@ -9381,7 +9482,7 @@ module Aws::ECS
     # * `serviceRegistries`
     #
     #  For more information about the role see the `CreateService` request
-    # parameter [ `role` ][3].
+    # parameter [ `role` ][5].
     #
     #  </note>
     #
@@ -9389,7 +9490,9 @@ module Aws::ECS
     #
     # [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_CreateService.html#ECS-CreateService-request-role
+    # [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
@@ -9424,22 +9527,29 @@ module Aws::ECS
     #   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
+    #   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.
     #
     #   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.
+    #   be created with the [CreateClusterCapacityProvider][2] API operation.
     #
     #   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 PutClusterCapacityProviders API operation is used to update the
-    #   list of available capacity providers for a cluster after the cluster
-    #   is created.
+    #   The [PutClusterCapacityProviders][1]API operation is used to update
+    #   the list of available capacity providers for a cluster after the
+    #   cluster is created.
+    #
+    #
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateClusterCapacityProvider.html
     #
     # @option params [Types::DeploymentConfiguration] :deployment_configuration
     #   Optional deployment parameters that control how many tasks run during
@@ -10324,14 +10434,19 @@ module Aws::ECS
     # @api private
     def build_request(operation_name, params = {})
       handlers = @handlers.for(operation_name)
+      tracer = config.telemetry_provider.tracer_provider.tracer(
+        Aws::Telemetry.module_to_tracer_name('Aws::ECS')
+      )
       context = Seahorse::Client::RequestContext.new(
         operation_name: operation_name,
         operation: config.api.operation(operation_name),
         client: self,
         params: params,
-        config: config)
+        config: config,
+        tracer: tracer
+      )
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.152.0'
+      context[:gem_version] = '1.161.0'
       Seahorse::Client::Request.new(handlers, context)
     end