aws-sdk-s3 1.89.0 → 1.91.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +729 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-s3.rb +2 -2
- data/lib/aws-sdk-s3/bucket.rb +4 -4
- data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
- data/lib/aws-sdk-s3/bucket_cors.rb +3 -2
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +1 -1
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +1 -1
- data/lib/aws-sdk-s3/bucket_logging.rb +1 -1
- data/lib/aws-sdk-s3/bucket_notification.rb +1 -1
- data/lib/aws-sdk-s3/bucket_policy.rb +1 -1
- data/lib/aws-sdk-s3/bucket_request_payment.rb +1 -1
- data/lib/aws-sdk-s3/bucket_tagging.rb +1 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +1 -1
- data/lib/aws-sdk-s3/bucket_website.rb +1 -1
- data/lib/aws-sdk-s3/client.rb +523 -527
- data/lib/aws-sdk-s3/client_api.rb +2 -1
- data/lib/aws-sdk-s3/errors.rb +1 -1
- data/lib/aws-sdk-s3/event_streams.rb +1 -1
- data/lib/aws-sdk-s3/multipart_upload.rb +1 -1
- data/lib/aws-sdk-s3/multipart_upload_part.rb +1 -1
- data/lib/aws-sdk-s3/object.rb +7 -7
- data/lib/aws-sdk-s3/object_acl.rb +1 -1
- data/lib/aws-sdk-s3/object_summary.rb +7 -7
- data/lib/aws-sdk-s3/object_version.rb +1 -1
- data/lib/aws-sdk-s3/resource.rb +1 -1
- data/lib/aws-sdk-s3/types.rb +216 -204
- data/lib/aws-sdk-s3/waiters.rb +1 -1
- metadata +6 -3
data/LICENSE.txt
ADDED
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
|
|
2
|
+
Apache License
|
|
3
|
+
Version 2.0, January 2004
|
|
4
|
+
http://www.apache.org/licenses/
|
|
5
|
+
|
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
7
|
+
|
|
8
|
+
1. Definitions.
|
|
9
|
+
|
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
12
|
+
|
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
14
|
+
the copyright owner that is granting the License.
|
|
15
|
+
|
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
17
|
+
other entities that control, are controlled by, or are under common
|
|
18
|
+
control with that entity. For the purposes of this definition,
|
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
20
|
+
direction or management of such entity, whether by contract or
|
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
23
|
+
|
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
25
|
+
exercising permissions granted by this License.
|
|
26
|
+
|
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
28
|
+
including but not limited to software source code, documentation
|
|
29
|
+
source, and configuration files.
|
|
30
|
+
|
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
|
32
|
+
transformation or translation of a Source form, including but
|
|
33
|
+
not limited to compiled object code, generated documentation,
|
|
34
|
+
and conversions to other media types.
|
|
35
|
+
|
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
37
|
+
Object form, made available under the License, as indicated by a
|
|
38
|
+
copyright notice that is included in or attached to the work
|
|
39
|
+
(an example is provided in the Appendix below).
|
|
40
|
+
|
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
47
|
+
the Work and Derivative Works thereof.
|
|
48
|
+
|
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
|
50
|
+
the original version of the Work and any modifications or additions
|
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
|
61
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
|
62
|
+
|
|
63
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
64
|
+
on behalf of whom a Contribution has been received by Licensor and
|
|
65
|
+
subsequently incorporated within the Work.
|
|
66
|
+
|
|
67
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
68
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
69
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
70
|
+
copyright license to reproduce, prepare Derivative Works of,
|
|
71
|
+
publicly display, publicly perform, sublicense, and distribute the
|
|
72
|
+
Work and such Derivative Works in Source or Object form.
|
|
73
|
+
|
|
74
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
|
75
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
76
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
77
|
+
(except as stated in this section) patent license to make, have made,
|
|
78
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
79
|
+
where such license applies only to those patent claims licensable
|
|
80
|
+
by such Contributor that are necessarily infringed by their
|
|
81
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
|
82
|
+
with the Work to which such Contribution(s) was submitted. If You
|
|
83
|
+
institute patent litigation against any entity (including a
|
|
84
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
85
|
+
or a Contribution incorporated within the Work constitutes direct
|
|
86
|
+
or contributory patent infringement, then any patent licenses
|
|
87
|
+
granted to You under this License for that Work shall terminate
|
|
88
|
+
as of the date such litigation is filed.
|
|
89
|
+
|
|
90
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
|
91
|
+
Work or Derivative Works thereof in any medium, with or without
|
|
92
|
+
modifications, and in Source or Object form, provided that You
|
|
93
|
+
meet the following conditions:
|
|
94
|
+
|
|
95
|
+
(a) You must give any other recipients of the Work or
|
|
96
|
+
Derivative Works a copy of this License; and
|
|
97
|
+
|
|
98
|
+
(b) You must cause any modified files to carry prominent notices
|
|
99
|
+
stating that You changed the files; and
|
|
100
|
+
|
|
101
|
+
(c) You must retain, in the Source form of any Derivative Works
|
|
102
|
+
that You distribute, all copyright, patent, trademark, and
|
|
103
|
+
attribution notices from the Source form of the Work,
|
|
104
|
+
excluding those notices that do not pertain to any part of
|
|
105
|
+
the Derivative Works; and
|
|
106
|
+
|
|
107
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
|
108
|
+
distribution, then any Derivative Works that You distribute must
|
|
109
|
+
include a readable copy of the attribution notices contained
|
|
110
|
+
within such NOTICE file, excluding those notices that do not
|
|
111
|
+
pertain to any part of the Derivative Works, in at least one
|
|
112
|
+
of the following places: within a NOTICE text file distributed
|
|
113
|
+
as part of the Derivative Works; within the Source form or
|
|
114
|
+
documentation, if provided along with the Derivative Works; or,
|
|
115
|
+
within a display generated by the Derivative Works, if and
|
|
116
|
+
wherever such third-party notices normally appear. The contents
|
|
117
|
+
of the NOTICE file are for informational purposes only and
|
|
118
|
+
do not modify the License. You may add Your own attribution
|
|
119
|
+
notices within Derivative Works that You distribute, alongside
|
|
120
|
+
or as an addendum to the NOTICE text from the Work, provided
|
|
121
|
+
that such additional attribution notices cannot be construed
|
|
122
|
+
as modifying the License.
|
|
123
|
+
|
|
124
|
+
You may add Your own copyright statement to Your modifications and
|
|
125
|
+
may provide additional or different license terms and conditions
|
|
126
|
+
for use, reproduction, or distribution of Your modifications, or
|
|
127
|
+
for any such Derivative Works as a whole, provided Your use,
|
|
128
|
+
reproduction, and distribution of the Work otherwise complies with
|
|
129
|
+
the conditions stated in this License.
|
|
130
|
+
|
|
131
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
132
|
+
any Contribution intentionally submitted for inclusion in the Work
|
|
133
|
+
by You to the Licensor shall be under the terms and conditions of
|
|
134
|
+
this License, without any additional terms or conditions.
|
|
135
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
|
136
|
+
the terms of any separate license agreement you may have executed
|
|
137
|
+
with Licensor regarding such Contributions.
|
|
138
|
+
|
|
139
|
+
6. Trademarks. This License does not grant permission to use the trade
|
|
140
|
+
names, trademarks, service marks, or product names of the Licensor,
|
|
141
|
+
except as required for reasonable and customary use in describing the
|
|
142
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
|
143
|
+
|
|
144
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
145
|
+
agreed to in writing, Licensor provides the Work (and each
|
|
146
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
147
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
148
|
+
implied, including, without limitation, any warranties or conditions
|
|
149
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
150
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
151
|
+
appropriateness of using or redistributing the Work and assume any
|
|
152
|
+
risks associated with Your exercise of permissions under this License.
|
|
153
|
+
|
|
154
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
|
155
|
+
whether in tort (including negligence), contract, or otherwise,
|
|
156
|
+
unless required by applicable law (such as deliberate and grossly
|
|
157
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
|
158
|
+
liable to You for damages, including any direct, indirect, special,
|
|
159
|
+
incidental, or consequential damages of any character arising as a
|
|
160
|
+
result of this License or out of the use or inability to use the
|
|
161
|
+
Work (including but not limited to damages for loss of goodwill,
|
|
162
|
+
work stoppage, computer failure or malfunction, or any and all
|
|
163
|
+
other commercial damages or losses), even if such Contributor
|
|
164
|
+
has been advised of the possibility of such damages.
|
|
165
|
+
|
|
166
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
|
167
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
|
168
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
169
|
+
or other liability obligations and/or rights consistent with this
|
|
170
|
+
License. However, in accepting such obligations, You may act only
|
|
171
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
|
172
|
+
of any other Contributor, and only if You agree to indemnify,
|
|
173
|
+
defend, and hold each Contributor harmless for any liability
|
|
174
|
+
incurred by, or claims asserted against, such Contributor by reason
|
|
175
|
+
of your accepting any such warranty or additional liability.
|
|
176
|
+
|
|
177
|
+
END OF TERMS AND CONDITIONS
|
|
178
|
+
|
|
179
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
180
|
+
|
|
181
|
+
To apply the Apache License to your work, attach the following
|
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
183
|
+
replaced with your own identifying information. (Don't include
|
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
185
|
+
comment syntax for the file format. We also recommend that a
|
|
186
|
+
file or class name and description of purpose be included on the
|
|
187
|
+
same "printed page" as the copyright notice for easier
|
|
188
|
+
identification within third-party archives.
|
|
189
|
+
|
|
190
|
+
Copyright [yyyy] [name of copyright owner]
|
|
191
|
+
|
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
193
|
+
you may not use this file except in compliance with the License.
|
|
194
|
+
You may obtain a copy of the License at
|
|
195
|
+
|
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
197
|
+
|
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
201
|
+
See the License for the specific language governing permissions and
|
|
202
|
+
limitations under the License.
|
data/VERSION
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
1.91.0
|
data/lib/aws-sdk-s3.rb
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -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.
|
|
72
|
+
GEM_VERSION = '1.91.0'
|
|
73
73
|
|
|
74
74
|
end
|
data/lib/aws-sdk-s3/bucket.rb
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -456,7 +456,7 @@ module Aws::S3
|
|
|
456
456
|
#
|
|
457
457
|
# This action is not supported by Amazon S3 on Outposts.
|
|
458
458
|
# @option options [required, String] :key
|
|
459
|
-
# Object key for which the PUT
|
|
459
|
+
# Object key for which the PUT action was initiated.
|
|
460
460
|
# @option options [Hash<String,String>] :metadata
|
|
461
461
|
# A map of metadata to store with the object in S3.
|
|
462
462
|
# @option options [String] :server_side_encryption
|
|
@@ -533,8 +533,8 @@ module Aws::S3
|
|
|
533
533
|
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
|
534
534
|
# for object encryption with SSE-KMS.
|
|
535
535
|
#
|
|
536
|
-
# Specifying this header with a PUT
|
|
537
|
-
#
|
|
536
|
+
# Specifying this header with a PUT action doesn’t affect bucket-level
|
|
537
|
+
# settings for S3 Bucket Key.
|
|
538
538
|
# @option options [String] :request_payer
|
|
539
539
|
# Confirms that the requester knows that they will be charged for the
|
|
540
540
|
# request. Bucket owners need not specify this parameter in their
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -198,6 +198,7 @@ module Aws::S3
|
|
|
198
198
|
# cors_configuration: { # required
|
|
199
199
|
# cors_rules: [ # required
|
|
200
200
|
# {
|
|
201
|
+
# id: "ID",
|
|
201
202
|
# allowed_headers: ["AllowedHeader"],
|
|
202
203
|
# allowed_methods: ["AllowedMethod"], # required
|
|
203
204
|
# allowed_origins: ["AllowedOrigin"], # required
|
|
@@ -213,7 +214,7 @@ module Aws::S3
|
|
|
213
214
|
# @option options [required, Types::CORSConfiguration] :cors_configuration
|
|
214
215
|
# Describes the cross-origin access configuration for objects in an
|
|
215
216
|
# Amazon S3 bucket. For more information, see [Enabling Cross-Origin
|
|
216
|
-
# Resource Sharing][1] in the *Amazon Simple Storage Service
|
|
217
|
+
# Resource Sharing][1] in the *Amazon Simple Storage Service User
|
|
217
218
|
# Guide*.
|
|
218
219
|
#
|
|
219
220
|
#
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
data/lib/aws-sdk-s3/client.rb
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -408,7 +408,7 @@ module Aws::S3
|
|
|
408
408
|
|
|
409
409
|
# @!group API Operations
|
|
410
410
|
|
|
411
|
-
# This
|
|
411
|
+
# This action aborts a multipart upload. After a multipart upload is
|
|
412
412
|
# aborted, no additional parts can be uploaded using that upload ID. The
|
|
413
413
|
# storage consumed by any previously uploaded parts will be freed.
|
|
414
414
|
# However, if any part uploads are currently in progress, those part
|
|
@@ -417,11 +417,11 @@ module Aws::S3
|
|
|
417
417
|
# completely free all storage consumed by all parts.
|
|
418
418
|
#
|
|
419
419
|
# To verify that all parts have been removed, so you don't get charged
|
|
420
|
-
# for the part storage, you should call the [ListParts][1]
|
|
420
|
+
# for the part storage, you should call the [ListParts][1] action and
|
|
421
421
|
# ensure that the parts list is empty.
|
|
422
422
|
#
|
|
423
|
-
# For information about permissions required to use the multipart
|
|
424
|
-
#
|
|
423
|
+
# For information about permissions required to use the multipart
|
|
424
|
+
# upload, see [Multipart Upload and Permissions][2].
|
|
425
425
|
#
|
|
426
426
|
# The following operations are related to `AbortMultipartUpload`\:
|
|
427
427
|
#
|
|
@@ -447,22 +447,22 @@ module Aws::S3
|
|
|
447
447
|
# @option params [required, String] :bucket
|
|
448
448
|
# The bucket name to which the upload was taking place.
|
|
449
449
|
#
|
|
450
|
-
# When using this
|
|
451
|
-
# the access point hostname. The access point hostname takes the form
|
|
450
|
+
# When using this action with an access point, you must direct requests
|
|
451
|
+
# to the access point hostname. The access point hostname takes the form
|
|
452
452
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
453
|
-
# When using this
|
|
454
|
-
#
|
|
453
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
454
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
455
455
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
456
456
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
457
457
|
#
|
|
458
|
-
# When using this
|
|
458
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
459
459
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
460
460
|
# takes the form
|
|
461
461
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
462
|
-
# When using this
|
|
463
|
-
#
|
|
464
|
-
#
|
|
465
|
-
#
|
|
462
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
463
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
464
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
465
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
466
466
|
#
|
|
467
467
|
#
|
|
468
468
|
#
|
|
@@ -537,11 +537,11 @@ module Aws::S3
|
|
|
537
537
|
#
|
|
538
538
|
# You first initiate the multipart upload and then upload all parts
|
|
539
539
|
# using the [UploadPart][1] operation. After successfully uploading all
|
|
540
|
-
# relevant parts of an upload, you call this
|
|
540
|
+
# relevant parts of an upload, you call this action to complete the
|
|
541
541
|
# upload. Upon receiving this request, Amazon S3 concatenates all the
|
|
542
542
|
# parts in ascending order by part number to create a new object. In the
|
|
543
543
|
# Complete Multipart Upload request, you must provide the parts list.
|
|
544
|
-
# You must ensure that the parts list is complete. This
|
|
544
|
+
# You must ensure that the parts list is complete. This action
|
|
545
545
|
# concatenates the parts that you provide in the list. For each part in
|
|
546
546
|
# the list, you must provide the part number and the `ETag` value,
|
|
547
547
|
# returned after that part was uploaded.
|
|
@@ -563,7 +563,7 @@ module Aws::S3
|
|
|
563
563
|
# Using Multipart Upload][3].
|
|
564
564
|
#
|
|
565
565
|
# For information about permissions required to use the multipart upload
|
|
566
|
-
# API, see [Multipart Upload
|
|
566
|
+
# API, see [Multipart Upload and Permissions][4].
|
|
567
567
|
#
|
|
568
568
|
# `CompleteMultipartUpload` has the following special errors:
|
|
569
569
|
#
|
|
@@ -737,8 +737,8 @@ module Aws::S3
|
|
|
737
737
|
#
|
|
738
738
|
# <note markdown="1"> You can store individual objects of up to 5 TB in Amazon S3. You
|
|
739
739
|
# create a copy of your object up to 5 GB in size in a single atomic
|
|
740
|
-
#
|
|
741
|
-
#
|
|
740
|
+
# action using this API. However, to copy an object greater than 5 GB,
|
|
741
|
+
# you must use the multipart upload Upload Part - Copy API. For more
|
|
742
742
|
# information, see [Copy Object Using the REST Multipart Upload API][1].
|
|
743
743
|
#
|
|
744
744
|
# </note>
|
|
@@ -752,12 +752,11 @@ module Aws::S3
|
|
|
752
752
|
#
|
|
753
753
|
# A copy request might return an error when Amazon S3 receives the copy
|
|
754
754
|
# request or while Amazon S3 is copying the files. If the error occurs
|
|
755
|
-
# before the copy
|
|
756
|
-
#
|
|
757
|
-
#
|
|
758
|
-
#
|
|
759
|
-
#
|
|
760
|
-
# appropriately.
|
|
755
|
+
# before the copy action starts, you receive a standard Amazon S3 error.
|
|
756
|
+
# If the error occurs during the copy operation, the error response is
|
|
757
|
+
# embedded in the `200 OK` response. This means that a `200 OK` response
|
|
758
|
+
# can contain either a success or an error. Design your application to
|
|
759
|
+
# parse the contents of the response and handle it appropriately.
|
|
761
760
|
#
|
|
762
761
|
# If the copy is successful, you receive a response with information
|
|
763
762
|
# about the copied object.
|
|
@@ -845,7 +844,7 @@ module Aws::S3
|
|
|
845
844
|
#
|
|
846
845
|
# If a target object uses SSE-KMS, you can enable an S3 Bucket Key for
|
|
847
846
|
# the object. For more information, see [Amazon S3 Bucket Keys][9] in
|
|
848
|
-
# the *Amazon Simple Storage Service
|
|
847
|
+
# the *Amazon Simple Storage Service User Guide*.
|
|
849
848
|
#
|
|
850
849
|
# **Access Control List (ACL)-Specific Request Headers**
|
|
851
850
|
#
|
|
@@ -859,8 +858,8 @@ module Aws::S3
|
|
|
859
858
|
#
|
|
860
859
|
# **Storage Class Options**
|
|
861
860
|
#
|
|
862
|
-
# You can use the `CopyObject`
|
|
863
|
-
#
|
|
861
|
+
# You can use the `CopyObject` action to change the storage class of an
|
|
862
|
+
# object that is already stored in Amazon S3 using the `StorageClass`
|
|
864
863
|
# parameter. For more information, see [Storage Classes][12] in the
|
|
865
864
|
# *Amazon S3 Service Developer Guide*.
|
|
866
865
|
#
|
|
@@ -896,7 +895,7 @@ module Aws::S3
|
|
|
896
895
|
#
|
|
897
896
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
|
|
898
897
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
|
899
|
-
# [3]:
|
|
898
|
+
# [3]: http://aws.amazon.com/s3/pricing/
|
|
900
899
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
|
|
901
900
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
|
902
901
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/amazon-s3-policy-keys.html
|
|
@@ -919,22 +918,22 @@ module Aws::S3
|
|
|
919
918
|
# @option params [required, String] :bucket
|
|
920
919
|
# The name of the destination bucket.
|
|
921
920
|
#
|
|
922
|
-
# When using this
|
|
923
|
-
# the access point hostname. The access point hostname takes the form
|
|
921
|
+
# When using this action with an access point, you must direct requests
|
|
922
|
+
# to the access point hostname. The access point hostname takes the form
|
|
924
923
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
925
|
-
# When using this
|
|
926
|
-
#
|
|
924
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
925
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
927
926
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
928
927
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
929
928
|
#
|
|
930
|
-
# When using this
|
|
929
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
931
930
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
932
931
|
# takes the form
|
|
933
932
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
934
|
-
# When using this
|
|
935
|
-
#
|
|
936
|
-
#
|
|
937
|
-
#
|
|
933
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
934
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
935
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
936
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
938
937
|
#
|
|
939
938
|
#
|
|
940
939
|
#
|
|
@@ -1116,8 +1115,8 @@ module Aws::S3
|
|
|
1116
1115
|
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
|
1117
1116
|
# for object encryption with SSE-KMS.
|
|
1118
1117
|
#
|
|
1119
|
-
# Specifying this header with a COPY
|
|
1120
|
-
#
|
|
1118
|
+
# Specifying this header with a COPY action doesn’t affect bucket-level
|
|
1119
|
+
# settings for S3 Bucket Key.
|
|
1121
1120
|
#
|
|
1122
1121
|
# @option params [String] :copy_source_sse_customer_algorithm
|
|
1123
1122
|
# Specifies the algorithm to use when decrypting the source object (for
|
|
@@ -1476,7 +1475,7 @@ module Aws::S3
|
|
|
1476
1475
|
req.send_request(options)
|
|
1477
1476
|
end
|
|
1478
1477
|
|
|
1479
|
-
# This
|
|
1478
|
+
# This action initiates a multipart upload and returns an upload ID.
|
|
1480
1479
|
# This upload ID is used to associate all of the parts in the specific
|
|
1481
1480
|
# multipart upload. You specify this upload ID in each of your
|
|
1482
1481
|
# subsequent upload part requests (see [UploadPart][1]). You also
|
|
@@ -1489,12 +1488,12 @@ module Aws::S3
|
|
|
1489
1488
|
# If you have configured a lifecycle rule to abort incomplete multipart
|
|
1490
1489
|
# uploads, the upload must complete within the number of days specified
|
|
1491
1490
|
# in the bucket lifecycle configuration. Otherwise, the incomplete
|
|
1492
|
-
# multipart upload becomes eligible for an abort
|
|
1491
|
+
# multipart upload becomes eligible for an abort action and Amazon S3
|
|
1493
1492
|
# aborts the multipart upload. For more information, see [Aborting
|
|
1494
1493
|
# Incomplete Multipart Uploads Using a Bucket Lifecycle Policy][3].
|
|
1495
1494
|
#
|
|
1496
1495
|
# For information about the permissions required to use the multipart
|
|
1497
|
-
# upload API, see [Multipart Upload
|
|
1496
|
+
# upload API, see [Multipart Upload and Permissions][4].
|
|
1498
1497
|
#
|
|
1499
1498
|
# For request signing, multipart upload is just a series of regular
|
|
1500
1499
|
# requests. You initiate a multipart upload, send one or more requests
|
|
@@ -1517,9 +1516,9 @@ module Aws::S3
|
|
|
1517
1516
|
# your own encryption key, or use AWS Key Management Service (AWS KMS)
|
|
1518
1517
|
# customer master keys (CMKs) or Amazon S3-managed encryption keys. If
|
|
1519
1518
|
# you choose to provide your own encryption key, the request headers you
|
|
1520
|
-
# provide in [UploadPart]
|
|
1521
|
-
#
|
|
1522
|
-
#
|
|
1519
|
+
# provide in [UploadPart][1] and [UploadPartCopy][6] requests must match
|
|
1520
|
+
# the headers you used in the request to initiate the upload by using
|
|
1521
|
+
# `CreateMultipartUpload`.
|
|
1523
1522
|
#
|
|
1524
1523
|
# To perform a multipart upload with encryption using an AWS KMS CMK,
|
|
1525
1524
|
# the requester must have permission to the `kms:Encrypt`,
|
|
@@ -1717,22 +1716,22 @@ module Aws::S3
|
|
|
1717
1716
|
# @option params [required, String] :bucket
|
|
1718
1717
|
# The name of the bucket to which to initiate the upload
|
|
1719
1718
|
#
|
|
1720
|
-
# When using this
|
|
1721
|
-
# the access point hostname. The access point hostname takes the form
|
|
1719
|
+
# When using this action with an access point, you must direct requests
|
|
1720
|
+
# to the access point hostname. The access point hostname takes the form
|
|
1722
1721
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
1723
|
-
# When using this
|
|
1724
|
-
#
|
|
1722
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
1723
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
1725
1724
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
1726
1725
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
1727
1726
|
#
|
|
1728
|
-
# When using this
|
|
1727
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
1729
1728
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
1730
1729
|
# takes the form
|
|
1731
1730
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
1732
|
-
# When using this
|
|
1733
|
-
#
|
|
1734
|
-
#
|
|
1735
|
-
#
|
|
1731
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
1732
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
1733
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
1734
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
1736
1735
|
#
|
|
1737
1736
|
#
|
|
1738
1737
|
#
|
|
@@ -1833,7 +1832,7 @@ module Aws::S3
|
|
|
1833
1832
|
#
|
|
1834
1833
|
#
|
|
1835
1834
|
#
|
|
1836
|
-
# [1]: https://docs.aws.amazon.com/
|
|
1835
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
|
|
1837
1836
|
#
|
|
1838
1837
|
# @option params [String] :ssekms_encryption_context
|
|
1839
1838
|
# Specifies the AWS KMS Encryption Context to use for object encryption.
|
|
@@ -1846,7 +1845,7 @@ module Aws::S3
|
|
|
1846
1845
|
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
|
1847
1846
|
# for object encryption with SSE-KMS.
|
|
1848
1847
|
#
|
|
1849
|
-
# Specifying this header with an object
|
|
1848
|
+
# Specifying this header with an object action doesn’t affect
|
|
1850
1849
|
# bucket-level settings for S3 Bucket Key.
|
|
1851
1850
|
#
|
|
1852
1851
|
# @option params [String] :request_payer
|
|
@@ -2091,7 +2090,7 @@ module Aws::S3
|
|
|
2091
2090
|
# default and can grant this permission to others.
|
|
2092
2091
|
#
|
|
2093
2092
|
# For information about `cors`, see [Enabling Cross-Origin Resource
|
|
2094
|
-
# Sharing][1] in the *Amazon Simple Storage Service
|
|
2093
|
+
# Sharing][1] in the *Amazon Simple Storage Service User Guide*.
|
|
2095
2094
|
#
|
|
2096
2095
|
# **Related Resources:**
|
|
2097
2096
|
#
|
|
@@ -2140,10 +2139,10 @@ module Aws::S3
|
|
|
2140
2139
|
req.send_request(options)
|
|
2141
2140
|
end
|
|
2142
2141
|
|
|
2143
|
-
# This implementation of the DELETE
|
|
2142
|
+
# This implementation of the DELETE action removes default encryption
|
|
2144
2143
|
# from the bucket. For information about the Amazon S3 default
|
|
2145
2144
|
# encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
|
|
2146
|
-
# the *Amazon Simple Storage Service
|
|
2145
|
+
# the *Amazon Simple Storage Service User Guide*.
|
|
2147
2146
|
#
|
|
2148
2147
|
# To use this operation, you must have permissions to perform the
|
|
2149
2148
|
# `s3:PutEncryptionConfiguration` action. The bucket owner has this
|
|
@@ -2151,7 +2150,7 @@ module Aws::S3
|
|
|
2151
2150
|
# others. For more information about permissions, see [Permissions
|
|
2152
2151
|
# Related to Bucket Subresource Operations][2] and [Managing Access
|
|
2153
2152
|
# Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
|
|
2154
|
-
# Storage Service
|
|
2153
|
+
# Storage Service User Guide*.
|
|
2155
2154
|
#
|
|
2156
2155
|
# **Related Resources**
|
|
2157
2156
|
#
|
|
@@ -2491,12 +2490,12 @@ module Aws::S3
|
|
|
2491
2490
|
req.send_request(options)
|
|
2492
2491
|
end
|
|
2493
2492
|
|
|
2494
|
-
# This implementation of the DELETE
|
|
2495
|
-
#
|
|
2496
|
-
#
|
|
2497
|
-
#
|
|
2498
|
-
#
|
|
2499
|
-
#
|
|
2493
|
+
# This implementation of the DELETE action uses the policy subresource
|
|
2494
|
+
# to delete the policy of a specified bucket. If you are using an
|
|
2495
|
+
# identity other than the root user of the AWS account that owns the
|
|
2496
|
+
# bucket, the calling identity must have the `DeleteBucketPolicy`
|
|
2497
|
+
# permissions on the specified bucket and belong to the bucket owner's
|
|
2498
|
+
# account to use this operation.
|
|
2500
2499
|
#
|
|
2501
2500
|
# If you don't have `DeleteBucketPolicy` permissions, Amazon S3 returns
|
|
2502
2501
|
# a `403 Access Denied` error. If you have the correct permissions, but
|
|
@@ -2508,19 +2507,19 @@ module Aws::S3
|
|
|
2508
2507
|
# denies the root user the ability to perform this action.
|
|
2509
2508
|
#
|
|
2510
2509
|
# For more information about bucket policies, see [Using Bucket Policies
|
|
2511
|
-
# and UserPolicies]
|
|
2512
|
-
# https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html).
|
|
2510
|
+
# and UserPolicies][1].
|
|
2513
2511
|
#
|
|
2514
2512
|
# The following operations are related to `DeleteBucketPolicy`
|
|
2515
2513
|
#
|
|
2516
|
-
# * [CreateBucket][
|
|
2514
|
+
# * [CreateBucket][2]
|
|
2517
2515
|
#
|
|
2518
|
-
# * [DeleteObject][
|
|
2516
|
+
# * [DeleteObject][3]
|
|
2519
2517
|
#
|
|
2520
2518
|
#
|
|
2521
2519
|
#
|
|
2522
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
2523
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
2520
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
|
2521
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
|
2522
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
|
2524
2523
|
#
|
|
2525
2524
|
# @option params [required, String] :bucket
|
|
2526
2525
|
# The bucket name.
|
|
@@ -2571,22 +2570,22 @@ module Aws::S3
|
|
|
2571
2570
|
#
|
|
2572
2571
|
# </note>
|
|
2573
2572
|
#
|
|
2574
|
-
# For information about replication configuration, see [Replication]
|
|
2575
|
-
#
|
|
2576
|
-
# the *Amazon S3 Developer Guide*.
|
|
2573
|
+
# For information about replication configuration, see [Replication][3]
|
|
2574
|
+
# in the *Amazon S3 Developer Guide*.
|
|
2577
2575
|
#
|
|
2578
2576
|
# The following operations are related to `DeleteBucketReplication`\:
|
|
2579
2577
|
#
|
|
2580
|
-
# * [PutBucketReplication][
|
|
2578
|
+
# * [PutBucketReplication][4]
|
|
2581
2579
|
#
|
|
2582
|
-
# * [GetBucketReplication][
|
|
2580
|
+
# * [GetBucketReplication][5]
|
|
2583
2581
|
#
|
|
2584
2582
|
#
|
|
2585
2583
|
#
|
|
2586
2584
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
2587
2585
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
|
2588
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
2589
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
2586
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
|
|
2587
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
|
|
2588
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
|
|
2590
2589
|
#
|
|
2591
2590
|
# @option params [required, String] :bucket
|
|
2592
2591
|
# The bucket name.
|
|
@@ -2675,18 +2674,18 @@ module Aws::S3
|
|
|
2675
2674
|
req.send_request(options)
|
|
2676
2675
|
end
|
|
2677
2676
|
|
|
2678
|
-
# This
|
|
2679
|
-
#
|
|
2677
|
+
# This action removes the website configuration for a bucket. Amazon S3
|
|
2678
|
+
# returns a `200 OK` response upon successfully deleting a website
|
|
2680
2679
|
# configuration on the specified bucket. You will get a `200 OK`
|
|
2681
2680
|
# response if the website configuration you are trying to delete does
|
|
2682
2681
|
# not exist on the bucket. Amazon S3 returns a `404` response if the
|
|
2683
2682
|
# bucket specified in the request does not exist.
|
|
2684
2683
|
#
|
|
2685
|
-
# This DELETE
|
|
2686
|
-
#
|
|
2687
|
-
#
|
|
2688
|
-
#
|
|
2689
|
-
#
|
|
2684
|
+
# This DELETE action requires the `S3:DeleteBucketWebsite` permission.
|
|
2685
|
+
# By default, only the bucket owner can delete the website configuration
|
|
2686
|
+
# attached to a bucket. However, bucket owners can grant other users
|
|
2687
|
+
# permission to delete the website configuration by writing a bucket
|
|
2688
|
+
# policy granting them the `S3:DeleteBucketWebsite` permission.
|
|
2690
2689
|
#
|
|
2691
2690
|
# For more information about hosting websites, see [Hosting Websites on
|
|
2692
2691
|
# Amazon S3][1].
|
|
@@ -2757,14 +2756,14 @@ module Aws::S3
|
|
|
2757
2756
|
# For more information about MFA Delete, see [Using MFA Delete][1]. To
|
|
2758
2757
|
# see sample requests that use versioning, see [Sample Request][2].
|
|
2759
2758
|
#
|
|
2760
|
-
# You can delete objects by explicitly calling
|
|
2759
|
+
# You can delete objects by explicitly calling DELETE Object or
|
|
2761
2760
|
# configure its lifecycle ([PutBucketLifecycle][3]) to enable Amazon S3
|
|
2762
2761
|
# to remove them for you. If you want to block users or accounts from
|
|
2763
2762
|
# removing or deleting objects from your bucket, you must deny them the
|
|
2764
2763
|
# `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
|
|
2765
2764
|
# `s3:PutLifeCycleConfiguration` actions.
|
|
2766
2765
|
#
|
|
2767
|
-
# The following
|
|
2766
|
+
# The following action is related to `DeleteObject`\:
|
|
2768
2767
|
#
|
|
2769
2768
|
# * [PutObject][4]
|
|
2770
2769
|
#
|
|
@@ -2780,22 +2779,22 @@ module Aws::S3
|
|
|
2780
2779
|
# @option params [required, String] :bucket
|
|
2781
2780
|
# The bucket name of the bucket containing the object.
|
|
2782
2781
|
#
|
|
2783
|
-
# When using this
|
|
2784
|
-
# the access point hostname. The access point hostname takes the form
|
|
2782
|
+
# When using this action with an access point, you must direct requests
|
|
2783
|
+
# to the access point hostname. The access point hostname takes the form
|
|
2785
2784
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
2786
|
-
# When using this
|
|
2787
|
-
#
|
|
2785
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
2786
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
2788
2787
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
2789
2788
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
2790
2789
|
#
|
|
2791
|
-
# When using this
|
|
2790
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
2792
2791
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
2793
2792
|
# takes the form
|
|
2794
2793
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
2795
|
-
# When using this
|
|
2796
|
-
#
|
|
2797
|
-
#
|
|
2798
|
-
#
|
|
2794
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
2795
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
2796
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
2797
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
2799
2798
|
#
|
|
2800
2799
|
#
|
|
2801
2800
|
#
|
|
@@ -2916,22 +2915,22 @@ module Aws::S3
|
|
|
2916
2915
|
# @option params [required, String] :bucket
|
|
2917
2916
|
# The bucket name containing the objects from which to remove the tags.
|
|
2918
2917
|
#
|
|
2919
|
-
# When using this
|
|
2920
|
-
# the access point hostname. The access point hostname takes the form
|
|
2918
|
+
# When using this action with an access point, you must direct requests
|
|
2919
|
+
# to the access point hostname. The access point hostname takes the form
|
|
2921
2920
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
2922
|
-
# When using this
|
|
2923
|
-
#
|
|
2921
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
2922
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
2924
2923
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
2925
2924
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
2926
2925
|
#
|
|
2927
|
-
# When using this
|
|
2926
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
2928
2927
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
2929
2928
|
# takes the form
|
|
2930
2929
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
2931
|
-
# When using this
|
|
2932
|
-
#
|
|
2933
|
-
#
|
|
2934
|
-
#
|
|
2930
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
2931
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
2932
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
2933
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
2935
2934
|
#
|
|
2936
2935
|
#
|
|
2937
2936
|
#
|
|
@@ -3008,27 +3007,27 @@ module Aws::S3
|
|
|
3008
3007
|
req.send_request(options)
|
|
3009
3008
|
end
|
|
3010
3009
|
|
|
3011
|
-
# This
|
|
3012
|
-
#
|
|
3013
|
-
#
|
|
3014
|
-
#
|
|
3010
|
+
# This action enables you to delete multiple objects from a bucket using
|
|
3011
|
+
# a single HTTP request. If you know the object keys that you want to
|
|
3012
|
+
# delete, then this action provides a suitable alternative to sending
|
|
3013
|
+
# individual delete requests, reducing per-request overhead.
|
|
3015
3014
|
#
|
|
3016
3015
|
# The request contains a list of up to 1000 keys that you want to
|
|
3017
3016
|
# delete. In the XML, you provide the object key names, and optionally,
|
|
3018
3017
|
# version IDs if you want to delete a specific version of the object
|
|
3019
3018
|
# from a versioning-enabled bucket. For each key, Amazon S3 performs a
|
|
3020
|
-
# delete
|
|
3019
|
+
# delete action and returns the result of that delete, success, or
|
|
3021
3020
|
# failure, in the response. Note that if the object specified in the
|
|
3022
3021
|
# request is not found, Amazon S3 returns the result as deleted.
|
|
3023
3022
|
#
|
|
3024
|
-
# The
|
|
3025
|
-
#
|
|
3026
|
-
#
|
|
3027
|
-
#
|
|
3028
|
-
#
|
|
3029
|
-
#
|
|
3023
|
+
# The action supports two modes for the response: verbose and quiet. By
|
|
3024
|
+
# default, the action uses verbose mode in which the response includes
|
|
3025
|
+
# the result of deletion of each key in your request. In quiet mode the
|
|
3026
|
+
# response includes only keys where the delete action encountered an
|
|
3027
|
+
# error. For a successful deletion, the action does not return any
|
|
3028
|
+
# information about the delete in the response body.
|
|
3030
3029
|
#
|
|
3031
|
-
# When performing this
|
|
3030
|
+
# When performing this action on an MFA Delete enabled bucket, that
|
|
3032
3031
|
# attempts to delete any versioned objects, you must include an MFA
|
|
3033
3032
|
# token. If you do not provide one, the entire request will fail, even
|
|
3034
3033
|
# if there are non-versioned objects you are trying to delete. If you
|
|
@@ -3064,22 +3063,22 @@ module Aws::S3
|
|
|
3064
3063
|
# @option params [required, String] :bucket
|
|
3065
3064
|
# The bucket name containing the objects to delete.
|
|
3066
3065
|
#
|
|
3067
|
-
# When using this
|
|
3068
|
-
# the access point hostname. The access point hostname takes the form
|
|
3066
|
+
# When using this action with an access point, you must direct requests
|
|
3067
|
+
# to the access point hostname. The access point hostname takes the form
|
|
3069
3068
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
3070
|
-
# When using this
|
|
3071
|
-
#
|
|
3069
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
3070
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
3072
3071
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
3073
3072
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
3074
3073
|
#
|
|
3075
|
-
# When using this
|
|
3074
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
3076
3075
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
3077
3076
|
# takes the form
|
|
3078
3077
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
3079
|
-
# When using this
|
|
3080
|
-
#
|
|
3081
|
-
#
|
|
3082
|
-
#
|
|
3078
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
3079
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
3080
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
3081
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
3083
3082
|
#
|
|
3084
3083
|
#
|
|
3085
3084
|
#
|
|
@@ -3290,7 +3289,7 @@ module Aws::S3
|
|
|
3290
3289
|
req.send_request(options)
|
|
3291
3290
|
end
|
|
3292
3291
|
|
|
3293
|
-
# This implementation of the GET
|
|
3292
|
+
# This implementation of the GET action uses the `accelerate`
|
|
3294
3293
|
# subresource to return the Transfer Acceleration state of a bucket,
|
|
3295
3294
|
# which is either `Enabled` or `Suspended`. Amazon S3 Transfer
|
|
3296
3295
|
# Acceleration is a bucket-level feature that enables you to perform
|
|
@@ -3302,7 +3301,7 @@ module Aws::S3
|
|
|
3302
3301
|
# others. For more information about permissions, see [Permissions
|
|
3303
3302
|
# Related to Bucket Subresource Operations][1] and [Managing Access
|
|
3304
3303
|
# Permissions to your Amazon S3 Resources][2] in the *Amazon Simple
|
|
3305
|
-
# Storage Service
|
|
3304
|
+
# Storage Service User Guide*.
|
|
3306
3305
|
#
|
|
3307
3306
|
# You set the Transfer Acceleration state of an existing bucket to
|
|
3308
3307
|
# `Enabled` or `Suspended` by using the
|
|
@@ -3313,7 +3312,7 @@ module Aws::S3
|
|
|
3313
3312
|
# Acceleration state if a state has never been set on the bucket.
|
|
3314
3313
|
#
|
|
3315
3314
|
# For more information about transfer acceleration, see [Transfer
|
|
3316
|
-
# Acceleration][4] in the Amazon Simple Storage Service
|
|
3315
|
+
# Acceleration][4] in the Amazon Simple Storage Service User Guide.
|
|
3317
3316
|
#
|
|
3318
3317
|
# **Related Resources**
|
|
3319
3318
|
#
|
|
@@ -3361,8 +3360,8 @@ module Aws::S3
|
|
|
3361
3360
|
req.send_request(options)
|
|
3362
3361
|
end
|
|
3363
3362
|
|
|
3364
|
-
# This implementation of the `GET`
|
|
3365
|
-
#
|
|
3363
|
+
# This implementation of the `GET` action uses the `acl` subresource to
|
|
3364
|
+
# return the access control list (ACL) of a bucket. To use `GET` to
|
|
3366
3365
|
# return the ACL of the bucket, you must have `READ_ACP` access to the
|
|
3367
3366
|
# bucket. If `READ_ACP` permission is granted to the anonymous user, you
|
|
3368
3367
|
# can return the ACL of the bucket without using an authorization
|
|
@@ -3419,7 +3418,7 @@ module Aws::S3
|
|
|
3419
3418
|
req.send_request(options)
|
|
3420
3419
|
end
|
|
3421
3420
|
|
|
3422
|
-
# This implementation of the GET
|
|
3421
|
+
# This implementation of the GET action returns an analytics
|
|
3423
3422
|
# configuration (identified by the analytics configuration ID) from the
|
|
3424
3423
|
# bucket.
|
|
3425
3424
|
#
|
|
@@ -3429,11 +3428,11 @@ module Aws::S3
|
|
|
3429
3428
|
# others. For more information about permissions, see [ Permissions
|
|
3430
3429
|
# Related to Bucket Subresource Operations][1] and [Managing Access
|
|
3431
3430
|
# Permissions to Your Amazon S3 Resources][2] in the *Amazon Simple
|
|
3432
|
-
# Storage Service
|
|
3431
|
+
# Storage Service User Guide*.
|
|
3433
3432
|
#
|
|
3434
3433
|
# For information about Amazon S3 analytics feature, see [Amazon S3
|
|
3435
3434
|
# Analytics – Storage Class Analysis][3] in the *Amazon Simple Storage
|
|
3436
|
-
# Service
|
|
3435
|
+
# Service User Guide*.
|
|
3437
3436
|
#
|
|
3438
3437
|
# **Related Resources**
|
|
3439
3438
|
#
|
|
@@ -3571,6 +3570,7 @@ module Aws::S3
|
|
|
3571
3570
|
# @example Response structure
|
|
3572
3571
|
#
|
|
3573
3572
|
# resp.cors_rules #=> Array
|
|
3573
|
+
# resp.cors_rules[0].id #=> String
|
|
3574
3574
|
# resp.cors_rules[0].allowed_headers #=> Array
|
|
3575
3575
|
# resp.cors_rules[0].allowed_headers[0] #=> String
|
|
3576
3576
|
# resp.cors_rules[0].allowed_methods #=> Array
|
|
@@ -3931,7 +3931,7 @@ module Aws::S3
|
|
|
3931
3931
|
# API. The response describes the new filter element that you can use to
|
|
3932
3932
|
# specify a filter to select a subset of objects to which the rule
|
|
3933
3933
|
# applies. If you are using a previous version of the lifecycle
|
|
3934
|
-
# configuration, it still works. For the earlier
|
|
3934
|
+
# configuration, it still works. For the earlier action, see
|
|
3935
3935
|
# [GetBucketLifecycle][1].
|
|
3936
3936
|
#
|
|
3937
3937
|
# </note>
|
|
@@ -4367,8 +4367,8 @@ module Aws::S3
|
|
|
4367
4367
|
|
|
4368
4368
|
# Returns the notification configuration of a bucket.
|
|
4369
4369
|
#
|
|
4370
|
-
# If notifications are not enabled on the bucket, the
|
|
4371
|
-
#
|
|
4370
|
+
# If notifications are not enabled on the bucket, the action returns an
|
|
4371
|
+
# empty `NotificationConfiguration` element.
|
|
4372
4372
|
#
|
|
4373
4373
|
# By default, you must be the bucket owner to read the notification
|
|
4374
4374
|
# configuration of a bucket. However, the bucket owner can use a bucket
|
|
@@ -4380,7 +4380,7 @@ module Aws::S3
|
|
|
4380
4380
|
# Events][1]. For more information about bucket policies, see [Using
|
|
4381
4381
|
# Bucket Policies][2].
|
|
4382
4382
|
#
|
|
4383
|
-
# The following
|
|
4383
|
+
# The following action is related to `GetBucketNotification`\:
|
|
4384
4384
|
#
|
|
4385
4385
|
# * [PutBucketNotification][3]
|
|
4386
4386
|
#
|
|
@@ -4521,7 +4521,7 @@ module Aws::S3
|
|
|
4521
4521
|
# For more information about bucket policies, see [Using Bucket Policies
|
|
4522
4522
|
# and User Policies][1].
|
|
4523
4523
|
#
|
|
4524
|
-
# The following
|
|
4524
|
+
# The following action is related to `GetBucketPolicy`\:
|
|
4525
4525
|
#
|
|
4526
4526
|
# * [GetObject][2]
|
|
4527
4527
|
#
|
|
@@ -4648,9 +4648,9 @@ module Aws::S3
|
|
|
4648
4648
|
# </note>
|
|
4649
4649
|
#
|
|
4650
4650
|
# For information about replication configuration, see [Replication][1]
|
|
4651
|
-
# in the *Amazon Simple Storage Service
|
|
4651
|
+
# in the *Amazon Simple Storage Service User Guide*.
|
|
4652
4652
|
#
|
|
4653
|
-
# This
|
|
4653
|
+
# This action requires permissions for the
|
|
4654
4654
|
# `s3:GetReplicationConfiguration` action. For more information about
|
|
4655
4655
|
# permissions, see [Using Bucket Policies and User Policies][2].
|
|
4656
4656
|
#
|
|
@@ -4980,7 +4980,7 @@ module Aws::S3
|
|
|
4980
4980
|
# configuration. For more information about hosting websites, see
|
|
4981
4981
|
# [Hosting Websites on Amazon S3][1].
|
|
4982
4982
|
#
|
|
4983
|
-
# This GET
|
|
4983
|
+
# This GET action requires the `S3:GetBucketWebsite` permission. By
|
|
4984
4984
|
# default, only the bucket owner can read the bucket website
|
|
4985
4985
|
# configuration. However, bucket owners can allow other users to read
|
|
4986
4986
|
# the website configuration by writing a bucket policy granting them the
|
|
@@ -5092,9 +5092,9 @@ module Aws::S3
|
|
|
5092
5092
|
# Glacier Deep Archive storage class, or S3 Intelligent-Tiering Archive
|
|
5093
5093
|
# or S3 Intelligent-Tiering Deep Archive tiers, before you can retrieve
|
|
5094
5094
|
# the object you must first restore a copy using [RestoreObject][4].
|
|
5095
|
-
# Otherwise, this
|
|
5096
|
-
#
|
|
5097
|
-
#
|
|
5095
|
+
# Otherwise, this action returns an `InvalidObjectStateError` error. For
|
|
5096
|
+
# information about restoring archived objects, see [Restoring Archived
|
|
5097
|
+
# Objects][5].
|
|
5098
5098
|
#
|
|
5099
5099
|
# Encryption request headers, like `x-amz-server-side-encryption`,
|
|
5100
5100
|
# should not be sent for GET requests if your object uses server-side
|
|
@@ -5138,9 +5138,8 @@ module Aws::S3
|
|
|
5138
5138
|
#
|
|
5139
5139
|
# **Versioning**
|
|
5140
5140
|
#
|
|
5141
|
-
# By default, the GET
|
|
5142
|
-
#
|
|
5143
|
-
# subresource.
|
|
5141
|
+
# By default, the GET action returns the current version of an object.
|
|
5142
|
+
# To return a different version, use the `versionId` subresource.
|
|
5144
5143
|
#
|
|
5145
5144
|
# <note markdown="1"> If the current version of the object is a delete marker, Amazon S3
|
|
5146
5145
|
# behaves as if the object was deleted and includes
|
|
@@ -5225,22 +5224,22 @@ module Aws::S3
|
|
|
5225
5224
|
# @option params [required, String] :bucket
|
|
5226
5225
|
# The bucket name containing the object.
|
|
5227
5226
|
#
|
|
5228
|
-
# When using this
|
|
5229
|
-
# the access point hostname. The access point hostname takes the form
|
|
5227
|
+
# When using this action with an access point, you must direct requests
|
|
5228
|
+
# to the access point hostname. The access point hostname takes the form
|
|
5230
5229
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
5231
|
-
# When using this
|
|
5232
|
-
#
|
|
5230
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
5231
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
5233
5232
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
5234
5233
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
5235
5234
|
#
|
|
5236
|
-
# When using this
|
|
5235
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
5237
5236
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
5238
5237
|
# takes the form
|
|
5239
5238
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
5240
|
-
# When using this
|
|
5241
|
-
#
|
|
5242
|
-
#
|
|
5243
|
-
#
|
|
5239
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
5240
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
5241
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
5242
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
5244
5243
|
#
|
|
5245
5244
|
#
|
|
5246
5245
|
#
|
|
@@ -5376,49 +5375,49 @@ module Aws::S3
|
|
|
5376
5375
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
|
5377
5376
|
#
|
|
5378
5377
|
#
|
|
5379
|
-
# @example Example: To retrieve an object
|
|
5378
|
+
# @example Example: To retrieve a byte range of an object
|
|
5380
5379
|
#
|
|
5381
|
-
# # The following example retrieves an object for an S3 bucket.
|
|
5380
|
+
# # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
|
|
5381
|
+
# # specific byte range.
|
|
5382
5382
|
#
|
|
5383
5383
|
# resp = client.get_object({
|
|
5384
5384
|
# bucket: "examplebucket",
|
|
5385
|
-
# key: "
|
|
5385
|
+
# key: "SampleFile.txt",
|
|
5386
|
+
# range: "bytes=0-9",
|
|
5386
5387
|
# })
|
|
5387
5388
|
#
|
|
5388
5389
|
# resp.to_h outputs the following:
|
|
5389
5390
|
# {
|
|
5390
5391
|
# accept_ranges: "bytes",
|
|
5391
|
-
# content_length:
|
|
5392
|
-
#
|
|
5393
|
-
#
|
|
5394
|
-
#
|
|
5392
|
+
# content_length: 10,
|
|
5393
|
+
# content_range: "bytes 0-9/43",
|
|
5394
|
+
# content_type: "text/plain",
|
|
5395
|
+
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
|
5396
|
+
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
|
5395
5397
|
# metadata: {
|
|
5396
5398
|
# },
|
|
5397
|
-
# tag_count: 2,
|
|
5398
5399
|
# version_id: "null",
|
|
5399
5400
|
# }
|
|
5400
5401
|
#
|
|
5401
|
-
# @example Example: To retrieve
|
|
5402
|
+
# @example Example: To retrieve an object
|
|
5402
5403
|
#
|
|
5403
|
-
# # The following example retrieves an object for an S3 bucket.
|
|
5404
|
-
# # specific byte range.
|
|
5404
|
+
# # The following example retrieves an object for an S3 bucket.
|
|
5405
5405
|
#
|
|
5406
5406
|
# resp = client.get_object({
|
|
5407
5407
|
# bucket: "examplebucket",
|
|
5408
|
-
# key: "
|
|
5409
|
-
# range: "bytes=0-9",
|
|
5408
|
+
# key: "HappyFace.jpg",
|
|
5410
5409
|
# })
|
|
5411
5410
|
#
|
|
5412
5411
|
# resp.to_h outputs the following:
|
|
5413
5412
|
# {
|
|
5414
5413
|
# accept_ranges: "bytes",
|
|
5415
|
-
# content_length:
|
|
5416
|
-
#
|
|
5417
|
-
#
|
|
5418
|
-
#
|
|
5419
|
-
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
|
5414
|
+
# content_length: 3191,
|
|
5415
|
+
# content_type: "image/jpeg",
|
|
5416
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
|
5417
|
+
# last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
|
|
5420
5418
|
# metadata: {
|
|
5421
5419
|
# },
|
|
5420
|
+
# tag_count: 2,
|
|
5422
5421
|
# version_id: "null",
|
|
5423
5422
|
# }
|
|
5424
5423
|
#
|
|
@@ -5551,11 +5550,11 @@ module Aws::S3
|
|
|
5551
5550
|
# The bucket name that contains the object for which to get the ACL
|
|
5552
5551
|
# information.
|
|
5553
5552
|
#
|
|
5554
|
-
# When using this
|
|
5555
|
-
# the access point hostname. The access point hostname takes the form
|
|
5553
|
+
# When using this action with an access point, you must direct requests
|
|
5554
|
+
# to the access point hostname. The access point hostname takes the form
|
|
5556
5555
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
5557
|
-
# When using this
|
|
5558
|
-
#
|
|
5556
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
5557
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
5559
5558
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
5560
5559
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
5561
5560
|
#
|
|
@@ -5688,11 +5687,11 @@ module Aws::S3
|
|
|
5688
5687
|
# The bucket name containing the object whose Legal Hold status you want
|
|
5689
5688
|
# to retrieve.
|
|
5690
5689
|
#
|
|
5691
|
-
# When using this
|
|
5692
|
-
# the access point hostname. The access point hostname takes the form
|
|
5690
|
+
# When using this action with an access point, you must direct requests
|
|
5691
|
+
# to the access point hostname. The access point hostname takes the form
|
|
5693
5692
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
5694
|
-
# When using this
|
|
5695
|
-
#
|
|
5693
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
5694
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
5696
5695
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
5697
5696
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
5698
5697
|
#
|
|
@@ -5763,11 +5762,11 @@ module Aws::S3
|
|
|
5763
5762
|
# @option params [required, String] :bucket
|
|
5764
5763
|
# The bucket whose Object Lock configuration you want to retrieve.
|
|
5765
5764
|
#
|
|
5766
|
-
# When using this
|
|
5767
|
-
# the access point hostname. The access point hostname takes the form
|
|
5765
|
+
# When using this action with an access point, you must direct requests
|
|
5766
|
+
# to the access point hostname. The access point hostname takes the form
|
|
5768
5767
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
5769
|
-
# When using this
|
|
5770
|
-
#
|
|
5768
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
5769
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
5771
5770
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
5772
5771
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
5773
5772
|
#
|
|
@@ -5820,11 +5819,11 @@ module Aws::S3
|
|
|
5820
5819
|
# The bucket name containing the object whose retention settings you
|
|
5821
5820
|
# want to retrieve.
|
|
5822
5821
|
#
|
|
5823
|
-
# When using this
|
|
5824
|
-
# the access point hostname. The access point hostname takes the form
|
|
5822
|
+
# When using this action with an access point, you must direct requests
|
|
5823
|
+
# to the access point hostname. The access point hostname takes the form
|
|
5825
5824
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
5826
|
-
# When using this
|
|
5827
|
-
#
|
|
5825
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
5826
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
5828
5827
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
5829
5828
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
5830
5829
|
#
|
|
@@ -5888,7 +5887,7 @@ module Aws::S3
|
|
|
5888
5887
|
# tagging subresource associated with the object.
|
|
5889
5888
|
#
|
|
5890
5889
|
# To use this operation, you must have permission to perform the
|
|
5891
|
-
# `s3:GetObjectTagging` action. By default, the GET
|
|
5890
|
+
# `s3:GetObjectTagging` action. By default, the GET action returns
|
|
5892
5891
|
# information about current version of an object. For a versioned
|
|
5893
5892
|
# bucket, you can have multiple versions of an object in your bucket. To
|
|
5894
5893
|
# retrieve tags of any other version, use the versionId query parameter.
|
|
@@ -5900,7 +5899,7 @@ module Aws::S3
|
|
|
5900
5899
|
# For information about the Amazon S3 object tagging feature, see
|
|
5901
5900
|
# [Object Tagging][1].
|
|
5902
5901
|
#
|
|
5903
|
-
# The following
|
|
5902
|
+
# The following action is related to `GetObjectTagging`\:
|
|
5904
5903
|
#
|
|
5905
5904
|
# * [PutObjectTagging][2]
|
|
5906
5905
|
#
|
|
@@ -5916,22 +5915,22 @@ module Aws::S3
|
|
|
5916
5915
|
# The bucket name containing the object for which to get the tagging
|
|
5917
5916
|
# information.
|
|
5918
5917
|
#
|
|
5919
|
-
# When using this
|
|
5920
|
-
# the access point hostname. The access point hostname takes the form
|
|
5918
|
+
# When using this action with an access point, you must direct requests
|
|
5919
|
+
# to the access point hostname. The access point hostname takes the form
|
|
5921
5920
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
5922
|
-
# When using this
|
|
5923
|
-
#
|
|
5921
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
5922
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
5924
5923
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
5925
5924
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
5926
5925
|
#
|
|
5927
|
-
# When using this
|
|
5926
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
5928
5927
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
5929
5928
|
# takes the form
|
|
5930
5929
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
5931
|
-
# When using this
|
|
5932
|
-
#
|
|
5933
|
-
#
|
|
5934
|
-
#
|
|
5930
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
5931
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
5932
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
5933
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
5935
5934
|
#
|
|
5936
5935
|
#
|
|
5937
5936
|
#
|
|
@@ -5966,49 +5965,49 @@ module Aws::S3
|
|
|
5966
5965
|
# * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
|
|
5967
5966
|
#
|
|
5968
5967
|
#
|
|
5969
|
-
# @example Example: To retrieve tag set of
|
|
5968
|
+
# @example Example: To retrieve tag set of an object
|
|
5970
5969
|
#
|
|
5971
|
-
# # The following example retrieves tag set of an object.
|
|
5970
|
+
# # The following example retrieves tag set of an object.
|
|
5972
5971
|
#
|
|
5973
5972
|
# resp = client.get_object_tagging({
|
|
5974
5973
|
# bucket: "examplebucket",
|
|
5975
|
-
# key: "
|
|
5976
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
|
5974
|
+
# key: "HappyFace.jpg",
|
|
5977
5975
|
# })
|
|
5978
5976
|
#
|
|
5979
5977
|
# resp.to_h outputs the following:
|
|
5980
5978
|
# {
|
|
5981
5979
|
# tag_set: [
|
|
5982
5980
|
# {
|
|
5983
|
-
# key: "
|
|
5984
|
-
# value: "
|
|
5981
|
+
# key: "Key4",
|
|
5982
|
+
# value: "Value4",
|
|
5983
|
+
# },
|
|
5984
|
+
# {
|
|
5985
|
+
# key: "Key3",
|
|
5986
|
+
# value: "Value3",
|
|
5985
5987
|
# },
|
|
5986
5988
|
# ],
|
|
5987
|
-
# version_id: "
|
|
5989
|
+
# version_id: "null",
|
|
5988
5990
|
# }
|
|
5989
5991
|
#
|
|
5990
|
-
# @example Example: To retrieve tag set of
|
|
5992
|
+
# @example Example: To retrieve tag set of a specific object version
|
|
5991
5993
|
#
|
|
5992
|
-
# # The following example retrieves tag set of an object.
|
|
5994
|
+
# # The following example retrieves tag set of an object. The request specifies object version.
|
|
5993
5995
|
#
|
|
5994
5996
|
# resp = client.get_object_tagging({
|
|
5995
5997
|
# bucket: "examplebucket",
|
|
5996
|
-
# key: "
|
|
5998
|
+
# key: "exampleobject",
|
|
5999
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
|
5997
6000
|
# })
|
|
5998
6001
|
#
|
|
5999
6002
|
# resp.to_h outputs the following:
|
|
6000
6003
|
# {
|
|
6001
6004
|
# tag_set: [
|
|
6002
6005
|
# {
|
|
6003
|
-
# key: "
|
|
6004
|
-
# value: "
|
|
6005
|
-
# },
|
|
6006
|
-
# {
|
|
6007
|
-
# key: "Key3",
|
|
6008
|
-
# value: "Value3",
|
|
6006
|
+
# key: "Key1",
|
|
6007
|
+
# value: "Value1",
|
|
6009
6008
|
# },
|
|
6010
6009
|
# ],
|
|
6011
|
-
# version_id: "
|
|
6010
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
|
6012
6011
|
# }
|
|
6013
6012
|
#
|
|
6014
6013
|
# @example Request syntax with placeholder values
|
|
@@ -6051,7 +6050,7 @@ module Aws::S3
|
|
|
6051
6050
|
#
|
|
6052
6051
|
# This action is not supported by Amazon S3 on Outposts.
|
|
6053
6052
|
#
|
|
6054
|
-
# The following
|
|
6053
|
+
# The following action is related to `GetObjectTorrent`\:
|
|
6055
6054
|
#
|
|
6056
6055
|
# * [GetObject][2]
|
|
6057
6056
|
#
|
|
@@ -6201,9 +6200,9 @@ module Aws::S3
|
|
|
6201
6200
|
req.send_request(options)
|
|
6202
6201
|
end
|
|
6203
6202
|
|
|
6204
|
-
# This
|
|
6205
|
-
# permission to access it. The
|
|
6206
|
-
#
|
|
6203
|
+
# This action is useful to determine if a bucket exists and you have
|
|
6204
|
+
# permission to access it. The action returns a `200 OK` if the bucket
|
|
6205
|
+
# exists and you have permission to access it.
|
|
6207
6206
|
#
|
|
6208
6207
|
# If the bucket does not exist or you do not have permission to access
|
|
6209
6208
|
# it, the `HEAD` request returns a generic `404 Not Found` or `403
|
|
@@ -6225,22 +6224,22 @@ module Aws::S3
|
|
|
6225
6224
|
# @option params [required, String] :bucket
|
|
6226
6225
|
# The bucket name.
|
|
6227
6226
|
#
|
|
6228
|
-
# When using this
|
|
6229
|
-
# the access point hostname. The access point hostname takes the form
|
|
6227
|
+
# When using this action with an access point, you must direct requests
|
|
6228
|
+
# to the access point hostname. The access point hostname takes the form
|
|
6230
6229
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
6231
|
-
# When using this
|
|
6232
|
-
#
|
|
6230
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
6231
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
6233
6232
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
6234
6233
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
6235
6234
|
#
|
|
6236
|
-
# When using this
|
|
6235
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
6237
6236
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
6238
6237
|
# takes the form
|
|
6239
6238
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
6240
|
-
# When using this
|
|
6241
|
-
#
|
|
6242
|
-
#
|
|
6243
|
-
#
|
|
6239
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
6240
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
6241
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
6242
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
6244
6243
|
#
|
|
6245
6244
|
#
|
|
6246
6245
|
#
|
|
@@ -6285,17 +6284,17 @@ module Aws::S3
|
|
|
6285
6284
|
req.send_request(options)
|
|
6286
6285
|
end
|
|
6287
6286
|
|
|
6288
|
-
# The HEAD
|
|
6289
|
-
# the object itself. This
|
|
6290
|
-
#
|
|
6291
|
-
#
|
|
6292
|
-
#
|
|
6293
|
-
# A `HEAD` request has the same options as a `GET`
|
|
6294
|
-
#
|
|
6295
|
-
#
|
|
6296
|
-
#
|
|
6297
|
-
#
|
|
6298
|
-
#
|
|
6287
|
+
# The HEAD action retrieves metadata from an object without returning
|
|
6288
|
+
# the object itself. This action is useful if you're only interested in
|
|
6289
|
+
# an object's metadata. To use HEAD, you must have READ access to the
|
|
6290
|
+
# object.
|
|
6291
|
+
#
|
|
6292
|
+
# A `HEAD` request has the same options as a `GET` action on an object.
|
|
6293
|
+
# The response is identical to the `GET` response except that there is
|
|
6294
|
+
# no response body. Because of this, if the `HEAD` request generates an
|
|
6295
|
+
# error, it returns a generic `404 Not Found` or `403 Forbidden` code.
|
|
6296
|
+
# It is not possible to retrieve the exact exception beyond these error
|
|
6297
|
+
# codes.
|
|
6299
6298
|
#
|
|
6300
6299
|
# If you encrypt an object by using server-side encryption with
|
|
6301
6300
|
# customer-provided encryption keys (SSE-C) when you store the object in
|
|
@@ -6361,7 +6360,7 @@ module Aws::S3
|
|
|
6361
6360
|
# * If you don’t have the `s3:ListBucket` permission, Amazon S3 returns
|
|
6362
6361
|
# an HTTP status code 403 ("access denied") error.
|
|
6363
6362
|
#
|
|
6364
|
-
# The following
|
|
6363
|
+
# The following action is related to `HeadObject`\:
|
|
6365
6364
|
#
|
|
6366
6365
|
# * [GetObject][5]
|
|
6367
6366
|
#
|
|
@@ -6378,22 +6377,22 @@ module Aws::S3
|
|
|
6378
6377
|
# @option params [required, String] :bucket
|
|
6379
6378
|
# The name of the bucket containing the object.
|
|
6380
6379
|
#
|
|
6381
|
-
# When using this
|
|
6382
|
-
# the access point hostname. The access point hostname takes the form
|
|
6380
|
+
# When using this action with an access point, you must direct requests
|
|
6381
|
+
# to the access point hostname. The access point hostname takes the form
|
|
6383
6382
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
6384
|
-
# When using this
|
|
6385
|
-
#
|
|
6383
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
6384
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
6386
6385
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
6387
6386
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
6388
6387
|
#
|
|
6389
|
-
# When using this
|
|
6388
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
6390
6389
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
6391
6390
|
# takes the form
|
|
6392
6391
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
6393
|
-
# When using this
|
|
6394
|
-
#
|
|
6395
|
-
#
|
|
6396
|
-
#
|
|
6392
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
6393
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
6394
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
6395
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
6397
6396
|
#
|
|
6398
6397
|
#
|
|
6399
6398
|
#
|
|
@@ -6602,15 +6601,14 @@ module Aws::S3
|
|
|
6602
6601
|
# Lists the analytics configurations for the bucket. You can have up to
|
|
6603
6602
|
# 1,000 analytics configurations per bucket.
|
|
6604
6603
|
#
|
|
6605
|
-
# This
|
|
6606
|
-
#
|
|
6607
|
-
#
|
|
6608
|
-
#
|
|
6609
|
-
#
|
|
6610
|
-
#
|
|
6611
|
-
#
|
|
6612
|
-
#
|
|
6613
|
-
# next page.
|
|
6604
|
+
# This action supports list pagination and does not return more than 100
|
|
6605
|
+
# configurations at a time. You should always check the `IsTruncated`
|
|
6606
|
+
# element in the response. If there are no more configurations to list,
|
|
6607
|
+
# `IsTruncated` is set to false. If there are more configurations to
|
|
6608
|
+
# list, `IsTruncated` is set to true, and there will be a value in
|
|
6609
|
+
# `NextContinuationToken`. You use the `NextContinuationToken` value to
|
|
6610
|
+
# continue the pagination of the list by passing the value in
|
|
6611
|
+
# continuation-token in the request to `GET` the next page.
|
|
6614
6612
|
#
|
|
6615
6613
|
# To use this operation, you must have permissions to perform the
|
|
6616
6614
|
# `s3:GetAnalyticsConfiguration` action. The bucket owner has this
|
|
@@ -6787,9 +6785,9 @@ module Aws::S3
|
|
|
6787
6785
|
# Returns a list of inventory configurations for the bucket. You can
|
|
6788
6786
|
# have up to 1,000 analytics configurations per bucket.
|
|
6789
6787
|
#
|
|
6790
|
-
# This
|
|
6791
|
-
#
|
|
6792
|
-
#
|
|
6788
|
+
# This action supports list pagination and does not return more than 100
|
|
6789
|
+
# configurations at a time. Always check the `IsTruncated` element in
|
|
6790
|
+
# the response. If there are no more configurations to list,
|
|
6793
6791
|
# `IsTruncated` is set to false. If there are more configurations to
|
|
6794
6792
|
# list, `IsTruncated` is set to true, and there is a value in
|
|
6795
6793
|
# `NextContinuationToken`. You use the `NextContinuationToken` value to
|
|
@@ -6887,9 +6885,9 @@ module Aws::S3
|
|
|
6887
6885
|
# not provide information on daily storage metrics. You can have up to
|
|
6888
6886
|
# 1,000 configurations per bucket.
|
|
6889
6887
|
#
|
|
6890
|
-
# This
|
|
6891
|
-
#
|
|
6892
|
-
#
|
|
6888
|
+
# This action supports list pagination and does not return more than 100
|
|
6889
|
+
# configurations at a time. Always check the `IsTruncated` element in
|
|
6890
|
+
# the response. If there are no more configurations to list,
|
|
6893
6891
|
# `IsTruncated` is set to false. If there are more configurations to
|
|
6894
6892
|
# list, `IsTruncated` is set to true, and there is a value in
|
|
6895
6893
|
# `NextContinuationToken`. You use the `NextContinuationToken` value to
|
|
@@ -7035,20 +7033,19 @@ module Aws::S3
|
|
|
7035
7033
|
req.send_request(options)
|
|
7036
7034
|
end
|
|
7037
7035
|
|
|
7038
|
-
# This
|
|
7036
|
+
# This action lists in-progress multipart uploads. An in-progress
|
|
7039
7037
|
# multipart upload is a multipart upload that has been initiated using
|
|
7040
7038
|
# the Initiate Multipart Upload request, but has not yet been completed
|
|
7041
7039
|
# or aborted.
|
|
7042
7040
|
#
|
|
7043
|
-
# This
|
|
7044
|
-
#
|
|
7045
|
-
#
|
|
7046
|
-
#
|
|
7047
|
-
#
|
|
7048
|
-
#
|
|
7049
|
-
#
|
|
7050
|
-
#
|
|
7051
|
-
# parameters.
|
|
7041
|
+
# This action returns at most 1,000 multipart uploads in the response.
|
|
7042
|
+
# 1,000 multipart uploads is the maximum number of uploads a response
|
|
7043
|
+
# can include, which is also the default value. You can further limit
|
|
7044
|
+
# the number of uploads in a response by specifying the `max-uploads`
|
|
7045
|
+
# parameter in the response. If additional multipart uploads satisfy the
|
|
7046
|
+
# list criteria, the response will contain an `IsTruncated` element with
|
|
7047
|
+
# the value true. To list the additional multipart uploads, use the
|
|
7048
|
+
# `key-marker` and `upload-id-marker` request parameters.
|
|
7052
7049
|
#
|
|
7053
7050
|
# In the response, the uploads are sorted by key. If your application
|
|
7054
7051
|
# has initiated more than one multipart upload using the same object
|
|
@@ -7060,7 +7057,7 @@ module Aws::S3
|
|
|
7060
7057
|
# Using Multipart Upload][1].
|
|
7061
7058
|
#
|
|
7062
7059
|
# For information on permissions required to use the multipart upload
|
|
7063
|
-
# API, see [Multipart Upload
|
|
7060
|
+
# API, see [Multipart Upload and Permissions][2].
|
|
7064
7061
|
#
|
|
7065
7062
|
# The following operations are related to `ListMultipartUploads`\:
|
|
7066
7063
|
#
|
|
@@ -7087,22 +7084,22 @@ module Aws::S3
|
|
|
7087
7084
|
# @option params [required, String] :bucket
|
|
7088
7085
|
# The name of the bucket to which the multipart upload was initiated.
|
|
7089
7086
|
#
|
|
7090
|
-
# When using this
|
|
7091
|
-
# the access point hostname. The access point hostname takes the form
|
|
7087
|
+
# When using this action with an access point, you must direct requests
|
|
7088
|
+
# to the access point hostname. The access point hostname takes the form
|
|
7092
7089
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
7093
|
-
# When using this
|
|
7094
|
-
#
|
|
7090
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
7091
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
7095
7092
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
7096
7093
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
7097
7094
|
#
|
|
7098
|
-
# When using this
|
|
7095
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
7099
7096
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
7100
7097
|
# takes the form
|
|
7101
7098
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
7102
|
-
# When using this
|
|
7103
|
-
#
|
|
7104
|
-
#
|
|
7105
|
-
#
|
|
7099
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
7100
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
7101
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
7102
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
7106
7103
|
#
|
|
7107
7104
|
#
|
|
7108
7105
|
#
|
|
@@ -7378,7 +7375,7 @@ module Aws::S3
|
|
|
7378
7375
|
#
|
|
7379
7376
|
# @option params [Integer] :max_keys
|
|
7380
7377
|
# Sets the maximum number of keys returned in the response. By default
|
|
7381
|
-
# the
|
|
7378
|
+
# the action returns up to 1,000 key names. The response might contain
|
|
7382
7379
|
# fewer keys but will never contain more. If additional keys satisfy the
|
|
7383
7380
|
# search criteria, but were not returned because max-keys was exceeded,
|
|
7384
7381
|
# the response contains <isTruncated>true</isTruncated>. To
|
|
@@ -7522,7 +7519,7 @@ module Aws::S3
|
|
|
7522
7519
|
# invalid XML. Be sure to design your application to parse the contents
|
|
7523
7520
|
# of the response and handle it appropriately.
|
|
7524
7521
|
#
|
|
7525
|
-
# This
|
|
7522
|
+
# This action has been revised. We recommend that you use the newer
|
|
7526
7523
|
# version, [ListObjectsV2][1], when developing applications. For
|
|
7527
7524
|
# backward compatibility, Amazon S3 continues to support `ListObjects`.
|
|
7528
7525
|
#
|
|
@@ -7549,22 +7546,22 @@ module Aws::S3
|
|
|
7549
7546
|
# @option params [required, String] :bucket
|
|
7550
7547
|
# The name of the bucket containing the objects.
|
|
7551
7548
|
#
|
|
7552
|
-
# When using this
|
|
7553
|
-
# the access point hostname. The access point hostname takes the form
|
|
7549
|
+
# When using this action with an access point, you must direct requests
|
|
7550
|
+
# to the access point hostname. The access point hostname takes the form
|
|
7554
7551
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
7555
|
-
# When using this
|
|
7556
|
-
#
|
|
7552
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
7553
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
7557
7554
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
7558
7555
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
7559
7556
|
#
|
|
7560
|
-
# When using this
|
|
7557
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
7561
7558
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
7562
7559
|
# takes the form
|
|
7563
7560
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
7564
|
-
# When using this
|
|
7565
|
-
#
|
|
7566
|
-
#
|
|
7567
|
-
#
|
|
7561
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
7562
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
7563
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
7564
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
7568
7565
|
#
|
|
7569
7566
|
#
|
|
7570
7567
|
#
|
|
@@ -7587,7 +7584,7 @@ module Aws::S3
|
|
|
7587
7584
|
#
|
|
7588
7585
|
# @option params [Integer] :max_keys
|
|
7589
7586
|
# Sets the maximum number of keys returned in the response. By default
|
|
7590
|
-
# the
|
|
7587
|
+
# the action returns up to 1,000 key names. The response might contain
|
|
7591
7588
|
# fewer keys but will never contain more.
|
|
7592
7589
|
#
|
|
7593
7590
|
# @option params [String] :prefix
|
|
@@ -7710,16 +7707,16 @@ module Aws::S3
|
|
|
7710
7707
|
#
|
|
7711
7708
|
# To use this operation, you must have READ access to the bucket.
|
|
7712
7709
|
#
|
|
7713
|
-
# To use this
|
|
7710
|
+
# To use this action in an AWS Identity and Access Management (IAM)
|
|
7714
7711
|
# policy, you must have permissions to perform the `s3:ListBucket`
|
|
7715
7712
|
# action. The bucket owner has this permission by default and can grant
|
|
7716
7713
|
# this permission to others. For more information about permissions, see
|
|
7717
7714
|
# [Permissions Related to Bucket Subresource Operations][1] and
|
|
7718
7715
|
# [Managing Access Permissions to Your Amazon S3 Resources][2].
|
|
7719
7716
|
#
|
|
7720
|
-
# This section describes the latest revision of
|
|
7721
|
-
# that you use this revised API for application development.
|
|
7722
|
-
# backward compatibility, Amazon S3 continues to support the prior
|
|
7717
|
+
# This section describes the latest revision of this action. We
|
|
7718
|
+
# recommend that you use this revised API for application development.
|
|
7719
|
+
# For backward compatibility, Amazon S3 continues to support the prior
|
|
7723
7720
|
# version of this API, [ListObjects][3].
|
|
7724
7721
|
#
|
|
7725
7722
|
# To get a list of your buckets, see [ListBuckets][4].
|
|
@@ -7745,22 +7742,22 @@ module Aws::S3
|
|
|
7745
7742
|
# @option params [required, String] :bucket
|
|
7746
7743
|
# Bucket name to list.
|
|
7747
7744
|
#
|
|
7748
|
-
# When using this
|
|
7749
|
-
# the access point hostname. The access point hostname takes the form
|
|
7745
|
+
# When using this action with an access point, you must direct requests
|
|
7746
|
+
# to the access point hostname. The access point hostname takes the form
|
|
7750
7747
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
7751
|
-
# When using this
|
|
7752
|
-
#
|
|
7748
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
7749
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
7753
7750
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
7754
7751
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
7755
7752
|
#
|
|
7756
|
-
# When using this
|
|
7753
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
7757
7754
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
7758
7755
|
# takes the form
|
|
7759
7756
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
7760
|
-
# When using this
|
|
7761
|
-
#
|
|
7762
|
-
#
|
|
7763
|
-
#
|
|
7757
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
7758
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
7759
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
7760
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
7764
7761
|
#
|
|
7765
7762
|
#
|
|
7766
7763
|
#
|
|
@@ -7775,7 +7772,7 @@ module Aws::S3
|
|
|
7775
7772
|
#
|
|
7776
7773
|
# @option params [Integer] :max_keys
|
|
7777
7774
|
# Sets the maximum number of keys returned in the response. By default
|
|
7778
|
-
# the
|
|
7775
|
+
# the action returns up to 1,000 key names. The response might contain
|
|
7779
7776
|
# fewer keys but will never contain more.
|
|
7780
7777
|
#
|
|
7781
7778
|
# @option params [String] :prefix
|
|
@@ -7924,7 +7921,7 @@ module Aws::S3
|
|
|
7924
7921
|
# Using Multipart Upload][2].
|
|
7925
7922
|
#
|
|
7926
7923
|
# For information on permissions required to use the multipart upload
|
|
7927
|
-
# API, see [Multipart Upload
|
|
7924
|
+
# API, see [Multipart Upload and Permissions][3].
|
|
7928
7925
|
#
|
|
7929
7926
|
# The following operations are related to `ListParts`\:
|
|
7930
7927
|
#
|
|
@@ -7951,22 +7948,22 @@ module Aws::S3
|
|
|
7951
7948
|
# @option params [required, String] :bucket
|
|
7952
7949
|
# The name of the bucket to which the parts are being uploaded.
|
|
7953
7950
|
#
|
|
7954
|
-
# When using this
|
|
7955
|
-
# the access point hostname. The access point hostname takes the form
|
|
7951
|
+
# When using this action with an access point, you must direct requests
|
|
7952
|
+
# to the access point hostname. The access point hostname takes the form
|
|
7956
7953
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
7957
|
-
# When using this
|
|
7958
|
-
#
|
|
7954
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
7955
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
7959
7956
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
7960
7957
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
7961
7958
|
#
|
|
7962
|
-
# When using this
|
|
7959
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
7963
7960
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
7964
7961
|
# takes the form
|
|
7965
7962
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
7966
|
-
# When using this
|
|
7967
|
-
#
|
|
7968
|
-
#
|
|
7969
|
-
#
|
|
7963
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
7964
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
7965
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
7966
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
7970
7967
|
#
|
|
7971
7968
|
#
|
|
7972
7969
|
#
|
|
@@ -8122,8 +8119,8 @@ module Aws::S3
|
|
|
8122
8119
|
#
|
|
8123
8120
|
# * Suspended – Disables accelerated data transfers to the bucket.
|
|
8124
8121
|
#
|
|
8125
|
-
# The [GetBucketAccelerateConfiguration][3]
|
|
8126
|
-
#
|
|
8122
|
+
# The [GetBucketAccelerateConfiguration][3] action returns the transfer
|
|
8123
|
+
# acceleration state of a bucket.
|
|
8127
8124
|
#
|
|
8128
8125
|
# After setting the Transfer Acceleration state of a bucket to Enabled,
|
|
8129
8126
|
# it might take up to thirty minutes before the data transfer rates to
|
|
@@ -8608,7 +8605,7 @@ module Aws::S3
|
|
|
8608
8605
|
# element.
|
|
8609
8606
|
#
|
|
8610
8607
|
# For more information about CORS, go to [Enabling Cross-Origin Resource
|
|
8611
|
-
# Sharing][1] in the *Amazon Simple Storage Service
|
|
8608
|
+
# Sharing][1] in the *Amazon Simple Storage Service User Guide*.
|
|
8612
8609
|
#
|
|
8613
8610
|
# **Related Resources**
|
|
8614
8611
|
#
|
|
@@ -8631,7 +8628,7 @@ module Aws::S3
|
|
|
8631
8628
|
# @option params [required, Types::CORSConfiguration] :cors_configuration
|
|
8632
8629
|
# Describes the cross-origin access configuration for objects in an
|
|
8633
8630
|
# Amazon S3 bucket. For more information, see [Enabling Cross-Origin
|
|
8634
|
-
# Resource Sharing][1] in the *Amazon Simple Storage Service
|
|
8631
|
+
# Resource Sharing][1] in the *Amazon Simple Storage Service User
|
|
8635
8632
|
# Guide*.
|
|
8636
8633
|
#
|
|
8637
8634
|
#
|
|
@@ -8708,6 +8705,7 @@ module Aws::S3
|
|
|
8708
8705
|
# cors_configuration: { # required
|
|
8709
8706
|
# cors_rules: [ # required
|
|
8710
8707
|
# {
|
|
8708
|
+
# id: "ID",
|
|
8711
8709
|
# allowed_headers: ["AllowedHeader"],
|
|
8712
8710
|
# allowed_methods: ["AllowedMethod"], # required
|
|
8713
8711
|
# allowed_origins: ["AllowedOrigin"], # required
|
|
@@ -8729,7 +8727,7 @@ module Aws::S3
|
|
|
8729
8727
|
req.send_request(options)
|
|
8730
8728
|
end
|
|
8731
8729
|
|
|
8732
|
-
# This
|
|
8730
|
+
# This action uses the `encryption` subresource to configure default
|
|
8733
8731
|
# encryption and Amazon S3 Bucket Key for an existing bucket.
|
|
8734
8732
|
#
|
|
8735
8733
|
# Default encryption for a bucket can use server-side encryption with
|
|
@@ -8737,36 +8735,36 @@ module Aws::S3
|
|
|
8737
8735
|
# (SSE-KMS). If you specify default encryption using SSE-KMS, you can
|
|
8738
8736
|
# also configure Amazon S3 Bucket Key. For information about default
|
|
8739
8737
|
# encryption, see [Amazon S3 default bucket encryption][1] in the
|
|
8740
|
-
# *Amazon Simple Storage Service
|
|
8741
|
-
#
|
|
8742
|
-
#
|
|
8738
|
+
# *Amazon Simple Storage Service User Guide*. For more information about
|
|
8739
|
+
# S3 Bucket Keys, see [Amazon S3 Bucket Keys][2] in the *Amazon Simple
|
|
8740
|
+
# Storage Service User Guide*.
|
|
8743
8741
|
#
|
|
8744
|
-
# This
|
|
8745
|
-
# see [ Authenticating Requests (AWS Signature Version
|
|
8746
|
-
# 4)](sig-v4-authenticating-requests.html).
|
|
8742
|
+
# This action requires AWS Signature Version 4. For more information,
|
|
8743
|
+
# see [ Authenticating Requests (AWS Signature Version 4)][3].
|
|
8747
8744
|
#
|
|
8748
8745
|
# To use this operation, you must have permissions to perform the
|
|
8749
8746
|
# `s3:PutEncryptionConfiguration` action. The bucket owner has this
|
|
8750
8747
|
# permission by default. The bucket owner can grant this permission to
|
|
8751
8748
|
# others. For more information about permissions, see [Permissions
|
|
8752
|
-
# Related to Bucket Subresource Operations][
|
|
8753
|
-
# Permissions to Your Amazon S3 Resources][
|
|
8754
|
-
# Storage Service
|
|
8749
|
+
# Related to Bucket Subresource Operations][4] and [Managing Access
|
|
8750
|
+
# Permissions to Your Amazon S3 Resources][5] in the Amazon Simple
|
|
8751
|
+
# Storage Service User Guide.
|
|
8755
8752
|
#
|
|
8756
8753
|
# **Related Resources**
|
|
8757
8754
|
#
|
|
8758
|
-
# * [GetBucketEncryption][
|
|
8755
|
+
# * [GetBucketEncryption][6]
|
|
8759
8756
|
#
|
|
8760
|
-
# * [DeleteBucketEncryption][
|
|
8757
|
+
# * [DeleteBucketEncryption][7]
|
|
8761
8758
|
#
|
|
8762
8759
|
#
|
|
8763
8760
|
#
|
|
8764
8761
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
|
8765
8762
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
|
|
8766
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
8767
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-
|
|
8768
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
8769
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
8763
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
|
8764
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
8765
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
|
8766
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
|
8767
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
|
8770
8768
|
#
|
|
8771
8769
|
# @option params [required, String] :bucket
|
|
8772
8770
|
# Specifies default encryption for a bucket using server-side encryption
|
|
@@ -8945,7 +8943,7 @@ module Aws::S3
|
|
|
8945
8943
|
req.send_request(options)
|
|
8946
8944
|
end
|
|
8947
8945
|
|
|
8948
|
-
# This implementation of the `PUT`
|
|
8946
|
+
# This implementation of the `PUT` action adds an inventory
|
|
8949
8947
|
# configuration (identified by the inventory ID) to the bucket. You can
|
|
8950
8948
|
# have up to 1,000 inventory configurations per bucket.
|
|
8951
8949
|
#
|
|
@@ -8961,8 +8959,8 @@ module Aws::S3
|
|
|
8961
8959
|
# whether to generate the inventory daily or weekly. You can also
|
|
8962
8960
|
# configure what object metadata to include and whether to inventory all
|
|
8963
8961
|
# object versions or only current versions. For more information, see
|
|
8964
|
-
# [Amazon S3 Inventory][1] in the Amazon Simple Storage Service
|
|
8965
|
-
#
|
|
8962
|
+
# [Amazon S3 Inventory][1] in the Amazon Simple Storage Service User
|
|
8963
|
+
# Guide.
|
|
8966
8964
|
#
|
|
8967
8965
|
# You must create a bucket policy on the *destination* bucket to grant
|
|
8968
8966
|
# permissions to Amazon S3 to write objects to the bucket in the defined
|
|
@@ -8974,7 +8972,7 @@ module Aws::S3
|
|
|
8974
8972
|
# permission by default and can grant this permission to others. For
|
|
8975
8973
|
# more information about permissions, see [Permissions Related to Bucket
|
|
8976
8974
|
# Subresource Operations][3] and [Managing Access Permissions to Your
|
|
8977
|
-
# Amazon S3 Resources][4] in the Amazon Simple Storage Service
|
|
8975
|
+
# Amazon S3 Resources][4] in the Amazon Simple Storage Service User
|
|
8978
8976
|
# Guide.
|
|
8979
8977
|
#
|
|
8980
8978
|
# **Special Errors**
|
|
@@ -9087,7 +9085,7 @@ module Aws::S3
|
|
|
9087
9085
|
# Creates a new lifecycle configuration for the bucket or replaces an
|
|
9088
9086
|
# existing lifecycle configuration. For information about lifecycle
|
|
9089
9087
|
# configuration, see [Object Lifecycle Management][2] in the *Amazon
|
|
9090
|
-
# Simple Storage Service
|
|
9088
|
+
# Simple Storage Service User Guide*.
|
|
9091
9089
|
#
|
|
9092
9090
|
# By default, all Amazon S3 resources, including buckets, objects, and
|
|
9093
9091
|
# related subresources (for example, lifecycle configuration and website
|
|
@@ -9110,7 +9108,7 @@ module Aws::S3
|
|
|
9110
9108
|
#
|
|
9111
9109
|
# For more information about permissions, see [Managing Access
|
|
9112
9110
|
# Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
|
|
9113
|
-
# Storage Service
|
|
9111
|
+
# Storage Service User Guide*.
|
|
9114
9112
|
#
|
|
9115
9113
|
# For more examples of transitioning objects to storage classes such as
|
|
9116
9114
|
# STANDARD\_IA or ONEZONE\_IA, see [Examples of Lifecycle
|
|
@@ -9128,7 +9126,7 @@ module Aws::S3
|
|
|
9128
9126
|
# the AWS account that created the bucket—can perform any of the
|
|
9129
9127
|
# operations. A resource owner can also grant others permission to
|
|
9130
9128
|
# perform the operation. For more information, see the following
|
|
9131
|
-
# topics in the Amazon Simple Storage Service
|
|
9129
|
+
# topics in the Amazon Simple Storage Service User Guide:
|
|
9132
9130
|
#
|
|
9133
9131
|
# * [Specifying Permissions in a Policy][8]
|
|
9134
9132
|
#
|
|
@@ -9718,8 +9716,8 @@ module Aws::S3
|
|
|
9718
9716
|
#
|
|
9719
9717
|
# `</NotificationConfiguration>`
|
|
9720
9718
|
#
|
|
9721
|
-
# This
|
|
9722
|
-
#
|
|
9719
|
+
# This action replaces the existing notification configuration with the
|
|
9720
|
+
# configuration you include in the request body.
|
|
9723
9721
|
#
|
|
9724
9722
|
# After Amazon S3 receives this request, it first verifies that any
|
|
9725
9723
|
# Amazon Simple Notification Service (Amazon SNS) or Amazon Simple Queue
|
|
@@ -9742,8 +9740,8 @@ module Aws::S3
|
|
|
9742
9740
|
# notification configuration includes SNS topic, SQS queue, and Lambda
|
|
9743
9741
|
# function configurations. When you send a PUT request with this
|
|
9744
9742
|
# configuration, Amazon S3 sends test messages to your SNS topic. If the
|
|
9745
|
-
# message fails, the entire PUT
|
|
9746
|
-
#
|
|
9743
|
+
# message fails, the entire PUT action will fail, and Amazon S3 will not
|
|
9744
|
+
# add the configuration to your bucket.
|
|
9747
9745
|
#
|
|
9748
9746
|
# </note>
|
|
9749
9747
|
#
|
|
@@ -9755,7 +9753,7 @@ module Aws::S3
|
|
|
9755
9753
|
# include the `x-amz-sns-test-message-id` header containing the message
|
|
9756
9754
|
# ID of the test notification sent to the topic.
|
|
9757
9755
|
#
|
|
9758
|
-
# The following
|
|
9756
|
+
# The following action is related to
|
|
9759
9757
|
# `PutBucketNotificationConfiguration`\:
|
|
9760
9758
|
#
|
|
9761
9759
|
# * [GetBucketNotificationConfiguration][2]
|
|
@@ -10020,8 +10018,8 @@ module Aws::S3
|
|
|
10020
10018
|
# more information, see [Replication][1] in the *Amazon S3 Developer
|
|
10021
10019
|
# Guide*.
|
|
10022
10020
|
#
|
|
10023
|
-
# <note markdown="1"> To perform this operation, the user or role performing the
|
|
10024
|
-
#
|
|
10021
|
+
# <note markdown="1"> To perform this operation, the user or role performing the action must
|
|
10022
|
+
# have the [iam:PassRole][2] permission.
|
|
10025
10023
|
#
|
|
10026
10024
|
# </note>
|
|
10027
10025
|
#
|
|
@@ -10343,7 +10341,7 @@ module Aws::S3
|
|
|
10343
10341
|
#
|
|
10344
10342
|
# * Error code: `OperationAbortedError `
|
|
10345
10343
|
#
|
|
10346
|
-
# * Description: A conflicting conditional
|
|
10344
|
+
# * Description: A conflicting conditional action is currently in
|
|
10347
10345
|
# progress against this resource. Please try again.
|
|
10348
10346
|
#
|
|
10349
10347
|
# ^
|
|
@@ -10558,7 +10556,7 @@ module Aws::S3
|
|
|
10558
10556
|
# such as the file name of the index document and any redirect rules.
|
|
10559
10557
|
# For more information, see [Hosting Websites on Amazon S3][1].
|
|
10560
10558
|
#
|
|
10561
|
-
# This PUT
|
|
10559
|
+
# This PUT action requires the `S3:PutBucketWebsite` permission. By
|
|
10562
10560
|
# default, only the bucket owner can configure the website attached to a
|
|
10563
10561
|
# bucket; however, bucket owners can allow other users to set the
|
|
10564
10562
|
# website configuration by writing a bucket policy that grants them the
|
|
@@ -10618,7 +10616,7 @@ module Aws::S3
|
|
|
10618
10616
|
# Amazon S3 has a limitation of 50 routing rules per website
|
|
10619
10617
|
# configuration. If you require more than 50 routing rules, you can use
|
|
10620
10618
|
# object redirect. For more information, see [Configuring an Object
|
|
10621
|
-
# Redirect][2] in the *Amazon Simple Storage Service
|
|
10619
|
+
# Redirect][2] in the *Amazon Simple Storage Service User Guide*.
|
|
10622
10620
|
#
|
|
10623
10621
|
#
|
|
10624
10622
|
#
|
|
@@ -10751,7 +10749,7 @@ module Aws::S3
|
|
|
10751
10749
|
# If you request server-side encryption using AWS Key Management Service
|
|
10752
10750
|
# (SSE-KMS), you can enable an S3 Bucket Key at the object-level. For
|
|
10753
10751
|
# more information, see [Amazon S3 Bucket Keys][3] in the *Amazon Simple
|
|
10754
|
-
# Storage Service
|
|
10752
|
+
# Storage Service User Guide*.
|
|
10755
10753
|
#
|
|
10756
10754
|
# **Access Control List (ACL)-Specific Request Headers**
|
|
10757
10755
|
#
|
|
@@ -10817,24 +10815,24 @@ module Aws::S3
|
|
|
10817
10815
|
# Object data.
|
|
10818
10816
|
#
|
|
10819
10817
|
# @option params [required, String] :bucket
|
|
10820
|
-
# The bucket name to which the PUT
|
|
10818
|
+
# The bucket name to which the PUT action was initiated.
|
|
10821
10819
|
#
|
|
10822
|
-
# When using this
|
|
10823
|
-
# the access point hostname. The access point hostname takes the form
|
|
10820
|
+
# When using this action with an access point, you must direct requests
|
|
10821
|
+
# to the access point hostname. The access point hostname takes the form
|
|
10824
10822
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
10825
|
-
# When using this
|
|
10826
|
-
#
|
|
10823
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
10824
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
10827
10825
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
10828
10826
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
10829
10827
|
#
|
|
10830
|
-
# When using this
|
|
10828
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
10831
10829
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
10832
10830
|
# takes the form
|
|
10833
10831
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
10834
|
-
# When using this
|
|
10835
|
-
#
|
|
10836
|
-
#
|
|
10837
|
-
#
|
|
10832
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
10833
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
10834
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
10835
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
10838
10836
|
#
|
|
10839
10837
|
#
|
|
10840
10838
|
#
|
|
@@ -10934,7 +10932,7 @@ module Aws::S3
|
|
|
10934
10932
|
# This action is not supported by Amazon S3 on Outposts.
|
|
10935
10933
|
#
|
|
10936
10934
|
# @option params [required, String] :key
|
|
10937
|
-
# Object key for which the PUT
|
|
10935
|
+
# Object key for which the PUT action was initiated.
|
|
10938
10936
|
#
|
|
10939
10937
|
# @option params [Hash<String,String>] :metadata
|
|
10940
10938
|
# A map of metadata to store with the object in S3.
|
|
@@ -11021,8 +11019,8 @@ module Aws::S3
|
|
|
11021
11019
|
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
|
11022
11020
|
# for object encryption with SSE-KMS.
|
|
11023
11021
|
#
|
|
11024
|
-
# Specifying this header with a PUT
|
|
11025
|
-
#
|
|
11022
|
+
# Specifying this header with a PUT action doesn’t affect bucket-level
|
|
11023
|
+
# settings for S3 Bucket Key.
|
|
11026
11024
|
#
|
|
11027
11025
|
# @option params [String] :request_payer
|
|
11028
11026
|
# Confirms that the requester knows that they will be charged for the
|
|
@@ -11072,114 +11070,114 @@ module Aws::S3
|
|
|
11072
11070
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
|
11073
11071
|
#
|
|
11074
11072
|
#
|
|
11075
|
-
# @example Example: To upload object and specify
|
|
11073
|
+
# @example Example: To upload an object and specify optional tags
|
|
11076
11074
|
#
|
|
11077
|
-
# # The following example
|
|
11078
|
-
# #
|
|
11075
|
+
# # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
|
|
11076
|
+
# # S3 returns version ID of the newly created object.
|
|
11079
11077
|
#
|
|
11080
11078
|
# resp = client.put_object({
|
|
11081
|
-
# body: "
|
|
11079
|
+
# body: "c:\\HappyFace.jpg",
|
|
11082
11080
|
# bucket: "examplebucket",
|
|
11083
|
-
# key: "
|
|
11084
|
-
#
|
|
11085
|
-
# "metadata1" => "value1",
|
|
11086
|
-
# "metadata2" => "value2",
|
|
11087
|
-
# },
|
|
11081
|
+
# key: "HappyFace.jpg",
|
|
11082
|
+
# tagging: "key1=value1&key2=value2",
|
|
11088
11083
|
# })
|
|
11089
11084
|
#
|
|
11090
11085
|
# resp.to_h outputs the following:
|
|
11091
11086
|
# {
|
|
11092
11087
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
|
11093
|
-
# version_id: "
|
|
11088
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
|
11094
11089
|
# }
|
|
11095
11090
|
#
|
|
11096
|
-
# @example Example: To upload an object and specify
|
|
11091
|
+
# @example Example: To upload an object and specify canned ACL.
|
|
11097
11092
|
#
|
|
11098
|
-
# # The following example uploads and object. The request specifies
|
|
11099
|
-
# #
|
|
11093
|
+
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
|
11094
|
+
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
|
11100
11095
|
#
|
|
11101
11096
|
# resp = client.put_object({
|
|
11097
|
+
# acl: "authenticated-read",
|
|
11102
11098
|
# body: "filetoupload",
|
|
11103
11099
|
# bucket: "examplebucket",
|
|
11104
11100
|
# key: "exampleobject",
|
|
11105
|
-
# server_side_encryption: "AES256",
|
|
11106
|
-
# tagging: "key1=value1&key2=value2",
|
|
11107
11101
|
# })
|
|
11108
11102
|
#
|
|
11109
11103
|
# resp.to_h outputs the following:
|
|
11110
11104
|
# {
|
|
11111
11105
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
|
11112
|
-
#
|
|
11113
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
|
11106
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
|
11114
11107
|
# }
|
|
11115
11108
|
#
|
|
11116
|
-
# @example Example: To
|
|
11109
|
+
# @example Example: To create an object.
|
|
11117
11110
|
#
|
|
11118
|
-
# # The following example
|
|
11119
|
-
# # syntax. S3 returns VersionId of the newly created object.
|
|
11111
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
|
11120
11112
|
#
|
|
11121
11113
|
# resp = client.put_object({
|
|
11122
|
-
# body: "
|
|
11114
|
+
# body: "filetoupload",
|
|
11123
11115
|
# bucket: "examplebucket",
|
|
11124
|
-
# key: "
|
|
11116
|
+
# key: "objectkey",
|
|
11125
11117
|
# })
|
|
11126
11118
|
#
|
|
11127
11119
|
# resp.to_h outputs the following:
|
|
11128
11120
|
# {
|
|
11129
11121
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
|
11130
|
-
# version_id: "
|
|
11122
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
|
11131
11123
|
# }
|
|
11132
11124
|
#
|
|
11133
|
-
# @example Example: To
|
|
11125
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
|
11134
11126
|
#
|
|
11135
|
-
# # The following example
|
|
11127
|
+
# # The following example uploads and object. The request specifies the optional server-side encryption option. The request
|
|
11128
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
|
11136
11129
|
#
|
|
11137
11130
|
# resp = client.put_object({
|
|
11138
11131
|
# body: "filetoupload",
|
|
11139
11132
|
# bucket: "examplebucket",
|
|
11140
|
-
# key: "
|
|
11133
|
+
# key: "exampleobject",
|
|
11134
|
+
# server_side_encryption: "AES256",
|
|
11135
|
+
# tagging: "key1=value1&key2=value2",
|
|
11141
11136
|
# })
|
|
11142
11137
|
#
|
|
11143
11138
|
# resp.to_h outputs the following:
|
|
11144
11139
|
# {
|
|
11145
11140
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
|
11146
|
-
#
|
|
11141
|
+
# server_side_encryption: "AES256",
|
|
11142
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
|
11147
11143
|
# }
|
|
11148
11144
|
#
|
|
11149
|
-
# @example Example: To upload
|
|
11145
|
+
# @example Example: To upload object and specify user-defined metadata
|
|
11150
11146
|
#
|
|
11151
|
-
# # The following example
|
|
11152
|
-
# #
|
|
11147
|
+
# # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
|
|
11148
|
+
# # enabled, S3 returns version ID in response.
|
|
11153
11149
|
#
|
|
11154
11150
|
# resp = client.put_object({
|
|
11155
|
-
# acl: "authenticated-read",
|
|
11156
11151
|
# body: "filetoupload",
|
|
11157
11152
|
# bucket: "examplebucket",
|
|
11158
11153
|
# key: "exampleobject",
|
|
11154
|
+
# metadata: {
|
|
11155
|
+
# "metadata1" => "value1",
|
|
11156
|
+
# "metadata2" => "value2",
|
|
11157
|
+
# },
|
|
11159
11158
|
# })
|
|
11160
11159
|
#
|
|
11161
11160
|
# resp.to_h outputs the following:
|
|
11162
11161
|
# {
|
|
11163
11162
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
|
11164
|
-
# version_id: "
|
|
11163
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
|
11165
11164
|
# }
|
|
11166
11165
|
#
|
|
11167
|
-
# @example Example: To upload an object
|
|
11166
|
+
# @example Example: To upload an object
|
|
11168
11167
|
#
|
|
11169
|
-
# # The following example uploads an object
|
|
11170
|
-
# # S3 returns
|
|
11168
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
|
11169
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
|
11171
11170
|
#
|
|
11172
11171
|
# resp = client.put_object({
|
|
11173
|
-
# body: "
|
|
11172
|
+
# body: "HappyFace.jpg",
|
|
11174
11173
|
# bucket: "examplebucket",
|
|
11175
11174
|
# key: "HappyFace.jpg",
|
|
11176
|
-
# tagging: "key1=value1&key2=value2",
|
|
11177
11175
|
# })
|
|
11178
11176
|
#
|
|
11179
11177
|
# resp.to_h outputs the following:
|
|
11180
11178
|
# {
|
|
11181
11179
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
|
11182
|
-
# version_id: "
|
|
11180
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
|
11183
11181
|
# }
|
|
11184
11182
|
#
|
|
11185
11183
|
# @example Example: To upload an object (specify optional headers)
|
|
@@ -11273,7 +11271,7 @@ module Aws::S3
|
|
|
11273
11271
|
# permissions for a new or existing object in an S3 bucket. You must
|
|
11274
11272
|
# have `WRITE_ACP` permission to set the ACL of an object. For more
|
|
11275
11273
|
# information, see [What permissions can I grant?][1] in the *Amazon
|
|
11276
|
-
# Simple Storage Service
|
|
11274
|
+
# Simple Storage Service User Guide*.
|
|
11277
11275
|
#
|
|
11278
11276
|
# This action is not supported by Amazon S3 on Outposts.
|
|
11279
11277
|
#
|
|
@@ -11437,11 +11435,11 @@ module Aws::S3
|
|
|
11437
11435
|
# The bucket name that contains the object to which you want to attach
|
|
11438
11436
|
# the ACL.
|
|
11439
11437
|
#
|
|
11440
|
-
# When using this
|
|
11441
|
-
# the access point hostname. The access point hostname takes the form
|
|
11438
|
+
# When using this action with an access point, you must direct requests
|
|
11439
|
+
# to the access point hostname. The access point hostname takes the form
|
|
11442
11440
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
11443
|
-
# When using this
|
|
11444
|
-
#
|
|
11441
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
11442
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
11445
11443
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
11446
11444
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
11447
11445
|
#
|
|
@@ -11488,24 +11486,24 @@ module Aws::S3
|
|
|
11488
11486
|
# This action is not supported by Amazon S3 on Outposts.
|
|
11489
11487
|
#
|
|
11490
11488
|
# @option params [required, String] :key
|
|
11491
|
-
# Key for which the PUT
|
|
11489
|
+
# Key for which the PUT action was initiated.
|
|
11492
11490
|
#
|
|
11493
|
-
# When using this
|
|
11494
|
-
# the access point hostname. The access point hostname takes the form
|
|
11491
|
+
# When using this action with an access point, you must direct requests
|
|
11492
|
+
# to the access point hostname. The access point hostname takes the form
|
|
11495
11493
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
11496
|
-
# When using this
|
|
11497
|
-
#
|
|
11494
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
11495
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
11498
11496
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
11499
11497
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
11500
11498
|
#
|
|
11501
|
-
# When using this
|
|
11499
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
11502
11500
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
11503
11501
|
# takes the form
|
|
11504
11502
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
11505
|
-
# When using this
|
|
11506
|
-
#
|
|
11507
|
-
#
|
|
11508
|
-
#
|
|
11503
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
11504
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
11505
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
11506
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
11509
11507
|
#
|
|
11510
11508
|
#
|
|
11511
11509
|
#
|
|
@@ -11620,11 +11618,11 @@ module Aws::S3
|
|
|
11620
11618
|
# The bucket name containing the object that you want to place a Legal
|
|
11621
11619
|
# Hold on.
|
|
11622
11620
|
#
|
|
11623
|
-
# When using this
|
|
11624
|
-
# the access point hostname. The access point hostname takes the form
|
|
11621
|
+
# When using this action with an access point, you must direct requests
|
|
11622
|
+
# to the access point hostname. The access point hostname takes the form
|
|
11625
11623
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
11626
|
-
# When using this
|
|
11627
|
-
#
|
|
11624
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
11625
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
11628
11626
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
11629
11627
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
11630
11628
|
#
|
|
@@ -11802,11 +11800,11 @@ module Aws::S3
|
|
|
11802
11800
|
# The bucket name that contains the object you want to apply this Object
|
|
11803
11801
|
# Retention configuration to.
|
|
11804
11802
|
#
|
|
11805
|
-
# When using this
|
|
11806
|
-
# the access point hostname. The access point hostname takes the form
|
|
11803
|
+
# When using this action with an access point, you must direct requests
|
|
11804
|
+
# to the access point hostname. The access point hostname takes the form
|
|
11807
11805
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
11808
|
-
# When using this
|
|
11809
|
-
#
|
|
11806
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
11807
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
11810
11808
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
11811
11809
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
11812
11810
|
#
|
|
@@ -11837,7 +11835,7 @@ module Aws::S3
|
|
|
11837
11835
|
# Retention configuration to.
|
|
11838
11836
|
#
|
|
11839
11837
|
# @option params [Boolean] :bypass_governance_retention
|
|
11840
|
-
# Indicates whether this
|
|
11838
|
+
# Indicates whether this action should bypass Governance-mode
|
|
11841
11839
|
# restrictions.
|
|
11842
11840
|
#
|
|
11843
11841
|
# @option params [String] :content_md5
|
|
@@ -11920,8 +11918,8 @@ module Aws::S3
|
|
|
11920
11918
|
#
|
|
11921
11919
|
# * * <i>Code: OperationAbortedError </i>
|
|
11922
11920
|
#
|
|
11923
|
-
# * *Cause: A conflicting conditional
|
|
11924
|
-
#
|
|
11921
|
+
# * *Cause: A conflicting conditional action is currently in progress
|
|
11922
|
+
# against this resource. Please try again.*
|
|
11925
11923
|
#
|
|
11926
11924
|
# * * *Code: InternalError*
|
|
11927
11925
|
#
|
|
@@ -11944,22 +11942,22 @@ module Aws::S3
|
|
|
11944
11942
|
# @option params [required, String] :bucket
|
|
11945
11943
|
# The bucket name containing the object.
|
|
11946
11944
|
#
|
|
11947
|
-
# When using this
|
|
11948
|
-
# the access point hostname. The access point hostname takes the form
|
|
11945
|
+
# When using this action with an access point, you must direct requests
|
|
11946
|
+
# to the access point hostname. The access point hostname takes the form
|
|
11949
11947
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
11950
|
-
# When using this
|
|
11951
|
-
#
|
|
11948
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
11949
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
11952
11950
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
11953
11951
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
11954
11952
|
#
|
|
11955
|
-
# When using this
|
|
11953
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
11956
11954
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
11957
11955
|
# takes the form
|
|
11958
11956
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
11959
|
-
# When using this
|
|
11960
|
-
#
|
|
11961
|
-
#
|
|
11962
|
-
#
|
|
11957
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
11958
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
11959
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
11960
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
11963
11961
|
#
|
|
11964
11962
|
#
|
|
11965
11963
|
#
|
|
@@ -12161,7 +12159,7 @@ module Aws::S3
|
|
|
12161
12159
|
# default and can grant this permission to others. For more information
|
|
12162
12160
|
# about permissions, see [Permissions Related to Bucket Subresource
|
|
12163
12161
|
# Operations][1] and [Managing Access Permissions to Your Amazon S3
|
|
12164
|
-
# Resources][2] in the *Amazon Simple Storage Service
|
|
12162
|
+
# Resources][2] in the *Amazon Simple Storage Service User Guide*.
|
|
12165
12163
|
#
|
|
12166
12164
|
# **Querying Archives with Select Requests**
|
|
12167
12165
|
#
|
|
@@ -12171,7 +12169,7 @@ module Aws::S3
|
|
|
12171
12169
|
# files. You can run queries and custom analytics on your archived data
|
|
12172
12170
|
# without having to restore your data to a hotter Amazon S3 tier. For an
|
|
12173
12171
|
# overview about select requests, see [Querying Archived Objects][3] in
|
|
12174
|
-
# the *Amazon Simple Storage Service
|
|
12172
|
+
# the *Amazon Simple Storage Service User Guide*.
|
|
12175
12173
|
#
|
|
12176
12174
|
# When making a select request, do the following:
|
|
12177
12175
|
#
|
|
@@ -12182,7 +12180,7 @@ module Aws::S3
|
|
|
12182
12180
|
# bucket. You can specify the storage class and encryption for the
|
|
12183
12181
|
# output objects stored in the bucket. For more information about
|
|
12184
12182
|
# output, see [Querying Archived Objects][3] in the *Amazon Simple
|
|
12185
|
-
# Storage Service
|
|
12183
|
+
# Storage Service User Guide*.
|
|
12186
12184
|
#
|
|
12187
12185
|
# For more information about the `S3` structure in the request body,
|
|
12188
12186
|
# see the following:
|
|
@@ -12190,10 +12188,10 @@ module Aws::S3
|
|
|
12190
12188
|
# * [PutObject][4]
|
|
12191
12189
|
#
|
|
12192
12190
|
# * [Managing Access with ACLs][5] in the *Amazon Simple Storage
|
|
12193
|
-
# Service
|
|
12191
|
+
# Service User Guide*
|
|
12194
12192
|
#
|
|
12195
12193
|
# * [Protecting Data Using Server-Side Encryption][6] in the *Amazon
|
|
12196
|
-
# Simple Storage Service
|
|
12194
|
+
# Simple Storage Service User Guide*
|
|
12197
12195
|
#
|
|
12198
12196
|
# * Define the SQL expression for the `SELECT` type of restoration for
|
|
12199
12197
|
# your query in the request body's `SelectParameters` structure. You
|
|
@@ -12219,7 +12217,7 @@ module Aws::S3
|
|
|
12219
12217
|
#
|
|
12220
12218
|
# For more information about using SQL with S3 Glacier Select restore,
|
|
12221
12219
|
# see [SQL Reference for Amazon S3 Select and S3 Glacier Select][7] in
|
|
12222
|
-
# the *Amazon Simple Storage Service
|
|
12220
|
+
# the *Amazon Simple Storage Service User Guide*.
|
|
12223
12221
|
#
|
|
12224
12222
|
# When making a select request, you can also do the following:
|
|
12225
12223
|
#
|
|
@@ -12298,20 +12296,20 @@ module Aws::S3
|
|
|
12298
12296
|
#
|
|
12299
12297
|
# For more information about archive retrieval options and provisioned
|
|
12300
12298
|
# capacity for `Expedited` data access, see [Restoring Archived
|
|
12301
|
-
# Objects][8] in the *Amazon Simple Storage Service
|
|
12299
|
+
# Objects][8] in the *Amazon Simple Storage Service User Guide*.
|
|
12302
12300
|
#
|
|
12303
12301
|
# You can use Amazon S3 restore speed upgrade to change the restore
|
|
12304
12302
|
# speed to a faster speed while it is in progress. For more information,
|
|
12305
12303
|
# see [ Upgrading the speed of an in-progress restore][9] in the *Amazon
|
|
12306
|
-
# Simple Storage Service
|
|
12304
|
+
# Simple Storage Service User Guide*.
|
|
12307
12305
|
#
|
|
12308
12306
|
# To get the status of object restoration, you can send a `HEAD`
|
|
12309
12307
|
# request. Operations return the `x-amz-restore` header, which provides
|
|
12310
12308
|
# information about the restoration status, in the response. You can use
|
|
12311
12309
|
# Amazon S3 event notifications to notify you when a restore is
|
|
12312
12310
|
# initiated or completed. For more information, see [Configuring Amazon
|
|
12313
|
-
# S3 Event Notifications][10] in the *Amazon Simple Storage Service
|
|
12314
|
-
#
|
|
12311
|
+
# S3 Event Notifications][10] in the *Amazon Simple Storage Service User
|
|
12312
|
+
# Guide*.
|
|
12315
12313
|
#
|
|
12316
12314
|
# After restoring an archived object, you can update the restoration
|
|
12317
12315
|
# period by reissuing the request with a new period. Amazon S3 updates
|
|
@@ -12327,11 +12325,11 @@ module Aws::S3
|
|
|
12327
12325
|
# days, Amazon S3 deletes the object in 3 days. For more information
|
|
12328
12326
|
# about lifecycle configuration, see
|
|
12329
12327
|
# [PutBucketLifecycleConfiguration][11] and [Object Lifecycle
|
|
12330
|
-
# Management][12] in *Amazon Simple Storage Service
|
|
12328
|
+
# Management][12] in *Amazon Simple Storage Service User Guide*.
|
|
12331
12329
|
#
|
|
12332
12330
|
# **Responses**
|
|
12333
12331
|
#
|
|
12334
|
-
# A successful
|
|
12332
|
+
# A successful action returns either the `200 OK` or `202 Accepted`
|
|
12335
12333
|
# status code.
|
|
12336
12334
|
#
|
|
12337
12335
|
# * If the object is not previously restored, then Amazon S3 returns
|
|
@@ -12369,7 +12367,7 @@ module Aws::S3
|
|
|
12369
12367
|
# * [GetBucketNotificationConfiguration][13]
|
|
12370
12368
|
#
|
|
12371
12369
|
# * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][7] in
|
|
12372
|
-
# the *Amazon Simple Storage Service
|
|
12370
|
+
# the *Amazon Simple Storage Service User Guide*
|
|
12373
12371
|
#
|
|
12374
12372
|
#
|
|
12375
12373
|
#
|
|
@@ -12390,22 +12388,22 @@ module Aws::S3
|
|
|
12390
12388
|
# @option params [required, String] :bucket
|
|
12391
12389
|
# The bucket name containing the object to restore.
|
|
12392
12390
|
#
|
|
12393
|
-
# When using this
|
|
12394
|
-
# the access point hostname. The access point hostname takes the form
|
|
12391
|
+
# When using this action with an access point, you must direct requests
|
|
12392
|
+
# to the access point hostname. The access point hostname takes the form
|
|
12395
12393
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
12396
|
-
# When using this
|
|
12397
|
-
#
|
|
12394
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
12395
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
12398
12396
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
12399
12397
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
12400
12398
|
#
|
|
12401
|
-
# When using this
|
|
12399
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
12402
12400
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
12403
12401
|
# takes the form
|
|
12404
12402
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
12405
|
-
# When using this
|
|
12406
|
-
#
|
|
12407
|
-
#
|
|
12408
|
-
#
|
|
12403
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
12404
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
12405
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
12406
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
12409
12407
|
#
|
|
12410
12408
|
#
|
|
12411
12409
|
#
|
|
@@ -12413,7 +12411,7 @@ module Aws::S3
|
|
|
12413
12411
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
|
12414
12412
|
#
|
|
12415
12413
|
# @option params [required, String] :key
|
|
12416
|
-
# Object key for which the
|
|
12414
|
+
# Object key for which the action was initiated.
|
|
12417
12415
|
#
|
|
12418
12416
|
# @option params [String] :version_id
|
|
12419
12417
|
# VersionId used to reference a specific version of the object.
|
|
@@ -12567,7 +12565,7 @@ module Aws::S3
|
|
|
12567
12565
|
req.send_request(options)
|
|
12568
12566
|
end
|
|
12569
12567
|
|
|
12570
|
-
# This
|
|
12568
|
+
# This action filters the contents of an Amazon S3 object based on a
|
|
12571
12569
|
# simple structured query language (SQL) statement. In the request,
|
|
12572
12570
|
# along with the SQL expression, you must also specify a data
|
|
12573
12571
|
# serialization format (JSON, CSV, or Apache Parquet) of the object.
|
|
@@ -12578,12 +12576,11 @@ module Aws::S3
|
|
|
12578
12576
|
# This action is not supported by Amazon S3 on Outposts.
|
|
12579
12577
|
#
|
|
12580
12578
|
# For more information about Amazon S3 Select, see [Selecting Content
|
|
12581
|
-
# from Objects][1] in the *Amazon Simple Storage Service
|
|
12582
|
-
# Guide*.
|
|
12579
|
+
# from Objects][1] in the *Amazon Simple Storage Service User Guide*.
|
|
12583
12580
|
#
|
|
12584
12581
|
# For more information about using SQL with Amazon S3 Select, see [ SQL
|
|
12585
12582
|
# Reference for Amazon S3 Select and S3 Glacier Select][2] in the
|
|
12586
|
-
# *Amazon Simple Storage Service
|
|
12583
|
+
# *Amazon Simple Storage Service User Guide*.
|
|
12587
12584
|
#
|
|
12588
12585
|
#
|
|
12589
12586
|
#
|
|
@@ -12592,7 +12589,7 @@ module Aws::S3
|
|
|
12592
12589
|
# You must have `s3:GetObject` permission for this operation. Amazon S3
|
|
12593
12590
|
# Select does not support anonymous access. For more information about
|
|
12594
12591
|
# permissions, see [Specifying Permissions in a Policy][3] in the
|
|
12595
|
-
# *Amazon Simple Storage Service
|
|
12592
|
+
# *Amazon Simple Storage Service User Guide*.
|
|
12596
12593
|
#
|
|
12597
12594
|
#
|
|
12598
12595
|
#
|
|
@@ -12620,7 +12617,7 @@ module Aws::S3
|
|
|
12620
12617
|
# keys (SSE-C), you must use HTTPS, and you must use the headers that
|
|
12621
12618
|
# are documented in the [GetObject][4]. For more information about
|
|
12622
12619
|
# SSE-C, see [Server-Side Encryption (Using Customer-Provided
|
|
12623
|
-
# Encryption Keys)][5] in the *Amazon Simple Storage Service
|
|
12620
|
+
# Encryption Keys)][5] in the *Amazon Simple Storage Service User
|
|
12624
12621
|
# Guide*.
|
|
12625
12622
|
#
|
|
12626
12623
|
# For objects that are encrypted with Amazon S3 managed encryption
|
|
@@ -12629,7 +12626,7 @@ module Aws::S3
|
|
|
12629
12626
|
# transparently, so you don't need to specify anything. For more
|
|
12630
12627
|
# information about server-side encryption, including SSE-S3 and
|
|
12631
12628
|
# SSE-KMS, see [Protecting Data Using Server-Side Encryption][6] in
|
|
12632
|
-
# the *Amazon Simple Storage Service
|
|
12629
|
+
# the *Amazon Simple Storage Service User Guide*.
|
|
12633
12630
|
#
|
|
12634
12631
|
# **Working with the Response Body**
|
|
12635
12632
|
#
|
|
@@ -12642,7 +12639,7 @@ module Aws::S3
|
|
|
12642
12639
|
#
|
|
12643
12640
|
# **GetObject Support**
|
|
12644
12641
|
#
|
|
12645
|
-
# The `SelectObjectContent`
|
|
12642
|
+
# The `SelectObjectContent` action does not support the following
|
|
12646
12643
|
# `GetObject` functionality. For more information, see [GetObject][4].
|
|
12647
12644
|
#
|
|
12648
12645
|
# * `Range`\: Although you can specify a scan range for an Amazon S3
|
|
@@ -12653,7 +12650,7 @@ module Aws::S3
|
|
|
12653
12650
|
# * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
|
|
12654
12651
|
# cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
|
|
12655
12652
|
# storage classes. For more information, about storage classes see
|
|
12656
|
-
# [Storage Classes][9] in the *Amazon Simple Storage Service
|
|
12653
|
+
# [Storage Classes][9] in the *Amazon Simple Storage Service User
|
|
12657
12654
|
# Guide*.
|
|
12658
12655
|
#
|
|
12659
12656
|
#
|
|
@@ -13020,12 +13017,11 @@ module Aws::S3
|
|
|
13020
13017
|
# parts storage and stops charging you for the parts storage.
|
|
13021
13018
|
#
|
|
13022
13019
|
# For more information on multipart uploads, go to [Multipart Upload
|
|
13023
|
-
# Overview][4] in the <i>Amazon Simple Storage Service
|
|
13024
|
-
# </i>.
|
|
13020
|
+
# Overview][4] in the <i>Amazon Simple Storage Service User Guide </i>.
|
|
13025
13021
|
#
|
|
13026
13022
|
# For information on the permissions required to use the multipart
|
|
13027
|
-
# upload API, go to [Multipart Upload
|
|
13028
|
-
#
|
|
13023
|
+
# upload API, go to [Multipart Upload and Permissions][5] in the *Amazon
|
|
13024
|
+
# Simple Storage Service User Guide*.
|
|
13029
13025
|
#
|
|
13030
13026
|
# You can optionally request server-side encryption where Amazon S3
|
|
13031
13027
|
# encrypts your data as it writes it to disks in its data centers and
|
|
@@ -13035,8 +13031,8 @@ module Aws::S3
|
|
|
13035
13031
|
# request headers you provide in the request must match the headers you
|
|
13036
13032
|
# used in the request to initiate the upload by using
|
|
13037
13033
|
# [CreateMultipartUpload][2]. For more information, go to [Using
|
|
13038
|
-
# Server-Side Encryption][6] in the *Amazon Simple Storage Service
|
|
13039
|
-
#
|
|
13034
|
+
# Server-Side Encryption][6] in the *Amazon Simple Storage Service User
|
|
13035
|
+
# Guide*.
|
|
13040
13036
|
#
|
|
13041
13037
|
# Server-side encryption is supported by the S3 Multipart Upload
|
|
13042
13038
|
# actions. Unless you are using a customer-provided encryption key, you
|
|
@@ -13099,22 +13095,22 @@ module Aws::S3
|
|
|
13099
13095
|
# @option params [required, String] :bucket
|
|
13100
13096
|
# The name of the bucket to which the multipart upload was initiated.
|
|
13101
13097
|
#
|
|
13102
|
-
# When using this
|
|
13103
|
-
# the access point hostname. The access point hostname takes the form
|
|
13098
|
+
# When using this action with an access point, you must direct requests
|
|
13099
|
+
# to the access point hostname. The access point hostname takes the form
|
|
13104
13100
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
13105
|
-
# When using this
|
|
13106
|
-
#
|
|
13101
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
13102
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
13107
13103
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
13108
13104
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
13109
13105
|
#
|
|
13110
|
-
# When using this
|
|
13106
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
13111
13107
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
13112
13108
|
# takes the form
|
|
13113
13109
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
13114
|
-
# When using this
|
|
13115
|
-
#
|
|
13116
|
-
#
|
|
13117
|
-
#
|
|
13110
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
13111
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
13112
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
13113
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
13118
13114
|
#
|
|
13119
13115
|
#
|
|
13120
13116
|
#
|
|
@@ -13247,10 +13243,10 @@ module Aws::S3
|
|
|
13247
13243
|
#
|
|
13248
13244
|
# The minimum allowable part size for a multipart upload is 5 MB. For
|
|
13249
13245
|
# more information about multipart upload limits, go to [Quick Facts][1]
|
|
13250
|
-
# in the *Amazon Simple Storage Service
|
|
13246
|
+
# in the *Amazon Simple Storage Service User Guide*.
|
|
13251
13247
|
#
|
|
13252
13248
|
# <note markdown="1"> Instead of using an existing object as part data, you might use the
|
|
13253
|
-
# [UploadPart][2]
|
|
13249
|
+
# [UploadPart][2] action and provide data in your request.
|
|
13254
13250
|
#
|
|
13255
13251
|
# </note>
|
|
13256
13252
|
#
|
|
@@ -13264,15 +13260,15 @@ module Aws::S3
|
|
|
13264
13260
|
#
|
|
13265
13261
|
# * For conceptual information about multipart uploads, see [Uploading
|
|
13266
13262
|
# Objects Using Multipart Upload][3] in the *Amazon Simple Storage
|
|
13267
|
-
# Service
|
|
13263
|
+
# Service User Guide*.
|
|
13268
13264
|
#
|
|
13269
13265
|
# * For information about permissions required to use the multipart
|
|
13270
|
-
# upload API, see [Multipart Upload
|
|
13271
|
-
#
|
|
13266
|
+
# upload API, see [Multipart Upload and Permissions][4] in the *Amazon
|
|
13267
|
+
# Simple Storage Service User Guide*.
|
|
13272
13268
|
#
|
|
13273
|
-
# * For information about copying objects using a single atomic
|
|
13274
|
-
#
|
|
13275
|
-
#
|
|
13269
|
+
# * For information about copying objects using a single atomic action
|
|
13270
|
+
# vs. the multipart upload, see [Operations on Objects][5] in the
|
|
13271
|
+
# *Amazon Simple Storage Service User Guide*.
|
|
13276
13272
|
#
|
|
13277
13273
|
# * For information about using server-side encryption with
|
|
13278
13274
|
# customer-provided encryption keys with the UploadPartCopy operation,
|
|
@@ -13374,22 +13370,22 @@ module Aws::S3
|
|
|
13374
13370
|
# @option params [required, String] :bucket
|
|
13375
13371
|
# The bucket name.
|
|
13376
13372
|
#
|
|
13377
|
-
# When using this
|
|
13378
|
-
# the access point hostname. The access point hostname takes the form
|
|
13373
|
+
# When using this action with an access point, you must direct requests
|
|
13374
|
+
# to the access point hostname. The access point hostname takes the form
|
|
13379
13375
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
|
13380
|
-
# When using this
|
|
13381
|
-
#
|
|
13376
|
+
# When using this action with an access point through the AWS SDKs, you
|
|
13377
|
+
# provide the access point ARN in place of the bucket name. For more
|
|
13382
13378
|
# information about access point ARNs, see [Using Access Points][1] in
|
|
13383
13379
|
# the *Amazon Simple Storage Service Developer Guide*.
|
|
13384
13380
|
#
|
|
13385
|
-
# When using this
|
|
13381
|
+
# When using this action with Amazon S3 on Outposts, you must direct
|
|
13386
13382
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
|
13387
13383
|
# takes the form
|
|
13388
13384
|
# *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
|
|
13389
|
-
# When using this
|
|
13390
|
-
#
|
|
13391
|
-
#
|
|
13392
|
-
#
|
|
13385
|
+
# When using this action using S3 on Outposts through the AWS SDKs, you
|
|
13386
|
+
# provide the Outposts bucket ARN in place of the bucket name. For more
|
|
13387
|
+
# information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
|
|
13388
|
+
# in the *Amazon Simple Storage Service Developer Guide*.
|
|
13393
13389
|
#
|
|
13394
13390
|
#
|
|
13395
13391
|
#
|
|
@@ -13538,45 +13534,45 @@ module Aws::S3
|
|
|
13538
13534
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
|
13539
13535
|
#
|
|
13540
13536
|
#
|
|
13541
|
-
# @example Example: To upload a part by copying
|
|
13537
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
|
13542
13538
|
#
|
|
13543
|
-
# # The following example uploads a part of a multipart upload by copying
|
|
13539
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
|
13540
|
+
# # data source.
|
|
13544
13541
|
#
|
|
13545
13542
|
# resp = client.upload_part_copy({
|
|
13546
13543
|
# bucket: "examplebucket",
|
|
13547
13544
|
# copy_source: "/bucketname/sourceobjectkey",
|
|
13545
|
+
# copy_source_range: "bytes=1-100000",
|
|
13548
13546
|
# key: "examplelargeobject",
|
|
13549
|
-
# part_number:
|
|
13547
|
+
# part_number: 2,
|
|
13550
13548
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
|
13551
13549
|
# })
|
|
13552
13550
|
#
|
|
13553
13551
|
# resp.to_h outputs the following:
|
|
13554
13552
|
# {
|
|
13555
13553
|
# copy_part_result: {
|
|
13556
|
-
# etag: "\"
|
|
13557
|
-
# last_modified: Time.parse("2016-12-29T21:
|
|
13554
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
|
13555
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
|
13558
13556
|
# },
|
|
13559
13557
|
# }
|
|
13560
13558
|
#
|
|
13561
|
-
# @example Example: To upload a part by copying
|
|
13559
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
|
13562
13560
|
#
|
|
13563
|
-
# # The following example uploads a part of a multipart upload by copying
|
|
13564
|
-
# # data source.
|
|
13561
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
|
13565
13562
|
#
|
|
13566
13563
|
# resp = client.upload_part_copy({
|
|
13567
13564
|
# bucket: "examplebucket",
|
|
13568
13565
|
# copy_source: "/bucketname/sourceobjectkey",
|
|
13569
|
-
# copy_source_range: "bytes=1-100000",
|
|
13570
13566
|
# key: "examplelargeobject",
|
|
13571
|
-
# part_number:
|
|
13567
|
+
# part_number: 1,
|
|
13572
13568
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
|
13573
13569
|
# })
|
|
13574
13570
|
#
|
|
13575
13571
|
# resp.to_h outputs the following:
|
|
13576
13572
|
# {
|
|
13577
13573
|
# copy_part_result: {
|
|
13578
|
-
# etag: "\"
|
|
13579
|
-
# last_modified: Time.parse("2016-12-29T21:
|
|
13574
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
|
13575
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
|
13580
13576
|
# },
|
|
13581
13577
|
# }
|
|
13582
13578
|
#
|
|
@@ -13638,7 +13634,7 @@ module Aws::S3
|
|
|
13638
13634
|
params: params,
|
|
13639
13635
|
config: config)
|
|
13640
13636
|
context[:gem_name] = 'aws-sdk-s3'
|
|
13641
|
-
context[:gem_version] = '1.
|
|
13637
|
+
context[:gem_version] = '1.91.0'
|
|
13642
13638
|
Seahorse::Client::Request.new(handlers, context)
|
|
13643
13639
|
end
|
|
13644
13640
|
|