aws-sdk-ec2 1.552.0 → 1.553.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: f45f351689bb4dbd3938d8ca9d365ca5c5a0630a6f404fd12f7ffe230eb20608
4
- data.tar.gz: 15ec74ff92376591e144cebb449436bb57144b28edef8948394e05427aef0505
3
+ metadata.gz: fd58bd43184ab3c974d44f4ba312b4548aa0c69567dd20ecd0f1d8f86f69a4a2
4
+ data.tar.gz: 6bddba743335840d8edfd89afa9498253c2d5bf8c08be0acdb451332c4026627
5
5
  SHA512:
6
- metadata.gz: 6aa1fbd47fa34481e639e08a689878fc2974369d33151e98b9377248d45adb9396f48a6952268a4375126c10c09719f5434266e57c4b8da0cd4a93c62c7a8f42
7
- data.tar.gz: daa0342984a77f275f30659685ee70e57df8d5e9a3c7d2c1ecfb5e63525a00f439ad52c3b7f7ca1b1bba4f983e80d7211d6ab7c3703764a2af8b66cbe342cd29
6
+ metadata.gz: d023d7ae93e64333acb494f2eda40183622e2bb536200f88270963709b109a7831ac13c0f06ec09a8495bd79f3ffbad4d02956d62a71321481d2f2a18933bf8f
7
+ data.tar.gz: 38561daad951034bf6b616ffcbf62131287cbf54996c5bd7fecbd52bcb0c582ba1470ff36fb28b55a56dee00bf1cbc6a6a2f8937b130a0fab023b83d76606ae1
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.553.0 (2025-08-28)
5
+ ------------------
6
+
7
+ * Feature - This release adds support for copying Amazon EBS snapshot and AMIs to and from Local Zones.
8
+
4
9
  1.552.0 (2025-08-26)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.552.0
1
+ 1.553.0
@@ -4842,23 +4842,73 @@ module Aws::EC2
4842
4842
  req.send_request(options)
4843
4843
  end
4844
4844
 
4845
- # Initiates an AMI copy operation. You can copy an AMI from one Region
4846
- # to another, or from a Region to an Outpost. You can't copy an AMI
4847
- # from an Outpost to a Region, from one Outpost to another, or within
4848
- # the same Outpost. To copy an AMI to another partition, see
4849
- # [CreateStoreImageTask][1].
4845
+ # Initiates an AMI copy operation. You must specify the source AMI ID
4846
+ # and both the source and destination locations. The copy operation must
4847
+ # be initiated in the destination Region.
4850
4848
  #
4851
- # When you copy an AMI from one Region to another, the destination
4852
- # Region is the current Region.
4849
+ # **CopyImage supports the following source to destination copies:**
4853
4850
  #
4854
- # When you copy an AMI from a Region to an Outpost, specify the ARN of
4855
- # the Outpost as the destination. Backing snapshots copied to an Outpost
4856
- # are encrypted by default using the default encryption key for the
4857
- # Region or the key that you specify. Outposts do not support
4858
- # unencrypted snapshots.
4851
+ # * Region to Region
4859
4852
  #
