@aws-sdk/client-ecs 3.288.0 → 3.289.0

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

@@ -29,6 +29,71 @@ export interface ListAccountSettingsCommandOutput extends ListAccountSettingsRes
  * @see {@link ListAccountSettingsCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To view your effective account settings
+ * ```javascript
+ * // This example displays the effective account settings for your account.
+ * const input = {
+ *   "effectiveSettings": true
+ * };
+ * const command = new ListAccountSettingsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "settings": [
+ *     {
+ *       "name": "containerInstanceLongArnFormat",
+ *       "value": "disabled",
+ *       "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ *     },
+ *     {
+ *       "name": "serviceLongArnFormat",
+ *       "value": "enabled",
+ *       "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ *     },
+ *     {
+ *       "name": "taskLongArnFormat",
+ *       "value": "disabled",
+ *       "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-view-your-account-settings-1549524118170
+ * ```
+ *
+ * @example To view the effective account settings for a specific IAM user or IAM role
+ * ```javascript
+ * // This example displays the effective account settings for the specified user or role.
+ * const input = {
+ *   "effectiveSettings": true,
+ *   "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ * };
+ * const command = new ListAccountSettingsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "settings": [
+ *     {
+ *       "name": "containerInstanceLongArnFormat",
+ *       "value": "disabled",
+ *       "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ *     },
+ *     {
+ *       "name": "serviceLongArnFormat",
+ *       "value": "enabled",
+ *       "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ *     },
+ *     {
+ *       "name": "taskLongArnFormat",
+ *       "value": "disabled",
+ *       "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-view-the-account-settings-for-a-specific-iam-user-or-iam-role-1549524237932
+ * ```
+ *
  */
 export declare class ListAccountSettingsCommand extends $Command<ListAccountSettingsCommandInput, ListAccountSettingsCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListAccountSettingsCommandInput;

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

@@ -29,6 +29,23 @@ export interface ListClustersCommandOutput extends ListClustersResponse, __Metad
  * @see {@link ListClustersCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To list your available clusters
+ * ```javascript
+ * // This example lists all of your available clusters in your default region.
+ * const input = {};
+ * const command = new ListClustersCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "clusterArns": [
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:cluster/test",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:cluster/default"
+ *   ]
+ * }
+ * *\/
+ * // example id: e337d059-134f-4125-ba8e-4f499139facf
+ * ```
+ *
  */
 export declare class ListClustersCommand extends $Command<ListClustersCommandInput, ListClustersCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListClustersCommandInput;

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

@@ -31,6 +31,25 @@ export interface ListContainerInstancesCommandOutput extends ListContainerInstan
  * @see {@link ListContainerInstancesCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To list your available container instances in a cluster
+ * ```javascript
+ * // This example lists all of your available container instances in the specified cluster in your default region.
+ * const input = {
+ *   "cluster": "default"
+ * };
+ * const command = new ListContainerInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "containerInstanceArns": [
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/f6bbb147-5370-4ace-8c73-c7181ded911f",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb"
+ *   ]
+ * }
+ * *\/
+ * // example id: 62a82a94-713c-4e18-8420-1d2b2ba9d484
+ * ```
+ *
  */
 export declare class ListContainerInstancesCommand extends $Command<ListContainerInstancesCommandInput, ListContainerInstancesCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListContainerInstancesCommandInput;

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

@@ -30,6 +30,22 @@ export interface ListServicesCommandOutput extends ListServicesResponse, __Metad
  * @see {@link ListServicesCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To list the services in a cluster
+ * ```javascript
+ * // This example lists the services running in the default cluster for an account.
+ * const input = {};
+ * const command = new ListServicesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "serviceArns": [
+ *     "arn:aws:ecs:us-east-1:012345678910:service/my-http-service"
+ *   ]
+ * }
+ * *\/
+ * // example id: 1d9a8037-4e0e-4234-a528-609656809a3a
+ * ```
+ *
  */
 export declare class ListServicesCommand extends $Command<ListServicesCommandInput, ListServicesCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListServicesCommandInput;

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

@@ -29,6 +29,27 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes
  * @see {@link ListTagsForResourceCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To list the tags for a cluster.
+ * ```javascript
+ * // This example lists the tags for the 'dev' cluster.
+ * const input = {
+ *   "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev"
+ * };
+ * const command = new ListTagsForResourceCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "tags": [
+ *     {
+ *       "key": "team",
+ *       "value": "dev"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-list-the-tags-for-a-cluster-1540582700259
+ * ```
+ *
  */
 export declare class ListTagsForResourceCommand extends $Command<ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListTagsForResourceCommandInput;

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

@@ -35,6 +35,44 @@ export interface ListTaskDefinitionFamiliesCommandOutput extends ListTaskDefinit
  * @see {@link ListTaskDefinitionFamiliesCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To list your registered task definition families
+ * ```javascript
+ * // This example lists all of your registered task definition families.
+ * const input = {};
+ * const command = new ListTaskDefinitionFamiliesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "families": [
+ *     "node-js-app",
+ *     "web-timer",
+ *     "hpcc",
+ *     "hpcc-c4-8xlarge"
+ *   ]
+ * }
+ * *\/
+ * // example id: b5c89769-1d94-4ca2-a79e-8069103c7f75
+ * ```
+ *
+ * @example To filter your registered task definition families
+ * ```javascript
+ * // This example lists the task definition revisions that start with "hpcc".
+ * const input = {
+ *   "familyPrefix": "hpcc"
+ * };
+ * const command = new ListTaskDefinitionFamiliesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "families": [
+ *     "hpcc",
+ *     "hpcc-c4-8xlarge"
+ *   ]
+ * }
+ * *\/
+ * // example id: 8a4cf9a6-42c1-4fe3-852d-99ac8968e11b
+ * ```
+ *
  */
 export declare class ListTaskDefinitionFamiliesCommand extends $Command<ListTaskDefinitionFamiliesCommandInput, ListTaskDefinitionFamiliesCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListTaskDefinitionFamiliesCommandInput;

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

@@ -31,6 +31,48 @@ export interface ListTaskDefinitionsCommandOutput extends ListTaskDefinitionsRes
  * @see {@link ListTaskDefinitionsCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To list your registered task definitions
+ * ```javascript
+ * // This example lists all of your registered task definitions.
+ * const input = {};
+ * const command = new ListTaskDefinitionsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "taskDefinitionArns": [
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep300:2",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep360:1",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:3",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:4",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:5",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:6"
+ *   ]
+ * }
+ * *\/
+ * // example id: b381ebaf-7eba-4d60-b99b-7f6ae49d3d60
+ * ```
+ *
+ * @example To list the registered task definitions in a family
+ * ```javascript
+ * // This example lists the task definition revisions of a specified family.
+ * const input = {
+ *   "familyPrefix": "wordpress"
+ * };
+ * const command = new ListTaskDefinitionsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "taskDefinitionArns": [
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:3",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:4",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:5",
+ *     "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:6"
+ *   ]
+ * }
+ * *\/
+ * // example id: 734e7afd-753a-4bc2-85d0-badddce10910
+ * ```
+ *
  */
 export declare class ListTaskDefinitionsCommand extends $Command<ListTaskDefinitionsCommandInput, ListTaskDefinitionsCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListTaskDefinitionsCommandInput;

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

@@ -33,6 +33,44 @@ export interface ListTasksCommandOutput extends ListTasksResponse, __MetadataBea
  * @see {@link ListTasksCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To list the tasks in a cluster
+ * ```javascript
+ * // This example lists all of the tasks in a cluster.
+ * const input = {
+ *   "cluster": "default"
+ * };
+ * const command = new ListTasksCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "taskArns": [
+ *     "arn:aws:ecs:us-east-1:012345678910:task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84",
+ *     "arn:aws:ecs:us-east-1:012345678910:task/6b809ef6-c67e-4467-921f-ee261c15a0a1"
+ *   ]
+ * }
+ * *\/
+ * // example id: 9a6ec707-1a77-45d0-b2eb-516b5dd9e924
+ * ```
+ *
+ * @example To list the tasks on a particular container instance
+ * ```javascript
+ * // This example lists the tasks of a specified container instance. Specifying a ``containerInstance`` value limits  the  results  to  tasks  that belong to that container instance.
+ * const input = {
+ *   "cluster": "default",
+ *   "containerInstance": "f6bbb147-5370-4ace-8c73-c7181ded911f"
+ * };
+ * const command = new ListTasksCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "taskArns": [
+ *     "arn:aws:ecs:us-east-1:012345678910:task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84"
+ *   ]
+ * }
+ * *\/
+ * // example id: 024bf3b7-9cbb-44e3-848f-9d074e1fecce
+ * ```
+ *
  */
 export declare class ListTasksCommand extends $Command<ListTasksCommandInput, ListTasksCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListTasksCommandInput;

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

@@ -52,6 +52,49 @@ export interface PutAccountSettingCommandOutput extends PutAccountSettingRespons
  * @see {@link PutAccountSettingCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To modify your account settings
+ * ```javascript
+ * // This example modifies your account settings to opt in to the new ARN and resource ID format for Amazon ECS services. If you’re using this command as the root user, then changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.
+ * const input = {
+ *   "name": "serviceLongArnFormat",
+ *   "value": "enabled"
+ * };
+ * const command = new PutAccountSettingCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "setting": {
+ *     "name": "serviceLongArnFormat",
+ *     "value": "enabled",
+ *     "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ *   }
+ * }
+ * *\/
+ * // example id: to-modify-the-account-settings-for-your-iam-user-account-1549523130939
+ * ```
+ *
+ * @example To modify the account settings for a specific IAM user or IAM role
+ * ```javascript
+ * // This example modifies the account setting for a specific IAM user or IAM role to opt in to the new ARN and resource ID format for Amazon ECS container instances. If you’re using this command as the root user, then changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.
+ * const input = {
+ *   "name": "containerInstanceLongArnFormat",
+ *   "value": "enabled",
+ *   "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ * };
+ * const command = new PutAccountSettingCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "setting": {
+ *     "name": "containerInstanceLongArnFormat",
+ *     "value": "enabled",
+ *     "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
+ *   }
+ * }
+ * *\/
+ * // example id: to-modify-the-account-settings-for-a-specific-iam-user-or-iam-role-1549523518390
+ * ```
+ *
  */
 export declare class PutAccountSettingCommand extends $Command<PutAccountSettingCommandInput, PutAccountSettingCommandOutput, ECSClientResolvedConfig> {
     readonly input: PutAccountSettingCommandInput;

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

@@ -31,6 +31,27 @@ export interface PutAccountSettingDefaultCommandOutput extends PutAccountSetting
  * @see {@link PutAccountSettingDefaultCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To modify the default account settings for all IAM users or roles on an account
+ * ```javascript
+ * // This example modifies the default account setting for the specified resource for all IAM users or roles on an account. These changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.
+ * const input = {
+ *   "name": "serviceLongArnFormat",
+ *   "value": "enabled"
+ * };
+ * const command = new PutAccountSettingDefaultCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "setting": {
+ *     "name": "serviceLongArnFormat",
+ *     "value": "enabled",
+ *     "principalArn": "arn:aws:iam::<aws_account_id>:root"
+ *   }
+ * }
+ * *\/
+ * // example id: to-modify-the-default-account-settings-for-all-iam-users-or-roles-on-your-account-1549523794603
+ * ```
+ *
  */
 export declare class PutAccountSettingDefaultCommand extends $Command<PutAccountSettingDefaultCommandInput, PutAccountSettingDefaultCommandOutput, ECSClientResolvedConfig> {
     readonly input: PutAccountSettingDefaultCommandInput;

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

@@ -46,6 +46,59 @@ export interface RegisterTaskDefinitionCommandOutput extends RegisterTaskDefinit
  * @see {@link RegisterTaskDefinitionCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To register a task definition
+ * ```javascript
+ * // This example registers a task definition to the specified family.
+ * const input = {
+ *   "containerDefinitions": [
+ *     {
+ *       "name": "sleep",
+ *       "command": [
+ *         "sleep",
+ *         "360"
+ *       ],
+ *       "cpu": 10,
+ *       "essential": true,
+ *       "image": "busybox",
+ *       "memory": 10
+ *     }
+ *   ],
+ *   "family": "sleep360",
+ *   "taskRoleArn": "",
+ *   "volumes": []
+ * };
+ * const command = new RegisterTaskDefinitionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "taskDefinition": {
+ *     "containerDefinitions": [
+ *       {
+ *         "name": "sleep",
+ *         "command": [
+ *           "sleep",
+ *           "360"
+ *         ],
+ *         "cpu": 10,
+ *         "environment": [],
+ *         "essential": true,
+ *         "image": "busybox",
+ *         "memory": 10,
+ *         "mountPoints": [],
+ *         "portMappings": [],
+ *         "volumesFrom": []
+ *       }
+ *     ],
+ *     "family": "sleep360",
+ *     "revision": 1,
+ *     "taskDefinitionArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep360:19",
+ *     "volumes": []
+ *   }
+ * }
+ * *\/
+ * // example id: to-register-a-task-definition-1470764550877
+ * ```
+ *
  */
 export declare class RegisterTaskDefinitionCommand extends $Command<RegisterTaskDefinitionCommandInput, RegisterTaskDefinitionCommandOutput, ECSClientResolvedConfig> {
     readonly input: RegisterTaskDefinitionCommandInput;

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

@@ -56,6 +56,46 @@ export interface RunTaskCommandOutput extends RunTaskResponse, __MetadataBearer
  * @see {@link RunTaskCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To run a task on your default cluster
+ * ```javascript
+ * // This example runs the specified task definition on your default cluster.
+ * const input = {
+ *   "cluster": "default",
+ *   "taskDefinition": "sleep360:1"
+ * };
+ * const command = new RunTaskCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "tasks": [
+ *     {
+ *       "containerInstanceArn": "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb",
+ *       "containers": [
+ *         {
+ *           "name": "sleep",
+ *           "containerArn": "arn:aws:ecs:us-east-1:<aws_account_id>:container/58591c8e-be29-4ddf-95aa-ee459d4c59fd",
+ *           "lastStatus": "PENDING",
+ *           "taskArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0"
+ *         }
+ *       ],
+ *       "desiredStatus": "RUNNING",
+ *       "lastStatus": "PENDING",
+ *       "overrides": {
+ *         "containerOverrides": [
+ *           {
+ *             "name": "sleep"
+ *           }
+ *         ]
+ *       },
+ *       "taskArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0",
+ *       "taskDefinitionArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep360:1"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: 6f238c83-a133-42cd-ab3d-abeca0560445
+ * ```
+ *
  */
 export declare class RunTaskCommand extends $Command<RunTaskCommandInput, RunTaskCommandOutput, ECSClientResolvedConfig> {
     readonly input: RunTaskCommandInput;

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

@@ -32,6 +32,23 @@ export interface TagResourceCommandOutput extends TagResourceResponse, __Metadat
  * @see {@link TagResourceCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To tag a cluster.
+ * ```javascript
+ * // This example tags the 'dev' cluster with key 'team' and value 'dev'.
+ * const input = {
+ *   "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev",
+ *   "tags": [
+ *     {
+ *       "key": "team",
+ *       "value": "dev"
+ *     }
+ *   ]
+ * };
+ * const command = new TagResourceCommand(input);
+ * await client.send(command);
+ * // example id: to-tag-a-cluster-1540581863751
+ * ```
+ *
  */
 export declare class TagResourceCommand extends $Command<TagResourceCommandInput, TagResourceCommandOutput, ECSClientResolvedConfig> {
     readonly input: TagResourceCommandInput;

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

@@ -29,6 +29,20 @@ export interface UntagResourceCommandOutput extends UntagResourceResponse, __Met
  * @see {@link UntagResourceCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To untag a cluster.
+ * ```javascript
+ * // This example deletes the 'team' tag from the 'dev' cluster.
+ * const input = {
+ *   "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev",
+ *   "tagKeys": [
+ *     "team"
+ *   ]
+ * };
+ * const command = new UntagResourceCommand(input);
+ * await client.send(command);
+ * // example id: to-untag-a-cluster-1540582546056
+ * ```
+ *
  */
 export declare class UntagResourceCommand extends $Command<UntagResourceCommandInput, UntagResourceCommandOutput, ECSClientResolvedConfig> {
     readonly input: UntagResourceCommandInput;

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

@@ -151,6 +151,30 @@ export interface UpdateServiceCommandOutput extends UpdateServiceResponse, __Met
  * @see {@link UpdateServiceCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To change the task definition used in a service
+ * ```javascript
+ * // This example updates the my-http-service service to use the amazon-ecs-sample task definition.
+ * const input = {
+ *   "service": "my-http-service",
+ *   "taskDefinition": "amazon-ecs-sample"
+ * };
+ * const command = new UpdateServiceCommand(input);
+ * await client.send(command);
+ * // example id: cc9e8900-0cc2-44d2-8491-64d1d3d37887
+ * ```
+ *
+ * @example To change the number of tasks in a service
+ * ```javascript
+ * // This example updates the desired count of the my-http-service service to 10.
+ * const input = {
+ *   "desiredCount": 10,
+ *   "service": "my-http-service"
+ * };
+ * const command = new UpdateServiceCommand(input);
+ * await client.send(command);
+ * // example id: 9581d6c5-02e3-4140-8cc1-5a4301586633
+ * ```
+ *
  */
 export declare class UpdateServiceCommand extends $Command<UpdateServiceCommandInput, UpdateServiceCommandOutput, ECSClientResolvedConfig> {
     readonly input: UpdateServiceCommandInput;

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

@@ -55,6 +55,87 @@ export interface UpdateTaskProtectionCommandOutput extends UpdateTaskProtectionR
  * @see {@link UpdateTaskProtectionCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @example To set task scale-in protection for a task for 60 minutes
+ * ```javascript
+ * // This example enables scale-in protection for a task for 60 minutes.
+ * const input = {
+ *   "cluster": "test-task-protection",
+ *   "expiresInMinutes": 60,
+ *   "protectionEnabled": true,
+ *   "tasks": [
+ *     "b8b1cf532d0e46ba8d44a40d1de16772"
+ *   ]
+ * };
+ * const command = new UpdateTaskProtectionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "failures": [],
+ *   "protectedTasks": [
+ *     {
+ *       "expirationDate": "2022-11-02T06:56:32.553Z",
+ *       "protectionEnabled": true,
+ *       "taskArn": "arn:aws:ecs:us-west-2:012345678910:task/b8b1cf532d0e46ba8d44a40d1de16772"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: enable-the-protection-status-for-a-single-task-for-60-minutes-2022-11-02T06:56:32.553Z
+ * ```
+ *
+ * @example To set task scale-in protection for the default time period in minutes
+ * ```javascript
+ * // This example enables task scale-in protection for a task, without specifying the expiresInMinutes parameter, for the default protection period of 120 minutes.
+ * const input = {
+ *   "cluster": "test-task-protection",
+ *   "protectionEnabled": true,
+ *   "tasks": [
+ *     "b8b1cf532d0e46ba8d44a40d1de16772"
+ *   ]
+ * };
+ * const command = new UpdateTaskProtectionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "failures": [],
+ *   "protectedTasks": [
+ *     {
+ *       "expirationDate": "2022-11-02T06:56:32.553Z",
+ *       "protectionEnabled": true,
+ *       "taskArn": "arn:aws:ecs:us-west-2:012345678910:task/b8b1cf532d0e46ba8d44a40d1de16772"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: enable-the-protection-status-for-a-single-task-with-default-expiresinminutes-2022-11-02T06:56:32.553Z
+ * ```
+ *
+ * @example To remove task scale-in protection
+ * ```javascript
+ * // This example removes scale-in protection for a task.
+ * const input = {
+ *   "cluster": "test-task-protection",
+ *   "protectionEnabled": false,
+ *   "tasks": [
+ *     "b8b1cf532d0e46ba8d44a40d1de16772"
+ *   ]
+ * };
+ * const command = new UpdateTaskProtectionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "failures": [],
+ *   "protectedTasks": [
+ *     {
+ *       "protectionEnabled": false,
+ *       "taskArn": "arn:aws:ecs:us-west-2:012345678910:task/b8b1cf532d0e46ba8d44a40d1de16772"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: disable-scale-in-protection-on-a-single-task
+ * ```
+ *
  */
 export declare class UpdateTaskProtectionCommand extends $Command<UpdateTaskProtectionCommandInput, UpdateTaskProtectionCommandOutput, ECSClientResolvedConfig> {
     readonly input: UpdateTaskProtectionCommandInput;