@aws-sdk/client-ec2 3.876.0 → 3.878.0

package/dist-cjs/index.js

@@ -19349,6 +19349,12 @@ var se_CopyImageRequest = /* @__PURE__ */ __name((input, context) => {
   if (input[_SCCDM] != null) {
     entries[_SCCDM] = input[_SCCDM];
   }
+  if (input[_DAZe] != null) {
+    entries[_DAZe] = input[_DAZe];
+  }
+  if (input[_DAZI] != null) {
+    entries[_DAZI] = input[_DAZI];
+  }
   if (input[_DRr] != null) {
     entries[_DRr] = input[_DRr];
   }
@@ -19390,6 +19396,9 @@ var se_CopySnapshotRequest = /* @__PURE__ */ __name((input, context) => {
   if (input[_CDM] != null) {
     entries[_CDM] = input[_CDM];
   }
+  if (input[_DAZe] != null) {
+    entries[_DAZe] = input[_DAZe];
+  }
   if (input[_DRr] != null) {
     entries[_DRr] = input[_DRr];
   }
@@ -64645,6 +64654,8 @@ var _DAT = "DescribeAddressTransfers";
 var _DATi = "DisableAddressTransfer";
 var _DATis = "DisableApiTermination";
 var _DAZ = "DescribeAvailabilityZones";
+var _DAZI = "DestinationAvailabilityZoneId";
+var _DAZe = "DestinationAvailabilityZone";
 var _DAe = "DeprecateAt";
 var _DAep = "DeprovisionedAddresses";
 var _DAes = "DestinationAddresses";

package/dist-es/protocols/Aws_ec2.js

@@ -17741,6 +17741,12 @@ const se_CopyImageRequest = (input, context) => {
     if (input[_SCCDM] != null) {
         entries[_SCCDM] = input[_SCCDM];
     }
+    if (input[_DAZe] != null) {
+        entries[_DAZe] = input[_DAZe];
+    }
+    if (input[_DAZI] != null) {
+        entries[_DAZI] = input[_DAZI];
+    }
     if (input[_DRr] != null) {
         entries[_DRr] = input[_DRr];
     }
@@ -17782,6 +17788,9 @@ const se_CopySnapshotRequest = (input, context) => {
     if (input[_CDM] != null) {
         entries[_CDM] = input[_CDM];
     }
+    if (input[_DAZe] != null) {
+        entries[_DAZe] = input[_DAZe];
+    }
     if (input[_DRr] != null) {
         entries[_DRr] = input[_DRr];
     }
@@ -64586,6 +64595,8 @@ const _DAT = "DescribeAddressTransfers";
 const _DATi = "DisableAddressTransfer";
 const _DATis = "DisableApiTermination";
 const _DAZ = "DescribeAvailabilityZones";
+const _DAZI = "DestinationAvailabilityZoneId";
+const _DAZe = "DestinationAvailabilityZone";
 const _DAe = "DeprecateAt";
 const _DAep = "DeprovisionedAddresses";
 const _DAes = "DestinationAddresses";

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

@@ -27,16 +27,96 @@ declare const CopyImageCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Initiates an AMI copy operation. You can copy an AMI from one Region to another, or from a
- *       Region to an Outpost. You can't copy an AMI from an Outpost to a Region, from one Outpost to
- *       another, or within the same Outpost. To copy an AMI to another partition, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateStoreImageTask.html">CreateStoreImageTask</a>.</p>
- *          <p>When you copy an AMI from one Region to another, the destination Region is the current
+ * <p>Initiates an AMI copy operation. You must specify the source AMI ID and both the source
+ *       and destination locations. The copy operation must be initiated in the destination
  *       Region.</p>
- *          <p>When you copy an AMI from a Region to an Outpost, specify the ARN of the Outpost as the
- *       destination. Backing snapshots copied to an Outpost are encrypted by default using the default
- *       encryption key for the Region or the key that you specify. Outposts do not support unencrypted
- *       snapshots.</p>
- *          <p>For information about the prerequisites when copying an AMI, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html">Copy an Amazon EC2 AMI</a> in the
+ *          <p class="title">
+ *             <b>CopyImage supports the following source to destination copies:</b>
+ *          </p>
+ *          <ul>
+ *             <li>
+ *                <p>Region to Region</p>
+ *             </li>
+ *             <li>
+ *                <p>Region to Outpost</p>
+ *             </li>
+ *             <li>
+ *                <p>Parent Region to Local Zone</p>
+ *             </li>
+ *             <li>
+ *                <p>Local Zone to parent Region</p>
+ *             </li>
+ *             <li>
+ *                <p>Between Local Zones with the same parent Region (only supported for certain Local
+ *           Zones)</p>
+ *             </li>
+ *          </ul>
+ *          <p class="title">
+ *             <b>CopyImage does not support the following source to destination copies:</b>
+ *          </p>
+ *          <ul>
+ *             <li>
+ *                <p>Local Zone to non-parent Regions</p>
+ *             </li>
+ *             <li>
+ *                <p>Between Local Zones with different parent Regions</p>
+ *             </li>
+ *             <li>
+ *                <p>Local Zone to Outpost</p>
+ *             </li>
+ *             <li>
+ *                <p>Outpost to Local Zone</p>
+ *             </li>
+ *             <li>
+ *                <p>Outpost to Region</p>
+ *             </li>
+ *             <li>
+ *                <p>Between Outposts</p>
+ *             </li>
+ *             <li>
+ *                <p>Within same Outpost</p>
+ *             </li>
+ *             <li>
+ *                <p>Cross-partition copies (use <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateStoreImageTask.html">CreateStoreImageTask</a> instead)</p>
+ *             </li>
+ *          </ul>
+ *          <p class="title">
+ *             <b>Destination specification</b>
+ *          </p>
+ *          <ul>
+ *             <li>
+ *                <p>Region to Region: The destination Region is the Region in which you initiate the copy
+ *           operation.</p>
+ *             </li>
+ *             <li>
+ *                <p>Region to Outpost: Specify the destination using the
+ *             <code>DestinationOutpostArn</code> parameter (the ARN of the Outpost)</p>
+ *             </li>
+ *             <li>
+ *                <p>Region to Local Zone, and Local Zone to Local Zone copies: Specify the destination
+ *           using the <code>DestinationAvailabilityZone</code> parameter (the name of the destination
+ *           Local Zone) or <code>DestinationAvailabilityZoneId</code> parameter (the ID of the
+ *           destination Local Zone).</p>
+ *             </li>
+ *          </ul>
+ *          <p class="title">
+ *             <b>Snapshot encryption</b>
+ *          </p>
+ *          <ul>
+ *             <li>
+ *                <p>Region to Outpost: Backing snapshots copied to an Outpost are encrypted by default
+ *           using the default encryption key for the Region or the key that you specify. Outposts do
+ *           not support unencrypted snapshots.</p>
+ *             </li>
+ *             <li>
+ *                <p>Region to Local Zone, and Local Zone to Local Zone: Not all Local Zones require
+ *           encrypted snapshots. In Local Zones that require encrypted snapshots, backing snapshots
+ *           are automatically encrypted during copy. In Local Zones where encryption is not required,
+ *           snapshots retain their original encryption state (encrypted or unencrypted) by
+ *           default.</p>
+ *             </li>
+ *          </ul>
+ *          <p>For more information, including the required permissions for copying an AMI, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html">Copy an Amazon EC2 AMI</a> in the
  *         <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -66,6 +146,8 @@ declare const CopyImageCommand_base: {
  *     },
  *   ],
  *   SnapshotCopyCompletionDurationMinutes: Number("long"),
+ *   DestinationAvailabilityZone: "STRING_VALUE",
+ *   DestinationAvailabilityZoneId: "STRING_VALUE",
  *   DryRun: true || false,
  * };
  * const command = new CopyImageCommand(input);

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

@@ -27,11 +27,24 @@ declare const CopySnapshotCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy a
- *       snapshot within the same Region, from one Region to another, or from a Region to an Outpost.
- *       You can't copy a snapshot from an Outpost to a Region, from one Outpost to another, or within
- *       the same Outpost.</p>
- *          <p>You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs).</p>
+ * <p>Creates an exact copy of an Amazon EBS snapshot.</p>
+ *          <p>The location of the source snapshot determines whether you can copy it or not,
+ *       and the allowed destinations for the snapshot copy.</p>
+ *          <ul>
+ *             <li>
+ *                <p>If the source snapshot is in a Region, you can copy it within that Region,
+ *           to another Region, to an Outpost associated with that Region, or to a Local
+ *           Zone in that Region.</p>
+ *             </li>
+ *             <li>
+ *                <p>If the source snapshot is in a Local Zone, you can copy it within that Local Zone,
+ *           to another Local Zone in the same zone group, or to the parent Region of the Local
+ *           Zone.</p>
+ *             </li>
+ *             <li>
+ *                <p>If the source snapshot is on an Outpost, you can't copy it.</p>
+ *             </li>
+ *          </ul>
  *          <p>When copying snapshots to a Region, copies of encrypted EBS snapshots remain encrypted.
  *     	Copies of unencrypted snapshots remain unencrypted, unless you enable encryption for the
  *     	snapshot copy operation. By default, encrypted snapshot copies use the default KMS key;
@@ -42,8 +55,10 @@ declare const CopySnapshotCommand_base: {
  *       for the Region, or a different key that you specify in the request using <b>KmsKeyId</b>. Outposts do not support unencrypted snapshots. For more information,
  *       see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#ami">Amazon EBS
  *         local snapshots on Outposts</a> in the <i>Amazon EBS User Guide</i>.</p>
- *          <p>Snapshots created by copying another snapshot have an arbitrary volume ID that should not
- *       be used for any purpose.</p>
+ *          <note>
+ *             <p>Snapshots copies have an arbitrary source volume ID. Do not use this volume ID for
+ *         any purpose.</p>
+ *          </note>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-copy-snapshot.html">Copy an Amazon EBS snapshot</a> in the
  *         <i>Amazon EBS User Guide</i>.</p>
  * @example
@@ -73,6 +88,7 @@ declare const CopySnapshotCommand_base: {
  *     },
  *   ],
  *   CompletionDurationMinutes: Number("int"),
+ *   DestinationAvailabilityZone: "STRING_VALUE",
  *   DryRun: true || false,
  * };
  * const command = new CopySnapshotCommand(input);

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

@@ -30,7 +30,7 @@ declare const CreateImageUsageReportCommand_base: {
  * <p>Creates a report that shows how your image is used across other Amazon Web Services accounts. The report
  *       provides visibility into which accounts are using the specified image, and how many resources
  *       (EC2 instances or launch templates) are referencing it.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-usage.html">View your AMI usage</a> in the
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/your-ec2-ami-usage.html">View your AMI usage</a> in the
  *       <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -28,7 +28,7 @@ declare const DeleteImageUsageReportCommand_base: {
 };
 /**
  * <p>Deletes the specified image usage report.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-usage.html">View your AMI usage</a> in the
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/your-ec2-ami-usage.html">View your AMI usage</a> in the
  *       <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -27,9 +27,9 @@ declare const DescribeImageReferencesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Describes your Amazon Web Services resources that are referencing the specified images. </p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-references.html">Identiy your resources referencing
- *         selected AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
+ * <p>Describes your Amazon Web Services resources that are referencing the specified images.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-references.html">Identify your resources referencing
+ *         specified AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -29,7 +29,7 @@ declare const DescribeImageUsageReportEntriesCommand_base: {
 /**
  * <p>Describes the entries in image usage reports, showing how your images are used across
  *       other Amazon Web Services accounts.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-usage.html">View your AMI usage</a> in the
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/your-ec2-ami-usage.html">View your AMI usage</a> in the
  *         <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -29,7 +29,7 @@ declare const DescribeImageUsageReportsCommand_base: {
 /**
  * <p>Describes the configuration and status of image usage reports, filtered by report IDs or
  *       image IDs.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-usage.html">View your AMI usage</a> in the
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/your-ec2-ami-usage.html">View your AMI usage</a> in the
  *       <i>Amazon EC2 User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -61,15 +61,15 @@ export interface CopyImageRequest {
      */
     ClientToken?: string | undefined;
     /**
-     * <p>A description for the new AMI in the destination Region.</p>
+     * <p>A description for the new AMI.</p>
      * @public
      */
     Description?: string | undefined;
     /**
-     * <p>Specifies whether the destination snapshots of the copied image should be encrypted. You
-     *       can encrypt a copy of an unencrypted snapshot, but you cannot create an unencrypted copy of an
-     *       encrypted snapshot. The default KMS key for Amazon EBS is used unless you specify a non-default
-     *       Key Management Service (KMS) KMS key using <code>KmsKeyId</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIEncryption.html">Use encryption with
+     * <p>Specifies whether to encrypt the snapshots of the copied image.</p>
+     *          <p>You can encrypt a copy of an unencrypted snapshot, but you cannot create an unencrypted
+     *       copy of an encrypted snapshot. The default KMS key for Amazon EBS is used unless you specify a
+     *       non-default Key Management Service (KMS) KMS key using <code>KmsKeyId</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIEncryption.html">Use encryption with
      *         EBS-backed AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
      * @public
      */
@@ -101,7 +101,7 @@ export interface CopyImageRequest {
      */
     KmsKeyId?: string | undefined;
     /**
-     * <p>The name of the new AMI in the destination Region.</p>
+     * <p>The name of the new AMI.</p>
      * @public
      */
     Name: string | undefined;
@@ -116,18 +116,21 @@ export interface CopyImageRequest {
      */
     SourceRegion: string | undefined;
     /**
-     * <p>The Amazon Resource Name (ARN) of the Outpost to which to copy the AMI. Only specify this
-     *       parameter when copying an AMI from an Amazon Web Services Region to an Outpost. The AMI must be in the
-     *       Region of the destination Outpost. You cannot copy an AMI from an Outpost to a Region, from
-     *       one Outpost to another, or within the same Outpost.</p>
+     * <p>The Amazon Resource Name (ARN) of the Outpost for the new AMI.</p>
+     *          <p>Only specify this parameter when copying an AMI from an Amazon Web Services Region to an Outpost. The
+     *       AMI must be in the Region of the destination Outpost. You can't copy an AMI from an Outpost to
+     *       a Region, from one Outpost to another, or within the same Outpost.</p>
      *          <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#copy-amis">Copy AMIs from an Amazon Web Services Region
      *         to an Outpost</a> in the <i>Amazon EBS User Guide</i>.</p>
+     *          <p>Only one of <code>DestinationAvailabilityZone</code>,
+     *         <code>DestinationAvailabilityZoneId</code>, or <code>DestinationOutpostArn</code> can be
+     *       specified.</p>
      * @public
      */
     DestinationOutpostArn?: string | undefined;
     /**
-     * <p>Indicates whether to include your user-defined AMI tags when copying the AMI.</p>
-     *          <p>The following tags will not be copied:</p>
+     * <p>Specifies whether to copy your user-defined AMI tags to the new AMI.</p>
+     *          <p>The following tags are not be copied:</p>
      *          <ul>
      *             <li>
      *                <p>System tags (prefixed with <code>aws:</code>)</p>
@@ -167,11 +170,31 @@ export interface CopyImageRequest {
      *       meet the timing target.</p>
      *          <p>If you do not specify a value, the AMI copy operation is completed on a best-effort
      *       basis.</p>
+     *          <note>
+     *             <p>This parameter is not supported when copying an AMI to or from a Local Zone, or to an
+     *         Outpost.</p>
+     *          </note>
      *          <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/time-based-copies.html">Time-based copies for Amazon EBS snapshots and
      *         EBS-backed AMIs</a>.</p>
      * @public
      */
     SnapshotCopyCompletionDurationMinutes?: number | undefined;
+    /**
+     * <p>The Local Zone for the new AMI (for example, <code>cn-north-1-pkx-1a</code>).</p>
+     *          <p>Only one of <code>DestinationAvailabilityZone</code>,
+     *         <code>DestinationAvailabilityZoneId</code>, or <code>DestinationOutpostArn</code> can be
+     *       specified.</p>
+     * @public
+     */
+    DestinationAvailabilityZone?: string | undefined;
+    /**
+     * <p>The ID of the Local Zone for the new AMI (for example, <code>cnn1-pkx1-az1</code>).</p>
+     *          <p>Only one of <code>DestinationAvailabilityZone</code>,
+     *         <code>DestinationAvailabilityZoneId</code>, or <code>DestinationOutpostArn</code> can be
+     *       specified.</p>
+     * @public
+     */
+    DestinationAvailabilityZoneId?: string | undefined;
     /**
      * <p>Checks whether you have the required permissions for the action, without actually making the request,
      * 			and provides an error response. If you have the required permissions, the error response is
@@ -201,14 +224,13 @@ export interface CopySnapshotRequest {
      */
     Description?: string | undefined;
     /**
-     * <p>The Amazon Resource Name (ARN) of the Outpost to which to copy the snapshot. Only
-     * 		specify this parameter when copying a snapshot from an Amazon Web Services Region to an Outpost.
-     * 		The snapshot must be in the Region for the destination Outpost. You cannot copy a
-     * 		snapshot from an Outpost to a Region, from one Outpost to another, or within the same
-     * 		Outpost.</p>
+     * <p>The Amazon Resource Name (ARN) of the Outpost to which to copy the snapshot.</p>
+     *          <note>
+     *             <p>Only supported when copying a snapshot to an Outpost.</p>
+     *          </note>
      *          <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#copy-snapshots">
      *   		Copy snapshots from an Amazon Web Services Region to an Outpost</a> in the
-     *   		<i>Amazon EBS User Guide</i>.</p>
+     *       <i>Amazon EBS User Guide</i>.</p>
      * @public
      */
     DestinationOutpostArn?: string | undefined;
@@ -289,7 +311,10 @@ export interface CopySnapshotRequest {
      */
     TagSpecifications?: TagSpecification[] | undefined;
     /**
-     * <p>Specify a completion duration, in 15 minute increments, to initiate a time-based snapshot
+     * <note>
+     *             <p>Not supported when copying snapshots to or from Local Zones or Outposts.</p>
+     *          </note>
+     *          <p>Specify a completion duration, in 15 minute increments, to initiate a time-based snapshot
      *       copy. Time-based snapshot copy operations complete within the specified duration. For more
      *       information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/time-based-copies.html">
      *         Time-based copies</a>.</p>
@@ -298,6 +323,15 @@ export interface CopySnapshotRequest {
      * @public
      */
     CompletionDurationMinutes?: number | undefined;
+    /**
+     * <p>The Local Zone, for example, <code>cn-north-1-pkx-1a</code> to which to copy the
+     *       snapshot.</p>
+     *          <note>
+     *             <p>Only supported when copying a snapshot to a Local Zone.</p>
+     *          </note>
+     * @public
+     */
+    DestinationAvailabilityZone?: string | undefined;
     /**
      * <p>Checks whether you have the required permissions for the action, without actually making the request,
      *    and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>.

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

@@ -44,6 +44,8 @@ export interface CopyImageRequest {
   CopyImageTags?: boolean | undefined;
   TagSpecifications?: TagSpecification[] | undefined;
   SnapshotCopyCompletionDurationMinutes?: number | undefined;
+  DestinationAvailabilityZone?: string | undefined;
+  DestinationAvailabilityZoneId?: string | undefined;
   DryRun?: boolean | undefined;
 }
 export interface CopyImageResult {
@@ -60,6 +62,7 @@ export interface CopySnapshotRequest {
   SourceSnapshotId: string | undefined;
   TagSpecifications?: TagSpecification[] | undefined;
   CompletionDurationMinutes?: number | undefined;
+  DestinationAvailabilityZone?: string | undefined;
   DryRun?: boolean | undefined;
 }
 export interface CopySnapshotResult {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-ec2",
   "description": "AWS SDK for JavaScript Ec2 Client for Node.js, Browser and React Native",
-  "version": "3.876.0",
+  "version": "3.878.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-ec2",