aws-sdk-ec2 1.497.0 → 1.498.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8b131fec51e5037c4687703cc3a8a158309d1f9a7f0ecfca6ba4f01b13b82823
4
- data.tar.gz: f65999a47814628898dd4ee1f6d0b3b54f448cf60a9f7249844431997eaba0af
3
+ metadata.gz: 470f7b2fdcd4a626a51e278d1ce72e368e68f8c79ef6b0bb2e672c7ee354d5eb
4
+ data.tar.gz: 47b5ce0689cf5c3cbe8e8f50b4ea6989cbb8b4a82961883eb2e13f505bf34c4f
5
5
  SHA512:
6
- metadata.gz: ed03c11256700c538f2408bb51ea0aeafde75b7db1fcf2eba3768ad90eaf1be2bea58f4d92915390f52e168f65b83d597933430e197f6a30b68b44bda9d7a0ef
7
- data.tar.gz: 739cf4e23bb311166d9d729aac01e552fa7027fee04738cb617a5fbf3287acbc39fd74c4e8ea54a355f7e023f759d896c7e03f1df3cdaceddc9c2cde6c93fdcc
6
+ metadata.gz: fad54eea26189abec229055f4e7d43a18453e9d81210f42d62a273f65ca9d717e2f8e8361cdde7c681416b25851734858f9755632d63f8c89e9405b6db09f592
7
+ data.tar.gz: 351cd256ad6081fdccefc58bd2728d28beabfb0222b5b5f081c5e6401d69d1b862eb4c9d632abf3083f0046c9bcef14fbb594c60292ac3360525b6981b692402
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.498.0 (2024-12-16)
5
+ ------------------
6
+
7
+ * Feature - This release adds support for EBS local snapshots in AWS Dedicated Local Zones, which allows you to store snapshots of EBS volumes locally in Dedicated Local Zones.
8
+
4
9
  1.497.0 (2024-12-13)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.497.0
1
+ 1.498.0
@@ -12169,12 +12169,17 @@ module Aws::EC2
12169
12169
  # can use snapshots for backups, to make copies of EBS volumes, and to
12170
12170
  # save data before shutting down an instance.
12171
12171
  #
12172
- # You can create snapshots of volumes in a Region and volumes on an
12173
- # Outpost. If you create a snapshot of a volume in a Region, the
12174
- # snapshot must be stored in the same Region as the volume. If you
12175
- # create a snapshot of a volume on an Outpost, the snapshot can be
12176
- # stored on the same Outpost as the volume, or in the Region for that
12177
- # Outpost.
12172
+ # The location of the source EBS volume determines where you can create
12173
+ # the snapshot.
12174
+ #
12175
+ # * If the source volume is in a Region, you must create the snapshot in
12176
+ # the same Region as the volume.
12177
+ #
12178
+ # * If the source volume is in a Local Zone, you can create the snapshot
12179
+ # in the same Local Zone or in parent Amazon Web Services Region.
12180
+ #
12181
+ # * If the source volume is on an Outpost, you can create the snapshot
12182
+ # on the same Outpost or in its parent Amazon Web Services Region.
12178
12183
  #
12179
12184
  # When a snapshot is created, any Amazon Web Services Marketplace
12180
12185
  # product codes that are associated with the source volume are
@@ -12199,37 +12204,28 @@ module Aws::EC2
12199
12204
  # Snapshots that are taken from encrypted volumes are automatically
12200
12205
  # encrypted. Volumes that are created from encrypted snapshots are also
12201
12206
  # automatically encrypted. Your encrypted volumes and any associated
12202
- # snapshots always remain protected.
12203
- #
12204
- # You can tag your snapshots during creation. For more information, see
12205
- # [Tag your Amazon EC2 resources][1] in the *Amazon EC2 User Guide*.
12206
- #
12207
- # For more information, see [Amazon EBS][2] and [Amazon EBS
12208
- # encryption][3] in the *Amazon EBS User Guide*.
12207
+ # snapshots always remain protected. For more information, [Amazon EBS
12208
+ # encryption][1] in the *Amazon EBS User Guide*.
12209
12209
  #
12210
12210
  #
12211
12211
  #
12212
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html
12213
- # [2]: https://docs.aws.amazon.com/ebs/latest/userguide/what-is-ebs.html
12214
- # [3]: https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html
12212
+ # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html
12215
12213
  #
12216
12214
  # @option params [String] :description
12217
12215
  # A description for the snapshot.
12218
12216
  #
12219
12217
  # @option params [String] :outpost_arn
12220
- # The Amazon Resource Name (ARN) of the Outpost on which to create a
12221
- # local snapshot.
12218
+ # <note markdown="1"> Only supported for volumes on Outposts. If the source volume is not on
12219
+ # an Outpost, omit this parameter.
12222
12220
  #
12223
- # * To create a snapshot of a volume in a Region, omit this parameter.
12224
- # The snapshot is created in the same Region as the volume.
12221
+ # </note>
12225
12222
  #
