@aws-sdk/client-ecs 3.489.0 → 3.490.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.
@@ -89,8 +89,8 @@ export interface ManagedScaling {
89
89
  * <code>100</code>. For example, if you want the capacity provider to maintain 10%
90
90
  * spare capacity, then that means the utilization is 90%, so use a
91
91
  * <code>targetCapacity</code> of <code>90</code>. The default value of
92
- * <code>100</code> percent results in the Amazon EC2 instances in your Auto Scaling group being
93
- * completely used.</p>
92
+ * <code>100</code> percent results in the Amazon EC2 instances in your Auto Scaling group
93
+ * being completely used.</p>
94
94
  */
95
95
  targetCapacity?: number;
96
96
  /**
@@ -108,8 +108,8 @@ export interface ManagedScaling {
108
108
  minimumScalingStepSize?: number;
109
109
  /**
110
110
  * @public
111
- * <p>The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in
112
- * process is not affected by this parameter. If this parameter is omitted, the default
111
+ * <p>The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale
112
+ * in process is not affected by this parameter. If this parameter is omitted, the default
113
113
  * value of <code>10000</code> is used.</p>
114
114
  */
115
115
  maximumScalingStepSize?: number;
@@ -140,7 +140,8 @@ export type ManagedTerminationProtection = (typeof ManagedTerminationProtection)
140
140
  export interface AutoScalingGroupProvider {
141
141
  /**
142
142
  * @public
143
- * <p>The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.</p>
143
+ * <p>The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group
144
+ * name.</p>
144
145
  */
145
146
  autoScalingGroupArn: string | undefined;
146
147
  /**
@@ -157,9 +158,9 @@ export interface AutoScalingGroupProvider {
157
158
  * <p>When using managed termination protection, managed scaling must also be used
158
159
  * otherwise managed termination protection doesn't work.</p>
159
160
  * </important>
160
- * <p>When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto
161
- * Scaling group that contain tasks from being terminated during a scale-in action. The
162
- * Auto Scaling group and each instance in the Auto Scaling group must have instance
161
+ * <p>When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an
162
+ * Auto Scaling group that contain tasks from being terminated during a scale-in action.
163
+ * The Auto Scaling group and each instance in the Auto Scaling group must have instance
163
164
  * protection from scale-in actions on as well. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection">Instance Protection</a> in the <i>Auto Scaling User Guide</i>.</p>
164
165
  * <p>When managed termination protection is off, your Amazon EC2 instances aren't protected from
165
166
  * termination when the Auto Scaling group scales in.</p>
@@ -168,7 +169,6 @@ export interface AutoScalingGroupProvider {
168
169
  /**
169
170
  * @public
170
171
  * <p>The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.</p>
171
- * <p>The default is <code>ENABLED</code>.</p>
172
172
  */
173
173
  managedDraining?: ManagedDraining;
174
174
  }
@@ -478,8 +478,8 @@ export interface ExecuteCommandLogConfiguration {
478
478
  cloudWatchLogGroupName?: string;
479
479
  /**
480
480
  * @public
481
- * <p>Determines whether to use encryption on the CloudWatch logs. If not specified, encryption
482
- * will be off.</p>
481
+ * <p>Determines whether to use encryption on the CloudWatch logs. If not specified,
482
+ * encryption will be off.</p>
483
483
  */
484
484
  cloudWatchEncryptionEnabled?: boolean;
485
485
  /**
@@ -658,8 +658,8 @@ export interface ClusterServiceConnectDefaultsRequest {
658
658
  * <p>If you update the cluster with an empty string <code>""</code> for the namespace name,
659
659
  * the cluster configuration for Service Connect is removed. Note that the namespace will
660
660
  * remain in Cloud Map and must be deleted separately.</p>
661
- * <p>For more information about Cloud Map, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html">Working
662
- * with Services</a> in the <i>Cloud Map Developer Guide</i>.</p>
661
+ * <p>For more information about Cloud Map, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html">Working with Services</a>
662
+ * in the <i>Cloud Map Developer Guide</i>.</p>
663
663
  */
664
664
  namespace: string | undefined;
665
665
  }
@@ -687,9 +687,9 @@ export interface ClusterSetting {
687
687
  name?: ClusterSettingName;
688
688
  /**
689
689
  * @public
690
- * <p>The value to set for the cluster setting. The supported values are <code>enabled</code> and
691
- * <code>disabled</code>. </p>
692
- * <p>If you set <code>name</code> to <code>containerInsights</code> and <code>value</code>
690
+ * <p>The value to set for the cluster setting. The supported values are
691
+ * <code>enabled</code> and <code>disabled</code>. </p>
692
+ * <p>If you set <code>name</code> to <code>containerInsights</code> and <code>value</code>
693
693
  * to <code>enabled</code>, CloudWatch Container Insights will be on for the cluster, otherwise
694
694
  * it will be off unless the <code>containerInsights</code> account setting is turned on.
695
695
  * If a cluster value is specified, it will override the <code>containerInsights</code>
@@ -762,26 +762,25 @@ export interface CreateClusterRequest {
762
762
  * <p>The short name of one or more capacity providers to associate with the cluster. A
763
763
  * capacity provider must be associated with a cluster before it can be included as part of
764
764
  * the default capacity provider strategy of the cluster or used in a capacity provider
765
- * strategy when calling the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html">CreateService</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html">RunTask</a>
766
- * actions.</p>
765
+ * strategy when calling the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html">CreateService</a> or
766
+ * <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html">RunTask</a> actions.</p>
767
767
  * <p>If specifying a capacity provider that uses an Auto Scaling group, the capacity
768
768
  * provider must be created but not associated with another cluster. New Auto Scaling group
769
- * capacity providers can be created with the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html">CreateCapacityProvider</a> API
770
- * operation.</p>
769
+ * capacity providers can be created with the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html">CreateCapacityProvider</a> API operation.</p>
771
770
  * <p>To use a Fargate capacity provider, specify either the <code>FARGATE</code> or
772
771
  * <code>FARGATE_SPOT</code> capacity providers. The Fargate capacity providers are
773
772
  * available to all accounts and only need to be associated with a cluster to be
774
773
  * used.</p>
775
- * <p>The <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProvider.html">PutCapacityProvider</a> API operation is used to update the
776
- * list of available capacity providers for a cluster after the cluster is created.</p>
774
+ * <p>The <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProvider.html">PutCapacityProvider</a> API operation is used to update the list of available
775
+ * capacity providers for a cluster after the cluster is created.</p>
777
776
  */
778
777
  capacityProviders?: string[];
779
778
  /**
780
779
  * @public
781
780
  * <p>The capacity provider strategy to set as the default for the cluster. After a default
782
- * capacity provider strategy is set for a cluster, when you call the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html">CreateService</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html">RunTask</a> APIs with no capacity
783
- * provider strategy or launch type specified, the default capacity provider strategy for
784
- * the cluster is used.</p>
781
+ * capacity provider strategy is set for a cluster, when you call the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html">CreateService</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html">RunTask</a> APIs with no
782
+ * capacity provider strategy or launch type specified, the default capacity provider
783
+ * strategy for the cluster is used.</p>
785
784
  * <p>If a default capacity provider strategy isn't defined for a cluster when it was
786
785
  * created, it can be defined later with the <a>PutClusterCapacityProviders</a>
787
786
  * API operation.</p>
@@ -834,7 +833,8 @@ export interface Attachment {
834
833
  id?: string;
835
834
  /**
836
835
  * @public
837
- * <p>The type of the attachment, such as <code>ElasticNetworkInterface</code>.</p>
836
+ * <p>The type of the attachment, such as <code>ElasticNetworkInterface</code>,
837
+ * <code>Service Connect</code>, and <code>AmazonElasticBlockStorage</code>.</p>
838
838
  */
839
839
  type?: string;
840
840
  /**
@@ -847,8 +847,16 @@ export interface Attachment {
847
847
  status?: string;
848
848
  /**
849
849
  * @public
850
- * <p>Details of the attachment. For elastic network interfaces, this includes the network
851
- * interface ID, the MAC address, the subnet ID, and the private IPv4 address.</p>
850
+ * <p>Details of the attachment.</p>
851
+ * <p>For elastic network interfaces, this includes the network interface ID, the MAC
852
+ * address, the subnet ID, and the private IPv4 address.</p>
853
+ * <p>For Service Connect services, this includes <code>portName</code>,
854
+ * <code>clientAliases</code>, <code>discoveryName</code>, and
855
+ * <code>ingressPortOverride</code>.</p>
856
+ * <p>For elastic block storage, this includes <code>roleArn</code>, <code>encrypted</code>,
857
+ * <code>filesystemType</code>, <code>iops</code>, <code>kmsKeyId</code>,
858
+ * <code>sizeInGiB</code>, <code>snapshotId</code>, <code>tagSpecifications</code>,
859
+ * <code>throughput</code>, and <code>volumeType</code>.</p>
852
860
  */
853
861
  details?: KeyValuePair[];
854
862
  }
@@ -1027,8 +1035,8 @@ export interface Cluster {
1027
1035
  tags?: Tag[];
1028
1036
  /**
1029
1037
  * @public
1030
- * <p>The settings for the cluster. This parameter indicates whether CloudWatch Container Insights is on
1031
- * or off for a cluster.</p>
1038
+ * <p>The settings for the cluster. This parameter indicates whether CloudWatch Container Insights
1039
+ * is on or off for a cluster.</p>
1032
1040
  */
1033
1041
  settings?: ClusterSetting[];
1034
1042
  /**
@@ -1126,9 +1134,9 @@ export declare class ClusterNotFoundException extends __BaseException {
1126
1134
  * <p>One of the methods which provide a way for you to quickly identify when a deployment
1127
1135
  * has failed, and then to optionally roll back the failure to the last working
1128
1136
  * deployment.</p>
1129
- * <p>When the alarms are generated, Amazon ECS sets the service deployment to failed. Set the rollback
1130
- * parameter to have Amazon ECS to roll back your service to the last completed deployment
1131
- * after a failure.</p>
1137
+ * <p>When the alarms are generated, Amazon ECS sets the service deployment to failed. Set the
1138
+ * rollback parameter to have Amazon ECS to roll back your service to the last completed
1139
+ * deployment after a failure.</p>
1132
1140
  * <p>You can only use the <code>DeploymentAlarms</code> method to detect failures when the
1133
1141
  * <code>DeploymentController</code> is set to <code>ECS</code> (rolling
1134
1142
  * update).</p>
@@ -1145,7 +1153,8 @@ export interface DeploymentAlarms {
1145
1153
  alarmNames: string[] | undefined;
1146
1154
  /**
1147
1155
  * @public
1148
- * <p>Determines whether to use the CloudWatch alarm option in the service deployment process.</p>
1156
+ * <p>Determines whether to use the CloudWatch alarm option in the service deployment
1157
+ * process.</p>
1149
1158
  */
1150
1159
  enable: boolean | undefined;
1151
1160
  /**
@@ -1163,12 +1172,13 @@ export interface DeploymentAlarms {
1163
1172
  * update (<code>ECS</code>) deployment type.</p>
1164
1173
  * </note>
1165
1174
  * <p>The <b>deployment circuit breaker</b> determines whether a
1166
- * service deployment will fail if the service can't reach a steady state. If it is turned on, a
1167
- * service deployment will transition to a failed state and stop launching new tasks. You
1168
- * can also configure Amazon ECS to roll back your service to the last completed deployment
1175
+ * service deployment will fail if the service can't reach a steady state. If it is turned
1176
+ * on, a service deployment will transition to a failed state and stop launching new tasks.
1177
+ * You can also configure Amazon ECS to roll back your service to the last completed deployment
1169
1178
  * after a failure. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html">Rolling
1170
1179
  * update</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
1171
- * <p>For more information about API failure reasons, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/api_failures_messages.html">API failure reasons</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
1180
+ * <p>For more information about API failure reasons, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/api_failures_messages.html">API failure
1181
+ * reasons</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
1172
1182
  */
1173
1183
  export interface DeploymentCircuitBreaker {
1174
1184
  /**
@@ -1197,12 +1207,13 @@ export interface DeploymentConfiguration {
1197
1207
  * update (<code>ECS</code>) deployment type.</p>
1198
1208
  * </note>
1199
1209
  * <p>The <b>deployment circuit breaker</b> determines whether a
1200
- * service deployment will fail if the service can't reach a steady state. If you use the deployment
1201
- * circuit breaker, a service deployment will transition to a failed state and
1202
- * stop launching new tasks. If you use the rollback option, when a service deployment fails, the
1203
- * service is rolled back to the last deployment that completed successfully. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html">Rolling
1210
+ * service deployment will fail if the service can't reach a steady state. If you use the
1211
+ * deployment circuit breaker, a service deployment will transition to a failed state and
1212
+ * stop launching new tasks. If you use the rollback option, when a service deployment
1213
+ * fails, the service is rolled back to the last deployment that completed successfully.
1214
+ * For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html">Rolling
1204
1215
  * update</a> in the <i>Amazon Elastic Container Service Developer
1205
- * Guide</i>
1216
+ * Guide</i>
1206
1217
  * </p>
1207
1218
  */
1208
1219
  deploymentCircuitBreaker?: DeploymentCircuitBreaker;
@@ -1620,9 +1631,10 @@ export interface Secret {
1620
1631
  /**
1621
1632
  * @public
1622
1633
  * <p>The secret to expose to the container. The supported values are either the full ARN
1623
- * of the Secrets Manager secret or the full ARN of the parameter in the SSM Parameter
1624
- * Store.</p>
1625
- * <p>For information about the require Identity and Access Management permissions, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-secrets.html#secrets-iam">Required IAM permissions for Amazon ECS secrets</a> (for Secrets Manager) or <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-parameters.html">Required IAM permissions for Amazon ECS secrets</a> (for Systems Manager Parameter
1634
+ * of the Secrets Manager secret or the full ARN of the parameter in the SSM
1635
+ * Parameter Store.</p>
1636
+ * <p>For information about the require Identity and Access Management permissions, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-secrets.html#secrets-iam">Required IAM permissions for Amazon ECS secrets</a> (for Secrets Manager) or
1637
+ * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-parameters.html">Required IAM permissions for Amazon ECS secrets</a> (for Systems Manager Parameter
1626
1638
  * store) in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
1627
1639
  * <note>
1628
1640
  * <p>If the SSM Parameter Store parameter exists in the same Region as the task
@@ -1650,9 +1662,9 @@ export interface Secret {
1650
1662
  * containers.</p>
1651
1663
  * <ul>
1652
1664
  * <li>
1653
- * <p>Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon.
1654
- * Additional log drivers may be available in future releases of the Amazon ECS
1655
- * container agent.</p>
1665
+ * <p>Amazon ECS currently supports a subset of the logging drivers available to the
1666
+ * Docker daemon. Additional log drivers may be available in future releases of the
1667
+ * Amazon ECS container agent.</p>
1656
1668
  * <p>For tasks on Fargate, the supported log drivers are <code>awslogs</code>,
1657
1669
  * <code>splunk</code>, and <code>awsfirelens</code>.</p>
1658
1670
  * <p>For tasks hosted on Amazon EC2 instances, the supported log drivers are
@@ -1820,8 +1832,8 @@ export interface ServiceConnectConfiguration {
1820
1832
  * @public
1821
1833
  * <p>The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace for use with Service Connect. The namespace must be in
1822
1834
  * the same Amazon Web Services Region as the Amazon ECS service and cluster. The type of namespace doesn't
1823
- * affect Service Connect. For more information about Cloud Map, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html">Working with Services</a> in the
1824
- * <i>Cloud Map Developer Guide</i>.</p>
1835
+ * affect Service Connect. For more information about Cloud Map, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html">Working
1836
+ * with Services</a> in the <i>Cloud Map Developer Guide</i>.</p>
1825
1837
  */
1826
1838
  namespace?: string;
1827
1839
  /**
@@ -1855,9 +1867,9 @@ export interface ServiceConnectConfiguration {
1855
1867
  * containers.</p>
1856
1868
  * <ul>
1857
1869
  * <li>
1858
- * <p>Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon.
1859
- * Additional log drivers may be available in future releases of the Amazon ECS
1860
- * container agent.</p>
1870
+ * <p>Amazon ECS currently supports a subset of the logging drivers available to the
1871
+ * Docker daemon. Additional log drivers may be available in future releases of the
1872
+ * Amazon ECS container agent.</p>
1861
1873
  * <p>For tasks on Fargate, the supported log drivers are <code>awslogs</code>,
1862
1874
  * <code>splunk</code>, and <code>awsfirelens</code>.</p>
1863
1875
  * <p>For tasks hosted on Amazon EC2 instances, the supported log drivers are
@@ -1936,6 +1948,246 @@ export interface ServiceRegistry {
1936
1948
  */
1937
1949
  containerPort?: number;
1938
1950
  }
1951
+ /**
1952
+ * @public
1953
+ * @enum
1954
+ */
1955
+ export declare const TaskFilesystemType: {
1956
+ readonly EXT3: "ext3";
1957
+ readonly EXT4: "ext4";
1958
+ readonly XFS: "xfs";
1959
+ };
1960
+ /**
1961
+ * @public
1962
+ */
1963
+ export type TaskFilesystemType = (typeof TaskFilesystemType)[keyof typeof TaskFilesystemType];
1964
+ /**
1965
+ * @public
1966
+ * @enum
1967
+ */
1968
+ export declare const EBSResourceType: {
1969
+ readonly VOLUME: "volume";
1970
+ };
1971
+ /**
1972
+ * @public
1973
+ */
1974
+ export type EBSResourceType = (typeof EBSResourceType)[keyof typeof EBSResourceType];
1975
+ /**
1976
+ * @public
1977
+ * <p>The tag specifications of an Amazon EBS volume.</p>
1978
+ */
1979
+ export interface EBSTagSpecification {
1980
+ /**
1981
+ * @public
1982
+ * <p>The type of volume resource.</p>
1983
+ */
1984
+ resourceType: EBSResourceType | undefined;
1985
+ /**
1986
+ * @public
1987
+ * <p>The tags applied to this Amazon EBS volume. <code>AmazonECSCreated</code> and
1988
+ * <code>AmazonECSManaged</code> are reserved tags that can't be used.</p>
1989
+ */
1990
+ tags?: Tag[];
1991
+ /**
1992
+ * @public
1993
+ * <p>Determines whether to propagate the tags from the task definition to
1994
+ the Amazon EBS
1995
+ * volume. Tags can only propagate to a <code>SERVICE</code> specified in
1996
+ *
1997
+ <code>ServiceVolumeConfiguration</code>. If no value is specified, the tags aren't
1998
+ *
1999
+ propagated.</p>
2000
+ */
2001
+ propagateTags?: PropagateTags;
2002
+ }
2003
+ /**
2004
+ * @public
2005
+ * <p>The configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf.
2006
+ * These settings are used to create each Amazon EBS volume, with one volume created for each
2007
+ * task in the service.</p>
2008
+ * <p>Many of these parameters map 1:1 with the Amazon EBS <code>CreateVolume</code> API request
2009
+ * parameters.</p>
2010
+ */
2011
+ export interface ServiceManagedEBSVolumeConfiguration {
2012
+ /**
2013
+ * @public
2014
+ * <p>Indicates whether the volume should be encrypted. If no value is specified, encryption
2015
+ * is turned on by default. This parameter maps 1:1 with the <code>Encrypted</code>
2016
+ * parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in
2017
+ * the <i>Amazon EC2 API Reference</i>.</p>
2018
+ */
2019
+ encrypted?: boolean;
2020
+ /**
2021
+ * @public
2022
+ * <p>The Amazon Resource Name (ARN) identifier of the Amazon Web Services Key Management Service key to use for Amazon EBS encryption. When
2023
+ * encryption is turned on and no Amazon Web Services Key Management Service key is specified, the default Amazon Web Services managed key
2024
+ * for Amazon EBS volumes is used. This parameter maps 1:1 with the <code>KmsKeyId</code>
2025
+ * parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in
2026
+ * the <i>Amazon EC2 API Reference</i>.</p>
2027
+ * <important>
2028
+ * <p>Amazon Web Services authenticates the Amazon Web Services Key Management Service key asynchronously. Therefore, if you specify an
2029
+ * ID, alias, or ARN that is invalid, the action can appear to complete, but
2030
+ * eventually fails.</p>
2031
+ * </important>
2032
+ */
2033
+ kmsKeyId?: string;
2034
+ /**
2035
+ * @public
2036
+ * <p>The volume type. This parameter maps 1:1 with the <code>VolumeType</code> parameter of
2037
+ * the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>. For more
2038
+ * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html">Amazon EBS volume types</a> in
2039
+ * the <i>Amazon EC2 User Guide</i>.</p>
2040
+ * <p>The following are the supported volume types.</p>
2041
+ * <ul>
2042
+ * <li>
2043
+ * <p>General Purpose SSD: <code>gp2</code>|<code>gp3</code>
2044
+ * </p>
2045
+ * </li>
2046
+ * <li>
2047
+ * <p>Provisioned IOPS SSD: <code>io1</code>|<code>io2</code>
2048
+ * </p>
2049
+ * </li>
2050
+ * <li>
2051
+ * <p>Throughput Optimized HDD: <code>st1</code>
2052
+ * </p>
2053
+ * </li>
2054
+ * <li>
2055
+ * <p>Cold HDD: <code>sc1</code>
2056
+ * </p>
2057
+ * </li>
2058
+ * <li>
2059
+ * <p>Magnetic: <code>standard</code>
2060
+ * </p>
2061
+ * <note>
2062
+ * <p>The magnetic volume type is not supported on Fargate.</p>
2063
+ * </note>
2064
+ * </li>
2065
+ * </ul>
2066
+ */
2067
+ volumeType?: string;
2068
+ /**
2069
+ * @public
2070
+ * <p>The size of the volume in GiB. You must specify either a volume size or a snapshot ID.
2071
+ * If you specify a snapshot ID, the snapshot size is used for the volume size by default.
2072
+ * You can optionally specify a volume size greater than or equal to the snapshot size.
2073
+ * This parameter maps 1:1 with the <code>Size</code> parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>.</p>
2074
+ * <p>The following are the supported volume size values for each volume type.</p>
2075
+ * <ul>
2076
+ * <li>
2077
+ * <p>
2078
+ * <code>gp2</code> and <code>gp3</code>: 1-16,384</p>
2079
+ * </li>
2080
+ * <li>
2081
+ * <p>
2082
+ * <code>io1</code> and <code>io2</code>: 4-16,384</p>
2083
+ * </li>
2084
+ * <li>
2085
+ * <p>
2086
+ * <code>st1</code> and <code>sc1</code>: 125-16,384</p>
2087
+ * </li>
2088
+ * <li>
2089
+ * <p>
2090
+ * <code>standard</code>: 1-1,024</p>
2091
+ * </li>
2092
+ * </ul>
2093
+ */
2094
+ sizeInGiB?: number;
2095
+ /**
2096
+ * @public
2097
+ * <p>The snapshot that Amazon ECS uses to create the volume. You must specify either a snapshot
2098
+ * ID or a volume size. This parameter maps 1:1 with the <code>SnapshotId</code> parameter
2099
+ * of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in
2100
+ * the <i>Amazon EC2 API Reference</i>.</p>
2101
+ */
2102
+ snapshotId?: string;
2103
+ /**
2104
+ * @public
2105
+ * <p>The number of I/O operations per second (IOPS). For <code>gp3</code>,
2106
+ * <code>io1</code>, and <code>io2</code> volumes, this represents the number of IOPS that
2107
+ * are provisioned for the volume. For <code>gp2</code> volumes, this represents the
2108
+ * baseline performance of the volume and the rate at which the volume accumulates I/O
2109
+ * credits for bursting.</p>
2110
+ * <p>The following are the supported values for each volume type.</p>
2111
+ * <ul>
2112
+ * <li>
2113
+ * <p>
2114
+ * <code>gp3</code>: 3,000 - 16,000 IOPS</p>
2115
+ * </li>
2116
+ * <li>
2117
+ * <p>
2118
+ * <code>io1</code>: 100 - 64,000 IOPS</p>
2119
+ * </li>
2120
+ * <li>
2121
+ * <p>
2122
+ * <code>io2</code>: 100 - 256,000 IOPS</p>
2123
+ * </li>
2124
+ * </ul>
2125
+ * <p>This parameter is required for <code>io1</code> and <code>io2</code> volume types. The
2126
+ * default for <code>gp3</code> volumes is <code>3,000 IOPS</code>. This parameter is not
2127
+ * supported for <code>st1</code>, <code>sc1</code>, or <code>standard</code> volume
2128
+ * types.</p>
2129
+ * <p>This parameter maps 1:1 with the <code>Iops</code> parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>.</p>
2130
+ */
2131
+ iops?: number;
2132
+ /**
2133
+ * @public
2134
+ * <p>The throughput to provision for a volume, in MiB/s, with a maximum of 1,000 MiB/s.
2135
+ * This parameter maps 1:1 with the <code>Throughput</code> parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>.</p>
2136
+ * <important>
2137
+ * <p>This parameter is only supported for the <code>gp3</code> volume type.</p>
2138
+ * </important>
2139
+ */
2140
+ throughput?: number;
2141
+ /**
2142
+ * @public
2143
+ * <p>The tags to apply to the volume. Amazon ECS applies service-managed tags by default. This
2144
+ * parameter maps 1:1 with the <code>TagSpecifications.N</code> parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>.</p>
2145
+ */
2146
+ tagSpecifications?: EBSTagSpecification[];
2147
+ /**
2148
+ * @public
2149
+ * <p>The ARN of the IAM role to associate with this volume. This is the Amazon ECS
2150
+ * infrastructure IAM role that is used to manage your Amazon Web Services infrastructure. We recommend
2151
+ * using the Amazon ECS-managed <code>AmazonECSInfrastructureRolePolicyForVolumes</code> IAM
2152
+ * policy with this role. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/infrastructure_IAM_role.html">Amazon ECS
2153
+ * infrastructure IAM role</a> in the <i>Amazon ECS Developer
2154
+ * Guide</i>.</p>
2155
+ */
2156
+ roleArn: string | undefined;
2157
+ /**
2158
+ * @public
2159
+ * <p>The Linux filesystem type for the volume. For volumes created from a snapshot, you
2160
+ * must specify the same filesystem type that the volume was using when the snapshot was
2161
+ * created. If there is a filesystem type mismatch, the task will fail to start.</p>
2162
+ * <p>The available filesystem types are
2163
+ <code>ext3</code>, <code>ext4</code>, and
2164
+ * <code>xfs</code>. If no value is specified, the <code>xfs</code> filesystem type is
2165
+ * used by default.</p>
2166
+ */
2167
+ filesystemType?: TaskFilesystemType;
2168
+ }
2169
+ /**
2170
+ * @public
2171
+ * <p>The configuration for a volume specified in the task definition as a volume that is
2172
+ * configured at launch time. Currently, the only supported volume type is an Amazon EBS
2173
+ * volume.</p>
2174
+ */
2175
+ export interface ServiceVolumeConfiguration {
2176
+ /**
2177
+ * @public
2178
+ * <p>The name of the volume. This value must match the volume name from the
2179
+ * <code>Volume</code> object in the task definition.</p>
2180
+ */
2181
+ name: string | undefined;
2182
+ /**
2183
+ * @public
2184
+ * <p>The configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf.
2185
+ * These settings are used to create each Amazon EBS volume, with one volume created for each
2186
+ * task in the service. The Amazon EBS volumes are visible in your account in the Amazon EC2 console
2187
+ * once they are created.</p>
2188
+ */
2189
+ managedEBSVolume?: ServiceManagedEBSVolumeConfiguration;
2190
+ }
1939
2191
  /**
1940
2192
  * @public
1941
2193
  */
@@ -1960,7 +2212,8 @@ export interface CreateServiceRequest {
1960
2212
  * isn't specified, the latest <code>ACTIVE</code> revision is used.</p>
1961
2213
  * <p>A task definition must be specified if the service uses either the <code>ECS</code> or
1962
2214
  * <code>CODE_DEPLOY</code> deployment controllers.</p>
1963
- * <p>For more information about deployment types, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS deployment types</a>.</p>
2215
+ * <p>For more information about deployment types, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS deployment
2216
+ * types</a>.</p>
1964
2217
  */
1965
2218
  taskDefinition?: string;
1966
2219
  /**
@@ -2015,7 +2268,8 @@ export interface CreateServiceRequest {
2015
2268
  serviceRegistries?: ServiceRegistry[];
2016
2269
  /**
2017
2270
  * @public
2018
- * <p>The number of instantiations of the specified task definition to place and keep running in your service.</p>
2271
+ * <p>The number of instantiations of the specified task definition to place and keep
2272
+ * running in your service.</p>
2019
2273
  * <p>This is required if <code>schedulingStrategy</code> is <code>REPLICA</code> or isn't
2020
2274
  * specified. If <code>schedulingStrategy</code> is <code>DAEMON</code> then this isn't
2021
2275
  * required.</p>
@@ -2086,7 +2340,8 @@ export interface CreateServiceRequest {
2086
2340
  * specify the full role ARN (this is recommended) or prefix the role name with the path.
2087
2341
  * For example, if a role with the name <code>bar</code> has a path of <code>/foo/</code>
2088
2342
  * then you would specify <code>/foo/bar</code> as the role name. For more information, see
2089
- * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names">Friendly names and paths</a> in the <i>IAM User Guide</i>.</p>
2343
+ * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names">Friendly names and paths</a> in the <i>IAM User
2344
+ * Guide</i>.</p>
2090
2345
  */
2091
2346
  role?: string;
2092
2347
  /**
@@ -2248,6 +2503,13 @@ export interface CreateServiceRequest {
2248
2503
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html">Service Connect</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
2249
2504
  */
2250
2505
  serviceConnectConfiguration?: ServiceConnectConfiguration;
2506
+ /**
2507
+ * @public
2508
+ * <p>The configuration for a volume specified in the task definition as a volume that is
2509
+ * configured at launch time. Currently, the only supported volume type is an Amazon EBS
2510
+ * volume.</p>
2511
+ */
2512
+ volumeConfigurations?: ServiceVolumeConfiguration[];
2251
2513
  }
2252
2514
  /**
2253
2515
  * @public
@@ -2441,6 +2703,13 @@ export interface Deployment {
2441
2703
  * list entry maps a discovery name to a Cloud Map service name.</p>
2442
2704
  */
2443
2705
  serviceConnectResources?: ServiceConnectServiceResource[];
2706
+ /**
2707
+ * @public
2708
+ * <p>The details of the volume that was <code>configuredAtLaunch</code>. You can configure
2709
+ * different settings like the size, throughput, volumeType, and ecryption in <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ServiceManagedEBSVolumeConfiguration.html">ServiceManagedEBSVolumeConfiguration</a>. The <code>name</code> of the volume
2710
+ * must match the <code>name</code> from the task definition.</p>
2711
+ */
2712
+ volumeConfigurations?: ServiceVolumeConfiguration[];
2444
2713
  }
2445
2714
  /**
2446
2715
  * @public
@@ -3056,8 +3325,8 @@ export interface CreateTaskSetRequest {
3056
3325
  externalId?: string;
3057
3326
  /**
3058
3327
  * @public
3059
- * <p>The task definition for the tasks in the task set to use. If a revision isn't specified, the
3060
- * latest <code>ACTIVE</code> revision is used.</p>
3328
+ * <p>The task definition for the tasks in the task set to use. If a revision isn't
3329
+ * specified, the latest <code>ACTIVE</code> revision is used.</p>
3061
3330
  */
3062
3331
  taskDefinition: string | undefined;
3063
3332
  /**
@@ -3242,10 +3511,10 @@ export interface DeleteAccountSettingRequest {
3242
3511
  name: SettingName | undefined;
3243
3512
  /**
3244
3513
  * @public
3245
- * <p>The Amazon Resource Name (ARN) of the principal. It can be an user, role, or
3246
- * the root user. If you specify the root user, it disables the account setting for all users, roles, and the root user of the account unless a user or role explicitly
3247
- * overrides these settings. If this field is omitted, the setting is changed only for the
3248
- * authenticated user.</p>
3514
+ * <p>The Amazon Resource Name (ARN) of the principal. It can be an user, role, or the
3515
+ * root user. If you specify the root user, it disables the account setting for all users, roles,
3516
+ * and the root user of the account unless a user or role explicitly overrides these settings.
3517
+ * If this field is omitted, the setting is changed only for the authenticated user.</p>
3249
3518
  */
3250
3519
  principalArn?: string;
3251
3520
  }
@@ -3278,8 +3547,8 @@ export interface Setting {
3278
3547
  value?: string;
3279
3548
  /**
3280
3549
  * @public
3281
- * <p>The ARN of the principal. It can be a user, role, or the root user. If this
3282
- * field is omitted, the authenticated user is assumed.</p>
3550
+ * <p>The ARN of the principal. It can be a user, role, or the root user. If this field is
3551
+ * omitted, the authenticated user is assumed.</p>
3283
3552
  */
3284
3553
  principalArn?: string;
3285
3554
  /**
@@ -3649,9 +3918,9 @@ export declare const EnvironmentFileType: {
3649
3918
  export type EnvironmentFileType = (typeof EnvironmentFileType)[keyof typeof EnvironmentFileType];
3650
3919
  /**
3651
3920
  * @public
3652
- * <p>A list of files containing the environment variables to pass to a container. You can specify
3653
- * up to ten environment files. The file must have a <code>.env</code> file extension. Each
3654
- * line in an environment file should contain an environment variable in
3921
+ * <p>A list of files containing the environment variables to pass to a container. You can
3922
+ * specify up to ten environment files. The file must have a <code>.env</code> file
3923
+ * extension. Each line in an environment file should contain an environment variable in
3655
3924
  * <code>VARIABLE=VALUE</code> format. Lines beginning with <code>#</code> are treated
3656
3925
  * as comments and are ignored.</p>
3657
3926
  * <p>If there are environment variables specified using the <code>environment</code>
@@ -3833,20 +4102,24 @@ export interface FirelensConfiguration {
3833
4102
  * <p>Consider the following task health example with 3 containers.</p>
3834
4103
  * <ul>
3835
4104
  * <li>
3836
- * <p>If Container1 is <code>UNHEALTHY</code> and Container2 is <code>UNKNOWN</code>, and Container3
3837
- * is <code>UNKNOWN</code>, the task health is <code>UNHEALTHY</code>.</p>
4105
+ * <p>If Container1 is <code>UNHEALTHY</code> and Container2 is
4106
+ * <code>UNKNOWN</code>, and Container3 is <code>UNKNOWN</code>, the task health is
4107
+ * <code>UNHEALTHY</code>.</p>
3838
4108
  * </li>
3839
4109
  * <li>
3840
- * <p>If Container1 is <code>UNHEALTHY</code> and Container2 is <code>UNKNOWN</code>, and Container3
3841
- * is <code>HEALTHY</code>, the task health is <code>UNHEALTHY</code>.</p>
4110
+ * <p>If Container1 is <code>UNHEALTHY</code> and Container2 is
4111
+ * <code>UNKNOWN</code>, and Container3 is <code>HEALTHY</code>, the task health is
4112
+ * <code>UNHEALTHY</code>.</p>
3842
4113
  * </li>
3843
4114
  * <li>
3844
- * <p>If Container1 is <code>UNHEALTHY</code> and Container2 is <code>HEALTHY</code>, and Container3
3845
- * is <code>HEALTHY</code>, the task health is <code>UNHEALTHY</code>.</p>
4115
+ * <p>If Container1 is <code>UNHEALTHY</code> and Container2 is
4116
+ * <code>HEALTHY</code>, and Container3 is <code>HEALTHY</code>, the task health is
4117
+ * <code>UNHEALTHY</code>.</p>
3846
4118
  * </li>
3847
4119
  * <li>
3848
- * <p>If Container1 is <code>HEALTHY</code> and Container2 is <code>UNKNOWN</code>, and Container3
3849
- * is <code>HEALTHY</code>, the task health is <code>UNKNOWN</code>.</p>
4120
+ * <p>If Container1 is <code>HEALTHY</code> and Container2 is <code>UNKNOWN</code>,
4121
+ * and Container3 is <code>HEALTHY</code>, the task health is
4122
+ * <code>UNKNOWN</code>.</p>
3850
4123
  * </li>
3851
4124
  * <li>
3852
4125
  * <p>If Container1 is <code>HEALTHY</code> and Container2 is <code>UNKNOWN</code>,
@@ -3898,8 +4171,8 @@ export interface HealthCheck {
3898
4171
  * healthy. The string array must start with <code>CMD</code> to run the command arguments
3899
4172
  * directly, or <code>CMD-SHELL</code> to run the command with the container's default
3900
4173
  * shell. </p>
3901
- * <p> When you use the Amazon Web Services Management Console JSON panel, the Command Line Interface, or the APIs, enclose the list of
3902
- * commands in double quotes and brackets.</p>
4174
+ * <p> When you use the Amazon Web Services Management Console JSON panel, the Command Line Interface, or the APIs, enclose the list
4175
+ * of commands in double quotes and brackets.</p>
3903
4176
  * <p>
3904
4177
  * <code>[ "CMD-SHELL", "curl -f http://localhost/ || exit 1" ]</code>
3905
4178
  * </p>
@@ -4127,7 +4400,8 @@ export interface LinuxParameters {
4127
4400
  * <note>
4128
4401
  * <p>If you're using tasks that use the Fargate launch type, the
4129
4402
  * <code>maxSwap</code> parameter isn't supported.</p>
4130
- * <p>If you're using tasks on Amazon Linux 2023 the <code>swappiness</code> parameter isn't supported.</p>
4403
+ * <p>If you're using tasks on Amazon Linux 2023 the <code>swappiness</code> parameter isn't
4404
+ * supported.</p>
4131
4405
  * </note>
4132
4406
  */
4133
4407
  maxSwap?: number;
@@ -4144,7 +4418,8 @@ export interface LinuxParameters {
4144
4418
  * <note>
4145
4419
  * <p>If you're using tasks that use the Fargate launch type, the
4146
4420
  * <code>swappiness</code> parameter isn't supported.</p>
4147
- * <p>If you're using tasks on Amazon Linux 2023 the <code>swappiness</code> parameter isn't supported.</p>
4421
+ * <p>If you're using tasks on Amazon Linux 2023 the <code>swappiness</code> parameter isn't
4422
+ * supported.</p>
4148
4423
  * </note>
4149
4424
  */
4150
4425
  swappiness?: number;
@@ -4241,8 +4516,8 @@ export interface PortMapping {
4241
4516
  /**
4242
4517
  * @public
4243
4518
  * <p>The port number on the container instance to reserve for your container.</p>
4244
- * <p>If you specify a <code>containerPortRange</code>, leave this field empty and the value of
4245
- * the <code>hostPort</code> is set as follows:</p>
4519
+ * <p>If you specify a <code>containerPortRange</code>, leave this field empty and the value
4520
+ * of the <code>hostPort</code> is set as follows:</p>
4246
4521
  * <ul>
4247
4522
  * <li>
4248
4523
  * <p>For containers in a task with the <code>awsvpc</code> network mode, the
@@ -4250,9 +4525,9 @@ export interface PortMapping {
4250
4525
  * <code>containerPort</code>. This is a static mapping strategy.</p>
4251
4526
  * </li>
4252
4527
  * <li>
4253
- * <p>For containers in a task with the <code>bridge</code> network mode, the Amazon ECS agent finds
4254
- * open ports on the host and automatically binds them to the container ports. This
4255
- * is a dynamic mapping strategy.</p>
4528
+ * <p>For containers in a task with the <code>bridge</code> network mode, the Amazon ECS
4529
+ * agent finds open ports on the host and automatically binds them to the container
4530
+ * ports. This is a dynamic mapping strategy.</p>
4256
4531
  * </li>
4257
4532
  * </ul>
4258
4533
  * <p>If you use containers in a task with the <code>awsvpc</code> or <code>host</code>
@@ -4267,26 +4542,24 @@ export interface PortMapping {
4267
4542
  * <p>The default ephemeral port range for Docker version 1.6.0 and later is listed on the
4268
4543
  * instance under <code>/proc/sys/net/ipv4/ip_local_port_range</code>. If this kernel
4269
4544
  * parameter is unavailable, the default ephemeral port range from 49153 through 65535
4270
- * (Linux) or 49152 through 65535 (Windows) is used. Do not attempt to specify a host port
4545
+ * (Linux) or 49152 through 65535 (Windows) is used. Do not attempt to specify a host port
4271
4546
  * in the ephemeral port range as these are reserved for automatic assignment. In general,
4272
4547
  * ports below 32768 are outside of the ephemeral port range.</p>
4273
4548
  * <p>The default reserved ports are 22 for SSH, the Docker ports 2375 and 2376, and the
4274
4549
  * Amazon ECS container agent ports 51678-51680. Any host port that was previously specified in
4275
4550
  * a running task is also reserved while the task is running. That is, after a task stops,
4276
4551
  * the host port is released. The current reserved ports are displayed in the
4277
- * <code>remainingResources</code> of <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeContainerInstances.html">DescribeContainerInstances</a>
4278
- * output. A container instance can have up to 100 reserved ports at a time. This number
4279
- * includes the default reserved ports. Automatically assigned ports aren't included in the
4280
- * 100 reserved ports quota.</p>
4552
+ * <code>remainingResources</code> of <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeContainerInstances.html">DescribeContainerInstances</a> output. A container instance can have up to 100
4553
+ * reserved ports at a time. This number includes the default reserved ports. Automatically
4554
+ * assigned ports aren't included in the 100 reserved ports quota.</p>
4281
4555
  */
4282
4556
  hostPort?: number;
4283
4557
  /**
4284
4558
  * @public
4285
4559
  * <p>The protocol used for the port mapping. Valid values are <code>tcp</code> and
4286
- * <code>udp</code>. The default is <code>tcp</code>. <code>protocol</code> is immutable in a
4287
- * Service Connect service. Updating this field requires a service deletion and
4288
- * redeployment.
4289
- * </p>
4560
+ * <code>udp</code>. The default is <code>tcp</code>. <code>protocol</code> is
4561
+ * immutable in a Service Connect service. Updating this field requires a service deletion
4562
+ * and redeployment. </p>
4290
4563
  */
4291
4564
  protocol?: TransportProtocol;
4292
4565
  /**
@@ -4309,8 +4582,8 @@ export interface PortMapping {
4309
4582
  * <p>If you don't set a value for this parameter, then TCP is used. However, Amazon ECS doesn't
4310
4583
  * add protocol-specific telemetry for TCP.</p>
4311
4584
  * <p>
4312
- * <code>appProtocol</code> is immutable in a Service Connect service. Updating this field
4313
- * requires a service deletion and redeployment.</p>
4585
+ * <code>appProtocol</code> is immutable in a Service Connect service. Updating this
4586
+ * field requires a service deletion and redeployment.</p>
4314
4587
  * <p>Tasks that run in a namespace can use short names to connect
4315
4588
  * to services in the namespace. Tasks can connect to services across all of the clusters in the namespace.
4316
4589
  * Tasks connect through a managed proxy container
@@ -4321,8 +4594,8 @@ export interface PortMapping {
4321
4594
  appProtocol?: ApplicationProtocol;
4322
4595
  /**
4323
4596
  * @public
4324
- * <p>The port number range on the container that's bound to the dynamically mapped host port
4325
- * range. </p>
4597
+ * <p>The port number range on the container that's bound to the dynamically mapped host
4598
+ * port range. </p>
4326
4599
  * <p>The following rules apply when you specify a <code>containerPortRange</code>:</p>
4327
4600
  * <ul>
4328
4601
  * <li>
@@ -4415,10 +4688,10 @@ export declare const ResourceType: {
4415
4688
  export type ResourceType = (typeof ResourceType)[keyof typeof ResourceType];
4416
4689
  /**
4417
4690
  * @public
4418
- * <p>The type and amount of a resource to assign to a container. The supported resource types are
4419
- * GPUs and Elastic Inference accelerators. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-gpu.html">Working with
4420
- * GPUs on Amazon ECS</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html">Working with
4421
- * Amazon Elastic Inference on Amazon ECS</a> in the <i>Amazon Elastic Container Service Developer Guide</i>
4691
+ * <p>The type and amount of a resource to assign to a container. The supported resource
4692
+ * types are GPUs and Elastic Inference accelerators. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-gpu.html">Working with
4693
+ * GPUs on Amazon ECS</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html">Working with Amazon Elastic
4694
+ * Inference on Amazon ECS</a> in the <i>Amazon Elastic Container Service Developer Guide</i>
4422
4695
  * </p>
4423
4696
  */
4424
4697
  export interface ResourceRequirement {
@@ -4430,8 +4703,7 @@ export interface ResourceRequirement {
4430
4703
  * of GPUs that's reserved for all containers in a task can't exceed the number of
4431
4704
  * available GPUs on the container instance that the task is launched on.</p>
4432
4705
  * <p>If the <code>InferenceAccelerator</code> type is used, the <code>value</code> matches
4433
- * the <code>deviceName</code> for an <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html">InferenceAccelerator</a> specified in a
4434
- * task definition.</p>
4706
+ * the <code>deviceName</code> for an <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html">InferenceAccelerator</a> specified in a task definition.</p>
4435
4707
  */
4436
4708
  value: string | undefined;
4437
4709
  /**
@@ -4474,16 +4746,14 @@ export interface SystemControl {
4474
4746
  namespace?: string;
4475
4747
  /**
4476
4748
  * @public
4477
- * <p>The namespaced kernel parameter to set a
4478
- * <code>value</code> for.</p>
4749
+ * <p>The namespaced kernel parameter to set a <code>value</code> for.</p>
4479
4750
  * <p>Valid IPC namespace values: <code>"kernel.msgmax" | "kernel.msgmnb" | "kernel.msgmni"
4480
- * | "kernel.sem" | "kernel.shmall" | "kernel.shmmax" |
4481
- * "kernel.shmmni" | "kernel.shm_rmid_forced"</code>, and
4482
- * <code>Sysctls</code> that start with
4483
- * <code>"fs.mqueue.*"</code>
4751
+ * | "kernel.sem" | "kernel.shmall" | "kernel.shmmax" | "kernel.shmmni" |
4752
+ * "kernel.shm_rmid_forced"</code>, and <code>Sysctls</code> that start with
4753
+ * <code>"fs.mqueue.*"</code>
4484
4754
  * </p>
4485
4755
  * <p>Valid network namespace values: <code>Sysctls</code> that start with
4486
- * <code>"net.*"</code>
4756
+ * <code>"net.*"</code>
4487
4757
  * </p>
4488
4758
  * <p>All of these values are supported by Fargate.</p>
4489
4759
  */
@@ -5041,9 +5311,9 @@ export interface ContainerDefinition {
5041
5311
  workingDirectory?: string;
5042
5312
  /**
5043
5313
  * @public
5044
- * <p>When this parameter is true, networking is off within the container. This parameter maps to
5045
- * <code>NetworkDisabled</code> in the <a href="https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate">Create a container</a> section of
5046
- * the <a href="https://docs.docker.com/engine/api/v1.35/">Docker Remote API</a>.</p>
5314
+ * <p>When this parameter is true, networking is off within the container. This parameter
5315
+ * maps to <code>NetworkDisabled</code> in the <a href="https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate">Create a container</a> section
5316
+ * of the <a href="https://docs.docker.com/engine/api/v1.35/">Docker Remote API</a>.</p>
5047
5317
  * <note>
5048
5318
  * <p>This parameter is not supported for Windows containers.</p>
5049
5319
  * </note>
@@ -5107,18 +5377,17 @@ export interface ContainerDefinition {
5107
5377
  extraHosts?: HostEntry[];
5108
5378
  /**
5109
5379
  * @public
5110
- * <p>A list of strings to provide custom configuration for multiple
5111
- * security systems. For more information about valid values, see <a href="https://docs.docker.com/engine/reference/run/#security-configuration">Docker Run Security Configuration</a>. This field isn't valid
5112
- * for containers in tasks using the Fargate launch
5113
- * type.</p>
5380
+ * <p>A list of strings to provide custom configuration for multiple security systems. For
5381
+ * more information about valid values, see <a href="https://docs.docker.com/engine/reference/run/#security-configuration">Docker
5382
+ * Run Security Configuration</a>. This field isn't valid for containers in tasks
5383
+ * using the Fargate launch type.</p>
5114
5384
  * <p>For Linux tasks on EC2, this parameter can be used to reference custom
5115
5385
  * labels for SELinux and AppArmor multi-level security systems.</p>
5116
5386
  * <p>For any tasks on EC2, this parameter can be used to reference a
5117
- * credential spec file that configures a container for Active Directory
5118
- * authentication. For more
5119
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/windows-gmsa.html">Using gMSAs for Windows
5387
+ * credential spec file that configures a container for Active Directory authentication.
5388
+ * For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/windows-gmsa.html">Using gMSAs for Windows
5120
5389
  * Containers</a> and <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/linux-gmsa.html">Using gMSAs for Linux
5121
- * Containers</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
5390
+ * Containers</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
5122
5391
  * <p>This parameter maps to <code>SecurityOpt</code> in the
5123
5392
  * <a href="https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate">Create a container</a> section of the <a href="https://docs.docker.com/engine/api/v1.35/">Docker Remote API</a> and the
5124
5393
  * <code>--security-opt</code> option to <a href="https://docs.docker.com/engine/reference/run/#security-configuration">docker
@@ -5224,9 +5493,9 @@ export interface ContainerDefinition {
5224
5493
  * @public
5225
5494
  * <p>A list of namespaced kernel parameters to set in the container. This parameter maps to
5226
5495
  * <code>Sysctls</code> in the <a href="https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate">Create a container</a> section of the
5227
- * <a href="https://docs.docker.com/engine/api/v1.35/">Docker Remote API</a> and the <code>--sysctl</code> option to <a href="https://docs.docker.com/engine/reference/run/#security-configuration">docker run</a>. For example, you can
5228
- * configure <code>net.ipv4.tcp_keepalive_time</code> setting to maintain
5229
- * longer lived connections.</p>
5496
+ * <a href="https://docs.docker.com/engine/api/v1.35/">Docker Remote API</a> and the <code>--sysctl</code> option to <a href="https://docs.docker.com/engine/reference/run/#security-configuration">docker run</a>. For example, you can configure
5497
+ * <code>net.ipv4.tcp_keepalive_time</code> setting to maintain longer lived
5498
+ * connections.</p>
5230
5499
  * <note>
5231
5500
  * <p>We don't recommended that you specify network-related <code>systemControls</code>
5232
5501
  * parameters for multiple containers in a single task that also uses either the
@@ -5262,11 +5531,10 @@ export interface ContainerDefinition {
5262
5531
  firelensConfiguration?: FirelensConfiguration;
5263
5532
  /**
5264
5533
  * @public
5265
- * <p>A list of ARNs in SSM or Amazon S3 to a credential spec
5266
- * (<code>CredSpec</code>) file that configures the container for Active Directory
5267
- * authentication. We recommend that you use this parameter instead of the
5268
- * <code>dockerSecurityOptions</code>. The maximum number of ARNs is
5269
- * 1.</p>
5534
+ * <p>A list of ARNs in SSM or Amazon S3 to a credential spec (<code>CredSpec</code>) file that
5535
+ * configures the container for Active Directory authentication. We recommend that you use
5536
+ * this parameter instead of the <code>dockerSecurityOptions</code>. The maximum number of
5537
+ * ARNs is 1.</p>
5270
5538
  * <p>There are two formats for each ARN.</p>
5271
5539
  * <dl>
5272
5540
  * <dt>credentialspecdomainless:MyARN</dt>
@@ -5287,8 +5555,7 @@ export interface ContainerDefinition {
5287
5555
  * tasks that use this task definition.</p>
5288
5556
  * </dd>
5289
5557
  * </dl>
5290
- * <p>In both formats, replace <code>MyARN</code> with the ARN in
5291
- * SSM or Amazon S3.</p>
5558
+ * <p>In both formats, replace <code>MyARN</code> with the ARN in SSM or Amazon S3.</p>
5292
5559
  * <p>If you provide a <code>credentialspecdomainless:MyARN</code>, the
5293
5560
  * <code>credspec</code> must provide a ARN in Secrets Manager for a secret containing the
5294
5561
  * username, password, and the domain to connect to. For better security, the instance
@@ -5308,8 +5575,8 @@ export interface ContainerDefinition {
5308
5575
  * tasks hosted on Fargate. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/userguide/using_data_volumes.html">Fargate task
5309
5576
  * storage</a> in the <i>Amazon ECS User Guide for Fargate</i>.</p>
5310
5577
  * <note>
5311
- * <p>For tasks using the Fargate launch type, the task requires
5312
- * the following platforms:</p>
5578
+ * <p>For tasks using the Fargate launch type, the task requires the
5579
+ * following platforms:</p>
5313
5580
  * <ul>
5314
5581
  * <li>
5315
5582
  * <p>Linux platform version <code>1.4.0</code> or later.</p>
@@ -5331,8 +5598,8 @@ export interface EphemeralStorage {
5331
5598
  }
5332
5599
  /**
5333
5600
  * @public
5334
- * <p>Details on an Elastic Inference accelerator. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html">Working with Amazon Elastic Inference on
5335
- * Amazon ECS</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
5601
+ * <p>Details on an Elastic Inference accelerator. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html">Working with Amazon Elastic Inference on Amazon ECS</a> in the
5602
+ * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
5336
5603
  */
5337
5604
  export interface InferenceAccelerator {
5338
5605
  /**
@@ -5399,8 +5666,8 @@ export declare const TaskDefinitionPlacementConstraintType: {
5399
5666
  export type TaskDefinitionPlacementConstraintType = (typeof TaskDefinitionPlacementConstraintType)[keyof typeof TaskDefinitionPlacementConstraintType];
5400
5667
  /**
5401
5668
  * @public
5402
- * <p>The constraint on task placement in the task definition. For more
5403
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html">Task placement constraints</a> in the
5669
+ * <p>The constraint on task placement in the task definition. For more information, see
5670
+ * <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html">Task placement constraints</a> in the
5404
5671
  * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
5405
5672
  * <note>
5406
5673
  * <p>Task placement constraints aren't supported for tasks run on Fargate.</p>
@@ -5656,17 +5923,17 @@ export interface EFSAuthorizationConfig {
5656
5923
  * <p>The Amazon EFS access point ID to use. If an access point is specified, the root directory
5657
5924
  * value specified in the <code>EFSVolumeConfiguration</code> must either be omitted or set
5658
5925
  * to <code>/</code> which will enforce the path set on the EFS access point. If an access
5659
- * point is used, transit encryption must be on in the
5660
- * <code>EFSVolumeConfiguration</code>. For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html">Working with Amazon
5661
- * EFS access points</a> in the <i>Amazon Elastic File System User Guide</i>.</p>
5926
+ * point is used, transit encryption must be on in the <code>EFSVolumeConfiguration</code>.
5927
+ * For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html">Working with Amazon EFS access
5928
+ * points</a> in the <i>Amazon Elastic File System User Guide</i>.</p>
5662
5929
  */
5663
5930
  accessPointId?: string;
5664
5931
  /**
5665
5932
  * @public
5666
5933
  * <p>Determines whether to use the Amazon ECS task role defined in a task definition when
5667
- * mounting the Amazon EFS file system. If it is turned on, transit encryption must be turned on in the
5668
- * <code>EFSVolumeConfiguration</code>. If this parameter is omitted, the default value
5669
- * of <code>DISABLED</code> is used. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/efs-volumes.html#efs-volume-accesspoints">Using
5934
+ * mounting the Amazon EFS file system. If it is turned on, transit encryption must be turned on
5935
+ * in the <code>EFSVolumeConfiguration</code>. If this parameter is omitted, the default
5936
+ * value of <code>DISABLED</code> is used. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/efs-volumes.html#efs-volume-accesspoints">Using
5670
5937
  * Amazon EFS access points</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
5671
5938
  */
5672
5939
  iam?: EFSAuthorizationConfigIAM;
@@ -5710,9 +5977,9 @@ export interface EFSVolumeConfiguration {
5710
5977
  /**
5711
5978
  * @public
5712
5979
  * <p>Determines whether to use encryption for Amazon EFS data in transit between the Amazon ECS host
5713
- * and the Amazon EFS server. Transit encryption must be turned on if Amazon EFS IAM authorization is
5714
- * used. If this parameter is omitted, the default value of <code>DISABLED</code> is used.
5715
- * For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/encryption-in-transit.html">Encrypting data in transit</a> in
5980
+ * and the Amazon EFS server. Transit encryption must be turned on if Amazon EFS IAM authorization
5981
+ * is used. If this parameter is omitted, the default value of <code>DISABLED</code> is
5982
+ * used. For more information, see <a href="https://docs.aws.amazon.com/efs/latest/ug/encryption-in-transit.html">Encrypting data in transit</a> in
5716
5983
  * the <i>Amazon Elastic File System User Guide</i>.</p>
5717
5984
  */
5718
5985
  transitEncryption?: EFSTransitEncryption;
@@ -5799,22 +6066,30 @@ export interface HostVolumeProperties {
5799
6066
  }
5800
6067
  /**
5801
6068
  * @public
5802
- * <p>A data volume that's used in a task definition. For tasks that use the Amazon Elastic File System
5803
- * (Amazon EFS), specify an <code>efsVolumeConfiguration</code>. For Windows tasks that use
5804
- * Amazon FSx for Windows File Server file system, specify a
5805
- * <code>fsxWindowsFileServerVolumeConfiguration</code>. For tasks that use a Docker
5806
- * volume, specify a <code>DockerVolumeConfiguration</code>. For tasks that use a bind
5807
- * mount host volume, specify a <code>host</code> and optional <code>sourcePath</code>. For
5808
- * more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_data_volumes.html">Using Data Volumes in
5809
- * Tasks</a>.</p>
6069
+ * <p>The data volume configuration for tasks launched using this task definition.
6070
+ * Specifying a volume configuration in a task definition is optional. The volume
6071
+ * configuration may contain multiple volumes but only one volume configured at launch is
6072
+ * supported. Each volume defined in the volume configuration may only specify a
6073
+ * <code>name</code> and one of either <code>configuredAtLaunch</code>,
6074
+ * <code>dockerVolumeConfiguration</code>, <code>efsVolumeConfiguration</code>,
6075
+ * <code>fsxWindowsFileServerVolumeConfiguration</code>, or <code>host</code>. If an
6076
+ * empty volume configuration is specified, by default Amazon ECS uses a host volume. For more
6077
+ * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_data_volumes.html">Using data volumes in
6078
+ * tasks</a>.</p>
5810
6079
  */
5811
6080
  export interface Volume {
5812
6081
  /**
5813
6082
  * @public
5814
- * <p>The name of the volume. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. This name is referenced in the
5815
- * <code>sourceVolume</code> parameter of container definition
5816
- * <code>mountPoints</code>.</p>
5817
- * <p>This is required wwhen you use an Amazon EFS volume.</p>
6083
+ * <p>The name of the volume. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed.</p>
6084
+ * <p>When using a volume configured at launch, the <code>name</code> is required and must
6085
+ * also be specified as the volume name in the <code>ServiceVolumeConfiguration</code> or
6086
+ * <code>TaskVolumeConfiguration</code> parameter when creating your service or
6087
+ * standalone task.</p>
6088
+ * <p>For all other types of volumes, this name is referenced in the
6089
+ * <code>sourceVolume</code> parameter of the <code>mountPoints</code> object in the
6090
+ * container definition.</p>
6091
+ * <p>When a volume is using the <code>efsVolumeConfiguration</code>, the name is
6092
+ * required.</p>
5818
6093
  */
5819
6094
  name?: string;
5820
6095
  /**
@@ -5854,6 +6129,18 @@ export interface Volume {
5854
6129
  * storage.</p>
5855
6130
  */
5856
6131
  fsxWindowsFileServerVolumeConfiguration?: FSxWindowsFileServerVolumeConfiguration;
6132
+ /**
6133
+ * @public
6134
+ * <p>Indicates whether the volume should be configured at launch time. This is used to
6135
+ * create Amazon EBS volumes for standalone tasks or tasks created as part of a service. Each
6136
+ * task definition revision may only have one volume configured at launch in the volume
6137
+ * configuration.</p>
6138
+ * <p>To configure a volume at launch time, use this task definition revision and specify a
6139
+ * <code>volumeConfigurations</code> object when calling the
6140
+ * <code>CreateService</code>, <code>UpdateService</code>, <code>RunTask</code> or
6141
+ * <code>StartTask</code> APIs.</p>
6142
+ */
6143
+ configuredAtLaunch?: boolean;
5857
6144
  }
5858
6145
  /**
5859
6146
  * @public
@@ -5891,8 +6178,8 @@ export interface TaskDefinition {
5891
6178
  * <p>The short name or full Amazon Resource Name (ARN) of the Identity and Access Management role that grants containers in the
5892
6179
  * task permission to call Amazon Web Services APIs on your behalf. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html">Amazon ECS
5893
6180
  * Task Role</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
5894
- * <p>IAM roles for tasks on Windows require that the <code>-EnableTaskIAMRole</code> option
5895
- * is set when you launch the Amazon ECS-optimized Windows AMI. Your containers must also run some
6181
+ * <p>IAM roles for tasks on Windows require that the <code>-EnableTaskIAMRole</code>
6182
+ * option is set when you launch the Amazon ECS-optimized Windows AMI. Your containers must also run some
5896
6183
  * configuration code to use the feature. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/windows_task_IAM_roles.html">Windows IAM roles
5897
6184
  * for tasks</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
5898
6185
  */
@@ -6511,7 +6798,8 @@ export interface ContainerInstance {
6511
6798
  agentConnected?: boolean;
6512
6799
  /**
6513
6800
  * @public
6514
- * <p>The number of tasks on the container instance that have a desired status (<code>desiredStatus</code>) of <code>RUNNING</code>.</p>
6801
+ * <p>The number of tasks on the container instance that have a desired status
6802
+ * (<code>desiredStatus</code>) of <code>RUNNING</code>.</p>
6515
6803
  */
6516
6804
  runningTasksCount?: number;
6517
6805
  /**
@@ -7067,8 +7355,8 @@ export interface NetworkBinding {
7067
7355
  protocol?: TransportProtocol;
7068
7356
  /**
7069
7357
  * @public
7070
- * <p>The port number range on the container that's bound to the dynamically mapped host port
7071
- * range.</p>
7358
+ * <p>The port number range on the container that's bound to the dynamically mapped host
7359
+ * port range.</p>
7072
7360
  * <p>The following rules apply when you specify a <code>containerPortRange</code>:</p>
7073
7361
  * <ul>
7074
7362
  * <li>
@@ -7130,8 +7418,8 @@ export interface NetworkBinding {
7130
7418
  containerPortRange?: string;
7131
7419
  /**
7132
7420
  * @public
7133
- * <p>The port number range on the host that's used with the network binding. This is assigned is
7134
- * assigned by Docker and delivered by the Amazon ECS agent.</p>
7421
+ * <p>The port number range on the host that's used with the network binding. This is
7422
+ * assigned is assigned by Docker and delivered by the Amazon ECS agent.</p>
7135
7423
  */
7136
7424
  hostPortRange?: string;
7137
7425
  }
@@ -7259,8 +7547,9 @@ export interface Container {
7259
7547
  * in. An example of an empty container override is <code>\{"containerOverrides": [ ]
7260
7548
  * \}</code>. If a non-empty container override is specified, the <code>name</code>
7261
7549
  * parameter must be included.</p>
7262
- * <p>You can use Secrets Manager or Amazon Web Services Systems Manager Parameter Store to store the sensitive
7263
- * data. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/secrets-envvar.html">Retrieve secrets through environment variables</a> in the Amazon ECS Developer Guide.</p>
7550
+ * <p>You can use Secrets Manager or Amazon Web Services Systems Manager Parameter Store to store the
7551
+ * sensitive data. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/secrets-envvar.html">Retrieve secrets through
7552
+ * environment variables</a> in the Amazon ECS Developer Guide.</p>
7264
7553
  */
7265
7554
  export interface ContainerOverride {
7266
7555
  /**
@@ -7357,8 +7646,8 @@ export interface TaskOverride {
7357
7646
  inferenceAcceleratorOverrides?: InferenceAcceleratorOverride[];
7358
7647
  /**
7359
7648
  * @public
7360
- * <p>The Amazon Resource Name (ARN) of the task execution role override for the task. For more
7361
- * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_execution_IAM_role.html">Amazon ECS task
7649
+ * <p>The Amazon Resource Name (ARN) of the task execution role override for the task. For more information,
7650
+ * see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_execution_IAM_role.html">Amazon ECS task
7362
7651
  * execution IAM role</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
7363
7652
  */
7364
7653
  executionRoleArn?: string;
@@ -7369,8 +7658,8 @@ export interface TaskOverride {
7369
7658
  memory?: string;
7370
7659
  /**
7371
7660
  * @public
7372
- * <p>The Amazon Resource Name (ARN) of the role that containers in this task can assume. All containers
7373
- * in this task are granted the permissions that are specified in this role. For more
7661
+ * <p>The Amazon Resource Name (ARN) of the role that containers in this task can assume. All containers in
7662
+ * this task are granted the permissions that are specified in this role. For more
7374
7663
  * information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html">IAM Role for Tasks</a>
7375
7664
  * in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
7376
7665
  */
@@ -7656,7 +7945,8 @@ export interface Task {
7656
7945
  * @public
7657
7946
  * <p>The stop code indicating why a task was stopped. The <code>stoppedReason</code> might
7658
7947
  * contain additional details. </p>
7659
- * <p>For more information about stop code, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/userguide/stopped-task-error-codes.html">Stopped tasks error codes</a> in the <i>Amazon ECS User Guide</i>.</p>
7948
+ * <p>For more information about stop code, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/userguide/stopped-task-error-codes.html">Stopped tasks error
7949
+ * codes</a> in the <i>Amazon ECS User Guide</i>.</p>
7660
7950
  * <p>The following are valid values:</p>
7661
7951
  * <ul>
7662
7952
  * <li>
@@ -7988,8 +8278,8 @@ export interface ExecuteCommandResponse {
7988
8278
  * <p>The SSM agent is not installed or is not running</p>
7989
8279
  * </li>
7990
8280
  * <li>
7991
- * <p> There is an interface Amazon VPC endpoint for Amazon ECS, but there is not one for Systems
7992
- * Manager Session Manager</p>
8281
+ * <p> There is an interface Amazon VPC endpoint for Amazon ECS, but there is not one for
8282
+ * Systems Manager Session Manager</p>
7993
8283
  * </li>
7994
8284
  * </ul>
7995
8285
  * <p>For information about how to troubleshoot the issues, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html">Troubleshooting issues with ECS
@@ -8033,8 +8323,8 @@ export interface ProtectedTask {
8033
8323
  taskArn?: string;
8034
8324
  /**
8035
8325
  * @public
8036
- * <p>The protection status of the task. If scale-in protection is on for a task, the
8037
- * value is <code>true</code>. Otherwise, it is <code>false</code>.</p>
8326
+ * <p>The protection status of the task. If scale-in protection is on for a task, the value
8327
+ * is <code>true</code>. Otherwise, it is <code>false</code>.</p>
8038
8328
  */
8039
8329
  protectionEnabled?: boolean;
8040
8330
  /**
@@ -8058,8 +8348,8 @@ export interface GetTaskProtectionResponse {
8058
8348
  * <li>
8059
8349
  * <p>
8060
8350
  * <code>protectionEnabled</code>: The protection status of the task. If scale-in
8061
- * protection is turned on for a task, the value is <code>true</code>. Otherwise, it
8062
- * is <code>false</code>.</p>
8351
+ * protection is turned on for a task, the value is <code>true</code>. Otherwise,
8352
+ * it is <code>false</code>.</p>
8063
8353
  * </li>
8064
8354
  * <li>
8065
8355
  * <p>
@@ -8104,12 +8394,11 @@ export interface ListAccountSettingsRequest {
8104
8394
  value?: string;
8105
8395
  /**
8106
8396
  * @public
8107
- * <p>The ARN of the principal, which can be a user, role, or the root user. If
8108
- * this field is omitted, the account settings are listed only for the authenticated
8109
- * user.</p>
8397
+ * <p>The ARN of the principal, which can be a user, role, or the root user. If this field is
8398
+ * omitted, the account settings are listed only for the authenticated user.</p>
8110
8399
  * <note>
8111
- * <p>Federated users assume the account setting of the root user and can't have
8112
- * explicit account settings set for them.</p>
8400
+ * <p>Federated users assume the account setting of the root user and can't have explicit
8401
+ * account settings set for them.</p>
8113
8402
  * </note>
8114
8403
  */
8115
8404
  principalArn?: string;
@@ -8845,36 +9134,38 @@ export interface PutAccountSettingRequest {
8845
9134
  * <p>The account setting value for the specified principal ARN. Accepted values are
8846
9135
  * <code>enabled</code>, <code>disabled</code>, <code>on</code>, and
8847
9136
  * <code>off</code>.</p>
8848
- * <p>When you specify <code>fargateTaskRetirementWaitPeriod</code> for the <code>name</code>, the
8849
- * following are the valid values:</p>
9137
+ * <p>When you specify <code>fargateTaskRetirementWaitPeriod</code> for the
9138
+ * <code>name</code>, the following are the valid values:</p>
8850
9139
  * <ul>
8851
9140
  * <li>
8852
9141
  * <p>
8853
- * <code>0</code> - Amazon Web Services sends the notification, and immediately retires the affected tasks.</p>
9142
+ * <code>0</code> - Amazon Web Services sends the notification, and immediately retires the
9143
+ * affected tasks.</p>
8854
9144
  * </li>
8855
9145
  * <li>
8856
9146
  * <p>
8857
- * <code>7</code> - Amazon Web Services sends the notification, and waits 7 calendar days to retire the tasks.</p>
9147
+ * <code>7</code> - Amazon Web Services sends the notification, and waits 7 calendar days to
9148
+ * retire the tasks.</p>
8858
9149
  * </li>
8859
9150
  * <li>
8860
9151
  * <p>
8861
- * <code>14</code> - Amazon Web Services sends the notification, and waits 14 calendar days to retire the tasks.</p>
9152
+ * <code>14</code> - Amazon Web Services sends the notification, and waits 14 calendar days to
9153
+ * retire the tasks.</p>
8862
9154
  * </li>
8863
9155
  * </ul>
8864
9156
  */
8865
9157
  value: string | undefined;
8866
9158
  /**
8867
9159
  * @public
8868
- * <p>The ARN of the principal, which can be a user, role, or the root user. If
8869
- * you specify the root user, it modifies the account setting for all users, roles,
8870
- * and the root user of the account unless a user or role explicitly overrides these
8871
- * settings. If this field is omitted, the setting is changed only for the authenticated
8872
- * user.</p>
9160
+ * <p>The ARN of the principal, which can be a user, role, or the root user. If you specify
9161
+ * the root user, it modifies the account setting for all users, roles, and the root user of the
9162
+ * account unless a user or role explicitly overrides these settings. If this field is
9163
+ * omitted, the setting is changed only for the authenticated user.</p>
8873
9164
  * <note>
8874
9165
  * <p>You must use the root user when you set the Fargate wait time
8875
9166
  * (<code>fargateTaskRetirementWaitPeriod</code>). </p>
8876
- * <p>Federated users assume the account setting of the root user and can't have
8877
- * explicit account settings set for them.</p>
9167
+ * <p>Federated users assume the account setting of the root user and can't have explicit
9168
+ * account settings set for them.</p>
8878
9169
  * </note>
8879
9170
  */
8880
9171
  principalArn?: string;
@@ -8909,12 +9200,13 @@ export interface PutAccountSettingDefaultRequest {
8909
9200
  * default wait time to retire a Fargate task due to required maintenance is
8910
9201
  * affected.</p>
8911
9202
  * <p>When you specify <code>fargateFIPSMode</code> for the <code>name</code> and
8912
- * <code>enabled</code> for the <code>value</code>, Fargate uses FIPS-140 compliant
9203
+ * <code>enabled</code> for the <code>value</code>, Fargate uses FIPS-140 compliant
8913
9204
  * cryptographic algorithms on your tasks. For more information about FIPS-140 compliance
8914
- * with Fargate, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-fips-compliance.html"> Amazon Web Services Fargate Federal Information Processing Standard (FIPS) 140-2
8915
- * compliance</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
8916
- * <p>When Amazon Web Services determines that a security or infrastructure update is needed for an Amazon ECS task
8917
- * hosted on Fargate, the tasks need to be stopped and new tasks launched to replace
9205
+ * with Fargate, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-fips-compliance.html"> Amazon Web Services Fargate
9206
+ * Federal Information Processing Standard (FIPS) 140-2 compliance</a> in the
9207
+ * <i>Amazon Elastic Container Service Developer Guide</i>.</p>
9208
+ * <p>When Amazon Web Services determines that a security or infrastructure update is needed for an Amazon ECS
9209
+ * task hosted on Fargate, the tasks need to be stopped and new tasks launched to replace
8918
9210
  * them. Use <code>fargateTaskRetirementWaitPeriod</code> to set the wait time to retire a
8919
9211
  * Fargate task to the default. For information about the Fargate tasks maintenance,
8920
9212
  * see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-maintenance.html">Amazon Web Services Fargate task
@@ -8934,15 +9226,18 @@ export interface PutAccountSettingDefaultRequest {
8934
9226
  * <ul>
8935
9227
  * <li>
8936
9228
  * <p>
8937
- * <code>0</code> - Amazon Web Services sends the notification, and immediately retires the affected tasks.</p>
9229
+ * <code>0</code> - Amazon Web Services sends the notification, and immediately retires the
9230
+ * affected tasks.</p>
8938
9231
  * </li>
8939
9232
  * <li>
8940
9233
  * <p>
8941
- * <code>7</code> - Amazon Web Services sends the notification, and waits 7 calendar days to retire the tasks.</p>
9234
+ * <code>7</code> - Amazon Web Services sends the notification, and waits 7 calendar days to
9235
+ * retire the tasks.</p>
8942
9236
  * </li>
8943
9237
  * <li>
8944
9238
  * <p>
8945
- * <code>14</code> - Amazon Web Services sends the notification, and waits 14 calendar days to retire the tasks.</p>
9239
+ * <code>14</code> - Amazon Web Services sends the notification, and waits 14 calendar days to
9240
+ * retire the tasks.</p>
8946
9241
  * </li>
8947
9242
  * </ul>
8948
9243
  */
@@ -9503,8 +9798,8 @@ export interface RegisterTaskDefinitionRequest {
9503
9798
  * tasks hosted on Fargate. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/userguide/using_data_volumes.html">Fargate task
9504
9799
  * storage</a> in the <i>Amazon ECS User Guide for Fargate</i>.</p>
9505
9800
  * <note>
9506
- * <p>For tasks using the Fargate launch type, the task requires
9507
- * the following platforms:</p>
9801
+ * <p>For tasks using the Fargate launch type, the task requires the
9802
+ * following platforms:</p>
9508
9803
  * <ul>
9509
9804
  * <li>
9510
9805
  * <p>Linux platform version <code>1.4.0</code> or later.</p>
@@ -9562,12 +9857,11 @@ export declare class BlockedException extends __BaseException {
9562
9857
  * <p>To fix this issue:</p>
9563
9858
  * <ul>
9564
9859
  * <li>
9565
- * <p>Run <code>RunTask</code> with a unique
9566
- * <code>clientToken</code>.</p>
9860
+ * <p>Run <code>RunTask</code> with a unique <code>clientToken</code>.</p>
9567
9861
  * </li>
9568
9862
  * <li>
9569
- * <p>Run <code>RunTask</code> with the <code>clientToken</code> and the original set of
9570
- * parameters</p>
9863
+ * <p>Run <code>RunTask</code> with the <code>clientToken</code> and the original
9864
+ * set of parameters</p>
9571
9865
  * </li>
9572
9866
  * </ul>
9573
9867
  */
@@ -9576,7 +9870,8 @@ export declare class ConflictException extends __BaseException {
9576
9870
  readonly $fault: "client";
9577
9871
  /**
9578
9872
  * @public
9579
- * <p>The existing task ARNs which are already associated with the <code>clientToken</code>.</p>
9873
+ * <p>The existing task ARNs which are already associated with the
9874
+ * <code>clientToken</code>.</p>
9580
9875
  */
9581
9876
  resourceIds?: string[];
9582
9877
  /**
@@ -9584,6 +9879,216 @@ export declare class ConflictException extends __BaseException {
9584
9879
  */
9585
9880
  constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
9586
9881
  }
9882
+ /**
9883
+ * @public
9884
+ * <p>The termination policy for the Amazon EBS volume when the task exits. For more information,
9885
+ * see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html#ebs-volume-types">Amazon ECS volume termination policy</a>.</p>
9886
+ */
9887
+ export interface TaskManagedEBSVolumeTerminationPolicy {
9888
+ /**
9889
+ * @public
9890
+ * <p>Indicates whether the volume should be deleted on when the task stops. If a value of
9891
+ * <code>true</code> is specified,
9892
+ Amazon ECS deletes the Amazon EBS volume on your behalf when
9893
+ * the task goes into the <code>STOPPED</code> state. If no value is specified, the
9894
+ *
9895
+ default value is <code>true</code> is used. When set to <code>false</code>, Amazon ECS
9896
+ * leaves the volume in your
9897
+ account.</p>
9898
+ */
9899
+ deleteOnTermination: boolean | undefined;
9900
+ }
9901
+ /**
9902
+ * @public
9903
+ * <p>The configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf.
9904
+ * These settings are used to create each Amazon EBS volume, with one volume created for each
9905
+ * task.</p>
9906
+ */
9907
+ export interface TaskManagedEBSVolumeConfiguration {
9908
+ /**
9909
+ * @public
9910
+ * <p>Indicates whether the volume should be encrypted. If no value is specified, encryption
9911
+ * is turned on by default. This parameter maps 1:1 with the <code>Encrypted</code>
9912
+ * parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in
9913
+ * the <i>Amazon EC2 API Reference</i>.</p>
9914
+ */
9915
+ encrypted?: boolean;
9916
+ /**
9917
+ * @public
9918
+ * <p>The Amazon Resource Name (ARN) identifier of the Amazon Web Services Key Management Service key to use for Amazon EBS encryption. When
9919
+ * encryption is turned on and no Amazon Web Services Key Management Service key is specified, the default Amazon Web Services managed key
9920
+ * for Amazon EBS volumes is used. This parameter maps 1:1 with the <code>KmsKeyId</code>
9921
+ * parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in
9922
+ * the <i>Amazon EC2 API Reference</i>.</p>
9923
+ * <important>
9924
+ * <p>Amazon Web Services authenticates the Amazon Web Services Key Management Service key asynchronously. Therefore, if you specify an
9925
+ * ID, alias, or ARN that is invalid, the action can appear to complete, but
9926
+ * eventually fails.</p>
9927
+ * </important>
9928
+ */
9929
+ kmsKeyId?: string;
9930
+ /**
9931
+ * @public
9932
+ * <p>The volume type. This parameter maps 1:1 with the <code>VolumeType</code> parameter of
9933
+ * the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>. For more
9934
+ * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html">Amazon EBS volume types</a> in
9935
+ * the <i>Amazon EC2 User Guide</i>.</p>
9936
+ * <p>The following are the supported volume types.</p>
9937
+ * <ul>
9938
+ * <li>
9939
+ * <p>General Purpose SSD: <code>gp2</code>|<code>gp3</code>
9940
+ * </p>
9941
+ * </li>
9942
+ * <li>
9943
+ * <p>Provisioned IOPS SSD: <code>io1</code>|<code>io2</code>
9944
+ * </p>
9945
+ * </li>
9946
+ * <li>
9947
+ * <p>Throughput Optimized HDD: <code>st1</code>
9948
+ * </p>
9949
+ * </li>
9950
+ * <li>
9951
+ * <p>Cold HDD: <code>sc1</code>
9952
+ * </p>
9953
+ * </li>
9954
+ * <li>
9955
+ * <p>Magnetic: <code>standard</code>
9956
+ * </p>
9957
+ * <note>
9958
+ * <p>The magnetic volume type is not supported on Fargate.</p>
9959
+ * </note>
9960
+ * </li>
9961
+ * </ul>
9962
+ */
9963
+ volumeType?: string;
9964
+ /**
9965
+ * @public
9966
+ * <p>The size of the volume in GiB. You must specify either a volume size or a snapshot ID.
9967
+ * If you specify a snapshot ID, the snapshot size is used for the volume size by default.
9968
+ * You can optionally specify a volume size greater than or equal to the snapshot size.
9969
+ * This parameter maps 1:1 with the <code>Size</code> parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>.</p>
9970
+ * <p>The following are the supported volume size values for each volume type.</p>
9971
+ * <ul>
9972
+ * <li>
9973
+ * <p>
9974
+ * <code>gp2</code> and <code>gp3</code>: 1-16,384</p>
9975
+ * </li>
9976
+ * <li>
9977
+ * <p>
9978
+ * <code>io1</code> and <code>io2</code>: 4-16,384</p>
9979
+ * </li>
9980
+ * <li>
9981
+ * <p>
9982
+ * <code>st1</code> and <code>sc1</code>: 125-16,384</p>
9983
+ * </li>
9984
+ * <li>
9985
+ * <p>
9986
+ * <code>standard</code>: 1-1,024</p>
9987
+ * </li>
9988
+ * </ul>
9989
+ */
9990
+ sizeInGiB?: number;
9991
+ /**
9992
+ * @public
9993
+ * <p>The snapshot that Amazon ECS uses to create the volume. You must specify either a snapshot
9994
+ * ID or a volume size. This parameter maps 1:1 with the <code>SnapshotId</code> parameter
9995
+ * of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in
9996
+ * the <i>Amazon EC2 API Reference</i>.</p>
9997
+ */
9998
+ snapshotId?: string;
9999
+ /**
10000
+ * @public
10001
+ * <p>The number of I/O operations per second (IOPS). For <code>gp3</code>,
10002
+ * <code>io1</code>, and <code>io2</code> volumes, this represents the number of IOPS that
10003
+ * are provisioned for the volume. For <code>gp2</code> volumes, this represents the
10004
+ * baseline performance of the volume and the rate at which the volume accumulates I/O
10005
+ * credits for bursting.</p>
10006
+ * <p>The following are the supported values for each volume type.</p>
10007
+ * <ul>
10008
+ * <li>
10009
+ * <p>
10010
+ * <code>gp3</code>: 3,000 - 16,000 IOPS</p>
10011
+ * </li>
10012
+ * <li>
10013
+ * <p>
10014
+ * <code>io1</code>: 100 - 64,000 IOPS</p>
10015
+ * </li>
10016
+ * <li>
10017
+ * <p>
10018
+ * <code>io2</code>: 100 - 256,000 IOPS</p>
10019
+ * </li>
10020
+ * </ul>
10021
+ * <p>This parameter is required for <code>io1</code> and <code>io2</code> volume types. The
10022
+ * default for <code>gp3</code> volumes is <code>3,000 IOPS</code>. This parameter is not
10023
+ * supported for <code>st1</code>, <code>sc1</code>, or <code>standard</code> volume
10024
+ * types.</p>
10025
+ * <p>This parameter maps 1:1 with the <code>Iops</code> parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>.</p>
10026
+ */
10027
+ iops?: number;
10028
+ /**
10029
+ * @public
10030
+ * <p>The throughput to provision for a volume, in MiB/s, with a maximum of 1,000 MiB/s.
10031
+ * This parameter maps 1:1 with the <code>Throughput</code> parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>.</p>
10032
+ * <important>
10033
+ * <p>This parameter is only supported for the <code>gp3</code> volume type.</p>
10034
+ * </important>
10035
+ */
10036
+ throughput?: number;
10037
+ /**
10038
+ * @public
10039
+ * <p>The tags to apply to the volume. Amazon ECS applies service-managed tags by default. This
10040
+ * parameter maps 1:1 with the <code>TagSpecifications.N</code> parameter of the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html">CreateVolume API</a> in the <i>Amazon EC2 API Reference</i>.</p>
10041
+ */
10042
+ tagSpecifications?: EBSTagSpecification[];
10043
+ /**
10044
+ * @public
10045
+ * <p>The ARN of the IAM role to associate with this volume. This is the Amazon ECS
10046
+ * infrastructure IAM role that is used to manage your Amazon Web Services infrastructure. We recommend
10047
+ * using the Amazon ECS-managed <code>AmazonECSInfrastructureRolePolicyForVolumes</code> IAM
10048
+ * policy with this role. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/infrastructure_IAM_role.html">Amazon ECS
10049
+ * infrastructure IAM role</a> in the <i>Amazon ECS Developer
10050
+ * Guide</i>.</p>
10051
+ */
10052
+ roleArn: string | undefined;
10053
+ /**
10054
+ * @public
10055
+ * <p>The termination policy for the volume when the task exits. This provides a way to
10056
+ * control whether Amazon ECS terminates the Amazon EBS volume when the task stops.</p>
10057
+ */
10058
+ terminationPolicy?: TaskManagedEBSVolumeTerminationPolicy;
10059
+ /**
10060
+ * @public
10061
+ * <p>The Linux filesystem type for the volume. For volumes created from a snapshot, you
10062
+ * must specify the same filesystem type that the volume was using when the snapshot was
10063
+ * created. If there is a filesystem type mismatch, the task will fail to start.</p>
10064
+ * <p>The available filesystem types are
10065
+ <code>ext3</code>, <code>ext4</code>, and
10066
+ * <code>xfs</code>. If no value is specified, the <code>xfs</code> filesystem type is
10067
+ * used by default.</p>
10068
+ */
10069
+ filesystemType?: TaskFilesystemType;
10070
+ }
10071
+ /**
10072
+ * @public
10073
+ * <p>Configuration settings for the task volume that was <code>configuredAtLaunch</code>
10074
+ * that weren't set during <code>RegisterTaskDef</code>.</p>
10075
+ */
10076
+ export interface TaskVolumeConfiguration {
10077
+ /**
10078
+ * @public
10079
+ * <p>The name of the volume. This value must match the volume name from the
10080
+ * <code>Volume</code> object in the task definition.</p>
10081
+ */
10082
+ name: string | undefined;
10083
+ /**
10084
+ * @public
10085
+ * <p>The configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf.
10086
+ * These settings are used to create each Amazon EBS volume, with one volume created for each
10087
+ * task. The Amazon EBS volumes are visible in your account in the Amazon EC2 console once they are
10088
+ * created.</p>
10089
+ */
10090
+ managedEBSVolume?: TaskManagedEBSVolumeConfiguration;
10091
+ }
9587
10092
  /**
9588
10093
  * @public
9589
10094
  */
@@ -9717,12 +10222,12 @@ export interface RunTaskRequest {
9717
10222
  referenceId?: string;
9718
10223
  /**
9719
10224
  * @public
9720
- * <p>An optional tag specified when a task is started. For example, if you automatically trigger
9721
- * a task to run a batch process job, you could apply a unique identifier for that job to
9722
- * your task with the <code>startedBy</code> parameter. You can then identify which tasks
9723
- * belong to that job by filtering the results of a <a>ListTasks</a> call with
9724
- * the <code>startedBy</code> value. Up to 128 letters (uppercase and lowercase), numbers,
9725
- * hyphens (-), and underscores (_) are allowed.</p>
10225
+ * <p>An optional tag specified when a task is started. For example, if you automatically
10226
+ * trigger a task to run a batch process job, you could apply a unique identifier for that
10227
+ * job to your task with the <code>startedBy</code> parameter. You can then identify which
10228
+ * tasks belong to that job by filtering the results of a <a>ListTasks</a> call
10229
+ * with the <code>startedBy</code> value. Up to 128 letters (uppercase and lowercase),
10230
+ * numbers, hyphens (-), and underscores (_) are allowed.</p>
9726
10231
  * <p>If a task is started by an Amazon ECS service, then the <code>startedBy</code> parameter
9727
10232
  * contains the deployment ID of the service that starts it.</p>
9728
10233
  */
@@ -9769,8 +10274,8 @@ export interface RunTaskRequest {
9769
10274
  * <p>The <code>family</code> and <code>revision</code> (<code>family:revision</code>) or
9770
10275
  * full ARN of the task definition to run. If a <code>revision</code> isn't specified,
9771
10276
  * the latest <code>ACTIVE</code> revision is used.</p>
9772
- * <p>When you create a policy for run-task, you can set the resource to be the latest
9773
- * task definition revision, or a specific revision.</p>
10277
+ * <p>When you create a policy for run-task, you can set the resource to be the latest task
10278
+ * definition revision, or a specific revision.</p>
9774
10279
  * <p>The full ARN value must match the value that you specified as the
9775
10280
  * <code>Resource</code> of the principal's permissions policy.</p>
9776
10281
  * <p>When you specify the policy resource as the latest task definition version (by setting
@@ -9789,11 +10294,18 @@ export interface RunTaskRequest {
9789
10294
  taskDefinition: string | undefined;
9790
10295
  /**
9791
10296
  * @public
9792
- * <p>An identifier that you provide to ensure the idempotency of the request. It must be unique
9793
- * and is case sensitive. Up to 64 characters are allowed. The valid characters are characters in the range of 33-126, inclusive. For more information, see
9794
- * <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/ECS_Idempotency.html">Ensuring idempotency</a>.</p>
10297
+ * <p>An identifier that you provide to ensure the idempotency of the request. It must be
10298
+ * unique and is case sensitive. Up to 64 characters are allowed. The valid characters are
10299
+ * characters in the range of 33-126, inclusive. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/ECS_Idempotency.html">Ensuring idempotency</a>.</p>
9795
10300
  */
9796
10301
  clientToken?: string;
10302
+ /**
10303
+ * @public
10304
+ * <p>The details of the volume that was <code>configuredAtLaunch</code>. You can configure
10305
+ * the size, volumeType, IOPS, throughput, snapshot and encryption in in <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TaskManagedEBSVolumeConfiguration.html">TaskManagedEBSVolumeConfiguration</a>. The <code>name</code> of the volume must
10306
+ * match the <code>name</code> from the task definition.</p>
10307
+ */
10308
+ volumeConfigurations?: TaskVolumeConfiguration[];
9797
10309
  }
9798
10310
  /**
9799
10311
  * @public
@@ -9838,8 +10350,8 @@ export interface StartTaskRequest {
9838
10350
  /**
9839
10351
  * @public
9840
10352
  * <p>Whether or not the execute command functionality is turned on for the task. If
9841
- * <code>true</code>, this turns on the execute command functionality on all containers in
9842
- * the task.</p>
10353
+ * <code>true</code>, this turns on the execute command functionality on all containers
10354
+ * in the task.</p>
9843
10355
  */
9844
10356
  enableExecuteCommand?: boolean;
9845
10357
  /**
@@ -9935,6 +10447,13 @@ export interface StartTaskRequest {
9935
10447
  * the latest <code>ACTIVE</code> revision is used.</p>
9936
10448
  */
9937
10449
  taskDefinition: string | undefined;
10450
+ /**
10451
+ * @public
10452
+ * <p>The details of the volume that was <code>configuredAtLaunch</code>. You can configure
10453
+ * the size, volumeType, IOPS, throughput, snapshot and encryption in <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TaskManagedEBSVolumeConfiguration.html">TaskManagedEBSVolumeConfiguration</a>. The <code>name</code> of the volume must
10454
+ * match the <code>name</code> from the task definition.</p>
10455
+ */
10456
+ volumeConfigurations?: TaskVolumeConfiguration[];
9938
10457
  }
9939
10458
  /**
9940
10459
  * @public
@@ -10310,9 +10829,9 @@ export interface AutoScalingGroupProviderUpdate {
10310
10829
  * <p>When using managed termination protection, managed scaling must also be used
10311
10830
  * otherwise managed termination protection doesn't work.</p>
10312
10831
  * </important>
10313
- * <p>When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto
10314
- * Scaling group that contain tasks from being terminated during a scale-in action. The
10315
- * Auto Scaling group and each instance in the Auto Scaling group must have instance
10832
+ * <p>When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an
10833
+ * Auto Scaling group that contain tasks from being terminated during a scale-in action.
10834
+ * The Auto Scaling group and each instance in the Auto Scaling group must have instance
10316
10835
  * protection from scale-in actions on. For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection">Instance Protection</a> in the <i>Auto Scaling User Guide</i>.</p>
10317
10836
  * <p>When managed termination protection is off, your Amazon EC2 instances aren't protected from
10318
10837
  * termination when the Auto Scaling group scales in.</p>
@@ -10321,7 +10840,6 @@ export interface AutoScalingGroupProviderUpdate {
10321
10840
  /**
10322
10841
  * @public
10323
10842
  * <p>The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.</p>
10324
- * <p>The default is <code>ENABLED</code>.</p>
10325
10843
  */
10326
10844
  managedDraining?: ManagedDraining;
10327
10845
  }
@@ -10721,6 +11239,15 @@ export interface UpdateServiceRequest {
10721
11239
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html">Service Connect</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
10722
11240
  */
10723
11241
  serviceConnectConfiguration?: ServiceConnectConfiguration;
11242
+ /**
11243
+ * @public
11244
+ * <p>The details of the volume that was <code>configuredAtLaunch</code>. You can configure
11245
+ * the size, volumeType, IOPS, throughput, snapshot and encryption in <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ServiceManagedEBSVolumeConfiguration.html">ServiceManagedEBSVolumeConfiguration</a>. The <code>name</code> of the volume
11246
+ * must match the <code>name</code> from the task definition. If set to null, no new
11247
+ * deployment is triggered. Otherwise, if this configuration differs from the existing one,
11248
+ * it triggers a new deployment.</p>
11249
+ */
11250
+ volumeConfigurations?: ServiceVolumeConfiguration[];
10724
11251
  }
10725
11252
  /**
10726
11253
  * @public
@@ -10812,8 +11339,8 @@ export interface UpdateTaskProtectionResponse {
10812
11339
  * <li>
10813
11340
  * <p>
10814
11341
  * <code>protectionEnabled</code>: The protection status of the task. If scale-in
10815
- * protection is turned on for a task, the value is <code>true</code>. Otherwise, it
10816
- * is <code>false</code>.</p>
11342
+ * protection is turned on for a task, the value is <code>true</code>. Otherwise,
11343
+ * it is <code>false</code>.</p>
10817
11344
  * </li>
10818
11345
  * <li>
10819
11346
  * <p>