@aws-sdk/client-ecs 3.787.0 → 3.795.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +8 -0
  2. package/dist-cjs/index.js +77 -0
  3. package/dist-es/ECS.js +2 -0
  4. package/dist-es/commands/StopServiceDeploymentCommand.js +22 -0
  5. package/dist-es/commands/index.js +1 -0
  6. package/dist-es/models/models_0.js +18 -0
  7. package/dist-es/protocols/Aws_json1_1.js +32 -1
  8. package/dist-types/ECS.d.ts +7 -0
  9. package/dist-types/ECSClient.d.ts +3 -2
  10. package/dist-types/commands/DeleteAccountSettingCommand.d.ts +2 -2
  11. package/dist-types/commands/DescribeServiceDeploymentsCommand.d.ts +2 -3
  12. package/dist-types/commands/ListAccountSettingsCommand.d.ts +2 -2
  13. package/dist-types/commands/ListServiceDeploymentsCommand.d.ts +2 -2
  14. package/dist-types/commands/PutAccountSettingCommand.d.ts +2 -2
  15. package/dist-types/commands/PutAccountSettingDefaultCommand.d.ts +2 -2
  16. package/dist-types/commands/StopServiceDeploymentCommand.d.ts +149 -0
  17. package/dist-types/commands/TagResourceCommand.d.ts +1 -1
  18. package/dist-types/commands/UntagResourceCommand.d.ts +1 -1
  19. package/dist-types/commands/index.d.ts +1 -0
  20. package/dist-types/models/models_0.d.ts +147 -144
  21. package/dist-types/models/models_1.d.ts +88 -1
  22. package/dist-types/protocols/Aws_json1_1.d.ts +9 -0
  23. package/dist-types/ts3.4/ECS.d.ts +17 -0
  24. package/dist-types/ts3.4/ECSClient.d.ts +6 -0
  25. package/dist-types/ts3.4/commands/StopServiceDeploymentCommand.d.ts +51 -0
  26. package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +1 -1
  27. package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +1 -1
  28. package/dist-types/ts3.4/commands/index.d.ts +1 -0
  29. package/dist-types/ts3.4/models/models_0.d.ts +25 -10
  30. package/dist-types/ts3.4/models/models_1.d.ts +11 -0
  31. package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +12 -0
  32. package/package.json +1 -1
