aws-sdk-s3 1.84.1 → 1.85.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 152630b0a9acb1b213eb0793432bbf020129fa5ba436128ec2cc8bf404895c99
4
- data.tar.gz: 32352566fbee102dd684a37205b3a90ee9a6d0736ec6a106aa112540ba7d081b
3
+ metadata.gz: 149a7e68554a7b8ab408e8ca71af6db2265bfde1ff763880cf160202cbc55dfe
4
+ data.tar.gz: e526a261743e9f58ce1ae89674e73a287def1ed75d3a3653077cbe4a4c51723e
5
5
  SHA512:
6
- metadata.gz: 410beb9c8e6e673bda33f020f01bd6bbdb9e848d309e2ed732263b2ac09c708023591a08084bea78223aacb45f4b48980234060d6ef63778d04c261f837e862c
7
- data.tar.gz: 9e97114d1b6044c44715744b56856678ff0509d11270fb3ebbb7a4dd9fa5af55d9e085c316af9d2bf4ca6e36be342240b9241d4352896709f8961356b88f0b5e
6
+ metadata.gz: f7ff92c23369d0dbe26b3f313d8c32560e0d9afbe6b6b9da2f9f3285be8eafe29436a9fcba65c7beb419fa0d10f2ec2a7b6af3a6452e735643126e743ff63b7f
7
+ data.tar.gz: b86680a9d6c2eff8c99f5b18a363759da6e7847e0984ed111cc20e766e903fb85fa877ae6517ec83f3e2c1540eafbfb1086a47a7a7e4ed3ac6896ed62f8fd51f
@@ -69,6 +69,6 @@ require_relative 'aws-sdk-s3/event_streams'
69
69
  # @!group service
70
70
  module Aws::S3
71
71
 
72
- GEM_VERSION = '1.84.1'
72
+ GEM_VERSION = '1.85.0'
73
73
 
74
74
  end
@@ -221,6 +221,9 @@ module Aws::S3
221
221
  # used as a message integrity check to verify that the request body was
222
222
  # not corrupted in transit. For more information, go to [RFC 1864.][1]
223
223
  #
224
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
225
+ # SDKs, this field is calculated automatically.
226
+ #
224
227
  #
225
228
  #
226
229
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -224,6 +224,9 @@ module Aws::S3
224
224
  # used as a message integrity check to verify that the request body was
225
225
  # not corrupted in transit. For more information, go to [RFC 1864.][1]
226
226
  #
227
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
228
+ # SDKs, this field is calculated automatically.
229
+ #
227
230
  #
228
231
  #
229
232
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -228,6 +228,8 @@ module Aws::S3
228
228
  # })
229
229
  # @param [Hash] options ({})
230
230
  # @option options [String] :content_md5
231
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
232
+ # SDKs, this field is calculated automatically.
231
233
  # @option options [Types::LifecycleConfiguration] :lifecycle_configuration
232
234
  # @option options [String] :expected_bucket_owner
233
235
  # The account id of the expected bucket owner. If the bucket is owned by
@@ -210,6 +210,9 @@ module Aws::S3
210
210
  # Container for logging status information.
211
211
  # @option options [String] :content_md5
212
212
  # The MD5 hash of the `PutBucketLogging` request body.
213
+ #
214
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
215
+ # SDKs, this field is calculated automatically.
213
216
  # @option options [String] :expected_bucket_owner
214
217
  # The account id of the expected bucket owner. If the bucket is owned by
215
218
  # a different account, the request will fail with an HTTP `403 (Access
@@ -202,6 +202,9 @@ module Aws::S3
202
202
  # @param [Hash] options ({})
203
203
  # @option options [String] :content_md5
204
204
  # The MD5 hash of the request body.
205
+ #
206
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
207
+ # SDKs, this field is calculated automatically.
205
208
  # @option options [Boolean] :confirm_remove_self_bucket_access
206
209
  # Set this parameter to true to confirm that you want to remove your
207
210
  # permissions to change this bucket policy in the future.
@@ -190,6 +190,9 @@ module Aws::S3
190
190
  # body was not corrupted in transit. For more information, see [RFC
191
191
  # 1864][1].
192
192
  #
193
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
194
+ # SDKs, this field is calculated automatically.
195
+ #
193
196
  #
194
197
  #
195
198
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -211,6 +211,9 @@ module Aws::S3
211
211
  # header as a message integrity check to verify that the request body
212
212
  # was not corrupted in transit. For more information, see [RFC 1864][1].
213
213
  #
214
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
215
+ # SDKs, this field is calculated automatically.
216
+ #
214
217
  #
215
218
  #
216
219
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -197,6 +197,9 @@ module Aws::S3
197
197
  # body was not corrupted in transit. For more information, see [RFC
