aws-sdk-s3 1.212.0 → 1.213.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.
@@ -721,10 +721,10 @@ module Aws::S3
721
721
  # Confirms that the requester knows that they will be charged for the
722
722
  # request. Bucket owners need not specify this parameter in their
723
723
  # requests. If either the source or destination S3 bucket has Requester
724
- # Pays enabled, the requester will pay for corresponding charges to copy
725
- # the object. For information about downloading objects from Requester
726
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
727
- # in the *Amazon S3 User Guide*.
724
+ # Pays enabled, the requester will pay for the corresponding charges.
725
+ # For information about downloading objects from Requester Pays buckets,
726
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
727
+ # S3 User Guide*.
728
728
  #
729
729
  # <note markdown="1"> This functionality is not supported for directory buckets.
730
730
  #
@@ -1079,10 +1079,10 @@ module Aws::S3
1079
1079
  # Confirms that the requester knows that they will be charged for the
1080
1080
  # request. Bucket owners need not specify this parameter in their
1081
1081
  # requests. If either the source or destination S3 bucket has Requester
1082
- # Pays enabled, the requester will pay for corresponding charges to copy
1083
- # the object. For information about downloading objects from Requester
1084
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
1085
- # in the *Amazon S3 User Guide*.
1082
+ # Pays enabled, the requester will pay for the corresponding charges.
1083
+ # For information about downloading objects from Requester Pays buckets,
1084
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
1085
+ # S3 User Guide*.
1086
1086
  #
1087
1087
  # <note markdown="1"> This functionality is not supported for directory buckets.
1088
1088
  #
@@ -2209,10 +2209,10 @@ module Aws::S3
2209
2209
  # Confirms that the requester knows that they will be charged for the
2210
2210
  # request. Bucket owners need not specify this parameter in their
2211
2211
  # requests. If either the source or destination S3 bucket has Requester
2212
- # Pays enabled, the requester will pay for corresponding charges to copy
2213
- # the object. For information about downloading objects from Requester
2214
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
2215
- # in the *Amazon S3 User Guide*.
2212
+ # Pays enabled, the requester will pay for the corresponding charges.
2213
+ # For information about downloading objects from Requester Pays buckets,
2214
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
2215
+ # S3 User Guide*.
2216
2216
  #
2217
2217
  # <note markdown="1"> This functionality is not supported for directory buckets.
2218
2218
  #
@@ -3810,10 +3810,10 @@ module Aws::S3
3810
3810
  # Confirms that the requester knows that they will be charged for the
3811
3811
  # request. Bucket owners need not specify this parameter in their
3812
3812
  # requests. If either the source or destination S3 bucket has Requester
3813
- # Pays enabled, the requester will pay for corresponding charges to copy
3814
- # the object. For information about downloading objects from Requester
3815
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
3816
- # in the *Amazon S3 User Guide*.
3813
+ # Pays enabled, the requester will pay for the corresponding charges.
3814
+ # For information about downloading objects from Requester Pays buckets,
3815
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
3816
+ # S3 User Guide*.
3817
3817
  #
3818
3818
  # <note markdown="1"> This functionality is not supported for directory buckets.
3819
3819
  #
@@ -5734,10 +5734,10 @@ module Aws::S3
5734
5734
  # Confirms that the requester knows that they will be charged for the
5735
5735
  # request. Bucket owners need not specify this parameter in their
5736
5736
  # requests. If either the source or destination S3 bucket has Requester
5737
- # Pays enabled, the requester will pay for corresponding charges to copy
5738
- # the object. For information about downloading objects from Requester
5739
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
5740
- # in the *Amazon S3 User Guide*.
5737
+ # Pays enabled, the requester will pay for the corresponding charges.
5738
+ # For information about downloading objects from Requester Pays buckets,
5739
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
5740
+ # S3 User Guide*.
5741
5741
  #
5742
5742
  # <note markdown="1"> This functionality is not supported for directory buckets.
5743
5743
  #
@@ -6196,10 +6196,10 @@ module Aws::S3
6196
6196
  # Confirms that the requester knows that they will be charged for the
6197
6197
  # request. Bucket owners need not specify this parameter in their
6198
6198
  # requests. If either the source or destination S3 bucket has Requester
6199
- # Pays enabled, the requester will pay for corresponding charges to copy
6200
- # the object. For information about downloading objects from Requester
6201
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
6202
- # in the *Amazon S3 User Guide*.
6199
+ # Pays enabled, the requester will pay for the corresponding charges.
6200
+ # For information about downloading objects from Requester Pays buckets,
6201
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
6202
+ # S3 User Guide*.
6203
6203
  #
