@aws-sdk/client-ecs 3.36.0 → 3.39.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 (156) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/dist-cjs/ECS.js +0 -15
  3. package/dist-cjs/ECSClient.js +0 -20
  4. package/dist-cjs/commands/CreateCapacityProviderCommand.js +0 -30
  5. package/dist-cjs/commands/CreateClusterCommand.js +0 -35
  6. package/dist-cjs/commands/CreateServiceCommand.js +0 -129
  7. package/dist-cjs/commands/CreateTaskSetCommand.js +0 -27
  8. package/dist-cjs/commands/DeleteAccountSettingCommand.js +0 -25
  9. package/dist-cjs/commands/DeleteAttributesCommand.js +0 -24
  10. package/dist-cjs/commands/DeleteCapacityProviderCommand.js +0 -38
  11. package/dist-cjs/commands/DeleteClusterCommand.js +0 -30
  12. package/dist-cjs/commands/DeleteServiceCommand.js +0 -44
  13. package/dist-cjs/commands/DeleteTaskSetCommand.js +0 -25
  14. package/dist-cjs/commands/DeregisterContainerInstanceCommand.js +0 -36
  15. package/dist-cjs/commands/DeregisterTaskDefinitionCommand.js +0 -39
  16. package/dist-cjs/commands/DescribeCapacityProvidersCommand.js +0 -24
  17. package/dist-cjs/commands/DescribeClustersCommand.js +0 -24
  18. package/dist-cjs/commands/DescribeContainerInstancesCommand.js +0 -25
  19. package/dist-cjs/commands/DescribeServicesCommand.js +0 -24
  20. package/dist-cjs/commands/DescribeTaskDefinitionCommand.js +0 -31
  21. package/dist-cjs/commands/DescribeTaskSetsCommand.js +0 -27
  22. package/dist-cjs/commands/DescribeTasksCommand.js +0 -24
  23. package/dist-cjs/commands/DiscoverPollEndpointCommand.js +0 -28
  24. package/dist-cjs/commands/ExecuteCommandCommand.js +0 -24
  25. package/dist-cjs/commands/ListAccountSettingsCommand.js +0 -24
  26. package/dist-cjs/commands/ListAttributesCommand.js +0 -30
  27. package/dist-cjs/commands/ListClustersCommand.js +0 -24
  28. package/dist-cjs/commands/ListContainerInstancesCommand.js +0 -27
  29. package/dist-cjs/commands/ListServicesCommand.js +0 -25
  30. package/dist-cjs/commands/ListTagsForResourceCommand.js +0 -24
  31. package/dist-cjs/commands/ListTaskDefinitionFamiliesCommand.js +0 -30
  32. package/dist-cjs/commands/ListTaskDefinitionsCommand.js +0 -26
  33. package/dist-cjs/commands/ListTasksCommand.js +0 -28
  34. package/dist-cjs/commands/PutAccountSettingCommand.js +0 -47
  35. package/dist-cjs/commands/PutAccountSettingDefaultCommand.js +0 -26
  36. package/dist-cjs/commands/PutAttributesCommand.js +0 -28
  37. package/dist-cjs/commands/PutClusterCapacityProvidersCommand.js +0 -37
  38. package/dist-cjs/commands/RegisterContainerInstanceCommand.js +0 -29
  39. package/dist-cjs/commands/RegisterTaskDefinitionCommand.js +0 -41
  40. package/dist-cjs/commands/RunTaskCommand.js +0 -52
  41. package/dist-cjs/commands/StartTaskCommand.js +0 -28
  42. package/dist-cjs/commands/StopTaskCommand.js +0 -36
  43. package/dist-cjs/commands/SubmitAttachmentStateChangesCommand.js +0 -28
  44. package/dist-cjs/commands/SubmitContainerStateChangeCommand.js +0 -28
  45. package/dist-cjs/commands/SubmitTaskStateChangeCommand.js +0 -28
  46. package/dist-cjs/commands/TagResourceCommand.js +0 -27
  47. package/dist-cjs/commands/UntagResourceCommand.js +0 -24
  48. package/dist-cjs/commands/UpdateCapacityProviderCommand.js +0 -24
  49. package/dist-cjs/commands/UpdateClusterCommand.js +0 -24
  50. package/dist-cjs/commands/UpdateClusterSettingsCommand.js +0 -24
  51. package/dist-cjs/commands/UpdateContainerAgentCommand.js +0 -39
  52. package/dist-cjs/commands/UpdateContainerInstancesStateCommand.js +0 -72
  53. package/dist-cjs/commands/UpdateServiceCommand.js +0 -132
  54. package/dist-cjs/commands/UpdateServicePrimaryTaskSetCommand.js +0 -28
  55. package/dist-cjs/commands/UpdateTaskSetCommand.js +0 -26
  56. package/dist-cjs/commands/index.js +55 -0
  57. package/dist-cjs/endpoints.js +6 -1
  58. package/dist-cjs/index.js +5 -66
  59. package/dist-cjs/models/models_0.js +26 -619
  60. package/dist-cjs/pagination/ListAccountSettingsPaginator.js +0 -10
  61. package/dist-cjs/pagination/ListAttributesPaginator.js +0 -10
  62. package/dist-cjs/pagination/ListClustersPaginator.js +0 -10
  63. package/dist-cjs/pagination/ListContainerInstancesPaginator.js +0 -10
  64. package/dist-cjs/pagination/ListServicesPaginator.js +0 -10
  65. package/dist-cjs/pagination/ListTaskDefinitionFamiliesPaginator.js +0 -10
  66. package/dist-cjs/pagination/ListTaskDefinitionsPaginator.js +0 -10
  67. package/dist-cjs/pagination/ListTasksPaginator.js +0 -10
  68. package/dist-cjs/pagination/index.js +12 -0
  69. package/dist-cjs/protocols/Aws_json1_1.js +25 -5
  70. package/dist-cjs/runtimeConfig.browser.js +1 -5
  71. package/dist-cjs/runtimeConfig.js +1 -5
  72. package/dist-cjs/runtimeConfig.native.js +0 -3
  73. package/dist-cjs/runtimeConfig.shared.js +0 -3
  74. package/dist-cjs/waiters/index.js +6 -0
  75. package/dist-cjs/waiters/waitForServicesInactive.js +0 -9
  76. package/dist-cjs/waiters/waitForTasksRunning.js +0 -9
  77. package/dist-cjs/waiters/waitForTasksStopped.js +0 -9
  78. package/dist-es/commands/index.js +52 -0
  79. package/dist-es/endpoints.js +6 -1
  80. package/dist-es/index.js +5 -66
  81. package/dist-es/models/models_0.js +20 -0
  82. package/dist-es/pagination/index.js +9 -0
  83. package/dist-es/protocols/Aws_json1_1.js +22 -1
  84. package/dist-es/waiters/index.js +3 -0
  85. package/dist-types/commands/index.d.ts +52 -0
  86. package/dist-types/index.d.ts +5 -66
  87. package/dist-types/models/models_0.d.ts +170 -25
  88. package/dist-types/pagination/index.d.ts +9 -0
  89. package/dist-types/ts3.4/ECS.d.ts +53 -702
  90. package/dist-types/ts3.4/ECSClient.d.ts +24 -101
  91. package/dist-types/ts3.4/commands/CreateCapacityProviderCommand.d.ts +2 -26
  92. package/dist-types/ts3.4/commands/CreateClusterCommand.d.ts +2 -31
  93. package/dist-types/ts3.4/commands/CreateServiceCommand.d.ts +2 -125
  94. package/dist-types/ts3.4/commands/CreateTaskSetCommand.d.ts +2 -23
  95. package/dist-types/ts3.4/commands/DeleteAccountSettingCommand.d.ts +2 -21
  96. package/dist-types/ts3.4/commands/DeleteAttributesCommand.d.ts +2 -20
  97. package/dist-types/ts3.4/commands/DeleteCapacityProviderCommand.d.ts +2 -34
  98. package/dist-types/ts3.4/commands/DeleteClusterCommand.d.ts +2 -26
  99. package/dist-types/ts3.4/commands/DeleteServiceCommand.d.ts +2 -40
  100. package/dist-types/ts3.4/commands/DeleteTaskSetCommand.d.ts +2 -21
  101. package/dist-types/ts3.4/commands/DeregisterContainerInstanceCommand.d.ts +2 -32
  102. package/dist-types/ts3.4/commands/DeregisterTaskDefinitionCommand.d.ts +2 -35
  103. package/dist-types/ts3.4/commands/DescribeCapacityProvidersCommand.d.ts +2 -20
  104. package/dist-types/ts3.4/commands/DescribeClustersCommand.d.ts +2 -20
  105. package/dist-types/ts3.4/commands/DescribeContainerInstancesCommand.d.ts +2 -21
  106. package/dist-types/ts3.4/commands/DescribeServicesCommand.d.ts +2 -20
  107. package/dist-types/ts3.4/commands/DescribeTaskDefinitionCommand.d.ts +2 -27
  108. package/dist-types/ts3.4/commands/DescribeTaskSetsCommand.d.ts +2 -23
  109. package/dist-types/ts3.4/commands/DescribeTasksCommand.d.ts +2 -20
  110. package/dist-types/ts3.4/commands/DiscoverPollEndpointCommand.d.ts +2 -24
  111. package/dist-types/ts3.4/commands/ExecuteCommandCommand.d.ts +2 -20
  112. package/dist-types/ts3.4/commands/ListAccountSettingsCommand.d.ts +2 -20
  113. package/dist-types/ts3.4/commands/ListAttributesCommand.d.ts +2 -26
  114. package/dist-types/ts3.4/commands/ListClustersCommand.d.ts +2 -20
  115. package/dist-types/ts3.4/commands/ListContainerInstancesCommand.d.ts +2 -23
  116. package/dist-types/ts3.4/commands/ListServicesCommand.d.ts +2 -21
  117. package/dist-types/ts3.4/commands/ListTagsForResourceCommand.d.ts +2 -20
  118. package/dist-types/ts3.4/commands/ListTaskDefinitionFamiliesCommand.d.ts +2 -26
  119. package/dist-types/ts3.4/commands/ListTaskDefinitionsCommand.d.ts +2 -22
  120. package/dist-types/ts3.4/commands/ListTasksCommand.d.ts +2 -24
  121. package/dist-types/ts3.4/commands/PutAccountSettingCommand.d.ts +2 -43
  122. package/dist-types/ts3.4/commands/PutAccountSettingDefaultCommand.d.ts +2 -22
  123. package/dist-types/ts3.4/commands/PutAttributesCommand.d.ts +2 -24
  124. package/dist-types/ts3.4/commands/PutClusterCapacityProvidersCommand.d.ts +2 -33
  125. package/dist-types/ts3.4/commands/RegisterContainerInstanceCommand.d.ts +2 -25
  126. package/dist-types/ts3.4/commands/RegisterTaskDefinitionCommand.d.ts +2 -37
  127. package/dist-types/ts3.4/commands/RunTaskCommand.d.ts +2 -48
  128. package/dist-types/ts3.4/commands/StartTaskCommand.d.ts +2 -24
  129. package/dist-types/ts3.4/commands/StopTaskCommand.d.ts +2 -32
  130. package/dist-types/ts3.4/commands/SubmitAttachmentStateChangesCommand.d.ts +2 -24
  131. package/dist-types/ts3.4/commands/SubmitContainerStateChangeCommand.d.ts +2 -24
  132. package/dist-types/ts3.4/commands/SubmitTaskStateChangeCommand.d.ts +2 -24
  133. package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +2 -23
  134. package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +2 -20
  135. package/dist-types/ts3.4/commands/UpdateCapacityProviderCommand.d.ts +2 -20
  136. package/dist-types/ts3.4/commands/UpdateClusterCommand.d.ts +2 -20
  137. package/dist-types/ts3.4/commands/UpdateClusterSettingsCommand.d.ts +2 -20
  138. package/dist-types/ts3.4/commands/UpdateContainerAgentCommand.d.ts +2 -35
  139. package/dist-types/ts3.4/commands/UpdateContainerInstancesStateCommand.d.ts +2 -68
  140. package/dist-types/ts3.4/commands/UpdateServiceCommand.d.ts +2 -128
  141. package/dist-types/ts3.4/commands/UpdateServicePrimaryTaskSetCommand.d.ts +2 -24
  142. package/dist-types/ts3.4/commands/UpdateTaskSetCommand.d.ts +2 -22
  143. package/dist-types/ts3.4/commands/index.d.ts +52 -0
  144. package/dist-types/ts3.4/index.d.ts +5 -66
  145. package/dist-types/ts3.4/models/models_0.d.ts +1099 -6662
  146. package/dist-types/ts3.4/pagination/index.d.ts +9 -0
  147. package/dist-types/ts3.4/runtimeConfig.browser.d.ts +1 -3
  148. package/dist-types/ts3.4/runtimeConfig.d.ts +1 -3
  149. package/dist-types/ts3.4/runtimeConfig.native.d.ts +1 -3
  150. package/dist-types/ts3.4/runtimeConfig.shared.d.ts +1 -3
  151. package/dist-types/ts3.4/waiters/index.d.ts +3 -0
  152. package/dist-types/ts3.4/waiters/waitForServicesInactive.d.ts +2 -9
  153. package/dist-types/ts3.4/waiters/waitForTasksRunning.d.ts +2 -9
  154. package/dist-types/ts3.4/waiters/waitForTasksStopped.d.ts +2 -9
  155. package/dist-types/waiters/index.d.ts +3 -0
  156. package/package.json +33 -33
