aws-sdk-s3 1.170.0 → 1.171.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: 8fbb9d2ce339539a64280ac5c819839aa6a25ab6bba04fe19081ea2474357985
4
- data.tar.gz: be626f4d8eeb71b48a1ac9a10f46352303cd350e9d6af29a64d9435efdcd9866
3
+ metadata.gz: 958d9e96cdee4392a5c72351830f6eb3708ff4b6f352165ebfe413e027821064
4
+ data.tar.gz: 6e8acf39da2fb4c9ad2829da587d6948af8e15b9fa4635ea716c60355fb44e5f
5
5
  SHA512:
6
- metadata.gz: b51f11c287ae4650f82e8d0b91fc89d798aeaea62c4082d495e64110faf27a6c02f0c095e29c55d01376e79f48b60c0b5fbaafe9b422083ca69f7609e30d84a8
7
- data.tar.gz: 57e5a2de576b43c9f05ed47a94f19dc9f806ef2d241252a24cd469601ba78c13a25a7eb21290571192afb73f60cb1df86cd8dbb35fb613d30e9016b005246e9c
6
+ metadata.gz: 22f2eac6252417eb3b8c66c4cd2379051858591524baff178cd9f9711bca49d2027e9e59847374b27d20af4b85b6ff61a20350a9115ba2fb043b0c490be7646d
7
+ data.tar.gz: 7976310bf6f27fd27a3247d63c56365163f2a976d65b56d040bc85874777eafad26311715b8f8bdab504e7229800e89c7e6efeaa7942e4fa258d4fb21a528d7e
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.171.0 (2024-11-14)
5
+ ------------------
6
+
7
+ * Feature - This release updates the ListBuckets API Reference documentation in support of the new 10,000 general purpose bucket default quota on all AWS accounts. To increase your bucket quota from 10,000 to up to 1 million buckets, simply request a quota increase via Service Quotas.
8
+
9
+ 1.170.1 (2024-11-11)
10
+ ------------------
11
+
12
+ * Issue - Tighten regex used to check for S3 200 errors.
13
+
4
14
  1.170.0 (2024-11-06)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.170.0
1
+ 1.171.0
@@ -571,7 +571,7 @@ module Aws::S3
571
571
  # in-progress multipart uploads are aborted or completed. To delete
572
572
  # these in-progress multipart uploads, use the `ListMultipartUploads`
573
573
  # operation to list the in-progress multipart uploads in the bucket
574
- # and use the `AbortMultupartUpload` operation to abort all the
574
+ # and use the `AbortMultipartUpload` operation to abort all the
575
575
  # in-progress multipart uploads.
576
576
  #
577
577
  # * **Directory buckets** - For directory buckets, you must make
@@ -8205,49 +8205,49 @@ module Aws::S3
8205
8205
  # * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
8206
8206
  #
8207
8207
  #
8208
- # @example Example: To retrieve a byte range of an object
8208
+ # @example Example: To retrieve an object
8209
8209
  #
8210
- # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
8211
- # # specific byte range.
8210
+ # # The following example retrieves an object for an S3 bucket.
8212
8211
  #
8213
8212
  # resp = client.get_object({
8214
8213
  # bucket: "examplebucket",
8215
- # key: "SampleFile.txt",
8216
- # range: "bytes=0-9",
8214
+ # key: "HappyFace.jpg",
8217
8215
  # })
8218
8216
  #
8219
8217
  # resp.to_h outputs the following:
8220
8218
  # {
8221
8219
  # accept_ranges: "bytes",
8222
- # content_length: 10,
8223
- # content_range: "bytes 0-9/43",
8224
- # content_type: "text/plain",
8225
- # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
8226
- # last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
8220
+ # content_length: 3191,
8221
+ # content_type: "image/jpeg",
8222
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8223
+ # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
8227
8224
  # metadata: {
8228
8225
  # },
8226
+ # tag_count: 2,
8229
8227
  # version_id: "null",
8230
8228
  # }
8231
8229
  #
8232
- # @example Example: To retrieve an object
8230
+ # @example Example: To retrieve a byte range of an object
8233
8231
  #