12226
- # * To create a snapshot of a volume on an Outpost and store the
12227
- # snapshot in the Region, omit this parameter. The snapshot is created
12228
- # in the Region for the Outpost.
12223
+ # * To create the snapshot on the same Outpost as the source volume,
12224
+ # specify the ARN of that Outpost. The snapshot must be created on the
12225
+ # same Outpost as the volume.
12229
12226
  #
12230
- # * To create a snapshot of a volume on an Outpost and store the
12231
- # snapshot on an Outpost, specify the ARN of the destination Outpost.
12232
- # The snapshot must be created on the same Outpost as the volume.
12227
+ # * To create the snapshot in the parent Region of the Outpost, omit
12228
+ # this parameter.
12233
12229
  #
12234
12230
  # For more information, see [Create local snapshots from volumes on an
12235
12231
  # Outpost][1] in the *Amazon EBS User Guide*.
@@ -12244,6 +12240,20 @@ module Aws::EC2
12244
12240
  # @option params [Array<Types::TagSpecification>] :tag_specifications
12245
12241
  # The tags to apply to the snapshot during creation.
12246
12242
  #
12243
+ # @option params [String] :location
12244
+ # <note markdown="1"> Only supported for volumes in Local Zones. If the source volume is not
12245
+ # in a Local Zone, omit this parameter.
12246
+ #
12247
+ # </note>
12248
+ #
12249
+ # * To create a local snapshot in the same Local Zone as the source
12250
+ # volume, specify `local`.
12251
+ #
12252
+ # * To create a regional snapshot in the parent Region of the Local
12253
+ # Zone, specify `regional` or omit this parameter.
12254
+ #
12255
+ # Default value: `regional`
12256
+ #
12247
12257
  # @option params [Boolean] :dry_run
12248
12258
  # Checks whether you have the required permissions for the action,
12249
12259
  # without actually making the request, and provides an error response.
@@ -12258,6 +12268,7 @@ module Aws::EC2
12258
12268
  # * {Types::Snapshot#storage_tier #storage_tier} => String
12259
12269
  # * {Types::Snapshot#restore_expiry_time #restore_expiry_time} => Time
12260
12270
  # * {Types::Snapshot#sse_type #sse_type} => String
12271
+ # * {Types::Snapshot#availability_zone #availability_zone} => String
12261
12272
  # * {Types::Snapshot#transfer_type #transfer_type} => String
12262
12273
  # * {Types::Snapshot#completion_duration_minutes #completion_duration_minutes} => Integer
12263
12274
  # * {Types::Snapshot#completion_time #completion_time} => Time
@@ -12315,6 +12326,7 @@ module Aws::EC2
12315
12326
  # ],
12316
12327
  # },
12317
12328
  # ],
12329
+ # location: "regional", # accepts regional, local
12318
12330
  # dry_run: false,
12319
12331
  # })
12320
12332
  #
@@ -12328,6 +12340,7 @@ module Aws::EC2
12328
12340
  # resp.storage_tier #=> String, one of "archive", "standard"
12329
12341
  # resp.restore_expiry_time #=> Time
12330
12342
  # resp.sse_type #=> String, one of "sse-ebs", "sse-kms", "none"
12343
+ # resp.availability_zone #=> String
12331
12344
  # resp.transfer_type #=> String, one of "time-based", "standard"
12332
12345
  # resp.completion_duration_minutes #=> Integer
12333
12346
  # resp.completion_time #=> Time
@@ -12353,21 +12366,27 @@ module Aws::EC2
12353
12366
  req.send_request(options)
12354
12367
  end
12355
12368
 
12356
- # Creates crash-consistent snapshots of multiple EBS volumes and stores
12357
- # the data in S3. Volumes are chosen by specifying an instance. Any
12358
- # attached volumes will produce one snapshot each that is
12359
- # crash-consistent across the instance.
12369
+ # Creates crash-consistent snapshots of multiple EBS volumes attached to
12370
+ # an Amazon EC2 instance. Volumes are chosen by specifying an instance.
12371
+ # Each volume attached to the specified instance will produce one
12372
+ # snapshot that is crash-consistent across the instance. You can include
12373
+ # all of the volumes currently attached to the instance, or you can
12374
+ # exclude the root volume or specific data (non-root) volumes from the
12375
+ # multi-volume snapshot set.
12360
12376
  #
12361
- # You can include all of the volumes currently attached to the instance,
12362
- # or you can exclude the root volume or specific data (non-root) volumes
12363
- # from the multi-volume snapshot set.
12377
+ # The location of the source instance determines where you can create
12378
+ # the snapshots.
12364
12379
  #
