@aws-sdk/client-imagebuilder 3.936.0 → 3.939.0

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

@@ -0,0 +1,127 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ImagebuilderClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ImagebuilderClient";
+import { DistributeImageRequest, DistributeImageResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link DistributeImageCommand}.
+ */
+export interface DistributeImageCommandInput extends DistributeImageRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link DistributeImageCommand}.
+ */
+export interface DistributeImageCommandOutput extends DistributeImageResponse, __MetadataBearer {
+}
+declare const DistributeImageCommand_base: {
+    new (input: DistributeImageCommandInput): import("@smithy/smithy-client").CommandImpl<DistributeImageCommandInput, DistributeImageCommandOutput, ImagebuilderClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: DistributeImageCommandInput): import("@smithy/smithy-client").CommandImpl<DistributeImageCommandInput, DistributeImageCommandOutput, ImagebuilderClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>DistributeImage distributes existing AMIs to additional regions and accounts without rebuilding the image.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ImagebuilderClient, DistributeImageCommand } from "@aws-sdk/client-imagebuilder"; // ES Modules import
+ * // const { ImagebuilderClient, DistributeImageCommand } = require("@aws-sdk/client-imagebuilder"); // CommonJS import
+ * // import type { ImagebuilderClientConfig } from "@aws-sdk/client-imagebuilder";
+ * const config = {}; // type is ImagebuilderClientConfig
+ * const client = new ImagebuilderClient(config);
+ * const input = { // DistributeImageRequest
+ *   sourceImage: "STRING_VALUE", // required
+ *   distributionConfigurationArn: "STRING_VALUE", // required
+ *   executionRole: "STRING_VALUE", // required
+ *   tags: { // TagMap
+ *     "<keys>": "STRING_VALUE",
+ *   },
+ *   clientToken: "STRING_VALUE", // required
+ *   loggingConfiguration: { // ImageLoggingConfiguration
+ *     logGroupName: "STRING_VALUE",
+ *   },
+ * };
+ * const command = new DistributeImageCommand(input);
+ * const response = await client.send(command);
+ * // { // DistributeImageResponse
+ * //   clientToken: "STRING_VALUE",
+ * //   imageBuildVersionArn: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param DistributeImageCommandInput - {@link DistributeImageCommandInput}
+ * @returns {@link DistributeImageCommandOutput}
+ * @see {@link DistributeImageCommandInput} for command's `input` shape.
+ * @see {@link DistributeImageCommandOutput} for command's `response` shape.
+ * @see {@link ImagebuilderClientResolvedConfig | config} for ImagebuilderClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You do not have permissions to perform the requested operation.</p>
+ *
+ * @throws {@link CallRateLimitExceededException} (client fault)
+ *  <p>You have exceeded the permitted request rate for the specific operation.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action, such as using an action or
+ * 			resource on behalf of a user that doesn't have permissions to use the action or
+ * 			resource, or specifying an invalid resource identifier.</p>
+ *
+ * @throws {@link ForbiddenException} (client fault)
+ *  <p>You are not authorized to perform the requested operation.</p>
+ *
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
+ *  <p>You have specified a client token for an operation using parameter values that differ
+ * 			from a previous request that used the same client token.</p>
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>You have requested an action that that the service doesn't support.</p>
+ *
+ * @throws {@link ResourceInUseException} (client fault)
+ *  <p>The resource that you are trying to operate on is currently in use. Review the message
+ * 			details and retry later.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>At least one of the resources referenced by your request does not exist.</p>
+ *
+ * @throws {@link ServiceException} (server fault)
+ *  <p>This exception is thrown when the service encounters an unrecoverable
+ * 			exception.</p>
+ *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>You have exceeded the number of permitted resources or operations for this service.
+ * 			For service quotas, see <a href="https://docs.aws.amazon.com/general/latest/gr/imagebuilder.html#limits_imagebuilder">EC2 Image Builder endpoints and
+ * 				quotas</a>.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service is unable to process your request at this time.</p>
+ *
+ * @throws {@link TooManyRequestsException} (client fault)
+ *  <p>You have attempted too many requests for the specific operation.</p>
+ *
+ * @throws {@link ImagebuilderServiceException}
+ * <p>Base exception class for all service exceptions from Imagebuilder service.</p>
+ *
+ *
+ * @public
+ */
+export declare class DistributeImageCommand extends DistributeImageCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: DistributeImageRequest;
+            output: DistributeImageResponse;
+        };
+        sdk: {
+            input: DistributeImageCommandInput;
+            output: DistributeImageCommandOutput;
+        };
+    };
+}

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