4860
- # For information about the prerequisites when copying an AMI, see [Copy
4861
- # an Amazon EC2 AMI][2] in the *Amazon EC2 User Guide*.
4853
+ # * Region to Outpost
4854
+ #
4855
+ # * Parent Region to Local Zone
4856
+ #
4857
+ # * Local Zone to parent Region
4858
+ #
4859
+ # * Between Local Zones with the same parent Region (only supported for
4860
+ # certain Local Zones)
4861
+ #
4862
+ # **CopyImage does not support the following source to destination
4863
+ # copies:**
4864
+ #
4865
+ # * Local Zone to non-parent Regions
4866
+ #
4867
+ # * Between Local Zones with different parent Regions
4868
+ #
4869
+ # * Local Zone to Outpost
4870
+ #
4871
+ # * Outpost to Local Zone
4872
+ #
4873
+ # * Outpost to Region
4874
+ #
4875
+ # * Between Outposts
4876
+ #
4877
+ # * Within same Outpost
4878
+ #
4879
+ # * Cross-partition copies (use [CreateStoreImageTask][1] instead)
4880
+ #
4881
+ # **Destination specification**
4882
+ #
4883
+ # * Region to Region: The destination Region is the Region in which you
4884
+ # initiate the copy operation.
4885
+ #
4886
+ # * Region to Outpost: Specify the destination using the
4887
+ # `DestinationOutpostArn` parameter (the ARN of the Outpost)
4888
+ #
4889
+ # * Region to Local Zone, and Local Zone to Local Zone copies: Specify
4890
+ # the destination using the `DestinationAvailabilityZone` parameter
4891
+ # (the name of the destination Local Zone) or
4892
+ # `DestinationAvailabilityZoneId` parameter (the ID of the destination
4893
+ # Local Zone).
4894
+ #
4895
+ # **Snapshot encryption**
4896
+ #
4897
+ # * Region to Outpost: Backing snapshots copied to an Outpost are
4898
+ # encrypted by default using the default encryption key for the Region
4899
+ # or the key that you specify. Outposts do not support unencrypted
4900
+ # snapshots.
4901
+ #
4902
+ # * Region to Local Zone, and Local Zone to Local Zone: Not all Local
4903
+ # Zones require encrypted snapshots. In Local Zones that require
4904
+ # encrypted snapshots, backing snapshots are automatically encrypted
4905
+ # during copy. In Local Zones where encryption is not required,
4906
+ # snapshots retain their original encryption state (encrypted or
4907
+ # unencrypted) by default.
4908
+ #
4909
+ # For more information, including the required permissions for copying
4910
+ # an AMI, see [Copy an Amazon EC2 AMI][2] in the *Amazon EC2 User
4911
+ # Guide*.
4862
4912
  #
4863
4913
  #
4864
4914
  #
@@ -4878,15 +4928,16 @@ module Aws::EC2
4878
4928
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html
4879
4929
  #
4880
4930
  # @option params [String] :description
4881
- # A description for the new AMI in the destination Region.
4931
+ # A description for the new AMI.
4882
4932
  #
4883
4933
  # @option params [Boolean] :encrypted
4884
- # Specifies whether the destination snapshots of the copied image should
4885
- # be encrypted. You can encrypt a copy of an unencrypted snapshot, but
4886
- # you cannot create an unencrypted copy of an encrypted snapshot. The
4887
- # default KMS key for Amazon EBS is used unless you specify a
4888
- # non-default Key Management Service (KMS) KMS key using `KmsKeyId`. For
4889
- # more information, see [Use encryption with EBS-backed AMIs][1] in the
4934
+ # Specifies whether to encrypt the snapshots of the copied image.
4935
+ #
4936
+ # You can encrypt a copy of an unencrypted snapshot, but you cannot
4937
+ # create an unencrypted copy of an encrypted snapshot. The default KMS
4938
+ # key for Amazon EBS is used unless you specify a non-default Key
4939
+ # Management Service (KMS) KMS key using `KmsKeyId`. For more
4940
+ # information, see [Use encryption with EBS-backed AMIs][1] in the
4890
4941
  # *Amazon EC2 User Guide*.
4891
4942
  #
4892
4943
  #
@@ -4921,7 +4972,7 @@ module Aws::EC2
4921
4972
  # Amazon EBS does not support asymmetric KMS keys.
4922
4973
  #
4923
4974
  # @option params [required, String] :name
4924
- # The name of the new AMI in the destination Region.
4975
+ # The name of the new AMI.
4925
4976
  #
4926
4977
  # @option params [required, String] :source_image_id
4927
4978
  # The ID of the AMI to copy.
@@ -4930,24 +4981,28 @@ module Aws::EC2
4930
4981
  # The name of the Region that contains the AMI to copy.
4931
4982
  #
4932
4983
  # @option params [String] :destination_outpost_arn
4933
- # The Amazon Resource Name (ARN) of the Outpost to which to copy the
4934
- # AMI. Only specify this parameter when copying an AMI from an Amazon
4935
- # Web Services Region to an Outpost. The AMI must be in the Region of
4936
- # the destination Outpost. You cannot copy an AMI from an Outpost to a
4984
+ # The Amazon Resource Name (ARN) of the Outpost for the new AMI.
4985
+ #
4986
+ # Only specify this parameter when copying an AMI from an Amazon Web
4987
+ # Services Region to an Outpost. The AMI must be in the Region of the
4988
+ # destination Outpost. You can't copy an AMI from an Outpost to a
4937
4989
  # Region, from one Outpost to another, or within the same Outpost.
4938
4990
  #
