@aws-sdk/client-ecs 3.51.0 → 3.54.0

package/dist-types/ECS.d.ts

@@ -109,8 +109,7 @@ export declare class ECS extends ECSClient {
      * 				<i>Amazon Elastic Container Service Developer Guide</i>.</p>
      * 		       <p>Tasks for services that don't use a load balancer are considered healthy if they're in
      * 			the <code>RUNNING</code> state. Tasks for services that use a load balancer are
-     * 			considered healthy if they're in the <code>RUNNING</code> state and the container
-     * 			instance that they're hosted on is reported as healthy by the load balancer.</p>
+     * 			considered healthy if they're in the <code>RUNNING</code> state and are reported as healthy by the load balancer.</p>
      * 		       <p>There are two service scheduler strategies available:</p>
      * 		       <ul>
      *             <li>
@@ -490,7 +489,7 @@ export declare class ECS extends ECSClient {
      * 			the root user for an account is affected. The opt-in and opt-out account setting must be
      * 			set for each Amazon ECS resource separately. The ARN and resource ID format of a resource is
      * 			defined by the opt-in status of the IAM user or role that created the resource. You must
-     * 			enable this setting to use Amazon ECS features such as resource tagging.</p>
+     * 			turn on this setting to use Amazon ECS features such as resource tagging.</p>
      * 		       <p>When <code>awsvpcTrunking</code> is specified, the elastic network interface (ENI)
      * 			limit for any new container instances that support the feature is changed. If
      * 				<code>awsvpcTrunking</code> is enabled, any new container instances that support the
@@ -750,8 +749,7 @@ export declare class ECS extends ECSClient {
      * 					replacement tasks are considered healthy. Tasks for services that do not use a
      * 					load balancer are considered healthy if they're in the <code>RUNNING</code>
      * 					state. Tasks for services that use a load balancer are considered healthy if
-     * 					they're in the <code>RUNNING</code> state and the container instance they're
-     * 					hosted on is reported as healthy by the load balancer.</p>
+     * 					they're in the <code>RUNNING</code> state and are reported as healthy by the load balancer..</p>
      * 			         </li>
      *             <li>
      * 				           <p>The <code>maximumPercent</code> parameter represents an upper limit on the
@@ -782,19 +780,21 @@ export declare class ECS extends ECSClient {
      * 				apply to your participation in this preview.</p>
      * 		       </important>
      * 		       <p>Modifies the parameters of a service.</p>
-     * 		       <p>For services using the rolling update (<code>ECS</code>) deployment controller, the
-     * 			desired count, deployment configuration, network configuration, task placement
-     * 			constraints and strategies, or task definition used can be updated.</p>
-     * 		       <p>For services using the blue/green (<code>CODE_DEPLOY</code>) deployment controller,
-     * 			only the desired count, deployment configuration, task placement constraints and
-     * 			strategies, and health check grace period can be updated using this API. If the network
-     * 			configuration, platform version, or task definition need to be updated, a new CodeDeploy
-     * 			deployment is 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>
-     * 		       <p>For services using an external deployment controller, you can update only the desired
-     * 			count, task placement constraints and strategies, and health check grace period using
-     * 			this API. If the launch type, load balancer, network configuration, platform version, or
-     * 			task definition need to be updated, create a new task set. For more information, see
-     * 				<a>CreateTaskSet</a>.</p>
+     * 		       <p>For services using the rolling update (<code>ECS</code>) you can update the desired count,
+     * 			the deployment configuration, the network configuration, load balancers, service
+     * 			registries, enable ECS managed tags option, propagate tags option, task placement
+     * 			constraints and strategies, and the task definition. When you update any of these
+     * 			parameters, Amazon ECS starts new tasks with the new configuration. </p>
+     * 		       <p>For services using the blue/green (<code>CODE_DEPLOY</code>) deployment controller, only the
+     * 			desired count, deployment configuration, task placement constraints and strategies,
+     * 			enable ECS managed tags option, and propagate tags can be updated using this API. If the
+     * 			network configuration, platform version, task definition, or load balancer need to be
+     * 			updated, create a new CodeDeploy deployment. 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>
+     * 		       <p>For services using an external deployment controller, you can update only the desired count,
+     * 			task placement constraints and strategies, health check grace period, enable ECS managed
+     * 			tags option, and propagate tags option, using this API. If the launch type, load
+     * 			balancer, network configuration, platform version, or task definition need to be
+     * 			updated, create a new task set For more information, see <a>CreateTaskSet</a>.</p>
      * 		       <p>You can add to or subtract from the number of instantiations of a task definition in a
      * 			service by specifying the cluster that the service is running in and a new
      * 				<code>desiredCount</code> parameter.</p>
@@ -822,9 +822,8 @@ export declare class ECS extends ECSClient {
      * 					scheduler to stop two existing tasks before starting two new tasks. Tasks for
      * 					services that don't use a load balancer are considered healthy if they're in the
      * 						<code>RUNNING</code> state. Tasks for services that use a load balancer are
-     * 					considered healthy if they're in the <code>RUNNING</code> state and the
-     * 					container instance they're hosted on is reported as healthy by the load
-     * 					balancer.</p>
+     * 					considered healthy if they're in the <code>RUNNING</code> state and are reported
+     * 					as healthy by the load balancer.</p>
      * 			         </li>
      *             <li>
      * 				           <p>The <code>maximumPercent</code> parameter represents an upper limit on the
@@ -869,6 +868,7 @@ export declare class ECS extends ECSClient {
      *                </ul>
      * 			         </li>
      *          </ul>
+     *
      * 		       <p>When the service scheduler stops running tasks, it attempts to maintain balance across
      * 			the Availability Zones in your cluster using the following logic: </p>
      * 		       <ul>
@@ -884,6 +884,25 @@ export declare class ECS extends ECSClient {
      * 					running tasks for this service.</p>
      * 			         </li>
      *          </ul>
+     * 		       <note>
+     * 		          <p>You must have a service-linked role when you update any of the following service properties.
+     * 			If you specified a custom IAM role when you created the service, Amazon ECS automatically
+     * 			replaces the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Service.html#ECS-Type-Service-roleArn">roleARN</a> associated with the service with the ARN of your service-linked
+     * 			role. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html">Service-linked
+     * 				roles</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
+     * 		          <ul>
+     *                <li>
+     * 				              <p>
+     *                      <code>loadBalancers,</code>
+     *                   </p>
+     * 			            </li>
+     *                <li>
+     * 				              <p>
+     *                      <code>serviceRegistries</code>
+     *                   </p>
+     * 			            </li>
+     *             </ul>
+     * 		       </note>
      */
     updateService(args: UpdateServiceCommandInput, options?: __HttpHandlerOptions): Promise<UpdateServiceCommandOutput>;
     updateService(args: UpdateServiceCommandInput, cb: (err: any, data?: UpdateServiceCommandOutput) => void): void;

package/dist-types/ECSClient.d.ts

@@ -5,7 +5,7 @@ import { AwsAuthInputConfig, AwsAuthResolvedConfig } from "@aws-sdk/middleware-s
 import { UserAgentInputConfig, UserAgentResolvedConfig } from "@aws-sdk/middleware-user-agent";
 import { HttpHandler as __HttpHandler } from "@aws-sdk/protocol-http";
 import { Client as __Client, DefaultsMode, SmithyConfiguration as __SmithyConfiguration, SmithyResolvedConfiguration as __SmithyResolvedConfiguration } from "@aws-sdk/smithy-client";
-import { Credentials as __Credentials, Decoder as __Decoder, Encoder as __Encoder, HashConstructor as __HashConstructor, HttpHandlerOptions as __HttpHandlerOptions, Logger as __Logger, Provider as __Provider, Provider, RegionInfoProvider, StreamCollector as __StreamCollector, UrlParser as __UrlParser, UserAgent as __UserAgent } from "@aws-sdk/types";
+import { BodyLengthCalculator as __BodyLengthCalculator, Credentials as __Credentials, Decoder as __Decoder, Encoder as __Encoder, HashConstructor as __HashConstructor, HttpHandlerOptions as __HttpHandlerOptions, Logger as __Logger, Provider as __Provider, Provider, RegionInfoProvider, StreamCollector as __StreamCollector, UrlParser as __UrlParser, UserAgent as __UserAgent } from "@aws-sdk/types";
 import { CreateCapacityProviderCommandInput, CreateCapacityProviderCommandOutput } from "./commands/CreateCapacityProviderCommand";
 import { CreateClusterCommandInput, CreateClusterCommandOutput } from "./commands/CreateClusterCommand";
 import { CreateServiceCommandInput, CreateServiceCommandOutput } from "./commands/CreateServiceCommand";
@@ -80,7 +80,7 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
      * A function that can calculate the length of a request body.
      * @internal
      */
-    bodyLengthChecker?: (body: any) => number | undefined;
+    bodyLengthChecker?: __BodyLengthCalculator;
     /**
      * A function that converts a stream into an array of bytes.
      * @internal

package/dist-types/commands/CreateServiceCommand.d.ts

@@ -18,8 +18,7 @@ export interface CreateServiceCommandOutput extends CreateServiceResponse, __Met
  * 				<i>Amazon Elastic Container Service Developer Guide</i>.</p>
  * 		       <p>Tasks for services that don't use a load balancer are considered healthy if they're in
  * 			the <code>RUNNING</code> state. Tasks for services that use a load balancer are
- * 			considered healthy if they're in the <code>RUNNING</code> state and the container
- * 			instance that they're hosted on is reported as healthy by the load balancer.</p>
+ * 			considered healthy if they're in the <code>RUNNING</code> state and are reported as healthy by the load balancer.</p>
  * 		       <p>There are two service scheduler strategies available:</p>
  * 		       <ul>
  *             <li>

package/dist-types/commands/PutAccountSettingCommand.d.ts

@@ -18,7 +18,7 @@ export interface PutAccountSettingCommandOutput extends PutAccountSettingRespons
  * 			the root user for an account is affected. The opt-in and opt-out account setting must be
  * 			set for each Amazon ECS resource separately. The ARN and resource ID format of a resource is
  * 			defined by the opt-in status of the IAM user or role that created the resource. You must
- * 			enable this setting to use Amazon ECS features such as resource tagging.</p>
+ * 			turn on this setting to use Amazon ECS features such as resource tagging.</p>
  * 		       <p>When <code>awsvpcTrunking</code> is specified, the elastic network interface (ENI)
  * 			limit for any new container instances that support the feature is changed. If
  * 				<code>awsvpcTrunking</code> is enabled, any new container instances that support the

package/dist-types/commands/UpdateContainerInstancesStateCommand.d.ts

@@ -36,8 +36,7 @@ export interface UpdateContainerInstancesStateCommandOutput extends UpdateContai
  * 					replacement tasks are considered healthy. Tasks for services that do not use a
  * 					load balancer are considered healthy if they're in the <code>RUNNING</code>
  * 					state. Tasks for services that use a load balancer are considered healthy if
- * 					they're in the <code>RUNNING</code> state and the container instance they're
- * 					hosted on is reported as healthy by the load balancer.</p>
+ * 					they're in the <code>RUNNING</code> state and are reported as healthy by the load balancer..</p>
  * 			         </li>
  *             <li>
  * 				           <p>The <code>maximumPercent</code> parameter represents an upper limit on the

package/dist-types/commands/UpdateServiceCommand.d.ts

@@ -14,19 +14,21 @@ export interface UpdateServiceCommandOutput extends UpdateServiceResponse, __Met
  * 				apply to your participation in this preview.</p>
  * 		       </important>
  * 		       <p>Modifies the parameters of a service.</p>
- * 		       <p>For services using the rolling update (<code>ECS</code>) deployment controller, the
- * 			desired count, deployment configuration, network configuration, task placement
- * 			constraints and strategies, or task definition used can be updated.</p>
- * 		       <p>For services using the blue/green (<code>CODE_DEPLOY</code>) deployment controller,
- * 			only the desired count, deployment configuration, task placement constraints and
- * 			strategies, and health check grace period can be updated using this API. If the network
- * 			configuration, platform version, or task definition need to be updated, a new CodeDeploy
- * 			deployment is 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>
- * 		       <p>For services using an external deployment controller, you can update only the desired
- * 			count, task placement constraints and strategies, and health check grace period using
- * 			this API. If the launch type, load balancer, network configuration, platform version, or
- * 			task definition need to be updated, create a new task set. For more information, see
- * 				<a>CreateTaskSet</a>.</p>
+ * 		       <p>For services using the rolling update (<code>ECS</code>) you can update the desired count,
+ * 			the deployment configuration, the network configuration, load balancers, service
+ * 			registries, enable ECS managed tags option, propagate tags option, task placement
+ * 			constraints and strategies, and the task definition. When you update any of these
+ * 			parameters, Amazon ECS starts new tasks with the new configuration. </p>
+ * 		       <p>For services using the blue/green (<code>CODE_DEPLOY</code>) deployment controller, only the
+ * 			desired count, deployment configuration, task placement constraints and strategies,
+ * 			enable ECS managed tags option, and propagate tags can be updated using this API. If the
+ * 			network configuration, platform version, task definition, or load balancer need to be
+ * 			updated, create a new CodeDeploy deployment. 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>
+ * 		       <p>For services using an external deployment controller, you can update only the desired count,
+ * 			task placement constraints and strategies, health check grace period, enable ECS managed
+ * 			tags option, and propagate tags option, using this API. If the launch type, load
+ * 			balancer, network configuration, platform version, or task definition need to be
+ * 			updated, create a new task set For more information, see <a>CreateTaskSet</a>.</p>
  * 		       <p>You can add to or subtract from the number of instantiations of a task definition in a
  * 			service by specifying the cluster that the service is running in and a new
  * 				<code>desiredCount</code> parameter.</p>
@@ -54,9 +56,8 @@ export interface UpdateServiceCommandOutput extends UpdateServiceResponse, __Met
  * 					scheduler to stop two existing tasks before starting two new tasks. Tasks for
  * 					services that don't use a load balancer are considered healthy if they're in the
  * 						<code>RUNNING</code> state. Tasks for services that use a load balancer are
- * 					considered healthy if they're in the <code>RUNNING</code> state and the
- * 					container instance they're hosted on is reported as healthy by the load
- * 					balancer.</p>
+ * 					considered healthy if they're in the <code>RUNNING</code> state and are reported
+ * 					as healthy by the load balancer.</p>
  * 			         </li>
  *             <li>
  * 				           <p>The <code>maximumPercent</code> parameter represents an upper limit on the
@@ -101,6 +102,7 @@ export interface UpdateServiceCommandOutput extends UpdateServiceResponse, __Met
  *                </ul>
  * 			         </li>
  *          </ul>
+ *
  * 		       <p>When the service scheduler stops running tasks, it attempts to maintain balance across
  * 			the Availability Zones in your cluster using the following logic: </p>
  * 		       <ul>
@@ -116,6 +118,25 @@ export interface UpdateServiceCommandOutput extends UpdateServiceResponse, __Met
  * 					running tasks for this service.</p>
  * 			         </li>
  *          </ul>
+ * 		       <note>
+ * 		          <p>You must have a service-linked role when you update any of the following service properties.
+ * 			If you specified a custom IAM role when you created the service, Amazon ECS automatically
+ * 			replaces the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Service.html#ECS-Type-Service-roleArn">roleARN</a> associated with the service with the ARN of your service-linked
+ * 			role. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html">Service-linked
+ * 				roles</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
+ * 		          <ul>
+ *                <li>
+ * 				              <p>
+ *                      <code>loadBalancers,</code>
+ *                   </p>
+ * 			            </li>
+ *                <li>
+ * 				              <p>
+ *                      <code>serviceRegistries</code>
+ *                   </p>
+ * 			            </li>
+ *             </ul>
+ * 		       </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/index.d.ts

@@ -4,3 +4,4 @@ export * from "./commands";
 export * from "./models";
 export * from "./pagination";
 export * from "./waiters";
+export { ECSServiceException } from "./models/ECSServiceException";

package/dist-types/models/ECSServiceException.d.ts

@@ -0,0 +1,10 @@
+import { ServiceException as __ServiceException, ServiceExceptionOptions as __ServiceExceptionOptions } from "@aws-sdk/smithy-client";
+/**
+ * Base exception class for all service exceptions from ECS service.
+ */
+export declare class ECSServiceException extends __ServiceException {
+    /**
+     * @internal
+     */
+    constructor(options: __ServiceExceptionOptions);
+}