@@ -52,862 +52,213 @@ import { UpdateServiceCommandInput, UpdateServiceCommandOutput } from "./command
52
52
  import { UpdateServicePrimaryTaskSetCommandInput, UpdateServicePrimaryTaskSetCommandOutput } from "./commands/UpdateServicePrimaryTaskSetCommand";
53
53
  import { UpdateTaskSetCommandInput, UpdateTaskSetCommandOutput } from "./commands/UpdateTaskSetCommand";
54
54
  import { ECSClient } from "./ECSClient";
55
- /**
56
- * <fullname>Amazon Elastic Container Service</fullname>
57
- * <p>Amazon Elastic Container Service (Amazon ECS) is a highly scalable, fast, container management service that makes
58
- * it easy to run, stop, and manage Docker containers on a cluster. You can host your
59
- * cluster on a serverless infrastructure that is managed by Amazon ECS by launching your
60
- * services or tasks on Fargate. For more control, you can host your tasks on a cluster
61
- * of Amazon Elastic Compute Cloud (Amazon EC2) instances that you manage.</p>
62
- * <p>Amazon ECS makes it easy to launch and stop container-based applications with simple API
63
- * calls, allows you to get the state of your cluster from a centralized service, and gives
64
- * you access to many familiar Amazon EC2 features.</p>
65
- * <p>You can use Amazon ECS to schedule the placement of containers across your cluster based on
66
- * your resource needs, isolation policies, and availability requirements. Amazon ECS eliminates
67
- * the need for you to operate your own cluster management and configuration management
68
- * systems or worry about scaling your management infrastructure.</p>
69
- */
55
+
70
56
  export declare class ECS extends ECSClient {
71
- /**
72
- * <p>Creates a new capacity provider. Capacity providers are associated with an Amazon ECS
73
- * cluster and are used in capacity provider strategies to facilitate cluster auto
74
- * scaling.</p>
75
- * <p>Only capacity providers using an Auto Scaling group can be created. Amazon ECS tasks on
76
- * Fargate use the <code>FARGATE</code> and <code>FARGATE_SPOT</code> capacity providers
77
- * which are already created and available to all accounts in Regions supported by
78
- * Fargate.</p>
79
- */
57
+
80
58
  createCapacityProvider(args: CreateCapacityProviderCommandInput, options?: __HttpHandlerOptions): Promise<CreateCapacityProviderCommandOutput>;
81
59
  createCapacityProvider(args: CreateCapacityProviderCommandInput, cb: (err: any, data?: CreateCapacityProviderCommandOutput) => void): void;
82
60
  createCapacityProvider(args: CreateCapacityProviderCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateCapacityProviderCommandOutput) => void): void;
83
- /**
84
- * <p>Creates a new Amazon ECS cluster. By default, your account receives a <code>default</code>
85
- * cluster when you launch your first container instance. However, you can create your own
86
- * cluster with a unique name with the <code>CreateCluster</code> action.</p>
87
- * <note>
88
- * <p>When you call the <a>CreateCluster</a> API operation, Amazon ECS attempts to
89
- * create the Amazon ECS service-linked role for your account so that required resources in
90
- * other Amazon Web Services services can be managed on your behalf. However, if the IAM user that
91
- * makes the call does not have permissions to create the service-linked role, it is
92
- * not created. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html">Using
93
- * Service-Linked Roles for Amazon ECS</a> in the
94
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
95
- * </note>
96
- */
61
+
97
62
  createCluster(args: CreateClusterCommandInput, options?: __HttpHandlerOptions): Promise<CreateClusterCommandOutput>;
98
63
  createCluster(args: CreateClusterCommandInput, cb: (err: any, data?: CreateClusterCommandOutput) => void): void;
99
64
  createCluster(args: CreateClusterCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateClusterCommandOutput) => void): void;
