feat(client-ecs): This release introduces support for configuring the version consistency feature for individual containers defined within a task definition. The configuration allows to specify whether ECS should resolve the container image tag specified in the container definition to an image digest.

awstools · awstools · commit d632c0c49327 · 2024-11-19T20:36:46.000Z
diff --git a/clients/client-ecs/src/commands/DeleteTaskDefinitionsCommand.ts b/clients/client-ecs/src/commands/DeleteTaskDefinitionsCommand.ts
@@ -168,6 +168,7 @@ export interface DeleteTaskDefinitionsCommandOutput extends DeleteTaskDefinition
  * //           ],
  * //           startTimeout: Number("int"),
  * //           stopTimeout: Number("int"),
+ * //           versionConsistency: "enabled" || "disabled",
  * //           hostname: "STRING_VALUE",
  * //           user: "STRING_VALUE",
  * //           workingDirectory: "STRING_VALUE",
diff --git a/clients/client-ecs/src/commands/DeregisterTaskDefinitionCommand.ts b/clients/client-ecs/src/commands/DeregisterTaskDefinitionCommand.ts
@@ -165,6 +165,7 @@ export interface DeregisterTaskDefinitionCommandOutput extends DeregisterTaskDef
  * //         ],
  * //         startTimeout: Number("int"),
  * //         stopTimeout: Number("int"),
+ * //         versionConsistency: "enabled" || "disabled",
  * //         hostname: "STRING_VALUE",
  * //         user: "STRING_VALUE",
  * //         workingDirectory: "STRING_VALUE",
diff --git a/clients/client-ecs/src/commands/DescribeTaskDefinitionCommand.ts b/clients/client-ecs/src/commands/DescribeTaskDefinitionCommand.ts
@@ -158,6 +158,7 @@ export interface DescribeTaskDefinitionCommandOutput extends DescribeTaskDefinit
  * //         ],
  * //         startTimeout: Number("int"),
  * //         stopTimeout: Number("int"),
+ * //         versionConsistency: "enabled" || "disabled",
  * //         hostname: "STRING_VALUE",
  * //         user: "STRING_VALUE",
  * //         workingDirectory: "STRING_VALUE",
diff --git a/clients/client-ecs/src/commands/RegisterTaskDefinitionCommand.ts b/clients/client-ecs/src/commands/RegisterTaskDefinitionCommand.ts
@@ -160,6 +160,7 @@ export interface RegisterTaskDefinitionCommandOutput extends RegisterTaskDefinit
  *       ],
  *       startTimeout: Number("int"),
  *       stopTimeout: Number("int"),
+ *       versionConsistency: "enabled" || "disabled",
  *       hostname: "STRING_VALUE",
  *       user: "STRING_VALUE",
  *       workingDirectory: "STRING_VALUE",
@@ -419,6 +420,7 @@ export interface RegisterTaskDefinitionCommandOutput extends RegisterTaskDefinit
  * //         ],
  * //         startTimeout: Number("int"),
  * //         stopTimeout: Number("int"),
+ * //         versionConsistency: "enabled" || "disabled",
  * //         hostname: "STRING_VALUE",
  * //         user: "STRING_VALUE",
  * //         workingDirectory: "STRING_VALUE",