8234
- # # The following example retrieves an object for an S3 bucket.
8232
+ # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
8233
+ # # specific byte range.
8235
8234
  #
8236
8235
  # resp = client.get_object({
8237
8236
  # bucket: "examplebucket",
8238
- # key: "HappyFace.jpg",
8237
+ # key: "SampleFile.txt",
8238
+ # range: "bytes=0-9",
8239
8239
  # })
8240
8240
  #
8241
8241
  # resp.to_h outputs the following:
8242
8242
  # {
8243
8243
  # accept_ranges: "bytes",
8244
- # content_length: 3191,
8245
- # content_type: "image/jpeg",
8246
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8247
- # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
8244
+ # content_length: 10,
8245
+ # content_range: "bytes 0-9/43",
8246
+ # content_type: "text/plain",
8247
+ # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
8248
+ # last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
8248
8249
  # metadata: {
8249
8250
  # },
8250
- # tag_count: 2,
8251
8251
  # version_id: "null",
8252
8252
  # }
8253
8253
  #
@@ -9263,49 +9263,49 @@ module Aws::S3
9263
9263
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
9264
9264
  #
9265
9265
  #
9266
- # @example Example: To retrieve tag set of a specific object version
9266
+ # @example Example: To retrieve tag set of an object
9267
9267
  #
9268
- # # The following example retrieves tag set of an object. The request specifies object version.
9268
+ # # The following example retrieves tag set of an object.
9269
9269
  #
9270
9270
  # resp = client.get_object_tagging({
9271
9271
  # bucket: "examplebucket",
9272
- # key: "exampleobject",
9273
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9272
+ # key: "HappyFace.jpg",
9274
9273
  # })
9275
9274
  #
9276
9275
  # resp.to_h outputs the following:
9277
9276
  # {
9278
9277
  # tag_set: [
9279
9278
  # {
9280
- # key: "Key1",
9281
- # value: "Value1",
9279
+ # key: "Key4",
9280
+ # value: "Value4",
9281
+ # },
9282
+ # {
9283
+ # key: "Key3",
9284
+ # value: "Value3",
9282
9285
  # },
9283
9286
  # ],
9284
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9287
+ # version_id: "null",
9285
9288
  # }
9286
9289
  #
9287
- # @example Example: To retrieve tag set of an object
9290
+ # @example Example: To retrieve tag set of a specific object version
9288
9291
  #
9289
- # # The following example retrieves tag set of an object.
9292
+ # # The following example retrieves tag set of an object. The request specifies object version.
9290
9293
  #
9291
9294
  # resp = client.get_object_tagging({
9292
9295
  # bucket: "examplebucket",
9293
- # key: "HappyFace.jpg",
9296
+ # key: "exampleobject",
9297
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9294
9298
  # })
9295
9299
  #
9296
9300
  # resp.to_h outputs the following:
9297
9301
  # {
9298
9302
  # tag_set: [
9299
9303
  # {
9300
- # key: "Key4",
9301
- # value: "Value4",
9302
- # },
9303
- # {
9304
- # key: "Key3",
9305
- # value: "Value3",
9304
+ # key: "Key1",
9305
+ # value: "Value1",
9306
9306
  # },
9307
9307
  # ],
9308
- # version_id: "null",
9308
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9309
9309
  # }
9310
9310
  #
9311
9311
  # @example Request syntax with placeholder values
@@ -10123,7 +10123,7 @@ module Aws::S3
10123
10123
  # content_length: 3191,
10124
10124
  # content_type: "image/jpeg",
10125
10125
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
10126
- # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
10126
+ # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
10127
10127
  # metadata: {
10128
10128
  # },
10129
10129
  # version_id: "null",
@@ -10617,6 +10617,14 @@ module Aws::S3
10617
10617
  # For information about Amazon S3 buckets, see [Creating, configuring,
10618
10618
  # and working with Amazon S3 buckets][1].
10619
10619
  #
10620
+ # We strongly recommend using only paginated requests. Unpaginated
10621
+ # requests are only supported for Amazon Web Services accounts set to
10622
+ # the default general purpose bucket quota of 10,000. If you have an
10623
+ # approved general purpose bucket quota above 10,000, you must send
10624
+ # paginated requests to list your account’s buckets. All unpaginated
10625
+ # ListBuckets requests will be rejected for Amazon Web Services accounts
10626
+ # with a general purpose bucket quota greater than 10,000.
10627
+ #
10620
10628
  #