198
198
  # 1864][1].
199
199
  #
200
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
201
+ # SDKs, this field is calculated automatically.
202
+ #
200
203
  #
201
204
  #
202
205
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -237,6 +240,9 @@ module Aws::S3
237
240
  # body was not corrupted in transit. For more information, see [RFC
238
241
  # 1864][1].
239
242
  #
243
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
244
+ # SDKs, this field is calculated automatically.
245
+ #
240
246
  #
241
247
  #
242
248
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -270,6 +276,9 @@ module Aws::S3
270
276
  # body was not corrupted in transit. For more information, see [RFC
271
277
  # 1864][1].
272
278
  #
279
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
280
+ # SDKs, this field is calculated automatically.
281
+ #
273
282
  #
274
283
  #
275
284
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -252,6 +252,9 @@ module Aws::S3
252
252
  # header as a message integrity check to verify that the request body
253
253
  # was not corrupted in transit. For more information, see [RFC 1864][1].
254
254
  #
255
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
256
+ # SDKs, this field is calculated automatically.
257
+ #
255
258
  #
256
259
  #
257
260
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -1405,33 +1405,33 @@ module Aws::S3
1405
1405
  # * {Types::CreateBucketOutput#location #location} => String
1406
1406
  #
1407
1407
  #
1408
- # @example Example: To create a bucket in a specific region
1408
+ # @example Example: To create a bucket
1409
1409
  #
1410
- # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
1410
+ # # The following example creates a bucket.
1411
1411
  #
1412
1412
  # resp = client.create_bucket({
1413
1413
  # bucket: "examplebucket",
1414
- # create_bucket_configuration: {
1415
- # location_constraint: "eu-west-1",
1416
- # },
1417
1414
  # })
1418
1415
  #
1419
1416
  # resp.to_h outputs the following:
1420
1417
  # {
1421
- # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
1418
+ # location: "/examplebucket",
1422
1419
  # }
1423
1420
  #
1424
- # @example Example: To create a bucket
1421
+ # @example Example: To create a bucket in a specific region
1425
1422
  #
1426
- # # The following example creates a bucket.
1423
+ # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
1427
1424
  #
1428
1425
  # resp = client.create_bucket({
1429
1426
  # bucket: "examplebucket",
1427
+ # create_bucket_configuration: {
1428
+ # location_constraint: "eu-west-1",
1429
+ # },
1430
1430
  # })
1431
1431
  #
1432
1432
  # resp.to_h outputs the following:
1433
1433
  # {
1434
- # location: "/examplebucket",
1434
+ # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
1435
1435
  # }
1436
1436
  #
1437
1437
  # @example Request syntax with placeholder values
@@ -2929,35 +2929,35 @@ module Aws::S3
2929
2929
  # * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
2930
2930
  #
2931
2931
  #
2932
- # @example Example: To remove tag set from an object
2932
+ # @example Example: To remove tag set from an object version
2933
2933
  #
2934
- # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2935
- # # operation removes tag set from the latest object version.
2934
+ # # The following example removes tag set associated with the specified object version. The request specifies both the
2935
+ # # object key and object version.
2936
2936
  #
2937
2937
  # resp = client.delete_object_tagging({
2938
2938
  # bucket: "examplebucket",
2939
2939
  # key: "HappyFace.jpg",
2940
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2940
2941
  # })
2941
2942
  #
2942
2943
  # resp.to_h outputs the following:
2943
2944
  # {
2944
- # version_id: "null",
2945
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2945
2946
  # }
2946
2947
  #
2947
- # @example Example: To remove tag set from an object version
2948
+ # @example Example: To remove tag set from an object
2948
2949
  #
2949
- # # The following example removes tag set associated with the specified object version. The request specifies both the
2950
- # # object key and object version.
2950
+ # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2951
+ # # operation removes tag set from the latest object version.
2951
2952
  #
2952
2953
  # resp = client.delete_object_tagging({
2953
2954
  # bucket: "examplebucket",
2954
2955
  # key: "HappyFace.jpg",
2955
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2956
2956
  # })
2957
2957
  #
2958
2958
  # resp.to_h outputs the following:
2959
2959
  # {
2960
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2960
+ # version_id: "null",
2961
2961
  # }
2962
2962
  #
2963
2963
  # @example Request syntax with placeholder values
@@ -3097,20 +3097,22 @@ module Aws::S3
3097
3097
  # * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
3098
3098
  #
3099
3099
  #
3100
- # @example Example: To delete multiple objects from a versioned bucket
3100
+ # @example Example: To delete multiple object versions from a versioned bucket
3101
3101
  #
