aws-sdk-s3 1.113.2 → 1.115.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: 5274b91e581e514386584d3ea2284363db3bcc1d1d6cbdd3ea992484a26ba3e3
4
- data.tar.gz: 6659086890fbfcb9223311361dbb67f3a55738f2a01ce4845bb05210dd06f59a
3
+ metadata.gz: 8f6bcf037d303611c499b18e346918dfa94632af0e0f2170ddea71b04022b646
4
+ data.tar.gz: 87619f8106356f34e070a7215bbd81de9e58ac3a3d7a586b5f93064eb1989d2d
5
5
  SHA512:
6
- metadata.gz: 2e25bc0dd1c8249a1c5982cb36f1e06b8b8dc8c3c04e277cd2b9eff8bb3ed2fc4cfd2617ecdd8ea206881e066a02a0bccfc525258a5dc9b2b15a42ad1568a31b
7
- data.tar.gz: 9fb04f15c827cdcad16645bde85de0e2b9bdca01483acebc13d6ca8b163eeb21038882468a275b96e293f4c7be42ff481b9275c681d492925cc6e3469a05de02
6
+ metadata.gz: 0f218e976873fed04027aa60f9b946f02e0329d6e9f375f2024072744b372070966dec41dd9386e9c69da1875e575c8b481f47584e84e16561e18f669d3ae020
7
+ data.tar.gz: '08d983381937f557e2b7b3159bd8d7bfce48cc80962c9319d81f2a6032ecb7a7e95fe0af3b140d0ef3db6d2023ebca0c880a8b2337c40bcd459cadc67599d595'
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.115.0 (2022-10-19)
5
+ ------------------
6
+
7
+ * Feature - Updates internal logic for constructing API endpoints. We have added rule-based endpoints and internal model parameters.
8
+
9
+ 1.114.0 (2022-05-03)
10
+ ------------------
11
+
12
+ * Feature - Documentation only update for doc bug fixes for the S3 API docs.
13
+
4
14
  1.113.2 (2022-04-26)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.113.2
1
+ 1.115.0
@@ -223,7 +223,7 @@ module Aws::S3
223
223
  # bucket.create({
224
224
  # acl: "private", # accepts private, public-read, public-read-write, authenticated-read
225
225
  # create_bucket_configuration: {
226
- # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
226
+ # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
227
227
  # },
228
228
  # grant_full_control: "GrantFullControl",
229
229
  # grant_read: "GrantRead",
@@ -1662,33 +1662,33 @@ module Aws::S3
1662
1662
  # * {Types::CreateBucketOutput#location #location} => String
1663
1663
  #
1664
1664
  #
1665
- # @example Example: To create a bucket
1665
+ # @example Example: To create a bucket in a specific region
1666
1666
  #
1667
- # # The following example creates a bucket.
1667
+ # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
1668
1668
  #
1669
1669
  # resp = client.create_bucket({
1670
1670
  # bucket: "examplebucket",
1671
+ # create_bucket_configuration: {
1672
+ # location_constraint: "eu-west-1",
1673
+ # },
1671
1674
  # })
1672
1675
  #
1673
1676
  # resp.to_h outputs the following:
1674
1677
  # {
1675
- # location: "/examplebucket",
1678
+ # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
1676
1679
  # }
1677
1680
  #
1678
- # @example Example: To create a bucket in a specific region
1681
+ # @example Example: To create a bucket
1679
1682
  #
1680
- # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
1683
+ # # The following example creates a bucket.
1681
1684
  #
1682
1685
  # resp = client.create_bucket({
1683
1686
  # bucket: "examplebucket",
1684
- # create_bucket_configuration: {
1685
- # location_constraint: "eu-west-1",
1686
- # },
1687
1687
  # })
1688
1688
  #
1689
1689
  # resp.to_h outputs the following:
1690
1690
  # {
1691
- # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
1691
+ # location: "/examplebucket",
1692
1692
  # }
1693
1693
  #
1694
1694
  # @example Request syntax with placeholder values
