@aws-sdk/client-ec2 3.775.0 → 3.779.0

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

@@ -1,4 +1,276 @@
 import { AcceleratorCount, AcceleratorCountRequest, AcceleratorManufacturer, AcceleratorName, AcceleratorTotalMemoryMiB, AcceleratorTotalMemoryMiBRequest, AcceleratorType, AddIpamOperatingRegion, AddressFamily, AllocationType, AttachmentStatus, CapacityReservationFleetState, InstanceEventWindow, ResourceType, SubnetIpv6CidrBlockAssociation, Tag, TagSpecification, UnsuccessfulItem, VpcCidrBlockAssociation, VpcIpv6CidrBlockAssociation, WeekDay } from "./models_0";
+/**
+ * <p>Contains the parameters for CopyImage.</p>
+ * @public
+ */
+export interface CopyImageRequest {
+    /**
+     * <p>Unique, case-sensitive identifier you provide to ensure idempotency of the request. For
+     *       more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>
+     *       in the <i>Amazon EC2 API Reference</i>.</p>
+     * @public
+     */
+    ClientToken?: string | undefined;
+    /**
+     * <p>A description for the new AMI in the destination Region.</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
+     *         EBS-backed AMIs</a> in the <i>Amazon EC2 User Guide</i>.</p>
+     * @public
+     */
+    Encrypted?: boolean | undefined;
+    /**
+     * <p>The identifier of the symmetric Key Management Service (KMS) KMS key to use when creating encrypted volumes.
+     *       If this parameter is not specified, your Amazon Web Services managed KMS key for Amazon EBS is used. If you
+     *       specify a KMS key, you must also set the encrypted state to <code>true</code>.</p>
+     *          <p>You can specify a KMS key using any of the following:</p>
+     *          <ul>
+     *             <li>
+     *                <p>Key ID. For example, 1234abcd-12ab-34cd-56ef-1234567890ab.</p>
+     *             </li>
+     *             <li>
+     *                <p>Key alias. For example, alias/ExampleAlias.</p>
+     *             </li>
+     *             <li>
+     *                <p>Key ARN. For example, arn:aws:kms:us-east-1:012345678910:key/1234abcd-12ab-34cd-56ef-1234567890ab.</p>
+     *             </li>
+     *             <li>
+     *                <p>Alias ARN. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.</p>
+     *             </li>
+     *          </ul>
+     *          <p>Amazon Web Services authenticates the KMS key asynchronously. Therefore, if you specify an identifier
+     *       that is not valid, the action can appear to complete, but eventually fails.</p>
+     *          <p>The specified KMS key must exist in the destination Region.</p>
+     *          <p>Amazon EBS does not support asymmetric KMS keys.</p>
+     * @public
+     */
+    KmsKeyId?: string | undefined;
+    /**
+     * <p>The name of the new AMI in the destination Region.</p>
+     * @public
+     */
+    Name: string | undefined;
+    /**
+     * <p>The ID of the AMI to copy.</p>
+     * @public
+     */
+    SourceImageId: string | undefined;
+    /**
+     * <p>The name of the Region that contains the AMI to copy.</p>
+     * @public
+     */
+    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>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>
+     * @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>
+     *          <ul>
+     *             <li>
+     *                <p>System tags (prefixed with <code>aws:</code>)</p>
+     *             </li>
+     *             <li>
+     *                <p>For public and shared AMIs, user-defined tags that are attached by other Amazon Web Services
+     *           accounts</p>
+     *             </li>
+     *          </ul>
+     *          <p>Default: Your user-defined AMI tags are not copied.</p>
+     * @public
+     */
+    CopyImageTags?: boolean | undefined;
+    /**
+     * <p>The tags to apply to the new AMI and new snapshots. You can tag the AMI, the snapshots, or
+     *       both.</p>
+     *          <ul>
+     *             <li>
+     *                <p>To tag the new AMI, the value for <code>ResourceType</code> must be
+     *           <code>image</code>.</p>
+     *             </li>
+     *             <li>
+     *                <p>To tag the new snapshots, the value for <code>ResourceType</code> must be
+     *             <code>snapshot</code>. The same tag is applied to all the new snapshots.</p>
+     *             </li>
+     *          </ul>
+     *          <p>If you specify other values for <code>ResourceType</code>, the request fails.</p>
+     *          <p>To tag an AMI or snapshot after it has been created, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html">CreateTags</a>.</p>
+     * @public
+     */
+    TagSpecifications?: TagSpecification[] | undefined;
+    /**
+     * <p>Specify a completion duration, in 15 minute increments, to initiate a time-based
+     *       AMI copy. The specified completion duration applies to each of the snapshots associated
+     *       with the AMI. Each snapshot associated with the AMI will be completed within the
+     *       specified completion duration, regardless of their size.</p>
+     *          <p>If you do not specify a value, the AMI copy operation is completed on a best-effort
+     *       basis.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/time-based-copies.html">
+     *       Time-based copies</a>.</p>
+     * @public
+     */
+    SnapshotCopyCompletionDurationMinutes?: number | 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>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
+     * @public
+     */
+    DryRun?: boolean | undefined;
+}
+/**
+ * <p>Contains the output of CopyImage.</p>
+ * @public
+ */
+export interface CopyImageResult {
+    /**
+     * <p>The ID of the new AMI.</p>
+     * @public
+     */
+    ImageId?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CopySnapshotRequest {
+    /**
+     * <p>A description for the EBS snapshot.</p>
+     * @public
+     */
+    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>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>
+     * @public
+     */
+    DestinationOutpostArn?: string | undefined;
+    /**
+     * <p>The destination Region to use in the <code>PresignedUrl</code> parameter of a snapshot
+     *       copy operation. This parameter is only valid for specifying the destination Region in a
+     *         <code>PresignedUrl</code> parameter, where it is required.</p>
+     *          <p>The snapshot copy is sent to the regional endpoint that you sent the HTTP
+     *     	request to (for example, <code>ec2.us-east-1.amazonaws.com</code>). With the CLI, this is
+     *       specified using the <code>--region</code> parameter or the default Region in your Amazon Web Services
+     *       configuration file.</p>
+     * @public
+     */
+    DestinationRegion?: string | undefined;
+    /**
+     * <p>To encrypt a copy of an unencrypted snapshot if encryption by default is not enabled,
+     *       enable encryption using this parameter. Otherwise, omit this parameter. Encrypted snapshots
+     *       are encrypted, even if you omit this parameter and encryption by default is not enabled. You
+     *       cannot set this parameter to false. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html">Amazon EBS encryption</a> in the
+     *       <i>Amazon EBS User Guide</i>.</p>
+     * @public
+     */
+    Encrypted?: boolean | undefined;
+    /**
+     * <p>The identifier of the KMS key to use for Amazon EBS encryption.
+     *       If this parameter is not specified, your KMS key for Amazon EBS is used. If <code>KmsKeyId</code> is
+     *       specified, the encrypted state must be <code>true</code>.</p>
+     *          <p>You can specify the KMS key using any of the following:</p>
+     *          <ul>
+     *             <li>
+     *                <p>Key ID. For example, 1234abcd-12ab-34cd-56ef-1234567890ab.</p>
+     *             </li>
+     *             <li>
+     *                <p>Key alias. For example, alias/ExampleAlias.</p>
+     *             </li>
+     *             <li>
+     *                <p>Key ARN. For example, arn:aws:kms:us-east-1:012345678910:key/1234abcd-12ab-34cd-56ef-1234567890ab.</p>
+     *             </li>
+     *             <li>
+     *                <p>Alias ARN. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.</p>
+     *             </li>
+     *          </ul>
+     *          <p>Amazon Web Services authenticates the KMS key asynchronously. Therefore, if you specify an ID, alias, or ARN that is not valid,
+     *       the action can appear to complete, but eventually fails.</p>
+     * @public
+     */
+    KmsKeyId?: string | undefined;
+    /**
+     * <p>When you copy an encrypted source snapshot using the Amazon EC2 Query API, you must supply a
+     *       pre-signed URL. This parameter is optional for unencrypted snapshots. For more information,
+     *       see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html">Query
+     *         requests</a>.</p>
+     *          <p>The <code>PresignedUrl</code> should use the snapshot source endpoint, the
+     *         <code>CopySnapshot</code> action, and include the <code>SourceRegion</code>,
+     *         <code>SourceSnapshotId</code>, and <code>DestinationRegion</code> parameters. The
+     *         <code>PresignedUrl</code> must be signed using Amazon Web Services Signature Version 4. Because EBS
+     *       snapshots are stored in Amazon S3, the signing algorithm for this parameter uses the same logic
+     *       that is described in <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html">
+     *         Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4)</a> in the <i>Amazon S3 API Reference</i>. An
+     *       invalid or improperly signed <code>PresignedUrl</code> will cause the copy operation to fail
+     *       asynchronously, and the snapshot will move to an <code>error</code> state.</p>
+     * @public
+     */
+    PresignedUrl?: string | undefined;
+    /**
+     * <p>The ID of the Region that contains the snapshot to be copied.</p>
+     * @public
+     */
+    SourceRegion: string | undefined;
+    /**
+     * <p>The ID of the EBS snapshot to copy.</p>
+     * @public
+     */
+    SourceSnapshotId: string | undefined;
+    /**
+     * <p>The tags to apply to the new snapshot.</p>
+     * @public
+     */
+    TagSpecifications?: TagSpecification[] | undefined;
+    /**
+     * <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>
+     *          <p>If you do not specify a value, the snapshot copy operation is completed on a
+     *       best-effort basis.</p>
+     * @public
+     */
+    CompletionDurationMinutes?: number | 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>.
+     *    Otherwise, it is <code>UnauthorizedOperation</code>.</p>
+     * @public
+     */
+    DryRun?: boolean | undefined;
+}
+/**
+ * @public
+ */
+export interface CopySnapshotResult {
+    /**
+     * <p>Any tags applied to the new snapshot.</p>
+     * @public
+     */
+    Tags?: Tag[] | undefined;
+    /**
+     * <p>The ID of the new snapshot.</p>
+     * @public
+     */
+    SnapshotId?: string | undefined;
+}
 /**
  * @public
  * @enum
@@ -3031,6 +3303,8 @@ export interface VpcEncryptionControlExclusions {
  */
 export declare const VpcEncryptionControlState: {
     readonly available: "available";
+    readonly creating: "creating";
+    readonly delete_failed: "delete-failed";
     readonly deleted: "deleted";
     readonly deleting: "deleting";
     readonly enforce_failed: "enforce-failed";
@@ -9106,8 +9380,7 @@ export interface EnaSrdUdpSpecificationRequest {
     /**
      * <p>Indicates whether UDP traffic uses ENA Express for your instance. To ensure that
      * 			UDP traffic can use ENA Express when you launch an instance, you must also set
-     * 			<b>EnaSrdEnabled</b> in the <b>EnaSrdSpecificationRequest</b> to <code>true</code> in your
-     * 			launch template.</p>
+     * 			<b>EnaSrdEnabled</b> in the <b>EnaSrdSpecificationRequest</b> to <code>true</code>.</p>
      * @public
      */
     EnaSrdUdpEnabled?: boolean | undefined;
@@ -9120,12 +9393,13 @@ export interface EnaSrdUdpSpecificationRequest {
 export interface EnaSrdSpecificationRequest {
     /**
      * <p>Specifies whether ENA Express is enabled for the network interface when you
-     * 			launch an instance from your launch template.</p>
+     * 			launch an instance.</p>
      * @public
      */
     EnaSrdEnabled?: boolean | undefined;
     /**
-     * <p>Contains ENA Express settings for UDP network traffic in your launch template.</p>
+     * <p>Contains ENA Express settings for UDP network traffic for the network interface
+     * 	        attached to the instance.</p>
      * @public
      */
     EnaSrdUdpSpecification?: EnaSrdUdpSpecificationRequest | undefined;
@@ -11098,136 +11372,9 @@ export interface CreateLaunchTemplateVersionResult {
     Warning?: ValidationWarning | undefined;
 }
 /**
- * @public
- */
-export interface CreateLocalGatewayRouteRequest {
-    /**
-     * <p>The CIDR range used for destination matches. Routing decisions are based on
-     *         the most specific match.</p>
-     * @public
-     */
-    DestinationCidrBlock?: string | undefined;
-    /**
-     * <p>The ID of the local gateway route table.</p>
-     * @public
-     */
-    LocalGatewayRouteTableId: string | undefined;
-    /**
-     * <p>The ID of the virtual interface group.</p>
-     * @public
-     */
-    LocalGatewayVirtualInterfaceGroupId?: 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>.
-     *    Otherwise, it is <code>UnauthorizedOperation</code>.</p>
-     * @public
-     */
-    DryRun?: boolean | undefined;
-    /**
-     * <p>The ID of the network interface.</p>
-     * @public
-     */
-    NetworkInterfaceId?: string | undefined;
-    /**
-     * <p>
-     *          The ID of the prefix list. Use a prefix list in place of <code>DestinationCidrBlock</code>. You
-     *          cannot use <code>DestinationPrefixListId</code> and <code>DestinationCidrBlock</code> in the same request.
-     *       </p>
-     * @public
-     */
-    DestinationPrefixListId?: string | undefined;
-}
-/**
- * @public
- * @enum
- */
-export declare const LocalGatewayRouteState: {
-    readonly active: "active";
-    readonly blackhole: "blackhole";
-    readonly deleted: "deleted";
-    readonly deleting: "deleting";
-    readonly pending: "pending";
-};
-/**
- * @public
- */
-export type LocalGatewayRouteState = (typeof LocalGatewayRouteState)[keyof typeof LocalGatewayRouteState];
-/**
- * @public
- * @enum
- */
-export declare const LocalGatewayRouteType: {
-    readonly propagated: "propagated";
-    readonly static: "static";
-};
-/**
- * @public
- */
-export type LocalGatewayRouteType = (typeof LocalGatewayRouteType)[keyof typeof LocalGatewayRouteType];
-/**
- * <p>Describes a route for a local gateway route table.</p>
- * @public
+ * @internal
  */
-export interface LocalGatewayRoute {
-    /**
-     * <p>The CIDR block used for destination matches.</p>
-     * @public
-     */
-    DestinationCidrBlock?: string | undefined;
-    /**
-     * <p>The ID of the virtual interface group.</p>
-     * @public
-     */
-    LocalGatewayVirtualInterfaceGroupId?: string | undefined;
-    /**
-     * <p>The route type.</p>
-     * @public
-     */
-    Type?: LocalGatewayRouteType | undefined;
-    /**
-     * <p>The state of the route.</p>
-     * @public
-     */
-    State?: LocalGatewayRouteState | undefined;
-    /**
-     * <p>The ID of the local gateway route table.</p>
-     * @public
-     */
-    LocalGatewayRouteTableId?: string | undefined;
-    /**
-     * <p>The Amazon Resource Name (ARN) of the local gateway route table.</p>
-     * @public
-     */
-    LocalGatewayRouteTableArn?: string | undefined;
-    /**
-     * <p>The ID of the Amazon Web Services account that owns the local gateway route.</p>
-     * @public
-     */
-    OwnerId?: string | undefined;
-    /**
-     * <p>The ID of the subnet.</p>
-     * @public
-     */
-    SubnetId?: string | undefined;
-    /**
-     * <p>The ID of the customer-owned address pool.</p>
-     * @public
-     */
-    CoipPoolId?: string | undefined;
-    /**
-     * <p>The ID of the network interface.</p>
-     * @public
-     */
-    NetworkInterfaceId?: string | undefined;
-    /**
-     * <p>
-     *          The ID of the prefix list.
-     *       </p>
-     * @public
-     */
-    DestinationPrefixListId?: string | undefined;
-}
+export declare const CopySnapshotRequestFilterSensitiveLog: (obj: CopySnapshotRequest) => any;
 /**
  * @internal
  */