@aws-sdk/client-ecs 3.40.0 → 3.45.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/README.md +7 -7
  3. package/dist-cjs/endpoints.js +9 -0
  4. package/dist-cjs/models/models_0.js +29 -5
  5. package/dist-cjs/protocols/Aws_json1_1.js +33 -0
  6. package/dist-es/endpoints.js +9 -0
  7. package/dist-es/models/models_0.js +20 -0
  8. package/dist-es/protocols/Aws_json1_1.js +33 -0
  9. package/dist-types/ECS.d.ts +147 -152
  10. package/dist-types/ECSClient.d.ts +7 -7
  11. package/dist-types/commands/CreateCapacityProviderCommand.d.ts +5 -5
  12. package/dist-types/commands/CreateClusterCommand.d.ts +5 -5
  13. package/dist-types/commands/CreateServiceCommand.d.ts +52 -51
  14. package/dist-types/commands/CreateTaskSetCommand.d.ts +1 -1
  15. package/dist-types/commands/DeleteAccountSettingCommand.d.ts +1 -1
  16. package/dist-types/commands/DeleteAttributesCommand.d.ts +1 -1
  17. package/dist-types/commands/DeleteCapacityProviderCommand.d.ts +4 -4
  18. package/dist-types/commands/DeleteClusterCommand.d.ts +5 -6
  19. package/dist-types/commands/DeleteServiceCommand.d.ts +2 -2
  20. package/dist-types/commands/DeleteTaskSetCommand.d.ts +1 -1
  21. package/dist-types/commands/DeregisterContainerInstanceCommand.d.ts +8 -7
  22. package/dist-types/commands/DeregisterTaskDefinitionCommand.d.ts +8 -9
  23. package/dist-types/commands/DescribeCapacityProvidersCommand.d.ts +1 -1
  24. package/dist-types/commands/DescribeClustersCommand.d.ts +1 -1
  25. package/dist-types/commands/DescribeContainerInstancesCommand.d.ts +1 -1
  26. package/dist-types/commands/DescribeServicesCommand.d.ts +1 -1
  27. package/dist-types/commands/DescribeTaskDefinitionCommand.d.ts +1 -1
  28. package/dist-types/commands/DescribeTaskSetsCommand.d.ts +1 -1
  29. package/dist-types/commands/DescribeTasksCommand.d.ts +1 -1
  30. package/dist-types/commands/DiscoverPollEndpointCommand.d.ts +2 -3
  31. package/dist-types/commands/ExecuteCommandCommand.d.ts +1 -1
  32. package/dist-types/commands/ListAccountSettingsCommand.d.ts +1 -1
  33. package/dist-types/commands/ListAttributesCommand.d.ts +4 -4
  34. package/dist-types/commands/ListClustersCommand.d.ts +1 -1
  35. package/dist-types/commands/ListContainerInstancesCommand.d.ts +1 -1
  36. package/dist-types/commands/ListServicesCommand.d.ts +1 -1
  37. package/dist-types/commands/ListTagsForResourceCommand.d.ts +1 -1
  38. package/dist-types/commands/ListTaskDefinitionFamiliesCommand.d.ts +7 -7
  39. package/dist-types/commands/ListTaskDefinitionsCommand.d.ts +1 -1
  40. package/dist-types/commands/ListTasksCommand.d.ts +1 -1
  41. package/dist-types/commands/PutAccountSettingCommand.d.ts +6 -6
  42. package/dist-types/commands/PutAccountSettingDefaultCommand.d.ts +1 -1
  43. package/dist-types/commands/PutAttributesCommand.d.ts +3 -3
  44. package/dist-types/commands/PutClusterCapacityProvidersCommand.d.ts +7 -7
  45. package/dist-types/commands/RegisterContainerInstanceCommand.d.ts +3 -4
  46. package/dist-types/commands/RegisterTaskDefinitionCommand.d.ts +2 -2
  47. package/dist-types/commands/RunTaskCommand.d.ts +6 -6
  48. package/dist-types/commands/StartTaskCommand.d.ts +1 -1
  49. package/dist-types/commands/StopTaskCommand.d.ts +1 -1
  50. package/dist-types/commands/SubmitAttachmentStateChangesCommand.d.ts +2 -3
  51. package/dist-types/commands/SubmitContainerStateChangeCommand.d.ts +2 -3
  52. package/dist-types/commands/SubmitTaskStateChangeCommand.d.ts +2 -3
  53. package/dist-types/commands/TagResourceCommand.d.ts +3 -3
  54. package/dist-types/commands/UntagResourceCommand.d.ts +1 -1
  55. package/dist-types/commands/UpdateCapacityProviderCommand.d.ts +1 -1
  56. package/dist-types/commands/UpdateClusterCommand.d.ts +1 -1
  57. package/dist-types/commands/UpdateClusterSettingsCommand.d.ts +1 -1
  58. package/dist-types/commands/UpdateContainerAgentCommand.d.ts +4 -4
  59. package/dist-types/commands/UpdateContainerInstancesStateCommand.d.ts +6 -6
  60. package/dist-types/commands/UpdateServiceCommand.d.ts +16 -16
  61. package/dist-types/commands/UpdateServicePrimaryTaskSetCommand.d.ts +1 -1
  62. package/dist-types/commands/UpdateTaskSetCommand.d.ts +1 -1
  63. package/dist-types/models/models_0.d.ts +1041 -948
  64. package/dist-types/ts3.4/models/models_0.d.ts +38 -0
  65. package/package.json +6 -6