6204
6204
  # <note markdown="1"> This functionality is not supported for directory buckets.
6205
6205
  #
@@ -6548,10 +6548,10 @@ module Aws::S3
6548
6548
  # Confirms that the requester knows that they will be charged for the
6549
6549
  # request. Bucket owners need not specify this parameter in their
6550
6550
  # requests. If either the source or destination S3 bucket has Requester
6551
- # Pays enabled, the requester will pay for corresponding charges to copy
6552
- # the object. For information about downloading objects from Requester
6553
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
6554
- # in the *Amazon S3 User Guide*.
6551
+ # Pays enabled, the requester will pay for the corresponding charges.
6552
+ # For information about downloading objects from Requester Pays buckets,
6553
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
6554
+ # S3 User Guide*.
6555
6555
  #
6556
6556
  # <note markdown="1"> This functionality is not supported for directory buckets.
6557
6557
  #
@@ -9454,10 +9454,10 @@ module Aws::S3
9454
9454
  # Confirms that the requester knows that they will be charged for the
9455
9455
  # request. Bucket owners need not specify this parameter in their
9456
9456
  # requests. If either the source or destination S3 bucket has Requester
9457
- # Pays enabled, the requester will pay for corresponding charges to copy
9458
- # the object. For information about downloading objects from Requester
9459
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
9460
- # in the *Amazon S3 User Guide*.
9457
+ # Pays enabled, the requester will pay for the corresponding charges.
9458
+ # For information about downloading objects from Requester Pays buckets,
9459
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
9460
+ # S3 User Guide*.
9461
9461
  #
9462
9462
  # <note markdown="1"> This functionality is not supported for directory buckets.
9463
9463
  #
@@ -9759,10 +9759,10 @@ module Aws::S3
9759
9759
  # Confirms that the requester knows that they will be charged for the
9760
9760
  # request. Bucket owners need not specify this parameter in their
9761
9761
  # requests. If either the source or destination S3 bucket has Requester
9762
- # Pays enabled, the requester will pay for corresponding charges to copy
9763
- # the object. For information about downloading objects from Requester
9764
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
9765
- # in the *Amazon S3 User Guide*.
9762
+ # Pays enabled, the requester will pay for the corresponding charges.
9763
+ # For information about downloading objects from Requester Pays buckets,
9764
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
9765
+ # S3 User Guide*.
9766
9766
  #
9767
9767
  # <note markdown="1"> This functionality is not supported for directory buckets.
9768
9768
  #
@@ -10170,10 +10170,10 @@ module Aws::S3
10170
10170
  # Confirms that the requester knows that they will be charged for the
10171
10171
  # request. Bucket owners need not specify this parameter in their
10172
10172
  # requests. If either the source or destination S3 bucket has Requester
10173
- # Pays enabled, the requester will pay for corresponding charges to copy
10174
- # the object. For information about downloading objects from Requester
10175
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
10176
- # in the *Amazon S3 User Guide*.
10173
+ # Pays enabled, the requester will pay for the corresponding charges.
10174
+ # For information about downloading objects from Requester Pays buckets,
10175
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
10176
+ # S3 User Guide*.
10177
10177
  #
10178
10178
  # <note markdown="1"> This functionality is not supported for directory buckets.
10179
10179
  #
@@ -10315,10 +10315,10 @@ module Aws::S3
10315
10315
  # Confirms that the requester knows that they will be charged for the
10316
10316
  # request. Bucket owners need not specify this parameter in their
10317
10317
  # requests. If either the source or destination S3 bucket has Requester
10318
- # Pays enabled, the requester will pay for corresponding charges to copy
10319
- # the object. For information about downloading objects from Requester
10320
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
10321
- # in the *Amazon S3 User Guide*.
10318
+ # Pays enabled, the requester will pay for the corresponding charges.
10319
+ # For information about downloading objects from Requester Pays buckets,
10320
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
10321
+ # S3 User Guide*.
10322
10322
  #
10323
10323
  # <note markdown="1"> This functionality is not supported for directory buckets.
10324
10324
  #
@@ -10493,10 +10493,10 @@ module Aws::S3
10493
10493
  # Confirms that the requester knows that they will be charged for the
10494
10494
  # request. Bucket owners need not specify this parameter in their
10495
10495
  # requests. If either the source or destination S3 bucket has Requester