@@ -1697,7 +1697,7 @@ module Aws::S3
1697
1697
  # acl: "private", # accepts private, public-read, public-read-write, authenticated-read
1698
1698
  # bucket: "BucketName", # required
1699
1699
  # create_bucket_configuration: {
1700
- # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
1700
+ # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
1701
1701
  # },
1702
1702
  # grant_full_control: "GrantFullControl",
1703
1703
  # grant_read: "GrantRead",
@@ -3109,15 +3109,6 @@ module Aws::S3
3109
3109
  # * {Types::DeleteObjectOutput#request_charged #request_charged} => String
3110
3110
  #
3111
3111
  #
3112
- # @example Example: To delete an object (from a non-versioned bucket)
3113
- #
3114
- # # The following example deletes an object from a non-versioned bucket.
3115
- #
3116
- # resp = client.delete_object({
3117
- # bucket: "ExampleBucket",
3118
- # key: "HappyFace.jpg",
3119
- # })
3120
- #
3121
3112
  # @example Example: To delete an object
3122
3113
  #
3123
3114
  # # The following example deletes an object from an S3 bucket.
@@ -3131,6 +3122,15 @@ module Aws::S3
3131
3122
  # {
3132
3123
  # }
3133
3124
  #
3125
+ # @example Example: To delete an object (from a non-versioned bucket)
3126
+ #
3127
+ # # The following example deletes an object from a non-versioned bucket.
3128
+ #
3129
+ # resp = client.delete_object({
3130
+ # bucket: "ExampleBucket",
3131
+ # key: "HappyFace.jpg",
3132
+ # })
3133
+ #
3134
3134
  # @example Request syntax with placeholder values
3135
3135
  #
3136
3136
  # resp = client.delete_object({
@@ -3223,35 +3223,35 @@ module Aws::S3
3223
3223
  # * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
3224
3224
  #
3225
3225
  #
3226
- # @example Example: To remove tag set from an object version
3226
+ # @example Example: To remove tag set from an object
3227
3227
  #
3228
- # # The following example removes tag set associated with the specified object version. The request specifies both the
3229
- # # object key and object version.
3228
+ # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
3229
+ # # operation removes tag set from the latest object version.
3230
3230
  #
3231
3231
  # resp = client.delete_object_tagging({
3232
3232
  # bucket: "examplebucket",
3233
3233
  # key: "HappyFace.jpg",
3234
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
3235
3234
  # })
3236
3235
  #
3237
3236
  # resp.to_h outputs the following:
3238
3237
  # {
3239
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
3238
+ # version_id: "null",
3240
3239
  # }
3241
3240
  #
3242
- # @example Example: To remove tag set from an object
3241
+ # @example Example: To remove tag set from an object version
3243
3242
  #
3244
- # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
3245
- # # operation removes tag set from the latest object version.
3243
+ # # The following example removes tag set associated with the specified object version. The request specifies both the
3244
+ # # object key and object version.
3246
3245
  #
3247
3246
  # resp = client.delete_object_tagging({
3248
3247
  # bucket: "examplebucket",
3249
3248
  # key: "HappyFace.jpg",
3249
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
3250
3250
  # })
3251
3251
  #
3252
3252
  # resp.to_h outputs the following:
3253
3253
  # {
3254
- # version_id: "null",
3254
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
3255
3255
  # }
3256
3256
  #
3257
3257
  # @example Request syntax with placeholder values
@@ -3410,22 +3410,20 @@ module Aws::S3
3410
3410
  # * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
3411
3411
  #
3412
3412
  #
3413
- # @example Example: To delete multiple object versions from a versioned bucket
3413
+ # @example Example: To delete multiple objects from a versioned bucket
3414
3414
  #
3415
- # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
3416
- # # versions and returns the key and versions of deleted objects in the response.
3415
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
3416
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
3417
3417
  #
3418
3418
  # resp = client.delete_objects({
3419
3419
  # bucket: "examplebucket",
3420
3420
  # delete: {
3421
3421
  # objects: [
3422
3422
  # {