10621
10629
  #
10622
10630
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
@@ -10636,6 +10644,14 @@ module Aws::S3
10636
10644
  #
10637
10645
  # Required: No.
10638
10646
  #
10647
+ # <note markdown="1"> If you specify the `bucket-region`, `prefix`, or `continuation-token`
10648
+ # query parameters without using `max-buckets` to set the maximum number
10649
+ # of buckets returned in the response, Amazon S3 applies a default page
10650
+ # size of 10,000 and provides a continuation token if there are more
10651
+ # buckets.
10652
+ #
10653
+ # </note>
10654
+ #
10639
10655
  # @option params [String] :prefix
10640
10656
  # Limits the response to bucket names that begin with the specified
10641
10657
  # bucket name prefix.
@@ -10757,6 +10773,11 @@ module Aws::S3
10757
10773
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
10758
10774
  # `s3express-control.region.amazonaws.com`.
10759
10775
  #
10776
+ # <note markdown="1"> The `BucketRegion` response element is not part of the
10777
+ # `ListDirectoryBuckets` Response Syntax.
10778
+ #
10779
+ # </note>
10780
+ #
10760
10781
  #
10761
10782
  #
10762
10783
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
@@ -10815,7 +10836,7 @@ module Aws::S3
10815
10836
  # multipart uploads are aborted or completed. To delete these
10816
10837
  # in-progress multipart uploads, use the `ListMultipartUploads`
10817
10838
  # operation to list the in-progress multipart uploads in the bucket and
10818
- # use the `AbortMultupartUpload` operation to abort all the in-progress
10839
+ # use the `AbortMultipartUpload` operation to abort all the in-progress
10819
10840
  # multipart uploads.
10820
10841
  #
10821
10842
  # </note>
@@ -11101,97 +11122,97 @@ module Aws::S3
11101
11122
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
11102
11123
  #
11103
11124
  #
11104
- # @example Example: To list in-progress multipart uploads on a bucket
11125
+ # @example Example: List next set of multipart uploads when previous result is truncated
11105
11126
  #
11106
- # # The following example lists in-progress multipart uploads on a specific bucket.
11127
+ # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
11128
+ # # setup of multipart uploads.
11107
11129
  #
11108
11130
  # resp = client.list_multipart_uploads({
11109
11131
  # bucket: "examplebucket",
11132
+ # key_marker: "nextkeyfrompreviousresponse",
11133
+ # max_uploads: 2,
11134
+ # upload_id_marker: "valuefrompreviousresponse",
11110
11135
  # })
11111
11136
  #
11112
11137
  # resp.to_h outputs the following:
11113
11138
  # {
11139
+ # bucket: "acl1",
11140
+ # is_truncated: true,
11141
+ # key_marker: "",
11142
+ # max_uploads: 2,
11143
+ # next_key_marker: "someobjectkey",
11144
+ # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
11145
+ # upload_id_marker: "",
11114
11146
  # uploads: [
11115
11147
  # {
11116
11148
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
11117
11149
  # initiator: {
11118
- # display_name: "display-name",
11150
+ # display_name: "ownder-display-name",
11119
11151
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11120
11152
  # },
11121
11153
  # key: "JavaFile",
11122
11154
  # owner: {
11123
- # display_name: "display-name",
11124
- # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11155
+ # display_name: "mohanataws",
11156
+ # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11125
11157
  # },
11126
11158
  # storage_class: "STANDARD",
11127
- # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
11159
+ # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
11128
11160
  # },
11129
11161
  # {
11130
11162
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
11131
11163
  # initiator: {
11132
- # display_name: "display-name",
11164
+ # display_name: "ownder-display-name",
11133
11165
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11134
11166
  # },
11135
11167
  # key: "JavaFile",
11136
11168
  # owner: {
11137
- # display_name: "display-name",
11169
+ # display_name: "ownder-display-name",
11138
11170
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11139
11171
  # },