10496
- # Pays enabled, the requester will pay for corresponding charges to copy
10497
- # the object. For information about downloading objects from Requester
10498
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
10499
- # in the *Amazon S3 User Guide*.
10496
+ # Pays enabled, the requester will pay for the corresponding charges.
10497
+ # For information about downloading objects from Requester Pays buckets,
10498
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
10499
+ # S3 User Guide*.
10500
10500
  #
10501
10501
  # <note markdown="1"> This functionality is not supported for directory buckets.
10502
10502
  #
@@ -10624,10 +10624,10 @@ module Aws::S3
10624
10624
  # Confirms that the requester knows that they will be charged for the
10625
10625
  # request. Bucket owners need not specify this parameter in their
10626
10626
  # requests. If either the source or destination S3 bucket has Requester
10627
- # Pays enabled, the requester will pay for corresponding charges to copy
10628
- # the object. For information about downloading objects from Requester
10629
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
10630
- # in the *Amazon S3 User Guide*.
10627
+ # Pays enabled, the requester will pay for the corresponding charges.
10628
+ # For information about downloading objects from Requester Pays buckets,
10629
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
10630
+ # S3 User Guide*.
10631
10631
  #
10632
10632
  # <note markdown="1"> This functionality is not supported for directory buckets.
10633
10633
  #
@@ -10759,10 +10759,10 @@ module Aws::S3
10759
10759
  # Confirms that the requester knows that they will be charged for the
10760
10760
  # request. Bucket owners need not specify this parameter in their
10761
10761
  # requests. If either the source or destination S3 bucket has Requester
10762
- # Pays enabled, the requester will pay for corresponding charges to copy
10763
- # the object. For information about downloading objects from Requester
10764
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
10765
- # in the *Amazon S3 User Guide*.
10762
+ # Pays enabled, the requester will pay for the corresponding charges.
10763
+ # For information about downloading objects from Requester Pays buckets,
10764
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
10765
+ # S3 User Guide*.
10766
10766
  #
10767
10767
  # <note markdown="1"> This functionality is not supported for directory buckets.
10768
10768
  #
@@ -11446,10 +11446,10 @@ module Aws::S3
11446
11446
  # Confirms that the requester knows that they will be charged for the
11447
11447
  # request. Bucket owners need not specify this parameter in their
11448
11448
  # requests. If either the source or destination S3 bucket has Requester
11449
- # Pays enabled, the requester will pay for corresponding charges to copy
11450
- # the object. For information about downloading objects from Requester
11451
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
11452
- # in the *Amazon S3 User Guide*.
11449
+ # Pays enabled, the requester will pay for the corresponding charges.
11450
+ # For information about downloading objects from Requester Pays buckets,
11451
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
11452
+ # S3 User Guide*.
11453
11453
  #
11454
11454
  # <note markdown="1"> This functionality is not supported for directory buckets.
11455
11455
  #
@@ -12567,10 +12567,10 @@ module Aws::S3
12567
12567
  # Confirms that the requester knows that they will be charged for the
12568
12568
  # request. Bucket owners need not specify this parameter in their
12569
12569
  # requests. If either the source or destination S3 bucket has Requester
12570
- # Pays enabled, the requester will pay for corresponding charges to copy
12571
- # the object. For information about downloading objects from Requester
12572
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
12573
- # in the *Amazon S3 User Guide*.
12570
+ # Pays enabled, the requester will pay for the corresponding charges.
12571
+ # For information about downloading objects from Requester Pays buckets,
12572
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
12573
+ # S3 User Guide*.
12574
12574
  #
12575
12575
  # <note markdown="1"> This functionality is not supported for directory buckets.
12576
12576
  #
@@ -12851,10 +12851,10 @@ module Aws::S3
12851
12851
  # Confirms that the requester knows that they will be charged for the
12852
12852
  # request. Bucket owners need not specify this parameter in their
12853
12853
  # requests. If either the source or destination S3 bucket has Requester
12854
- # Pays enabled, the requester will pay for corresponding charges to copy
12855
- # the object. For information about downloading objects from Requester
12856
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
12857
- # in the *Amazon S3 User Guide*.
12854
+ # Pays enabled, the requester will pay for the corresponding charges.
12855
+ # For information about downloading objects from Requester Pays buckets,
12856
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
12857
+ # S3 User Guide*.
12858
12858
  #
12859
12859
  # <note markdown="1"> This functionality is not supported for directory buckets.
12860
12860
  #