12365
- # You can create multi-volume snapshots of instances in a Region and
12366
- # instances on an Outpost. If you create snapshots from an instance in a
12367
- # Region, the snapshots must be stored in the same Region as the
12368
- # instance. If you create snapshots from an instance on an Outpost, the
12369
- # snapshots can be stored on the same Outpost as the instance, or in the
12370
- # Region for that Outpost.
12380
+ # * If the source instance is in a Region, you must create the snapshots
12381
+ # in the same Region as the instance.
12382
+ #
12383
+ # * If the source instance is in a Local Zone, you can create the
12384
+ # snapshots in the same Local Zone or in parent Amazon Web Services
12385
+ # Region.
12386
+ #
12387
+ # * If the source instance is on an Outpost, you can create the
12388
+ # snapshots on the same Outpost or in its parent Amazon Web Services
12389
+ # Region.
12371
12390
  #
12372
12391
  # @option params [String] :description
12373
12392
  # A description propagated to every snapshot specified by the instance.
@@ -12377,27 +12396,24 @@ module Aws::EC2
12377
12396
  # snapshots.
12378
12397
  #
12379
12398
  # @option params [String] :outpost_arn
12380
- # The Amazon Resource Name (ARN) of the Outpost on which to create the
12381
- # local snapshots.
12399
+ # <note markdown="1"> Only supported for instances on Outposts. If the source instance is
12400
+ # not on an Outpost, omit this parameter.
12382
12401
  #
12383
- # * To create snapshots from an instance in a Region, omit this
12384
- # parameter. The snapshots are created in the same Region as the
12385
- # instance.
12402
+ # </note>
12386
12403
  #
12387
- # * To create snapshots from an instance on an Outpost and store the
12388
- # snapshots in the Region, omit this parameter. The snapshots are
12389
- # created in the Region for the Outpost.
12404
+ # * To create the snapshots on the same Outpost as the source instance,
12405
+ # specify the ARN of that Outpost. The snapshots must be created on
12406
+ # the same Outpost as the instance.
12390
12407
  #
12391
- # * To create snapshots from an instance on an Outpost and store the
12392
- # snapshots on an Outpost, specify the ARN of the destination Outpost.
12393
- # The snapshots must be created on the same Outpost as the instance.
12408
+ # * To create the snapshots in the parent Region of the Outpost, omit
12409
+ # this parameter.
12394
12410
  #
12395
- # For more information, see [ Create multi-volume local snapshots from
12396
- # instances on an Outpost][1] in the *Amazon EBS User Guide*.
12411
+ # For more information, see [ Create local snapshots from volumes on an
12412
+ # Outpost][1] in the *Amazon EBS User Guide*.
12397
12413
  #
12398
12414
  #
12399
12415
  #
12400
- # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#create-multivol-snapshot
12416
+ # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#create-snapshot
12401
12417
  #
12402
12418
  # @option params [Array<Types::TagSpecification>] :tag_specifications
12403
12419
  # Tags to apply to every snapshot specified by the instance.
@@ -12411,6 +12427,20 @@ module Aws::EC2
12411
12427
  # @option params [String] :copy_tags_from_source
12412
12428
  # Copies the tags from the specified volume to corresponding snapshot.
12413
12429
  #
12430
+ # @option params [String] :location
12431
+ # <note markdown="1"> Only supported for instances in Local Zones. If the source instance is
12432
+ # not in a Local Zone, omit this parameter.
12433
+ #
12434
+ # </note>
12435
+ #
12436
+ # * To create local snapshots in the same Local Zone as the source
12437
+ # instance, specify `local`.
12438
+ #
12439
+ # * To create a regional snapshots in the parent Region of the Local
12440
+ # Zone, specify `regional` or omit this parameter.
12441
+ #
12442
+ # Default value: `regional`
12443
+ #
12414
12444
  # @return [Types::CreateSnapshotsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
12415
12445
  #
12416
12446
  # * {Types::CreateSnapshotsResult#snapshots #snapshots} => Array&lt;Types::SnapshotInfo&gt;
@@ -12438,6 +12468,7 @@ module Aws::EC2
12438
12468
  # ],
12439
12469
  # dry_run: false,
12440
12470
  # copy_tags_from_source: "volume", # accepts volume
12471
+ # location: "regional", # accepts regional, local
12441
12472
  # })
12442
12473
  #
12443
12474
  # @example Response structure
@@ -12457,6 +12488,7 @@ module Aws::EC2
12457
12488
  # resp.snapshots[0].snapshot_id #=> String
12458
12489
  # resp.snapshots[0].outpost_arn #=> String
12459
12490
  # resp.snapshots[0].sse_type #=> String, one of "sse-ebs", "sse-kms", "none"
12491
+ # resp.snapshots[0].availability_zone #=> String
12460
12492
  #
12461
12493
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateSnapshots AWS API Documentation
12462
12494
  #
@@ -34357,6 +34389,7 @@ module Aws::EC2
34357
34389
  # resp.snapshots[0].storage_tier #=> String, one of "archive", "standard"
34358
34390
  # resp.snapshots[0].restore_expiry_time #=> Time
34359
34391
  # resp.snapshots[0].sse_type #=> String, one of "sse-ebs", "sse-kms", "none"