4939
4991
  # For more information, see [Copy AMIs from an Amazon Web Services
4940
4992
  # Region to an Outpost][1] in the *Amazon EBS User Guide*.
4941
4993
  #
4994
+ # Only one of `DestinationAvailabilityZone`,
4995
+ # `DestinationAvailabilityZoneId`, or `DestinationOutpostArn` can be
4996
+ # specified.
4997
+ #
4942
4998
  #
4943
4999
  #
4944
5000
  # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#copy-amis
4945
5001
  #
4946
5002
  # @option params [Boolean] :copy_image_tags
4947
- # Indicates whether to include your user-defined AMI tags when copying
4948
- # the AMI.
5003
+ # Specifies whether to copy your user-defined AMI tags to the new AMI.
4949
5004
  #
4950
- # The following tags will not be copied:
5005
+ # The following tags are not be copied:
4951
5006
  #
4952
5007
  # * System tags (prefixed with `aws:`)
4953
5008
  #
@@ -4985,6 +5040,11 @@ module Aws::EC2
4985
5040
  # If you do not specify a value, the AMI copy operation is completed on
4986
5041
  # a best-effort basis.
4987
5042
  #
5043
+ # <note markdown="1"> This parameter is not supported when copying an AMI to or from a Local
5044
+ # Zone, or to an Outpost.
5045
+ #
5046
+ # </note>
5047
+ #
4988
5048
  # For more information, see [Time-based copies for Amazon EBS snapshots
4989
5049
  # and EBS-backed AMIs][1].
4990
5050
  #
@@ -4992,6 +5052,21 @@ module Aws::EC2
4992
5052
  #
4993
5053
  # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/time-based-copies.html
4994
5054
  #
5055
+ # @option params [String] :destination_availability_zone
5056
+ # The Local Zone for the new AMI (for example, `cn-north-1-pkx-1a`).
5057
+ #
5058
+ # Only one of `DestinationAvailabilityZone`,
5059
+ # `DestinationAvailabilityZoneId`, or `DestinationOutpostArn` can be
5060
+ # specified.
5061
+ #
5062
+ # @option params [String] :destination_availability_zone_id
5063
+ # The ID of the Local Zone for the new AMI (for example,
5064
+ # `cnn1-pkx1-az1`).
5065
+ #
5066
+ # Only one of `DestinationAvailabilityZone`,
5067
+ # `DestinationAvailabilityZoneId`, or `DestinationOutpostArn` can be
5068
+ # specified.
5069
+ #
4995
5070
  # @option params [Boolean] :dry_run
4996
5071
  # Checks whether you have the required permissions for the action,
4997
5072
  # without actually making the request, and provides an error response.
@@ -5043,6 +5118,8 @@ module Aws::EC2
5043
5118
  # },
5044
5119
  # ],
5045
5120
  # snapshot_copy_completion_duration_minutes: 1,
5121
+ # destination_availability_zone: "String",
5122
+ # destination_availability_zone_id: "String",
5046
5123
  # dry_run: false,
5047
5124
  # })
5048
5125
  #
@@ -5059,14 +5136,20 @@ module Aws::EC2
5059
5136
  req.send_request(options)
5060
5137
  end
5061
5138
 
5062
- # Copies a point-in-time snapshot of an EBS volume and stores it in
5063
- # Amazon S3. You can copy a snapshot within the same Region, from one
5064
- # Region to another, or from a Region to an Outpost. You can't copy a
5065
- # snapshot from an Outpost to a Region, from one Outpost to another, or
5066
- # within the same Outpost.
5139
+ # Creates an exact copy of an Amazon EBS snapshot.
5140
+ #
5141
+ # The location of the source snapshot determines whether you can copy it
5142
+ # or not, and the allowed destinations for the snapshot copy.
5143
+ #
5144
+ # * If the source snapshot is in a Region, you can copy it within that
5145
+ # Region, to another Region, to an Outpost associated with that
5146
+ # Region, or to a Local Zone in that Region.
5147
+ #
5148
+ # * If the source snapshot is in a Local Zone, you can copy it within
5149
+ # that Local Zone, to another Local Zone in the same zone group, or to
5150
+ # the parent Region of the Local Zone.
5067
5151
  #
5068
- # You can use the snapshot to create EBS volumes or Amazon Machine
5069
- # Images (AMIs).
5152
+ # * If the source snapshot is on an Outpost, you can't copy it.
5070
5153
  #
