aws-sdk-s3 1.113.2 → 1.114.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: dc4ed3965895fd8f673f79e9c405d272cd281f2fee60e6f78a791a0743c981fe
4
+ data.tar.gz: 2328ddf1594b50e642acfb659edc07fe02f35ad383948363699333e63e3b57ca
5
5
  SHA512:
6
- metadata.gz: 2e25bc0dd1c8249a1c5982cb36f1e06b8b8dc8c3c04e277cd2b9eff8bb3ed2fc4cfd2617ecdd8ea206881e066a02a0bccfc525258a5dc9b2b15a42ad1568a31b
7
- data.tar.gz: 9fb04f15c827cdcad16645bde85de0e2b9bdca01483acebc13d6ca8b163eeb21038882468a275b96e293f4c7be42ff481b9275c681d492925cc6e3469a05de02
6
+ metadata.gz: d35e6bd7c43c29a3bb8b31b4094a89608fac6ed9b3b13fd4da5fa37419f573215290346214d1c62747add1f352b43c405afb2c4b7e187ce267def725aa8b2ff1
7
+ data.tar.gz: b02f97001766edc02501290d135234ef99b45b54bf25560384887455a1f4dcec81b235aaa553e25e43cfe60c7cd8ef6a315ba44979b94fd0f6d2c2dc7a348404
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.114.0 (2022-05-03)
5
+ ------------------
6
+
7
+ * Feature - Documentation only update for doc bug fixes for the S3 API docs.
8
+
4
9
  1.113.2 (2022-04-26)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.113.2