11140
11172
  # storage_class: "STANDARD",
11141
- # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
11173
+ # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
11142
11174
  # },
11143
11175
  # ],
11144
11176
  # }
11145
11177
  #
11146
- # @example Example: List next set of multipart uploads when previous result is truncated
11178
+ # @example Example: To list in-progress multipart uploads on a bucket
11147
11179
  #
11148
- # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
11149
- # # setup of multipart uploads.
11180
+ # # The following example lists in-progress multipart uploads on a specific bucket.
11150
11181
  #
11151
11182
  # resp = client.list_multipart_uploads({
11152
11183
  # bucket: "examplebucket",
11153
- # key_marker: "nextkeyfrompreviousresponse",
11154
- # max_uploads: 2,
11155
- # upload_id_marker: "valuefrompreviousresponse",
11156
11184
  # })
11157
11185
  #
11158
11186
  # resp.to_h outputs the following:
11159
11187
  # {
11160
- # bucket: "acl1",
11161
- # is_truncated: true,
11162
- # key_marker: "",
11163
- # max_uploads: 2,
11164
- # next_key_marker: "someobjectkey",
11165
- # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
11166
- # upload_id_marker: "",
11167
11188
  # uploads: [
11168
11189
  # {
11169
11190
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
11170
11191
  # initiator: {
11171
- # display_name: "ownder-display-name",
11192
+ # display_name: "display-name",
11172
11193
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11173
11194
  # },
11174
11195
  # key: "JavaFile",
11175
11196
  # owner: {
11176
- # display_name: "mohanataws",
11177
- # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11197
+ # display_name: "display-name",
11198
+ # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11178
11199
  # },
11179
11200
  # storage_class: "STANDARD",
11180
- # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
11201
+ # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
11181
11202
  # },
11182
11203
  # {
11183
11204
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
11184
11205
  # initiator: {
11185
- # display_name: "ownder-display-name",
11206
+ # display_name: "display-name",
11186
11207
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11187
11208
  # },
11188
11209
  # key: "JavaFile",
11189
11210
  # owner: {
11190
- # display_name: "ownder-display-name",
11211
+ # display_name: "display-name",
11191
11212
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
11192
11213
  # },
11193
11214
  # storage_class: "STANDARD",
11194
- # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
11215
+ # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
11195
11216
  # },
11196
11217
  # ],
11197
11218
  # }
@@ -16364,76 +16385,81 @@ module Aws::S3
16364
16385
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
16365
16386
  #
16366
16387
  #
16367
- # @example Example: To create an object.
16388
+ # @example Example: To upload an object and specify optional tags
16368
16389
  #
16369
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
16390
+ # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
16391
+ # # S3 returns version ID of the newly created object.
16370
16392
  #
16371
16393
  # resp = client.put_object({
16372
- # body: "filetoupload",
16394
+ # body: "c:\\HappyFace.jpg",
16373
16395
  # bucket: "examplebucket",
16374
- # key: "objectkey",
16396
+ # key: "HappyFace.jpg",
16397
+ # tagging: "key1=value1&key2=value2",
16375
16398
  # })
16376
16399
  #
16377
16400
  # resp.to_h outputs the following:
16378
16401
  # {
16379
16402
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16380
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
16403
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
16381
16404
  # }
16382
16405
  #
16383
- # @example Example: To upload object and specify user-defined metadata
16406
+ # @example Example: To upload an object and specify canned ACL.
16384
16407
  #
16385
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
16386
- # # enabled, S3 returns version ID in response.
16408
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
16409
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
16387
16410
  #
16388
16411
  # resp = client.put_object({
16412
+ # acl: "authenticated-read",
16389
16413
  # body: "filetoupload",
16390
16414
  # bucket: "examplebucket",
16391
16415
  # key: "exampleobject",
16392
- # metadata: {
16393
- # "metadata1" => "value1",
16394
- # "metadata2" => "value2",
16395
- # },
16396
16416
  # })
16397
16417
  #
16398
16418
  # resp.to_h outputs the following:
16399
16419
  # {
16400
16420
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16401
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16421
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
16402
16422
  # }
16403
16423
  #