34392
+ # resp.snapshots[0].availability_zone #=> String
34360
34393
  # resp.snapshots[0].transfer_type #=> String, one of "time-based", "standard"
34361
34394
  # resp.snapshots[0].completion_duration_minutes #=> Integer
34362
34395
  # resp.snapshots[0].completion_time #=> Time
@@ -63082,7 +63115,7 @@ module Aws::EC2
63082
63115
  tracer: tracer
63083
63116
  )
63084
63117
  context[:gem_name] = 'aws-sdk-ec2'
63085
- context[:gem_version] = '1.497.0'
63118
+ context[:gem_version] = '1.498.0'
63086
63119
  Seahorse::Client::Request.new(handlers, context)
63087
63120
  end
63088
63121
 
@@ -2914,6 +2914,7 @@ module Aws::EC2
2914
2914
  SnapshotIdStringList = Shapes::ListShape.new(name: 'SnapshotIdStringList')
2915
2915
  SnapshotInfo = Shapes::StructureShape.new(name: 'SnapshotInfo')
2916
2916
  SnapshotList = Shapes::ListShape.new(name: 'SnapshotList')
2917
+ SnapshotLocationEnum = Shapes::StringShape.new(name: 'SnapshotLocationEnum')
2917
2918
  SnapshotRecycleBinInfo = Shapes::StructureShape.new(name: 'SnapshotRecycleBinInfo')
2918
2919
  SnapshotRecycleBinInfoList = Shapes::ListShape.new(name: 'SnapshotRecycleBinInfoList')
2919
2920
  SnapshotSet = Shapes::ListShape.new(name: 'SnapshotSet')
@@ -5476,6 +5477,7 @@ module Aws::EC2
5476
5477
  CreateSnapshotRequest.add_member(:outpost_arn, Shapes::ShapeRef.new(shape: String, location_name: "OutpostArn"))
5477
5478
  CreateSnapshotRequest.add_member(:volume_id, Shapes::ShapeRef.new(shape: VolumeId, required: true, location_name: "VolumeId"))
5478
5479
  CreateSnapshotRequest.add_member(:tag_specifications, Shapes::ShapeRef.new(shape: TagSpecificationList, location_name: "TagSpecification"))
5480
+ CreateSnapshotRequest.add_member(:location, Shapes::ShapeRef.new(shape: SnapshotLocationEnum, location_name: "Location"))
5479
5481
  CreateSnapshotRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "dryRun"))
5480
5482
  CreateSnapshotRequest.struct_class = Types::CreateSnapshotRequest
5481
5483
 
@@ -5485,6 +5487,7 @@ module Aws::EC2
5485
5487
  CreateSnapshotsRequest.add_member(:tag_specifications, Shapes::ShapeRef.new(shape: TagSpecificationList, location_name: "TagSpecification"))
5486
5488
  CreateSnapshotsRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "DryRun"))
5487
5489
  CreateSnapshotsRequest.add_member(:copy_tags_from_source, Shapes::ShapeRef.new(shape: CopyTagsFromSource, location_name: "CopyTagsFromSource"))
5490
+ CreateSnapshotsRequest.add_member(:location, Shapes::ShapeRef.new(shape: SnapshotLocationEnum, location_name: "Location"))
5488
5491
  CreateSnapshotsRequest.struct_class = Types::CreateSnapshotsRequest
5489
5492
 
5490
5493
  CreateSnapshotsResult.add_member(:snapshots, Shapes::ShapeRef.new(shape: SnapshotSet, location_name: "snapshotSet"))
@@ -14969,6 +14972,7 @@ module Aws::EC2
14969
14972
  Snapshot.add_member(:storage_tier, Shapes::ShapeRef.new(shape: StorageTier, location_name: "storageTier"))
14970
14973
  Snapshot.add_member(:restore_expiry_time, Shapes::ShapeRef.new(shape: MillisecondDateTime, location_name: "restoreExpiryTime"))
14971
14974
  Snapshot.add_member(:sse_type, Shapes::ShapeRef.new(shape: SSEType, location_name: "sseType"))
14975
+ Snapshot.add_member(:availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "availabilityZone"))
14972
14976
  Snapshot.add_member(:transfer_type, Shapes::ShapeRef.new(shape: TransferType, location_name: "transferType"))
14973
14977
  Snapshot.add_member(:completion_duration_minutes, Shapes::ShapeRef.new(shape: SnapshotCompletionDurationMinutesResponse, location_name: "completionDurationMinutes"))
14974
14978
  Snapshot.add_member(:completion_time, Shapes::ShapeRef.new(shape: MillisecondDateTime, location_name: "completionTime"))
@@ -15020,6 +15024,7 @@ module Aws::EC2
15020
15024
  SnapshotInfo.add_member(:snapshot_id, Shapes::ShapeRef.new(shape: String, location_name: "snapshotId"))
15021
15025
  SnapshotInfo.add_member(:outpost_arn, Shapes::ShapeRef.new(shape: String, location_name: "outpostArn"))