diff --git a/clients/client-ecs/src/commands/UpdateCapacityProviderCommand.ts b/clients/client-ecs/src/commands/UpdateCapacityProviderCommand.ts
@@ -6,8 +6,7 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { ECSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ECSClient";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { UpdateCapacityProviderRequest } from "../models/models_0";
-import { UpdateCapacityProviderResponse } from "../models/models_1";
+import { UpdateCapacityProviderRequest, UpdateCapacityProviderResponse } from "../models/models_1";
 import { de_UpdateCapacityProviderCommand, se_UpdateCapacityProviderCommand } from "../protocols/Aws_json1_1";
 
 /**
diff --git a/clients/client-ecs/src/models/models_0.ts b/clients/client-ecs/src/models/models_0.ts
@@ -5513,6 +5513,20 @@ export interface Ulimit {
   hardLimit: number | undefined;
 }
 
+/**
+ * @public
+ * @enum
+ */
+export const VersionConsistency = {
+  DISABLED: "disabled",
+  ENABLED: "enabled",
+} as const;
+
+/**
+ * @public
+ */
+export type VersionConsistency = (typeof VersionConsistency)[keyof typeof VersionConsistency];
+
 /**
  * <p>Details on a data volume from another container in the same task definition.</p>
  * @public
@@ -5933,6 +5947,17 @@ export interface ContainerDefinition {
    */
   stopTimeout?: number | undefined;
 
+  /**
+   * <p>Specifies whether Amazon ECS will resolve the container image tag
+   * 			provided in the container definition to an image digest. By default, the
+   * 			value is <code>enabled</code>. If you set the value for a container as
+   * 			<code>disabled</code>, Amazon ECS will not resolve the provided container image tag
+   * 			to a digest and will use the original image URI specified in the container definition for deployment.
+   * 			For more information about container image resolution, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html#deployment-container-image-stability">Container image resolution</a> in the <i>Amazon ECS Developer Guide</i>.</p>
+   * @public
+   */
+  versionConsistency?: VersionConsistency | undefined;
+
   /**
    * <p>The hostname to use for your container. This parameter maps to <code>Hostname</code> in the docker
    * 			container create command and the <code>--hostname</code> option to docker run.</p>
@@ -12687,24 +12712,6 @@ export interface AutoScalingGroupProviderUpdate {
   managedDraining?: ManagedDraining | undefined;
 }
 
-/**
- * @public
- */
-export interface UpdateCapacityProviderRequest {
-  /**
-   * <p>The name of the capacity provider to update.</p>
-   * @public
-   */
-  name: string | undefined;
-
-  /**
-   * <p>An object that represent the parameters to update for the Auto Scaling group capacity
-   * 			provider.</p>
-   * @public
-   */
-  autoScalingGroupProvider: AutoScalingGroupProviderUpdate | undefined;
-}
-
 /**
  * @internal
  */
diff --git a/clients/client-ecs/src/models/models_1.ts b/clients/client-ecs/src/models/models_1.ts
@@ -4,6 +4,7 @@ import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-cli
 import { ECSServiceException as __BaseException } from "./ECSServiceException";
 
 import {
+  AutoScalingGroupProviderUpdate,
   CapacityProvider,
   CapacityProviderStrategyItem,
   Cluster,
@@ -29,6 +30,24 @@ import {
   VpcLatticeConfiguration,
 } from "./models_0";
 
+/**
+ * @public
+ */
+export interface UpdateCapacityProviderRequest {
+  /**
+   * <p>The name of the capacity provider to update.</p>
+   * @public
+   */
+  name: string | undefined;
+
+  /**
+   * <p>An object that represent the parameters to update for the Auto Scaling group capacity
+   * 			provider.</p>
+   * @public
+   */
+  autoScalingGroupProvider: AutoScalingGroupProviderUpdate | undefined;
+}
+
 /**
  * @public
  */
diff --git a/clients/client-ecs/src/protocols/Aws_json1_1.ts b/clients/client-ecs/src/protocols/Aws_json1_1.ts
@@ -378,7 +378,6 @@ import {
   Ulimit,
   UnsupportedFeatureException,
   UntagResourceRequest,
-  UpdateCapacityProviderRequest,
   UpdateInProgressException,
   VersionInfo,
   Volume,
@@ -388,6 +387,7 @@ import {
 import {
   MissingVersionException,
   NoUpdateAvailableException,
+  UpdateCapacityProviderRequest,
   UpdateClusterRequest,
   UpdateClusterSettingsRequest,
   UpdateContainerAgentRequest,
diff --git a/codegen/sdk-codegen/aws-models/ecs.json b/codegen/sdk-codegen/aws-models/ecs.json
@@ -2412,6 +2412,12 @@
             "smithy.api#documentation": "<p>Time duration (in seconds) to wait before the container is forcefully killed if it doesn't exit\n\t\t\tnormally on its own.</p>\n         <p>For tasks using the Fargate launch type, the task or service requires the following\n\t\t\tplatforms:</p>\n         <ul>\n            <li>\n               <p>Linux platform version <code>1.3.0</code> or later.</p>\n            </li>\n            <li>\n               <p>Windows platform version <code>1.0.0</code> or later.</p>\n            </li>\n         </ul>\n         <p>For tasks that use the Fargate launch type, the max stop timeout value is 120 seconds and if the\n\t\t\tparameter is not specified, the default value of 30 seconds is used.</p>\n         <p>For tasks that use the EC2 launch type, if the <code>stopTimeout</code> parameter isn't\n\t\t\tspecified, the value set for the Amazon ECS container agent configuration variable\n\t\t\t\t<code>ECS_CONTAINER_STOP_TIMEOUT</code> is used. If neither the <code>stopTimeout</code> parameter\n\t\t\tor the <code>ECS_CONTAINER_STOP_TIMEOUT</code> agent configuration variable are set, then the default\n\t\t\tvalues of 30 seconds for Linux containers and 30 seconds on Windows containers are used. Your container\n\t\t\tinstances require at least version 1.26.0 of the container agent to use a container stop timeout value.\n\t\t\tHowever, we recommend using the latest container agent version. For information about checking your\n\t\t\tagent version and updating to the latest version, see <a href=\"https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html\">Updating the Amazon ECS Container\n\t\t\t\tAgent</a> in the <i>Amazon Elastic Container Service Developer Guide</i>. If you're using an Amazon ECS-optimized Linux AMI, your instance needs at\n\t\t\tleast version 1.26.0-1 of the <code>ecs-init</code> package. If your container instances are launched\n\t\t\tfrom version <code>20190301</code> or later, then they contain the required versions of the container\n\t\t\tagent and <code>ecs-init</code>. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html\">Amazon ECS-optimized Linux AMI</a> in the\n\t\t\t<i>Amazon Elastic Container Service Developer Guide</i>.</p>\n         <p>The valid values for Fargate are 2-120 seconds.</p>"
           }
         },
+        "versionConsistency": {
+          "target": "com.amazonaws.ecs#VersionConsistency",
+          "traits": {
+            "smithy.api#documentation": "<p>Specifies whether Amazon ECS will resolve the container image tag\n\t\t\tprovided in the container definition to an image digest. By default, the\n\t\t\tvalue is <code>enabled</code>. If you set the value for a container as\n\t\t\t<code>disabled</code>, Amazon ECS will not resolve the provided container image tag\n\t\t\tto a digest and will use the original image URI specified in the container definition for deployment.\n\t\t\tFor more information about container image resolution, see <a href=\"https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html#deployment-container-image-stability\">Container image resolution</a> in the <i>Amazon ECS Developer Guide</i>.</p>"
+          }
+        },
         "hostname": {
           "target": "com.amazonaws.ecs#String",
           "traits": {
@@ -14218,6 +14224,23 @@
         "smithy.api#output": {}
       }
     },
+    "com.amazonaws.ecs#VersionConsistency": {
+      "type": "enum",
+      "members": {
+        "ENABLED": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "enabled"
+          }
+        },
+        "DISABLED": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "disabled"
+          }
+        }
+      }
+    },
     "com.amazonaws.ecs#VersionInfo": {
       "type": "structure",
       "members": {
