@aws-sdk/client-ecs 3.306.0 → 3.307.0

package/dist-types/ECS.d.ts

@@ -109,6 +109,9 @@ export declare class ECS extends ECSClient {
      * 			the number of tasks running in a service drops below the <code>desiredCount</code>,
      * 			Amazon ECS runs another copy of the task in the specified cluster. To update an existing
      * 			service, see the <a>UpdateService</a> action.</p>
+     *          <note>
+     *             <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service. </p>
+     *          </note>
      *          <p>In addition to maintaining the desired count of tasks in your service, you can
      * 			optionally run your service behind one or more load balancers. The load balancers
      * 			distribute traffic across the tasks that are associated with the service. For more
@@ -641,6 +644,9 @@ export declare class ECS extends ECSClient {
      * 				<a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html">Scheduling Tasks</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
      *          <p>Alternatively, you can use <a>StartTask</a> to use your own scheduler or
      * 			place tasks manually on specific container instances.</p>
+     *          <note>
+     *             <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service. </p>
+     *          </note>
      *          <p>The Amazon ECS API follows an eventual consistency model. This is because of the
      * 			distributed nature of the system supporting the API. This means that the result of an
      * 			API command you run that affects your Amazon ECS resources might not be immediately visible
@@ -671,6 +677,9 @@ export declare class ECS extends ECSClient {
      * @public
      * <p>Starts a new task from the specified task definition on the specified container
      * 			instance or instances.</p>
+     *          <note>
+     *             <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service. </p>
+     *          </note>
      *          <p>Alternatively, you can use <a>RunTask</a> to place tasks for you. For more
      * 			information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html">Scheduling Tasks</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
      */

package/dist-types/commands/CreateServiceCommand.d.ts

@@ -23,6 +23,9 @@ export interface CreateServiceCommandOutput extends CreateServiceResponse, __Met
  * 			the number of tasks running in a service drops below the <code>desiredCount</code>,
  * 			Amazon ECS runs another copy of the task in the specified cluster. To update an existing
  * 			service, see the <a>UpdateService</a> action.</p>
+ *          <note>
+ *             <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service. </p>
+ *          </note>
  *          <p>In addition to maintaining the desired count of tasks in your service, you can
  * 			optionally run your service behind one or more load balancers. The load balancers
  * 			distribute traffic across the tasks that are associated with the service. For more

package/dist-types/commands/RunTaskCommand.d.ts

@@ -25,6 +25,9 @@ export interface RunTaskCommandOutput extends RunTaskResponse, __MetadataBearer
  * 				<a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html">Scheduling Tasks</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
  *          <p>Alternatively, you can use <a>StartTask</a> to use your own scheduler or
  * 			place tasks manually on specific container instances.</p>
+ *          <note>
+ *             <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service. </p>
+ *          </note>
  *          <p>The Amazon ECS API follows an eventual consistency model. This is because of the
  * 			distributed nature of the system supporting the API. This means that the result of an
  * 			API command you run that affects your Amazon ECS resources might not be immediately visible

package/dist-types/commands/StartTaskCommand.d.ts

@@ -21,6 +21,9 @@ export interface StartTaskCommandOutput extends StartTaskResponse, __MetadataBea
  * @public
  * <p>Starts a new task from the specified task definition on the specified container
  * 			instance or instances.</p>
+ *          <note>
+ *             <p>Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service. </p>
+ *          </note>
  *          <p>Alternatively, you can use <a>RunTask</a> to place tasks for you. For more
  * 			information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html">Scheduling Tasks</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
  * @example

package/dist-types/models/models_0.d.ts

@@ -70,9 +70,12 @@ export interface ManagedScaling {
      */
     status?: ManagedScalingStatus | string;
     /**
-     * <p>The target capacity value for the capacity provider. The specified value must be
-     * 			greater than <code>0</code> and less than or equal to <code>100</code>. A value of
-     * 				<code>100</code> results in the Amazon EC2 instances in your Auto Scaling group being
+     * <p>The target capacity utilization as a percentage for the capacity provider. The
+     * 			specified value must be greater than <code>0</code> and less than or equal to
+     * 				<code>100</code>. For example, if you want the capacity provider to maintain 10%
+     * 			spare capacity, then that means the utilization is 90%, so use a
+     * 				<code>targetCapacity</code> of <code>90</code>. The default value of
+     * 				<code>100</code> percent results in the Amazon EC2 instances in your Auto Scaling group being
      * 			completely used.</p>
      */
     targetCapacity?: number;
@@ -1246,8 +1249,6 @@ export type LaunchType = (typeof LaunchType)[keyof typeof LaunchType];
 /**
  * @public
  * <p>The load balancer configuration to use with a service or task set.</p>
- *          <p>For specific notes and restrictions regarding the use of load balancers with services
- * 			and task sets, see the CreateService and CreateTaskSet actions.</p>
  *          <p>When you add, update, or remove a load balancer configuration, Amazon ECS starts a new
  * 			deployment with the updated Elastic Load Balancing configuration. This causes tasks to register to and
  * 			deregister from load balancers.</p>
@@ -1632,7 +1633,7 @@ export interface ServiceConnectService {
      * <p>The <code>discoveryName</code> is the name of the new Cloud Map service that Amazon ECS creates
      * 			for this Amazon ECS service. This must be unique within the Cloud Map namespace. The name can contain up to 64 characters. The name can include lowercase letters,
      * 			numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.</p>
-     *          <p>If this parameter isn't specified, the default value of <code>discoveryName.namespace</code> is used. If the <code>discoveryName</code> isn't specified, the port mapping name from the task definition is used in <code>portName.namespace</code>.</p>
+     *          <p>If the <code>discoveryName</code> isn't specified, the port mapping name from the task definition is used in <code>portName.namespace</code>.</p>
      */
     discoveryName?: string;
     /**
@@ -2048,7 +2049,7 @@ export interface CreateServiceRequest {
     /**
      * <p>Specifies whether to propagate the tags from the task definition to the task. If no
      * 			value is specified, the tags aren't propagated. Tags can only be propagated to the task
-     * 			during task creation. To add tags to a task after task creation, use the <a>TagResource</a> API action.</p>
+     * 			during task creation. To add tags to a task after task creation, use the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html">TagResource</a> API action.</p>
      */
     propagateTags?: PropagateTags | string;
     /**
@@ -2098,7 +2099,7 @@ export interface ServiceConnectServiceResource {
      *          <p>The <code>discoveryName</code> is the name of the new Cloud Map service that Amazon ECS creates
      * 			for this Amazon ECS service. This must be unique within the Cloud Map namespace. The name can contain up to 64 characters. The name can include lowercase letters,
      * 			numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.</p>
-     *          <p>If this parameter isn't specified, the default value of <code>discoveryName.namespace</code> is used. If the <code>discoveryName</code> isn't specified, the port mapping name from the task definition is used in <code>portName.namespace</code>.</p>
+     *          <p>If the <code>discoveryName</code> isn't specified, the port mapping name from the task definition is used in <code>portName.namespace</code>.</p>
      */
     discoveryName?: string;
     /**
@@ -2498,7 +2499,7 @@ export interface TaskSet {
 }
 /**
  * @public
- * <p>Details on a service within a cluster</p>
+ * <p>Details on a service within a cluster.</p>
  */
 export interface Service {
     /**
@@ -3428,7 +3429,7 @@ export interface FirelensConfiguration {
  * <p>An object representing a container health check. Health check parameters that are
  * 			specified in a container definition override any Docker health checks that exist in the
  * 			container image (such as those specified in a parent image or from the image's
- * 			Dockerfile).</p>
+ * 			Dockerfile). This configuration maps to the <code>HEALTHCHECK</code> parameter of <a href="https://docs.docker.com/engine/reference/run/">docker run</a>.</p>
  *          <note>
  *             <p>The Amazon ECS container agent only monitors and reports on the health checks specified
  * 				in the task definition. Amazon ECS does not monitor Docker health checks that are
@@ -3457,8 +3458,8 @@ export interface FirelensConfiguration {
  *             </li>
  *          </ul>
  *          <p>The following describes the possible <code>healthStatus</code> values for a task. The
- * 			container health check status of nonessential containers only affects the health status
- * 			of a task if no essential containers have health checks defined.</p>
+ * 			container health check status of
+ * 			non-essential containers don't have an effect on the health status of a task.</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -3473,22 +3474,15 @@ export interface FirelensConfiguration {
  *             <li>
  *                <p>
  *                   <code>UNKNOWN</code>-The essential containers within the task are still
- * 					having their health checks evaluated or there are only nonessential containers
- * 					with health checks defined.</p>
+ * 					having their health checks evaluated, there are only nonessential containers
+ * 					with health checks defined, or there are no container health checks
+ * 					defined.</p>
  *             </li>
  *          </ul>
  *          <p>If a task is run manually, and not as part of a service, the task will continue its
  * 			lifecycle regardless of its health status. For tasks that are part of a service, if the
  * 			task reports as unhealthy then the task will be stopped and the service scheduler will
  * 			replace it.</p>
- *          <important>
- *             <p>For tasks that are a part of a service and the service uses the <code>ECS</code>
- * 				rolling deployment type, the deployment is paused while the new tasks have the
- * 					<code>UNKNOWN</code> task health check status. For example, tasks that define
- * 				health checks for nonessential containers when no essential containers have health
- * 				checks will have the <code>UNKNOWN</code> health check status indefinitely which
- * 				prevents the deployment from completing.</p>
- *          </important>
  *          <p>The following are notes about container health check support:</p>
  *          <ul>
  *             <li>
@@ -3664,7 +3658,7 @@ export interface Tmpfs {
 }
 /**
  * @public
- * <p>Linux-specific options that are applied to the container, such as Linux <a>KernelCapabilities</a>.</p>
+ * <p>The Linux-specific options that are applied to the container, such as Linux <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_KernelCapabilities.html">KernelCapabilities</a>.</p>
  */
 export interface LinuxParameters {
     /**
@@ -3746,7 +3740,7 @@ export interface LinuxParameters {
 }
 /**
  * @public
- * <p>Details for a volume mount point that's used in a container definition.</p>
+ * <p>The details for a volume mount point that's used in a container definition.</p>
  */
 export interface MountPoint {
     /**
@@ -3855,7 +3849,7 @@ export interface PortMapping {
      * 			Amazon ECS container agent ports 51678-51680. Any host port that was previously specified in
      * 			a running task is also reserved while the task is running. That is, after a task stops,
      * 			the host port is released. The current reserved ports are displayed in the
-     * 				<code>remainingResources</code> of <a>DescribeContainerInstances</a>
+     * 			<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 reserved ports at a time. This number
      * 			includes the default reserved ports. Automatically assigned ports aren't included in the
      * 			100 reserved ports quota.</p>
@@ -3985,9 +3979,9 @@ export declare const ResourceType: {
 export type ResourceType = (typeof ResourceType)[keyof typeof ResourceType];
 /**
  * @public
- * <p>The type and amount of a resource to assign to a container. The supported resource
- * 			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
- * 				GPUs on Amazon ECS</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html">Working with
+ * <p>The type and amount of a resource to assign to a container. The supported resource 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
+ * 				GPUs on Amazon ECS</a> or <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/url-ecs-dev;ecs-inference.html">Working with
  * 				Amazon Elastic Inference on Amazon ECS</a> in the <i>Amazon Elastic Container Service Developer Guide</i>
  *          </p>
  */
@@ -3999,7 +3993,7 @@ export interface ResourceRequirement {
      * 			of GPUs that's reserved for all containers in a task can't exceed the number of
      * 			available GPUs on the container instance that the task is launched on.</p>
      *          <p>If the <code>InferenceAccelerator</code> type is used, the <code>value</code> matches
-     * 			the <code>deviceName</code> for an <a>InferenceAccelerator</a> specified in a
+     * 			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>
      */
     value: string | undefined;
@@ -4783,7 +4777,7 @@ export interface EphemeralStorage {
 export interface InferenceAccelerator {
     /**
      * <p>The Elastic Inference accelerator device name. The <code>deviceName</code> must also
-     * 			be referenced in a container definition as a <a>ResourceRequirement</a>.</p>
+     * 			be referenced in a container definition as a <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ResourceRequirement.html">ResourceRequirement</a>.</p>
      */
     deviceName: string | undefined;
     /**
@@ -5397,8 +5391,8 @@ export interface TaskDefinition {
      */
     runtimePlatform?: RuntimePlatform;
     /**
-     * <p>The task launch types the task definition was validated against. To determine which
-     * 			task launch types the task definition is validated for, see the <a>TaskDefinition$compatibilities</a> parameter.</p>
+     * <p>The task launch types the task definition was validated against.  For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html">Amazon ECS launch types</a>
+     * 			in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
      */
     requiresCompatibilities?: (Compatibility | string)[];
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-ecs",
   "description": "AWS SDK for JavaScript Ecs Client for Node.js, Browser and React Native",
-  "version": "3.306.0",
+  "version": "3.307.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",