15022
15026
  SnapshotInfo.add_member(:sse_type, Shapes::ShapeRef.new(shape: SSEType, location_name: "sseType"))
15027
+ SnapshotInfo.add_member(:availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "availabilityZone"))
15023
15028
  SnapshotInfo.struct_class = Types::SnapshotInfo
15024
15029
 
15025
15030
  SnapshotList.member = Shapes::ShapeRef.new(shape: Snapshot, location_name: "item")
@@ -1223,25 +1223,24 @@ module Aws::EC2
1223
1223
  # ],
1224
1224
  # },
1225
1225
  # ],
1226
+ # location: "regional", # accepts regional, local
1226
1227
  # dry_run: false,
1227
1228
  # })
1228
1229
  # @param [Hash] options ({})
1229
1230
  # @option options [String] :description
1230
1231
  # A description for the snapshot.
1231
1232
  # @option options [String] :outpost_arn
1232
- # The Amazon Resource Name (ARN) of the Outpost on which to create a
1233
- # local snapshot.
1233
+ # <note markdown="1"> Only supported for volumes on Outposts. If the source volume is not on
1234
+ # an Outpost, omit this parameter.
1234
1235
  #
1235
- # * To create a snapshot of a volume in a Region, omit this parameter.
1236
- # The snapshot is created in the same Region as the volume.
1236
+ # </note>
1237
1237
  #
1238
- # * To create a snapshot of a volume on an Outpost and store the
1239
- # snapshot in the Region, omit this parameter. The snapshot is created
1240
- # in the Region for the Outpost.
1238
+ # * To create the snapshot on the same Outpost as the source volume,
1239
+ # specify the ARN of that Outpost. The snapshot must be created on the
1240
+ # same Outpost as the volume.
1241
1241
  #
1242
- # * To create a snapshot of a volume on an Outpost and store the
1243
- # snapshot on an Outpost, specify the ARN of the destination Outpost.
1244
- # The snapshot must be created on the same Outpost as the volume.
1242
+ # * To create the snapshot in the parent Region of the Outpost, omit
1243
+ # this parameter.
1245
1244
  #
1246
1245
  # For more information, see [Create local snapshots from volumes on an
1247
1246
  # Outpost][1] in the *Amazon EBS User Guide*.
@@ -1253,6 +1252,19 @@ module Aws::EC2
1253
1252
  # The ID of the Amazon EBS volume.
1254
1253
  # @option options [Array<Types::TagSpecification>] :tag_specifications
1255
1254
  # The tags to apply to the snapshot during creation.
1255
+ # @option options [String] :location
1256
+ # <note markdown="1"> Only supported for volumes in Local Zones. If the source volume is not
1257
+ # in a Local Zone, omit this parameter.
1258
+ #
1259
+ # </note>
1260
+ #
1261
+ # * To create a local snapshot in the same Local Zone as the source
1262
+ # volume, specify `local`.
1263
+ #
1264
+ # * To create a regional snapshot in the parent Region of the Local
1265
+ # Zone, specify `regional` or omit this parameter.
1266
+ #
1267
+ # Default value: `regional`
1256
1268
  # @option options [Boolean] :dry_run
1257
1269
  # Checks whether you have the required permissions for the action,
1258
1270
  # without actually making the request, and provides an error response.
@@ -84,6 +84,13 @@ module Aws::EC2
84
84
  data[:sse_type]
85
85
  end
86
86
 
87
+ # The Availability Zone or Local Zone of the snapshot. For example,
88
+ # `us-west-1a` (Availability Zone) or `us-west-2-lax-1a` (Local Zone).
89
+ # @return [String]
90
+ def availability_zone
91
+ data[:availability_zone]
92
+ end
93
+
87
94
  # <note markdown="1"> Only for snapshot copies.
88
95
  #
89
96
  # </note>
@@ -11504,20 +11504,17 @@ module Aws::EC2
11504
11504
  # @return [String]
11505
11505
  #
11506
11506
  # @!attribute [rw] outpost_arn
11507
- # The Amazon Resource Name (ARN) of the Outpost on which to create a
11508
- # local snapshot.
11507
+ # <note markdown="1"> Only supported for volumes on Outposts. If the source volume is not
11508
+ # on an Outpost, omit this parameter.
11509
11509
  #
11510
- # * To create a snapshot of a volume in a Region, omit this parameter.
11511
- # The snapshot is created in the same Region as the volume.
11510
+ # </note>
11512
11511
  #
11513
- # * To create a snapshot of a volume on an Outpost and store the
11514
- # snapshot in the Region, omit this parameter. The snapshot is
11515
- # created in the Region for the Outpost.
11512
+ # * To create the snapshot on the same Outpost as the source volume,
11513
+ # specify the ARN of that Outpost. The snapshot must be created on
11514
+ # the same Outpost as the volume.
11516
11515
  #