100
- /**
101
- * <p>Runs and maintains a desired number of tasks from a specified task definition. If the
102
- * number of tasks running in a service drops below the <code>desiredCount</code>, Amazon ECS
103
- * runs another copy of the task in the specified cluster. To update an existing service,
104
- * see the UpdateService action.</p>
105
- * <p>In addition to maintaining the desired count of tasks in your service, you can
106
- * optionally run your service behind one or more load balancers. The load balancers
107
- * distribute traffic across the tasks that are associated with the service. For more
108
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html">Service Load Balancing</a> in the
109
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
110
- * <p>Tasks for services that <i>do not</i> use a load balancer are considered
111
- * healthy if they're in the <code>RUNNING</code> state. Tasks for services that
112
- * <i>do</i> use a load balancer are considered healthy if they're in the
113
- * <code>RUNNING</code> state and the container instance that they're hosted on is
114
- * reported as healthy by the load balancer.</p>
115
- * <p>There are two service scheduler strategies available:</p>
116
- * <ul>
117
- * <li>
118
- * <p>
119
- * <code>REPLICA</code> - The replica scheduling strategy places and
120
- * maintains the desired number of tasks across your cluster. By default, the
121
- * service scheduler spreads tasks across Availability Zones. You can use task
122
- * placement strategies and constraints to customize task placement decisions. For
123
- * more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html">Service Scheduler Concepts</a> in the
124
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
125
- * </li>
126
- * <li>
127
- * <p>
128
- * <code>DAEMON</code> - The daemon scheduling strategy deploys exactly one
129
- * task on each active container instance that meets all of the task placement
130
- * constraints that you specify in your cluster. The service scheduler also
131
- * evaluates the task placement constraints for running tasks and will stop tasks
132
- * that do not meet the placement constraints. When using this strategy, you don't
133
- * need to specify a desired number of tasks, a task placement strategy, or use
134
- * 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
135
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
136
- * </li>
137
- * </ul>
138
- * <p>You can optionally specify a deployment configuration for your service. The deployment
139
- * is triggered by changing properties, such as the task definition or the desired count of
140
- * a service, with an <a>UpdateService</a> operation. The default value for a
141
- * replica service for <code>minimumHealthyPercent</code> is 100%. The default value for a
142
- * daemon service for <code>minimumHealthyPercent</code> is 0%.</p>
143
- * <p>If a service is using the <code>ECS</code> deployment controller, the minimum healthy
144
- * percent represents a lower limit on the number of tasks in a service that must remain in
145
- * the <code>RUNNING</code> state during a deployment, as a percentage of the desired
146
- * number of tasks (rounded up to the nearest integer), and while any container instances
147
- * are in the <code>DRAINING</code> state if the service contains tasks using the
148
- * EC2 launch type. This parameter enables you to deploy without using
149
- * additional cluster capacity. For example, if your service has a desired number of four
150
- * tasks and a minimum healthy percent of 50%, the scheduler might stop two existing tasks
151
- * to free up cluster capacity before starting two new tasks. Tasks for services that
152
- * <i>do not</i> use a load balancer are considered healthy if they're in
153
- * the <code>RUNNING</code> state. Tasks for services that <i>do</i> use a
154
- * load balancer are considered healthy if they're in the <code>RUNNING</code> state and
155
- * they're reported as healthy by the load balancer. The default value for minimum healthy
156
- * percent is 100%.</p>
157
- * <p>If a service is using the <code>ECS</code> deployment controller, the <b>maximum percent</b> parameter represents an upper limit on the
158
- * number of tasks in a service that are allowed in the <code>RUNNING</code> or
159
- * <code>PENDING</code> state during a deployment, as a percentage of the desired
160
- * number of tasks (rounded down to the nearest integer), and while any container instances
161
- * are in the <code>DRAINING</code> state if the service contains tasks using the
162
- * EC2 launch type. This parameter enables you to define the deployment batch
163
- * size. For example, if your service has a desired number of four tasks and a maximum
164
- * percent value of 200%, the scheduler may start four new tasks before stopping the four
165
- * older tasks (provided that the cluster resources required to do this are available). The
166
- * default value for maximum percent is 200%.</p>
167
- * <p>If a service is using either the <code>CODE_DEPLOY</code> or <code>EXTERNAL</code>
168
- * deployment controller types and tasks that use the EC2 launch type, the
169
- * <b>minimum healthy percent</b> and <b>maximum percent</b> values are used only to define the lower and upper limit
170
- * on the number of the tasks in the service that remain in the <code>RUNNING</code> state
171
- * while the container instances are in the <code>DRAINING</code> state. If the tasks in
172
- * the service use the Fargate launch type, the minimum healthy percent and
173
- * maximum percent values aren't used, although they're currently visible when describing
174
- * your service.</p>
175
- * <p>When creating a service that uses the <code>EXTERNAL</code> deployment controller, you
176
- * can specify only parameters that aren't controlled at the task set level. The only
177
- * 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>
178
- * <p>When the service scheduler launches new tasks, it determines task placement in your
179
- * cluster using the following logic:</p>
180
- * <ul>
181
- * <li>
182
- * <p>Determine which of the container instances in your cluster can support your
183
- * service's task definition (for example, they have the required CPU, memory,
184
- * ports, and container instance attributes).</p>
185
- * </li>
186
- * <li>
187
- * <p>By default, the service scheduler attempts to balance tasks across
188
- * Availability Zones in this manner (although you can choose a different placement
189
- * strategy) with the <code>placementStrategy</code> parameter):</p>
190
- * <ul>
191
- * <li>
192
- * <p>Sort the valid container instances, giving priority to instances that
193
- * have the fewest number of running tasks for this service in their
194
- * respective Availability Zone. For example, if zone A has one running
195
- * service task and zones B and C each have zero, valid container instances
196
- * in either zone B or C are considered optimal for placement.</p>
197
- * </li>
198
- * <li>
199
- * <p>Place the new service task on a valid container instance in an optimal
200
- * Availability Zone (based on the previous steps), favoring container
201
- * instances with the fewest number of running tasks for this
202
- * service.</p>
203
- * </li>
204
- * </ul>
205
- * </li>
206
- * </ul>
207
- */
65
+
208
66
  createService(args: CreateServiceCommandInput, options?: __HttpHandlerOptions): Promise<CreateServiceCommandOutput>;
209
67
  createService(args: CreateServiceCommandInput, cb: (err: any, data?: CreateServiceCommandOutput) => void): void;
210
68
  createService(args: CreateServiceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateServiceCommandOutput) => void): void;
211
- /**
212
- * <p>Create a task set in the specified cluster and service. This is used when a service
213
- * uses the <code>EXTERNAL</code> deployment controller type. For more information, see
214
- * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS Deployment
215
- * Types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
216
- */
69
+
217
70
  createTaskSet(args: CreateTaskSetCommandInput, options?: __HttpHandlerOptions): Promise<CreateTaskSetCommandOutput>;
218
71
  createTaskSet(args: CreateTaskSetCommandInput, cb: (err: any, data?: CreateTaskSetCommandOutput) => void): void;
219
72
  createTaskSet(args: CreateTaskSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateTaskSetCommandOutput) => void): void;
220
- /**
221
- * <p>Disables an account setting for a specified IAM user, IAM role, or the root user for
222
- * an account.</p>
223
- */
73
+
224
74
  deleteAccountSetting(args: DeleteAccountSettingCommandInput, options?: __HttpHandlerOptions): Promise<DeleteAccountSettingCommandOutput>;
225
75
  deleteAccountSetting(args: DeleteAccountSettingCommandInput, cb: (err: any, data?: DeleteAccountSettingCommandOutput) => void): void;
226
76
  deleteAccountSetting(args: DeleteAccountSettingCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteAccountSettingCommandOutput) => void): void;
227
- /**
228
- * <p>Deletes one or more custom attributes from an Amazon ECS resource.</p>
229
- */
77
+
230
78
  deleteAttributes(args: DeleteAttributesCommandInput, options?: __HttpHandlerOptions): Promise<DeleteAttributesCommandOutput>;
231
79
  deleteAttributes(args: DeleteAttributesCommandInput, cb: (err: any, data?: DeleteAttributesCommandOutput) => void): void;
232
80
  deleteAttributes(args: DeleteAttributesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteAttributesCommandOutput) => void): void;
233
- /**
234
- * <p>Deletes the specified capacity provider.</p>
235
- * <note>
236
- * <p>The <code>FARGATE</code> and <code>FARGATE_SPOT</code> capacity providers are
237
- * reserved and cannot be deleted. You can disassociate them from a cluster using
238
- * either the <a>PutClusterCapacityProviders</a> API or by deleting the
239
- * cluster.</p>
240
- * </note>
241
- * <p>Prior to a capacity provider being deleted, the capacity provider must be removed from
242
- * the capacity provider strategy from all services. The <a>UpdateService</a>
243
- * API can be used to remove a capacity provider from a service's capacity provider
244
- * strategy. When updating a service, the <code>forceNewDeployment</code> option can be
245
- * used to ensure that any tasks using the Amazon EC2 instance capacity provided by the capacity
246
- * provider are transitioned to use the capacity from the remaining capacity providers.
247
- * Only capacity providers that are not associated with a cluster can be deleted. To remove
248
- * a capacity provider from a cluster, you can either use <a>PutClusterCapacityProviders</a> or delete the cluster.</p>
249
- */
81
+
250
82
  deleteCapacityProvider(args: DeleteCapacityProviderCommandInput, options?: __HttpHandlerOptions): Promise<DeleteCapacityProviderCommandOutput>;
251
83
  deleteCapacityProvider(args: DeleteCapacityProviderCommandInput, cb: (err: any, data?: DeleteCapacityProviderCommandOutput) => void): void;
252
84
  deleteCapacityProvider(args: DeleteCapacityProviderCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteCapacityProviderCommandOutput) => void): void;
253
- /**
254
- * <p>Deletes the specified cluster. The cluster will transition to the
255
- * <code>INACTIVE</code> state. Clusters with an <code>INACTIVE</code> status may
256
- * remain discoverable in your account for a period of time. However, this behavior is
257
- * subject to change in the future, so you should not rely on <code>INACTIVE</code>
258
- * clusters persisting.</p>
259
- * <p>You must deregister all container instances from this cluster before you may delete
260
- * it. You can list the container instances in a cluster with <a>ListContainerInstances</a> and deregister them with <a>DeregisterContainerInstance</a>.</p>
261
- */
85
+
262
86
  deleteCluster(args: DeleteClusterCommandInput, options?: __HttpHandlerOptions): Promise<DeleteClusterCommandOutput>;