@@ -13748,10 +13748,10 @@ module Aws::S3
13748
13748
  # Confirms that the requester knows that they will be charged for the
13749
13749
  # request. Bucket owners need not specify this parameter in their
13750
13750
  # requests. If either the source or destination S3 bucket has Requester
13751
- # Pays enabled, the requester will pay for corresponding charges to copy
13752
- # the object. For information about downloading objects from Requester
13753
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
13754
- # in the *Amazon S3 User Guide*.
13751
+ # Pays enabled, the requester will pay for the corresponding charges.
13752
+ # For information about downloading objects from Requester Pays buckets,
13753
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
13754
+ # S3 User Guide*.
13755
13755
  #
13756
13756
  # <note markdown="1"> This functionality is not supported for directory buckets.
13757
13757
  #
@@ -15448,8 +15448,6 @@ module Aws::S3
15448
15448
  # </note>
15449
15449
  #
15450
15450
  # Rules
15451
- # Permissions
15452
- # HTTP Host header syntax
15453
15451
  #
15454
15452
  # : You specify the lifecycle configuration in your request body. The
15455
15453
  # lifecycle configuration is specified as XML consisting of one or
@@ -15488,6 +15486,8 @@ module Aws::S3
15488
15486
  #
15489
15487
  # For more information, see [Object Lifecycle Management][3] and
15490
15488
  # [Lifecycle Configuration Elements][4].
15489
+ #
15490
+ # Permissions
15491
15491
  # : * **General purpose bucket permissions** - By default, all Amazon S3
15492
15492
  # resources are private, including buckets, objects, and related
15493
15493
  # subresources (for example, lifecycle configuration and website
@@ -15537,6 +15537,8 @@ module Aws::S3
15537
15537
  #
15538
15538
  # </note>
15539
15539
  #
15540
+ # HTTP Host header syntax
15541
+ #
15540
15542
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
15541
15543
  # `s3express-control.region.amazonaws.com`.
15542
15544
  #
@@ -17597,6 +17599,20 @@ module Aws::S3
17597
17599
  #
17598
17600
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
17599
17601
  # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
17602
+ # ^
17603
+ #
17604
+ # Errors
17605
+ # : * You might receive an `InvalidRequest` error for several reasons.
17606
+ # Depending on the reason for the error, you might receive one of
17607
+ # the following messages:
17608
+ #
17609
+ # * Cannot specify both a write offset value and user-defined object
17610
+ # metadata for existing objects.
17611
+ #
17612
+ # * Checksum Type mismatch occurred, expected checksum Type: sha1,
17613
+ # actual checksum Type: crc32c.
17614
+ #
17615
+ # * Request body cannot be empty when 'write offset' is specified.
17600
17616
  #
17601
17617
  # For more information about related Amazon S3 APIs, see the following:
17602
17618
  #
@@ -18220,10 +18236,10 @@ module Aws::S3
18220
18236
  # Confirms that the requester knows that they will be charged for the
18221
18237
  # request. Bucket owners need not specify this parameter in their
18222
18238
  # requests. If either the source or destination S3 bucket has Requester
18223
- # Pays enabled, the requester will pay for corresponding charges to copy
18224
- # the object. For information about downloading objects from Requester
18225
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
18226
- # in the *Amazon S3 User Guide*.
18239
+ # Pays enabled, the requester will pay for the corresponding charges.
18240
+ # For information about downloading objects from Requester Pays buckets,
18241
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
18242
+ # S3 User Guide*.
18227
18243
  #
18228
18244
  # <note markdown="1"> This functionality is not supported for directory buckets.
18229
18245
  #
@@ -18802,10 +18818,10 @@ module Aws::S3
18802
18818
  # Confirms that the requester knows that they will be charged for the
18803
18819
  # request. Bucket owners need not specify this parameter in their
18804
18820
  # requests. If either the source or destination S3 bucket has Requester
18805
- # Pays enabled, the requester will pay for corresponding charges to copy
18806
- # the object. For information about downloading objects from Requester
18807
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
18808
- # in the *Amazon S3 User Guide*.
18821
+ # Pays enabled, the requester will pay for the corresponding charges.
18822
+ # For information about downloading objects from Requester Pays buckets,
18823
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
18824
+ # S3 User Guide*.
18809
18825
  #
18810
18826
  # <note markdown="1"> This functionality is not supported for directory buckets.
18811
18827
  #
@@ -18948,10 +18964,10 @@ module Aws::S3
18948
18964
  # Confirms that the requester knows that they will be charged for the