@@ -175,18 +175,18 @@ export interface ECSClientResolvedConfig extends ECSClientResolvedConfigType {
175
175
  }
176
176
  /**
177
177
  * <fullname>Amazon Elastic Container Service</fullname>
178
- * <p>Amazon Elastic Container Service (Amazon ECS) is a highly scalable, fast, container management service that makes
178
+ * <p>Amazon Elastic Container Service (Amazon ECS) is a highly scalable, fast, container management service. It makes
179
179
  * it easy to run, stop, and manage Docker containers on a cluster. You can host your
180
- * cluster on a serverless infrastructure that is managed by Amazon ECS by launching your
180
+ * cluster on a serverless infrastructure that's managed by Amazon ECS by launching your
181
181
  * services or tasks on Fargate. For more control, you can host your tasks on a cluster
182
182
  * of Amazon Elastic Compute Cloud (Amazon EC2) instances that you manage.</p>
183
183
  * <p>Amazon ECS makes it easy to launch and stop container-based applications with simple API
184
- * calls, allows you to get the state of your cluster from a centralized service, and gives
185
- * you access to many familiar Amazon EC2 features.</p>
184
+ * calls. This makes it easy to get the state of your cluster from a centralized service,
185
+ * and gives you access to many familiar Amazon EC2 features.</p>
186
186
  * <p>You can use Amazon ECS to schedule the placement of containers across your cluster based on
187
- * your resource needs, isolation policies, and availability requirements. Amazon ECS eliminates
188
- * the need for you to operate your own cluster management and configuration management
189
- * systems or worry about scaling your management infrastructure.</p>
187
+ * your resource needs, isolation policies, and availability requirements. With Amazon ECS, you
188
+ * don't need to operate your own cluster management and configuration management systems.
189
+ * You also don't need to worry about scaling your management infrastructure.</p>
190
190
  */