16404
- # @example Example: To upload an object
16424
+ # @example Example: To upload an object and specify server-side encryption and object tags
16405
16425
  #
16406
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
16407
- # # syntax. S3 returns VersionId of the newly created object.
16426
+ # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
16427
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
16408
16428
  #
16409
16429
  # resp = client.put_object({
16410
- # body: "HappyFace.jpg",
16430
+ # body: "filetoupload",
16411
16431
  # bucket: "examplebucket",
16412
- # key: "HappyFace.jpg",
16432
+ # key: "exampleobject",
16433
+ # server_side_encryption: "AES256",
16434
+ # tagging: "key1=value1&key2=value2",
16413
16435
  # })
16414
16436
  #
16415
16437
  # resp.to_h outputs the following:
16416
16438
  # {
16417
16439
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16418
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16440
+ # server_side_encryption: "AES256",
16441
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16419
16442
  # }
16420
16443
  #
16421
- # @example Example: To upload an object and specify canned ACL.
16444
+ # @example Example: To upload object and specify user-defined metadata
16422
16445
  #
16423
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
16424
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
16446
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
16447
+ # # enabled, S3 returns version ID in response.
16425
16448
  #
16426
16449
  # resp = client.put_object({
16427
- # acl: "authenticated-read",
16428
16450
  # body: "filetoupload",
16429
16451
  # bucket: "examplebucket",
16430
16452
  # key: "exampleobject",
16453
+ # metadata: {
16454
+ # "metadata1" => "value1",
16455
+ # "metadata2" => "value2",
16456
+ # },
16431
16457
  # })
16432
16458
  #
16433
16459
  # resp.to_h outputs the following:
16434
16460
  # {
16435
16461
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16436
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
16462
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16437
16463
  # }
16438
16464
  #
16439
16465
  # @example Example: To upload an object (specify optional headers)
@@ -16456,42 +16482,37 @@ module Aws::S3
16456
16482
  # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16457
16483
  # }
16458
16484
  #
16459
- # @example Example: To upload an object and specify optional tags
16485
+ # @example Example: To create an object.
16460
16486
  #
16461
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
16462
- # # S3 returns version ID of the newly created object.
16487
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
16463
16488
  #
16464
16489
  # resp = client.put_object({
16465
- # body: "c:\\HappyFace.jpg",
16490
+ # body: "filetoupload",
16466
16491
  # bucket: "examplebucket",
16467
- # key: "HappyFace.jpg",
16468
- # tagging: "key1=value1&key2=value2",
16492
+ # key: "objectkey",
16469
16493
  # })
16470
16494
  #
16471
16495
  # resp.to_h outputs the following:
16472
16496
  # {
16473
16497
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16474
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
16498
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
16475
16499
  # }
16476
16500
  #
16477
- # @example Example: To upload an object and specify server-side encryption and object tags
16501
+ # @example Example: To upload an object
16478
16502
  #
16479
- # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
16480
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
16503
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
16504
+ # # syntax. S3 returns VersionId of the newly created object.
16481
16505
  #
16482
16506
  # resp = client.put_object({
16483
- # body: "filetoupload",
16507
+ # body: "HappyFace.jpg",
16484
16508
  # bucket: "examplebucket",
16485
- # key: "exampleobject",
16486
- # server_side_encryption: "AES256",
16487
- # tagging: "key1=value1&key2=value2",
16509
+ # key: "HappyFace.jpg",
16488
16510
  # })
16489
16511
  #
16490
16512
  # resp.to_h outputs the following:
16491
16513
  # {
16492
16514
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16493
- # server_side_encryption: "AES256",
16494
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16515
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16495
16516
  # }
16496
16517
  #
16497
16518
  # @example Streaming a file from disk
@@ -19345,45 +19366,45 @@ module Aws::S3
19345
19366
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
19346
19367
  #
19347
19368
  #
19348
- # @example Example: To upload a part by copying byte range from an existing object as data source
19369
+ # @example Example: To upload a part by copying data from an existing object as data source
19349
19370
  #
19350
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
19351
- # # data source.
19371
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
19352
19372
  #
19353
19373
  # resp = client.upload_part_copy({