18949
18965
  # request. Bucket owners need not specify this parameter in their
18950
18966
  # requests. If either the source or destination S3 bucket has Requester
18951
- # Pays enabled, the requester will pay for corresponding charges to copy
18952
- # the object. For information about downloading objects from Requester
18953
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
18954
- # in the *Amazon S3 User Guide*.
18967
+ # Pays enabled, the requester will pay for the corresponding charges.
18968
+ # For information about downloading objects from Requester Pays buckets,
18969
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
18970
+ # S3 User Guide*.
18955
18971
  #
18956
18972
  # <note markdown="1"> This functionality is not supported for directory buckets.
18957
18973
  #
@@ -19065,10 +19081,10 @@ module Aws::S3
19065
19081
  # Confirms that the requester knows that they will be charged for the
19066
19082
  # request. Bucket owners need not specify this parameter in their
19067
19083
  # requests. If either the source or destination S3 bucket has Requester
19068
- # Pays enabled, the requester will pay for corresponding charges to copy
19069
- # the object. For information about downloading objects from Requester
19070
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
19071
- # in the *Amazon S3 User Guide*.
19084
+ # Pays enabled, the requester will pay for the corresponding charges.
19085
+ # For information about downloading objects from Requester Pays buckets,
19086
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
19087
+ # S3 User Guide*.
19072
19088
  #
19073
19089
  # <note markdown="1"> This functionality is not supported for directory buckets.
19074
19090
  #
@@ -19199,10 +19215,10 @@ module Aws::S3
19199
19215
  # Confirms that the requester knows that they will be charged for the
19200
19216
  # request. Bucket owners need not specify this parameter in their
19201
19217
  # requests. If either the source or destination S3 bucket has Requester
19202
- # Pays enabled, the requester will pay for corresponding charges to copy
19203
- # the object. For information about downloading objects from Requester
19204
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
19205
- # in the *Amazon S3 User Guide*.
19218
+ # Pays enabled, the requester will pay for the corresponding charges.
19219
+ # For information about downloading objects from Requester Pays buckets,
19220
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
19221
+ # S3 User Guide*.
19206
19222
  #
19207
19223
  # <note markdown="1"> This functionality is not supported for directory buckets.
19208
19224
  #
@@ -19988,10 +20004,10 @@ module Aws::S3
19988
20004
  # Confirms that the requester knows that they will be charged for the
19989
20005
  # request. Bucket owners need not specify this parameter in their
19990
20006
  # requests. If either the source or destination S3 bucket has Requester
19991
- # Pays enabled, the requester will pay for corresponding charges to copy
19992
- # the object. For information about downloading objects from Requester
19993
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
19994
- # in the *Amazon S3 User Guide*.
20007
+ # Pays enabled, the requester will pay for the corresponding charges.
20008
+ # For information about downloading objects from Requester Pays buckets,
20009
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
20010
+ # S3 User Guide*.
19995
20011
  #
19996
20012
  # <note markdown="1"> This functionality is not supported for directory buckets.
19997
20013
  #
@@ -20762,6 +20778,260 @@ module Aws::S3
20762
20778
  req.send_request(options)
20763
20779
  end
20764
20780
 