5071
5154
  # When copying snapshots to a Region, copies of encrypted EBS snapshots
5072
5155
  # remain encrypted. Copies of unencrypted snapshots remain unencrypted,
@@ -5082,8 +5165,10 @@ module Aws::EC2
5082
5165
  # unencrypted snapshots. For more information, see [Amazon EBS local
5083
5166
  # snapshots on Outposts][1] in the *Amazon EBS User Guide*.
5084
5167
  #
5085
- # Snapshots created by copying another snapshot have an arbitrary volume
5086
- # ID that should not be used for any purpose.
5168
+ # <note markdown="1"> Snapshots copies have an arbitrary source volume ID. Do not use this
5169
+ # volume ID for any purpose.
5170
+ #
5171
+ # </note>
5087
5172
  #
5088
5173
  # For more information, see [Copy an Amazon EBS snapshot][2] in the
5089
5174
  # *Amazon EBS User Guide*.
@@ -5098,11 +5183,11 @@ module Aws::EC2
5098
5183
  #
5099
5184
  # @option params [String] :destination_outpost_arn
5100
5185
  # The Amazon Resource Name (ARN) of the Outpost to which to copy the
5101
- # snapshot. Only specify this parameter when copying a snapshot from an
5102
- # Amazon Web Services Region to an Outpost. The snapshot must be in the
5103
- # Region for the destination Outpost. You cannot copy a snapshot from an
5104
- # Outpost to a Region, from one Outpost to another, or within the same
5105
- # Outpost.
5186
+ # snapshot.
5187
+ #
5188
+ # <note markdown="1"> Only supported when copying a snapshot to an Outpost.
5189
+ #
5190
+ # </note>
5106
5191
  #
5107
5192
  # For more information, see [ Copy snapshots from an Amazon Web Services
5108
5193
  # Region to an Outpost][1] in the *Amazon EBS User Guide*.
@@ -5186,6 +5271,11 @@ module Aws::EC2
5186
5271
  # The tags to apply to the new snapshot.
5187
5272
  #
5188
5273
  # @option params [Integer] :completion_duration_minutes
5274
+ # <note markdown="1"> Not supported when copying snapshots to or from Local Zones or
5275
+ # Outposts.
5276
+ #
5277
+ # </note>
5278
+ #
5189
5279
  # Specify a completion duration, in 15 minute increments, to initiate a
5190
5280
  # time-based snapshot copy. Time-based snapshot copy operations complete
5191
5281
  # within the specified duration. For more information, see [ Time-based
@@ -5198,6 +5288,14 @@ module Aws::EC2
5198
5288
  #
5199
5289
  # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/time-based-copies.html
5200
5290
  #
5291
+ # @option params [String] :destination_availability_zone
5292
+ # The Local Zone, for example, `cn-north-1-pkx-1a` to which to copy the
5293
+ # snapshot.
5294
+ #
5295
+ # <note markdown="1"> Only supported when copying a snapshot to a Local Zone.
5296
+ #
5297
+ # </note>
5298
+ #
5201
5299
  # @option params [Boolean] :dry_run
5202
5300
  # Checks whether you have the required permissions for the action,
5203
5301
  # without actually making the request, and provides an error response.
@@ -5275,6 +5373,7 @@ module Aws::EC2
5275
5373
  # },
5276
5374
  # ],
5277
5375
  # completion_duration_minutes: 1,
5376
+ # destination_availability_zone: "String",
5278
5377
  # dry_run: false,
5279
5378
  # })
5280
5379
  #
@@ -8015,7 +8114,7 @@ module Aws::EC2
8015
8114
  #
8016
8115
  #
8017
8116
  #
8018
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-usage.html
8117
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/your-ec2-ami-usage.html
8019
8118
  #
8020
8119
  # @option params [required, String] :image_id
8021
8120
  # The ID of the image to report on.
@@ -18199,7 +18298,7 @@ module Aws::EC2
18199
18298
  #
18200
18299
  #
18201
18300
  #
18202
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-usage.html
18301
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/your-ec2-ami-usage.html
18203
18302
  #
18204
18303
  # @option params [required, String] :report_id
18205
18304
  # The ID of the report to delete.
@@ -26862,8 +26961,8 @@ module Aws::EC2
26862
26961
  # Describes your Amazon Web Services resources that are referencing the
