aws-sdk-s3 1.84.1 → 1.85.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: 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