20781
+ # <note markdown="1"> This operation is not supported for directory buckets or Amazon S3 on
20782
+ # Outposts buckets.
20783
+ #
20784
+ # </note>
20785
+ #
20786
+ # Updates the server-side encryption type of an existing encrypted
20787
+ # object in a general purpose bucket. You can use the
20788
+ # `UpdateObjectEncryption` operation to change encrypted objects from
20789
+ # server-side encryption with Amazon S3 managed keys (SSE-S3) to
20790
+ # server-side encryption with Key Management Service (KMS) keys
20791
+ # (SSE-KMS), or to apply S3 Bucket Keys. You can also use the
20792
+ # `UpdateObjectEncryption` operation to change the customer-managed KMS
20793
+ # key used to encrypt your data so that you can comply with custom
20794
+ # key-rotation standards.
20795
+ #
20796
+ # Using the `UpdateObjectEncryption` operation, you can atomically
20797
+ # update the server-side encryption type of an existing object in a
20798
+ # general purpose bucket without any data movement. The
20799
+ # `UpdateObjectEncryption` operation uses envelope encryption to
20800
+ # re-encrypt the data key used to encrypt and decrypt your object with
20801
+ # your newly specified server-side encryption type. In other words, when
20802
+ # you use the `UpdateObjectEncryption` operation, your data isn't
20803
+ # copied, archived objects in the S3 Glacier Flexible Retrieval and S3
20804
+ # Glacier Deep Archive storage classes aren't restored, and objects in
20805
+ # the S3 Intelligent-Tiering storage class aren't moved between tiers.
20806
+ # Additionally, the `UpdateObjectEncryption` operation preserves all
20807
+ # object metadata properties, including the storage class, creation
20808
+ # date, last modified date, ETag, and checksum properties. For more
20809
+ # information, see [ Updating server-side encryption for existing
20810
+ # objects][1] in the *Amazon S3 User Guide*.
20811
+ #
20812
+ # By default, all `UpdateObjectEncryption` requests that specify a
20813
+ # customer-managed KMS key are restricted to KMS keys that are owned by
20814
+ # the bucket owner's Amazon Web Services account. If you're using
20815
+ # Organizations, you can request the ability to use KMS keys owned by
20816
+ # other member accounts within your organization by contacting Amazon
20817
+ # Web Services Support.
20818
+ #
20819
+ # <note markdown="1"> Source objects that are unencrypted, or encrypted with either
20820
+ # dual-layer server-side encryption with KMS keys (DSSE-KMS) or
20821
+ # server-side encryption with customer-provided keys (SSE-C) aren't
20822
+ # supported by this operation. Additionally, you cannot specify SSE-S3
20823
+ # encryption as the requested new encryption type
20824
+ # `UpdateObjectEncryption` request.
20825
+ #
20826
+ # </note>
20827
+ #
20828
+ # Permissions
20829
+ # : * To use the `UpdateObjectEncryption` operation, you must have the
20830
+ # following permissions:
20831
+ #
20832
+ # * `s3:PutObject`
20833
+ #
20834
+ # * `s3:UpdateObjectEncryption`
20835
+ #
20836
+ # * `kms:Encrypt`
20837
+ #
20838
+ # * `kms:Decrypt`
20839
+ #
20840
+ # * `kms:GenerateDataKey`
20841
+ #
20842
+ # * `kms:ReEncrypt*`
20843
+ # * If you're using Organizations, to use this operation with
20844
+ # customer-managed KMS keys from other Amazon Web Services accounts
20845
+ # within your organization, you must have the
20846
+ # `organizations:DescribeAccount` permission.
20847
+ # ^
20848
+ #
20849
+ # Errors
20850
+ # : * You might receive an `InvalidRequest` error for several reasons.
20851
+ # Depending on the reason for the error, you might receive one of
20852
+ # the following messages:
20853
+ #
20854
+ # * The `UpdateObjectEncryption` operation doesn't supported
20855
+ # unencrypted source objects. Only source objects encrypted with
20856
+ # SSE-S3 or SSE-KMS are supported.
20857
+ #
20858
+ # * The `UpdateObjectEncryption` operation doesn't support source
20859
+ # objects with the encryption type DSSE-KMS or SSE-C. Only source
20860
+ # objects encrypted with SSE-S3 or SSE-KMS are supported.
20861
+ #
20862
+ # * The `UpdateObjectEncryption` operation doesn't support updating
20863
+ # the encryption type to DSSE-KMS or SSE-C. Modify the request to
20864
+ # specify SSE-KMS for the updated encryption type, and then try
20865
+ # again.
20866
+ #
20867
+ # * Requests that modify an object encryption configuration require
20868
+ # Amazon Web Services Signature Version 4. Modify the request to
20869
+ # use Amazon Web Services Signature Version 4, and then try again.
20870
+ #
20871
+ # * Requests that modify an object encryption configuration require
20872
+ # a valid new encryption type. Valid values are `SSEKMS`. Modify
20873
+ # the request to specify SSE-KMS for the updated encryption type,
20874
+ # and then try again.
20875
+ #
20876
+ # * Requests that modify an object's encryption type to SSE-KMS
20877
+ # require an Amazon Web Services KMS key Amazon Resource Name
20878
+ # (ARN). Modify the request to specify a KMS key ARN, and then try
20879
+ # again.
20880
+ #
20881
+ # * Requests that modify an object's encryption type to SSE-KMS
20882
+ # require a valid Amazon Web Services KMS key Amazon Resource Name
20883
+ # (ARN). Confirm that you have a correctly formatted KMS key ARN
20884
+ # in your request, and then try again.
20885
+ #
20886
+ # * The `BucketKeyEnabled` value isn't valid. Valid values are
20887
+ # `true` or `false`. Modify the request to specify a valid value,
20888
+ # and then try again.
20889
+ # * You might receive an `AccessDenied` error for several reasons.
20890
+ # Depending on the reason for the error, you might receive one of
20891
+ # the following messages:
20892
+ #
20893
+ # * The Amazon Web Services KMS key in the request must be owned by
20894
+ # the same account as the bucket. Modify the request to specify a
20895
+ # KMS key from the same account, and then try again.
20896
+ #
20897
+ # * The bucket owner's account was approved to make
20898
+ # `UpdateObjectEncryption` requests that use any Amazon Web
20899
+ # Services KMS key in their organization, but the bucket owner's
20900
+ # account isn't part of an organization in Organizations. Make
20901
+ # sure that the bucket owner's account and the specified KMS key
20902
+ # belong to the same organization, and then try again.
20903
+ #
20904
+ # * The specified Amazon Web Services KMS key must be from the same
20905
+ # organization in Organizations as the bucket. Specify a KMS key
20906
+ # that belongs to the same organization as the bucket, and then
20907
+ # try again.
20908
+ #
20909
+ # * The encryption type for the specified object can’t be updated
20910
+ # because that object is protected by S3 Object Lock. If the
20911
+ # object has a governance-mode retention period or a legal hold,
20912
+ # you must first remove the Object Lock status on the object
20913
+ # before you issue your `UpdateObjectEncryption` request. You
20914
+ # can't use the `UpdateObjectEncryption` operation with objects
20915
+ # that have an Object Lock compliance mode retention period
20916
+ # applied to them.
20917
+ #
20918
+ #
20919
+ #
20920
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/update-sse-encryption.html
20921
+ #
20922
+ # @option params [required, String] :bucket
20923
+ # The name of the general purpose bucket that contains the specified
20924
+ # object key name.
20925
+ #
20926
+ # When you use this operation with an access point attached to a general
20927
+ # purpose bucket, you must either provide the alias of the access point
20928
+ # in place of the bucket name or you must specify the access point
20929
+ # Amazon Resource Name (ARN). When using the access point ARN, you must
20930
+ # direct requests to the access point hostname. The access point
20931
+ # hostname takes the form `
20932
+ # AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com`. When
20933
+ # using this operation with an access point through the Amazon Web
20934
+ # Services SDKs, you provide the access point ARN in place of the bucket
20935
+ # name. For more information about access point ARNs, see [ Referencing
20936
+ # access points][1] in the *Amazon S3 User Guide*.
20937
+ #
20938
+ #
20939
+ #
20940
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-naming.html
20941
+ #
20942
+ # @option params [required, String] :key
20943
+ # The key name of the object that you want to update the server-side
20944
+ # encryption type for.
20945
+ #
20946
+ # @option params [String] :version_id
20947
+ # The version ID of the object that you want to update the server-side
20948
+ # encryption type for.
20949
+ #
20950
+ # @option params [required, Types::ObjectEncryption] :object_encryption
20951
+ # The updated server-side encryption type for this object. The
20952
+ # `UpdateObjectEncryption` operation supports the SSE-S3 and SSE-KMS
20953
+ # encryption types.
20954
+ #
20955
+ # Valid Values: `SSES3` \| `SSEKMS`
20956
+ #
20957
+ # @option params [String] :request_payer
20958
+ # Confirms that the requester knows that they will be charged for the
20959
+ # request. Bucket owners need not specify this parameter in their
20960
+ # requests. If either the source or destination S3 bucket has Requester
20961
+ # Pays enabled, the requester will pay for the corresponding charges.
20962
+ # For information about downloading objects from Requester Pays buckets,
20963
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
20964
+ # S3 User Guide*.
20965
+ #
20966
+ # <note markdown="1"> This functionality is not supported for directory buckets.
20967
+ #
20968
+ # </note>
20969
+ #
20970
+ #
20971
+ #
20972
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
20973
+ #
20974
+ # @option params [String] :expected_bucket_owner
20975
+ # The account ID of the expected bucket owner. If the account ID that
20976
+ # you provide doesn't match the actual owner of the bucket, the request
20977
+ # fails with the HTTP status code `403 Forbidden` (access denied).
20978
+ #
20979
+ # @option params [String] :content_md5
20980
+ # The MD5 hash for the request body. For requests made using the Amazon
20981
+ # Web Services Command Line Interface (CLI) or Amazon Web Services SDKs,
20982
+ # this field is calculated automatically.
20983
+ #
20984
+ # @option params [String] :checksum_algorithm
20985
+ # Indicates the algorithm used to create the checksum for the object
20986
+ # when you use an Amazon Web Services SDK. This header doesn't provide
20987
+ # any additional functionality if you don't use the SDK. When you send
20988
+ # this header, there must be a corresponding `x-amz-checksum` or
20989
+ # `x-amz-trailer` header sent. Otherwise, Amazon S3 fails the request
20990
+ # with the HTTP status code `400 Bad Request`. For more information, see
20991
+ # [ Checking object integrity ][1] in the *Amazon S3 User Guide*.
20992
+ #
20993
+ # If you provide an individual checksum, Amazon S3 ignores any provided
20994
+ # `ChecksumAlgorithm` parameter.
20995
+ #
20996
+ #
20997
+ #
20998
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
20999
+ #
21000
+ # @return [Types::UpdateObjectEncryptionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
21001
+ #
21002
+ # * {Types::UpdateObjectEncryptionResponse#request_charged #request_charged} => String
21003
+ #
21004
+ # @example Request syntax with placeholder values
21005
+ #
21006
+ # resp = client.update_object_encryption({
21007
+ # bucket: "BucketName", # required
21008
+ # key: "ObjectKey", # required
21009
+ # version_id: "ObjectVersionId",
21010
+ # object_encryption: { # required
21011
+ # ssekms: {
21012
+ # kms_key_arn: "NonEmptyKmsKeyArnString", # required
21013
+ # bucket_key_enabled: false,
21014
+ # },
21015
+ # },
21016
+ # request_payer: "requester", # accepts requester
21017
+ # expected_bucket_owner: "AccountId",
21018
+ # content_md5: "ContentMD5",
21019
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
21020
+ # })
21021
+ #
21022
+ # @example Response structure
21023
+ #
21024
+ # resp.request_charged #=> String, one of "requester"
21025
+ #
21026
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UpdateObjectEncryption AWS API Documentation
21027
+ #
21028
+ # @overload update_object_encryption(params = {})
21029
+ # @param [Hash] params ({})
21030
+ def update_object_encryption(params = {}, options = {})
21031
+ req = build_request(:update_object_encryption, params)
21032
+ req.send_request(options)
21033
+ end
21034
+
20765
21035
  # Uploads a part in a multipart upload.
