@aws-sdk/client-ecs 3.699.0 → 3.703.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.
@@ -30,7 +30,7 @@ declare const DeleteCapacityProviderCommand_base: {
30
30
  * <p>Deletes the specified capacity provider.</p>
31
31
  * <note>
32
32
  * <p>The <code>FARGATE</code> and <code>FARGATE_SPOT</code> capacity providers are reserved and can't
33
- * be deleted. You can disassociate them from a cluster using either <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProviderProviders.html">PutCapacityProviderProviders</a> or by deleting the cluster.</p>
33
+ * be deleted. You can disassociate them from a cluster using either <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html">PutClusterCapacityProviders</a> or by deleting the cluster.</p>
34
34
  * </note>
35
35
  * <p>Prior to a capacity provider being deleted, the capacity provider must be removed from the capacity
36
36
  * provider strategy from all services. The <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html">UpdateService</a> API can be used to
@@ -28,6 +28,7 @@ declare const DescribeClustersCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <p>Describes one or more of your clusters.</p>
31
+ * <p> For CLI examples, see <a href="https://github.com/aws/aws-cli/blob/develop/awscli/examples/ecs/describe-clusters.rst">describe-clusters.rst</a> on GitHub.</p>
31
32
  * @example
32
33
  * Use a bare-bones client and the command you need to make an API call.
33
34
  * ```javascript
@@ -696,7 +696,18 @@ export declare const ClusterSettingName: {
696
696
  export type ClusterSettingName = (typeof ClusterSettingName)[keyof typeof ClusterSettingName];
697
697
  /**
698
698
  * <p>The settings to use when creating a cluster. This parameter is used to turn on CloudWatch Container
699
+ * Insights with enhanced observability or CloudWatch Container
699
700
  * Insights for a cluster.</p>
701
+ * <p>Container Insights with enhanced observability provides all the Container Insights metrics,
702
+ * plus additional task and container metrics. This version supports enhanced observability
703
+ * for Amazon ECS clusters using the Amazon EC2 and Fargate launch types. After you configure
704
+ * Container Insights with enhanced observability on Amazon ECS, Container Insights
705
+ * auto-collects detailed infrastructure telemetry from the cluster level down to the container
706
+ * level in your environment and displays these critical performance data in curated
707
+ * dashboards removing the heavy lifting in observability set-up. </p>
708
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html">Monitor
709
+ * Amazon ECS containers using Container Insights with enhanced observability</a> in the
710
+ * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
700
711
  * @public
701
712
  */
702
713
  export interface ClusterSetting {
@@ -706,12 +717,14 @@ export interface ClusterSetting {
706
717
  */
707
718
  name?: ClusterSettingName | undefined;
708
719
  /**
709
- * <p>The value to set for the cluster setting. The supported values are <code>enabled</code> and
710
- * <code>disabled</code>. </p>
711
- * <p>If you set <code>name</code> to <code>containerInsights</code> and <code>value</code> to
712
- * <code>enabled</code>, CloudWatch Container Insights will be on for the cluster, otherwise it will be off
713
- * unless the <code>containerInsights</code> account setting is turned on. If a cluster value is
714
- * specified, it will override the <code>containerInsights</code> value set with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSetting.html">PutAccountSetting</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSettingDefault.html">PutAccountSettingDefault</a>.</p>
720
+ * <p>The value to set for the cluster setting. The supported values are <code>enhanced</code>,
721
+ * <code>enabled</code>, and <code>disabled</code>. </p>
722
+ * <p>To use Container Insights with enhanced observability, set the
723
+ * <code>containerInsights</code> account setting to <code>enhanced</code>.</p>
724
+ * <p>To use Container Insights, set the <code>containerInsights</code> account setting to
725
+ * <code>enabled</code>.</p>
726
+ * <p>If a cluster value is specified, it will override the <code>containerInsights</code> value
727
+ * set with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSetting.html">PutAccountSetting</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSettingDefault.html">PutAccountSettingDefault</a>.</p>
715
728
  * @public
716
729
  */
717
730
  value?: string | undefined;
@@ -1479,7 +1492,7 @@ export interface AwsVpcConfiguration {
1479
1492
  securityGroups?: string[] | undefined;
1480
1493
  /**
1481
1494
  * <p>Whether the task's elastic network interface receives a public IP address. The default value is
1482
- * <code>DISABLED</code>.</p>
1495
+ * <code>ENABLED</code>.</p>
1483
1496
  * @public
1484
1497
  */
1485
1498
  assignPublicIp?: AssignPublicIp | undefined;
@@ -5716,8 +5729,9 @@ export interface ContainerDefinition {
5716
5729
  */
5717
5730
  export interface EphemeralStorage {
5718
5731
  /**
5719
- * <p>The total amount, in GiB, of ephemeral storage to set for the task. The minimum supported value is
5720
- * <code>20</code> GiB and the maximum supported value is <code>200</code> GiB.</p>
5732
+ * <p>The total amount, in GiB, of ephemeral storage to set for the task. The minimum supported
5733
+ * value is <code>21</code> GiB and the maximum supported value is <code>200</code>
5734
+ * GiB.</p>
5721
5735
  * @public
5722
5736
  */
5723
5737
  sizeInGiB: number | undefined;
@@ -7741,8 +7755,8 @@ export type TaskField = (typeof TaskField)[keyof typeof TaskField];
7741
7755
  export interface DescribeTasksRequest {
7742
7756
  /**
7743
7757
  * <p>The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task or tasks to describe.
7744
- * If you do not specify a cluster, the default cluster is assumed. This parameter is required if the task or tasks you are describing were
7745
- * launched in any cluster other than the default cluster.</p>
7758
+ * If you do not specify a cluster, the default cluster is assumed. This parameter is required. If you do not specify a value, the
7759
+ * <code>default</code> cluster is used.</p>
7746
7760
  * @public
7747
7761
  */
7748
7762
  cluster?: string | undefined;
@@ -9144,8 +9158,11 @@ export interface ListServiceDeploymentsRequest {
9144
9158
  */
9145
9159
  service: string | undefined;
9146
9160
  /**
9147
- * <p>The cluster that hosts the service. This can either be the cluster name or ARN. Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performanceIf you don't
9148
- * specify a cluster, <code>deault</code> is used.</p>
9161
+ * <p>The cluster that hosts the service. This can either be the cluster name or ARN. Starting
9162
+ * April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic
9163
+ * Inference (EI), and will help current customers migrate their workloads to options that
9164
+ * offer better price and performanceIf you don't specify a cluster, <code>default</code>
9165
+ * is used.</p>
9149
9166
  * @public
9150
9167
  */
9151
9168
  cluster?: string | undefined;
@@ -9738,12 +9755,20 @@ export interface PutAccountSettingRequest {
9738
9755
  * </li>
9739
9756
  * <li>
9740
9757
  * <p>
9741
- * <code>containerInsights</code> - When modified, the default setting indicating whether Amazon Web Services
9742
- * CloudWatch Container Insights is turned on for your clusters is changed. If
9743
- * <code>containerInsights</code> is turned on, any new clusters that are created will have
9744
- * Container Insights turned on unless you disable it during cluster creation. For more
9745
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html">CloudWatch Container
9746
- * Insights</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
9758
+ * <code>containerInsights</code> - Container Insights with enhanced observability provides
9759
+ * all the Container Insights metrics, plus additional task and container metrics.
9760
+ * This version supports enhanced observability for Amazon ECS clusters using the Amazon EC2
9761
+ * and Fargate launch types. After you configure Container Insights with enhanced
9762
+ * observability on Amazon ECS, Container Insights auto-collects detailed infrastructure
9763
+ * telemetry from the cluster level down to the container level in your environment and
9764
+ * displays these critical performance data in curated dashboards removing the
9765
+ * heavy lifting in observability set-up. </p>
9766
+ * <p>To use Container Insights with enhanced observability, set the
9767
+ * <code>containerInsights</code> account setting to
9768
+ * <code>enhanced</code>.</p>
9769
+ * <p>To use Container Insights, set the <code>containerInsights</code> account setting to
9770
+ * <code>enabled</code>.</p>
9771
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html">Monitor Amazon ECS containers using Container Insights with enhanced observability</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
9747
9772
  * </li>
9748
9773
  * <li>
9749
9774
  * <p>
@@ -9784,10 +9809,11 @@ export interface PutAccountSettingRequest {
9784
9809
  */
9785
9810
  name: SettingName | undefined;
9786
9811
  /**
9787
- * <p>The account setting value for the specified principal ARN. Accepted values are <code>enabled</code>,
9788
- * <code>disabled</code>, <code>on</code>, and <code>off</code>.</p>
9789
- * <p>When you specify <code>fargateTaskRetirementWaitPeriod</code> for the <code>name</code>, the
9790
- * following are the valid values:</p>
9812
+ * <p>The account setting value for the specified principal ARN. Accepted values are
9813
+ * <code>enabled</code>, <code>disabled</code>, <code>enhanced</code>,
9814
+ * <code>on</code>, and <code>off</code>.</p>
9815
+ * <p>When you specify <code>fargateTaskRetirementWaitPeriod</code> for the
9816
+ * <code>name</code>, the following are the valid values:</p>
9791
9817
  * <ul>
9792
9818
  * <li>
9793
9819
  * <p>
@@ -9878,12 +9904,20 @@ export interface PutAccountSettingDefaultRequest {
9878
9904
  * </li>
9879
9905
  * <li>
9880
9906
  * <p>
9881
- * <code>containerInsights</code> - When modified, the default setting indicating whether Amazon Web Services
9882
- * CloudWatch Container Insights is turned on for your clusters is changed. If
9883
- * <code>containerInsights</code> is turned on, any new clusters that are created will have
9884
- * Container Insights turned on unless you disable it during cluster creation. For more
9885
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html">CloudWatch Container
9886
- * Insights</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
9907
+ * <code>containerInsights</code> - Container Insights with enhanced observability provides
9908
+ * all the Container Insights metrics, plus additional task and container metrics.
9909
+ * This version supports enhanced observability for Amazon ECS clusters using the Amazon EC2
9910
+ * and Fargate launch types. After you configure Container Insights with enhanced
9911
+ * observability on Amazon ECS, Container Insights auto-collects detailed infrastructure
9912
+ * telemetry from the cluster level down to the container level in your environment and
9913
+ * displays these critical performance data in curated dashboards removing the
9914
+ * heavy lifting in observability set-up. </p>
9915
+ * <p>To use Container Insights with enhanced observability, set the
9916
+ * <code>containerInsights</code> account setting to
9917
+ * <code>enhanced</code>.</p>
9918
+ * <p>To use Container Insights, set the <code>containerInsights</code> account
9919
+ * setting to <code>enabled</code>.</p>
9920
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html">Monitor Amazon ECS containers using Container Insights with enhanced observability</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
9887
9921
  * </li>
9888
9922
  * <li>
9889
9923
  * <p>
@@ -9929,10 +9963,11 @@ export interface PutAccountSettingDefaultRequest {
9929
9963
  */
9930
9964
  name: SettingName | undefined;
9931
9965
  /**
9932
- * <p>The account setting value for the specified principal ARN. Accepted values are <code>enabled</code>,
9933
- * <code>disabled</code>, <code>on</code>, and <code>off</code>.</p>
9934
- * <p>When you specify <code>fargateTaskRetirementWaitPeriod</code> for the <code>name</code>, the
9935
- * following are the valid values:</p>
9966
+ * <p>The account setting value for the specified principal ARN. Accepted values are
9967
+ * <code>enabled</code>, <code>disabled</code>, <code>on</code>, <code>enhanced</code>,
9968
+ * and <code>off</code>.</p>
9969
+ * <p>When you specify <code>fargateTaskRetirementWaitPeriod</code> for the
9970
+ * <code>name</code>, the following are the valid values:</p>
9936
9971
  * <ul>
9937
9972
  * <li>
9938
9973
  * <p>
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-ecs",
3
3
  "description": "AWS SDK for JavaScript Ecs Client for Node.js, Browser and React Native",
4
- "version": "3.699.0",
4
+ "version": "3.703.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-ecs",