3102
- # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
3103
- # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
3102
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
3103
+ # # versions and returns the key and versions of deleted objects in the response.
3104
3104
  #
3105
3105
  # resp = client.delete_objects({
3106
3106
  # bucket: "examplebucket",
3107
3107
  # delete: {
3108
3108
  # objects: [
3109
3109
  # {
3110
- # key: "objectkey1",
3110
+ # key: "HappyFace.jpg",
3111
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3111
3112
  # },
3112
3113
  # {
3113
- # key: "objectkey2",
3114
+ # key: "HappyFace.jpg",
3115
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3114
3116
  # },
3115
3117
  # ],
3116
3118
  # quiet: false,
@@ -3121,34 +3123,30 @@ module Aws::S3
3121
3123
  # {
3122
3124
  # deleted: [
3123
3125
  # {
3124
- # delete_marker: true,
3125
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
3126
- # key: "objectkey1",
3126
+ # key: "HappyFace.jpg",
3127
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3127
3128
  # },
3128
3129
  # {
3129
- # delete_marker: true,
3130
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
3131
- # key: "objectkey2",
3130
+ # key: "HappyFace.jpg",
3131
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3132
3132
  # },
3133
3133
  # ],
3134
3134
  # }
3135
3135
  #
3136
- # @example Example: To delete multiple object versions from a versioned bucket
3136
+ # @example Example: To delete multiple objects from a versioned bucket
3137
3137
  #
3138
- # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
3139
- # # versions and returns the key and versions of deleted objects in the response.
3138
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
3139
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
3140
3140
  #
3141
3141
  # resp = client.delete_objects({
3142
3142
  # bucket: "examplebucket",
3143
3143
  # delete: {
3144
3144
  # objects: [
3145
3145
  # {
3146
- # key: "HappyFace.jpg",
3147
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3146
+ # key: "objectkey1",
3148
3147
  # },
3149
3148
  # {
3150
- # key: "HappyFace.jpg",
3151
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3149
+ # key: "objectkey2",
3152
3150
  # },
3153
3151
  # ],
3154
3152
  # quiet: false,
@@ -3159,12 +3157,14 @@ module Aws::S3
3159
3157
  # {
3160
3158
  # deleted: [
3161
3159
  # {
3162
- # key: "HappyFace.jpg",
3163
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3160
+ # delete_marker: true,
3161
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
3162
+ # key: "objectkey1",
3164
3163
  # },
3165
3164
  # {
3166
- # key: "HappyFace.jpg",
3167
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3165
+ # delete_marker: true,
3166
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
3167
+ # key: "objectkey2",
3168
3168
  # },
3169
3169
  # ],
3170
3170
  # }
@@ -5056,13 +5056,13 @@ module Aws::S3
5056
5056
  # For more information about returning the ACL of an object, see
5057
5057
  # [GetObjectAcl][3].
5058
5058
  #
5059
- # If the object you are retrieving is stored in the S3 Glacier, S3
5060
- # Glacier Deep Archive, S3 Intelligent-Tiering Archive, or S3
5061
- # Intelligent-Tiering Deep Archive storage classes, before you can
5062
- # retrieve the object you must first restore a copy using
5063
- # [RestoreObject][4]. Otherwise, this operation returns an
5064
- # `InvalidObjectStateError` error. For information about restoring
5065
- # archived objects, see [Restoring Archived Objects][5].
5059
+ # If the object you are retrieving is stored in the S3 Glacier or S3
5060
+ # Glacier Deep Archive storage class, or S3 Intelligent-Tiering Archive
5061
+ # or S3 Intelligent-Tiering Deep Archive tiers, before you can retrieve
5062
+ # the object you must first restore a copy using [RestoreObject][4].
5063
+ # Otherwise, this operation returns an `InvalidObjectStateError` error.
5064
+ # For information about restoring archived objects, see [Restoring
5065
+ # Archived Objects][5].
5066
5066
  #
5067
5067
  # Encryption request headers, like `x-amz-server-side-encryption`,
5068
5068
  # should not be sent for GET requests if your object uses server-side
@@ -8294,6 +8294,9 @@ module Aws::S3
8294
8294
  # used as a message integrity check to verify that the request body was
8295
8295
  # not corrupted in transit. For more information, go to [RFC 1864.][1]
8296
8296
  #
8297
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
8298
+ # SDKs, this field is calculated automatically.
8299
+ #
8297
8300
  #
8298
8301
  #
8299
8302
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -8580,6 +8583,9 @@ module Aws::S3
8580
8583
  # used as a message integrity check to verify that the request body was
8581
8584
  # not corrupted in transit. For more information, go to [RFC 1864.][1]
8582
8585
  #