20766
21036
  #
20767
21037
  # <note markdown="1"> In this operation, you provide new data as a part of an object in your
@@ -21148,10 +21418,10 @@ module Aws::S3
21148
21418
  # Confirms that the requester knows that they will be charged for the
21149
21419
  # request. Bucket owners need not specify this parameter in their
21150
21420
  # requests. If either the source or destination S3 bucket has Requester
21151
- # Pays enabled, the requester will pay for corresponding charges to copy
21152
- # the object. For information about downloading objects from Requester
21153
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
21154
- # in the *Amazon S3 User Guide*.
21421
+ # Pays enabled, the requester will pay for the corresponding charges.
21422
+ # For information about downloading objects from Requester Pays buckets,
21423
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
21424
+ # S3 User Guide*.
21155
21425
  #
21156
21426
  # <note markdown="1"> This functionality is not supported for directory buckets.
21157
21427
  #
@@ -21713,10 +21983,10 @@ module Aws::S3
21713
21983
  # Confirms that the requester knows that they will be charged for the
21714
21984
  # request. Bucket owners need not specify this parameter in their
21715
21985
  # requests. If either the source or destination S3 bucket has Requester
21716
- # Pays enabled, the requester will pay for corresponding charges to copy
21717
- # the object. For information about downloading objects from Requester
21718
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
21719
- # in the *Amazon S3 User Guide*.
21986
+ # Pays enabled, the requester will pay for the corresponding charges.
21987
+ # For information about downloading objects from Requester Pays buckets,
21988
+ # see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
21989
+ # S3 User Guide*.
21720
21990
  #
21721
21991
  # <note markdown="1"> This functionality is not supported for directory buckets.
21722
21992
  #
@@ -22283,7 +22553,7 @@ module Aws::S3
22283
22553
  tracer: tracer
22284
22554
  )
22285
22555
  context[:gem_name] = 'aws-sdk-s3'
22286
- context[:gem_version] = '1.212.0'
22556
+ context[:gem_version] = '1.213.0'
22287
22557
  Seahorse::Client::Request.new(handlers, context)
22288
22558
  end
22289
22559