191
191
  export declare class ECSClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, ECSClientResolvedConfig> {
192
192
  /**
@@ -10,10 +10,10 @@ export interface CreateCapacityProviderCommandOutput extends CreateCapacityProvi
10
10
  * <p>Creates a new capacity provider. Capacity providers are associated with an Amazon ECS
11
11
  * cluster and are used in capacity provider strategies to facilitate cluster auto
12
12
  * scaling.</p>
13
- * <p>Only capacity providers using an Auto Scaling group can be created. Amazon ECS tasks on
14
- * Fargate use the <code>FARGATE</code> and <code>FARGATE_SPOT</code> capacity providers
15
- * which are already created and available to all accounts in Regions supported by
16
- * Fargate.</p>
13
+ * <p>Only capacity providers that use an Auto Scaling group can be created. Amazon ECS tasks on
14
+ * Fargate use the <code>FARGATE</code> and <code>FARGATE_SPOT</code> capacity providers.
15
+ * These providers are available to all accounts in the Amazon Web Services Regions that Fargate
16
+ * supports.</p>
17
17
  * @example
18
18
  * Use a bare-bones client and the command you need to make an API call.
19
19
  * ```javascript
@@ -26,7 +26,7 @@ export interface CreateCapacityProviderCommandOutput extends CreateCapacityProvi
26
26
  *
27
27
  * @see {@link CreateCapacityProviderCommandInput} for command's `input` shape.
28
28
  * @see {@link CreateCapacityProviderCommandOutput} for command's `response` shape.
29
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
29
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
30
30
  *
31
31
  */
32
32
  export declare class CreateCapacityProviderCommand extends $Command<CreateCapacityProviderCommandInput, CreateCapacityProviderCommandOutput, ECSClientResolvedConfig> {
@@ -12,10 +12,10 @@ export interface CreateClusterCommandOutput extends CreateClusterResponse, __Met
12
12
  * cluster with a unique name with the <code>CreateCluster</code> action.</p>
13
13
  * <note>
14
14
  * <p>When you call the <a>CreateCluster</a> API operation, Amazon ECS attempts to
15
- * create the Amazon ECS service-linked role for your account so that required resources in
16
- * other Amazon Web Services services can be managed on your behalf. However, if the IAM user that
17
- * makes the call does not have permissions to create the service-linked role, it is
18
- * not created. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html">Using
15
+ * create the Amazon ECS service-linked role for your account. This is so that it can manage
16
+ * required resources in other Amazon Web Services services on your behalf. However, if the IAM user
17
+ * that makes the call doesn't have permissions to create the service-linked role, it
18
+ * isn't created. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html">Using
19
19
  * Service-Linked Roles for Amazon ECS</a> in the
20
20
  * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
21
21
  * </note>
@@ -31,7 +31,7 @@ export interface CreateClusterCommandOutput extends CreateClusterResponse, __Met
31
31
  *
32
32
  * @see {@link CreateClusterCommandInput} for command's `input` shape.
33
33
  * @see {@link CreateClusterCommandOutput} for command's `response` shape.
34
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
34
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
35
35
  *
36
36
  */
37
37
  export declare class CreateClusterCommand extends $Command<CreateClusterCommandInput, CreateClusterCommandOutput, ECSClientResolvedConfig> {
@@ -7,26 +7,25 @@ export interface CreateServiceCommandInput extends CreateServiceRequest {
7
7
  export interface CreateServiceCommandOutput extends CreateServiceResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Runs and maintains a desired number of tasks from a specified task definition. If the
11
- * number of tasks running in a service drops below the <code>desiredCount</code>, Amazon ECS
12
- * runs another copy of the task in the specified cluster. To update an existing service,
13
- * see the UpdateService action.</p>
10
+ * <p>Runs and maintains your desired number of tasks from a specified task definition. If
11
+ * the number of tasks running in a service drops below the <code>desiredCount</code>,
12
+ * Amazon ECS runs another copy of the task in the specified cluster. To update an existing
13
+ * service, see the UpdateService action.</p>
14
14
  * <p>In addition to maintaining the desired count of tasks in your service, you can
15
15
  * optionally run your service behind one or more load balancers. The load balancers
16
16
  * distribute traffic across the tasks that are associated with the service. For more
17
17
  * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html">Service Load Balancing</a> in the
18
18
  * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
19
- * <p>Tasks for services that <i>do not</i> use a load balancer are considered
20
- * healthy if they're in the <code>RUNNING</code> state. Tasks for services that
21
- * <i>do</i> use a load balancer are considered healthy if they're in the
22
- * <code>RUNNING</code> state and the container instance that they're hosted on is
23
- * reported as healthy by the load balancer.</p>
19
+ * <p>Tasks for services that don't use a load balancer are considered healthy if they're in
20
+ * the <code>RUNNING</code> state. Tasks for services that use a load balancer are
21
+ * considered healthy if they're in the <code>RUNNING</code> state and the container
22
+ * instance that they're hosted on is reported as healthy by the load balancer.</p>
24
23
  * <p>There are two service scheduler strategies available:</p>
25
24
  * <ul>
26
25
  * <li>
27
26
  * <p>
28
27
  * <code>REPLICA</code> - The replica scheduling strategy places and
29
- * maintains the desired number of tasks across your cluster. By default, the
28
+ * maintains your desired number of tasks across your cluster. By default, the
30
29
  * service scheduler spreads tasks across Availability Zones. You can use task
31
30
  * placement strategies and constraints to customize task placement decisions. For
32
31
  * more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html">Service Scheduler Concepts</a> in the
@@ -37,50 +36,51 @@ export interface CreateServiceCommandOutput extends CreateServiceResponse, __Met
37
36
  * <code>DAEMON</code> - The daemon scheduling strategy deploys exactly one
38
37
  * task on each active container instance that meets all of the task placement
39
38
  * constraints that you specify in your cluster. The service scheduler also
40
- * evaluates the task placement constraints for running tasks and will stop tasks
41
- * that do not meet the placement constraints. When using this strategy, you don't
39
+ * evaluates the task placement constraints for running tasks. It also stops tasks
40
+ * that don't meet the placement constraints. When using this strategy, you don't
42
41
  * need to specify a desired number of tasks, a task placement strategy, or use
43
42
  * Service Auto Scaling policies. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html">Service Scheduler Concepts</a> in the
44
43
  * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
45
44
  * </li>
46
45
  * </ul>
47
46
  * <p>You can optionally specify a deployment configuration for your service. The deployment
48
- * is triggered by changing properties, such as the task definition or the desired count of
49
- * a service, with an <a>UpdateService</a> operation. The default value for a
50
- * replica service for <code>minimumHealthyPercent</code> is 100%. The default value for a
51
- * daemon service for <code>minimumHealthyPercent</code> is 0%.</p>
52
- * <p>If a service is using the <code>ECS</code> deployment controller, the minimum healthy
47
+ * is initiated by changing properties. For example, the deployment might be initiated by
48
+ * the task definition or by your desired count of a service. This is done with an <a>UpdateService</a> operation. The default value for a replica service for
49
+ * <code>minimumHealthyPercent</code> is 100%. The default value for a daemon service
50
+ * for <code>minimumHealthyPercent</code> is 0%.</p>
51
+ * <p>If a service uses the <code>ECS</code> deployment controller, the minimum healthy
53
52
  * percent represents a lower limit on the number of tasks in a service that must remain in
54
- * the <code>RUNNING</code> state during a deployment, as a percentage of the desired
55
- * number of tasks (rounded up to the nearest integer), and while any container instances
56
- * are in the <code>DRAINING</code> state if the service contains tasks using the
57
- * EC2 launch type. This parameter enables you to deploy without using
58
- * additional cluster capacity. For example, if your service has a desired number of four
59
- * tasks and a minimum healthy percent of 50%, the scheduler might stop two existing tasks
60
- * to free up cluster capacity before starting two new tasks. Tasks for services that
61
- * <i>do not</i> use a load balancer are considered healthy if they're in
62
- * the <code>RUNNING</code> state. Tasks for services that <i>do</i> use a
63
- * load balancer are considered healthy if they're in the <code>RUNNING</code> state and
64
- * they're reported as healthy by the load balancer. The default value for minimum healthy
65
- * percent is 100%.</p>
66
- * <p>If a service is using the <code>ECS</code> deployment controller, the <b>maximum percent</b> parameter represents an upper limit on the
53
+ * the <code>RUNNING</code> state during a deployment. Specifically, it represents it as a
54
+ * percentage of your desired number of tasks (rounded up to the nearest integer). This
55
+ * happens when any of your container instances are in the <code>DRAINING</code> state if
56
+ * the service contains tasks using the EC2 launch type. Using this
57
+ * parameter, you can deploy without using additional cluster capacity. For example, if you
58
+ * set your service to have desired number of four tasks and a minimum healthy percent of
59
+ * 50%, the scheduler might stop two existing tasks to free up cluster capacity before
60
+ * starting two new tasks. If they're in the <code>RUNNING</code> state, tasks for services
61
+ * that don't use a load balancer are considered healthy . If they're in the
62
+ * <code>RUNNING</code> state and reported as healthy by the load balancer, tasks for
63
+ * services that <i>do</i> use a load balancer are considered healthy . The
64
+ * default value for minimum healthy percent is 100%.</p>
65
+ * <p>If a service uses the <code>ECS</code> deployment controller, the <b>maximum percent</b> parameter represents an upper limit on the
67
66
  * number of tasks in a service that are allowed in the <code>RUNNING</code> or
68
- * <code>PENDING</code> state during a deployment, as a percentage of the desired
69
- * number of tasks (rounded down to the nearest integer), and while any container instances
70
- * are in the <code>DRAINING</code> state if the service contains tasks using the
71
- * EC2 launch type. This parameter enables you to define the deployment batch
72
- * size. For example, if your service has a desired number of four tasks and a maximum
73
- * percent value of 200%, the scheduler may start four new tasks before stopping the four
74
- * older tasks (provided that the cluster resources required to do this are available). The
75
- * default value for maximum percent is 200%.</p>
76
- * <p>If a service is using either the <code>CODE_DEPLOY</code> or <code>EXTERNAL</code>
67
+ * <code>PENDING</code> state during a deployment. Specifically, it represents it as a
68
+ * percentage of the desired number of tasks (rounded down to the nearest integer). This
69
+ * happens when any of your container instances are in the <code>DRAINING</code> state if
70
+ * the service contains tasks using the EC2 launch type. Using this
71
+ * parameter, you can define the deployment batch size. For example, if your service has a
72
+ * desired number of four tasks and a maximum percent value of 200%, the scheduler may
73
+ * start four new tasks before stopping the four older tasks (provided that the cluster
74
+ * resources required to do this are available). The default value for maximum percent is
75
+ * 200%.</p>
76
+ * <p>If a service uses either the <code>CODE_DEPLOY</code> or <code>EXTERNAL</code>
77
77
  * deployment controller types and tasks that use the EC2 launch type, the
78
78
  * <b>minimum healthy percent</b> and <b>maximum percent</b> values are used only to define the lower and upper limit
79
- * on the number of the tasks in the service that remain in the <code>RUNNING</code> state
80
- * while the container instances are in the <code>DRAINING</code> state. If the tasks in
81
- * the service use the Fargate launch type, the minimum healthy percent and
82
- * maximum percent values aren't used, although they're currently visible when describing
83
- * your service.</p>
79
+ * on the number of the tasks in the service that remain in the <code>RUNNING</code> state.
80
+ * This is while the container instances are in the <code>DRAINING</code> state. If the
81
+ * tasks in the service use the Fargate launch type, the minimum healthy
82
+ * percent and maximum percent values aren't used. This is the case even if they're
83
+ * currently visible when describing your service.</p>
84
84
  * <p>When creating a service that uses the <code>EXTERNAL</code> deployment controller, you
85
85
  * can specify only parameters that aren't controlled at the task set level. The only
86
86
  * required parameter is the service name. You control your services using the <a>CreateTaskSet</a> operation. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS Deployment Types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
@@ -88,14 +88,15 @@ export interface CreateServiceCommandOutput extends CreateServiceResponse, __Met
88
88
  * cluster using the following logic:</p>
89
89
  * <ul>
90
90
  * <li>
91
- * <p>Determine which of the container instances in your cluster can support your
92
- * service's task definition (for example, they have the required CPU, memory,
93
- * ports, and container instance attributes).</p>
91
+ * <p>Determine which of the container instances in your cluster can support the
92
+ * task definition of your service. For example, they have the required CPU,
93
+ * memory, ports, and container instance attributes.</p>
94
94
  * </li>
95
95
  * <li>
96
96
  * <p>By default, the service scheduler attempts to balance tasks across
97
- * Availability Zones in this manner (although you can choose a different placement
98
- * strategy) with the <code>placementStrategy</code> parameter):</p>
97
+ * Availability Zones in this manner. This is the case even if you can choose a
98
+ * different placement strategy with the <code>placementStrategy</code>
99
+ * parameter.</p>
99
100
  * <ul>
100
101
  * <li>
101
102
  * <p>Sort the valid container instances, giving priority to instances that
@@ -106,7 +107,7 @@ export interface CreateServiceCommandOutput extends CreateServiceResponse, __Met
106
107
  * </li>
107
108
  * <li>
108
109
  * <p>Place the new service task on a valid container instance in an optimal
109
- * Availability Zone (based on the previous steps), favoring container
110
+ * Availability Zone based on the previous steps, favoring container
110
111
  * instances with the fewest number of running tasks for this
111
112
  * service.</p>
112
113
  * </li>
@@ -125,7 +126,7 @@ export interface CreateServiceCommandOutput extends CreateServiceResponse, __Met
125
126
  *
126
127
  * @see {@link CreateServiceCommandInput} for command's `input` shape.
127
128
  * @see {@link CreateServiceCommandOutput} for command's `response` shape.
128
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
129
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
129
130
  *
130
131
  */
131
132
  export declare class CreateServiceCommand extends $Command<CreateServiceCommandInput, CreateServiceCommandOutput, ECSClientResolvedConfig> {
@@ -23,7 +23,7 @@ export interface CreateTaskSetCommandOutput extends CreateTaskSetResponse, __Met
23
23
  *
24
24
  * @see {@link CreateTaskSetCommandInput} for command's `input` shape.
25
25
  * @see {@link CreateTaskSetCommandOutput} for command's `response` shape.
26
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
26
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
27
27
  *
28
28
  */
29
29
  export declare class CreateTaskSetCommand extends $Command<CreateTaskSetCommandInput, CreateTaskSetCommandOutput, ECSClientResolvedConfig> {
@@ -21,7 +21,7 @@ export interface DeleteAccountSettingCommandOutput extends DeleteAccountSettingR
21
21
  *
22
22
  * @see {@link DeleteAccountSettingCommandInput} for command's `input` shape.
23
23
  * @see {@link DeleteAccountSettingCommandOutput} for command's `response` shape.
24
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
24
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
25
25
  *
26
26
  */
27
27
  export declare class DeleteAccountSettingCommand extends $Command<DeleteAccountSettingCommandInput, DeleteAccountSettingCommandOutput, ECSClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface DeleteAttributesCommandOutput extends DeleteAttributesResponse,
20
20
  *
21
21
  * @see {@link DeleteAttributesCommandInput} for command's `input` shape.
22
22
  * @see {@link DeleteAttributesCommandOutput} for command's `response` shape.
23
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class DeleteAttributesCommand extends $Command<DeleteAttributesCommandInput, DeleteAttributesCommandOutput, ECSClientResolvedConfig> {
@@ -10,8 +10,8 @@ export interface DeleteCapacityProviderCommandOutput extends DeleteCapacityProvi
10
10
  * <p>Deletes the specified capacity provider.</p>
11
11
  * <note>
12
12
  * <p>The <code>FARGATE</code> and <code>FARGATE_SPOT</code> capacity providers are
13
- * reserved and cannot be deleted. You can disassociate them from a cluster using
14
- * either the <a>PutClusterCapacityProviders</a> API or by deleting the
13
+ * reserved and can't be deleted. You can disassociate them from a cluster using either
14
+ * the <a>PutClusterCapacityProviders</a> API or by deleting the
15
15
  * cluster.</p>
16
16
  * </note>
17
17
  * <p>Prior to a capacity provider being deleted, the capacity provider must be removed from
@@ -20,7 +20,7 @@ export interface DeleteCapacityProviderCommandOutput extends DeleteCapacityProvi
20
20
  * strategy. When updating a service, the <code>forceNewDeployment</code> option can be
21
21
  * used to ensure that any tasks using the Amazon EC2 instance capacity provided by the capacity
22
22
  * provider are transitioned to use the capacity from the remaining capacity providers.
23
- * Only capacity providers that are not associated with a cluster can be deleted. To remove
23
+ * Only capacity providers that aren't associated with a cluster can be deleted. To remove
24
24
  * a capacity provider from a cluster, you can either use <a>PutClusterCapacityProviders</a> or delete the cluster.</p>
25
25
  * @example
26
26
  * Use a bare-bones client and the command you need to make an API call.
@@ -34,7 +34,7 @@ export interface DeleteCapacityProviderCommandOutput extends DeleteCapacityProvi
34
34
  *
35
35
  * @see {@link DeleteCapacityProviderCommandInput} for command's `input` shape.
36
36
  * @see {@link DeleteCapacityProviderCommandOutput} for command's `response` shape.
37
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
37
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
38
38
  *
39
39
  */
40
40
  export declare class DeleteCapacityProviderCommand extends $Command<DeleteCapacityProviderCommandInput, DeleteCapacityProviderCommandOutput, ECSClientResolvedConfig> {
@@ -7,11 +7,10 @@ export interface DeleteClusterCommandInput extends DeleteClusterRequest {
7
7
  export interface DeleteClusterCommandOutput extends DeleteClusterResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Deletes the specified cluster. The cluster will transition to the
11
- * <code>INACTIVE</code> state. Clusters with an <code>INACTIVE</code> status may
12
- * remain discoverable in your account for a period of time. However, this behavior is
13
- * subject to change in the future, so you should not rely on <code>INACTIVE</code>
14
- * clusters persisting.</p>
10
+ * <p>Deletes the specified cluster. The cluster transitions to the <code>INACTIVE</code>
11
+ * state. Clusters with an <code>INACTIVE</code> status might remain discoverable in your
12
+ * account for a period of time. However, this behavior is subject to change in the future.
13
+ * We don't recommend that you rely on <code>INACTIVE</code> clusters persisting.</p>
15
14
  * <p>You must deregister all container instances from this cluster before you may delete
16
15
  * it. You can list the container instances in a cluster with <a>ListContainerInstances</a> and deregister them with <a>DeregisterContainerInstance</a>.</p>
17
16
  * @example
@@ -26,7 +25,7 @@ export interface DeleteClusterCommandOutput extends DeleteClusterResponse, __Met
26
25
  *
27
26
  * @see {@link DeleteClusterCommandInput} for command's `input` shape.
28
27
  * @see {@link DeleteClusterCommandOutput} for command's `response` shape.
29
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
28
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
30
29
  *
31
30
  */
32
31
  export declare class DeleteClusterCommand extends $Command<DeleteClusterCommandInput, DeleteClusterCommandOutput, ECSClientResolvedConfig> {
@@ -9,7 +9,7 @@ export interface DeleteServiceCommandOutput extends DeleteServiceResponse, __Met
9
9
  /**
10
10
  * <p>Deletes a specified service within a cluster. You can delete a service if you have no
11
11
  * running tasks in it and the desired task count is zero. If the service is actively
12
- * maintaining tasks, you cannot delete it, and you must update the service to a desired
12
+ * maintaining tasks, you can't delete it, and you must update the service to a desired
13
13
  * task count of zero. For more information, see <a>UpdateService</a>.</p>
14
14
  * <note>
15
15
  * <p>When you delete a service, if there are still running tasks that require cleanup,
@@ -40,7 +40,7 @@ export interface DeleteServiceCommandOutput extends DeleteServiceResponse, __Met
40
40
  *
41
41
  * @see {@link DeleteServiceCommandInput} for command's `input` shape.
42
42
  * @see {@link DeleteServiceCommandOutput} for command's `response` shape.
43
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
43
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
44
44
  *
45
45
  */
46
46
  export declare class DeleteServiceCommand extends $Command<DeleteServiceCommandInput, DeleteServiceCommandOutput, ECSClientResolvedConfig> {
@@ -21,7 +21,7 @@ export interface DeleteTaskSetCommandOutput extends DeleteTaskSetResponse, __Met
21
21
  *
22
22
  * @see {@link DeleteTaskSetCommandInput} for command's `input` shape.
23
23
  * @see {@link DeleteTaskSetCommandOutput} for command's `response` shape.
24
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
24
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
25
25
  *
26
26
  */
27
27
  export declare class DeleteTaskSetCommand extends $Command<DeleteTaskSetCommandInput, DeleteTaskSetCommandOutput, ECSClientResolvedConfig> {
@@ -10,15 +10,16 @@ export interface DeregisterContainerInstanceCommandOutput extends DeregisterCont
10
10
  * <p>Deregisters an Amazon ECS container instance from the specified cluster. This instance is
11
11
  * no longer available to run tasks.</p>
12
12
  * <p>If you intend to use the container instance for some other purpose after
13
- * deregistration, you should stop all of the tasks running on the container instance
14
- * before deregistration. That prevents any orphaned tasks from consuming resources.</p>
15
- * <p>Deregistering a container instance removes the instance from a cluster, but it does
16
- * not terminate the EC2 instance. If you are finished using the instance, be sure to
17
- * terminate it in the Amazon EC2 console to stop billing.</p>
13
+ * deregistration, we recommend that you stop all of the tasks running on the container
14
+ * instance before deregistration. That prevents any orphaned tasks from consuming
15
+ * resources.</p>
16
+ * <p>Deregistering a container instance removes the instance from a cluster, but it doesn't
17
+ * terminate the EC2 instance. If you are finished using the instance, be sure to terminate
18
+ * it in the Amazon EC2 console to stop billing.</p>
18
19
  * <note>
19
20
  * <p>If you terminate a running container instance, Amazon ECS automatically deregisters the
20
21
  * instance from your cluster (stopped container instances or instances with
21
- * disconnected agents are not automatically deregistered when terminated).</p>
22
+ * disconnected agents aren't automatically deregistered when terminated).</p>
22
23
  * </note>
23
24
  * @example
24
25
  * Use a bare-bones client and the command you need to make an API call.
@@ -32,7 +33,7 @@ export interface DeregisterContainerInstanceCommandOutput extends DeregisterCont
32
33
  *
33
34
  * @see {@link DeregisterContainerInstanceCommandInput} for command's `input` shape.
34
35
  * @see {@link DeregisterContainerInstanceCommandOutput} for command's `response` shape.
35
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
36
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
36
37
  *
37
38
  */
38
39
  export declare class DeregisterContainerInstanceCommand extends $Command<DeregisterContainerInstanceCommandInput, DeregisterContainerInstanceCommandOutput, ECSClientResolvedConfig> {
@@ -12,16 +12,15 @@ export interface DeregisterTaskDefinitionCommandOutput extends DeregisterTaskDef
12
12
  * reference an <code>INACTIVE</code> task definition continue to run without disruption.
13
13
  * Existing services that reference an <code>INACTIVE</code> task definition can still
14
14
  * scale up or down by modifying the service's desired count.</p>
15
- * <p>You cannot use an <code>INACTIVE</code> task definition to run new tasks or create new
16
- * services, and you cannot update an existing service to reference an
17
- * <code>INACTIVE</code> task definition. However, there may be up to a 10-minute
18
- * window following deregistration where these restrictions have not yet taken
19
- * effect.</p>
15
+ * <p>You can't use an <code>INACTIVE</code> task definition to run new tasks or create new
16
+ * services, and you can't update an existing service to reference an <code>INACTIVE</code>
17
+ * task definition. However, there may be up to a 10-minute window following deregistration
18
+ * where these restrictions have not yet taken effect.</p>
20
19
  * <note>
21
20
  * <p>At this time, <code>INACTIVE</code> task definitions remain discoverable in your
22
- * account indefinitely. However, this behavior is subject to change in the future, so
23
- * you should not rely on <code>INACTIVE</code> task definitions persisting beyond the
24
- * lifecycle of any associated tasks and services.</p>
21
+ * account indefinitely. However, this behavior is subject to change in the future. We
22
+ * don't recommend that you rely on <code>INACTIVE</code> task definitions persisting
23
+ * beyond the lifecycle of any associated tasks and services.</p>
25
24
  * </note>
26
25
  * @example
27
26
  * Use a bare-bones client and the command you need to make an API call.
@@ -35,7 +34,7 @@ export interface DeregisterTaskDefinitionCommandOutput extends DeregisterTaskDef
35
34
  *
36
35
  * @see {@link DeregisterTaskDefinitionCommandInput} for command's `input` shape.
37
36
  * @see {@link DeregisterTaskDefinitionCommandOutput} for command's `response` shape.
38
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
37
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
39
38
  *
40
39
  */
41
40
  export declare class DeregisterTaskDefinitionCommand extends $Command<DeregisterTaskDefinitionCommandInput, DeregisterTaskDefinitionCommandOutput, ECSClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface DescribeCapacityProvidersCommandOutput extends DescribeCapacity
20
20
  *
21
21
  * @see {@link DescribeCapacityProvidersCommandInput} for command's `input` shape.
22
22
  * @see {@link DescribeCapacityProvidersCommandOutput} for command's `response` shape.
23
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class DescribeCapacityProvidersCommand extends $Command<DescribeCapacityProvidersCommandInput, DescribeCapacityProvidersCommandOutput, ECSClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface DescribeClustersCommandOutput extends DescribeClustersResponse,
20
20
  *
21
21
  * @see {@link DescribeClustersCommandInput} for command's `input` shape.
22
22
  * @see {@link DescribeClustersCommandOutput} for command's `response` shape.
23
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class DescribeClustersCommand extends $Command<DescribeClustersCommandInput, DescribeClustersCommandOutput, ECSClientResolvedConfig> {
@@ -21,7 +21,7 @@ export interface DescribeContainerInstancesCommandOutput extends DescribeContain
21
21
  *
22
22
  * @see {@link DescribeContainerInstancesCommandInput} for command's `input` shape.
23
23
  * @see {@link DescribeContainerInstancesCommandOutput} for command's `response` shape.
24
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
24
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
25
25
  *
26
26
  */
27
27
  export declare class DescribeContainerInstancesCommand extends $Command<DescribeContainerInstancesCommandInput, DescribeContainerInstancesCommandOutput, ECSClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface DescribeServicesCommandOutput extends DescribeServicesResponse,
20
20
  *
21
21
  * @see {@link DescribeServicesCommandInput} for command's `input` shape.
22
22
  * @see {@link DescribeServicesCommandOutput} for command's `response` shape.
23
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class DescribeServicesCommand extends $Command<DescribeServicesCommandInput, DescribeServicesCommandOutput, ECSClientResolvedConfig> {
@@ -27,7 +27,7 @@ export interface DescribeTaskDefinitionCommandOutput extends DescribeTaskDefinit
27
27
  *
28
28
  * @see {@link DescribeTaskDefinitionCommandInput} for command's `input` shape.
29
29
  * @see {@link DescribeTaskDefinitionCommandOutput} for command's `response` shape.
30
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
30
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
31
31
  *
32
32
  */
33
33
  export declare class DescribeTaskDefinitionCommand extends $Command<DescribeTaskDefinitionCommandInput, DescribeTaskDefinitionCommandOutput, ECSClientResolvedConfig> {
@@ -23,7 +23,7 @@ export interface DescribeTaskSetsCommandOutput extends DescribeTaskSetsResponse,
23
23
  *
24
24
  * @see {@link DescribeTaskSetsCommandInput} for command's `input` shape.
25
25
  * @see {@link DescribeTaskSetsCommandOutput} for command's `response` shape.
26
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
26
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
27
27
  *
28
28
  */
29
29
  export declare class DescribeTaskSetsCommand extends $Command<DescribeTaskSetsCommandInput, DescribeTaskSetsCommandOutput, ECSClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface DescribeTasksCommandOutput extends DescribeTasksResponse, __Met
20
20
  *
21
21
  * @see {@link DescribeTasksCommandInput} for command's `input` shape.
22
22
  * @see {@link DescribeTasksCommandOutput} for command's `response` shape.
23
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class DescribeTasksCommand extends $Command<DescribeTasksCommandInput, DescribeTasksCommandOutput, ECSClientResolvedConfig> {
@@ -10,8 +10,7 @@ export interface DiscoverPollEndpointCommandOutput extends DiscoverPollEndpointR
10
10
  * <note>
11
11
  * <p>This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.</p>
12
12
  * </note>
13
- * <p>Returns an endpoint for
14
- * the Amazon ECS agent to poll for updates.</p>
13
+ * <p>Returns an endpoint for the Amazon ECS agent to poll for updates.</p>
15
14
  * @example
16
15
  * Use a bare-bones client and the command you need to make an API call.
17
16
  * ```javascript
@@ -24,7 +23,7 @@ export interface DiscoverPollEndpointCommandOutput extends DiscoverPollEndpointR
24
23
  *
25
24
  * @see {@link DiscoverPollEndpointCommandInput} for command's `input` shape.
26
25
  * @see {@link DiscoverPollEndpointCommandOutput} for command's `response` shape.
27
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
26
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
28
27
  *
29
28
  */
30
29
  export declare class DiscoverPollEndpointCommand extends $Command<DiscoverPollEndpointCommandInput, DiscoverPollEndpointCommandOutput, ECSClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface ExecuteCommandCommandOutput extends ExecuteCommandResponse, __M
20
20
  *
21
21
  * @see {@link ExecuteCommandCommandInput} for command's `input` shape.
22
22
  * @see {@link ExecuteCommandCommandOutput} for command's `response` shape.
23
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class ExecuteCommandCommand extends $Command<ExecuteCommandCommandInput, ExecuteCommandCommandOutput, ECSClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface ListAccountSettingsCommandOutput extends ListAccountSettingsRes
20
20
  *
21
21
  * @see {@link ListAccountSettingsCommandInput} for command's `input` shape.
22
22
  * @see {@link ListAccountSettingsCommandOutput} for command's `response` shape.
23
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class ListAccountSettingsCommand extends $Command<ListAccountSettingsCommandInput, ListAccountSettingsCommandOutput, ECSClientResolvedConfig> {
@@ -11,9 +11,9 @@ export interface ListAttributesCommandOutput extends ListAttributesResponse, __M
11
11
  * When you specify a target type and cluster, <code>ListAttributes</code> returns a list
12
12
  * of attribute objects, one for each attribute on each resource. You can filter the list
13
13
  * of results to a single attribute name to only return results that have that name. You
14
- * can also filter the results by attribute name and value, for example, to see which
15
- * container instances in a cluster are running a Linux AMI
16
- * (<code>ecs.os-type=linux</code>). </p>
14
+ * can also filter the results by attribute name and value. You can do this, for example,
15
+ * to see which container instances in a cluster are running a Linux AMI
16
+ * (<code>ecs.os-type=linux</code>). </p>
17
17
  * @example
18
18
  * Use a bare-bones client and the command you need to make an API call.
19
19
  * ```javascript
@@ -26,7 +26,7 @@ export interface ListAttributesCommandOutput extends ListAttributesResponse, __M
26
26
  *
27
27
  * @see {@link ListAttributesCommandInput} for command's `input` shape.
28
28
  * @see {@link ListAttributesCommandOutput} for command's `response` shape.
29
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
29
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
30
30
  *
31
31
  */
32
32
  export declare class ListAttributesCommand extends $Command<ListAttributesCommandInput, ListAttributesCommandOutput, ECSClientResolvedConfig> {
@@ -20,7 +20,7 @@ export interface ListClustersCommandOutput extends ListClustersResponse, __Metad
20
20
  *
21
21
  * @see {@link ListClustersCommandInput} for command's `input` shape.
22
22
  * @see {@link ListClustersCommandOutput} for command's `response` shape.
23
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
23
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
24
24
  *
25
25
  */
26
26
  export declare class ListClustersCommand extends $Command<ListClustersCommandInput, ListClustersCommandOutput, ECSClientResolvedConfig> {
@@ -23,7 +23,7 @@ export interface ListContainerInstancesCommandOutput extends ListContainerInstan
23
23
  *
24
24
  * @see {@link ListContainerInstancesCommandInput} for command's `input` shape.
25
25
  * @see {@link ListContainerInstancesCommandOutput} for command's `response` shape.
26
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
26
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
27
27
  *
28
28
  */
29
29
  export declare class ListContainerInstancesCommand extends $Command<ListContainerInstancesCommandInput, ListContainerInstancesCommandOutput, ECSClientResolvedConfig> {
@@ -21,7 +21,7 @@ export interface ListServicesCommandOutput extends ListServicesResponse, __Metad
21
21
  *
22
22
  * @see {@link ListServicesCommandInput} for command's `input` shape.
23
23
  * @see {@link ListServicesCommandOutput} for command's `response` shape.
24
- * @see {@link ECSClientResolvedConfig | config} for command's `input` shape.
24
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
25
25
  *
26
26
  */
27
27
  export declare class ListServicesCommand extends $Command<ListServicesCommandInput, ListServicesCommandOutput, ECSClientResolvedConfig> {