8586
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
8587
+ # SDKs, this field is calculated automatically.
8588
+ #
8583
8589
  #
8584
8590
  #
8585
8591
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -8711,8 +8717,10 @@ module Aws::S3
8711
8717
  #
8712
8718
  # @option params [String] :content_md5
8713
8719
  # The base64-encoded 128-bit MD5 digest of the server-side encryption
8714
- # configuration. This parameter is auto-populated when using the command
8715
- # from the CLI.
8720
+ # configuration.
8721
+ #
8722
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
8723
+ # SDKs, this field is calculated automatically.
8716
8724
  #
8717
8725
  # @option params [required, Types::ServerSideEncryptionConfiguration] :server_side_encryption_configuration
8718
8726
  # Specifies the default server-side-encryption configuration.
@@ -9044,6 +9052,8 @@ module Aws::S3
9044
9052
  # @option params [required, String] :bucket
9045
9053
  #
9046
9054
  # @option params [String] :content_md5
9055
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
9056
+ # SDKs, this field is calculated automatically.
9047
9057
  #
9048
9058
  # @option params [Types::LifecycleConfiguration] :lifecycle_configuration
9049
9059
  #
@@ -9364,6 +9374,9 @@ module Aws::S3
9364
9374
  # @option params [String] :content_md5
9365
9375
  # The MD5 hash of the `PutBucketLogging` request body.
9366
9376
  #
9377
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
9378
+ # SDKs, this field is calculated automatically.
9379
+ #
9367
9380
  # @option params [String] :expected_bucket_owner
9368
9381
  # The account id of the expected bucket owner. If the bucket is owned by
9369
9382
  # a different account, the request will fail with an HTTP `403 (Access
@@ -9540,6 +9553,9 @@ module Aws::S3
9540
9553
  # @option params [String] :content_md5
9541
9554
  # The MD5 hash of the `PutPublicAccessBlock` request body.
9542
9555
  #
9556
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
9557
+ # SDKs, this field is calculated automatically.
9558
+ #
9543
9559
  # @option params [required, Types::NotificationConfigurationDeprecated] :notification_configuration
9544
9560
  # The container for the configuration.
9545
9561
  #
@@ -9784,6 +9800,9 @@ module Aws::S3
9784
9800
  # @option params [String] :content_md5
9785
9801
  # The MD5 hash of the `OwnershipControls` request body.
9786
9802
  #
9803
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
9804
+ # SDKs, this field is calculated automatically.
9805
+ #
9787
9806
  # @option params [String] :expected_bucket_owner
9788
9807
  # The account id of the expected bucket owner. If the bucket is owned by
9789
9808
  # a different account, the request will fail with an HTTP `403 (Access
@@ -9855,6 +9874,9 @@ module Aws::S3
9855
9874
  # @option params [String] :content_md5
9856
9875
  # The MD5 hash of the request body.
9857
9876
  #
9877
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
9878
+ # SDKs, this field is calculated automatically.
9879
+ #
9858
9880
  # @option params [Boolean] :confirm_remove_self_bucket_access
9859
9881
  # Set this parameter to true to confirm that you want to remove your
9860
9882
  # permissions to change this bucket policy in the future.
@@ -9926,26 +9948,21 @@ module Aws::S3
9926
9948
  # configuration, you must also add the following elements:
9927
9949
  # `DeleteMarkerReplication`, `Status`, and `Priority`.
9928
9950
  #
9929
- # <note markdown="1"> The latest version of the replication configuration XML is V2. XML V2
9930
- # replication configurations are those that contain the `Filter` element
9931
- # for rules, and rules that specify S3 Replication Time Control (S3
9932
- # RTC). In XML V2 replication configurations, Amazon S3 doesn't
9933
- # replicate delete markers. Therefore, you must set the
9934
- # `DeleteMarkerReplication` element to `Disabled`. For backward
9935
- # compatibility, Amazon S3 continues to support the XML V1 replication
9936
- # configuration.
9951
+ # <note markdown="1"> If you are using an earlier version of the replication configuration,
9952
+ # Amazon S3 handles replication of delete markers differently. For more
9953
+ # information, see [Backward Compatibility][3].
9937
9954
  #
9938
9955
  # </note>
9939
9956
  #
9940
9957
  # For information about enabling versioning on a bucket, see [Using
9941
- # Versioning][3].
9958
+ # Versioning][4].
9942
9959
  #
9943
9960
  # By default, a resource owner, in this case the AWS account that
9944
9961
  # created the bucket, can perform this operation. The resource owner can
9945
9962
  # also grant others permissions to perform the operation. For more
9946
9963
  # information about permissions, see [Specifying Permissions in a
