@aws-sdk/client-ecs 3.51.0 → 3.54.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.
@@ -1,11 +1,15 @@
1
- import { MetadataBearer as $MetadataBearer, SmithyException as __SmithyException } from "@aws-sdk/types";
1
+ import { ExceptionOptionType as __ExceptionOptionType } from "@aws-sdk/smithy-client";
2
+ import { ECSServiceException as __BaseException } from "./ECSServiceException";
2
3
  /**
3
4
  * <p>You don't have authorization to perform the requested action.</p>
4
5
  */
5
- export interface AccessDeniedException extends __SmithyException, $MetadataBearer {
6
- name: "AccessDeniedException";
7
- $fault: "client";
8
- message?: string;
6
+ export declare class AccessDeniedException extends __BaseException {
7
+ readonly name: "AccessDeniedException";
8
+ readonly $fault: "client";
9
+ /**
10
+ * @internal
11
+ */
12
+ constructor(opts: __ExceptionOptionType<AccessDeniedException, __BaseException>);
9
13
  }
10
14
  export declare enum AgentUpdateStatus {
11
15
  FAILED = "FAILED",
@@ -20,10 +24,13 @@ export declare enum AgentUpdateStatus {
20
24
  * an action or resource on behalf of a user that doesn't have permissions to use the
21
25
  * action or resource,. Or, it might be specifying an identifier that isn't valid.</p>
22
26
  */
23
- export interface ClientException extends __SmithyException, $MetadataBearer {
24
- name: "ClientException";
25
- $fault: "client";
26
- message?: string;
27
+ export declare class ClientException extends __BaseException {
28
+ readonly name: "ClientException";
29
+ readonly $fault: "client";
30
+ /**
31
+ * @internal
32
+ */
33
+ constructor(opts: __ExceptionOptionType<ClientException, __BaseException>);
27
34
  }
28
35
  export declare enum ManagedScalingStatus {
29
36
  DISABLED = "DISABLED",
@@ -40,7 +47,7 @@ export declare enum ManagedScalingStatus {
40
47
  */
41
48
  export interface ManagedScaling {
42
49
  /**
43
- * <p>Determines whether to enable managed scaling for the capacity provider.</p>
50
+ * <p>Determines whether to use managed scaling for the capacity provider.</p>
44
51
  */
45
52
  status?: ManagedScalingStatus | string;
46
53
  /**
@@ -341,26 +348,35 @@ export declare namespace CreateCapacityProviderResponse {
341
348
  * <p>The specified parameter isn't valid. Review the available parameters for the API
342
349
  * request.</p>
343
350
  */
344
- export interface InvalidParameterException extends __SmithyException, $MetadataBearer {
345
- name: "InvalidParameterException";
346
- $fault: "client";
347
- message?: string;
351
+ export declare class InvalidParameterException extends __BaseException {
352
+ readonly name: "InvalidParameterException";
353
+ readonly $fault: "client";
354
+ /**
355
+ * @internal
356
+ */
357
+ constructor(opts: __ExceptionOptionType<InvalidParameterException, __BaseException>);
348
358
  }
349
359
  /**
350
360
  * <p>The limit for the resource was exceeded.</p>
351
361
  */
352
- export interface LimitExceededException extends __SmithyException, $MetadataBearer {
353
- name: "LimitExceededException";
354
- $fault: "client";
355
- message?: string;
362
+ export declare class LimitExceededException extends __BaseException {
363
+ readonly name: "LimitExceededException";
364
+ readonly $fault: "client";
365
+ /**
366
+ * @internal
367
+ */
368
+ constructor(opts: __ExceptionOptionType<LimitExceededException, __BaseException>);
356
369
  }
357
370
  /**
358
371
  * <p>These errors are usually caused by a server issue.</p>
359
372
  */
360
- export interface ServerException extends __SmithyException, $MetadataBearer {
361
- name: "ServerException";
362
- $fault: "server";
363
- message?: string;
373
+ export declare class ServerException extends __BaseException {
374
+ readonly name: "ServerException";
375
+ readonly $fault: "server";
376
+ /**
377
+ * @internal
378
+ */
379
+ constructor(opts: __ExceptionOptionType<ServerException, __BaseException>);
364
380
  }
365
381
  /**
366
382
  * <p>There's already a current Amazon ECS container agent update in progress on the container
@@ -369,10 +385,13 @@ export interface ServerException extends __SmithyException, $MetadataBearer {
369
385
  * process can get stuck in that state. However, when the agent reconnects, it resumes
370
386
  * where it stopped previously.</p>
371
387
  */
372
- export interface UpdateInProgressException extends __SmithyException, $MetadataBearer {
373
- name: "UpdateInProgressException";
374
- $fault: "client";
375
- message?: string;
388
+ export declare class UpdateInProgressException extends __BaseException {
389
+ readonly name: "UpdateInProgressException";
390
+ readonly $fault: "client";
391
+ /**
392
+ * @internal
393
+ */
394
+ constructor(opts: __ExceptionOptionType<UpdateInProgressException, __BaseException>);
376
395
  }
377
396
  /**
378
397
  * <p>The log configuration for the results of the execute command actions. The logs can be
@@ -387,7 +406,7 @@ export interface ExecuteCommandLogConfiguration {
387
406
  */
388
407
  cloudWatchLogGroupName?: string;
389
408
  /**
390
- * <p>Determines whether to enable encryption on the CloudWatch logs. If not specified,
409
+ * <p>Determines whether to use encryption on the CloudWatch logs. If not specified,
391
410
  * encryption will be disabled.</p>
392
411
  */
393
412
  cloudWatchEncryptionEnabled?: boolean;
@@ -542,7 +561,7 @@ export declare enum ClusterSettingName {
542
561
  CONTAINER_INSIGHTS = "containerInsights"
543
562
  }
544
563
  /**
545
- * <p>The settings to use when creating a cluster. This parameter is used to enable CloudWatch
564
+ * <p>The settings to use when creating a cluster. This parameter is used to turn on CloudWatch
546
565
  * Container Insights for a cluster.</p>
547
566
  */
548
567
  export interface ClusterSetting {
@@ -610,7 +629,7 @@ export interface CreateClusterRequest {
610
629
  */
611
630
  tags?: Tag[];
612
631
  /**
613
- * <p>The setting to use when creating a cluster. This parameter is used to enable CloudWatch
632
+ * <p>The setting to use when creating a cluster. This parameter is used to turn on CloudWatch
614
633
  * Container Insights for a cluster. If this value is specified, it overrides the
615
634
  * <code>containerInsights</code> value set with <a>PutAccountSetting</a> or
616
635
  * <a>PutAccountSettingDefault</a>.</p>
@@ -908,10 +927,13 @@ export declare namespace CreateClusterResponse {
908
927
  /**
909
928
  * <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
910
929
  */
911
- export interface ClusterNotFoundException extends __SmithyException, $MetadataBearer {
912
- name: "ClusterNotFoundException";
913
- $fault: "client";
914
- message?: string;
930
+ export declare class ClusterNotFoundException extends __BaseException {
931
+ readonly name: "ClusterNotFoundException";
932
+ readonly $fault: "client";
933
+ /**
934
+ * @internal
935
+ */
936
+ constructor(opts: __ExceptionOptionType<ClusterNotFoundException, __BaseException>);
915
937
  }
916
938
  /**
917
939
  * <note>
@@ -921,18 +943,18 @@ export interface ClusterNotFoundException extends __SmithyException, $MetadataBe
921
943
  * <p>The <b>deployment circuit breaker</b> determines whether a
922
944
  * service deployment will fail if the service can't reach a steady state. If enabled, a
923
945
  * service deployment will transition to a failed state and stop launching new tasks. You
924
- * can also enable Amazon ECS to roll back your service to the last completed deployment after a
946
+ * can also configure Amazon ECS to roll back your service to the last completed deployment after a
925
947
  * failure. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html">Rolling
926
948
  * update</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
927
949
  */
928
950
  export interface DeploymentCircuitBreaker {
929
951
  /**
930
- * <p>Determines whether to enable the deployment circuit breaker logic for the
952
+ * <p>Determines whether to use the deployment circuit breaker logic for the
931
953
  * service.</p>
932
954
  */
933
955
  enable: boolean | undefined;
934
956
  /**
935
- * <p>Determines whether to enable Amazon ECS to roll back the service if a service deployment
957
+ * <p>Determines whether to configure Amazon ECS to roll back the service if a service deployment
936
958
  * fails. If rollback is enabled, when a service deployment fails, the service is rolled
937
959
  * back to the last deployment that completed successfully.</p>
938
960
  */
@@ -1067,6 +1089,14 @@ export declare enum LaunchType {
1067
1089
  * <p>The load balancer configuration to use with a service or task set.</p>
1068
1090
  * <p>For specific notes and restrictions regarding the use of load balancers with services
1069
1091
  * and task sets, see the CreateService and CreateTaskSet actions.</p>
1092
+ * <p>When you add, update, or remove a load blaancer configuration, Amazon ECS starts a new
1093
+ * deployment with the updated Elastic Load Balancing configuration. This causes tasks to register to and
1094
+ * deregister from load balancers.</p>
1095
+ * <p>We recommend that you verify this on a test environment before you update the Elastic Load Balancing
1096
+ * configuration. </p>
1097
+ * <p>A service-linked role is required for services that use multiple target groups. For
1098
+ * more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html">Service-linked
1099
+ * roles</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
1070
1100
  */
1071
1101
  export interface LoadBalancer {
1072
1102
  /**
@@ -1247,6 +1277,7 @@ export declare namespace PlacementStrategy {
1247
1277
  const filterSensitiveLog: (obj: PlacementStrategy) => any;
1248
1278
  }
1249
1279
  export declare enum PropagateTags {
1280
+ NONE = "NONE",
1250
1281
  SERVICE = "SERVICE",
1251
1282
  TASK_DEFINITION = "TASK_DEFINITION"
1252
1283
  }
@@ -1256,6 +1287,11 @@ export declare enum SchedulingStrategy {
1256
1287
  }
1257
1288
  /**
1258
1289
  * <p>The details for the service registry.</p>
1290
+ * <p>Each service may be associated with one service registry. Multiple service registries for
1291
+ * each service are not supported.</p>
1292
+ * <p>When you add, update, or remove the service registries configuration, Amazon ECS starts a
1293
+ * new deployment. New tasks are registered and deregistered to the updated service
1294
+ * registry configuration.</p>
1259
1295
  */
1260
1296
  export interface ServiceRegistry {
1261
1297
  /**
@@ -1336,10 +1372,8 @@ export interface CreateServiceRequest {
1336
1372
  * also have up to two listeners: a required listener for production traffic and an
1337
1373
  * optional listener that you can use to perform validation tests with Lambda functions
1338
1374
  * before routing production traffic to it.</p>
1339
- * <p>After you create a service using the <code>ECS</code> deployment controller, the load
1340
- * balancer name or target group ARN, container name, and container port that's specified
1341
- * in the service definition are immutable. If you use the <code>CODE_DEPLOY</code>
1342
- * deployment controller, these values can be changed when updating the service.</p>
1375
+ * <p>If you use the <code>CODE_DEPLOY</code> deployment controller, these values can be changed
1376
+ * when updating the service.</p>
1343
1377
  * <p>For Application Load Balancers and Network Load Balancers, this object must contain the load balancer target group ARN,
1344
1378
  * the container name, and the container port to access from the load balancer. The
1345
1379
  * container name must be as it appears in a container definition. The load balancer name
@@ -1471,6 +1505,7 @@ export interface CreateServiceRequest {
1471
1505
  * service is configured to use a load balancer. If your service has a load balancer
1472
1506
  * defined and you don't specify a health check grace period value, the default value of
1473
1507
  * <code>0</code> is used.</p>
1508
+ * <p>If you do not use an Elastic Load Balancing, we recomend that you use the <code>startPeriod</code> in the task definition healtch check parameters. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html">Health check</a>.</p>
1474
1509
  * <p>If your service's tasks take a while to start and respond to Elastic Load Balancing health checks, you
1475
1510
  * can specify a health check grace period of up to
1476
1511
  * 2,147,483,647
@@ -1554,7 +1589,7 @@ export interface CreateServiceRequest {
1554
1589
  */
1555
1590
  tags?: Tag[];
1556
1591
  /**
1557
- * <p>Specifies whether to enable Amazon ECS managed tags for the tasks within the service. For
1592
+ * <p>Specifies whether to turn on Amazon ECS managed tags for the tasks within the service. For
1558
1593
  * more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html">Tagging Your Amazon ECS
1559
1594
  * Resources</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
1560
1595
  */
@@ -2100,13 +2135,11 @@ export interface Service {
2100
2135
  * </li>
2101
2136
  * <li>
2102
2137
  * <p>
2103
- * <code>DAEMON</code>-The daemon scheduling strategy deploys exactly one
2104
- * task on each active container
2105
- * instance.
2106
- * This taskmeets all of the task placement constraints that you
2107
- * specify in your cluster. The service scheduler also evaluates the task placement
2108
- * constraints for running tasks. It stop tasks that don't meet the placement
2109
- * constraints.</p>
2138
+ * <code>DAEMON</code>-The daemon scheduling strategy deploys exactly one task on each
2139
+ * active container instance. This task meets all of the task placement constraints
2140
+ * that you specify in your cluster. The service scheduler also evaluates the task
2141
+ * placement constraints for running tasks. It stop tasks that don't meet the
2142
+ * placement constraints.</p>
2110
2143
  * <note>
2111
2144
  * <p>Fargate tasks don't support the <code>DAEMON</code>
2112
2145
  * scheduling strategy.</p>
@@ -2163,7 +2196,7 @@ export interface Service {
2163
2196
  */
2164
2197
  createdBy?: string;
2165
2198
  /**
2166
- * <p>Determines whether to enable Amazon ECS managed tags for the tasks in the service. For more
2199
+ * <p>Determines whether to use Amazon ECS managed tags for the tasks in the service. For more
2167
2200
  * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html">Tagging Your Amazon ECS
2168
2201
  * Resources</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
2169
2202
  */
@@ -2212,26 +2245,35 @@ export declare namespace CreateServiceResponse {
2212
2245
  * <p>The specified platform version doesn't satisfy the required capabilities of the task
2213
2246
  * definition.</p>
2214
2247
  */
2215
- export interface PlatformTaskDefinitionIncompatibilityException extends __SmithyException, $MetadataBearer {
2216
- name: "PlatformTaskDefinitionIncompatibilityException";
2217
- $fault: "client";
2218
- message?: string;
2248
+ export declare class PlatformTaskDefinitionIncompatibilityException extends __BaseException {
2249
+ readonly name: "PlatformTaskDefinitionIncompatibilityException";
2250
+ readonly $fault: "client";
2251
+ /**
2252
+ * @internal
2253
+ */
2254
+ constructor(opts: __ExceptionOptionType<PlatformTaskDefinitionIncompatibilityException, __BaseException>);
2219
2255
  }
2220
2256
  /**
2221
2257
  * <p>The specified platform version doesn't exist.</p>
2222
2258
  */
2223
- export interface PlatformUnknownException extends __SmithyException, $MetadataBearer {
2224
- name: "PlatformUnknownException";
2225
- $fault: "client";
2226
- message?: string;
2259
+ export declare class PlatformUnknownException extends __BaseException {
2260
+ readonly name: "PlatformUnknownException";
2261
+ readonly $fault: "client";
2262
+ /**
2263
+ * @internal
2264
+ */
2265
+ constructor(opts: __ExceptionOptionType<PlatformUnknownException, __BaseException>);
2227
2266
  }
2228
2267
  /**
2229
2268
  * <p>The specified task isn't supported in this Region.</p>
2230
2269
  */
2231
- export interface UnsupportedFeatureException extends __SmithyException, $MetadataBearer {
2232
- name: "UnsupportedFeatureException";
2233
- $fault: "client";
2234
- message?: string;
2270
+ export declare class UnsupportedFeatureException extends __BaseException {
2271
+ readonly name: "UnsupportedFeatureException";
2272
+ readonly $fault: "client";
2273
+ /**
2274
+ * @internal
2275
+ */
2276
+ constructor(opts: __ExceptionOptionType<UnsupportedFeatureException, __BaseException>);
2235
2277
  }
2236
2278
  export interface CreateTaskSetRequest {
2237
2279
  /**
@@ -2377,19 +2419,25 @@ export declare namespace CreateTaskSetResponse {
2377
2419
  * <p>The specified service isn't active. You can't update a service that's inactive. If you
2378
2420
  * have previously deleted a service, you can re-create it with <a>CreateService</a>.</p>
2379
2421
  */
2380
- export interface ServiceNotActiveException extends __SmithyException, $MetadataBearer {
2381
- name: "ServiceNotActiveException";
2382
- $fault: "client";
2383
- message?: string;
2422
+ export declare class ServiceNotActiveException extends __BaseException {
2423
+ readonly name: "ServiceNotActiveException";
2424
+ readonly $fault: "client";
2425
+ /**
2426
+ * @internal
2427
+ */
2428
+ constructor(opts: __ExceptionOptionType<ServiceNotActiveException, __BaseException>);
2384
2429
  }
2385
2430
  /**
2386
2431
  * <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
2387
2432
  * specific.</p>
2388
2433
  */
2389
- export interface ServiceNotFoundException extends __SmithyException, $MetadataBearer {
2390
- name: "ServiceNotFoundException";
2391
- $fault: "client";
2392
- message?: string;
2434
+ export declare class ServiceNotFoundException extends __BaseException {
2435
+ readonly name: "ServiceNotFoundException";
2436
+ readonly $fault: "client";
2437
+ /**
2438
+ * @internal
2439
+ */
2440
+ constructor(opts: __ExceptionOptionType<ServiceNotFoundException, __BaseException>);
2393
2441
  }
2394
2442
  export declare enum SettingName {
2395
2443
  AWSVPC_TRUNKING = "awsvpcTrunking",
@@ -2465,8 +2513,8 @@ export declare enum TargetType {
2465
2513
  CONTAINER_INSTANCE = "container-instance"
2466
2514
  }
2467
2515
  /**
2468
- * <p>An attribute is a name-value pair that's associated with an Amazon ECS object. Attributes
2469
- * enable you to extend the Amazon ECS data model by adding custom metadata to your resources.
2516
+ * <p>An attribute is a name-value pair that's associated with an Amazon ECS object. Use attributes
2517
+ * to extend the Amazon ECS data model by adding custom metadata to your resources.
2470
2518
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html#attributes">Attributes</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
2471
2519
  */
2472
2520
  export interface Attribute {
@@ -2537,10 +2585,13 @@ export declare namespace DeleteAttributesResponse {
2537
2585
  * with <a>ListContainerInstances</a>. Amazon ECS container instances are
2538
2586
  * cluster-specific and Region-specific.</p>
2539
2587
  */
2540
- export interface TargetNotFoundException extends __SmithyException, $MetadataBearer {
2541
- name: "TargetNotFoundException";
2542
- $fault: "client";
2543
- message?: string;
2588
+ export declare class TargetNotFoundException extends __BaseException {
2589
+ readonly name: "TargetNotFoundException";
2590
+ readonly $fault: "client";
2591
+ /**
2592
+ * @internal
2593
+ */
2594
+ constructor(opts: __ExceptionOptionType<TargetNotFoundException, __BaseException>);
2544
2595
  }
2545
2596
  export interface DeleteCapacityProviderRequest {
2546
2597
  /**
@@ -2571,28 +2622,37 @@ export declare namespace DeleteCapacityProviderResponse {
2571
2622
  * the container instances before you can delete the cluster. For more information, see
2572
2623
  * <a>DeregisterContainerInstance</a>.</p>
2573
2624
  */
2574
- export interface ClusterContainsContainerInstancesException extends __SmithyException, $MetadataBearer {
2575
- name: "ClusterContainsContainerInstancesException";
2576
- $fault: "client";
2577
- message?: string;
2625
+ export declare class ClusterContainsContainerInstancesException extends __BaseException {
2626
+ readonly name: "ClusterContainsContainerInstancesException";
2627
+ readonly $fault: "client";
2628
+ /**
2629
+ * @internal
2630
+ */
2631
+ constructor(opts: __ExceptionOptionType<ClusterContainsContainerInstancesException, __BaseException>);
2578
2632
  }
2579
2633
  /**
2580
2634
  * <p>You can't delete a cluster that contains services. First, update the service to reduce
2581
2635
  * its desired task count to 0, and then delete the service. For more information, see
2582
2636
  * <a>UpdateService</a> and <a>DeleteService</a>.</p>
2583
2637
  */
2584
- export interface ClusterContainsServicesException extends __SmithyException, $MetadataBearer {
2585
- name: "ClusterContainsServicesException";
2586
- $fault: "client";
2587
- message?: string;
2638
+ export declare class ClusterContainsServicesException extends __BaseException {
2639
+ readonly name: "ClusterContainsServicesException";
2640
+ readonly $fault: "client";
2641
+ /**
2642
+ * @internal
2643
+ */
2644
+ constructor(opts: __ExceptionOptionType<ClusterContainsServicesException, __BaseException>);
2588
2645
  }
2589
2646
  /**
2590
2647
  * <p>You can't delete a cluster that has active tasks.</p>
2591
2648
  */
2592
- export interface ClusterContainsTasksException extends __SmithyException, $MetadataBearer {
2593
- name: "ClusterContainsTasksException";
2594
- $fault: "client";
2595
- message?: string;
2649
+ export declare class ClusterContainsTasksException extends __BaseException {
2650
+ readonly name: "ClusterContainsTasksException";
2651
+ readonly $fault: "client";
2652
+ /**
2653
+ * @internal
2654
+ */
2655
+ constructor(opts: __ExceptionOptionType<ClusterContainsTasksException, __BaseException>);
2596
2656
  }
2597
2657
  export interface DeleteClusterRequest {
2598
2658
  /**
@@ -2696,10 +2756,13 @@ export declare namespace DeleteTaskSetResponse {
2696
2756
  * <p>The specified task set wasn't found. You can view your available task sets with <a>DescribeTaskSets</a>. Task sets are specific to each cluster, service and
2697
2757
  * Region.</p>
2698
2758
  */
2699
- export interface TaskSetNotFoundException extends __SmithyException, $MetadataBearer {
2700
- name: "TaskSetNotFoundException";
2701
- $fault: "client";
2702
- message?: string;
2759
+ export declare class TaskSetNotFoundException extends __BaseException {
2760
+ readonly name: "TaskSetNotFoundException";
2761
+ readonly $fault: "client";
2762
+ /**
2763
+ * @internal
2764
+ */
2765
+ constructor(opts: __ExceptionOptionType<TaskSetNotFoundException, __BaseException>);
2703
2766
  }
2704
2767
  export interface DeregisterContainerInstanceRequest {
2705
2768
  /**
@@ -3057,7 +3120,7 @@ export declare enum ContainerCondition {
3057
3120
  * multiple dependencies. When a dependency is defined for container startup, for container
3058
3121
  * shutdown it is reversed.</p>
3059
3122
  * <p>Your Amazon ECS container instances require at least version 1.26.0 of the container agent
3060
- * to enable container dependencies. However, we recommend using the latest container agent
3123
+ * to use container dependencies. However, we recommend using the latest container agent
3061
3124
  * version. For information about checking your agent version and updating to the latest
3062
3125
  * version, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html">Updating the Amazon ECS
3063
3126
  * Container Agent</a> in the <i>Amazon Elastic Container Service Developer Guide</i>. If you're using
@@ -3584,6 +3647,7 @@ export interface Secret {
3584
3647
  /**
3585
3648
  * <p>The secret to expose to the container. The supported values are either the full ARN of
3586
3649
  * the Secrets Manager secret or the full ARN of the parameter in the SSM Parameter Store.</p>
3650
+ * <p>For information about the require Identity and Access Management permissions, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-secrets.html#secrets-iam">Required IAM permissions for Amazon ECS secrets</a> (for Secrets Manager) or <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-parameters.html">Required IAM permissions for Amazon ECS secrets</a> (for Systems Manager Parameter store) in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
3587
3651
  * <note>
3588
3652
  * <p>If the SSM Parameter Store parameter exists in the same Region as the task
3589
3653
  * you're launching, then you can use either the full ARN or name of the parameter. If
@@ -4248,7 +4312,7 @@ export interface ContainerDefinition {
4248
4312
  * multiple dependencies. When a dependency is defined for container startup, for container
4249
4313
  * shutdown it is reversed.</p>
4250
4314
  * <p>For tasks using the EC2 launch type, the container instances require at
4251
- * least version 1.26.0 of the container agent to enable container dependencies. However,
4315
+ * least version 1.26.0 of the container agent to turn on container dependencies. However,
4252
4316
  * we recommend using the latest container agent version. For information about checking
4253
4317
  * your agent version and updating to the latest version, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html">Updating the Amazon ECS
4254
4318
  * Container Agent</a> in the <i>Amazon Elastic Container Service Developer Guide</i>. If you're using
@@ -4291,7 +4355,7 @@ export interface ContainerDefinition {
4291
4355
  * </li>
4292
4356
  * </ul>
4293
4357
  * <p>For tasks using the EC2 launch type, your container instances require at
4294
- * least version <code>1.26.0</code> of the container agent to enable a container start
4358
+ * least version <code>1.26.0</code> of the container agent to use a container start
4295
4359
  * timeout value. However, we recommend using the latest container agent version. For
4296
4360
  * information about checking your agent version and updating to the latest version, see
4297
4361
  * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html">Updating the Amazon ECS
@@ -4323,7 +4387,7 @@ export interface ContainerDefinition {
4323
4387
  * <code>stopTimeout</code> parameter or the <code>ECS_CONTAINER_STOP_TIMEOUT</code>
4324
4388
  * agent configuration variable are set, then the default values of 30 seconds for Linux
4325
4389
  * containers and 30 seconds on Windows containers are used. Your container instances
4326
- * require at least version 1.26.0 of the container agent to enable a container stop
4390
+ * require at least version 1.26.0 of the container agent to use a container stop
4327
4391
  * timeout value. However, we recommend using the latest container agent version. For
4328
4392
  * information about checking your agent version and updating to the latest version, see
4329
4393
  * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html">Updating the Amazon ECS
@@ -4604,16 +4668,9 @@ export declare namespace ContainerDefinition {
4604
4668
  * tasks hosted on Fargate. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/userguide/using_data_volumes.html">Fargate task
4605
4669
  * storage</a> in the <i>Amazon ECS User Guide for Fargate</i>.</p>
4606
4670
  * <note>
4607
- * <p>This parameter is only supported for tasks hosted on Fargate using
4608
- * the following platform versions:</p>
4609
- * <ul>
4610
- * <li>
4611
- * <p>Linux platform version <code>1.4.0</code> or later.</p>
4612
- * </li>
4613
- * <li>
4614
- * <p>Windows platform version <code>1.0.0</code> or later.</p>
4615
- * </li>
4616
- * </ul>
4671
+ * <p>This parameter is only supported for tasks hosted on Fargate using Linux
4672
+ * platform version <code>1.4.0</code> or later. This parameter is not supported for
4673
+ * Windows containers on Fargate.</p>
4617
4674
  * </note>
4618
4675
  */
4619
4676
  export interface EphemeralStorage {
@@ -4703,7 +4760,7 @@ export declare enum ProxyConfigurationType {
4703
4760
  * <p>The configuration details for the App Mesh proxy.</p>
4704
4761
  * <p>For tasks that use the EC2 launch type, the container instances require
4705
4762
  * at least version 1.26.0 of the container agent and at least version 1.26.0-1 of the
4706
- * <code>ecs-init</code> package to enable a proxy configuration. If your container
4763
+ * <code>ecs-init</code> package to use a proxy configuration. If your container
4707
4764
  * instances are launched from the Amazon ECS optimized AMI version <code>20190301</code> or
4708
4765
  * later, then they contain the required versions of the container agent and
4709
4766
  * <code>ecs-init</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html">Amazon ECS-optimized Linux AMI</a>
@@ -4935,7 +4992,7 @@ export interface EFSVolumeConfiguration {
4935
4992
  */
4936
4993
  rootDirectory?: string;
4937
4994
  /**
4938
- * <p>Determines whether to enable encryption for Amazon EFS data in transit between the Amazon ECS
4995
+ * <p>Determines whether to use encryption for Amazon EFS data in transit between the Amazon ECS
4939
4996
  * host and the Amazon EFS server. Transit encryption must be enabled if Amazon EFS IAM authorization
4940
4997
  * is used. If this parameter is omitted, the default value of <code>DISABLED</code> is
4941
4998
  * used. For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/encryption-in-transit.html">Encrypting Data in Transit</a> in
@@ -5342,7 +5399,7 @@ export interface TaskDefinition {
5342
5399
  /**
5343
5400
  * <p>The configuration details for the App Mesh proxy.</p>
5344
5401
  * <p>Your Amazon ECS container instances require at least version 1.26.0 of the container agent
5345
- * and at least version 1.26.0-1 of the <code>ecs-init</code> package to enable a proxy
5402
+ * and at least version 1.26.0-1 of the <code>ecs-init</code> package to use a proxy
5346
5403
  * configuration. If your container instances are launched from the Amazon ECS optimized AMI
5347
5404
  * version <code>20190301</code> or later, they contain the required versions of the
5348
5405
  * container agent and <code>ecs-init</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html">Amazon ECS-optimized Linux AMI</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
@@ -6242,6 +6299,39 @@ export interface Task {
6242
6299
  /**
6243
6300
  * <p>The stop code indicating why a task was stopped. The <code>stoppedReason</code> might
6244
6301
  * contain additional details.</p>
6302
+ * <p>The following are valid values:</p>
6303
+ * <ul>
6304
+ * <li>
6305
+ * <p>
6306
+ * <code>TaskFailedToStart</code>
6307
+ * </p>
6308
+ * </li>
6309
+ * <li>
6310
+ * <p>
6311
+ * <code>EssentialContainerExited</code>
6312
+ * </p>
6313
+ * </li>
6314
+ * <li>
6315
+ * <p>
6316
+ * <code>UserInitiated</code>
6317
+ * </p>
6318
+ * </li>
6319
+ * <li>
6320
+ * <p>
6321
+ * <code>TerminationNotice</code>
6322
+ * </p>
6323
+ * </li>
6324
+ * <li>
6325
+ * <p>
6326
+ * <code>ServiceSchedulerInitiated</code>
6327
+ * </p>
6328
+ * </li>
6329
+ * <li>
6330
+ * <p>
6331
+ * <code>SpotInterruption</code>
6332
+ * </p>
6333
+ * </li>
6334
+ * </ul>
6245
6335
  */
6246
6336
  stopCode?: TaskStopCode | string;
6247
6337
  /**
@@ -6462,8 +6552,7 @@ export interface Session {
6462
6552
  sessionId?: string;
6463
6553
  /**
6464
6554
  * <p>A URL
6465
- * back
6466
- * to managed agent on the container that the SSM Session Manager client
6555
+ * to the managed agent on the container that the SSM Session Manager client
6467
6556
  * uses to send commands and receive output from the container.</p>
6468
6557
  */
6469
6558
  streamUrl?: string;
@@ -6518,10 +6607,13 @@ export declare namespace ExecuteCommandResponse {
6518
6607
  * <p>The target container isn't properly configured with the execute command agent or the
6519
6608
  * container is no longer active or running.</p>
6520
6609
  */
6521
- export interface TargetNotConnectedException extends __SmithyException, $MetadataBearer {
6522
- name: "TargetNotConnectedException";
6523
- $fault: "client";
6524
- message?: string;
6610
+ export declare class TargetNotConnectedException extends __BaseException {
6611
+ readonly name: "TargetNotConnectedException";
6612
+ readonly $fault: "client";
6613
+ /**
6614
+ * @internal
6615
+ */
6616
+ constructor(opts: __ExceptionOptionType<TargetNotConnectedException, __BaseException>);
6525
6617
  }
6526
6618
  export interface ListAccountSettingsRequest {
6527
6619
  /**
@@ -7243,10 +7335,13 @@ export declare namespace PutAccountSettingDefaultResponse {
7243
7335
  * attributes of a resource with <a>ListAttributes</a>. You can remove existing
7244
7336
  * attributes on a resource with <a>DeleteAttributes</a>.</p>
7245
7337
  */
7246
- export interface AttributeLimitExceededException extends __SmithyException, $MetadataBearer {
7247
- name: "AttributeLimitExceededException";
7248
- $fault: "client";
7249
- message?: string;
7338
+ export declare class AttributeLimitExceededException extends __BaseException {
7339
+ readonly name: "AttributeLimitExceededException";
7340
+ readonly $fault: "client";
7341
+ /**
7342
+ * @internal
7343
+ */
7344
+ constructor(opts: __ExceptionOptionType<AttributeLimitExceededException, __BaseException>);
7250
7345
  }
7251
7346
  export interface PutAttributesRequest {
7252
7347
  /**
@@ -7335,10 +7430,13 @@ export declare namespace PutClusterCapacityProvidersResponse {
7335
7430
  /**
7336
7431
  * <p>The specified resource is in-use and can't be removed.</p>
7337
7432
  */
7338
- export interface ResourceInUseException extends __SmithyException, $MetadataBearer {
7339
- name: "ResourceInUseException";
7340
- $fault: "client";
7341
- message?: string;
7433
+ export declare class ResourceInUseException extends __BaseException {
7434
+ readonly name: "ResourceInUseException";
7435
+ readonly $fault: "client";
7436
+ /**
7437
+ * @internal
7438
+ */
7439
+ constructor(opts: __ExceptionOptionType<ResourceInUseException, __BaseException>);
7342
7440
  }
7343
7441
  export declare enum PlatformDeviceType {
7344
7442
  GPU = "GPU"
@@ -7704,7 +7802,7 @@ export interface RegisterTaskDefinitionRequest {
7704
7802
  * <p>The configuration details for the App Mesh proxy.</p>
7705
7803
  * <p>For tasks hosted on Amazon EC2 instances, the container instances require at least version
7706
7804
  * <code>1.26.0</code> of the container agent and at least version
7707
- * <code>1.26.0-1</code> of the <code>ecs-init</code> package to enable a proxy
7805
+ * <code>1.26.0-1</code> of the <code>ecs-init</code> package to use a proxy
7708
7806
  * configuration. If your container instances are launched from the Amazon ECS-optimized
7709
7807
  * AMI version <code>20190301</code> or later, then they contain the required versions of
7710
7808
  * the container agent and <code>ecs-init</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-ami-versions.html">Amazon ECS-optimized AMI versions</a> in the
@@ -7768,10 +7866,13 @@ export declare namespace RegisterTaskDefinitionResponse {
7768
7866
  * <p>Your Amazon Web Services account was blocked. For more information, contact <a href="http://aws.amazon.com/contact-us/">
7769
7867
  * Amazon Web Services Support</a>.</p>
7770
7868
  */
7771
- export interface BlockedException extends __SmithyException, $MetadataBearer {
7772
- name: "BlockedException";
7773
- $fault: "client";
7774
- message?: string;
7869
+ export declare class BlockedException extends __BaseException {
7870
+ readonly name: "BlockedException";
7871
+ readonly $fault: "client";
7872
+ /**
7873
+ * @internal
7874
+ */
7875
+ constructor(opts: __ExceptionOptionType<BlockedException, __BaseException>);
7775
7876
  }
7776
7877
  export interface RunTaskRequest {
7777
7878
  /**
@@ -7796,13 +7897,13 @@ export interface RunTaskRequest {
7796
7897
  */
7797
7898
  count?: number;
7798
7899
  /**
7799
- * <p>Specifies whether to enable Amazon ECS managed tags for the task. For more information, see
7900
+ * <p>Specifies whether to use Amazon ECS managed tags for the task. For more information, see
7800
7901
  * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html">Tagging Your Amazon ECS
7801
7902
  * Resources</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
7802
7903
  */
7803
7904
  enableECSManagedTags?: boolean;
7804
7905
  /**
7805
- * <p>Determines whether to enable the execute command functionality for the containers in
7906
+ * <p>Determines whether to use the execute command functionality for the containers in
7806
7907
  * this task. If <code>true</code>, this enables execute command functionality on all
7807
7908
  * containers in the task.</p>
7808
7909
  */
@@ -7980,7 +8081,7 @@ export interface StartTaskRequest {
7980
8081
  */
7981
8082
  containerInstances: string[] | undefined;
7982
8083
  /**
7983
- * <p>Specifies whether to enable Amazon ECS managed tags for the task. For more information, see
8084
+ * <p>Specifies whether to use Amazon ECS managed tags for the task. For more information, see
7984
8085
  * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html">Tagging Your Amazon ECS
7985
8086
  * Resources</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
7986
8087
  */
@@ -8366,10 +8467,13 @@ export declare namespace SubmitTaskStateChangeResponse {
8366
8467
  /**
8367
8468
  * <p>The specified resource wasn't found.</p>
8368
8469
  */
8369
- export interface ResourceNotFoundException extends __SmithyException, $MetadataBearer {
8370
- name: "ResourceNotFoundException";
8371
- $fault: "client";
8372
- message?: string;
8470
+ export declare class ResourceNotFoundException extends __BaseException {
8471
+ readonly name: "ResourceNotFoundException";
8472
+ readonly $fault: "client";
8473
+ /**
8474
+ * @internal
8475
+ */
8476
+ constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
8373
8477
  }
8374
8478
  export interface TagResourceRequest {
8375
8479
  /**
@@ -8552,7 +8656,7 @@ export interface UpdateClusterSettingsRequest {
8552
8656
  */
8553
8657
  cluster: string | undefined;
8554
8658
  /**
8555
- * <p>The setting to use by default for a cluster. This parameter is used to enable CloudWatch
8659
+ * <p>The setting to use by default for a cluster. This parameter is used to turn on CloudWatch
8556
8660
  * Container Insights for a cluster. If this value is specified, it overrides the
8557
8661
  * <code>containerInsights</code> value set with <a>PutAccountSetting</a> or
8558
8662
  * <a>PutAccountSettingDefault</a>.</p>
@@ -8583,20 +8687,26 @@ export declare namespace UpdateClusterSettingsResponse {
8583
8687
  * could be because the agent running on the container instance is a previous or custom
8584
8688
  * version that doesn't use our version information.</p>
8585
8689
  */
8586
- export interface MissingVersionException extends __SmithyException, $MetadataBearer {
8587
- name: "MissingVersionException";
8588
- $fault: "client";
8589
- message?: string;
8690
+ export declare class MissingVersionException extends __BaseException {
8691
+ readonly name: "MissingVersionException";
8692
+ readonly $fault: "client";
8693
+ /**
8694
+ * @internal
8695
+ */
8696
+ constructor(opts: __ExceptionOptionType<MissingVersionException, __BaseException>);
8590
8697
  }
8591
8698
  /**
8592
8699
  * <p>There's no update available for this Amazon ECS container agent. This might be because the
8593
8700
  * agent is already running the latest version or because it's so old that there's no
8594
8701
  * update path to the current version.</p>
8595
8702
  */
8596
- export interface NoUpdateAvailableException extends __SmithyException, $MetadataBearer {
8597
- name: "NoUpdateAvailableException";
8598
- $fault: "client";
8599
- message?: string;
8703
+ export declare class NoUpdateAvailableException extends __BaseException {
8704
+ readonly name: "NoUpdateAvailableException";
8705
+ readonly $fault: "client";
8706
+ /**
8707
+ * @internal
8708
+ */
8709
+ constructor(opts: __ExceptionOptionType<NoUpdateAvailableException, __BaseException>);
8600
8710
  }
8601
8711
  export interface UpdateContainerAgentRequest {
8602
8712
  /**
@@ -8778,6 +8888,44 @@ export interface UpdateServiceRequest {
8778
8888
  * you can set this to <code>null</code> when performing this action.</p>
8779
8889
  */
8780
8890
  enableExecuteCommand?: boolean;
8891
+ /**
8892
+ * <p>Determines whether to turn on Amazon ECS managed tags for the tasks in the service. For more
8893
+ * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html">Tagging Your Amazon ECS
8894
+ * Resources</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
8895
+ * <p>Only tasks launched after the update will reflect the update. To update the tags on
8896
+ * all tasks, set <code>forceNewDeployment</code> to <code>true</code>, so that Amazon ECS
8897
+ * starts new tasks with the updated tags.</p>
8898
+ */
8899
+ enableECSManagedTags?: boolean;
8900
+ /**
8901
+ * <p>A list of Elastic Load Balancing load balancer objects. It contains the load balancer name, the
8902
+ * container name, and the container port to access from the load balancer. The container
8903
+ * name is as it appears in a container definition.</p>
8904
+ * <p>When you add, update, or remove a load balancer configuration, Amazon ECS starts new tasks with
8905
+ * the updated Elastic Load Balancing configuration, and then stops the old tasks when the new tasks are
8906
+ * running.</p>
8907
+ * <p>You can remove existing <code>loadBalancers</code> by passing an empty list.</p>
8908
+ */
8909
+ loadBalancers?: LoadBalancer[];
8910
+ /**
8911
+ * <p>Determines whether to propagate the tags from the task definition or the service to
8912
+ * the task. If no value is specified, the tags aren't propagated.</p>
8913
+ * <p>Only tasks launched after the update will reflect the update. To update the tags on
8914
+ * all tasks, set <code>forceNewDeployment</code> to <code>true</code>, so that Amazon ECS
8915
+ * starts new tasks with the updated tags.</p>
8916
+ */
8917
+ propagateTags?: PropagateTags | string;
8918
+ /**
8919
+ * <p>The details for the service discovery registries to assign to this service. For more
8920
+ * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html">Service
8921
+ * Discovery</a>.</p>
8922
+ * <p>When you add, update, or remove the service registries configuration, Amazon ECS starts new tasks
8923
+ * with the updated service registries configuration, and then stops the old tasks when the
8924
+ * new tasks are running.</p>
8925
+ * <p>You can remove existing <code>serviceRegistries</code> by passing an empty
8926
+ * list.</p>
8927
+ */
8928
+ serviceRegistries?: ServiceRegistry[];
8781
8929
  }
8782
8930
  export declare namespace UpdateServiceRequest {
8783
8931
  /**
@@ -8821,7 +8969,7 @@ export declare namespace UpdateServicePrimaryTaskSetRequest {
8821
8969
  }
8822
8970
  export interface UpdateServicePrimaryTaskSetResponse {
8823
8971
  /**
8824
- * <p>Details about the task set.</p>
8972
+ * <p>etails about the task set.</p>
8825
8973
  */
8826
8974
  taskSet?: TaskSet;
8827
8975
  }