263
87
  deleteCluster(args: DeleteClusterCommandInput, cb: (err: any, data?: DeleteClusterCommandOutput) => void): void;
264
88
  deleteCluster(args: DeleteClusterCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteClusterCommandOutput) => void): void;
265
- /**
266
- * <p>Deletes a specified service within a cluster. You can delete a service if you have no
267
- * running tasks in it and the desired task count is zero. If the service is actively
268
- * maintaining tasks, you cannot delete it, and you must update the service to a desired
269
- * task count of zero. For more information, see <a>UpdateService</a>.</p>
270
- * <note>
271
- * <p>When you delete a service, if there are still running tasks that require cleanup,
272
- * the service status moves from <code>ACTIVE</code> to <code>DRAINING</code>, and the
273
- * service is no longer visible in the console or in the <a>ListServices</a>
274
- * API operation. After all tasks have transitioned to either <code>STOPPING</code> or
275
- * <code>STOPPED</code> status, the service status moves from <code>DRAINING</code>
276
- * to <code>INACTIVE</code>. Services in the <code>DRAINING</code> or
277
- * <code>INACTIVE</code> status can still be viewed with the <a>DescribeServices</a> API operation. However, in the future,
278
- * <code>INACTIVE</code> services may be cleaned up and purged from Amazon ECS record
279
- * keeping, and <a>DescribeServices</a> calls on those services return a
280
- * <code>ServiceNotFoundException</code> error.</p>
281
- * </note>
282
- * <important>
283
- * <p>If you attempt to create a new service with the same name as an existing service
284
- * in either <code>ACTIVE</code> or <code>DRAINING</code> status, you receive an
285
- * error.</p>
286
- * </important>
287
- */
89
+
288
90
  deleteService(args: DeleteServiceCommandInput, options?: __HttpHandlerOptions): Promise<DeleteServiceCommandOutput>;
289
91
  deleteService(args: DeleteServiceCommandInput, cb: (err: any, data?: DeleteServiceCommandOutput) => void): void;
290
92
  deleteService(args: DeleteServiceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteServiceCommandOutput) => void): void;
291
- /**
292
- * <p>Deletes a specified task set within a service. This is used when a service uses the
293
- * <code>EXTERNAL</code> deployment controller type. 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>
294
- */
93
+
295
94
  deleteTaskSet(args: DeleteTaskSetCommandInput, options?: __HttpHandlerOptions): Promise<DeleteTaskSetCommandOutput>;
296
95
  deleteTaskSet(args: DeleteTaskSetCommandInput, cb: (err: any, data?: DeleteTaskSetCommandOutput) => void): void;
297
96
  deleteTaskSet(args: DeleteTaskSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteTaskSetCommandOutput) => void): void;
298
- /**
299
- * <p>Deregisters an Amazon ECS container instance from the specified cluster. This instance is
300
- * no longer available to run tasks.</p>
301
- * <p>If you intend to use the container instance for some other purpose after
302
- * deregistration, you should stop all of the tasks running on the container instance
303
- * before deregistration. That prevents any orphaned tasks from consuming resources.</p>
304
- * <p>Deregistering a container instance removes the instance from a cluster, but it does
305
- * not terminate the EC2 instance. If you are finished using the instance, be sure to
306
- * terminate it in the Amazon EC2 console to stop billing.</p>
307
- * <note>
308
- * <p>If you terminate a running container instance, Amazon ECS automatically deregisters the
309
- * instance from your cluster (stopped container instances or instances with
310
- * disconnected agents are not automatically deregistered when terminated).</p>
311
- * </note>
312
- */
97
+
313
98
  deregisterContainerInstance(args: DeregisterContainerInstanceCommandInput, options?: __HttpHandlerOptions): Promise<DeregisterContainerInstanceCommandOutput>;
314
99
  deregisterContainerInstance(args: DeregisterContainerInstanceCommandInput, cb: (err: any, data?: DeregisterContainerInstanceCommandOutput) => void): void;
315
100
  deregisterContainerInstance(args: DeregisterContainerInstanceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeregisterContainerInstanceCommandOutput) => void): void;
316
- /**
317
- * <p>Deregisters the specified task definition by family and revision. Upon deregistration,
318
- * the task definition is marked as <code>INACTIVE</code>. Existing tasks and services that
319
- * reference an <code>INACTIVE</code> task definition continue to run without disruption.
320
- * Existing services that reference an <code>INACTIVE</code> task definition can still
321
- * scale up or down by modifying the service's desired count.</p>
322
- * <p>You cannot use an <code>INACTIVE</code> task definition to run new tasks or create new
323
- * services, and you cannot update an existing service to reference an
324
- * <code>INACTIVE</code> task definition. However, there may be up to a 10-minute
325
- * window following deregistration where these restrictions have not yet taken
326
- * effect.</p>
327
- * <note>
328
- * <p>At this time, <code>INACTIVE</code> task definitions remain discoverable in your
329
- * account indefinitely. However, this behavior is subject to change in the future, so
330
- * you should not rely on <code>INACTIVE</code> task definitions persisting beyond the
331
- * lifecycle of any associated tasks and services.</p>
332
- * </note>
333
- */
101
+
334
102
  deregisterTaskDefinition(args: DeregisterTaskDefinitionCommandInput, options?: __HttpHandlerOptions): Promise<DeregisterTaskDefinitionCommandOutput>;
335
103
  deregisterTaskDefinition(args: DeregisterTaskDefinitionCommandInput, cb: (err: any, data?: DeregisterTaskDefinitionCommandOutput) => void): void;
336
104
  deregisterTaskDefinition(args: DeregisterTaskDefinitionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeregisterTaskDefinitionCommandOutput) => void): void;
337
- /**
338
- * <p>Describes one or more of your capacity providers.</p>
339
- */
105
+
340
106
  describeCapacityProviders(args: DescribeCapacityProvidersCommandInput, options?: __HttpHandlerOptions): Promise<DescribeCapacityProvidersCommandOutput>;
341
107
  describeCapacityProviders(args: DescribeCapacityProvidersCommandInput, cb: (err: any, data?: DescribeCapacityProvidersCommandOutput) => void): void;
342
108
  describeCapacityProviders(args: DescribeCapacityProvidersCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeCapacityProvidersCommandOutput) => void): void;
343
- /**
344
- * <p>Describes one or more of your clusters.</p>
345
- */
109
+
346
110
  describeClusters(args: DescribeClustersCommandInput, options?: __HttpHandlerOptions): Promise<DescribeClustersCommandOutput>;
347
111
  describeClusters(args: DescribeClustersCommandInput, cb: (err: any, data?: DescribeClustersCommandOutput) => void): void;
348
112
  describeClusters(args: DescribeClustersCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeClustersCommandOutput) => void): void;
349
- /**
350
- * <p>Describes one or more container instances. Returns metadata about each container
351
- * instance requested.</p>
352
- */
113
+
353
114
  describeContainerInstances(args: DescribeContainerInstancesCommandInput, options?: __HttpHandlerOptions): Promise<DescribeContainerInstancesCommandOutput>;
354
115
  describeContainerInstances(args: DescribeContainerInstancesCommandInput, cb: (err: any, data?: DescribeContainerInstancesCommandOutput) => void): void;
355
116
  describeContainerInstances(args: DescribeContainerInstancesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeContainerInstancesCommandOutput) => void): void;
356
- /**
357
- * <p>Describes the specified services running in your cluster.</p>
358
- */
117
+
359
118
  describeServices(args: DescribeServicesCommandInput, options?: __HttpHandlerOptions): Promise<DescribeServicesCommandOutput>;
360
119
  describeServices(args: DescribeServicesCommandInput, cb: (err: any, data?: DescribeServicesCommandOutput) => void): void;
361
120
  describeServices(args: DescribeServicesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeServicesCommandOutput) => void): void;
362
- /**
363
- * <p>Describes a task definition. You can specify a <code>family</code> and
364
- * <code>revision</code> to find information about a specific task definition, or you
365
- * can simply specify the family to find the latest <code>ACTIVE</code> revision in that
366
- * family.</p>
367
- * <note>
368
- * <p>You can only describe <code>INACTIVE</code> task definitions while an active task
369
- * or service references them.</p>
370
- * </note>
371
- */
121
+
372
122
  describeTaskDefinition(args: DescribeTaskDefinitionCommandInput, options?: __HttpHandlerOptions): Promise<DescribeTaskDefinitionCommandOutput>;
373
123
  describeTaskDefinition(args: DescribeTaskDefinitionCommandInput, cb: (err: any, data?: DescribeTaskDefinitionCommandOutput) => void): void;
374
124
  describeTaskDefinition(args: DescribeTaskDefinitionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeTaskDefinitionCommandOutput) => void): void;
375
- /**
376
- * <p>Describes a specified task or tasks.</p>
377
- */
125
+
378
126
  describeTasks(args: DescribeTasksCommandInput, options?: __HttpHandlerOptions): Promise<DescribeTasksCommandOutput>;
379
127
  describeTasks(args: DescribeTasksCommandInput, cb: (err: any, data?: DescribeTasksCommandOutput) => void): void;