9947
- # Policy][4] and [Managing Access Permissions to Your Amazon S3
9948
- # Resources][5].
9964
+ # Policy][5] and [Managing Access Permissions to Your Amazon S3
9965
+ # Resources][6].
9949
9966
  #
9950
9967
  # **Handling Replication of Encrypted Objects**
9951
9968
  #
@@ -9955,28 +9972,29 @@ module Aws::S3
9955
9972
  # `SourceSelectionCriteria`, `SseKmsEncryptedObjects`, `Status`,
9956
9973
  # `EncryptionConfiguration`, and `ReplicaKmsKeyID`. For information
9957
9974
  # about replication configuration, see [Replicating Objects Created with
9958
- # SSE Using CMKs stored in AWS KMS][6].
9975
+ # SSE Using CMKs stored in AWS KMS][7].
9959
9976
  #
9960
9977
  # For information on `PutBucketReplication` errors, see [List of
9961
- # replication-related error codes][7]
9978
+ # replication-related error codes][8]
9962
9979
  #
9963
9980
  # The following operations are related to `PutBucketReplication`\:
9964
9981
  #
9965
- # * [GetBucketReplication][8]
9982
+ # * [GetBucketReplication][9]
9966
9983
  #
9967
- # * [DeleteBucketReplication][9]
9984
+ # * [DeleteBucketReplication][10]
9968
9985
  #
9969
9986
  #
9970
9987
  #
9971
9988
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
9972
9989
  # [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html
9973
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html
9974
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
9975
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9976
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html
9977
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList
9978
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
9979
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html
9990
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations
9991
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html
9992
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
9993
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9994
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html
9995
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList
9996
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
9997
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html
9980
9998
  #
9981
9999
  # @option params [required, String] :bucket
9982
10000
  # The name of the bucket
@@ -9986,6 +10004,9 @@ module Aws::S3
9986
10004
  # header as a message integrity check to verify that the request body
9987
10005
  # was not corrupted in transit. For more information, see [RFC 1864][1].
9988
10006
  #
10007
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
10008
+ # SDKs, this field is calculated automatically.
10009
+ #
9989
10010
  #
9990
10011
  #
9991
10012
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -10132,6 +10153,9 @@ module Aws::S3
10132
10153
  # body was not corrupted in transit. For more information, see [RFC
10133
10154
  # 1864][1].
10134
10155
  #
10156
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
10157
+ # SDKs, this field is calculated automatically.
10158
+ #
10135
10159
  #
10136
10160
  #
10137
10161
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -10258,6 +10282,9 @@ module Aws::S3
10258
10282
  # header as a message integrity check to verify that the request body
10259
10283
  # was not corrupted in transit. For more information, see [RFC 1864][1].
10260
10284
  #
10285
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
10286
+ # SDKs, this field is calculated automatically.
10287
+ #
10261
10288
  #
10262
10289
  #
10263
10290
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -10371,6 +10398,9 @@ module Aws::S3
10371
10398
  # body was not corrupted in transit. For more information, see [RFC
10372
10399
  # 1864][1].
10373
10400
  #
10401
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
10402
+ # SDKs, this field is calculated automatically.
10403
+ #
10374
10404
  #
10375
10405
  #
10376
10406
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -10505,6 +10535,9 @@ module Aws::S3
10505
10535
  # header as a message integrity check to verify that the request body
10506
10536
  # was not corrupted in transit. For more information, see [RFC 1864][1].
10507
10537
  #
10538
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
10539
+ # SDKs, this field is calculated automatically.
10540
+ #
10508
10541
  #
10509
10542
  #
10510
10543
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -10925,41 +10958,22 @@ module Aws::S3
10925
10958
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
10926
10959
  #
10927
10960
  #
10928
- # @example Example: To upload object and specify user-defined metadata
10961
+ # @example Example: To upload an object and specify canned ACL.
10929
10962
  #
10930
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
10931
- # # enabled, S3 returns version ID in response.
10963
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
10964
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
10932
10965
  #
10933
10966
  # resp = client.put_object({
10967
+ # acl: "authenticated-read",
10934
10968
  # body: "filetoupload",
10935
10969
  # bucket: "examplebucket",
10936
10970
  # key: "exampleobject",
10937
- # metadata: {
10938
- # "metadata1" => "value1",
10939
- # "metadata2" => "value2",
10940
- # },
10941
- # })
10942
- #
10943
- # resp.to_h outputs the following:
10944
- # {
10945
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
10946
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
10947
- # }
10948
- #
10949
- # @example Example: To create an object.
10950
- #
10951
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
10952
- #
10953
- # resp = client.put_object({
10954
- # body: "filetoupload",
10955
- # bucket: "examplebucket",
10956
- # key: "objectkey",
10957
10971
  # })