3423
- # key: "HappyFace.jpg",
3424
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3423
+ # key: "objectkey1",
3425
3424
  # },
3426
3425
  # {
3427
- # key: "HappyFace.jpg",
3428
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3426
+ # key: "objectkey2",
3429
3427
  # },
3430
3428
  # ],
3431
3429
  # quiet: false,
@@ -3436,30 +3434,34 @@ module Aws::S3
3436
3434
  # {
3437
3435
  # deleted: [
3438
3436
  # {
3439
- # key: "HappyFace.jpg",
3440
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3437
+ # delete_marker: true,
3438
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
3439
+ # key: "objectkey1",
3441
3440
  # },
3442
3441
  # {
3443
- # key: "HappyFace.jpg",
3444
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3442
+ # delete_marker: true,
3443
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
3444
+ # key: "objectkey2",
3445
3445
  # },
3446
3446
  # ],
3447
3447
  # }
3448
3448
  #
3449
- # @example Example: To delete multiple objects from a versioned bucket
3449
+ # @example Example: To delete multiple object versions from a versioned bucket
3450
3450
  #
3451
- # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
3452
- # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
3451
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
3452
+ # # versions and returns the key and versions of deleted objects in the response.
3453
3453
  #
3454
3454
  # resp = client.delete_objects({
3455
3455
  # bucket: "examplebucket",
3456
3456
  # delete: {
3457
3457
  # objects: [
3458
3458
  # {
3459
- # key: "objectkey1",
3459
+ # key: "HappyFace.jpg",
3460
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3460
3461
  # },
3461
3462
  # {
3462
- # key: "objectkey2",
3463
+ # key: "HappyFace.jpg",
3464
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3463
3465
  # },
3464
3466
  # ],
3465
3467
  # quiet: false,
@@ -3470,14 +3472,12 @@ module Aws::S3
3470
3472
  # {
3471
3473
  # deleted: [
3472
3474
  # {
3473
- # delete_marker: true,
3474
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
3475
- # key: "objectkey1",
3475
+ # key: "HappyFace.jpg",
3476
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3476
3477
  # },
3477
3478
  # {
3478
- # delete_marker: true,
3479
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
3480
- # key: "objectkey2",
3479
+ # key: "HappyFace.jpg",
3480
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3481
3481
  # },
3482
3482
  # ],
3483
3483
  # }
@@ -4418,7 +4418,7 @@ module Aws::S3
4418
4418
  #
4419
4419
  # @example Response structure
4420
4420
  #
4421
- # resp.location_constraint #=> String, one of "af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "ap-south-1", "ap-southeast-1", "ap-southeast-2", "ca-central-1", "cn-north-1", "cn-northwest-1", "EU", "eu-central-1", "eu-north-1", "eu-south-1", "eu-west-1", "eu-west-2", "eu-west-3", "me-south-1", "sa-east-1", "us-east-2", "us-gov-east-1", "us-gov-west-1", "us-west-1", "us-west-2"
4421
+ # resp.location_constraint #=> String, one of "af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "ap-south-1", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ca-central-1", "cn-north-1", "cn-northwest-1", "EU", "eu-central-1", "eu-north-1", "eu-south-1", "eu-west-1", "eu-west-2", "eu-west-3", "me-south-1", "sa-east-1", "us-east-2", "us-gov-east-1", "us-gov-west-1", "us-west-1", "us-west-2"
4422
4422
  #
4423
4423
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation AWS API Documentation
4424
4424
  #
@@ -10028,7 +10028,9 @@ module Aws::S3
10028
10028
  #
10029
10029
  # You specify the lifecycle configuration in your request body. The
10030
10030
  # lifecycle configuration is specified as XML consisting of one or more
10031
- # rules. Each rule consists of the following:
10031
+ # rules. An Amazon S3 Lifecycle configuration can have up to 1,000
10032
+ # rules. This limit is not adjustable. Each rule consists of the
10033
+ # following:
10032
10034
  #
10033
10035
  # * Filter identifying a subset of objects to which the rule applies.