11517
- # * To create a snapshot of a volume on an Outpost and store the
11518
- # snapshot on an Outpost, specify the ARN of the destination
11519
- # Outpost. The snapshot must be created on the same Outpost as the
11520
- # volume.
11516
+ # * To create the snapshot in the parent Region of the Outpost, omit
11517
+ # this parameter.
11521
11518
  #
11522
11519
  # For more information, see [Create local snapshots from volumes on an
11523
11520
  # Outpost][1] in the *Amazon EBS User Guide*.
@@ -11535,6 +11532,21 @@ module Aws::EC2
11535
11532
  # The tags to apply to the snapshot during creation.
11536
11533
  # @return [Array<Types::TagSpecification>]
11537
11534
  #
11535
+ # @!attribute [rw] location
11536
+ # <note markdown="1"> Only supported for volumes in Local Zones. If the source volume is
11537
+ # not in a Local Zone, omit this parameter.
11538
+ #
11539
+ # </note>
11540
+ #
11541
+ # * To create a local snapshot in the same Local Zone as the source
11542
+ # volume, specify `local`.
11543
+ #
11544
+ # * To create a regional snapshot in the parent Region of the Local
11545
+ # Zone, specify `regional` or omit this parameter.
11546
+ #
11547
+ # Default value: `regional`
11548
+ # @return [String]
11549
+ #
11538
11550
  # @!attribute [rw] dry_run
11539
11551
  # Checks whether you have the required permissions for the action,
11540
11552
  # without actually making the request, and provides an error response.
@@ -11549,6 +11561,7 @@ module Aws::EC2
11549
11561
  :outpost_arn,
11550
11562
  :volume_id,
11551
11563
  :tag_specifications,
11564
+ :location,
11552
11565
  :dry_run)
11553
11566
  SENSITIVE = []
11554
11567
  include Aws::Structure
@@ -11565,28 +11578,24 @@ module Aws::EC2
11565
11578
  # @return [Types::InstanceSpecification]
11566
11579
  #
11567
11580
  # @!attribute [rw] outpost_arn
11568
- # The Amazon Resource Name (ARN) of the Outpost on which to create the
11569
- # local snapshots.
11581
+ # <note markdown="1"> Only supported for instances on Outposts. If the source instance is
11582
+ # not on an Outpost, omit this parameter.
11570
11583
  #
11571
- # * To create snapshots from an instance in a Region, omit this
11572
- # parameter. The snapshots are created in the same Region as the
11573
- # instance.
11584
+ # </note>
11574
11585
  #
11575
- # * To create snapshots from an instance on an Outpost and store the
11576
- # snapshots in the Region, omit this parameter. The snapshots are
11577
- # created in the Region for the Outpost.
11586
+ # * To create the snapshots on the same Outpost as the source
11587
+ # instance, specify the ARN of that Outpost. The snapshots must be
11588
+ # created on the same Outpost as the instance.
11578
11589
  #
11579
- # * To create snapshots from an instance on an Outpost and store the
11580
- # snapshots on an Outpost, specify the ARN of the destination
11581
- # Outpost. The snapshots must be created on the same Outpost as the
11582
- # instance.
11590
+ # * To create the snapshots in the parent Region of the Outpost, omit
11591
+ # this parameter.
11583
11592
  #
11584
- # For more information, see [ Create multi-volume local snapshots from
11585
- # instances on an Outpost][1] in the *Amazon EBS User Guide*.
11593
+ # For more information, see [ Create local snapshots from volumes on
11594
+ # an Outpost][1] in the *Amazon EBS User Guide*.
11586
11595
  #
11587
11596
  #
11588
11597
  #
11589
- # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#create-multivol-snapshot
11598
+ # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#create-snapshot
11590
11599
  # @return [String]
11591
11600
  #
11592
11601
  # @!attribute [rw] tag_specifications
@@ -11604,6 +11613,21 @@ module Aws::EC2
11604
11613
  # Copies the tags from the specified volume to corresponding snapshot.
11605
11614
  # @return [String]
11606
11615
  #
11616
+ # @!attribute [rw] location
11617
+ # <note markdown="1"> Only supported for instances in Local Zones. If the source instance
11618
+ # is not in a Local Zone, omit this parameter.
11619
+ #
11620
+ # </note>
11621
+ #
11622
+ # * To create local snapshots in the same Local Zone as the source
11623
+ # instance, specify `local`.
11624
+ #
11625
+ # * To create a regional snapshots in the parent Region of the Local
11626
+ # Zone, specify `regional` or omit this parameter.
11627
+ #
11628
+ # Default value: `regional`
11629
+ # @return [String]
11630
+ #
11607
11631
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateSnapshotsRequest AWS API Documentation
11608
11632
  #
11609
11633
  class CreateSnapshotsRequest < Struct.new(
@@ -11612,7 +11636,8 @@ module Aws::EC2
11612
11636
  :outpost_arn,
11613
11637
  :tag_specifications,
11614
11638
  :dry_run,
11615
- :copy_tags_from_source)
11639
+ :copy_tags_from_source,
11640
+ :location)
11616
11641
  SENSITIVE = []