10958
10972
  #
10959
10973
  # resp.to_h outputs the following:
10960
10974
  # {
10961
10975
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
10962
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
10976
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
10963
10977
  # }
10964
10978
  #
10965
10979
  # @example Example: To upload an object and specify optional tags
@@ -11000,42 +11014,41 @@ module Aws::S3
11000
11014
  # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11001
11015
  # }
11002
11016
  #
11003
- # @example Example: To upload an object and specify canned ACL.
11017
+ # @example Example: To create an object.
11004
11018
  #
11005
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
11006
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
11019
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
11007
11020
  #
11008
11021
  # resp = client.put_object({
11009
- # acl: "authenticated-read",
11010
11022
  # body: "filetoupload",
11011
11023
  # bucket: "examplebucket",
11012
- # key: "exampleobject",
11024
+ # key: "objectkey",
11013
11025
  # })
11014
11026
  #
11015
11027
  # resp.to_h outputs the following:
11016
11028
  # {
11017
11029
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11018
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
11030
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
11019
11031
  # }
11020
11032
  #
11021
- # @example Example: To upload an object (specify optional headers)
11033
+ # @example Example: To upload object and specify user-defined metadata
11022
11034
  #
11023
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
11024
- # # storage class and use server-side encryption.
11035
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
11036
+ # # enabled, S3 returns version ID in response.
11025
11037
  #
11026
11038
  # resp = client.put_object({
11027
- # body: "HappyFace.jpg",
11039
+ # body: "filetoupload",
11028
11040
  # bucket: "examplebucket",
11029
- # key: "HappyFace.jpg",
11030
- # server_side_encryption: "AES256",
11031
- # storage_class: "STANDARD_IA",
11041
+ # key: "exampleobject",
11042
+ # metadata: {
11043
+ # "metadata1" => "value1",
11044
+ # "metadata2" => "value2",
11045
+ # },
11032
11046
  # })
11033
11047
  #
11034
11048
  # resp.to_h outputs the following:
11035
11049
  # {
11036
11050
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11037
- # server_side_encryption: "AES256",
11038
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
11051
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
11039
11052
  # }
11040
11053
  #
11041
11054
  # @example Example: To upload an object
@@ -11055,6 +11068,26 @@ module Aws::S3
11055
11068
  # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11056
11069
  # }
11057
11070
  #
11071
+ # @example Example: To upload an object (specify optional headers)
11072
+ #
11073
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
11074
+ # # storage class and use server-side encryption.
11075
+ #
11076
+ # resp = client.put_object({
11077
+ # body: "HappyFace.jpg",
11078
+ # bucket: "examplebucket",
11079
+ # key: "HappyFace.jpg",
11080
+ # server_side_encryption: "AES256",
11081
+ # storage_class: "STANDARD_IA",
11082
+ # })
11083
+ #
11084
+ # resp.to_h outputs the following:
11085
+ # {
11086
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11087
+ # server_side_encryption: "AES256",
11088
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
11089
+ # }
11090
+ #
11058
11091
  # @example Streaming a file from disk
11059
11092
  # # upload file from disk in a single request, may not exceed 5GB
11060
11093
  # File.open('/source/file/path', 'rb') do |file|
@@ -11306,6 +11339,9 @@ module Aws::S3
11306
11339
  # not corrupted in transit. For more information, go to [RFC
11307
11340
  # 1864.&gt;][1]
11308
11341
  #
11342
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
11343
+ # SDKs, this field is calculated automatically.
11344
+ #
11309
11345
  #
11310
11346
  #
11311
11347
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
@@ -11504,6 +11540,9 @@ module Aws::S3
11504
11540
  # @option params [String] :content_md5
11505
11541
  # The MD5 hash for the request body.
11506
11542
  #
11543
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
11544
+ # SDKs, this field is calculated automatically.
11545
+ #
11507
11546
  # @option params [String] :expected_bucket_owner
11508
11547
  # The account id of the expected bucket owner. If the bucket is owned by
11509
11548
  # a different account, the request will fail with an HTTP `403 (Access
@@ -11584,6 +11623,9 @@ module Aws::S3
11584
11623
  # @option params [String] :content_md5
11585
11624
  # The MD5 hash for the request body.
11586
11625
  #
11626
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
11627
+ # SDKs, this field is calculated automatically.
11628
+ #
11587
11629
  # @option params [String] :expected_bucket_owner
11588
11630
  # The account id of the expected bucket owner. If the bucket is owned by
11589
11631
  # a different account, the request will fail with an HTTP `403 (Access
@@ -11685,6 +11727,9 @@ module Aws::S3
11685
11727
  # @option params [String] :content_md5
11686
11728
  # The MD5 hash for the request body.
