@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.
- package/README.md +8 -0
- package/dist-cjs/index.js +77 -0
- package/dist-es/ECS.js +2 -0
- package/dist-es/commands/StopServiceDeploymentCommand.js +22 -0
- package/dist-es/commands/index.js +1 -0
- package/dist-es/models/models_0.js +18 -0
- package/dist-es/protocols/Aws_json1_1.js +32 -1
- package/dist-types/ECS.d.ts +7 -0
- package/dist-types/ECSClient.d.ts +3 -2
- package/dist-types/commands/DeleteAccountSettingCommand.d.ts +2 -2
- package/dist-types/commands/DescribeServiceDeploymentsCommand.d.ts +2 -3
- package/dist-types/commands/ListAccountSettingsCommand.d.ts +2 -2
- package/dist-types/commands/ListServiceDeploymentsCommand.d.ts +2 -2
- package/dist-types/commands/PutAccountSettingCommand.d.ts +2 -2
- package/dist-types/commands/PutAccountSettingDefaultCommand.d.ts +2 -2
- package/dist-types/commands/StopServiceDeploymentCommand.d.ts +149 -0
- package/dist-types/commands/TagResourceCommand.d.ts +1 -1
- package/dist-types/commands/UntagResourceCommand.d.ts +1 -1
- package/dist-types/commands/index.d.ts +1 -0
- package/dist-types/models/models_0.d.ts +147 -144
- package/dist-types/models/models_1.d.ts +88 -1
- package/dist-types/protocols/Aws_json1_1.d.ts +9 -0
- package/dist-types/ts3.4/ECS.d.ts +17 -0
- package/dist-types/ts3.4/ECSClient.d.ts +6 -0
- package/dist-types/ts3.4/commands/StopServiceDeploymentCommand.d.ts +51 -0
- package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/index.d.ts +1 -0
- package/dist-types/ts3.4/models/models_0.d.ts +25 -10
- package/dist-types/ts3.4/models/models_1.d.ts +11 -0
- package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +12 -0
- 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
|
-
* (
|
|
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
|
|
1312
|
-
*
|
|
1313
|
-
* percent value is not used. The value is
|
|
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
|
|
1568
|
-
*
|
|
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
|
|
1572
|
-
*
|
|
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
|
|
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
|
|
1922
|
-
* the flow of logs from
|
|
1923
|
-
*
|
|
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
|
|
1932
|
-
*
|
|
1933
|
-
*
|
|
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
|
-
*
|
|
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
|
|
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
|
|
4598
|
-
* and 300 seconds. The default value is 30 seconds. This value applies only when
|
|
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
|
|
4605
|
-
* failure. You may specify between 2 and 60 seconds. The default value is 5.
|
|
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
|
|
4636
|
-
* <code>drop</code> request parameters. For information about the
|
|
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>
|
|
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
|
|
4641
|
-
* default Docker capabilities. The capabilities specified in the
|
|
4642
|
-
*
|
|
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
|
|
4652
|
-
* the capabilities specified in the <code>add</code> request
|
|
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
|
|
4656
|
-
*
|
|
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
|
|
4660
|
-
*
|
|
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
|
|
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
|
|
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
|
|
8701
|
-
* optional. Supported values are between <code>128</code> CPU units
|
|
8702
|
-
*
|
|
8703
|
-
* a value, the parameter is ignored.</p>
|
|
8704
|
-
* <p>If you're using the Fargate launch type, this field is required. You
|
|
8705
|
-
* one of the following values. These values determine the range of supported
|
|
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
|
|
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
|
|
11056
|
-
* to be accepted from the task's containers. The default value is
|
|
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
|