11617
11642
  include Aws::Structure
11618
11643
  end
@@ -65552,6 +65577,11 @@ module Aws::EC2
65552
65577
  # Reserved for future use.
65553
65578
  # @return [String]
65554
65579
  #
65580
+ # @!attribute [rw] availability_zone
65581
+ # The Availability Zone or Local Zone of the snapshot. For example,
65582
+ # `us-west-1a` (Availability Zone) or `us-west-2-lax-1a` (Local Zone).
65583
+ # @return [String]
65584
+ #
65555
65585
  # @!attribute [rw] transfer_type
65556
65586
  # <note markdown="1"> Only for snapshot copies.
65557
65587
  #
@@ -65657,6 +65687,7 @@ module Aws::EC2
65657
65687
  :storage_tier,
65658
65688
  :restore_expiry_time,
65659
65689
  :sse_type,
65690
+ :availability_zone,
65660
65691
  :transfer_type,
65661
65692
  :completion_duration_minutes,
65662
65693
  :completion_time,
@@ -65825,6 +65856,11 @@ module Aws::EC2
65825
65856
  # Reserved for future use.
65826
65857
  # @return [String]
65827
65858
  #
65859
+ # @!attribute [rw] availability_zone
65860
+ # The Availability Zone or Local Zone of the snapshots. For example,
65861
+ # `us-west-1a` (Availability Zone) or `us-west-2-lax-1a` (Local Zone).
65862
+ # @return [String]
65863
+ #
65828
65864
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/SnapshotInfo AWS API Documentation
65829
65865
  #
65830
65866
  class SnapshotInfo < Struct.new(
@@ -65839,7 +65875,8 @@ module Aws::EC2
65839
65875
  :owner_id,
65840
65876
  :snapshot_id,
65841
65877
  :outpost_arn,
65842
- :sse_type)
65878
+ :sse_type,
65879
+ :availability_zone)
65843
65880
  SENSITIVE = []
65844
65881
  include Aws::Structure
65845
65882
  end
@@ -334,25 +334,24 @@ module Aws::EC2
334
334
  # ],
335
335
  # },
336
336
  # ],
337
+ # location: "regional", # accepts regional, local
337
338
  # dry_run: false,
338
339
  # })
339
340
  # @param [Hash] options ({})
340
341
  # @option options [String] :description
341
342
  # A description for the snapshot.
342
343
  # @option options [String] :outpost_arn
343
- # The Amazon Resource Name (ARN) of the Outpost on which to create a
344
- # local snapshot.
344
+ # <note markdown="1"> Only supported for volumes on Outposts. If the source volume is not on
345
+ # an Outpost, omit this parameter.
345
346
  #
346
- # * To create a snapshot of a volume in a Region, omit this parameter.
347
- # The snapshot is created in the same Region as the volume.
347
+ # </note>
348
348
  #
349
- # * To create a snapshot of a volume on an Outpost and store the
350
- # snapshot in the Region, omit this parameter. The snapshot is created
351
- # in the Region for the Outpost.
349
+ # * To create the snapshot on the same Outpost as the source volume,
350
+ # specify the ARN of that Outpost. The snapshot must be created on the
351
+ # same Outpost as the volume.
352
352
  #
353
- # * To create a snapshot of a volume on an Outpost and store the
354
- # snapshot on an Outpost, specify the ARN of the destination Outpost.
355
- # The snapshot must be created on the same Outpost as the volume.
353
+ # * To create the snapshot in the parent Region of the Outpost, omit
354
+ # this parameter.
356
355
  #
357
356
  # For more information, see [Create local snapshots from volumes on an
358
357
  # Outpost][1] in the *Amazon EBS User Guide*.
@@ -362,6 +361,19 @@ module Aws::EC2
362
361
  # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#create-snapshot
363
362
  # @option options [Array<Types::TagSpecification>] :tag_specifications
364
363
  # The tags to apply to the snapshot during creation.
364
+ # @option options [String] :location
365
+ # <note markdown="1"> Only supported for volumes in Local Zones. If the source volume is not
366
+ # in a Local Zone, omit this parameter.
367
+ #
368
+ # </note>
369
+ #
370
+ # * To create a local snapshot in the same Local Zone as the source
371
+ # volume, specify `local`.
372
+ #
373
+ # * To create a regional snapshot in the parent Region of the Local
374
+ # Zone, specify `regional` or omit this parameter.
375
+ #
376
+ # Default value: `regional`
365
377
  # @option options [Boolean] :dry_run
366
378
  # Checks whether you have the required permissions for the action,
367
379
  # without actually making the request, and provides an error response.
data/lib/aws-sdk-ec2.rb CHANGED
@@ -78,7 +78,7 @@ module Aws::EC2
78
78
  autoload :VpcPeeringConnection, 'aws-sdk-ec2/vpc_peering_connection'