@@ -685,8 +685,8 @@ export interface ClusterServiceConnectDefaultsRequest {
685
685
  /**
686
686
  * <p>The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace that's used when you create a service and don't specify
687
687
  * a Service Connect configuration. The namespace name can include up to 1024 characters.
688
- * The name is case-sensitive. The name can't include greater than
689
- * (>), less than (<), double quotation marks ("), or slash (/).</p>
688
+ * The name is case-sensitive. The name can't include greater than (>), less than
689
+ * (<), double quotation marks ("), or slash (/).</p>
690
690
  * <p>If you enter an existing namespace name or ARN, then that namespace will be used.
691
691
  * Any namespace type is supported. The namespace must be in this account and this Amazon Web Services
692
692
  * Region.</p>
@@ -1308,9 +1308,10 @@ export interface DeploymentConfiguration {
1308
1308
  * uses either the blue/green (<code>CODE_DEPLOY</code>) or <code>EXTERNAL</code>
1309
1309
  * deployment types and has tasks that use the EC2 launch type.</p>
1310
1310
  * </note>
1311
- * <p>If the service uses either the blue/green (<code>CODE_DEPLOY</code>) or <code>EXTERNAL</code>
1312
- * deployment types, and the tasks in the service use the Fargate launch type, the maximum
1313
- * percent value is not used. The value is still returned when describing your service.</p>
1311
+ * <p>If the service uses either the blue/green (<code>CODE_DEPLOY</code>) or
1312
+ * <code>EXTERNAL</code> deployment types, and the tasks in the service use the
1313
+ * Fargate launch type, the maximum percent value is not used. The value is
1314
+ * still returned when describing your service.</p>
1314
1315
  * @public
1315
1316
  */
1316
1317
  maximumPercent?: number | undefined;
@@ -1564,12 +1565,12 @@ export interface AwsVpcConfiguration {
1564
1565
  * <p>Consider the following when you set this value:</p>
1565
1566
  * <ul>
1566
1567
  * <li>
1567
- * <p>When you use <code>create-service</code> or <code>update-service</code>, the default is
1568
- * <code>DISABLED</code>. </p>
1568
+ * <p>When you use <code>create-service</code> or <code>update-service</code>, the
1569
+ * default is <code>DISABLED</code>. </p>
1569
1570
  * </li>
1570
1571
  * <li>
1571
- * <p>When the service <code>deploymentController</code> is <code>ECS</code>, the value must be
1572
- * <code>DISABLED</code>. </p>
1572
+ * <p>When the service <code>deploymentController</code> is <code>ECS</code>, the
1573
+ * value must be <code>DISABLED</code>. </p>
1573
1574
  * </li>
1574
1575
  * </ul>
1575
1576
  * @public
@@ -1854,9 +1855,7 @@ export interface LogConfiguration {
1854
1855
  * </dd>
1855
1856
  * <dt>awslogs-stream-prefix</dt>
1856
1857
  * <dd>
1857
- * <p>Required: Yes, when using the Fargate launch
1858
- * type.Optional for the EC2 launch type,
1859
- * required for the Fargate launch type.</p>
1858
+ * <p>Required: Yes, when using Fargate.Optional when using EC2.</p>
1860
1859
  * <p>Use the <code>awslogs-stream-prefix</code> option to associate a log
1861
1860
  * stream with the specified prefix, the container name, and the ID of the
1862
1861
  * Amazon ECS task that the container belongs to. If you specify a prefix with this
@@ -1912,15 +1911,19 @@ export interface LogConfiguration {
1912
1911
  * performance.</p>
1913
1912
  * </note>
1914
1913
  * </dd>
1914
+ * </dl>
1915
+ * <p>The following options apply to all supported log drivers.</p>
1916
+ * <dl>
1915
1917
  * <dt>mode</dt>
1916
1918
  * <dd>
1917
1919
  * <p>Required: No</p>
1918
1920
  * <p>Valid values: <code>non-blocking</code> | <code>blocking</code>
1919
1921
  * </p>
1920
1922
  * <p>This option defines the delivery mode of log messages from the container
1921
- * to CloudWatch Logs. The delivery mode you choose affects application availability when
1922
- * the flow of logs from container to CloudWatch is interrupted.</p>
1923
- * <p>If you use the <code>blocking</code> mode and the flow of logs to CloudWatch is
1923
+ * to the log driver specified using <code>logDriver</code>. The delivery mode
1924
+ * you choose affects application availability when the flow of logs from
1925
+ * container is interrupted.</p>
1926
+ * <p>If you use the <code>blocking</code> mode and the flow of logs is
1924
1927
  * interrupted, calls from container code to write to the <code>stdout</code>
1925
1928
  * and <code>stderr</code> streams will block. The logging thread of the
1926
1929
  * application will block as a result. This may cause the application to become
@@ -1928,10 +1931,15 @@ export interface LogConfiguration {
1928
1931
  * <p>If you use the <code>non-blocking</code> mode, the container's logs are
1929
1932
  * instead stored in an in-memory intermediate buffer configured with the
1930
1933
  * <code>max-buffer-size</code> option. This prevents the application from
1931
- * becoming unresponsive when logs cannot be sent to CloudWatch. We recommend using
1932
- * this mode if you want to ensure service availability and are okay with some
1933
- * log loss. For more information, see <a href="http://aws.amazon.com/blogs/containers/preventing-log-loss-with-non-blocking-mode-in-the-awslogs-container-log-driver/">Preventing log loss with non-blocking mode in the <code>awslogs</code>
1934
+ * becoming unresponsive when logs cannot be sent. We recommend using this mode
1935
+ * if you want to ensure service availability and are okay with some log loss.
1936
+ * For more information, see <a href="http://aws.amazon.com/blogs/containers/preventing-log-loss-with-non-blocking-mode-in-the-awslogs-container-log-driver/">Preventing log loss with non-blocking mode in the <code>awslogs</code>
1934
1937
  * container log driver</a>.</p>
1938
+ * <p>You can set a default <code>mode</code> for all containers in a specific
1939
+ * Amazon Web Services Region by using the <code>defaultLogDriverMode</code> account setting.
1940
+ * If you don't specify the <code>mode</code> option or
1941
+ * configure the account setting, Amazon ECS will default to the
1942
+ * <code>blocking</code> mode. For more information about the account setting, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#default-log-driver-mode">Default log driver mode</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
1935
1943
  * </dd>
1936
1944
  * <dt>max-buffer-size</dt>
1937
1945
  * <dd>
@@ -1962,8 +1970,9 @@ export interface LogConfiguration {
1962
1970
  * <p> When you export logs to Amazon OpenSearch Service, you can specify options like <code>Name</code>,
1963
1971
  * <code>Host</code> (OpenSearch Service endpoint without protocol), <code>Port</code>,
1964
1972
  * <code>Index</code>, <code>Type</code>, <code>Aws_auth</code>,
1965
- * <code>Aws_region</code>, <code>Suppress_Type_Name</code>, and
1966
- * <code>tls</code>. For more information, see <a href="http://aws.amazon.com/blogs/containers/under-the-hood-firelens-for-amazon-ecs-tasks/">Under the hood: FireLens for Amazon ECS Tasks</a>.</p>
1973
+ * <code>Aws_region</code>, <code>Suppress_Type_Name</code>, and <code>tls</code>. For
1974
+ * more information, see <a href="http://aws.amazon.com/blogs/containers/under-the-hood-firelens-for-amazon-ecs-tasks/">Under the hood:
1975
+ * FireLens for Amazon ECS Tasks</a>.</p>
1967
1976
  * <p>When you export logs to Amazon S3, you can specify the bucket using the <code>bucket</code>
1968
1977
  * option. You can also specify <code>region</code>, <code>total_file_size</code>,
1969
1978
  * <code>upload_timeout</code>, and <code>use_put_object</code> as options.</p>
@@ -3881,6 +3890,7 @@ export declare const SettingName: {
3881
3890
  readonly AWSVPC_TRUNKING: "awsvpcTrunking";
3882
3891
  readonly CONTAINER_INSIGHTS: "containerInsights";
3883
3892
  readonly CONTAINER_INSTANCE_LONG_ARN_FORMAT: "containerInstanceLongArnFormat";
3893
+ readonly DEFAULT_LOG_DRIVER_MODE: "defaultLogDriverMode";
3884
3894
  readonly FARGATE_FIPS_MODE: "fargateFIPSMode";
3885
3895
  readonly FARGATE_TASK_RETIREMENT_WAIT_PERIOD: "fargateTaskRetirementWaitPeriod";
3886
3896
  readonly GUARD_DUTY_ACTIVATE: "guardDutyActivate";
@@ -4569,7 +4579,8 @@ export interface FirelensConfiguration {
4569
4579
  * that's configured to use a Classic Load Balancer.</p>
4570
4580
  * </li>
4571
4581
  * </ul>
4572
- * <p>For an example of how to specify a task definition with multiple containers where container dependency is specified, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/example_task_definitions.html#example_task_definition-containerdependency">Container dependency</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
4582
+ * <p>For an example of how to specify a task definition with multiple containers where
4583
+ * container dependency is specified, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/example_task_definitions.html#example_task_definition-containerdependency">Container dependency</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
4573
4584
  * @public
4574
4585
  */
4575
4586
  export interface HealthCheck {
@@ -4594,16 +4605,16 @@ export interface HealthCheck {
4594
4605
  */
4595
4606
  command: string[] | undefined;
4596
4607
  /**
4597
- * <p>The time period in seconds between each health check execution. You may specify between 5
4598
- * and 300 seconds. The default value is 30 seconds. This value applies only when you
4599
- * specify a <code>command</code>. </p>
4608
+ * <p>The time period in seconds between each health check execution. You may specify
4609
+ * between 5 and 300 seconds. The default value is 30 seconds. This value applies only when
4610
+ * you specify a <code>command</code>. </p>
4600
4611
  * @public
4601
4612
  */
4602
4613
  interval?: number | undefined;
4603
4614
  /**
4604
- * <p>The time period in seconds to wait for a health check to succeed before it is considered a
4605
- * failure. You may specify between 2 and 60 seconds. The default value is 5. This value
4606
- * applies only when you specify a <code>command</code>. </p>
4615
+ * <p>The time period in seconds to wait for a health check to succeed before it is
4616
+ * considered a failure. You may specify between 2 and 60 seconds. The default value is 5.
4617
+ * This value applies only when you specify a <code>command</code>. </p>
4607
4618
  * @public
4608
4619
  */
4609
4620
  timeout?: number | undefined;
@@ -4632,15 +4643,16 @@ export interface HealthCheck {
4632
4643
  * <p>The Linux capabilities to add or remove from the default Docker configuration for a
4633
4644
  * container defined in the task definition. For more detailed information about these
4634
4645
  * Linux capabilities, see the <a href="http://man7.org/linux/man-pages/man7/capabilities.7.html">capabilities(7)</a> Linux manual page.</p>
4635
- * <p>The following describes how Docker processes the Linux capabilities specified in the <code>add</code> and
4636
- * <code>drop</code> request parameters. For information about the latest behavior, see
4637
- * <a href="https://forums.docker.com/t/docker-compose-order-of-cap-drop-and-cap-add/97136/1">Docker Compose: order of cap_drop and cap_add</a> in the Docker Community Forum.</p>
4646
+ * <p>The following describes how Docker processes the Linux capabilities specified in the
4647
+ * <code>add</code> and <code>drop</code> request parameters. For information about the
4648
+ * latest behavior, see <a href="https://forums.docker.com/t/docker-compose-order-of-cap-drop-and-cap-add/97136/1">Docker Compose: order of cap_drop and cap_add</a> in the Docker Community
4649
+ * Forum.</p>
4638
4650
  * <ul>
4639
4651
  * <li>
4640
- * <p>When the container is a privleged container, the container capabilities are all of the
4641
- * default Docker capabilities. The capabilities specified in the <code>add</code>
4642
- * request parameter, and the <code>drop</code> request parameter are
4643
- * ignored.</p>
4652
+ * <p>When the container is a privleged container, the container capabilities are
4653
+ * all of the default Docker capabilities. The capabilities specified in the
4654
+ * <code>add</code> request parameter, and the <code>drop</code> request
4655
+ * parameter are ignored.</p>
4644
4656
  * </li>
4645
4657
  * <li>
4646
4658
  * <p>When the <code>add</code> request parameter is set to ALL, the container
@@ -4648,17 +4660,19 @@ export interface HealthCheck {
4648
4660
  * specified in the <code>drop</code> request parameter.</p>
4649
4661
  * </li>
4650
4662
  * <li>
4651
- * <p>When the <code>drop</code> request parameter is set to ALL, the container capabilities are
4652
- * the capabilities specified in the <code>add</code> request parameter.</p>
4663
+ * <p>When the <code>drop</code> request parameter is set to ALL, the container
4664
+ * capabilities are the capabilities specified in the <code>add</code> request
4665
+ * parameter.</p>
4653
4666
  * </li>
4654
4667
  * <li>
4655
- * <p>When the <code>add</code> request parameter and the <code>drop</code> request parameter are both empty, the capabilities the container
4656
- * capabilities are all of the default Docker capabilities.</p>
4668
+ * <p>When the <code>add</code> request parameter and the <code>drop</code> request
4669
+ * parameter are both empty, the capabilities the container capabilities are all of
4670
+ * the default Docker capabilities.</p>
4657
4671
  * </li>
4658
4672
  * <li>
4659
- * <p>The default is to first drop the capabilities specified in the <code>drop</code> request
4660
- * parameter, and then add the capabilities specified in the <code>add</code>
4661
- * request parameter.</p>
4673
+ * <p>The default is to first drop the capabilities specified in the
4674
+ * <code>drop</code> request parameter, and then add the capabilities specified
4675
+ * in the <code>add</code> request parameter.</p>
4662
4676
  * </li>
4663
4677
  * </ul>
4664
4678
  * @public
@@ -5634,8 +5648,8 @@ export interface ContainerDefinition {
5634
5648
  */
5635
5649
  volumesFrom?: VolumeFrom[] | undefined;
5636
5650
  /**
5637
- * <p>Linux-specific modifications that are applied to the default Docker container configuration, such as Linux kernel
5638
- * capabilities. For more information see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_KernelCapabilities.html">KernelCapabilities</a>.</p>
5651
+ * <p>Linux-specific modifications that are applied to the default Docker container
5652
+ * configuration, such as Linux kernel capabilities. For more information see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_KernelCapabilities.html">KernelCapabilities</a>.</p>
5639
5653
  * <note>
5640
5654
  * <p>This parameter is not supported for Windows containers.</p>
5641
5655
  * </note>
@@ -6936,8 +6950,8 @@ export interface TaskDefinition {
6936
6950
  */
6937
6951
  ephemeralStorage?: EphemeralStorage | undefined;
6938
6952
  /**
6939
- * <p>Enables fault injection and allows for fault injection requests to be accepted from the task's containers.
6940
- * The default value is <code>false</code>.</p>
6953
+ * <p>Enables fault injection and allows for fault injection requests to be accepted from
6954
+ * the task's containers. The default value is <code>false</code>.</p>
6941
6955
  * @public
6942
6956
  */
6943
6957
  enableFaultInjection?: boolean | undefined;
@@ -7716,6 +7730,7 @@ export declare const ServiceDeploymentStatus: {
7716
7730
  readonly PENDING: "PENDING";
7717
7731
  readonly ROLLBACK_FAILED: "ROLLBACK_FAILED";
7718
7732
  readonly ROLLBACK_IN_PROGRESS: "ROLLBACK_IN_PROGRESS";
7733
+ readonly ROLLBACK_REQUESTED: "ROLLBACK_REQUESTED";
7719
7734
  readonly ROLLBACK_SUCCESSFUL: "ROLLBACK_SUCCESSFUL";
7720
7735
  readonly STOPPED: "STOPPED";
7721
7736
  readonly STOP_REQUESTED: "STOP_REQUESTED";
@@ -7728,8 +7743,7 @@ export type ServiceDeploymentStatus = (typeof ServiceDeploymentStatus)[keyof typ
7728
7743
  /**
7729
7744
  * <p>Information about the service deployment.</p>
7730
7745
  * <p>Service deployments provide a comprehensive view of your deployments. For information
7731
- * about service deployments, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployment.html">View service history
7732
- * using Amazon ECS service deployments</a> in the
7746
+ * about service deployments, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployment.html">View service history using Amazon ECS service deployments</a> in the
7733
7747
  * <i>
7734
7748
  * <i>Amazon Elastic Container Service Developer Guide</i>
7735
7749
  * </i>.</p>
@@ -8697,13 +8711,13 @@ export interface Task {
8697
8711
  * expressed as a string using vCPUs (for example, <code>1 vCPU</code> or <code>1
8698
8712
  * vcpu</code>). String values are converted to an integer that indicates the CPU units
8699
8713
  * when the task definition is registered.</p>
8700
- * <p>If you're using the EC2 launch type or the external launch type, this field is
8701
- * optional. Supported values are between <code>128</code> CPU units (<code>0.125</code>
8702
- * vCPUs) and <code>196608</code> CPU units (<code>192</code> vCPUs). If you do not specify
8703
- * a value, the parameter is ignored.</p>
8704
- * <p>If you're using the Fargate launch type, this field is required. You must use
8705
- * one of the following values. These values determine the range of supported values for
8706
- * the <code>memory</code> parameter:</p>
8714
+ * <p>If you're using the EC2 launch type or the external launch type, this
8715
+ * field is optional. Supported values are between <code>128</code> CPU units
8716
+ * (<code>0.125</code> vCPUs) and <code>196608</code> CPU units (<code>192</code>
8717
+ * vCPUs). If you do not specify a value, the parameter is ignored.</p>
8718
+ * <p>If you're using the Fargate launch type, this field is required. You
8719
+ * must use one of the following values. These values determine the range of supported
8720
+ * values for the <code>memory</code> parameter:</p>
8707
8721
  * <p>The CPU units cannot be less than 1 vCPU when you use Windows containers on
8708
8722
  * Fargate.</p>
8709
8723
  * <ul>
@@ -10291,6 +10305,17 @@ export interface PutAccountSettingRequest {
10291
10305
  * </li>
10292
10306
  * <li>
10293
10307
  * <p>
10308
+ * <code>defaultLogDriverMode</code> - Amazon ECS supports setting a default delivery
10309
+ * mode of log messages from a container to the <code>logDriver</code> that you specify in the container's <code>logConfiguration</code>. The delivery mode affects
10310
+ * application stability when the flow of logs from the container to the log driver is
10311
+ * interrupted. The <code>defaultLogDriverMode</code> setting supports two values:
10312
+ * <code>blocking</code> and <code>non-blocking</code>. If you don't specify a
10313
+ * delivery mode in your container definition's <code>logConfiguration</code>, the
10314
+ * mode you specify using this account setting will be used as the default. For
10315
+ * more information about log delivery modes, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html">LogConfiguration</a>.</p>
10316
+ * </li>
10317
+ * <li>
10318
+ * <p>
10294
10319
  * <code>guardDutyActivate</code> - The <code>guardDutyActivate</code> parameter is read-only in Amazon ECS and indicates whether
10295
10320
  * Amazon ECS Runtime Monitoring is enabled or disabled by your security administrator in your
10296
10321
  * Amazon ECS account. Amazon GuardDuty controls this account setting on your behalf. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-guard-duty-integration.html">Protecting Amazon ECS workloads with Amazon ECS Runtime Monitoring</a>.</p>
@@ -10452,6 +10477,17 @@ export interface PutAccountSettingDefaultRequest {
10452
10477
  * </li>
10453
10478
  * <li>
10454
10479
  * <p>
10480
+ * <code>defaultLogDriverMode</code> -Amazon ECS supports setting a default delivery
10481
+ * mode of log messages from a container to the <code>logDriver</code> that you specify in the container's <code>logConfiguration</code>. The delivery mode affects
10482
+ * application stability when the flow of logs from the container to the log driver is
10483
+ * interrupted. The <code>defaultLogDriverMode</code> setting supports two values:
10484
+ * <code>blocking</code> and <code>non-blocking</code>. If you don't specify a
10485
+ * delivery mode in your container definition's <code>logConfiguration</code>, the
10486
+ * mode you specify using this account setting will be used as the default. For
10487
+ * more information about log delivery modes, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html">LogConfiguration</a>.</p>
10488
+ * </li>
10489
+ * <li>
10490
+ * <p>
10455
10491
  * <code>guardDutyActivate</code> - The <code>guardDutyActivate</code> parameter is read-only in Amazon ECS and indicates whether
10456
10492
  * Amazon ECS Runtime Monitoring is enabled or disabled by your security administrator in your
10457
10493
  * Amazon ECS account. Amazon GuardDuty controls this account setting on your behalf. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-guard-duty-integration.html">Protecting Amazon ECS workloads with Amazon ECS Runtime Monitoring</a>.</p>
@@ -10826,8 +10862,8 @@ export interface RegisterTaskDefinitionRequest {
10826
10862
  * <p>Task-level CPU and memory parameters are ignored for Windows containers. We
10827
10863
  * recommend specifying container-level resources for Windows containers.</p>
10828
10864
  * </note>
10829
- * <p>If you're using the EC2 launch type or external launch type, this field is
10830
- * optional. Supported values are between <code>128</code> CPU units (<code>0.125</code>
10865
+ * <p>If you're using the EC2 launch type or external launch type, this field
10866
+ * is optional. Supported values are between <code>128</code> CPU units (<code>0.125</code>
10831
10867
  * vCPUs) and <code>196608</code> CPU units (<code>192</code> vCPUs). If you do not specify
10832
10868
  * a value, the parameter is ignored.</p>
10833
10869
  * <p>If you're using the Fargate launch type, this field is required and you
@@ -11052,8 +11088,9 @@ export interface RegisterTaskDefinitionRequest {
11052
11088
  */
11053
11089
  runtimePlatform?: RuntimePlatform | undefined;
11054
11090
  /**
11055
- * <p>Enables fault injection when you register your task definition and allows for fault injection requests
11056
- * to be accepted from the task's containers. The default value is <code>false</code>.</p>
11091
+ * <p>Enables fault injection when you register your task definition and allows for fault
11092
+ * injection requests to be accepted from the task's containers. The default value is
11093
+ * <code>false</code>.</p>
11057
11094
  * @public
11058
11095
  */
11059
11096
  enableFaultInjection?: boolean | undefined;
@@ -11346,6 +11383,8 @@ export interface RunTaskRequest {
11346
11383
  /**
11347
11384
  * <p>The short name or full Amazon Resource Name (ARN) of the cluster to run your task on.
11348
11385
  * If you do not specify a cluster, the default cluster is assumed.</p>
11386
+ * <p>Each account receives a default cluster the first time you use the service, but you
11387
+ * may also create other clusters.</p>
11349
11388
  * @public
11350
11389
  */
11351
11390
  cluster?: string | undefined;
@@ -11704,6 +11743,56 @@ export interface StartTaskResponse {
11704
11743
  */
11705
11744
  failures?: Failure[] | undefined;
11706
11745
  }
11746
+ /**
11747
+ * <p>The service deploy ARN that you specified in the <code>StopServiceDeployment</code> doesn't exist. You can use <code>ListServiceDeployments</code> to retrieve the service deployment ARNs.</p>
11748
+ * @public
11749
+ */
11750
+ export declare class ServiceDeploymentNotFoundException extends __BaseException {
11751
+ readonly name: "ServiceDeploymentNotFoundException";
11752
+ readonly $fault: "client";
11753
+ /**
11754
+ * @internal
11755
+ */
11756
+ constructor(opts: __ExceptionOptionType<ServiceDeploymentNotFoundException, __BaseException>);
11757
+ }
11758
+ /**
11759
+ * @public
11760
+ * @enum
11761
+ */
11762
+ export declare const StopServiceDeploymentStopType: {
11763
+ readonly ABORT: "ABORT";
11764
+ readonly ROLLBACK: "ROLLBACK";
11765
+ };
11766
+ /**
11767
+ * @public
11768
+ */
11769
+ export type StopServiceDeploymentStopType = (typeof StopServiceDeploymentStopType)[keyof typeof StopServiceDeploymentStopType];
11770
+ /**
11771
+ * @public
11772
+ */
11773
+ export interface StopServiceDeploymentRequest {
11774
+ /**
11775
+ * <p>The ARN of the service deployment that you want to stop.</p>
11776
+ * @public
11777
+ */
11778
+ serviceDeploymentArn: string | undefined;
11779
+ /**
11780
+ * <p>How you want Amazon ECS to stop the task. </p>
11781
+ * <p>The valid values are <code>ROLLBACK</code>.</p>
11782
+ * @public
11783
+ */
11784
+ stopType?: StopServiceDeploymentStopType | undefined;
11785
+ }
11786
+ /**
11787
+ * @public
11788
+ */
11789
+ export interface StopServiceDeploymentResponse {
11790
+ /**
11791
+ * <p>The ARN of the stopped service deployment.</p>
11792
+ * @public
11793
+ */
11794
+ serviceDeploymentArn?: string | undefined;
11795
+ }
11707
11796
  /**
11708
11797
  * @public
11709
11798
  */
@@ -11968,92 +12057,6 @@ export interface SubmitTaskStateChangeResponse {
11968
12057
  */
11969
12058
  acknowledgment?: string | undefined;
11970
12059
  }
11971
- /**
11972
- * @public
11973
- */
11974
- export interface TagResourceRequest {
11975
- /**
11976
- * <p>The Amazon Resource Name (ARN) of the resource to add tags to. Currently, the supported resources are
11977
- * Amazon ECS capacity providers, tasks, services, task definitions, clusters, and container
11978
- * instances.</p>
11979
- * <p>In order to tag a service that has the following ARN format, you need to migrate the
11980
- * service to the long ARN. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-arn-migration.html">Migrate an Amazon ECS short service ARN to a long ARN</a> in the <i>Amazon Elastic Container Service
11981
- * Developer Guide</i>.</p>
11982
- * <p>
11983
- * <code>arn:aws:ecs:region:aws_account_id:service/service-name</code>
11984
- * </p>
11985
- * <p>After the migration is complete, the service has the long ARN format, as shown below. Use this ARN to tag the service.</p>
11986
- * <p>
11987
- * <code>arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name</code>
11988
- * </p>
11989
- * <p>If you try to tag a service with a short ARN, you receive an <code>InvalidParameterException</code> error.</p>
11990
- * @public
11991
- */
11992
- resourceArn: string | undefined;
11993
- /**
11994
- * <p>The tags to add to the resource. A tag is an array of key-value pairs.</p>
11995
- * <p>The following basic restrictions apply to tags:</p>
11996
- * <ul>
11997
- * <li>
11998
- * <p>Maximum number of tags per resource - 50</p>
11999
- * </li>
12000
- * <li>
12001
- * <p>For each resource, each tag key must be unique, and each tag key can have only
12002
- * one value.</p>
12003
- * </li>
12004
- * <li>
12005
- * <p>Maximum key length - 128 Unicode characters in UTF-8</p>
12006
- * </li>
12007
- * <li>
12008
- * <p>Maximum value length - 256 Unicode characters in UTF-8</p>
12009
- * </li>
12010
- * <li>
12011
- * <p>If your tagging schema is used across multiple services and resources,
12012
- * remember that other services may have restrictions on allowed characters.
12013
- * Generally allowed characters are: letters, numbers, and spaces representable in
12014
- * UTF-8, and the following characters: + - = . _ : / @.</p>
12015
- * </li>
12016
- * <li>
12017
- * <p>Tag keys and values are case-sensitive.</p>
12018
- * </li>
12019
- * <li>
12020
- * <p>Do not use <code>aws:</code>, <code>AWS:</code>, or any upper or lowercase
12021
- * combination of such as a prefix for either keys or values as it is reserved for
12022
- * Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with
12023
- * this prefix do not count against your tags per resource limit.</p>
12024
- * </li>
12025
- * </ul>
12026
- * @public
12027
- */
12028
- tags: Tag[] | undefined;
12029
- }
12030
- /**
12031
- * @public
12032
- */
12033
- export interface TagResourceResponse {
12034
- }
12035
- /**
12036
- * @public
12037
- */
12038
- export interface UntagResourceRequest {
12039
- /**
12040
- * <p>The Amazon Resource Name (ARN) of the resource to delete tags from. Currently, the supported resources
12041
- * are Amazon ECS capacity providers, tasks, services, task definitions, clusters, and container
12042
- * instances.</p>
12043
- * @public
12044
- */
12045
- resourceArn: string | undefined;
12046
- /**
12047
- * <p>The keys of the tags to be removed.</p>
12048
- * @public
12049
- */
12050
- tagKeys: string[] | undefined;
12051
- }
12052
- /**
12053
- * @public
12054
- */
12055
- export interface UntagResourceResponse {
12056
- }
12057
12060
  /**
12058
12061
  * @internal
12059
12062
  */
@@ -1,6 +1,93 @@
1
1
  import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
2
2
  import { ECSServiceException as __BaseException } from "./ECSServiceException";
3
- import { AvailabilityZoneRebalancing, CapacityProvider, CapacityProviderStrategyItem, Cluster, ClusterConfiguration, ClusterServiceConnectDefaultsRequest, ClusterSetting, ContainerInstance, ContainerInstanceStatus, DeploymentConfiguration, Failure, LoadBalancer, ManagedDraining, ManagedScaling, ManagedTerminationProtection, NetworkConfiguration, PlacementConstraint, PlacementStrategy, PropagateTags, ProtectedTask, Scale, Service, ServiceConnectConfiguration, ServiceRegistry, ServiceVolumeConfiguration, TaskSet, VpcLatticeConfiguration } from "./models_0";
3
+ import { AvailabilityZoneRebalancing, CapacityProvider, CapacityProviderStrategyItem, Cluster, ClusterConfiguration, ClusterServiceConnectDefaultsRequest, ClusterSetting, ContainerInstance, ContainerInstanceStatus, DeploymentConfiguration, Failure, LoadBalancer, ManagedDraining, ManagedScaling, ManagedTerminationProtection, NetworkConfiguration, PlacementConstraint, PlacementStrategy, PropagateTags, ProtectedTask, Scale, Service, ServiceConnectConfiguration, ServiceRegistry, ServiceVolumeConfiguration, Tag, TaskSet, VpcLatticeConfiguration } from "./models_0";
4
+ /**
5
+ * @public
6
+ */
7
+ export interface TagResourceRequest {
8
+ /**
9
+ * <p>The Amazon Resource Name (ARN) of the resource to add tags to. Currently, the supported resources are
10
+ * Amazon ECS capacity providers, tasks, services, task definitions, clusters, and container
11
+ * instances.</p>
12
+ * <p>In order to tag a service that has the following ARN format, you need to migrate the
13
+ * service to the long ARN. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-arn-migration.html">Migrate an Amazon ECS short service ARN to a long ARN</a> in the <i>Amazon Elastic Container Service
14
+ * Developer Guide</i>.</p>
15
+ * <p>
16
+ * <code>arn:aws:ecs:region:aws_account_id:service/service-name</code>
17
+ * </p>
18
+ * <p>After the migration is complete, the service has the long ARN format, as shown below. Use this ARN to tag the service.</p>
19
+ * <p>
20
+ * <code>arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name</code>
21
+ * </p>
22
+ * <p>If you try to tag a service with a short ARN, you receive an
23
+ * <code>InvalidParameterException</code> error.</p>
24
+ * @public
25
+ */
26
+ resourceArn: string | undefined;
27
+ /**
28
+ * <p>The tags to add to the resource. A tag is an array of key-value pairs.</p>
29
+ * <p>The following basic restrictions apply to tags:</p>
30
+ * <ul>
31
+ * <li>
32
+ * <p>Maximum number of tags per resource - 50</p>
33
+ * </li>
34
+ * <li>
35
+ * <p>For each resource, each tag key must be unique, and each tag key can have only
36
+ * one value.</p>
37
+ * </li>
38
+ * <li>
39
+ * <p>Maximum key length - 128 Unicode characters in UTF-8</p>
40
+ * </li>
41
+ * <li>
42
+ * <p>Maximum value length - 256 Unicode characters in UTF-8</p>
43
+ * </li>
44
+ * <li>
45
+ * <p>If your tagging schema is used across multiple services and resources,
46
+ * remember that other services may have restrictions on allowed characters.
47
+ * Generally allowed characters are: letters, numbers, and spaces representable in
48
+ * UTF-8, and the following characters: + - = . _ : / @.</p>
49
+ * </li>
50
+ * <li>
51
+ * <p>Tag keys and values are case-sensitive.</p>
52
+ * </li>
53
+ * <li>
54
+ * <p>Do not use <code>aws:</code>, <code>AWS:</code>, or any upper or lowercase
55
+ * combination of such as a prefix for either keys or values as it is reserved for
56
+ * Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with
57
+ * this prefix do not count against your tags per resource limit.</p>
58
+ * </li>
59
+ * </ul>
60
+ * @public
61
+ */
62
+ tags: Tag[] | undefined;
63
+ }
64
+ /**
65
+ * @public
66
+ */
67
+ export interface TagResourceResponse {
68
+ }
69
+ /**
70
+ * @public
71
+ */
72
+ export interface UntagResourceRequest {
73
+ /**
74
+ * <p>The Amazon Resource Name (ARN) of the resource to delete tags from. Currently, the supported resources
75
+ * are Amazon ECS capacity providers, tasks, services, task definitions, clusters, and container
76
+ * instances.</p>
77
+ * @public
78
+ */
79
+ resourceArn: string | undefined;
80
+ /**
81
+ * <p>The keys of the tags to be removed.</p>
82
+ * @public
83
+ */
84
+ tagKeys: string[] | undefined;
85
+ }
86
+ /**
87
+ * @public
88
+ */
89
+ export interface UntagResourceResponse {
90
+ }
4
91
  /**
5
92
  * <p>The details of the Auto Scaling group capacity provider to update.</p>
6
93
  * @public
@@ -44,6 +44,7 @@ import { RegisterContainerInstanceCommandInput, RegisterContainerInstanceCommand
44
44
  import { RegisterTaskDefinitionCommandInput, RegisterTaskDefinitionCommandOutput } from "../commands/RegisterTaskDefinitionCommand";
45
45
  import { RunTaskCommandInput, RunTaskCommandOutput } from "../commands/RunTaskCommand";
46
46
  import { StartTaskCommandInput, StartTaskCommandOutput } from "../commands/StartTaskCommand";
47
+ import { StopServiceDeploymentCommandInput, StopServiceDeploymentCommandOutput } from "../commands/StopServiceDeploymentCommand";
47
48
  import { StopTaskCommandInput, StopTaskCommandOutput } from "../commands/StopTaskCommand";
48
49
  import { SubmitAttachmentStateChangesCommandInput, SubmitAttachmentStateChangesCommandOutput } from "../commands/SubmitAttachmentStateChangesCommand";
49
50
  import { SubmitContainerStateChangeCommandInput, SubmitContainerStateChangeCommandOutput } from "../commands/SubmitContainerStateChangeCommand";
@@ -235,6 +236,10 @@ export declare const se_RunTaskCommand: (input: RunTaskCommandInput, context: __
235
236
  * serializeAws_json1_1StartTaskCommand
236
237
  */
237
238
  export declare const se_StartTaskCommand: (input: StartTaskCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
239
+ /**
240
+ * serializeAws_json1_1StopServiceDeploymentCommand
241
+ */
242
+ export declare const se_StopServiceDeploymentCommand: (input: StopServiceDeploymentCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
238
243
  /**
239
244
  * serializeAws_json1_1StopTaskCommand
240
245
  */
@@ -471,6 +476,10 @@ export declare const de_RunTaskCommand: (output: __HttpResponse, context: __Serd
471
476
  * deserializeAws_json1_1StartTaskCommand
472
477
  */
473
478
  export declare const de_StartTaskCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<StartTaskCommandOutput>;
479
+ /**
480
+ * deserializeAws_json1_1StopServiceDeploymentCommand
481
+ */
482
+ export declare const de_StopServiceDeploymentCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<StopServiceDeploymentCommandOutput>;
474
483
  /**
475
484
  * deserializeAws_json1_1StopTaskCommand
476
485
  */
@@ -175,6 +175,10 @@ import {
175
175
  StartTaskCommandInput,
176
176
  StartTaskCommandOutput,
177
177
  } from "./commands/StartTaskCommand";
178
+ import {
179
+ StopServiceDeploymentCommandInput,
180
+ StopServiceDeploymentCommandOutput,
181
+ } from "./commands/StopServiceDeploymentCommand";
178
182
  import {
179
183
  StopTaskCommandInput,
180
184
  StopTaskCommandOutput,
@@ -821,6 +825,19 @@ export interface ECS {
821
825
  options: __HttpHandlerOptions,
822
826
  cb: (err: any, data?: StartTaskCommandOutput) => void
823
827
  ): void;
828
+ stopServiceDeployment(
829
+ args: StopServiceDeploymentCommandInput,
830
+ options?: __HttpHandlerOptions
831
+ ): Promise<StopServiceDeploymentCommandOutput>;
832
+ stopServiceDeployment(
833
+ args: StopServiceDeploymentCommandInput,
834
+ cb: (err: any, data?: StopServiceDeploymentCommandOutput) => void
835
+ ): void;
836
+ stopServiceDeployment(
837
+ args: StopServiceDeploymentCommandInput,
838
+ options: __HttpHandlerOptions,
839
+ cb: (err: any, data?: StopServiceDeploymentCommandOutput) => void
840
+ ): void;
824
841
  stopTask(
825
842
  args: StopTaskCommandInput,
826
843
  options?: __HttpHandlerOptions