26863
26962
  # specified images.
26864
26963
  #
26865
- # For more information, see [Identiy your resources referencing selected
26866
- # AMIs][1] in the *Amazon EC2 User Guide*.
26964
+ # For more information, see [Identify your resources referencing
26965
+ # specified AMIs][1] in the *Amazon EC2 User Guide*.
26867
26966
  #
26868
26967
  #
26869
26968
  #
@@ -26967,7 +27066,7 @@ module Aws::EC2
26967
27066
  #
26968
27067
  #
26969
27068
  #
26970
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-usage.html
27069
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/your-ec2-ami-usage.html
26971
27070
  #
26972
27071
  # @option params [Array<String>] :image_ids
26973
27072
  # The IDs of the images for filtering the report entries. If specified,
@@ -27059,7 +27158,7 @@ module Aws::EC2
27059
27158
  #
27060
27159
  #
27061
27160
  #
27062
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-ami-usage.html
27161
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/your-ec2-ami-usage.html
27063
27162
  #
27064
27163
  # @option params [Array<String>] :image_ids
27065
27164
  # The IDs of the images for filtering the reports. If specified, only
@@ -67054,7 +67153,7 @@ module Aws::EC2
67054
67153
  tracer: tracer
67055
67154
  )
67056
67155
  context[:gem_name] = 'aws-sdk-ec2'
67057
- context[:gem_version] = '1.552.0'
67156
+ context[:gem_version] = '1.553.0'
67058
67157
  Seahorse::Client::Request.new(handlers, context)
67059
67158
  end
67060
67159
 
@@ -5111,6 +5111,8 @@ module Aws::EC2
5111
5111
  CopyImageRequest.add_member(:copy_image_tags, Shapes::ShapeRef.new(shape: Boolean, location_name: "CopyImageTags"))
5112
5112
  CopyImageRequest.add_member(:tag_specifications, Shapes::ShapeRef.new(shape: TagSpecificationList, location_name: "TagSpecification"))
5113
5113
  CopyImageRequest.add_member(:snapshot_copy_completion_duration_minutes, Shapes::ShapeRef.new(shape: Long, location_name: "SnapshotCopyCompletionDurationMinutes"))
5114
+ CopyImageRequest.add_member(:destination_availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "DestinationAvailabilityZone"))
5115
+ CopyImageRequest.add_member(:destination_availability_zone_id, Shapes::ShapeRef.new(shape: String, location_name: "DestinationAvailabilityZoneId"))
5114
5116
  CopyImageRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "dryRun"))
5115
5117
  CopyImageRequest.struct_class = Types::CopyImageRequest
5116
5118
 
@@ -5127,6 +5129,7 @@ module Aws::EC2
5127
5129
  CopySnapshotRequest.add_member(:source_snapshot_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "SourceSnapshotId"))
5128
5130
  CopySnapshotRequest.add_member(:tag_specifications, Shapes::ShapeRef.new(shape: TagSpecificationList, location_name: "TagSpecification"))
5129
5131
  CopySnapshotRequest.add_member(:completion_duration_minutes, Shapes::ShapeRef.new(shape: SnapshotCompletionDurationMinutesRequest, location_name: "CompletionDurationMinutes"))
5132
+ CopySnapshotRequest.add_member(:destination_availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "DestinationAvailabilityZone"))
5130
5133
  CopySnapshotRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "dryRun"))
5131
5134
  CopySnapshotRequest.struct_class = Types::CopySnapshotRequest
5132
5135
 
@@ -398,6 +398,7 @@ module Aws::EC2
398
398
  # },
399
399
  # ],
400
400
  # completion_duration_minutes: 1,
401
+ # destination_availability_zone: "String",
401
402
  # dry_run: false,
402
403
  # })
403
404
  # @param [Hash] options ({})
@@ -405,11 +406,11 @@ module Aws::EC2
405
406
  # A description for the EBS snapshot.
406
407
  # @option options [String] :destination_outpost_arn
407
408
  # The Amazon Resource Name (ARN) of the Outpost to which to copy the
408
- # snapshot. Only specify this parameter when copying a snapshot from an
409
- # Amazon Web Services Region to an Outpost. The snapshot must be in the
410
- # Region for the destination Outpost. You cannot copy a snapshot from an
411
- # Outpost to a Region, from one Outpost to another, or within the same
412
- # Outpost.
409
+ # snapshot.
410
+ #
411
+ # <note markdown="1"> Only supported when copying a snapshot to an Outpost.
412
+ #
413
+ # </note>
413
414
  #