10034
10036
  # The filter can be based on a key name prefix, object tags, or a
@@ -12179,22 +12181,21 @@ module Aws::S3
12179
12181
  # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
12180
12182
  # }
12181
12183
  #
12182
- # @example Example: To upload an object and specify canned ACL.
12184
+ # @example Example: To upload an object
12183
12185
  #
12184
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
12185
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
12186
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
12187
+ # # syntax. S3 returns VersionId of the newly created object.
12186
12188
  #
12187
12189
  # resp = client.put_object({
12188
- # acl: "authenticated-read",
12189
- # body: "filetoupload",
12190
+ # body: "HappyFace.jpg",
12190
12191
  # bucket: "examplebucket",
12191
- # key: "exampleobject",
12192
+ # key: "HappyFace.jpg",
12192
12193
  # })
12193
12194
  #
12194
12195
  # resp.to_h outputs the following:
12195
12196
  # {
12196
12197
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12197
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
12198
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
12198
12199
  # }
12199
12200
  #
12200
12201
  # @example Example: To upload an object and specify server-side encryption and object tags
@@ -12217,78 +12218,79 @@ module Aws::S3
12217
12218
  # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
12218
12219
  # }
12219
12220
  #
12220
- # @example Example: To create an object.
12221
+ # @example Example: To upload object and specify user-defined metadata
12221
12222
  #
12222
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
12223
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
12224
+ # # enabled, S3 returns version ID in response.
12223
12225
  #
12224
12226
  # resp = client.put_object({
12225
12227
  # body: "filetoupload",
12226
12228
  # bucket: "examplebucket",
12227
- # key: "objectkey",
12229
+ # key: "exampleobject",
12230
+ # metadata: {
12231
+ # "metadata1" => "value1",
12232
+ # "metadata2" => "value2",
12233
+ # },
12228
12234
  # })
12229
12235
  #
12230
12236
  # resp.to_h outputs the following:
12231
12237
  # {
12232
12238
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12233
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
12239
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
12234
12240
  # }
12235
12241
  #
12236
- # @example Example: To upload an object
12242
+ # @example Example: To upload an object (specify optional headers)
12237
12243
  #
12238
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
12239
- # # syntax. S3 returns VersionId of the newly created object.
12244
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
12245
+ # # storage class and use server-side encryption.
12240
12246
  #
12241
12247
  # resp = client.put_object({
12242
12248
  # body: "HappyFace.jpg",
12243
12249
  # bucket: "examplebucket",
12244
12250
  # key: "HappyFace.jpg",
12251
+ # server_side_encryption: "AES256",
12252
+ # storage_class: "STANDARD_IA",
12245
12253
  # })
12246
12254
  #
12247
12255
  # resp.to_h outputs the following:
12248
12256
  # {
12249
12257
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12250
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
12258
+ # server_side_encryption: "AES256",
12259
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
12251
12260
  # }
12252
12261
  #
12253
- # @example Example: To upload an object (specify optional headers)
12262
+ # @example Example: To upload an object and specify canned ACL.
12254
12263
  #
12255
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
12256
- # # storage class and use server-side encryption.
12264
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
12265
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
12257
12266
  #
12258
12267
  # resp = client.put_object({
12259
- # body: "HappyFace.jpg",
12268
+ # acl: "authenticated-read",
12269
+ # body: "filetoupload",
12260
12270
  # bucket: "examplebucket",
12261
- # key: "HappyFace.jpg",
12262
- # server_side_encryption: "AES256",
12263
- # storage_class: "STANDARD_IA",
12271
+ # key: "exampleobject",
12264
12272
  # })
12265
12273
  #
12266
12274
  # resp.to_h outputs the following:
12267
12275
  # {
12268
12276
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12269
- # server_side_encryption: "AES256",
12270
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
12277
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
12271
12278
  # }
12272
12279
  #
12273
- # @example Example: To upload object and specify user-defined metadata
12280
+ # @example Example: To create an object.
12274
12281
  #
