@aws-sdk/client-imagebuilder 3.797.0 → 3.798.0

package/dist-cjs/index.js

@@ -136,6 +136,7 @@ __export(index_exports, {
   ServiceException: () => ServiceException,
   ServiceQuotaExceededException: () => ServiceQuotaExceededException,
   ServiceUnavailableException: () => ServiceUnavailableException,
+  SsmParameterDataType: () => SsmParameterDataType,
   StartImagePipelineExecutionCommand: () => StartImagePipelineExecutionCommand,
   StartResourceStateUpdateCommand: () => StartResourceStateUpdateCommand,
   TagResourceCommand: () => TagResourceCommand,
@@ -623,6 +624,10 @@ var DiskImageFormat = {
   VHD: "VHD",
   VMDK: "VMDK"
 };
+var SsmParameterDataType = {
+  AWS_EC2_IMAGE: "aws:ec2:image",
+  TEXT: "text"
+};
 var OnWorkflowFailure = {
   ABORT: "ABORT",
   CONTINUE: "CONTINUE"
@@ -5186,6 +5191,7 @@ var paginateListWorkflows = (0, import_core.createPaginator)(ImagebuilderClient,
   ServiceQuotaExceededException,
   ResourceAlreadyExistsException,
   DiskImageFormat,
+  SsmParameterDataType,
   OnWorkflowFailure,
   PipelineExecutionStartCondition,
   PipelineStatus,

package/dist-es/models/index.js

@@ -1 +1,2 @@
 export * from "./models_0";
+export * from "./models_1";

package/dist-es/models/models_0.js

@@ -203,6 +203,10 @@ export const DiskImageFormat = {
     VHD: "VHD",
     VMDK: "VMDK",
 };
+export const SsmParameterDataType = {
+    AWS_EC2_IMAGE: "aws:ec2:image",
+    TEXT: "text",
+};
 export const OnWorkflowFailure = {
     ABORT: "ABORT",
     CONTINUE: "CONTINUE",

package/dist-es/models/models_1.js

@@ -0,0 +1 @@
+export {};

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

@@ -107,6 +107,13 @@ declare const CreateDistributionConfigurationCommand_base: {
  *           accountId: "STRING_VALUE",
  *         },
  *       ],
+ *       ssmParameterConfigurations: [ // SsmParameterConfigurationList
+ *         { // SsmParameterConfiguration
+ *           amiAccountId: "STRING_VALUE",
+ *           parameterName: "STRING_VALUE", // required
+ *           dataType: "text" || "aws:ec2:image",
+ *         },
+ *       ],
  *     },
  *   ],
  *   tags: {

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

@@ -114,6 +114,13 @@ declare const GetDistributionConfigurationCommand_base: {
  * //             accountId: "STRING_VALUE",
  * //           },
  * //         ],
+ * //         ssmParameterConfigurations: [ // SsmParameterConfigurationList
+ * //           { // SsmParameterConfiguration
+ * //             amiAccountId: "STRING_VALUE",
+ * //             parameterName: "STRING_VALUE", // required
+ * //             dataType: "text" || "aws:ec2:image",
+ * //           },
+ * //         ],
  * //       },
  * //     ],
  * //     timeoutMinutes: Number("int"), // required

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

@@ -274,6 +274,13 @@ declare const GetImageCommand_base: {
  * //               accountId: "STRING_VALUE",
  * //             },
  * //           ],
+ * //           ssmParameterConfigurations: [ // SsmParameterConfigurationList
+ * //             { // SsmParameterConfiguration
+ * //               amiAccountId: "STRING_VALUE",
+ * //               parameterName: "STRING_VALUE", // required
+ * //               dataType: "text" || "aws:ec2:image",
+ * //             },
+ * //           ],
  * //         },
  * //       ],
  * //       timeoutMinutes: Number("int"), // required

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

@@ -107,6 +107,13 @@ declare const UpdateDistributionConfigurationCommand_base: {
  *           accountId: "STRING_VALUE",
  *         },
  *       ],
+ *       ssmParameterConfigurations: [ // SsmParameterConfigurationList
+ *         { // SsmParameterConfiguration
+ *           amiAccountId: "STRING_VALUE",
+ *           parameterName: "STRING_VALUE", // required
+ *           dataType: "text" || "aws:ec2:image",
+ *         },
+ *       ],
  *     },
  *   ],
  *   clientToken: "STRING_VALUE", // required

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

@@ -1,7 +1,8 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 import { ImagebuilderClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ImagebuilderClient";
-import { UpdateLifecyclePolicyRequest, UpdateLifecyclePolicyResponse } from "../models/models_0";
+import { UpdateLifecyclePolicyRequest } from "../models/models_0";
+import { UpdateLifecyclePolicyResponse } from "../models/models_1";
 /**
  * @public
  */

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

@@ -1 +1,2 @@
 export * from "./models_0";
+export * from "./models_1";

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

@@ -1046,8 +1046,10 @@ export interface InstanceBlockDeviceMapping {
  */
 export interface InstanceConfiguration {
     /**
-     * <p>The AMI ID to use as the base image for a container build and test instance. If not
-     * 			specified, Image Builder will use the appropriate ECS-optimized AMI as a base image.</p>
+     * <p>The base image for a container build and test instance. This can contain an AMI ID
+     * 			or it can specify an Amazon Web Services Systems Manager (SSM) Parameter Store Parameter, prefixed by <code>ssm:</code>,
+     * 			followed by the parameter name or ARN.</p>
+     *          <p>If not specified, Image Builder uses the appropriate ECS-optimized AMI as a base image.</p>
      * @public
      */
     image?: string | undefined;
@@ -1164,7 +1166,9 @@ export interface ContainerRecipe {
      */
     encrypted?: boolean | undefined;
     /**
-     * <p>The base image for the container recipe.</p>
+     * <p>The base image for customizations specified in the container recipe. This can
+     * 			contain an Image Builder image resource ARN or a container image URI, for example
+     * 			<code>amazonlinux:latest</code>.</p>
      * @public
      */
     parentImage?: string | undefined;
@@ -1674,6 +1678,45 @@ export interface S3ExportConfiguration {
      */
     s3Prefix?: string | undefined;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const SsmParameterDataType: {
+    readonly AWS_EC2_IMAGE: "aws:ec2:image";
+    readonly TEXT: "text";
+};
+/**
+ * @public
+ */
+export type SsmParameterDataType = (typeof SsmParameterDataType)[keyof typeof SsmParameterDataType];
+/**
+ * <p>Configuration for a single Parameter in the Amazon Web Services Systems Manager (SSM) Parameter Store in
+ * 			a given Region.</p>
+ * @public
+ */
+export interface SsmParameterConfiguration {
+    /**
+     * <p>Specify the account that will own the Parameter in a given Region. During distribution,
+     * 			this account must be specified in distribution settings as a target account for the
+     * 			Region.</p>
+     * @public
+     */
+    amiAccountId?: string | undefined;
+    /**
+     * <p>This is the name of the Parameter in the target Region or account. The image
+     * 			distribution creates the Parameter if it doesn't already exist. Otherwise, it updates
+     * 			the parameter.</p>
+     * @public
+     */
+    parameterName: string | undefined;
+    /**
+     * <p>The data type specifies what type of value the Parameter contains. We recommend that
+     * 			you use data type <code>aws:ec2:image</code>.</p>
+     * @public
+     */
+    dataType?: SsmParameterDataType | undefined;
+}
 /**
  * <p>Defines the settings for a specific Region.</p>
  * @public
@@ -1708,8 +1751,8 @@ export interface Distribution {
      */
     launchTemplateConfigurations?: LaunchTemplateConfiguration[] | undefined;
     /**
-     * <p>Configure export settings to deliver disk images created from your image build, using
-     * 			a file format that is compatible with your VMs in that Region.</p>
+     * <p>Configure export settings to deliver disk images created from your image build,
+     * 			using a file format that is compatible with your VMs in that Region.</p>
      * @public
      */
     s3ExportConfiguration?: S3ExportConfiguration | undefined;
@@ -1718,6 +1761,12 @@ export interface Distribution {
      * @public
      */
     fastLaunchConfigurations?: FastLaunchConfiguration[] | undefined;
+    /**
+     * <p>Contains settings to update Amazon Web Services Systems Manager (SSM) Parameter Store Parameters with
+     * 			output AMI IDs from the build by target Region.</p>
+     * @public
+     */
+    ssmParameterConfigurations?: SsmParameterConfiguration[] | undefined;
 }
 /**
  * @public
@@ -3270,8 +3319,8 @@ export interface DistributionConfiguration {
      */
     description?: string | undefined;
     /**
-     * <p>The distribution objects that apply Region-specific settings for the deployment of the
-     * 			image to targeted Regions.</p>
+     * <p>The distribution objects that apply Region-specific settings for the deployment of
+     * 			the image to targeted Regions.</p>
      * @public
      */
     distributions?: Distribution[] | undefined;
@@ -3566,7 +3615,23 @@ export interface ImageRecipe {
      */
     components?: ComponentConfiguration[] | undefined;
     /**
-     * <p>The base image of the image recipe.</p>
+     * <p>The base image for customizations specified in the image recipe. You can specify the
+     * 			parent image using one of the following options:</p>
+     *          <ul>
+     *             <li>
+     *                <p>AMI ID</p>
+     *             </li>
+     *             <li>
+     *                <p>Image Builder image Amazon Resource Name (ARN)</p>
+     *             </li>
+     *             <li>
+     *                <p>Amazon Web Services Systems Manager (SSM) Parameter Store Parameter, prefixed by <code>ssm:</code>,
+     * 					followed by the parameter name or ARN.</p>
+     *             </li>
+     *             <li>
+     *                <p>Amazon Web Services Marketplace product ID</p>
+     *             </li>
+     *          </ul>
      * @public
      */
     parentImage?: string | undefined;
@@ -8295,13 +8360,3 @@ export interface UpdateLifecyclePolicyRequest {
      */
     clientToken?: string | undefined;
 }
-/**
- * @public
- */
-export interface UpdateLifecyclePolicyResponse {
-    /**
-     * <p>The ARN of the image lifecycle policy resource that was updated.</p>
-     * @public
-     */
-    lifecyclePolicyArn?: string | undefined;
-}

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

@@ -0,0 +1,10 @@
+/**
+ * @public
+ */
+export interface UpdateLifecyclePolicyResponse {
+    /**
+     * <p>The ARN of the image lifecycle policy resource that was updated.</p>
+     * @public
+     */
+    lifecyclePolicyArn?: string | undefined;
+}

package/dist-types/ts3.4/commands/UpdateLifecyclePolicyCommand.d.ts

@@ -5,10 +5,8 @@ import {
   ServiceInputTypes,
   ServiceOutputTypes,
 } from "../ImagebuilderClient";
-import {
-  UpdateLifecyclePolicyRequest,
-  UpdateLifecyclePolicyResponse,
-} from "../models/models_0";
+import { UpdateLifecyclePolicyRequest } from "../models/models_0";
+import { UpdateLifecyclePolicyResponse } from "../models/models_1";
 export { __MetadataBearer };
 export { $Command };
 export interface UpdateLifecyclePolicyCommandInput

package/dist-types/ts3.4/models/index.d.ts

@@ -1 +1,2 @@
 export * from "./models_0";
+export * from "./models_1";

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

@@ -420,6 +420,17 @@ export interface S3ExportConfiguration {
   s3Bucket: string | undefined;
   s3Prefix?: string | undefined;
 }
+export declare const SsmParameterDataType: {
+  readonly AWS_EC2_IMAGE: "aws:ec2:image";
+  readonly TEXT: "text";
+};
+export type SsmParameterDataType =
+  (typeof SsmParameterDataType)[keyof typeof SsmParameterDataType];
+export interface SsmParameterConfiguration {
+  amiAccountId?: string | undefined;
+  parameterName: string | undefined;
+  dataType?: SsmParameterDataType | undefined;
+}
 export interface Distribution {
   region: string | undefined;
   amiDistributionConfiguration?: AmiDistributionConfiguration | undefined;
@@ -430,6 +441,7 @@ export interface Distribution {
   launchTemplateConfigurations?: LaunchTemplateConfiguration[] | undefined;
   s3ExportConfiguration?: S3ExportConfiguration | undefined;
   fastLaunchConfigurations?: FastLaunchConfiguration[] | undefined;
+  ssmParameterConfigurations?: SsmParameterConfiguration[] | undefined;
 }
 export interface CreateDistributionConfigurationRequest {
   name: string | undefined;
@@ -1903,6 +1915,3 @@ export interface UpdateLifecyclePolicyRequest {
   resourceSelection: LifecyclePolicyResourceSelection | undefined;
   clientToken?: string | undefined;
 }
-export interface UpdateLifecyclePolicyResponse {
-  lifecyclePolicyArn?: string | undefined;
-}

package/dist-types/ts3.4/models/models_1.d.ts

@@ -0,0 +1,3 @@
+export interface UpdateLifecyclePolicyResponse {
+  lifecyclePolicyArn?: string | undefined;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-imagebuilder",
   "description": "AWS SDK for JavaScript Imagebuilder Client for Node.js, Browser and React Native",
-  "version": "3.797.0",
+  "version": "3.798.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-imagebuilder",
@@ -20,38 +20,38 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/core": "3.796.0",
-    "@aws-sdk/credential-provider-node": "3.797.0",
+    "@aws-sdk/core": "3.798.0",
+    "@aws-sdk/credential-provider-node": "3.798.0",
     "@aws-sdk/middleware-host-header": "3.775.0",
     "@aws-sdk/middleware-logger": "3.775.0",
     "@aws-sdk/middleware-recursion-detection": "3.775.0",
-    "@aws-sdk/middleware-user-agent": "3.796.0",
+    "@aws-sdk/middleware-user-agent": "3.798.0",
     "@aws-sdk/region-config-resolver": "3.775.0",
     "@aws-sdk/types": "3.775.0",
     "@aws-sdk/util-endpoints": "3.787.0",
     "@aws-sdk/util-user-agent-browser": "3.775.0",
-    "@aws-sdk/util-user-agent-node": "3.796.0",
+    "@aws-sdk/util-user-agent-node": "3.798.0",
     "@smithy/config-resolver": "^4.1.0",
-    "@smithy/core": "^3.2.0",
+    "@smithy/core": "^3.3.0",
     "@smithy/fetch-http-handler": "^5.0.2",
     "@smithy/hash-node": "^4.0.2",
     "@smithy/invalid-dependency": "^4.0.2",
     "@smithy/middleware-content-length": "^4.0.2",
-    "@smithy/middleware-endpoint": "^4.1.0",
-    "@smithy/middleware-retry": "^4.1.0",
+    "@smithy/middleware-endpoint": "^4.1.1",
+    "@smithy/middleware-retry": "^4.1.1",
     "@smithy/middleware-serde": "^4.0.3",
     "@smithy/middleware-stack": "^4.0.2",
     "@smithy/node-config-provider": "^4.0.2",
     "@smithy/node-http-handler": "^4.0.4",
     "@smithy/protocol-http": "^5.1.0",
-    "@smithy/smithy-client": "^4.2.0",
+    "@smithy/smithy-client": "^4.2.1",
     "@smithy/types": "^4.2.0",
     "@smithy/url-parser": "^4.0.2",
     "@smithy/util-base64": "^4.0.0",
     "@smithy/util-body-length-browser": "^4.0.0",
     "@smithy/util-body-length-node": "^4.0.0",
-    "@smithy/util-defaults-mode-browser": "^4.0.8",
-    "@smithy/util-defaults-mode-node": "^4.0.8",
+    "@smithy/util-defaults-mode-browser": "^4.0.9",
+    "@smithy/util-defaults-mode-node": "^4.0.9",
     "@smithy/util-endpoints": "^3.0.2",
     "@smithy/util-middleware": "^4.0.2",
     "@smithy/util-retry": "^4.0.2",