414
415
  # For more information, see [ Copy snapshots from an Amazon Web Services
415
416
  # Region to an Outpost][1] in the *Amazon EBS User Guide*.
@@ -483,6 +484,11 @@ module Aws::EC2
483
484
  # @option options [Array<Types::TagSpecification>] :tag_specifications
484
485
  # The tags to apply to the new snapshot.
485
486
  # @option options [Integer] :completion_duration_minutes
487
+ # <note markdown="1"> Not supported when copying snapshots to or from Local Zones or
488
+ # Outposts.
489
+ #
490
+ # </note>
491
+ #
486
492
  # Specify a completion duration, in 15 minute increments, to initiate a
487
493
  # time-based snapshot copy. Time-based snapshot copy operations complete
488
494
  # within the specified duration. For more information, see [ Time-based
@@ -494,6 +500,13 @@ module Aws::EC2
494
500
  #
495
501
  #
496
502
  # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/time-based-copies.html
503
+ # @option options [String] :destination_availability_zone
504
+ # The Local Zone, for example, `cn-north-1-pkx-1a` to which to copy the
505
+ # snapshot.
506
+ #
507
+ # <note markdown="1"> Only supported when copying a snapshot to a Local Zone.
508
+ #
509
+ # </note>
497
510
  # @option options [Boolean] :dry_run
498
511
  # Checks whether you have the required permissions for the action,
499
512
  # without actually making the request, and provides an error response.
@@ -7474,17 +7474,18 @@ module Aws::EC2
7474
7474
  # @return [String]
7475
7475
  #
7476
7476
  # @!attribute [rw] description
7477
- # A description for the new AMI in the destination Region.
7477
+ # A description for the new AMI.
7478
7478
  # @return [String]
7479
7479
  #
7480
7480
  # @!attribute [rw] encrypted
7481
- # Specifies whether the destination snapshots of the copied image
7482
- # should be encrypted. You can encrypt a copy of an unencrypted
7483
- # snapshot, but you cannot create an unencrypted copy of an encrypted
7484
- # snapshot. The default KMS key for Amazon EBS is used unless you
7485
- # specify a non-default Key Management Service (KMS) KMS key using
7486
- # `KmsKeyId`. For more information, see [Use encryption with
7487
- # EBS-backed AMIs][1] in the *Amazon EC2 User Guide*.
7481
+ # Specifies whether to encrypt the snapshots of the copied image.
7482
+ #
7483
+ # You can encrypt a copy of an unencrypted snapshot, but you cannot
7484
+ # create an unencrypted copy of an encrypted snapshot. The default KMS
7485
+ # key for Amazon EBS is used unless you specify a non-default Key
7486
+ # Management Service (KMS) KMS key using `KmsKeyId`. For more
7487
+ # information, see [Use encryption with EBS-backed AMIs][1] in the
7488
+ # *Amazon EC2 User Guide*.
7488
7489
  #
7489
7490
  #
7490
7491
  #
@@ -7520,7 +7521,7 @@ module Aws::EC2
7520
7521
  # @return [String]
7521
7522
  #
7522
7523
  # @!attribute [rw] name
7523
- # The name of the new AMI in the destination Region.
7524
+ # The name of the new AMI.
7524
7525
  # @return [String]
7525
7526
  #
7526
7527
  # @!attribute [rw] source_image_id
@@ -7532,25 +7533,29 @@ module Aws::EC2
7532
7533
  # @return [String]
7533
7534
  #
7534
7535
  # @!attribute [rw] destination_outpost_arn
7535
- # The Amazon Resource Name (ARN) of the Outpost to which to copy the
7536
- # AMI. Only specify this parameter when copying an AMI from an Amazon
7537
- # Web Services Region to an Outpost. The AMI must be in the Region of
7538
- # the destination Outpost. You cannot copy an AMI from an Outpost to a
7536
+ # The Amazon Resource Name (ARN) of the Outpost for the new AMI.
7537
+ #
7538
+ # Only specify this parameter when copying an AMI from an Amazon Web
7539
+ # Services Region to an Outpost. The AMI must be in the Region of the
7540
+ # destination Outpost. You can't copy an AMI from an Outpost to a
7539
7541
  # Region, from one Outpost to another, or within the same Outpost.