12275
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
12276
- # # enabled, S3 returns version ID in response.
12282
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
12277
12283
  #
12278
12284
  # resp = client.put_object({
12279
12285
  # body: "filetoupload",
12280
12286
  # bucket: "examplebucket",
12281
- # key: "exampleobject",
12282
- # metadata: {
12283
- # "metadata1" => "value1",
12284
- # "metadata2" => "value2",
12285
- # },
12287
+ # key: "objectkey",
12286
12288
  # })
12287
12289
  #
12288
12290
  # resp.to_h outputs the following:
12289
12291
  # {
12290
12292
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12291
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
12293
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
12292
12294
  # }
12293
12295
  #
12294
12296
  # @example Streaming a file from disk
@@ -14230,9 +14232,11 @@ module Aws::S3
14230
14232
  # number uniquely identifies a part and also defines its position within
14231
14233
  # the object being created. If you upload a new part using the same part
14232
14234
  # number that was used with a previous part, the previously uploaded
14233
- # part is overwritten. Each part must be at least 5 MB in size, except
14234
- # the last part. There is no size limit on the last part of your
14235
- # multipart upload.
14235
+ # part is overwritten.
14236
+ #
14237
+ # For information about maximum and minimum part sizes and other
14238
+ # multipart upload specifications, see [Multipart upload limits][3] in
14239
+ # the *Amazon S3 User Guide*.
14236
14240
  #
14237
14241
  # To ensure that data is not corrupted when traversing the network,
14238
14242
  # specify the `Content-MD5` header in the upload part request. Amazon S3
@@ -14243,7 +14247,7 @@ module Aws::S3
14243
14247
  # Web Services S3 uses the `x-amz-content-sha256` header as a checksum
14244
14248
  # instead of `Content-MD5`. For more information see [Authenticating
14245
14249
  # Requests: Using the Authorization Header (Amazon Web Services
14246
- # Signature Version 4)][3].
14250
+ # Signature Version 4)][4].
14247
14251
  #
14248
14252
  # **Note:** After you initiate multipart upload and upload one or more
14249
14253
  # parts, you must either complete or abort multipart upload in order to
@@ -14252,10 +14256,10 @@ module Aws::S3
14252
14256
  # parts storage and stops charging you for the parts storage.
14253
14257
  #
14254
14258
  # For more information on multipart uploads, go to [Multipart Upload
14255
- # Overview][4] in the <i>Amazon S3 User Guide </i>.
14259
+ # Overview][5] in the <i>Amazon S3 User Guide </i>.
14256
14260
  #
14257
14261
  # For information on the permissions required to use the multipart
14258
- # upload API, go to [Multipart Upload and Permissions][5] in the *Amazon
14262
+ # upload API, go to [Multipart Upload and Permissions][6] in the *Amazon
14259
14263
  # S3 User Guide*.
14260
14264
  #
14261
14265
  # You can optionally request server-side encryption where Amazon S3
@@ -14266,7 +14270,7 @@ module Aws::S3
14266
14270
  # encryption key, the request headers you provide in the request must
14267
14271
  # match the headers you used in the request to initiate the upload by
14268
14272
  # using [CreateMultipartUpload][2]. For more information, go to [Using
14269
- # Server-Side Encryption][6] in the *Amazon S3 User Guide*.
14273
+ # Server-Side Encryption][7] in the *Amazon S3 User Guide*.
14270
14274
  #
14271
14275
  # Server-side encryption is supported by the S3 Multipart Upload
14272
14276
  # actions. Unless you are using a customer-provided encryption key, you
@@ -14302,26 +14306,27 @@ module Aws::S3
14302
14306
  #
14303
14307
  # * [CreateMultipartUpload][2]
14304
14308
  #
14305
- # * [CompleteMultipartUpload][7]
14309
+ # * [CompleteMultipartUpload][8]
14306
14310
  #
14307
- # * [AbortMultipartUpload][8]
14311
+ # * [AbortMultipartUpload][9]
14308
14312
  #
14309
- # * [ListParts][9]
14313
+ # * [ListParts][10]
14310
14314
  #