11687
11729
  #
11730
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
11731
+ # SDKs, this field is calculated automatically.
11732
+ #
11688
11733
  # @option params [String] :expected_bucket_owner
11689
11734
  # The account id of the expected bucket owner. If the bucket is owned by
11690
11735
  # a different account, the request will fail with an HTTP `403 (Access
@@ -11813,6 +11858,9 @@ module Aws::S3
11813
11858
  # @option params [String] :content_md5
11814
11859
  # The MD5 hash for the request body.
11815
11860
  #
11861
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
11862
+ # SDKs, this field is calculated automatically.
11863
+ #
11816
11864
  # @option params [required, Types::Tagging] :tagging
11817
11865
  # Container for the `TagSet` and `Tag` elements
11818
11866
  #
@@ -11925,6 +11973,9 @@ module Aws::S3
11925
11973
  # @option params [String] :content_md5
11926
11974
  # The MD5 hash of the `PutPublicAccessBlock` request body.
11927
11975
  #
11976
+ # For requests made using the AWS Command Line Interface (CLI) or AWS
11977
+ # SDKs, this field is calculated automatically.
11978
+ #
11928
11979
  # @option params [required, Types::PublicAccessBlockConfiguration] :public_access_block_configuration
11929
11980
  # The `PublicAccessBlock` configuration that you want to apply to this
11930
11981
  # Amazon S3 bucket. You can enable the configuration options in any
@@ -12064,18 +12115,18 @@ module Aws::S3
12064
12115
  # * Amazon S3 accepts a select request even if the object has already
12065
12116
  # been restored. A select request doesn’t return error response `409`.
12066
12117
  #
12067
- # **Restoring Archives**
12118
+ # **Restoring objects**
12068
12119
  #
12069
- # Objects that you archive to the S3 Glacier, S3 Glacier Deep Archive,
12070
- # S3 Intelligent-Tiering Archive, or S3 Intelligent-Tiering Deep Archive
12071
- # storage classes are not accessible in real time. For objects in
12072
- # Archive Access tier or Deep Archive Access tier you must first
12073
- # initiate a restore request, and then wait until the object is moved
12074
- # into the Frequent Access tier. For objects in S3 Glacier or S3 Glacier
12075
- # Deep Archive you must first initiate a restore request, and then wait
12076
- # until a temporary copy of the object is available. To access an
12077
- # archived object, you must restore the object for the duration (number
12078
- # of days) that you specify.
12120
+ # Objects that you archive to the S3 Glacier or S3 Glacier Deep Archive
12121
+ # storage class, and S3 Intelligent-Tiering Archive or S3
12122
+ # Intelligent-Tiering Deep Archive tiers are not accessible in real
12123
+ # time. For objects in Archive Access or Deep Archive Access tiers you
12124
+ # must first initiate a restore request, and then wait until the object
12125
+ # is moved into the Frequent Access tier. For objects in S3 Glacier or
12126
+ # S3 Glacier Deep Archive storage classes you must first initiate a
12127
+ # restore request, and then wait until a temporary copy of the object is
12128
+ # available. To access an archived object, you must restore the object
12129
+ # for the duration (number of days) that you specify.
12079
12130
  #
12080
12131
  # To restore a specific object version, you can provide a version ID. If
12081
12132
  # you don't provide a version ID, Amazon S3 restores the current
@@ -12086,35 +12137,34 @@ module Aws::S3
12086
12137
  # element of the request body:
12087
12138
  #
12088
12139
  # * <b> <code>Expedited</code> </b> - Expedited retrievals allow you to
12089
- # quickly access your data stored in the S3 Glacier or S3
12090
- # Intelligent-Tiering Archive storage class when occasional urgent
12091
- # requests for a subset of archives are required. For all but the
12092
- # largest archived objects (250 MB+), data accessed using Expedited
12093
- # retrievals is typically made available within 1–5 minutes.
12094
- # Provisioned capacity ensures that retrieval capacity for Expedited
12095
- # retrievals is available when you need it. Expedited retrievals and
12096
- # provisioned capacity are not available for objects stored in the S3
12097
- # Glacier Deep Archive or S3 Intelligent-Tiering Deep Archive storage
12098
- # class.
12140
+ # quickly access your data stored in the S3 Glacier storage class or
12141
+ # S3 Intelligent-Tiering Archive tier when occasional urgent requests
12142
+ # for a subset of archives are required. For all but the largest
12143
+ # archived objects (250 MB+), data accessed using Expedited retrievals
12144
+ # is typically made available within 1–5 minutes. Provisioned capacity
12145
+ # ensures that retrieval capacity for Expedited retrievals is
12146
+ # available when you need it. Expedited retrievals and provisioned
12147
+ # capacity are not available for objects stored in the S3 Glacier Deep
12148
+ # Archive storage class or S3 Intelligent-Tiering Deep Archive tier.
12099
12149
  #