7540
7542
  #
7541
7543
  # For more information, see [Copy AMIs from an Amazon Web Services
7542
7544
  # Region to an Outpost][1] in the *Amazon EBS User Guide*.
7543
7545
  #
7546
+ # Only one of `DestinationAvailabilityZone`,
7547
+ # `DestinationAvailabilityZoneId`, or `DestinationOutpostArn` can be
7548
+ # specified.
7549
+ #
7544
7550
  #
7545
7551
  #
7546
7552
  # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/snapshots-outposts.html#copy-amis
7547
7553
  # @return [String]
7548
7554
  #
7549
7555
  # @!attribute [rw] copy_image_tags
7550
- # Indicates whether to include your user-defined AMI tags when copying
7551
- # the AMI.
7556
+ # Specifies whether to copy your user-defined AMI tags to the new AMI.
7552
7557
  #
7553
- # The following tags will not be copied:
7558
+ # The following tags are not be copied:
7554
7559
  #
7555
7560
  # * System tags (prefixed with `aws:`)
7556
7561
  #
@@ -7590,6 +7595,11 @@ module Aws::EC2
7590
7595
  # If you do not specify a value, the AMI copy operation is completed
7591
7596
  # on a best-effort basis.
7592
7597
  #
7598
+ # <note markdown="1"> This parameter is not supported when copying an AMI to or from a
7599
+ # Local Zone, or to an Outpost.
7600
+ #
7601
+ # </note>
7602
+ #
7593
7603
  # For more information, see [Time-based copies for Amazon EBS
7594
7604
  # snapshots and EBS-backed AMIs][1].
7595
7605
  #
@@ -7598,6 +7608,23 @@ module Aws::EC2
7598
7608
  # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/time-based-copies.html
7599
7609
  # @return [Integer]
7600
7610
  #
7611
+ # @!attribute [rw] destination_availability_zone
7612
+ # The Local Zone for the new AMI (for example, `cn-north-1-pkx-1a`).
7613
+ #
7614
+ # Only one of `DestinationAvailabilityZone`,
7615
+ # `DestinationAvailabilityZoneId`, or `DestinationOutpostArn` can be
7616
+ # specified.
7617
+ # @return [String]
7618
+ #
7619
+ # @!attribute [rw] destination_availability_zone_id
7620
+ # The ID of the Local Zone for the new AMI (for example,
7621
+ # `cnn1-pkx1-az1`).
7622
+ #
7623
+ # Only one of `DestinationAvailabilityZone`,
7624
+ # `DestinationAvailabilityZoneId`, or `DestinationOutpostArn` can be
7625
+ # specified.
7626
+ # @return [String]
7627
+ #
7601
7628
  # @!attribute [rw] dry_run
7602
7629
  # Checks whether you have the required permissions for the action,
7603
7630
  # without actually making the request, and provides an error response.
@@ -7619,6 +7646,8 @@ module Aws::EC2
7619
7646
  :copy_image_tags,
7620
7647
  :tag_specifications,
7621
7648
  :snapshot_copy_completion_duration_minutes,
7649
+ :destination_availability_zone,
7650
+ :destination_availability_zone_id,
7622
7651
  :dry_run)
7623
7652
  SENSITIVE = []
7624
7653
  include Aws::Structure
@@ -7644,11 +7673,11 @@ module Aws::EC2
7644
7673
  #
7645
7674
  # @!attribute [rw] destination_outpost_arn
7646
7675
  # The Amazon Resource Name (ARN) of the Outpost to which to copy the
7647
- # snapshot. Only specify this parameter when copying a snapshot from
7648
- # an Amazon Web Services Region to an Outpost. The snapshot must be in
7649
- # the Region for the destination Outpost. You cannot copy a snapshot
7650
- # from an Outpost to a Region, from one Outpost to another, or within
7651
- # the same Outpost.
7676
+ # snapshot.
7677
+ #
7678
+ # <note markdown="1"> Only supported when copying a snapshot to an Outpost.
7679
+ #
7680
+ # </note>
7652
7681
  #
7653
7682
  # For more information, see [ Copy snapshots from an Amazon Web
7654
7683
  # Services Region to an Outpost][1] in the *Amazon EBS User Guide*.