380
128
  describeTasks(args: DescribeTasksCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeTasksCommandOutput) => void): void;
381
- /**
382
- * <p>Describes the task sets in the specified cluster and service. This is used when a
383
- * service uses the <code>EXTERNAL</code> deployment controller type. For more information,
384
- * see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS Deployment
385
- * Types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
386
- */
129
+
387
130
  describeTaskSets(args: DescribeTaskSetsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeTaskSetsCommandOutput>;
388
131
  describeTaskSets(args: DescribeTaskSetsCommandInput, cb: (err: any, data?: DescribeTaskSetsCommandOutput) => void): void;
389
132
  describeTaskSets(args: DescribeTaskSetsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeTaskSetsCommandOutput) => void): void;
390
- /**
391
- * <note>
392
- * <p>This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.</p>
393
- * </note>
394
- * <p>Returns an endpoint for
395
- * the Amazon ECS agent to poll for updates.</p>
396
- */
133
+
397
134
  discoverPollEndpoint(args: DiscoverPollEndpointCommandInput, options?: __HttpHandlerOptions): Promise<DiscoverPollEndpointCommandOutput>;
398
135
  discoverPollEndpoint(args: DiscoverPollEndpointCommandInput, cb: (err: any, data?: DiscoverPollEndpointCommandOutput) => void): void;
399
136
  discoverPollEndpoint(args: DiscoverPollEndpointCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DiscoverPollEndpointCommandOutput) => void): void;
400
- /**
401
- * <p>Runs a command remotely on a container within a task.</p>
402
- */
137
+
403
138
  executeCommand(args: ExecuteCommandCommandInput, options?: __HttpHandlerOptions): Promise<ExecuteCommandCommandOutput>;
404
139
  executeCommand(args: ExecuteCommandCommandInput, cb: (err: any, data?: ExecuteCommandCommandOutput) => void): void;
405
140
  executeCommand(args: ExecuteCommandCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ExecuteCommandCommandOutput) => void): void;
406
- /**
407
- * <p>Lists the account settings for a specified principal.</p>
408
- */
141
+
409
142
  listAccountSettings(args: ListAccountSettingsCommandInput, options?: __HttpHandlerOptions): Promise<ListAccountSettingsCommandOutput>;
410
143
  listAccountSettings(args: ListAccountSettingsCommandInput, cb: (err: any, data?: ListAccountSettingsCommandOutput) => void): void;
411
144
  listAccountSettings(args: ListAccountSettingsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListAccountSettingsCommandOutput) => void): void;
412
- /**
413
- * <p>Lists the attributes for Amazon ECS resources within a specified target type and cluster.
414
- * When you specify a target type and cluster, <code>ListAttributes</code> returns a list
415
- * of attribute objects, one for each attribute on each resource. You can filter the list
416
- * of results to a single attribute name to only return results that have that name. You
417
- * can also filter the results by attribute name and value, for example, to see which
418
- * container instances in a cluster are running a Linux AMI
419
- * (<code>ecs.os-type=linux</code>). </p>
420
- */
145
+
421
146
  listAttributes(args: ListAttributesCommandInput, options?: __HttpHandlerOptions): Promise<ListAttributesCommandOutput>;
422
147
  listAttributes(args: ListAttributesCommandInput, cb: (err: any, data?: ListAttributesCommandOutput) => void): void;
423
148
  listAttributes(args: ListAttributesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListAttributesCommandOutput) => void): void;
424
- /**
425
- * <p>Returns a list of existing clusters.</p>
426
- */
149
+
427
150
  listClusters(args: ListClustersCommandInput, options?: __HttpHandlerOptions): Promise<ListClustersCommandOutput>;
428
151
  listClusters(args: ListClustersCommandInput, cb: (err: any, data?: ListClustersCommandOutput) => void): void;
429
152
  listClusters(args: ListClustersCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListClustersCommandOutput) => void): void;
430
- /**
431
- * <p>Returns a list of container instances in a specified cluster. You can filter the
432
- * results of a <code>ListContainerInstances</code> operation with cluster query language
433
- * statements inside the <code>filter</code> parameter. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-query-language.html">Cluster Query Language</a> in the
434
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
435
- */
153
+
436
154
  listContainerInstances(args: ListContainerInstancesCommandInput, options?: __HttpHandlerOptions): Promise<ListContainerInstancesCommandOutput>;
437
155
  listContainerInstances(args: ListContainerInstancesCommandInput, cb: (err: any, data?: ListContainerInstancesCommandOutput) => void): void;
438
156
  listContainerInstances(args: ListContainerInstancesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListContainerInstancesCommandOutput) => void): void;
439
- /**
440
- * <p>Returns a list of services. You can filter the results by cluster, launch type, and
441
- * scheduling strategy.</p>
442
- */
157
+
443
158
  listServices(args: ListServicesCommandInput, options?: __HttpHandlerOptions): Promise<ListServicesCommandOutput>;
444
159
  listServices(args: ListServicesCommandInput, cb: (err: any, data?: ListServicesCommandOutput) => void): void;
445
160
  listServices(args: ListServicesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListServicesCommandOutput) => void): void;
446
- /**
447
- * <p>List the tags for an Amazon ECS resource.</p>
448
- */
161
+
449
162
  listTagsForResource(args: ListTagsForResourceCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsForResourceCommandOutput>;
450
163
  listTagsForResource(args: ListTagsForResourceCommandInput, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
451
164
  listTagsForResource(args: ListTagsForResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
452
- /**
453
- * <p>Returns a list of task definition families that are registered to your account (which
454
- * may include task definition families that no longer have any <code>ACTIVE</code> task
455
- * definition revisions).</p>
456
- * <p>You can filter out task definition families that do not contain any
457
- * <code>ACTIVE</code> task definition revisions by setting the <code>status</code>
458
- * parameter to <code>ACTIVE</code>. You can also filter the results with the
459
- * <code>familyPrefix</code> parameter.</p>
460
- */
165
+
461
166
  listTaskDefinitionFamilies(args: ListTaskDefinitionFamiliesCommandInput, options?: __HttpHandlerOptions): Promise<ListTaskDefinitionFamiliesCommandOutput>;
462
167
  listTaskDefinitionFamilies(args: ListTaskDefinitionFamiliesCommandInput, cb: (err: any, data?: ListTaskDefinitionFamiliesCommandOutput) => void): void;
463
168
  listTaskDefinitionFamilies(args: ListTaskDefinitionFamiliesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTaskDefinitionFamiliesCommandOutput) => void): void;
464
- /**
465
- * <p>Returns a list of task definitions that are registered to your account. You can filter
466
- * the results by family name with the <code>familyPrefix</code> parameter or by status
467
- * with the <code>status</code> parameter.</p>
468
- */
169
+
469
170
  listTaskDefinitions(args: ListTaskDefinitionsCommandInput, options?: __HttpHandlerOptions): Promise<ListTaskDefinitionsCommandOutput>;
470
171
  listTaskDefinitions(args: ListTaskDefinitionsCommandInput, cb: (err: any, data?: ListTaskDefinitionsCommandOutput) => void): void;
471
172
  listTaskDefinitions(args: ListTaskDefinitionsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTaskDefinitionsCommandOutput) => void): void;
472
- /**
473
- * <p>Returns a list of tasks. You can filter the results by cluster, task definition
474
- * family, container instance, launch type, what IAM principal started the task, or by the
475
- * desired status of the task.</p>
476
- * <p>Recently stopped tasks might appear in the returned results. Currently, stopped tasks
477
- * appear in the returned results for at least one hour.</p>
478
- */
173
+
479
174
  listTasks(args: ListTasksCommandInput, options?: __HttpHandlerOptions): Promise<ListTasksCommandOutput>;
480
175
  listTasks(args: ListTasksCommandInput, cb: (err: any, data?: ListTasksCommandOutput) => void): void;
481
176
  listTasks(args: ListTasksCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTasksCommandOutput) => void): void;
482
- /**
483
- * <p>Modifies an account setting. Account settings are set on a per-Region basis.</p>
484
- * <p>If you change the account setting for the root user, the default settings for all of
485
- * the IAM users and roles for which no individual account setting has been specified are
486
- * reset. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html">Account
487
- * Settings</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
488
- * <p>When <code>serviceLongArnFormat</code>, <code>taskLongArnFormat</code>, or
489
- * <code>containerInstanceLongArnFormat</code> are specified, the Amazon Resource Name
490
- * (ARN) and resource ID format of the resource type for a specified IAM user, IAM role, or
491
- * the root user for an account is affected. The opt-in and opt-out account setting must be
492
- * set for each Amazon ECS resource separately. The ARN and resource ID format of a resource
493
- * will be defined by the opt-in status of the IAM user or role that created the resource.
494
- * You must enable this setting to use Amazon ECS features such as resource tagging.</p>
495
- * <p>When <code>awsvpcTrunking</code> is specified, the elastic network interface (ENI)
496
- * limit for any new container instances that support the feature is changed. If
497
- * <code>awsvpcTrunking</code> is enabled, any new container instances that support the
498
- * feature are launched have the increased ENI limits available to them. For more
499
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-eni.html">Elastic Network
500
- * Interface Trunking</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
501
- * <p>When <code>containerInsights</code> is specified, the default setting indicating
502
- * whether CloudWatch Container Insights is enabled for your clusters is changed. If
503
- * <code>containerInsights</code> is enabled, any new clusters that are created will
504
- * have Container Insights enabled unless you disable it during cluster creation. For more
505
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html">CloudWatch
506
- * Container Insights</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
507
- */
177
+
508
178
  putAccountSetting(args: PutAccountSettingCommandInput, options?: __HttpHandlerOptions): Promise<PutAccountSettingCommandOutput>;