79
79
  autoload :VpcAddress, 'aws-sdk-ec2/vpc_address'
80
80
 
81
- GEM_VERSION = '1.497.0'
81
+ GEM_VERSION = '1.498.0'
82
82
 
83
83
  end
84
84
 
data/sig/client.rbs CHANGED
@@ -3122,6 +3122,7 @@ module Aws
3122
3122
  def storage_tier: () -> ("archive" | "standard")
3123
3123
  def restore_expiry_time: () -> ::Time
3124
3124
  def sse_type: () -> ("sse-ebs" | "sse-kms" | "none")
3125
+ def availability_zone: () -> ::String
3125
3126
  def transfer_type: () -> ("time-based" | "standard")
3126
3127
  def completion_duration_minutes: () -> ::Integer
3127
3128
  def completion_time: () -> ::Time
@@ -3154,6 +3155,7 @@ module Aws
3154
3155
  ]?
3155
3156
  },
3156
3157
  ],
3158
+ ?location: ("regional" | "local"),
3157
3159
  ?dry_run: bool
3158
3160
  ) -> _CreateSnapshotResponseSuccess
3159
3161
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateSnapshotResponseSuccess
@@ -3183,7 +3185,8 @@ module Aws
3183
3185
  },
3184
3186
  ],
3185
3187
  ?dry_run: bool,
3186
- ?copy_tags_from_source: ("volume")
3188
+ ?copy_tags_from_source: ("volume"),
3189
+ ?location: ("regional" | "local")
3187
3190
  ) -> _CreateSnapshotsResponseSuccess
3188
3191
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateSnapshotsResponseSuccess
3189
3192
 
data/sig/resource.rbs CHANGED
@@ -520,6 +520,7 @@ module Aws
520
520
  ]?
521
521
  },
522
522
  ],
523
+ ?location: ("regional" | "local"),
523
524
  ?dry_run: bool
524
525
  ) -> Snapshot
525
526
  | (?Hash[Symbol, untyped]) -> Snapshot
data/sig/snapshot.rbs CHANGED
@@ -36,6 +36,9 @@ module Aws
36
36
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/EC2/Snapshot.html#sse_type-instance_method
37
37
  def sse_type: () -> ("sse-ebs" | "sse-kms" | "none")
38
38
 
39
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/EC2/Snapshot.html#availability_zone-instance_method
40
+ def availability_zone: () -> ::String
41
+
39
42
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/EC2/Snapshot.html#transfer_type-instance_method
40
43
  def transfer_type: () -> ("time-based" | "standard")
41
44
 
data/sig/types.rbs CHANGED
@@ -2561,6 +2561,7 @@ module Aws::EC2
2561
2561
  attr_accessor outpost_arn: ::String
2562
2562
  attr_accessor volume_id: ::String
2563
2563
  attr_accessor tag_specifications: ::Array[Types::TagSpecification]
2564
+ attr_accessor location: ("regional" | "local")
2564
2565
  attr_accessor dry_run: bool
2565
2566
  SENSITIVE: []
2566
2567
  end
@@ -2572,6 +2573,7 @@ module Aws::EC2
2572
2573
  attr_accessor tag_specifications: ::Array[Types::TagSpecification]
2573
2574
  attr_accessor dry_run: bool
2574
2575
  attr_accessor copy_tags_from_source: ("volume")
2576
+ attr_accessor location: ("regional" | "local")
2575
2577
  SENSITIVE: []
2576
2578
  end
2577
2579
 
@@ -14308,6 +14310,7 @@ module Aws::EC2
14308
14310
  attr_accessor storage_tier: ("archive" | "standard")
14309
14311
  attr_accessor restore_expiry_time: ::Time
14310
14312
  attr_accessor sse_type: ("sse-ebs" | "sse-kms" | "none")
14313
+ attr_accessor availability_zone: ::String
14311
14314
  attr_accessor transfer_type: ("time-based" | "standard")
14312
14315
  attr_accessor completion_duration_minutes: ::Integer
14313
14316
  attr_accessor completion_time: ::Time
@@ -14361,6 +14364,7 @@ module Aws::EC2
14361
14364
  attr_accessor snapshot_id: ::String
14362
14365
  attr_accessor outpost_arn: ::String
14363
14366
  attr_accessor sse_type: ("sse-ebs" | "sse-kms" | "none")
14367
+ attr_accessor availability_zone: ::String
14364
14368
  SENSITIVE: []
14365
14369
  end
14366
14370
 
data/sig/volume.rbs CHANGED
@@ -105,6 +105,7 @@ module Aws
105
105
  ]?
106
106
  },
107
107
  ],
108
+ ?location: ("regional" | "local"),
108
109
  ?dry_run: bool
109
110
  ) -> Snapshot
110
111
  | (?Hash[Symbol, untyped]) -> Snapshot
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-ec2
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.497.0
4
+ version: 1.498.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-12-13 00:00:00.000000000 Z
11
+ date: 2024-12-16 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core