@@ -85,6 +85,12 @@ declare const GetComponentCommand_base: {
  * //       },
  * //     ],
  * //   },
+ * //   latestVersionReferences: { // LatestVersionReferences
+ * //     latestVersionArn: "STRING_VALUE",
+ * //     latestMajorVersionArn: "STRING_VALUE",
+ * //     latestMinorVersionArn: "STRING_VALUE",
+ * //     latestPatchVersionArn: "STRING_VALUE",
+ * //   },
  * // };
  *
  * ```

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

@@ -98,6 +98,12 @@ declare const GetContainerRecipeCommand_base: {
  * //       repositoryName: "STRING_VALUE", // required
  * //     },
  * //   },
+ * //   latestVersionReferences: { // LatestVersionReferences
+ * //     latestVersionArn: "STRING_VALUE",
+ * //     latestMajorVersionArn: "STRING_VALUE",
+ * //     latestMinorVersionArn: "STRING_VALUE",
+ * //     latestPatchVersionArn: "STRING_VALUE",
+ * //   },
  * // };
  *
  * ```

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

@@ -355,6 +355,12 @@ declare const GetImageCommand_base: {
  * //       logGroupName: "STRING_VALUE",
  * //     },
  * //   },
+ * //   latestVersionReferences: { // LatestVersionReferences
+ * //     latestVersionArn: "STRING_VALUE",
+ * //     latestMajorVersionArn: "STRING_VALUE",
+ * //     latestMinorVersionArn: "STRING_VALUE",
+ * //     latestPatchVersionArn: "STRING_VALUE",
+ * //   },
  * // };
  *
  * ```

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

@@ -97,6 +97,12 @@ declare const GetImageRecipeCommand_base: {
  * //       "<keys>": "STRING_VALUE",
  * //     },
  * //   },
+ * //   latestVersionReferences: { // LatestVersionReferences
+ * //     latestVersionArn: "STRING_VALUE",
+ * //     latestMajorVersionArn: "STRING_VALUE",
+ * //     latestMinorVersionArn: "STRING_VALUE",
+ * //     latestPatchVersionArn: "STRING_VALUE",
+ * //   },
  * // };
  *
  * ```

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

@@ -71,6 +71,12 @@ declare const GetWorkflowCommand_base: {
  * //       },
  * //     ],
  * //   },
+ * //   latestVersionReferences: { // LatestVersionReferences
+ * //     latestVersionArn: "STRING_VALUE",
+ * //     latestMajorVersionArn: "STRING_VALUE",
+ * //     latestMinorVersionArn: "STRING_VALUE",
+ * //     latestPatchVersionArn: "STRING_VALUE",
+ * //   },
  * // };
  *
  * ```

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

@@ -60,6 +60,7 @@ declare const ListWorkflowExecutionsCommand_base: {
  * //       startTime: "STRING_VALUE",
  * //       endTime: "STRING_VALUE",
  * //       parallelGroup: "STRING_VALUE",
+ * //       retried: true || false,
  * //     },
  * //   ],
  * //   imageBuildVersionArn: "STRING_VALUE",

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

@@ -0,0 +1,105 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ImagebuilderClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ImagebuilderClient";
+import { RetryImageRequest, RetryImageResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link RetryImageCommand}.
+ */
+export interface RetryImageCommandInput extends RetryImageRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link RetryImageCommand}.
+ */
+export interface RetryImageCommandOutput extends RetryImageResponse, __MetadataBearer {
+}
+declare const RetryImageCommand_base: {
+    new (input: RetryImageCommandInput): import("@smithy/smithy-client").CommandImpl<RetryImageCommandInput, RetryImageCommandOutput, ImagebuilderClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: RetryImageCommandInput): import("@smithy/smithy-client").CommandImpl<RetryImageCommandInput, RetryImageCommandOutput, ImagebuilderClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>RetryImage retries an image distribution without rebuilding the image.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ImagebuilderClient, RetryImageCommand } from "@aws-sdk/client-imagebuilder"; // ES Modules import
+ * // const { ImagebuilderClient, RetryImageCommand } = require("@aws-sdk/client-imagebuilder"); // CommonJS import
+ * // import type { ImagebuilderClientConfig } from "@aws-sdk/client-imagebuilder";
+ * const config = {}; // type is ImagebuilderClientConfig
+ * const client = new ImagebuilderClient(config);
+ * const input = { // RetryImageRequest
+ *   imageBuildVersionArn: "STRING_VALUE", // required
+ *   clientToken: "STRING_VALUE", // required
+ * };
+ * const command = new RetryImageCommand(input);
+ * const response = await client.send(command);
+ * // { // RetryImageResponse
+ * //   clientToken: "STRING_VALUE",
+ * //   imageBuildVersionArn: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param RetryImageCommandInput - {@link RetryImageCommandInput}
+ * @returns {@link RetryImageCommandOutput}
+ * @see {@link RetryImageCommandInput} for command's `input` shape.
+ * @see {@link RetryImageCommandOutput} for command's `response` shape.
+ * @see {@link ImagebuilderClientResolvedConfig | config} for ImagebuilderClient's `config` shape.
+ *
+ * @throws {@link CallRateLimitExceededException} (client fault)
+ *  <p>You have exceeded the permitted request rate for the specific operation.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action, such as using an action or
+ * 			resource on behalf of a user that doesn't have permissions to use the action or
+ * 			resource, or specifying an invalid resource identifier.</p>
+ *
+ * @throws {@link ForbiddenException} (client fault)
+ *  <p>You are not authorized to perform the requested operation.</p>
+ *
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
+ *  <p>You have specified a client token for an operation using parameter values that differ
+ * 			from a previous request that used the same client token.</p>
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>You have requested an action that that the service doesn't support.</p>
+ *
+ * @throws {@link ResourceInUseException} (client fault)
+ *  <p>The resource that you are trying to operate on is currently in use. Review the message
+ * 			details and retry later.</p>
+ *
+ * @throws {@link ServiceException} (server fault)
+ *  <p>This exception is thrown when the service encounters an unrecoverable
+ * 			exception.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service is unable to process your request at this time.</p>
+ *
+ * @throws {@link ImagebuilderServiceException}
+ * <p>Base exception class for all service exceptions from Imagebuilder service.</p>
+ *
+ *
+ * @public
+ */
+export declare class RetryImageCommand extends RetryImageCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: RetryImageRequest;
+            output: RetryImageResponse;
+        };
+        sdk: {
+            input: RetryImageCommandInput;
+            output: RetryImageCommandOutput;
+        };
+    };
+}

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

@@ -18,6 +18,7 @@ export * from "./DeleteImageRecipeCommand";
 export * from "./DeleteInfrastructureConfigurationCommand";
 export * from "./DeleteLifecyclePolicyCommand";
 export * from "./DeleteWorkflowCommand";
+export * from "./DistributeImageCommand";
 export * from "./GetComponentCommand";
 export * from "./GetComponentPolicyCommand";
 export * from "./GetContainerRecipeCommand";
@@ -64,6 +65,7 @@ export * from "./PutComponentPolicyCommand";
 export * from "./PutContainerRecipePolicyCommand";
 export * from "./PutImagePolicyCommand";
 export * from "./PutImageRecipePolicyCommand";
+export * from "./RetryImageCommand";
 export * from "./SendWorkflowStepActionCommand";
 export * from "./StartImagePipelineExecutionCommand";
 export * from "./StartResourceStateUpdateCommand";

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

@@ -1,5 +1,17 @@
 import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
 import { ImagebuilderServiceException as __BaseException } from "./ImagebuilderServiceException";
+/**
+ * <p>You do not have permissions to perform the requested operation.</p>
+ * @public
+ */
+export declare class AccessDeniedException extends __BaseException {
+    readonly name: "AccessDeniedException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<AccessDeniedException, __BaseException>);
+}
 /**
  * <p>You have exceeded the permitted request rate for the specific operation.</p>
  * @public
@@ -101,6 +113,18 @@ export declare class ServiceUnavailableException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ServiceUnavailableException, __BaseException>);
 }
+/**
+ * <p>The dry run operation of the resource was successful, and no resources or mutations were actually performed due to the dry run flag in the request.</p>
+ * @public
+ */
+export declare class DryRunOperationException extends __BaseException {
+    readonly name: "DryRunOperationException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<DryRunOperationException, __BaseException>);
+}
 /**
  * <p>You have specified two or more mutually exclusive parameters. Review the error message
  * 			for details.</p>
@@ -177,6 +201,18 @@ export declare class ResourceNotFoundException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
 }
+/**
+ * <p>You have attempted too many requests for the specific operation.</p>
+ * @public
+ */
+export declare class TooManyRequestsException extends __BaseException {
+    readonly name: "TooManyRequestsException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<TooManyRequestsException, __BaseException>);
+}
 /**
  * <p>You have provided an invalid pagination token in your request.</p>
  * @public