1
+ 1.114.0
@@ -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
@@ -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({
@@ -6582,49 +6582,49 @@ module Aws::S3
6582
6582
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
6583
6583
  #
6584
6584
  #
6585
- # @example Example: To retrieve tag set of a specific object version
6585
+ # @example Example: To retrieve tag set of an object
6586
6586
  #
6587
- # # The following example retrieves tag set of an object. The request specifies object version.
6587
+ # # The following example retrieves tag set of an object.
6588
6588
  #
6589
6589
  # resp = client.get_object_tagging({
6590
6590
  # bucket: "examplebucket",
6591
- # key: "exampleobject",
6592
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6591
+ # key: "HappyFace.jpg",
6593
6592
  # })
6594
6593
  #
6595
6594
  # resp.to_h outputs the following:
6596
6595
  # {
6597
6596
  # tag_set: [
6598
6597
  # {
6599
- # key: "Key1",
6600
- # value: "Value1",
6598
+ # key: "Key4",
6599
+ # value: "Value4",
6600
+ # },
6601
+ # {
6602
+ # key: "Key3",
6603
+ # value: "Value3",
6601
6604
  # },
6602
6605
  # ],
6603
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6606
+ # version_id: "null",
6604
6607
  # }
6605
6608
  #
6606
- # @example Example: To retrieve tag set of an object
6609
+ # @example Example: To retrieve tag set of a specific object version
6607
6610
  #
6608
- # # The following example retrieves tag set of an object.
6611
+ # # The following example retrieves tag set of an object. The request specifies object version.
6609
6612
  #
6610
6613
  # resp = client.get_object_tagging({
6611
6614
  # bucket: "examplebucket",
6612
- # key: "HappyFace.jpg",
6615
+ # key: "exampleobject",
6616
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6613
6617
  # })
6614
6618
  #
6615
6619
  # resp.to_h outputs the following:
6616
6620
  # {
6617
6621
  # tag_set: [
6618
6622
  # {
6619
- # key: "Key4",
6620
- # value: "Value4",
6621
- # },
6622
- # {
6623
- # key: "Key3",
6624
- # value: "Value3",
6623
+ # key: "Key1",
6624
+ # value: "Value1",
6625
6625
  # },
6626
6626
  # ],
6627
- # version_id: "null",
6627
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6628
6628
  # }
6629
6629
  #
6630
6630
  # @example Request syntax with placeholder values
@@ -7817,97 +7817,97 @@ module Aws::S3
7817
7817
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7818
7818
  #
7819
7819
  #
7820
- # @example Example: To list in-progress multipart uploads on a bucket
7820
+ # @example Example: List next set of multipart uploads when previous result is truncated
7821
7821
  #
7822
- # # The following example lists in-progress multipart uploads on a specific bucket.
7822
+ # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
7823
+ # # setup of multipart uploads.
7823
7824
  #
7824
7825
  # resp = client.list_multipart_uploads({
7825
7826
  # bucket: "examplebucket",
7827
+ # key_marker: "nextkeyfrompreviousresponse",
7828
+ # max_uploads: 2,
7829
+ # upload_id_marker: "valuefrompreviousresponse",
7826
7830
  # })
7827
7831
  #
7828
7832
  # resp.to_h outputs the following:
7829
7833
  # {
7834
+ # bucket: "acl1",
7835
+ # is_truncated: true,
7836
+ # key_marker: "",
7837
+ # max_uploads: 2,
7838
+ # next_key_marker: "someobjectkey",
7839
+ # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7840
+ # upload_id_marker: "",
7830
7841
  # uploads: [
7831
7842
  # {
7832
7843
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
7833
7844
  # initiator: {
7834
- # display_name: "display-name",
7845
+ # display_name: "ownder-display-name",
7835
7846
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7836
7847
  # },
7837
7848
  # key: "JavaFile",
7838
7849
  # owner: {
7839
- # display_name: "display-name",
7840
- # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7850
+ # display_name: "mohanataws",
7851
+ # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7841
7852
  # },
7842
7853
  # storage_class: "STANDARD",
7843
- # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7854
+ # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7844
7855
  # },
7845
7856
  # {
7846
7857
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
7847
7858
  # initiator: {
7848
- # display_name: "display-name",
7859
+ # display_name: "ownder-display-name",
7849
7860
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7850
7861
  # },
7851
7862
  # key: "JavaFile",
7852
7863
  # owner: {
7853
- # display_name: "display-name",
7864
+ # display_name: "ownder-display-name",
7854
7865
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7855
7866
  # },
7856
7867
  # storage_class: "STANDARD",
7857
- # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7868
+ # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7858
7869
  # },
7859
7870
  # ],
7860
7871
  # }
7861
7872
  #
7862
- # @example Example: List next set of multipart uploads when previous result is truncated
7873
+ # @example Example: To list in-progress multipart uploads on a bucket
7863
7874
  #
7864
- # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
7865
- # # setup of multipart uploads.
7875
+ # # The following example lists in-progress multipart uploads on a specific bucket.
7866
7876
  #
7867
7877
  # resp = client.list_multipart_uploads({
7868
7878
  # bucket: "examplebucket",
7869
- # key_marker: "nextkeyfrompreviousresponse",
7870
- # max_uploads: 2,
7871
- # upload_id_marker: "valuefrompreviousresponse",
7872
7879
  # })
7873
7880
  #
7874
7881
  # resp.to_h outputs the following:
7875
7882
  # {
7876
- # bucket: "acl1",
7877
- # is_truncated: true,
7878
- # key_marker: "",
7879
- # max_uploads: 2,
7880
- # next_key_marker: "someobjectkey",
7881
- # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7882
- # upload_id_marker: "",
7883
7883
  # uploads: [
7884
7884
  # {
7885
7885
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
7886
7886
  # initiator: {
7887
- # display_name: "ownder-display-name",
7887
+ # display_name: "display-name",
7888
7888
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7889
7889
  # },
7890
7890
  # key: "JavaFile",
7891
7891
  # owner: {
7892
- # display_name: "mohanataws",
7893
- # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7892
+ # display_name: "display-name",
7893
+ # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7894
7894
  # },
7895
7895
  # storage_class: "STANDARD",
7896
- # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7896
+ # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7897
7897
  # },
7898
7898
  # {
7899
7899
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
7900
7900
  # initiator: {
7901
- # display_name: "ownder-display-name",
7901
+ # display_name: "display-name",
7902
7902
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7903
7903
  # },
7904
7904
  # key: "JavaFile",
7905
7905
  # owner: {
7906
- # display_name: "ownder-display-name",
7906
+ # display_name: "display-name",
7907
7907
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7908
7908
  # },
7909
7909
  # storage_class: "STANDARD",
7910
- # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7910
+ # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7911
7911
  # },
7912
7912
  # ],
7913
7913
  # }
@@ -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
@@ -12161,134 +12163,134 @@ module Aws::S3
12161
12163
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
12162
12164
  #
12163
12165
  #
12164
- # @example Example: To upload an object and specify optional tags
12166
+ # @example Example: To create an object.
12165
12167
  #
12166
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
12167
- # # S3 returns version ID of the newly created object.
12168
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
12168
12169
  #
12169
12170
  # resp = client.put_object({
12170
- # body: "c:\\HappyFace.jpg",
12171
+ # body: "filetoupload",
12171
12172
  # bucket: "examplebucket",
12172
- # key: "HappyFace.jpg",
12173
- # tagging: "key1=value1&key2=value2",
12173
+ # key: "objectkey",
12174
12174
  # })
12175
12175
  #
12176
12176
  # resp.to_h outputs the following:
12177
12177
  # {
12178
12178
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12179
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
12179
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
12180
12180
  # }
12181
12181
  #
12182
- # @example Example: To upload an object and specify canned ACL.
12182
+ # @example Example: To upload an object
12183
12183
  #
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.
12184
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
12185
+ # # syntax. S3 returns VersionId of the newly created object.
12186
12186
  #
12187
12187
  # resp = client.put_object({
12188
- # acl: "authenticated-read",
12189
- # body: "filetoupload",
12188
+ # body: "HappyFace.jpg",
12190
12189
  # bucket: "examplebucket",
12191
- # key: "exampleobject",
12190
+ # key: "HappyFace.jpg",
12192
12191
  # })
12193
12192
  #
12194
12193
  # resp.to_h outputs the following:
12195
12194
  # {
12196
12195
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12197
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
12196
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
12198
12197
  # }
12199
12198
  #
12200
- # @example Example: To upload an object and specify server-side encryption and object tags
12199
+ # @example Example: To upload object and specify user-defined metadata
12201
12200
  #
12202
- # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
12203
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
12201
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
12202
+ # # enabled, S3 returns version ID in response.
12204
12203
  #
12205
12204
  # resp = client.put_object({
12206
12205
  # body: "filetoupload",
12207
12206
  # bucket: "examplebucket",
12208
12207
  # key: "exampleobject",
12209
- # server_side_encryption: "AES256",
12210
- # tagging: "key1=value1&key2=value2",
12208
+ # metadata: {
12209
+ # "metadata1" => "value1",
12210
+ # "metadata2" => "value2",
12211
+ # },
12211
12212
  # })
12212
12213
  #
12213
12214
  # resp.to_h outputs the following:
12214
12215
  # {
12215
12216
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12216
- # server_side_encryption: "AES256",
12217
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
12217
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
12218
12218
  # }
12219
12219
  #
12220
- # @example Example: To create an object.
12220
+ # @example Example: To upload an object and specify optional tags
12221
12221
  #
12222
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
12222
+ # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
12223
+ # # S3 returns version ID of the newly created object.
12223
12224
  #
12224
12225
  # resp = client.put_object({
12225
- # body: "filetoupload",
12226
+ # body: "c:\\HappyFace.jpg",
12226
12227
  # bucket: "examplebucket",
12227
- # key: "objectkey",
12228
+ # key: "HappyFace.jpg",
12229
+ # tagging: "key1=value1&key2=value2",
12228
12230
  # })
12229
12231
  #
12230
12232
  # resp.to_h outputs the following:
12231
12233
  # {
12232
12234
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12233
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
12235
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
12234
12236
  # }
12235
12237
  #
12236
- # @example Example: To upload an object
12238
+ # @example Example: To upload an object (specify optional headers)
12237
12239
  #
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.
12240
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
12241
+ # # storage class and use server-side encryption.
12240
12242
  #
12241
12243
  # resp = client.put_object({
12242
12244
  # body: "HappyFace.jpg",
12243
12245
  # bucket: "examplebucket",
12244
12246
  # key: "HappyFace.jpg",
12247
+ # server_side_encryption: "AES256",
12248
+ # storage_class: "STANDARD_IA",
12245
12249
  # })
12246
12250
  #
12247
12251
  # resp.to_h outputs the following:
12248
12252
  # {
12249
12253
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12250
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
12254
+ # server_side_encryption: "AES256",
12255
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
12251
12256
  # }
12252
12257
  #
12253
- # @example Example: To upload an object (specify optional headers)
12258
+ # @example Example: To upload an object and specify server-side encryption and object tags
12254
12259
  #
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.
12260
+ # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
12261
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
12257
12262
  #
12258
12263
  # resp = client.put_object({
12259
- # body: "HappyFace.jpg",
12264
+ # body: "filetoupload",
12260
12265
  # bucket: "examplebucket",
12261
- # key: "HappyFace.jpg",
12266
+ # key: "exampleobject",
12262
12267
  # server_side_encryption: "AES256",
12263
- # storage_class: "STANDARD_IA",
12268
+ # tagging: "key1=value1&key2=value2",
12264
12269
  # })
12265
12270
  #
12266
12271
  # resp.to_h outputs the following:
12267
12272
  # {
12268
12273
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12269
12274
  # server_side_encryption: "AES256",
12270
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
12275
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
12271
12276
  # }
12272
12277
  #
12273
- # @example Example: To upload object and specify user-defined metadata
12278
+ # @example Example: To upload an object and specify canned ACL.
12274
12279
  #
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.
12280
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
12281
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
12277
12282
  #
12278
12283
  # resp = client.put_object({
12284
+ # acl: "authenticated-read",
12279
12285
  # body: "filetoupload",
12280
12286
  # bucket: "examplebucket",
12281
12287
  # key: "exampleobject",
12282
- # metadata: {
12283
- # "metadata1" => "value1",
12284
- # "metadata2" => "value2",
12285
- # },
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: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
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
@@ -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.114.0'
15336
15341
  Seahorse::Client::Request.new(handlers, context)
15337
15342
  end
15338
15343
 
@@ -66,7 +66,9 @@ module Aws::S3
66
66
  #
67
67
  # * If an object is created by either the Multipart Upload or Part Copy
68
68
  # operation, the ETag is not an MD5 digest, regardless of the method
69
- # of encryption.
69
+ # of encryption. If an object is larger than 16 MB, the Amazon Web
70
+ # Services Management Console will upload or copy that object as a
71
+ # Multipart Upload, and therefore the ETag will not be an MD5 digest.
70
72
  # @return [String]
71
73
  def etag
72
74
  data[:etag]
@@ -10202,9 +10202,10 @@ module Aws::S3
10202
10202
  #
10203
10203
  # @!attribute [rw] noncurrent_days
10204
10204
  # Specifies the number of days an object is noncurrent before Amazon
10205
- # S3 can perform the associated action. For information about the
10206
- # noncurrent days calculations, see [How Amazon S3 Calculates When an
10207
- # Object Became Noncurrent][1] in the *Amazon S3 User Guide*.
10205
+ # S3 can perform the associated action. The value must be a non-zero
10206
+ # positive integer. For information about the noncurrent days
10207
+ # calculations, see [How Amazon S3 Calculates When an Object Became
10208
+ # Noncurrent][1] in the *Amazon S3 User Guide*.
10208
10209
  #
10209
10210
  #
10210
10211
  #
@@ -10497,7 +10498,10 @@ module Aws::S3
10497
10498
  #
10498
10499
  # * If an object is created by either the Multipart Upload or Part
10499
10500
  # Copy operation, the ETag is not an MD5 digest, regardless of the
10500
- # method of encryption.
10501
+ # method of encryption. If an object is larger than 16 MB, the
10502
+ # Amazon Web Services Management Console will upload or copy that
10503
+ # object as a Multipart Upload, and therefore the ETag will not be
10504
+ # an MD5 digest.
10501
10505
  # @return [String]
10502
10506
  #
10503
10507
  # @!attribute [rw] checksum_algorithm
data/lib/aws-sdk-s3.rb CHANGED
@@ -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.113.2'
72
+ GEM_VERSION = '1.114.0'
73
73
 
74
74
  end
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.113.2
4
+ version: 1.114.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: 2022-04-26 00:00:00.000000000 Z
11
+ date: 2022-05-03 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-kms