@@ -7744,6 +7773,11 @@ module Aws::EC2
7744
7773
  # @return [Array<Types::TagSpecification>]
7745
7774
  #
7746
7775
  # @!attribute [rw] completion_duration_minutes
7776
+ # <note markdown="1"> Not supported when copying snapshots to or from Local Zones or
7777
+ # Outposts.
7778
+ #
7779
+ # </note>
7780
+ #
7747
7781
  # Specify a completion duration, in 15 minute increments, to initiate
7748
7782
  # a time-based snapshot copy. Time-based snapshot copy operations
7749
7783
  # complete within the specified duration. For more information, see [
@@ -7757,6 +7791,15 @@ module Aws::EC2
7757
7791
  # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/time-based-copies.html
7758
7792
  # @return [Integer]
7759
7793
  #
7794
+ # @!attribute [rw] destination_availability_zone
7795
+ # The Local Zone, for example, `cn-north-1-pkx-1a` to which to copy
7796
+ # the snapshot.
7797
+ #
7798
+ # <note markdown="1"> Only supported when copying a snapshot to a Local Zone.
7799
+ #
7800
+ # </note>
7801
+ # @return [String]
7802
+ #
7760
7803
  # @!attribute [rw] dry_run
7761
7804
  # Checks whether you have the required permissions for the action,
7762
7805
  # without actually making the request, and provides an error response.
@@ -7777,6 +7820,7 @@ module Aws::EC2
7777
7820
  :source_snapshot_id,
7778
7821
  :tag_specifications,
7779
7822
  :completion_duration_minutes,
7823
+ :destination_availability_zone,
7780
7824
  :dry_run)
7781
7825
  SENSITIVE = [:presigned_url]
7782
7826
  include Aws::Structure
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.552.0'
81
+ GEM_VERSION = '1.553.0'
82
82
 
83
83
  end
84
84
 
data/sig/client.rbs CHANGED
@@ -1047,6 +1047,8 @@ module Aws
1047
1047
  },
1048
1048
  ],
1049
1049
  ?snapshot_copy_completion_duration_minutes: ::Integer,
1050
+ ?destination_availability_zone: ::String,
1051
+ ?destination_availability_zone_id: ::String,
1050
1052
  ?dry_run: bool
1051
1053
  ) -> _CopyImageResponseSuccess
1052
1054
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CopyImageResponseSuccess
@@ -1078,6 +1080,7 @@ module Aws
1078
1080
  },
1079
1081
  ],
1080
1082
  ?completion_duration_minutes: ::Integer,
1083
+ ?destination_availability_zone: ::String,
1081
1084
  ?dry_run: bool
1082
1085
  ) -> _CopySnapshotResponseSuccess
1083
1086
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CopySnapshotResponseSuccess
data/sig/snapshot.rbs CHANGED
@@ -122,6 +122,7 @@ module Aws
122
122
  },
123
123
  ],
124
124
  ?completion_duration_minutes: ::Integer,
125
+ ?destination_availability_zone: ::String,
125
126
  ?dry_run: bool
126
127
  ) -> Types::CopySnapshotResult
127
128
  | (?Hash[Symbol, untyped]) -> Types::CopySnapshotResult
data/sig/types.rbs CHANGED
@@ -1772,6 +1772,8 @@ module Aws::EC2
1772
1772
  attr_accessor copy_image_tags: bool
1773
1773
  attr_accessor tag_specifications: ::Array[Types::TagSpecification]
1774
1774
  attr_accessor snapshot_copy_completion_duration_minutes: ::Integer
1775
+ attr_accessor destination_availability_zone: ::String
1776
+ attr_accessor destination_availability_zone_id: ::String
1775
1777
  attr_accessor dry_run: bool
1776
1778
  SENSITIVE: []
1777
1779
  end
@@ -1792,6 +1794,7 @@ module Aws::EC2
1792
1794
  attr_accessor source_snapshot_id: ::String
1793
1795
  attr_accessor tag_specifications: ::Array[Types::TagSpecification]
1794
1796
  attr_accessor completion_duration_minutes: ::Integer
1797
+ attr_accessor destination_availability_zone: ::String
1795
1798
  attr_accessor dry_run: bool
1796
1799
  SENSITIVE: [:presigned_url]
1797
1800
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-ec2
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.552.0
4
+ version: 1.553.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services