509
179
  putAccountSetting(args: PutAccountSettingCommandInput, cb: (err: any, data?: PutAccountSettingCommandOutput) => void): void;
510
180
  putAccountSetting(args: PutAccountSettingCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutAccountSettingCommandOutput) => void): void;
511
- /**
512
- * <p>Modifies an account setting for all IAM users on an account for whom no individual
513
- * account setting has been specified. Account settings are set on a per-Region
514
- * basis.</p>
515
- */
181
+
516
182
  putAccountSettingDefault(args: PutAccountSettingDefaultCommandInput, options?: __HttpHandlerOptions): Promise<PutAccountSettingDefaultCommandOutput>;
517
183
  putAccountSettingDefault(args: PutAccountSettingDefaultCommandInput, cb: (err: any, data?: PutAccountSettingDefaultCommandOutput) => void): void;
518
184
  putAccountSettingDefault(args: PutAccountSettingDefaultCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutAccountSettingDefaultCommandOutput) => void): void;
519
- /**
520
- * <p>Create or update an attribute on an Amazon ECS resource. If the attribute does not exist,
521
- * it is created. If the attribute exists, its value is replaced with the specified value.
522
- * To delete an attribute, use <a>DeleteAttributes</a>. For more information,
523
- * see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html#attributes">Attributes</a> in the
524
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
525
- */
185
+
526
186
  putAttributes(args: PutAttributesCommandInput, options?: __HttpHandlerOptions): Promise<PutAttributesCommandOutput>;
527
187
  putAttributes(args: PutAttributesCommandInput, cb: (err: any, data?: PutAttributesCommandOutput) => void): void;
528
188
  putAttributes(args: PutAttributesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutAttributesCommandOutput) => void): void;
529
- /**
530
- * <p>Modifies the available capacity providers and the default capacity provider strategy
531
- * for a cluster.</p>
532
- * <p>You must specify both the available capacity providers and a default capacity provider
533
- * strategy for the cluster. If the specified cluster has existing capacity providers
534
- * associated with it, you must specify all existing capacity providers in addition to any
535
- * new ones you want to add. Any existing capacity providers associated with a cluster that
536
- * are omitted from a <a>PutClusterCapacityProviders</a> API call will be
537
- * disassociated with the cluster. You can only disassociate an existing capacity provider
538
- * from a cluster if it's not being used by any existing tasks.</p>
539
- * <p>When creating a service or running a task on a cluster, if no capacity provider or
540
- * launch type is specified, then the cluster's default capacity provider strategy is used.
541
- * It is recommended to define a default capacity provider strategy for your cluster,
542
- * however you may specify an empty array (<code>[]</code>) to bypass defining a default
543
- * strategy.</p>
544
- */
189
+
545
190
  putClusterCapacityProviders(args: PutClusterCapacityProvidersCommandInput, options?: __HttpHandlerOptions): Promise<PutClusterCapacityProvidersCommandOutput>;
546
191
  putClusterCapacityProviders(args: PutClusterCapacityProvidersCommandInput, cb: (err: any, data?: PutClusterCapacityProvidersCommandOutput) => void): void;
547
192
  putClusterCapacityProviders(args: PutClusterCapacityProvidersCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutClusterCapacityProvidersCommandOutput) => void): void;
548
- /**
549
- * <note>
550
- * <p>This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.</p>
551
- * </note>
552
- * <p>Registers an EC2
553
- * instance into the specified cluster. This instance becomes available to place containers
554
- * on.</p>
555
- */
193
+
556
194
  registerContainerInstance(args: RegisterContainerInstanceCommandInput, options?: __HttpHandlerOptions): Promise<RegisterContainerInstanceCommandOutput>;
557
195
  registerContainerInstance(args: RegisterContainerInstanceCommandInput, cb: (err: any, data?: RegisterContainerInstanceCommandOutput) => void): void;
558
196
  registerContainerInstance(args: RegisterContainerInstanceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RegisterContainerInstanceCommandOutput) => void): void;
559
- /**
560
- * <p>Registers a new task definition from the supplied <code>family</code> and
561
- * <code>containerDefinitions</code>. Optionally, you can add data volumes to your
562
- * containers with the <code>volumes</code> parameter. For more information about task
563
- * definition parameters and defaults, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html">Amazon ECS Task
564
- * Definitions</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
565
- * <p>You can specify an IAM role for your task with the <code>taskRoleArn</code> parameter.
566
- * When you specify an IAM role for a task, its containers can then use the latest versions
567
- * of the CLI or SDKs to make API requests to the Amazon Web Services services that are specified in
568
- * the IAM policy associated with the role. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html">IAM
569
- * Roles for Tasks</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
570
- * <p>You can specify a Docker networking mode for the containers in your task definition
571
- * with the <code>networkMode</code> parameter. The available network modes correspond to
572
- * those described in <a href="https://docs.docker.com/engine/reference/run/#/network-settings">Network
573
- * settings</a> in the Docker run reference. If you specify the <code>awsvpc</code>
574
- * network mode, the task is allocated an elastic network interface, and you must specify a
575
- * <a>NetworkConfiguration</a> when you create a service or run a task with
576
- * the task definition. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html">Task Networking</a>
577
- * in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
578
- */
197
+
579
198
  registerTaskDefinition(args: RegisterTaskDefinitionCommandInput, options?: __HttpHandlerOptions): Promise<RegisterTaskDefinitionCommandOutput>;
580
199
  registerTaskDefinition(args: RegisterTaskDefinitionCommandInput, cb: (err: any, data?: RegisterTaskDefinitionCommandOutput) => void): void;
581
200
  registerTaskDefinition(args: RegisterTaskDefinitionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RegisterTaskDefinitionCommandOutput) => void): void;
582
- /**
583
- * <p>Starts a new task using the specified task definition.</p>
584
- * <p>You can allow Amazon ECS to place tasks for you, or you can customize how Amazon ECS places
585
- * tasks using placement constraints and placement strategies. For more information, see
586
- * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html">Scheduling Tasks</a> in the
587
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
588
- * <p>Alternatively, you can use <a>StartTask</a> to use your own scheduler or
589
- * place tasks manually on specific container instances.</p>
590
- * <p>The Amazon ECS API follows an eventual consistency model, due to the distributed nature of
591
- * the system supporting the API. This means that the result of an API command you run that
592
- * affects your Amazon ECS resources might not be immediately visible to all subsequent commands
593
- * you run. Keep this in mind when you carry out an API command that immediately follows a
594
- * previous API command.</p>
595
- * <p>To manage eventual consistency, you can do the following:</p>
596
- * <ul>
597
- * <li>
598
- * <p>Confirm the state of the resource before you run a command to modify it. Run
599
- * the DescribeTasks command using an exponential backoff algorithm to ensure that
600
- * you allow enough time for the previous command to propagate through the system.
601
- * To do this, run the DescribeTasks command repeatedly, starting with a couple of
602
- * seconds of wait time and increasing gradually up to five minutes of wait
603
- * time.</p>
604
- * </li>
605
- * <li>
606
- * <p>Add wait time between subsequent commands, even if the DescribeTasks command
607
- * returns an accurate response. Apply an exponential backoff algorithm starting
608
- * with a couple of seconds of wait time, and increase gradually up to about five
609
- * minutes of wait time.</p>
610
- * </li>
611
- * </ul>
612
- */
201
+
613
202
  runTask(args: RunTaskCommandInput, options?: __HttpHandlerOptions): Promise<RunTaskCommandOutput>;
614
203
  runTask(args: RunTaskCommandInput, cb: (err: any, data?: RunTaskCommandOutput) => void): void;
615
204
  runTask(args: RunTaskCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RunTaskCommandOutput) => void): void;
616
- /**
617
- * <p>Starts a new task from the specified task definition on the specified container
618
- * instance or instances.</p>
619
- * <p>Alternatively, you can use <a>RunTask</a> to place tasks for you. For more
620
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html">Scheduling Tasks</a> in the
621
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
622
- */
205
+
623
206
  startTask(args: StartTaskCommandInput, options?: __HttpHandlerOptions): Promise<StartTaskCommandOutput>;
624
207
  startTask(args: StartTaskCommandInput, cb: (err: any, data?: StartTaskCommandOutput) => void): void;
625
208
  startTask(args: StartTaskCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StartTaskCommandOutput) => void): void;