19354
19374
  # bucket: "examplebucket",
19355
19375
  # copy_source: "/bucketname/sourceobjectkey",
19356
- # copy_source_range: "bytes=1-100000",
19357
19376
  # key: "examplelargeobject",
19358
- # part_number: 2,
19377
+ # part_number: 1,
19359
19378
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
19360
19379
  # })
19361
19380
  #
19362
19381
  # resp.to_h outputs the following:
19363
19382
  # {
19364
19383
  # copy_part_result: {
19365
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
19366
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
19384
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
19385
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
19367
19386
  # },
19368
19387
  # }
19369
19388
  #
19370
- # @example Example: To upload a part by copying data from an existing object as data source
19389
+ # @example Example: To upload a part by copying byte range from an existing object as data source
19371
19390
  #
19372
- # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
19391
+ # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
19392
+ # # data source.
19373
19393
  #
19374
19394
  # resp = client.upload_part_copy({
19375
19395
  # bucket: "examplebucket",
19376
19396
  # copy_source: "/bucketname/sourceobjectkey",
19397
+ # copy_source_range: "bytes=1-100000",
19377
19398
  # key: "examplelargeobject",
19378
- # part_number: 1,
19399
+ # part_number: 2,
19379
19400
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
19380
19401
  # })
19381
19402
  #
19382
19403
  # resp.to_h outputs the following:
19383
19404
  # {
19384
19405
  # copy_part_result: {
19385
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
19386
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
19406
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
19407
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
19387
19408
  # },
19388
19409
  # }
19389
19410
  #
@@ -19845,7 +19866,7 @@ module Aws::S3
19845
19866
  tracer: tracer
19846
19867
  )
19847
19868
  context[:gem_name] = 'aws-sdk-s3'
19848
- context[:gem_version] = '1.170.0'
19869
+ context[:gem_version] = '1.171.0'
19849
19870
  Seahorse::Client::Request.new(handlers, context)
19850
19871
  end
19851
19872
 
@@ -71,9 +71,9 @@ module Aws
71
71
 
72
72
  def check_for_error(context)
73
73
  xml = context.http_response.body_contents
74
- if xml.match(/\?>\s*<Error>/)
75
- error_code = xml.match(/<Code>(.+?)<\/Code>/)[1]
76
- error_message = xml.match(/<Message>(.+?)<\/Message>/)[1]
74
+ if xml.match(/<\?xml\s[^>]*\?>\s*<Error>/)
75
+ error_code = xml.match(%r{<Code>(.+?)</Code>})[1]
76
+ error_message = xml.match(%r{<Message>(.+?)</Message>})[1]
77
77
  S3::Errors.error_class(error_code).new(context, error_message)
78
78
  elsif incomplete_xml_body?(xml, context.operation.output)
79
79
  Seahorse::Client::NetworkingError.new(
@@ -9869,6 +9869,14 @@ module Aws::S3
9869
9869
  # Length Constraints: Minimum length of 0. Maximum length of 1024.
9870
9870
  #
9871
9871
  # Required: No.
9872
+ #
9873
+ # <note markdown="1"> If you specify the `bucket-region`, `prefix`, or
9874
+ # `continuation-token` query parameters without using `max-buckets` to
9875
+ # set the maximum number of buckets returned in the response, Amazon
9876
+ # S3 applies a default page size of 10,000 and provides a continuation
9877
+ # token if there are more buckets.
9878
+ #
9879
+ # </note>
9872
9880
  # @return [String]
9873
9881
  #
9874
9882
  # @!attribute [rw] prefix
data/lib/aws-sdk-s3.rb CHANGED
@@ -75,7 +75,7 @@ module Aws::S3
75
75
  autoload :ObjectVersion, 'aws-sdk-s3/object_version'
76
76
  autoload :EventStreams, 'aws-sdk-s3/event_streams'
77
77
 
78
- GEM_VERSION = '1.170.0'
78
+ GEM_VERSION = '1.171.0'
79
79
 
80
80
  end
81
81
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-s3
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.170.0
4
+ version: 1.171.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-11-06 00:00:00.000000000 Z
11
+ date: 2024-11-14 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-kms