Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for * backups, to make copies of EBS volumes, and to save data before shutting down an * instance.
- *You can create snapshots of volumes in a Region and volumes on an Outpost. If you - * create a snapshot of a volume in a Region, the snapshot must be stored in the same - * Region as the volume. If you create a snapshot of a volume on an Outpost, the snapshot - * can be stored on the same Outpost as the volume, or in the Region for that Outpost.
+ *The location of the source EBS volume determines where you can create the snapshot.
+ *If the source volume is in a Region, you must create the snapshot in the same + * Region as the volume.
+ *If the source volume is in a Local Zone, you can create the snapshot in the same + * Local Zone or in parent Amazon Web Services Region.
+ *If the source volume is on an Outpost, you can create the snapshot on the same + * Outpost or in its parent Amazon Web Services Region.
+ *When a snapshot is created, any Amazon Web Services Marketplace product codes that are associated with the * source volume are propagated to the snapshot.
*You can take a snapshot of an attached volume that is in use. However, snapshots only @@ -49,10 +60,9 @@ export interface CreateSnapshotCommandOutput extends Snapshot, __MetadataBearer * that you stop the instance before taking the snapshot.
*Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that * are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes - * and any associated snapshots always remain protected.
- *You can tag your snapshots during creation. For more information, see Tag your Amazon EC2 - * resources in the Amazon EC2 User Guide.
- *For more information, see Amazon EBS and Amazon EBS encryption in the Amazon EBS User Guide.
+ * and any associated snapshots always remain protected. For more information, + * Amazon EBS encryption + * in the Amazon EBS User Guide. * @example * Use a bare-bones client and the command you need to make an API call. * ```javascript @@ -74,6 +84,7 @@ export interface CreateSnapshotCommandOutput extends Snapshot, __MetadataBearer * ], * }, * ], + * Location: "regional" || "local", * DryRun: true || false, * }; * const command = new CreateSnapshotCommand(input); @@ -90,6 +101,7 @@ export interface CreateSnapshotCommandOutput extends Snapshot, __MetadataBearer * // StorageTier: "archive" || "standard", * // RestoreExpiryTime: new Date("TIMESTAMP"), * // SseType: "sse-ebs" || "sse-kms" || "none", + * // AvailabilityZone: "STRING_VALUE", * // TransferType: "time-based" || "standard", * // CompletionDurationMinutes: Number("int"), * // CompletionTime: new Date("TIMESTAMP"), diff --git a/clients/client-ec2/src/commands/CreateSnapshotsCommand.ts b/clients/client-ec2/src/commands/CreateSnapshotsCommand.ts index b3dce205b10b..2a950f23b091 100644 --- a/clients/client-ec2/src/commands/CreateSnapshotsCommand.ts +++ b/clients/client-ec2/src/commands/CreateSnapshotsCommand.ts @@ -28,16 +28,26 @@ export interface CreateSnapshotsCommandInput extends CreateSnapshotsRequest {} export interface CreateSnapshotsCommandOutput extends CreateSnapshotsResult, __MetadataBearer {} /** - *Creates crash-consistent snapshots of multiple EBS volumes and stores the data in S3. - * Volumes are chosen by specifying an instance. Any attached volumes will produce one snapshot - * each that is crash-consistent across the instance.
- *You can include all of the volumes currently attached to the instance, or you can exclude - * the root volume or specific data (non-root) volumes from the multi-volume snapshot set.
- *You can create multi-volume snapshots of instances in a Region and instances on an - * Outpost. If you create snapshots from an instance in a Region, the snapshots must be stored - * in the same Region as the instance. If you create snapshots from an instance on an Outpost, - * the snapshots can be stored on the same Outpost as the instance, or in the Region for that - * Outpost.
+ *Creates crash-consistent snapshots of multiple EBS volumes attached to an Amazon EC2 instance. + * Volumes are chosen by specifying an instance. Each volume attached to the specified instance + * will produce one snapshot that is crash-consistent across the instance. You can include all of + * the volumes currently attached to the instance, or you can exclude the root volume or specific + * data (non-root) volumes from the multi-volume snapshot set.
+ *The location of the source instance determines where you can create the snapshots.
+ *If the source instance is in a Region, you must create the snapshots in the same + * Region as the instance.
+ *If the source instance is in a Local Zone, you can create the snapshots in the same + * Local Zone or in parent Amazon Web Services Region.
+ *If the source instance is on an Outpost, you can create the snapshots on the same + * Outpost or in its parent Amazon Web Services Region.
+ *The Amazon Resource Name (ARN) of the Outpost on which to create a local - * snapshot.
+ *Only supported for volumes on Outposts. If the source volume is not on an Outpost, + * omit this parameter.
+ *To create a snapshot of a volume in a Region, omit this parameter. The snapshot - * is created in the same Region as the volume.
+ *To create the snapshot on the same Outpost as the source volume, specify the + * ARN of that Outpost. The snapshot must be created on the same Outpost as the volume.
*To create a snapshot of a volume on an Outpost and store the snapshot in the - * Region, omit this parameter. The snapshot is created in the Region for the - * Outpost.
- *To create a snapshot of a volume on an Outpost and store the snapshot on an - * Outpost, specify the ARN of the destination Outpost. The snapshot must be created on - * the same Outpost as the volume.
+ *To create the snapshot in the parent Region of the Outpost, omit this parameter.
*For more information, see Create local snapshots from volumes on an Outpost in the Amazon EBS User Guide.
@@ -3058,6 +3067,27 @@ export interface CreateSnapshotRequest { */ TagSpecifications?: TagSpecification[] | undefined; + /** + *Only supported for volumes in Local Zones. If the source volume is not in a Local Zone, + * omit this parameter.
+ *To create a local snapshot in the same Local Zone as the source volume, specify
+ * local.
To create a regional snapshot in the parent Region of the Local Zone, specify
+ * regional or omit this parameter.
Default value: regional
+ *
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 DryRunOperation.
@@ -3174,6 +3204,13 @@ export interface Snapshot {
*/
SseType?: SSEType | undefined;
+ /**
+ *
The Availability Zone or Local Zone of the snapshot. For example, us-west-1a
+ * (Availability Zone) or us-west-2-lax-1a (Local Zone).
Only for snapshot copies.
@@ -3353,27 +3390,21 @@ export interface CreateSnapshotsRequest { InstanceSpecification: InstanceSpecification | undefined; /** - *The Amazon Resource Name (ARN) of the Outpost on which to create the local - * snapshots.
+ *Only supported for instances on Outposts. If the source instance is not on an Outpost, + * omit this parameter.
+ *To create snapshots from an instance in a Region, omit this parameter. The - * snapshots are created in the same Region as the instance.
- *To create snapshots from an instance on an Outpost and store the snapshots - * in the Region, omit this parameter. The snapshots are created in the Region - * for the Outpost.
+ *To create the snapshots on the same Outpost as the source instance, specify the + * ARN of that Outpost. The snapshots must be created on the same Outpost as the instance.
*To create snapshots from an instance on an Outpost and store the snapshots - * on an Outpost, specify the ARN of the destination Outpost. The snapshots must - * be created on the same Outpost as the instance.
+ *To create the snapshots in the parent Region of the Outpost, omit this parameter.
*For more information, see - * Create multi-volume local snapshots from instances on an Outpost in the - * Amazon EBS User Guide.
+ *For more information, see + * Create local snapshots from volumes on an Outpost in the Amazon EBS User Guide.
* @public */ OutpostArn?: string | undefined; @@ -3397,6 +3428,27 @@ export interface CreateSnapshotsRequest { * @public */ CopyTagsFromSource?: CopyTagsFromSource | undefined; + + /** + *Only supported for instances in Local Zones. If the source instance is not in a Local Zone, + * omit this parameter.
+ *To create local snapshots in the same Local Zone as the source instance, specify
+ * local.
To create a regional snapshots in the parent Region of the Local Zone, specify
+ * regional or omit this parameter.
Default value: regional
+ *
The Availability Zone or Local Zone of the snapshots. For example, us-west-1a
+ * (Availability Zone) or us-west-2-lax-1a (Local Zone).
The ID of the Client VPN endpoint from which the route is to be deleted.
- * @public - */ - ClientVpnEndpointId: string | undefined; - - /** - *The ID of the target subnet used by the route.
- * @public - */ - TargetVpcSubnetId?: string | undefined; - - /** - *The IPv4 address range, in CIDR notation, of the route to be deleted.
- * @public - */ - DestinationCidrBlock: string | undefined; - - /** - *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 DryRunOperation. Otherwise, it is UnauthorizedOperation.
The ID of the Client VPN endpoint from which the route is to be deleted.
+ * @public + */ + ClientVpnEndpointId: string | undefined; + + /** + *The ID of the target subnet used by the route.
+ * @public + */ + TargetVpcSubnetId?: string | undefined; + + /** + *The IPv4 address range, in CIDR notation, of the route to be deleted.
+ * @public + */ + DestinationCidrBlock: string | undefined; + + /** + *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 DryRunOperation. Otherwise, it is UnauthorizedOperation.
Information about the events in the history of the EC2 Fleet.
- * @public - */ - HistoryRecords?: HistoryRecordEntry[] | undefined; - - /** - *The last date and time for the events, in UTC format (for example, - * YYYY-MM-DDTHH:MM:SSZ). - * All records up to this time were retrieved.
- *If nextToken indicates that there are more items, this value is not
- * present.
The token to include in another request to get the next page of items. This value is null when there
- * are no more items to return.
The ID of the EC Fleet.
- * @public - */ - FleetId?: string | undefined; - - /** - *The start date and time for the events, in UTC format (for example, - * YYYY-MM-DDTHH:MM:SSZ).
- * @public - */ - StartTime?: Date | undefined; -} - /** * @internal */ diff --git a/clients/client-ec2/src/models/models_4.ts b/clients/client-ec2/src/models/models_4.ts index 3c555b321e6c..9bd1bcb3770d 100644 --- a/clients/client-ec2/src/models/models_4.ts +++ b/clients/client-ec2/src/models/models_4.ts @@ -81,7 +81,55 @@ import { ReplaceRootVolumeTask, } from "./models_2"; -import { Byoasn, Filter, FleetStateCode, IdFormat, InstanceTagNotificationAttribute } from "./models_3"; +import { + Byoasn, + Filter, + FleetStateCode, + HistoryRecordEntry, + IdFormat, + InstanceTagNotificationAttribute, +} from "./models_3"; + +/** + * @public + */ +export interface DescribeFleetHistoryResult { + /** + *Information about the events in the history of the EC2 Fleet.
+ * @public + */ + HistoryRecords?: HistoryRecordEntry[] | undefined; + + /** + *The last date and time for the events, in UTC format (for example, + * YYYY-MM-DDTHH:MM:SSZ). + * All records up to this time were retrieved.
+ *If nextToken indicates that there are more items, this value is not
+ * present.
The token to include in another request to get the next page of items. This value is null when there
+ * are no more items to return.
The ID of the EC Fleet.
+ * @public + */ + FleetId?: string | undefined; + + /** + *The start date and time for the events, in UTC format (for example, + * YYYY-MM-DDTHH:MM:SSZ).
+ * @public + */ + StartTime?: Date | undefined; +} /** * @public @@ -12421,24 +12469,6 @@ export const OfferingClassType = { */ export type OfferingClassType = (typeof OfferingClassType)[keyof typeof OfferingClassType]; -/** - * @public - * @enum - */ -export const OfferingTypeValues = { - All_Upfront: "All Upfront", - Heavy_Utilization: "Heavy Utilization", - Light_Utilization: "Light Utilization", - Medium_Utilization: "Medium Utilization", - No_Upfront: "No Upfront", - Partial_Upfront: "Partial Upfront", -} as const; - -/** - * @public - */ -export type OfferingTypeValues = (typeof OfferingTypeValues)[keyof typeof OfferingTypeValues]; - /** * @internal */ diff --git a/clients/client-ec2/src/models/models_5.ts b/clients/client-ec2/src/models/models_5.ts index c869a172595c..7f63d30198b8 100644 --- a/clients/client-ec2/src/models/models_5.ts +++ b/clients/client-ec2/src/models/models_5.ts @@ -114,7 +114,25 @@ import { StatisticType, } from "./models_3"; -import { AttributeBooleanValue, OfferingClassType, OfferingTypeValues, PermissionGroup, ProductCode } from "./models_4"; +import { AttributeBooleanValue, OfferingClassType, PermissionGroup, ProductCode } from "./models_4"; + +/** + * @public + * @enum + */ +export const OfferingTypeValues = { + All_Upfront: "All Upfront", + Heavy_Utilization: "Heavy Utilization", + Light_Utilization: "Light Utilization", + Medium_Utilization: "Medium Utilization", + No_Upfront: "No Upfront", + Partial_Upfront: "Partial Upfront", +} as const; + +/** + * @public + */ +export type OfferingTypeValues = (typeof OfferingTypeValues)[keyof typeof OfferingTypeValues]; /** *Contains the parameters for DescribeReservedInstances.
@@ -11064,17 +11082,6 @@ export interface EnableAddressTransferRequest { DryRun?: boolean | undefined; } -/** - * @public - */ -export interface EnableAddressTransferResult { - /** - *An Elastic IP address transfer.
- * @public - */ - AddressTransfer?: AddressTransfer | undefined; -} - /** * @internal */ diff --git a/clients/client-ec2/src/models/models_6.ts b/clients/client-ec2/src/models/models_6.ts index bfb522d8d62a..625776e6abd7 100644 --- a/clients/client-ec2/src/models/models_6.ts +++ b/clients/client-ec2/src/models/models_6.ts @@ -4,6 +4,7 @@ import { SENSITIVE_STRING } from "@smithy/smithy-client"; import { AccessScopeAnalysisFinding, AddressAttribute, + AddressTransfer, AllowedImagesSettingsEnabledState, AutoPlacement, CurrencyCodeValues, @@ -35,7 +36,6 @@ import { EndDateType, FleetExcessCapacityTerminationPolicy, FleetLaunchTemplateConfigRequest, - InstanceEventWindowTimeRangeRequest, InstanceMatchCriteria, InstanceRequirementsRequest, IpamResourceTag, @@ -105,6 +105,17 @@ import { TransitGatewayPropagationState, } from "./models_5"; +/** + * @public + */ +export interface EnableAddressTransferResult { + /** + *An Elastic IP address transfer.
+ * @public + */ + AddressTransfer?: AddressTransfer | undefined; +} + /** * @public */ @@ -8970,71 +8981,6 @@ export interface ModifyInstanceEventStartTimeResult { Event?: InstanceStatusEvent | undefined; } -/** - * @public - */ -export interface ModifyInstanceEventWindowRequest { - /** - *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 DryRunOperation.
- * Otherwise, it is UnauthorizedOperation.
The name of the event window.
- * @public - */ - Name?: string | undefined; - - /** - *The ID of the event window.
- * @public - */ - InstanceEventWindowId: string | undefined; - - /** - *The time ranges of the event window.
- * @public - */ - TimeRanges?: InstanceEventWindowTimeRangeRequest[] | undefined; - - /** - *The cron expression of the event window, for example, * 0-4,20-23 * * 1,5.
Constraints:
- *Only hour and day of the week values are supported.
- *For day of the week values, you can specify either integers 0 through
- * 6, or alternative single values SUN through
- * SAT.
The minute, month, and year must be specified by *.
The hour value must be one or a multiple range, for example, 0-4 or
- * 0-4,20-23.
Each hour range must be >= 2 hours, for example, 0-2 or
- * 20-23.
The event window must be >= 4 hours. The combined total time ranges in the event - * window must be >= 4 hours.
- *For more information about cron expressions, see cron on the Wikipedia - * website.
- * @public - */ - CronExpression?: string | undefined; -} - /** * @internal */ diff --git a/clients/client-ec2/src/models/models_7.ts b/clients/client-ec2/src/models/models_7.ts index a998c5bfa369..b4e9718a7071 100644 --- a/clients/client-ec2/src/models/models_7.ts +++ b/clients/client-ec2/src/models/models_7.ts @@ -48,6 +48,7 @@ import { ElasticGpuSpecification, HostnameType, InstanceBandwidthWeighting, + InstanceEventWindowTimeRangeRequest, InstanceInterruptionBehavior, InstanceIpv6Address, Ipam, @@ -159,6 +160,71 @@ import { import { CapacityReservationSpecification, IpamResourceCidr, OperationType, Purchase } from "./models_6"; +/** + * @public + */ +export interface ModifyInstanceEventWindowRequest { + /** + *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 DryRunOperation.
+ * Otherwise, it is UnauthorizedOperation.
The name of the event window.
+ * @public + */ + Name?: string | undefined; + + /** + *The ID of the event window.
+ * @public + */ + InstanceEventWindowId: string | undefined; + + /** + *The time ranges of the event window.
+ * @public + */ + TimeRanges?: InstanceEventWindowTimeRangeRequest[] | undefined; + + /** + *The cron expression of the event window, for example, * 0-4,20-23 * * 1,5.
Constraints:
+ *Only hour and day of the week values are supported.
+ *For day of the week values, you can specify either integers 0 through
+ * 6, or alternative single values SUN through
+ * SAT.
The minute, month, and year must be specified by *.
The hour value must be one or a multiple range, for example, 0-4 or
+ * 0-4,20-23.
Each hour range must be >= 2 hours, for example, 0-2 or
+ * 20-23.
The event window must be >= 4 hours. The combined total time ranges in the event + * window must be >= 4 hours.
+ *For more information about cron expressions, see cron on the Wikipedia + * website.
+ * @public + */ + CronExpression?: string | undefined; +} + /** * @public */ @@ -9458,25 +9524,6 @@ export interface UnassignPrivateNatGatewayAddressResult { NatGatewayAddresses?: NatGatewayAddress[] | undefined; } -/** - * @public - */ -export interface UnlockSnapshotRequest { - /** - *The ID of the snapshot to unlock.
- * @public - */ - SnapshotId: string | undefined; - - /** - *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 DryRunOperation.
- * Otherwise, it is UnauthorizedOperation.
The ID of the snapshot to unlock.
+ * @public + */ + SnapshotId: string | undefined; + + /** + *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 DryRunOperation.
+ * Otherwise, it is UnauthorizedOperation.
Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for\n \tbackups, to make copies of EBS volumes, and to save data before shutting down an\n \tinstance.
\nYou can create snapshots of volumes in a Region and volumes on an Outpost. If you \n \tcreate a snapshot of a volume in a Region, the snapshot must be stored in the same \n \tRegion as the volume. If you create a snapshot of a volume on an Outpost, the snapshot \n \tcan be stored on the same Outpost as the volume, or in the Region for that Outpost.
\nWhen a snapshot is created, any Amazon Web Services Marketplace product codes that are associated with the\n source volume are propagated to the snapshot.
\nYou can take a snapshot of an attached volume that is in use. However, snapshots only\n capture data that has been written to your Amazon EBS volume at the time the snapshot command is\n issued; this might exclude any data that has been cached by any applications or the operating\n system. If you can pause any file systems on the volume long enough to take a snapshot, your\n snapshot should be complete. However, if you cannot pause all file writes to the volume, you\n should unmount the volume from within the instance, issue the snapshot command, and then\n remount the volume to ensure a consistent and complete snapshot. You may remount and use your\n volume while the snapshot status is pending.
When you create a snapshot for an EBS volume that serves as a root device, we recommend \n that you stop the instance before taking the snapshot.
\nSnapshots that are taken from encrypted volumes are automatically encrypted. Volumes that\n are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes\n and any associated snapshots always remain protected.
\nYou can tag your snapshots during creation. For more information, see Tag your Amazon EC2\n resources in the Amazon EC2 User Guide.
\nFor more information, see Amazon EBS and Amazon EBS encryption in the Amazon EBS User Guide.
", + "smithy.api#documentation": "Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for\n \tbackups, to make copies of EBS volumes, and to save data before shutting down an\n \tinstance.
\nThe location of the source EBS volume determines where you can create the snapshot.
\nIf the source volume is in a Region, you must create the snapshot in the same \n Region as the volume.
\nIf the source volume is in a Local Zone, you can create the snapshot in the same \n Local Zone or in parent Amazon Web Services Region.
\nIf the source volume is on an Outpost, you can create the snapshot on the same \n Outpost or in its parent Amazon Web Services Region.
\nWhen a snapshot is created, any Amazon Web Services Marketplace product codes that are associated with the\n source volume are propagated to the snapshot.
\nYou can take a snapshot of an attached volume that is in use. However, snapshots only\n capture data that has been written to your Amazon EBS volume at the time the snapshot command is\n issued; this might exclude any data that has been cached by any applications or the operating\n system. If you can pause any file systems on the volume long enough to take a snapshot, your\n snapshot should be complete. However, if you cannot pause all file writes to the volume, you\n should unmount the volume from within the instance, issue the snapshot command, and then\n remount the volume to ensure a consistent and complete snapshot. You may remount and use your\n volume while the snapshot status is pending.
When you create a snapshot for an EBS volume that serves as a root device, we recommend \n that you stop the instance before taking the snapshot.
\nSnapshots that are taken from encrypted volumes are automatically encrypted. Volumes that\n are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes\n and any associated snapshots always remain protected. For more information, \n Amazon EBS encryption \n in the Amazon EBS User Guide.
", "smithy.api#examples": [ { "title": "To create a snapshot", @@ -19829,7 +19829,7 @@ "OutpostArn": { "target": "com.amazonaws.ec2#String", "traits": { - "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Outpost on which to create a local \n \tsnapshot.
\nTo create a snapshot of a volume in a Region, omit this parameter. The snapshot \n \t\t\t\tis created in the same Region as the volume.
\nTo create a snapshot of a volume on an Outpost and store the snapshot in the \n \t\t\t\tRegion, omit this parameter. The snapshot is created in the Region for the \n \t\t\t\tOutpost.
\nTo create a snapshot of a volume on an Outpost and store the snapshot on an \n \t\t\tOutpost, specify the ARN of the destination Outpost. The snapshot must be created on \n \t\t\tthe same Outpost as the volume.
\nFor more information, see Create local snapshots from volumes on an Outpost in the Amazon EBS User Guide.
" + "smithy.api#documentation": "Only supported for volumes on Outposts. If the source volume is not on an Outpost, \n omit this parameter.
\nTo create the snapshot on the same Outpost as the source volume, specify the \n ARN of that Outpost. The snapshot must be created on the same Outpost as the volume.
\nTo create the snapshot in the parent Region of the Outpost, omit this parameter.
\nFor more information, see Create local snapshots from volumes on an Outpost in the Amazon EBS User Guide.
" } }, "VolumeId": { @@ -19847,6 +19847,12 @@ "smithy.api#xmlName": "TagSpecification" } }, + "Location": { + "target": "com.amazonaws.ec2#SnapshotLocationEnum", + "traits": { + "smithy.api#documentation": "Only supported for volumes in Local Zones. If the source volume is not in a Local Zone, \n omit this parameter.
\nTo create a local snapshot in the same Local Zone as the source volume, specify \n local.
To create a regional snapshot in the parent Region of the Local Zone, specify \n regional or omit this parameter.
Default value: regional\n
Creates crash-consistent snapshots of multiple EBS volumes and stores the data in S3.\n Volumes are chosen by specifying an instance. Any attached volumes will produce one snapshot\n each that is crash-consistent across the instance.
\nYou can include all of the volumes currently attached to the instance, or you can exclude \n the root volume or specific data (non-root) volumes from the multi-volume snapshot set.
\nYou can create multi-volume snapshots of instances in a Region and instances on an \n \tOutpost. If you create snapshots from an instance in a Region, the snapshots must be stored \n \tin the same Region as the instance. If you create snapshots from an instance on an Outpost, \n \tthe snapshots can be stored on the same Outpost as the instance, or in the Region for that \n \tOutpost.
" + "smithy.api#documentation": "Creates crash-consistent snapshots of multiple EBS volumes attached to an Amazon EC2 instance.\n Volumes are chosen by specifying an instance. Each volume attached to the specified instance \n will produce one snapshot that is crash-consistent across the instance. You can include all of \n the volumes currently attached to the instance, or you can exclude the root volume or specific \n data (non-root) volumes from the multi-volume snapshot set.
\nThe location of the source instance determines where you can create the snapshots.
\nIf the source instance is in a Region, you must create the snapshots in the same \n Region as the instance.
\nIf the source instance is in a Local Zone, you can create the snapshots in the same \n Local Zone or in parent Amazon Web Services Region.
\nIf the source instance is on an Outpost, you can create the snapshots on the same \n Outpost or in its parent Amazon Web Services Region.
\nThe Amazon Resource Name (ARN) of the Outpost on which to create the local \n \t\tsnapshots.
\nTo create snapshots from an instance in a Region, omit this parameter. The \n \t\t\t\tsnapshots are created in the same Region as the instance.
\nTo create snapshots from an instance on an Outpost and store the snapshots \n \t\t\t\tin the Region, omit this parameter. The snapshots are created in the Region \n \t\t\t\tfor the Outpost.
\nTo create snapshots from an instance on an Outpost and store the snapshots \n \t\t\t\ton an Outpost, specify the ARN of the destination Outpost. The snapshots must \n \t\t\t\tbe created on the same Outpost as the instance.
\nFor more information, see \n \t\tCreate multi-volume local snapshots from instances on an Outpost in the \n \t\tAmazon EBS User Guide.
" + "smithy.api#documentation": "Only supported for instances on Outposts. If the source instance is not on an Outpost, \n omit this parameter.
\nTo create the snapshots on the same Outpost as the source instance, specify the \n ARN of that Outpost. The snapshots must be created on the same Outpost as the instance.
\nTo create the snapshots in the parent Region of the Outpost, omit this parameter.
\nFor more information, see \n Create local snapshots from volumes on an Outpost in the Amazon EBS User Guide.
" } }, "TagSpecifications": { @@ -19913,6 +19919,12 @@ "traits": { "smithy.api#documentation": "Copies the tags from the specified volume to corresponding snapshot.
" } + }, + "Location": { + "target": "com.amazonaws.ec2#SnapshotLocationEnum", + "traits": { + "smithy.api#documentation": "Only supported for instances in Local Zones. If the source instance is not in a Local Zone, \n omit this parameter.
\nTo create local snapshots in the same Local Zone as the source instance, specify \n local.
To create a regional snapshots in the parent Region of the Local Zone, specify \n regional or omit this parameter.
Default value: regional\n
The Availability Zone or Local Zone of the snapshot. For example, us-west-1a \n (Availability Zone) or us-west-2-lax-1a (Local Zone).
Reserved for future use.
", "smithy.api#xmlName": "sseType" } + }, + "AvailabilityZone": { + "target": "com.amazonaws.ec2#String", + "traits": { + "aws.protocols#ec2QueryName": "AvailabilityZone", + "smithy.api#documentation": "The Availability Zone or Local Zone of the snapshots. For example, us-west-1a \n (Availability Zone) or us-west-2-lax-1a (Local Zone).