14311
- # * [ListMultipartUploads][10]
14315
+ # * [ListMultipartUploads][11]
14312
14316
  #
14313
14317
  #
14314
14318
  #
14315
14319
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
14316
14320
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
14317
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
14318
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
14319
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
14320
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
14321
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
14322
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
14323
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
14324
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
14321
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
14322
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
14323
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
14324
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
14325
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
14326
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
14327
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
14328
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
14329
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
14325
14330
  #
14326
14331
  # @option params [String, StringIO, File] :body
14327
14332
  # Object data.
@@ -14551,9 +14556,9 @@ module Aws::S3
14551
14556
  # `x-amz-copy-source` in your request and a byte range by adding the
14552
14557
  # request header `x-amz-copy-source-range` in your request.
14553
14558
  #
14554
- # The minimum allowable part size for a multipart upload is 5 MB. For
14555
- # more information about multipart upload limits, go to [Quick Facts][1]
14556
- # in the *Amazon S3 User Guide*.
14559
+ # For information about maximum and minimum part sizes and other
14560
+ # multipart upload specifications, see [Multipart upload limits][1] in
14561
+ # the *Amazon S3 User Guide*.
14557
14562
  #
14558
14563
  # <note markdown="1"> Instead of using an existing object as part data, you might use the
14559
14564
  # [UploadPart][2] action and provide data in your request.
@@ -14664,7 +14669,7 @@ module Aws::S3
14664
14669
  #
14665
14670
  #
14666
14671
  #
14667
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/qfacts.html
14672
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
14668
14673
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
14669
14674
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
14670
14675
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
@@ -14844,45 +14849,45 @@ module Aws::S3
14844
14849
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
14845
14850
  #
14846
14851
  #
14847
- # @example Example: To upload a part by copying data from an existing object as data source
14852
+ # @example Example: To upload a part by copying byte range from an existing object as data source
14848
14853
  #
14849
- # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
14854
+ # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
14855
+ # # data source.
14850
14856
  #
14851
14857
  # resp = client.upload_part_copy({
14852
14858
  # bucket: "examplebucket",
14853
14859
  # copy_source: "/bucketname/sourceobjectkey",
14860
+ # copy_source_range: "bytes=1-100000",
14854
14861
  # key: "examplelargeobject",
14855
- # part_number: 1,
14862
+ # part_number: 2,
14856
14863
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
14857
14864
  # })
14858
14865
  #
14859
14866
  # resp.to_h outputs the following:
14860
14867
  # {
14861
14868
  # copy_part_result: {
14862
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
14863
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
14869
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
14870
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
14864
14871
  # },
14865
14872
  # }
14866
14873
  #
14867
- # @example Example: To upload a part by copying byte range from an existing object as data source
14874
+ # @example Example: To upload a part by copying data from an existing object as data source
14868
14875
  #
14869
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
14870
- # # data source.
14876
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
14871
14877
  #
14872
14878
  # resp = client.upload_part_copy({
14873
14879
  # bucket: "examplebucket",
14874
14880
  # copy_source: "/bucketname/sourceobjectkey",
14875
- # copy_source_range: "bytes=1-100000",
14876
14881
  # key: "examplelargeobject",
14877
- # part_number: 2,
14882
+ # part_number: 1,
14878
14883
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
14879
14884
  # })
14880
14885
  #
14881
14886
  # resp.to_h outputs the following:
14882
14887
  # {
14883
14888
  # copy_part_result: {
14884
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
14885
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
14889
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
14890
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
14886
14891
  # },
14887
14892
  # }
14888
14893
  #
@@ -15332,7 +15337,7 @@ module Aws::S3
15332
15337
  params: params,
15333
15338
  config: config)
15334
15339
  context[:gem_name] = 'aws-sdk-s3'
15335
- context[:gem_version] = '1.113.2'
15340
+ context[:gem_version] = '1.115.0'
15336
15341
  Seahorse::Client::Request.new(handlers, context)
15337
15342
  end
15338
15343