626
- /**
627
- * <p>Stops a running task. Any tags associated with the task will be deleted.</p>
628
- * <p>When <a>StopTask</a> is called on a task, the equivalent of <code>docker
629
- * stop</code> is issued to the containers running in the task. This results in a
630
- * <code>SIGTERM</code> value and a default 30-second timeout, after which the
631
- * <code>SIGKILL</code> value is sent and the containers are forcibly stopped. If the
632
- * container handles the <code>SIGTERM</code> value gracefully and exits within 30 seconds
633
- * from receiving it, no <code>SIGKILL</code> value is sent.</p>
634
- * <note>
635
- * <p>The default 30-second timeout can be configured on the Amazon ECS container agent with
636
- * the <code>ECS_CONTAINER_STOP_TIMEOUT</code> variable. For more information, see
637
- * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html">Amazon ECS Container Agent Configuration</a> in the
638
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
639
- * </note>
640
- */
209
+
641
210
  stopTask(args: StopTaskCommandInput, options?: __HttpHandlerOptions): Promise<StopTaskCommandOutput>;
642
211
  stopTask(args: StopTaskCommandInput, cb: (err: any, data?: StopTaskCommandOutput) => void): void;
643
212
  stopTask(args: StopTaskCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StopTaskCommandOutput) => void): void;
644
- /**
645
- * <note>
646
- * <p>This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.</p>
647
- * </note>
648
- * <p>Sent to
649
- * acknowledge that an attachment changed states.</p>
650
- */
213
+
651
214
  submitAttachmentStateChanges(args: SubmitAttachmentStateChangesCommandInput, options?: __HttpHandlerOptions): Promise<SubmitAttachmentStateChangesCommandOutput>;
652
215
  submitAttachmentStateChanges(args: SubmitAttachmentStateChangesCommandInput, cb: (err: any, data?: SubmitAttachmentStateChangesCommandOutput) => void): void;
653
216
  submitAttachmentStateChanges(args: SubmitAttachmentStateChangesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: SubmitAttachmentStateChangesCommandOutput) => void): void;
654
- /**
655
- * <note>
656
- * <p>This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.</p>
657
- * </note>
658
- * <p>Sent to
659
- * acknowledge that a container changed states.</p>
660
- */
217
+
661
218
  submitContainerStateChange(args: SubmitContainerStateChangeCommandInput, options?: __HttpHandlerOptions): Promise<SubmitContainerStateChangeCommandOutput>;
662
219
  submitContainerStateChange(args: SubmitContainerStateChangeCommandInput, cb: (err: any, data?: SubmitContainerStateChangeCommandOutput) => void): void;
663
220
  submitContainerStateChange(args: SubmitContainerStateChangeCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: SubmitContainerStateChangeCommandOutput) => void): void;
664
- /**
665
- * <note>
666
- * <p>This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.</p>
667
- * </note>
668
- * <p>Sent to acknowledge
669
- * that a task changed states.</p>
670
- */
221
+
671
222
  submitTaskStateChange(args: SubmitTaskStateChangeCommandInput, options?: __HttpHandlerOptions): Promise<SubmitTaskStateChangeCommandOutput>;
672
223
  submitTaskStateChange(args: SubmitTaskStateChangeCommandInput, cb: (err: any, data?: SubmitTaskStateChangeCommandOutput) => void): void;
673
224
  submitTaskStateChange(args: SubmitTaskStateChangeCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: SubmitTaskStateChangeCommandOutput) => void): void;
674
- /**
675
- * <p>Associates the specified tags to a resource with the specified
676
- * <code>resourceArn</code>. If existing tags on a resource are not specified in the
677
- * request parameters, they are not changed. When a resource is deleted, the tags
678
- * associated with that resource are deleted as well.</p>
679
- */
225
+
680
226
  tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
681
227
  tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
682
228
  tagResource(args: TagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
683
- /**
684
- * <p>Deletes specified tags from a resource.</p>
685
- */
229
+
686
230
  untagResource(args: UntagResourceCommandInput, options?: __HttpHandlerOptions): Promise<UntagResourceCommandOutput>;
687
231
  untagResource(args: UntagResourceCommandInput, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
688
232
  untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
689
- /**
690
- * <p>Modifies the parameters for a capacity provider.</p>
691
- */
233
+
692
234
  updateCapacityProvider(args: UpdateCapacityProviderCommandInput, options?: __HttpHandlerOptions): Promise<UpdateCapacityProviderCommandOutput>;
693
235
  updateCapacityProvider(args: UpdateCapacityProviderCommandInput, cb: (err: any, data?: UpdateCapacityProviderCommandOutput) => void): void;
694
236
  updateCapacityProvider(args: UpdateCapacityProviderCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateCapacityProviderCommandOutput) => void): void;
695
- /**
696
- * <p>Updates the cluster.</p>
697
- */
237
+
698
238
  updateCluster(args: UpdateClusterCommandInput, options?: __HttpHandlerOptions): Promise<UpdateClusterCommandOutput>;
699
239
  updateCluster(args: UpdateClusterCommandInput, cb: (err: any, data?: UpdateClusterCommandOutput) => void): void;
700
240
  updateCluster(args: UpdateClusterCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateClusterCommandOutput) => void): void;
701
- /**
702
- * <p>Modifies the settings to use for a cluster.</p>
703
- */
241
+
704
242
  updateClusterSettings(args: UpdateClusterSettingsCommandInput, options?: __HttpHandlerOptions): Promise<UpdateClusterSettingsCommandOutput>;
705
243
  updateClusterSettings(args: UpdateClusterSettingsCommandInput, cb: (err: any, data?: UpdateClusterSettingsCommandOutput) => void): void;
706
244
  updateClusterSettings(args: UpdateClusterSettingsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateClusterSettingsCommandOutput) => void): void;
707
- /**
708
- * <p>Updates the Amazon ECS container agent on a specified container instance. Updating the
709
- * Amazon ECS container agent does not interrupt running tasks or services on the container
710
- * instance. The process for updating the agent differs depending on whether your container
711
- * instance was launched with the Amazon ECS-optimized AMI or another operating system.</p>
712
- * <note>
713
- * <p>The <code>UpdateContainerAgent</code> API isn't supported for container instances
714
- * using the Amazon ECS-optimized Amazon Linux 2 (arm64) AMI. To update the container agent,
715
- * you can update the <code>ecs-init</code> package which will update the agent. For
716
- * more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/agent-update-ecs-ami.html">Updating the
717
- * Amazon ECS container agent</a> in the
718
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
719
- * </note>
720
- * <p>The <code>UpdateContainerAgent</code> API requires an Amazon ECS-optimized AMI or Amazon
721
- * Linux AMI with the <code>ecs-init</code> service installed and running. For help
722
- * updating the Amazon ECS container agent on other operating systems, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html#manually_update_agent">Manually updating the Amazon ECS container agent</a> in the
723
- * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
724
- */
245
+
725
246
  updateContainerAgent(args: UpdateContainerAgentCommandInput, options?: __HttpHandlerOptions): Promise<UpdateContainerAgentCommandOutput>;
726
247
  updateContainerAgent(args: UpdateContainerAgentCommandInput, cb: (err: any, data?: UpdateContainerAgentCommandOutput) => void): void;
727
248
  updateContainerAgent(args: UpdateContainerAgentCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateContainerAgentCommandOutput) => void): void;
728
- /**
729
- * <p>Modifies the status of an Amazon ECS container instance.</p>
730
- * <p>Once a container instance has reached an <code>ACTIVE</code> state, you can change the
731
- * status of a container instance to <code>DRAINING</code> to manually remove an instance
732
- * from a cluster, for example to perform system updates, update the Docker daemon, or
733
- * scale down the cluster size.</p>
734
- * <important>
735
- * <p>A container instance cannot be changed to <code>DRAINING</code> until it has
736
- * reached an <code>ACTIVE</code> status. If the instance is in any other status, an
737
- * error will be received.</p>
738
- * </important>
739
- * <p>When you set a container instance to <code>DRAINING</code>, Amazon ECS prevents new tasks
740
- * from being scheduled for placement on the container instance and replacement service
741
- * tasks are started on other container instances in the cluster if the resources are
742
- * available. Service tasks on the container instance that are in the <code>PENDING</code>
743
- * state are stopped immediately.</p>
744
- * <p>Service tasks on the container instance that are in the <code>RUNNING</code> state are
745
- * stopped and replaced according to the service's deployment configuration parameters,
746
- * <code>minimumHealthyPercent</code> and <code>maximumPercent</code>. You can change
747
- * the deployment configuration of your service using <a>UpdateService</a>.</p>
748
- * <ul>
749
- * <li>
750
- * <p>If <code>minimumHealthyPercent</code> is below 100%, the scheduler can ignore
751
- * <code>desiredCount</code> temporarily during task replacement. For example,
752
- * <code>desiredCount</code> is four tasks, a minimum of 50% allows the
753
- * scheduler to stop two existing tasks before starting two new tasks. If the
754
- * minimum is 100%, the service scheduler can't remove existing tasks until the
755
- * replacement tasks are considered healthy. Tasks for services that do not use a
756
- * load balancer are considered healthy if they are in the <code>RUNNING</code>
757
- * state. Tasks for services that use a load balancer are considered healthy if
758
- * they are in the <code>RUNNING</code> state and the container instance they are
759
- * hosted on is reported as healthy by the load balancer.</p>
760
- * </li>
761
- * <li>
762
- * <p>The <code>maximumPercent</code> parameter represents an upper limit on the
763
- * number of running tasks during task replacement, which enables you to define the
764
- * replacement batch size. For example, if <code>desiredCount</code> is four tasks,
765
- * a maximum of 200% starts four new tasks before stopping the four tasks to be
766
- * drained, provided that the cluster resources required to do this are available.
767
- * If the maximum is 100%, then replacement tasks can't start until the draining
768
- * tasks have stopped.</p>
769
- * </li>
770
- * </ul>
771
- * <p>Any <code>PENDING</code> or <code>RUNNING</code> tasks that do not belong to a service
772
- * are not affected. You must wait for them to finish or stop them manually.</p>
773
- * <p>A container instance has completed draining when it has no more <code>RUNNING</code>
774
- * tasks. You can verify this using <a>ListTasks</a>.</p>
775
- * <p>When a container instance has been drained, you can set a container instance to
776
- * <code>ACTIVE</code> status and once it has reached that status the Amazon ECS scheduler
777
- * can begin scheduling tasks on the instance again.</p>
778
- */
249
+
779
250
  updateContainerInstancesState(args: UpdateContainerInstancesStateCommandInput, options?: __HttpHandlerOptions): Promise<UpdateContainerInstancesStateCommandOutput>;