12100
12150
  # * <b> <code>Standard</code> </b> - Standard retrievals allow you to
12101
12151
  # access any of your archived objects within several hours. This is
12102
12152
  # the default option for retrieval requests that do not specify the
12103
12153
  # retrieval option. Standard retrievals typically finish within 3–5
12104
- # hours for objects stored in the S3 Glacier or S3 Intelligent-Tiering
12105
- # Archive storage class. They typically finish within 12 hours for
12106
- # objects stored in the S3 Glacier Deep Archive or S3
12107
- # Intelligent-Tiering Deep Archive storage class. Standard retrievals
12108
- # are free for objects stored in S3 Intelligent-Tiering.
12154
+ # hours for objects stored in the S3 Glacier storage class or S3
12155
+ # Intelligent-Tiering Archive tier. They typically finish within 12
12156
+ # hours for objects stored in the S3 Glacier Deep Archive storage
12157
+ # class or S3 Intelligent-Tiering Deep Archive tier. Standard
12158
+ # retrievals are free for objects stored in S3 Intelligent-Tiering.
12109
12159
  #
12110
12160
  # * <b> <code>Bulk</code> </b> - Bulk retrievals are the lowest-cost
12111
12161
  # retrieval option in S3 Glacier, enabling you to retrieve large
12112
12162
  # amounts, even petabytes, of data inexpensively. Bulk retrievals
12113
12163
  # typically finish within 5–12 hours for objects stored in the S3
12114
- # Glacier or S3 Intelligent-Tiering Archive storage class. They
12164
+ # Glacier storage class or S3 Intelligent-Tiering Archive tier. They
12115
12165
  # typically finish within 48 hours for objects stored in the S3
12116
- # Glacier Deep Archive or S3 Intelligent-Tiering Deep Archive storage
12117
- # class. Bulk retrievals are free for objects stored in S3
12166
+ # Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep
12167
+ # Archive tier. Bulk retrievals are free for objects stored in S3
12118
12168
  # Intelligent-Tiering.
12119
12169
  #
12120
12170
  # For more information about archive retrieval options and provisioned
@@ -13356,45 +13406,45 @@ module Aws::S3
13356
13406
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
13357
13407
  #
13358
13408
  #
13359
- # @example Example: To upload a part by copying data from an existing object as data source
13409
+ # @example Example: To upload a part by copying byte range from an existing object as data source
13360
13410
  #
13361
- # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
13411
+ # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
13412
+ # # data source.
13362
13413
  #
13363
13414
  # resp = client.upload_part_copy({
13364
13415
  # bucket: "examplebucket",
13365
13416
  # copy_source: "/bucketname/sourceobjectkey",
13417
+ # copy_source_range: "bytes=1-100000",
13366
13418
  # key: "examplelargeobject",
13367
- # part_number: 1,
13419
+ # part_number: 2,
13368
13420
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
13369
13421
  # })
13370
13422
  #
13371
13423
  # resp.to_h outputs the following:
13372
13424
  # {
13373
13425
  # copy_part_result: {
13374
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
13375
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
13426
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
13427
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
13376
13428
  # },
13377
13429
  # }
13378
13430
  #
13379
- # @example Example: To upload a part by copying byte range from an existing object as data source
13431
+ # @example Example: To upload a part by copying data from an existing object as data source
13380
13432
  #
13381
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
13382
- # # data source.
13433
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
13383
13434
  #
13384
13435
  # resp = client.upload_part_copy({
13385
13436
  # bucket: "examplebucket",
13386
13437
  # copy_source: "/bucketname/sourceobjectkey",
13387
- # copy_source_range: "bytes=1-100000",
13388
13438
  # key: "examplelargeobject",
13389
- # part_number: 2,
13439
+ # part_number: 1,
13390
13440
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
13391
13441
  # })
13392
13442
  #
13393
13443
  # resp.to_h outputs the following:
13394
13444
  # {
13395
13445
  # copy_part_result: {
13396
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
13397
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
13446
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
13447
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
13398
13448
  # },
13399
13449
  # }
13400
13450
  #
@@ -13455,7 +13505,7 @@ module Aws::S3
13455
13505
  params: params,
13456
13506
  config: config)
13457
13507
  context[:gem_name] = 'aws-sdk-s3'
13458
- context[:gem_version] = '1.84.1'
13508
+ context[:gem_version] = '1.85.0'
13459
13509
  Seahorse::Client::Request.new(handlers, context)
13460
13510
  end
13461
13511