@aws-sdk/client-ecs 3.288.0 → 3.290.0

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

@@ -29,6 +29,44 @@ export interface DescribeClustersCommandOutput extends DescribeClustersResponse,
  * @see {@link DescribeClustersCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ *
+ * @example To describe a cluster
+ * ```javascript
+ * // This example provides a description of the specified cluster in your default region.
+ * const input = {
+ *   "clusters": [
+ *     "default"
+ *   ]
+ * };
+ * const command = new DescribeClustersCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "clusters": [
+ *     {
+ *       "clusterArn": "arn:aws:ecs:us-east-1:aws_account_id:cluster/default",
+ *       "clusterName": "default",
+ *       "status": "ACTIVE"
+ *     }
+ *   ],
+ *   "failures": []
+ * }
+ * *\/
+ * // example id: ba88d100-9672-4231-80da-a4bd210bf728
+ * ```
+ *
  */
 export declare class DescribeClustersCommand extends $Command<DescribeClustersCommandInput, DescribeClustersCommandOutput, ECSClientResolvedConfig> {
     readonly input: DescribeClustersCommandInput;

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

@@ -30,6 +30,110 @@ export interface DescribeContainerInstancesCommandOutput extends DescribeContain
  * @see {@link DescribeContainerInstancesCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link ClusterNotFoundException} (client fault)
+ *  <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ *
+ * @example To describe container instance
+ * ```javascript
+ * // This example provides a description of the specified container instance in your default region, using the container instance UUID as an identifier.
+ * const input = {
+ *   "cluster": "default",
+ *   "containerInstances": [
+ *     "f2756532-8f13-4d53-87c9-aed50dc94cd7"
+ *   ]
+ * };
+ * const command = new DescribeContainerInstancesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "containerInstances": [
+ *     {
+ *       "agentConnected": true,
+ *       "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/f2756532-8f13-4d53-87c9-aed50dc94cd7",
+ *       "ec2InstanceId": "i-807f3249",
+ *       "pendingTasksCount": 0,
+ *       "registeredResources": [
+ *         {
+ *           "name": "CPU",
+ *           "type": "INTEGER",
+ *           "doubleValue": 0,
+ *           "integerValue": 2048,
+ *           "longValue": 0
+ *         },
+ *         {
+ *           "name": "MEMORY",
+ *           "type": "INTEGER",
+ *           "doubleValue": 0,
+ *           "integerValue": 3768,
+ *           "longValue": 0
+ *         },
+ *         {
+ *           "name": "PORTS",
+ *           "type": "STRINGSET",
+ *           "doubleValue": 0,
+ *           "integerValue": 0,
+ *           "longValue": 0,
+ *           "stringSetValue": [
+ *             "2376",
+ *             "22",
+ *             "51678",
+ *             "2375"
+ *           ]
+ *         }
+ *       ],
+ *       "remainingResources": [
+ *         {
+ *           "name": "CPU",
+ *           "type": "INTEGER",
+ *           "doubleValue": 0,
+ *           "integerValue": 1948,
+ *           "longValue": 0
+ *         },
+ *         {
+ *           "name": "MEMORY",
+ *           "type": "INTEGER",
+ *           "doubleValue": 0,
+ *           "integerValue": 3668,
+ *           "longValue": 0
+ *         },
+ *         {
+ *           "name": "PORTS",
+ *           "type": "STRINGSET",
+ *           "doubleValue": 0,
+ *           "integerValue": 0,
+ *           "longValue": 0,
+ *           "stringSetValue": [
+ *             "2376",
+ *             "22",
+ *             "80",
+ *             "51678",
+ *             "2375"
+ *           ]
+ *         }
+ *       ],
+ *       "runningTasksCount": 1,
+ *       "status": "ACTIVE"
+ *     }
+ *   ],
+ *   "failures": []
+ * }
+ * *\/
+ * // example id: c8f439de-eb27-4269-8ca7-2c0a7ba75ab0
+ * ```
+ *
  */
 export declare class DescribeContainerInstancesCommand extends $Command<DescribeContainerInstancesCommandInput, DescribeContainerInstancesCommandOutput, ECSClientResolvedConfig> {
     readonly input: DescribeContainerInstancesCommandInput;

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

@@ -29,6 +29,77 @@ export interface DescribeServicesCommandOutput extends DescribeServicesResponse,
  * @see {@link DescribeServicesCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link ClusterNotFoundException} (client fault)
+ *  <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ *
+ * @example To describe a service
+ * ```javascript
+ * // This example provides descriptive information about the service named ``ecs-simple-service``.
+ * const input = {
+ *   "services": [
+ *     "ecs-simple-service"
+ *   ]
+ * };
+ * const command = new DescribeServicesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "failures": [],
+ *   "services": [
+ *     {
+ *       "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default",
+ *       "createdAt": "2016-08-29T16:25:52.130Z",
+ *       "deploymentConfiguration": {
+ *         "maximumPercent": 200,
+ *         "minimumHealthyPercent": 100
+ *       },
+ *       "deployments": [
+ *         {
+ *           "createdAt": "2016-08-29T16:25:52.130Z",
+ *           "desiredCount": 1,
+ *           "id": "ecs-svc/9223370564341623665",
+ *           "pendingCount": 0,
+ *           "runningCount": 0,
+ *           "status": "PRIMARY",
+ *           "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6",
+ *           "updatedAt": "2016-08-29T16:25:52.130Z"
+ *         }
+ *       ],
+ *       "desiredCount": 1,
+ *       "events": [
+ *         {
+ *           "createdAt": "2016-08-29T16:25:58.520Z",
+ *           "id": "38c285e5-d335-4b68-8b15-e46dedc8e88d",
+ *           "message": "(service ecs-simple-service) was unable to place a task because no container instance met all of its requirements. The closest matching (container-instance 3f4de1c5-ffdd-4954-af7e-75b4be0c8841) is already using a port required by your task. For more information, see the Troubleshooting section of the Amazon ECS Developer Guide."
+ *         }
+ *       ],
+ *       "loadBalancers": [],
+ *       "pendingCount": 0,
+ *       "runningCount": 0,
+ *       "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service",
+ *       "serviceName": "ecs-simple-service",
+ *       "status": "ACTIVE",
+ *       "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-a-service-1472513256350
+ * ```
+ *
  */
 export declare class DescribeServicesCommand extends $Command<DescribeServicesCommandInput, DescribeServicesCommandOutput, ECSClientResolvedConfig> {
     readonly input: DescribeServicesCommandInput;

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

@@ -36,6 +36,77 @@ export interface DescribeTaskDefinitionCommandOutput extends DescribeTaskDefinit
  * @see {@link DescribeTaskDefinitionCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ *
+ * @example To describe a task definition
+ * ```javascript
+ * // This example provides a description of the specified task definition.
+ * const input = {
+ *   "taskDefinition": "hello_world:8"
+ * };
+ * const command = new DescribeTaskDefinitionCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "taskDefinition": {
+ *     "containerDefinitions": [
+ *       {
+ *         "name": "wordpress",
+ *         "cpu": 10,
+ *         "environment": [],
+ *         "essential": true,
+ *         "image": "wordpress",
+ *         "links": [
+ *           "mysql"
+ *         ],
+ *         "memory": 500,
+ *         "mountPoints": [],
+ *         "portMappings": [
+ *           {
+ *             "containerPort": 80,
+ *             "hostPort": 80
+ *           }
+ *         ],
+ *         "volumesFrom": []
+ *       },
+ *       {
+ *         "name": "mysql",
+ *         "cpu": 10,
+ *         "environment": [
+ *           {
+ *             "name": "MYSQL_ROOT_PASSWORD",
+ *             "value": "password"
+ *           }
+ *         ],
+ *         "essential": true,
+ *         "image": "mysql",
+ *         "memory": 500,
+ *         "mountPoints": [],
+ *         "portMappings": [],
+ *         "volumesFrom": []
+ *       }
+ *     ],
+ *     "family": "hello_world",
+ *     "revision": 8,
+ *     "taskDefinitionArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/hello_world:8",
+ *     "volumes": []
+ *   }
+ * }
+ * *\/
+ * // example id: 4c21eeb1-f1da-4a08-8c44-297fc8d0ea88
+ * ```
+ *
  */
 export declare class DescribeTaskDefinitionCommand extends $Command<DescribeTaskDefinitionCommandInput, DescribeTaskDefinitionCommandOutput, ECSClientResolvedConfig> {
     readonly input: DescribeTaskDefinitionCommandInput;

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

@@ -32,6 +32,36 @@ export interface DescribeTaskSetsCommandOutput extends DescribeTaskSetsResponse,
  * @see {@link DescribeTaskSetsCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have authorization to perform the requested action.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link ClusterNotFoundException} (client fault)
+ *  <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ * @throws {@link ServiceNotActiveException} (client fault)
+ *  <p>The specified service isn't active. You can't update a service that's inactive. If you
+ * 			have previously deleted a service, you can re-create it with <a>CreateService</a>.</p>
+ *
+ * @throws {@link ServiceNotFoundException} (client fault)
+ *  <p>The specified service wasn't found. You can view your available services with <a>ListServices</a>. Amazon ECS services are cluster specific and Region
+ * 			specific.</p>
+ *
+ * @throws {@link UnsupportedFeatureException} (client fault)
+ *  <p>The specified task isn't supported in this Region.</p>
+ *
+ *
  */
 export declare class DescribeTaskSetsCommand extends $Command<DescribeTaskSetsCommandInput, DescribeTaskSetsCommandOutput, ECSClientResolvedConfig> {
     readonly input: DescribeTaskSetsCommandInput;

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

@@ -30,6 +30,73 @@ export interface DescribeTasksCommandOutput extends DescribeTasksResponse, __Met
  * @see {@link DescribeTasksCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link ClusterNotFoundException} (client fault)
+ *  <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ *
+ * @example To describe a task
+ * ```javascript
+ * // This example provides a description of the specified task, using the task UUID as an identifier.
+ * const input = {
+ *   "tasks": [
+ *     "c5cba4eb-5dad-405e-96db-71ef8eefe6a8"
+ *   ]
+ * };
+ * const command = new DescribeTasksCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "failures": [],
+ *   "tasks": [
+ *     {
+ *       "clusterArn": "arn:aws:ecs:<region>:<aws_account_id>:cluster/default",
+ *       "containerInstanceArn": "arn:aws:ecs:<region>:<aws_account_id>:container-instance/18f9eda5-27d7-4c19-b133-45adc516e8fb",
+ *       "containers": [
+ *         {
+ *           "name": "ecs-demo",
+ *           "containerArn": "arn:aws:ecs:<region>:<aws_account_id>:container/7c01765b-c588-45b3-8290-4ba38bd6c5a6",
+ *           "lastStatus": "RUNNING",
+ *           "networkBindings": [
+ *             {
+ *               "bindIP": "0.0.0.0",
+ *               "containerPort": 80,
+ *               "hostPort": 80
+ *             }
+ *           ],
+ *           "taskArn": "arn:aws:ecs:<region>:<aws_account_id>:task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8"
+ *         }
+ *       ],
+ *       "desiredStatus": "RUNNING",
+ *       "lastStatus": "RUNNING",
+ *       "overrides": {
+ *         "containerOverrides": [
+ *           {
+ *             "name": "ecs-demo"
+ *           }
+ *         ]
+ *       },
+ *       "startedBy": "ecs-svc/9223370608528463088",
+ *       "taskArn": "arn:aws:ecs:<region>:<aws_account_id>:task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8",
+ *       "taskDefinitionArn": "arn:aws:ecs:<region>:<aws_account_id>:task-definition/amazon-ecs-sample:1"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: a90b0cde-f965-4946-b55e-cfd8cc54e827
+ * ```
+ *
  */
 export declare class DescribeTasksCommand extends $Command<DescribeTasksCommandInput, DescribeTasksCommandOutput, ECSClientResolvedConfig> {
     readonly input: DescribeTasksCommandInput;

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

@@ -32,6 +32,15 @@ export interface DiscoverPollEndpointCommandOutput extends DiscoverPollEndpointR
  * @see {@link DiscoverPollEndpointCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ *
  */
 export declare class DiscoverPollEndpointCommand extends $Command<DiscoverPollEndpointCommandInput, DiscoverPollEndpointCommandOutput, ECSClientResolvedConfig> {
     readonly input: DiscoverPollEndpointCommandInput;

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

@@ -35,6 +35,43 @@ export interface ExecuteCommandCommandOutput extends ExecuteCommandResponse, __M
  * @see {@link ExecuteCommandCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have authorization to perform the requested action.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link ClusterNotFoundException} (client fault)
+ *  <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ * @throws {@link TargetNotConnectedException} (client fault)
+ *  <p>The execute command cannot run. This error can be caused by any of the following
+ * 			configuration issues:</p>
+ *          <ul>
+ *             <li>
+ *                <p>Incorrect IAM permissions</p>
+ *             </li>
+ *             <li>
+ *                <p>The SSM agent is not installed or is not running</p>
+ *             </li>
+ *             <li>
+ *                <p> There is an interface Amazon VPC endpoint for Amazon ECS, but there is not one for
+ * 					for Systems Manager Session Manager</p>
+ *             </li>
+ *          </ul>
+ *          <p>For information about how to troubleshoot the issues, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html">Troubleshooting issues with ECS
+ * 				Exec</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
+ *
+ *
  */
 export declare class ExecuteCommandCommand extends $Command<ExecuteCommandCommandInput, ExecuteCommandCommandOutput, ECSClientResolvedConfig> {
     readonly input: ExecuteCommandCommandInput;

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

@@ -29,6 +29,57 @@ export interface GetTaskProtectionCommandOutput extends GetTaskProtectionRespons
  * @see {@link GetTaskProtectionCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have authorization to perform the requested action.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link ClusterNotFoundException} (client fault)
+ *  <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource wasn't found.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ * @throws {@link UnsupportedFeatureException} (client fault)
+ *  <p>The specified task isn't supported in this Region.</p>
+ *
+ *
+ * @example To get the protection status of a task
+ * ```javascript
+ * // In this example, we get the protection status for a single task.
+ * const input = {
+ *   "cluster": "test-task-protection",
+ *   "tasks": [
+ *     "b8b1cf532d0e46ba8d44a40d1de16772"
+ *   ]
+ * };
+ * const command = new GetTaskProtectionCommand(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: get-the-protection-status-for-a-single-task-2022-11-02T06:56:32.553Z
+ * ```
+ *
  */
 export declare class GetTaskProtectionCommand extends $Command<GetTaskProtectionCommandInput, GetTaskProtectionCommandOutput, ECSClientResolvedConfig> {
     readonly input: GetTaskProtectionCommandInput;

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

@@ -29,6 +29,84 @@ export interface ListAccountSettingsCommandOutput extends ListAccountSettingsRes
  * @see {@link ListAccountSettingsCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using
+ * 			an action or resource on behalf of a user that doesn't have permissions to use the
+ * 			action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ *
+ * @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/ListAttributesCommand.d.ts

@@ -35,6 +35,14 @@ export interface ListAttributesCommandOutput extends ListAttributesResponse, __M
  * @see {@link ListAttributesCommandOutput} for command's `response` shape.
  * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
  *
+ * @throws {@link ClusterNotFoundException} (client fault)
+ *  <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API
+ * 			request.</p>
+ *
+ *
  */
 export declare class ListAttributesCommand extends $Command<ListAttributesCommandInput, ListAttributesCommandOutput, ECSClientResolvedConfig> {
     readonly input: ListAttributesCommandInput;