780
251
  updateContainerInstancesState(args: UpdateContainerInstancesStateCommandInput, cb: (err: any, data?: UpdateContainerInstancesStateCommandOutput) => void): void;
781
252
  updateContainerInstancesState(args: UpdateContainerInstancesStateCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateContainerInstancesStateCommandOutput) => void): void;
782
- /**
783
- * <important>
784
- * <p>Updating the task placement strategies and constraints on an Amazon ECS service remains
785
- * in preview and is a Beta Service as defined by and subject to the Beta Service
786
- * Participation Service Terms located at <a href="https://aws.amazon.com/service-terms">https://aws.amazon.com/service-terms</a> ("Beta Terms"). These Beta Terms
787
- * apply to your participation in this preview.</p>
788
- * </important>
789
- * <p>Modifies the parameters of a service.</p>
790
- * <p>For services using the rolling update (<code>ECS</code>) deployment controller, the
791
- * desired count, deployment configuration, network configuration, task placement
792
- * constraints and strategies, or task definition used can be updated.</p>
793
- * <p>For services using the blue/green (<code>CODE_DEPLOY</code>) deployment controller,
794
- * only the desired count, deployment configuration, task placement constraints and
795
- * strategies, and health check grace period can be updated using this API. If the network
796
- * configuration, platform version, or task definition need to be updated, a new CodeDeploy
797
- * deployment should be created. For more information, see <a href="https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html">CreateDeployment</a> in the <i>CodeDeploy API Reference</i>.</p>
798
- * <p>For services using an external deployment controller, you can update only the desired
799
- * count, task placement constraints and strategies, and health check grace period using
800
- * this API. If the launch type, load balancer, network configuration, platform version, or
801
- * task definition need to be updated, you should create a new task set. For more
802
- * information, see <a>CreateTaskSet</a>.</p>
803
- * <p>You can add to or subtract from the number of instantiations of a task definition in a
804
- * service by specifying the cluster that the service is running in and a new
805
- * <code>desiredCount</code> parameter.</p>
806
- * <p>If you have updated the Docker image of your application, you can create a new task
807
- * definition with that image and deploy it to your service. The service scheduler uses the
808
- * minimum healthy percent and maximum percent parameters (in the service's deployment
809
- * configuration) to determine the deployment strategy.</p>
810
- * <note>
811
- * <p>If your updated Docker image uses the same tag as what is in the existing task
812
- * definition for your service (for example, <code>my_image:latest</code>), you do not
813
- * need to create a new revision of your task definition. You can update the service
814
- * using the <code>forceNewDeployment</code> option. The new tasks launched by the
815
- * deployment pull the current image/tag combination from your repository when they
816
- * start.</p>
817
- * </note>
818
- * <p>You can also update the deployment configuration of a service. When a deployment is
819
- * triggered by updating the task definition of a service, the service scheduler uses the
820
- * deployment configuration parameters, <code>minimumHealthyPercent</code> and
821
- * <code>maximumPercent</code>, to determine the deployment strategy.</p>
822
- * <ul>
823
- * <li>
824
- * <p>If <code>minimumHealthyPercent</code> is below 100%, the scheduler can ignore
825
- * <code>desiredCount</code> temporarily during a deployment. For example, if
826
- * <code>desiredCount</code> is four tasks, a minimum of 50% allows the
827
- * scheduler to stop two existing tasks before starting two new tasks. Tasks for
828
- * services that do not use a load balancer are considered healthy if they are in
829
- * the <code>RUNNING</code> state. Tasks for services that use a load balancer are
830
- * considered healthy if they are in the <code>RUNNING</code> state and the
831
- * container instance they are hosted on is reported as healthy by the load
832
- * balancer.</p>
833
- * </li>
834
- * <li>
835
- * <p>The <code>maximumPercent</code> parameter represents an upper limit on the
836
- * number of running tasks during a deployment, which enables you to define the
837
- * deployment batch size. For example, if <code>desiredCount</code> is four tasks,
838
- * a maximum of 200% starts four new tasks before stopping the four older tasks
839
- * (provided that the cluster resources required to do this are available).</p>
840
- * </li>
841
- * </ul>
842
- * <p>When <a>UpdateService</a> stops a task during a deployment, the equivalent
843
- * of <code>docker stop</code> is issued to the containers running in the task. This
844
- * results in a <code>SIGTERM</code> and a 30-second timeout, after which
845
- * <code>SIGKILL</code> is sent and the containers are forcibly stopped. If the
846
- * container handles the <code>SIGTERM</code> gracefully and exits within 30 seconds from
847
- * receiving it, no <code>SIGKILL</code> is sent.</p>
848
- * <p>When the service scheduler launches new tasks, it determines task placement in your
849
- * cluster with the following logic:</p>
850
- * <ul>
851
- * <li>
852
- * <p>Determine which of the container instances in your cluster can support your
853
- * service's task definition (for example, they have the required CPU, memory,
854
- * ports, and container instance attributes).</p>
855
- * </li>
856
- * <li>
857
- * <p>By default, the service scheduler attempts to balance tasks across
858
- * Availability Zones in this manner (although you can choose a different placement
859
- * strategy):</p>
860
- * <ul>
861
- * <li>
862
- * <p>Sort the valid container instances by the fewest number of running
863
- * tasks for this service in the same Availability Zone as the instance.
864
- * For example, if zone A has one running service task and zones B and C
865
- * each have zero, valid container instances in either zone B or C are
866
- * considered optimal for placement.</p>
867
- * </li>
868
- * <li>
869
- * <p>Place the new service task on a valid container instance in an optimal
870
- * Availability Zone (based on the previous steps), favoring container
871
- * instances with the fewest number of running tasks for this
872
- * service.</p>
873
- * </li>
874
- * </ul>
875
- * </li>
876
- * </ul>
877
- * <p>When the service scheduler stops running tasks, it attempts to maintain balance across
878
- * the Availability Zones in your cluster using the following logic: </p>
879
- * <ul>
880
- * <li>
881
- * <p>Sort the container instances by the largest number of running tasks for this
882
- * service in the same Availability Zone as the instance. For example, if zone A
883
- * has one running service task and zones B and C each have two, container
884
- * instances in either zone B or C are considered optimal for termination.</p>
885
- * </li>
886
- * <li>
887
- * <p>Stop the task on a container instance in an optimal Availability Zone (based
888
- * on the previous steps), favoring container instances with the largest number of
889
- * running tasks for this service.</p>
890
- * </li>
891
- * </ul>
892
- */
253
+
893
254
  updateService(args: UpdateServiceCommandInput, options?: __HttpHandlerOptions): Promise<UpdateServiceCommandOutput>;
894
255
  updateService(args: UpdateServiceCommandInput, cb: (err: any, data?: UpdateServiceCommandOutput) => void): void;
895
256
  updateService(args: UpdateServiceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateServiceCommandOutput) => void): void;
896
- /**
897
- * <p>Modifies which task set in a service is the primary task set. Any parameters that are
898
- * updated on the primary task set in a service will transition to the service. This is
899
- * used when a service uses the <code>EXTERNAL</code> deployment controller type. For more
900
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS Deployment
901
- * Types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
902
- */
257
+
903
258
  updateServicePrimaryTaskSet(args: UpdateServicePrimaryTaskSetCommandInput, options?: __HttpHandlerOptions): Promise<UpdateServicePrimaryTaskSetCommandOutput>;
904
259
  updateServicePrimaryTaskSet(args: UpdateServicePrimaryTaskSetCommandInput, cb: (err: any, data?: UpdateServicePrimaryTaskSetCommandOutput) => void): void;
905
260
  updateServicePrimaryTaskSet(args: UpdateServicePrimaryTaskSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateServicePrimaryTaskSetCommandOutput) => void): void;
906
- /**
907
- * <p>Modifies a task set. This is used when a service uses the <code>EXTERNAL</code>
908
- * deployment controller type. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS Deployment
909
- * Types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
910
- */
261
+
911
262
  updateTaskSet(args: UpdateTaskSetCommandInput, options?: __HttpHandlerOptions): Promise<UpdateTaskSetCommandOutput>;
912
263
  updateTaskSet(args: UpdateTaskSetCommandInput, cb: (err: any, data?: UpdateTaskSetCommandOutput) => void): void;
913
264
  updateTaskSet(args: UpdateTaskSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateTaskSetCommandOutput) => void): void;