aws-sdk-s3 1.36.0 → 1.95.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/CHANGELOG.md +768 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-s3/arn/access_point_arn.rb +69 -0
- data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +69 -0
- data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +73 -0
- data/lib/aws-sdk-s3/bucket.rb +277 -76
- data/lib/aws-sdk-s3/bucket_acl.rb +40 -15
- data/lib/aws-sdk-s3/bucket_cors.rb +50 -14
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +33 -14
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +32 -14
- data/lib/aws-sdk-s3/bucket_logging.rb +35 -15
- data/lib/aws-sdk-s3/bucket_notification.rb +32 -18
- data/lib/aws-sdk-s3/bucket_policy.rb +34 -13
- data/lib/aws-sdk-s3/bucket_region_cache.rb +2 -0
- data/lib/aws-sdk-s3/bucket_request_payment.rb +34 -12
- data/lib/aws-sdk-s3/bucket_tagging.rb +42 -14
- data/lib/aws-sdk-s3/bucket_versioning.rb +67 -12
- data/lib/aws-sdk-s3/bucket_website.rb +49 -17
- data/lib/aws-sdk-s3/client.rb +7494 -618
- data/lib/aws-sdk-s3/client_api.rb +417 -2
- data/lib/aws-sdk-s3/customizations/bucket.rb +59 -16
- data/lib/aws-sdk-s3/customizations/multipart_upload.rb +2 -0
- data/lib/aws-sdk-s3/customizations/object.rb +125 -60
- data/lib/aws-sdk-s3/customizations/object_summary.rb +5 -0
- data/lib/aws-sdk-s3/customizations/types/list_object_versions_output.rb +2 -0
- data/lib/aws-sdk-s3/customizations.rb +4 -1
- data/lib/aws-sdk-s3/encryption/client.rb +22 -5
- data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +72 -26
- data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +43 -5
- data/lib/aws-sdk-s3/encryption/default_key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +13 -2
- data/lib/aws-sdk-s3/encryption/errors.rb +2 -0
- data/lib/aws-sdk-s3/encryption/io_auth_decrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryption/io_decrypter.rb +11 -3
- data/lib/aws-sdk-s3/encryption/io_encrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryption/key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +34 -3
- data/lib/aws-sdk-s3/encryption/materials.rb +8 -6
- data/lib/aws-sdk-s3/encryption/utils.rb +25 -0
- data/lib/aws-sdk-s3/encryption.rb +4 -0
- data/lib/aws-sdk-s3/encryptionV2/client.rb +566 -0
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +226 -0
- data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +170 -0
- data/lib/aws-sdk-s3/encryptionV2/default_key_provider.rb +40 -0
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +69 -0
- data/lib/aws-sdk-s3/encryptionV2/errors.rb +37 -0
- data/lib/aws-sdk-s3/encryptionV2/io_auth_decrypter.rb +58 -0
- data/lib/aws-sdk-s3/encryptionV2/io_decrypter.rb +37 -0
- data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +73 -0
- data/lib/aws-sdk-s3/encryptionV2/key_provider.rb +31 -0
- data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +169 -0
- data/lib/aws-sdk-s3/encryptionV2/materials.rb +60 -0
- data/lib/aws-sdk-s3/encryptionV2/utils.rb +103 -0
- data/lib/aws-sdk-s3/encryption_v2.rb +23 -0
- data/lib/aws-sdk-s3/errors.rb +123 -1
- data/lib/aws-sdk-s3/event_streams.rb +15 -8
- data/lib/aws-sdk-s3/file_downloader.rb +10 -8
- data/lib/aws-sdk-s3/file_part.rb +11 -6
- data/lib/aws-sdk-s3/file_uploader.rb +28 -14
- data/lib/aws-sdk-s3/legacy_signer.rb +17 -25
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +53 -13
- data/lib/aws-sdk-s3/multipart_stream_uploader.rb +20 -7
- data/lib/aws-sdk-s3/multipart_upload.rb +64 -29
- data/lib/aws-sdk-s3/multipart_upload_error.rb +2 -0
- data/lib/aws-sdk-s3/multipart_upload_part.rb +115 -42
- data/lib/aws-sdk-s3/object.rb +656 -151
- data/lib/aws-sdk-s3/object_acl.rb +64 -21
- data/lib/aws-sdk-s3/object_copier.rb +2 -0
- data/lib/aws-sdk-s3/object_multipart_copier.rb +2 -0
- data/lib/aws-sdk-s3/object_summary.rb +474 -138
- data/lib/aws-sdk-s3/object_version.rb +122 -58
- data/lib/aws-sdk-s3/plugins/accelerate.rb +32 -38
- data/lib/aws-sdk-s3/plugins/arn.rb +228 -0
- data/lib/aws-sdk-s3/plugins/bucket_dns.rb +7 -7
- data/lib/aws-sdk-s3/plugins/bucket_name_restrictions.rb +25 -3
- data/lib/aws-sdk-s3/plugins/dualstack.rb +15 -4
- data/lib/aws-sdk-s3/plugins/expect_100_continue.rb +4 -4
- data/lib/aws-sdk-s3/plugins/get_bucket_location_fix.rb +2 -0
- data/lib/aws-sdk-s3/plugins/http_200_errors.rb +11 -3
- data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +67 -0
- data/lib/aws-sdk-s3/plugins/location_constraint.rb +2 -0
- data/lib/aws-sdk-s3/plugins/md5s.rb +30 -28
- data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +25 -0
- data/lib/aws-sdk-s3/plugins/redirects.rb +2 -0
- data/lib/aws-sdk-s3/plugins/s3_host_id.rb +2 -0
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +64 -35
- data/lib/aws-sdk-s3/plugins/sse_cpk.rb +3 -1
- data/lib/aws-sdk-s3/plugins/streaming_retry.rb +118 -0
- data/lib/aws-sdk-s3/plugins/url_encoded_keys.rb +2 -0
- data/lib/aws-sdk-s3/presigned_post.rb +72 -32
- data/lib/aws-sdk-s3/presigner.rb +162 -66
- data/lib/aws-sdk-s3/resource.rb +23 -5
- data/lib/aws-sdk-s3/types.rb +6441 -952
- data/lib/aws-sdk-s3/waiters.rb +67 -1
- data/lib/aws-sdk-s3.rb +12 -6
- metadata +35 -12
data/lib/aws-sdk-s3/presigner.rb
CHANGED
@@ -1,27 +1,47 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
module Aws
|
2
4
|
module S3
|
3
|
-
|
4
|
-
# Allows you to create presigned URLs for S3 operations.
|
5
|
-
#
|
6
|
-
# Example Use:
|
7
|
-
#
|
8
|
-
# signer = Aws::S3::Presigner.new
|
9
|
-
# url = signer.presigned_url(:get_object, bucket: "bucket", key: "key")
|
10
|
-
#
|
11
5
|
class Presigner
|
12
|
-
|
13
6
|
# @api private
|
14
7
|
ONE_WEEK = 60 * 60 * 24 * 7
|
15
8
|
|
16
9
|
# @api private
|
17
10
|
FIFTEEN_MINUTES = 60 * 15
|
18
11
|
|
12
|
+
# @api private
|
13
|
+
BLACKLISTED_HEADERS = [
|
14
|
+
'accept',
|
15
|
+
'amz-sdk-request',
|
16
|
+
'cache-control',
|
17
|
+
'content-length', # due to a ELB bug
|
18
|
+
'expect',
|
19
|
+
'from',
|
20
|
+
'if-match',
|
21
|
+
'if-none-match',
|
22
|
+
'if-modified-since',
|
23
|
+
'if-unmodified-since',
|
24
|
+
'if-range',
|
25
|
+
'max-forwards',
|
26
|
+
'pragma',
|
27
|
+
'proxy-authorization',
|
28
|
+
'referer',
|
29
|
+
'te',
|
30
|
+
'user-agent'
|
31
|
+
].freeze
|
32
|
+
|
19
33
|
# @option options [Client] :client Optionally provide an existing
|
20
34
|
# S3 client
|
21
35
|
def initialize(options = {})
|
22
36
|
@client = options[:client] || Aws::S3::Client.new
|
23
37
|
end
|
24
38
|
|
39
|
+
# Create presigned URLs for S3 operations.
|
40
|
+
#
|
41
|
+
# @example
|
42
|
+
# signer = Aws::S3::Presigner.new
|
43
|
+
# url = signer.presigned_url(:get_object, bucket: "bucket", key: "key")
|
44
|
+
#
|
25
45
|
# @param [Symbol] method Symbolized method name of the operation you want
|
26
46
|
# to presign.
|
27
47
|
#
|
@@ -31,6 +51,56 @@ module Aws
|
|
31
51
|
# attempts to set this value to greater than one week (604800) will
|
32
52
|
# raise an exception.
|
33
53
|
#
|
54
|
+
# @option params [Time] :time (Time.now) The starting time for when the
|
55
|
+
# presigned url becomes active.
|
56
|
+
#
|
57
|
+
# @option params [Boolean] :secure (true) When `false`, a HTTP URL
|
58
|
+
# is returned instead of the default HTTPS URL.
|
59
|
+
#
|
60
|
+
# @option params [Boolean] :virtual_host (false) When `true`, the
|
61
|
+
# bucket name will be used as the hostname.
|
62
|
+
#
|
63
|
+
# @option params [Boolean] :use_accelerate_endpoint (false) When `true`,
|
64
|
+
# Presigner will attempt to use accelerated endpoint.
|
65
|
+
#
|
66
|
+
# @option params [Array<String>] :whitelist_headers ([]) Additional
|
67
|
+
# headers to be included for the signed request. Certain headers beyond
|
68
|
+
# the authorization header could, in theory, be changed for various
|
69
|
+
# reasons (including but not limited to proxies) while in transit and
|
70
|
+
# after signing. This would lead to signature errors being returned,
|
71
|
+
# despite no actual problems with signing. (see BLACKLISTED_HEADERS)
|
72
|
+
#
|
73
|
+
# @raise [ArgumentError] Raises an ArgumentError if `:expires_in`
|
74
|
+
# exceeds one week.
|
75
|
+
#
|
76
|
+
# @return [String] a presigned url
|
77
|
+
def presigned_url(method, params = {})
|
78
|
+
url, _headers = _presigned_request(method, params)
|
79
|
+
url
|
80
|
+
end
|
81
|
+
|
82
|
+
# Allows you to create presigned URL requests for S3 operations. This
|
83
|
+
# method returns a tuple containing the URL and the signed X-amz-* headers
|
84
|
+
# to be used with the presigned url.
|
85
|
+
#
|
86
|
+
# @example
|
87
|
+
# signer = Aws::S3::Presigner.new
|
88
|
+
# url, headers = signer.presigned_request(
|
89
|
+
# :get_object, bucket: "bucket", key: "key"
|
90
|
+
# )
|
91
|
+
#
|
92
|
+
# @param [Symbol] method Symbolized method name of the operation you want
|
93
|
+
# to presign.
|
94
|
+
#
|
95
|
+
# @option params [Integer] :expires_in (900) The number of seconds
|
96
|
+
# before the presigned URL expires. Defaults to 15 minutes. As signature
|
97
|
+
# version 4 has a maximum expiry time of one week for presigned URLs,
|
98
|
+
# attempts to set this value to greater than one week (604800) will
|
99
|
+
# raise an exception.
|
100
|
+
#
|
101
|
+
# @option params [Time] :time (Time.now) The starting time for when the
|
102
|
+
# presigned url becomes active.
|
103
|
+
#
|
34
104
|
# @option params [Boolean] :secure (true) When `false`, a HTTP URL
|
35
105
|
# is returned instead of the default HTTPS URL.
|
36
106
|
#
|
@@ -38,29 +108,51 @@ module Aws
|
|
38
108
|
# bucket name will be used as the hostname. This will cause
|
39
109
|
# the returned URL to be 'http' and not 'https'.
|
40
110
|
#
|
41
|
-
# @option params [Boolean] :use_accelerate_endpoint (false) When `true`,
|
42
|
-
# will attempt to use accelerated endpoint
|
111
|
+
# @option params [Boolean] :use_accelerate_endpoint (false) When `true`,
|
112
|
+
# Presigner will attempt to use accelerated endpoint.
|
113
|
+
#
|
114
|
+
# @option params [Array<String>] :whitelist_headers ([]) Additional
|
115
|
+
# headers to be included for the signed request. Certain headers beyond
|
116
|
+
# the authorization header could, in theory, be changed for various
|
117
|
+
# reasons (including but not limited to proxies) while in transit and
|
118
|
+
# after signing. This would lead to signature errors being returned,
|
119
|
+
# despite no actual problems with signing. (see BLACKLISTED_HEADERS)
|
43
120
|
#
|
44
121
|
# @raise [ArgumentError] Raises an ArgumentError if `:expires_in`
|
45
122
|
# exceeds one week.
|
46
123
|
#
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
124
|
+
# @return [String, Hash] A tuple with a presigned URL and headers that
|
125
|
+
# should be included with the request.
|
126
|
+
def presigned_request(method, params = {})
|
127
|
+
_presigned_request(method, params, false)
|
128
|
+
end
|
129
|
+
|
130
|
+
private
|
131
|
+
|
132
|
+
def _presigned_request(method, params, hoist = true)
|
133
|
+
virtual_host = params.delete(:virtual_host)
|
134
|
+
time = params.delete(:time)
|
135
|
+
unsigned_headers = unsigned_headers(params)
|
136
|
+
scheme = http_scheme(params)
|
137
|
+
expires_in = expires_in(params)
|
53
138
|
|
54
139
|
req = @client.build_request(method, params)
|
55
140
|
use_bucket_as_hostname(req) if virtual_host
|
56
|
-
|
57
|
-
|
141
|
+
handle_presigned_url_context(req)
|
142
|
+
|
143
|
+
x_amz_headers = sign_but_dont_send(
|
144
|
+
req, expires_in, scheme, time, unsigned_headers, hoist
|
145
|
+
)
|
146
|
+
[req.send_request.data, x_amz_headers]
|
58
147
|
end
|
59
148
|
|
60
|
-
|
149
|
+
def unsigned_headers(params)
|
150
|
+
whitelist_headers = params.delete(:whitelist_headers) || []
|
151
|
+
BLACKLISTED_HEADERS - whitelist_headers
|
152
|
+
end
|
61
153
|
|
62
|
-
def http_scheme(params
|
63
|
-
if params.delete(:secure) == false
|
154
|
+
def http_scheme(params)
|
155
|
+
if params.delete(:secure) == false
|
64
156
|
'http'
|
65
157
|
else
|
66
158
|
@client.config.endpoint.scheme
|
@@ -68,10 +160,13 @@ module Aws
|
|
68
160
|
end
|
69
161
|
|
70
162
|
def expires_in(params)
|
71
|
-
if expires_in = params.delete(:expires_in)
|
163
|
+
if (expires_in = params.delete(:expires_in))
|
72
164
|
if expires_in > ONE_WEEK
|
73
|
-
|
74
|
-
|
165
|
+
raise ArgumentError,
|
166
|
+
"expires_in value of #{expires_in} exceeds one-week maximum."
|
167
|
+
elsif expires_in <= 0
|
168
|
+
raise ArgumentError,
|
169
|
+
"expires_in value of #{expires_in} cannot be 0 or less."
|
75
170
|
end
|
76
171
|
expires_in
|
77
172
|
else
|
@@ -85,14 +180,26 @@ module Aws
|
|
85
180
|
uri = context.http_request.endpoint
|
86
181
|
uri.host = context.params[:bucket]
|
87
182
|
uri.path.sub!("/#{context.params[:bucket]}", '')
|
88
|
-
|
89
|
-
|
183
|
+
@handler.call(context)
|
184
|
+
end
|
185
|
+
end
|
186
|
+
|
187
|
+
# Used for excluding presigned_urls from API request count.
|
188
|
+
#
|
189
|
+
# Store context information as early as possible, to allow
|
190
|
+
# handlers to perform decisions based on this flag if need.
|
191
|
+
def handle_presigned_url_context(req)
|
192
|
+
req.handle(step: :initialize, priority: 98) do |context|
|
193
|
+
context[:presigned_url] = true
|
90
194
|
@handler.call(context)
|
91
195
|
end
|
92
196
|
end
|
93
197
|
|
94
198
|
# @param [Seahorse::Client::Request] req
|
95
|
-
def sign_but_dont_send(
|
199
|
+
def sign_but_dont_send(
|
200
|
+
req, expires_in, scheme, time, unsigned_headers, hoist = true
|
201
|
+
)
|
202
|
+
x_amz_headers = {}
|
96
203
|
|
97
204
|
http_req = req.context.http_request
|
98
205
|
|
@@ -100,11 +207,7 @@ module Aws
|
|
100
207
|
req.handlers.remove(Aws::S3::Plugins::S3Signer::V4Handler)
|
101
208
|
req.handlers.remove(Seahorse::Client::Plugins::ContentLength::Handler)
|
102
209
|
|
103
|
-
signer = build_signer(req.context.config)
|
104
|
-
req.context[:presigned_url] = true
|
105
|
-
|
106
210
|
req.handle(step: :send) do |context|
|
107
|
-
|
108
211
|
if scheme != http_req.endpoint.scheme
|
109
212
|
endpoint = http_req.endpoint.dup
|
110
213
|
endpoint.scheme = scheme
|
@@ -112,57 +215,50 @@ module Aws
|
|
112
215
|
http_req.endpoint = URI.parse(endpoint.to_s)
|
113
216
|
end
|
114
217
|
|
115
|
-
# hoist x-amz-* headers to the querystring
|
116
218
|
query = http_req.endpoint.query ? http_req.endpoint.query.split('&') : []
|
117
|
-
http_req.headers.
|
118
|
-
|
119
|
-
|
219
|
+
http_req.headers.each do |key, value|
|
220
|
+
next unless key =~ /^x-amz/i
|
221
|
+
|
222
|
+
if hoist
|
223
|
+
value = Aws::Sigv4::Signer.uri_escape(value)
|
120
224
|
key = Aws::Sigv4::Signer.uri_escape(key)
|
225
|
+
# hoist x-amz-* headers to the querystring
|
226
|
+
http_req.headers.delete(key)
|
121
227
|
query << "#{key}=#{value}"
|
228
|
+
else
|
229
|
+
x_amz_headers[key] = value
|
122
230
|
end
|
123
231
|
end
|
124
232
|
http_req.endpoint.query = query.join('&') unless query.empty?
|
125
233
|
|
234
|
+
# If it's an ARN, get the resolved region and service
|
235
|
+
if (arn = context.metadata[:s3_arn])
|
236
|
+
region = arn[:resolved_region]
|
237
|
+
service = arn[:arn].service
|
238
|
+
end
|
239
|
+
|
240
|
+
signer = Aws::Sigv4::Signer.new(
|
241
|
+
service: service || 's3',
|
242
|
+
region: region || context.config.region,
|
243
|
+
credentials_provider: context.config.credentials,
|
244
|
+
unsigned_headers: unsigned_headers,
|
245
|
+
uri_escape_path: false
|
246
|
+
)
|
247
|
+
|
126
248
|
url = signer.presign_url(
|
127
249
|
http_method: http_req.http_method,
|
128
250
|
url: http_req.endpoint,
|
129
251
|
headers: http_req.headers,
|
130
252
|
body_digest: 'UNSIGNED-PAYLOAD',
|
131
|
-
expires_in: expires_in
|
253
|
+
expires_in: expires_in,
|
254
|
+
time: time
|
132
255
|
).to_s
|
133
256
|
|
134
257
|
Seahorse::Client::Response.new(context: context, data: url)
|
135
258
|
end
|
259
|
+
# Return the headers
|
260
|
+
x_amz_headers
|
136
261
|
end
|
137
|
-
|
138
|
-
def build_signer(cfg)
|
139
|
-
Aws::Sigv4::Signer.new(
|
140
|
-
service: 's3',
|
141
|
-
region: cfg.region,
|
142
|
-
credentials_provider: cfg.credentials,
|
143
|
-
unsigned_headers: [
|
144
|
-
'cache-control',
|
145
|
-
'content-length', # due to a ELB bug
|
146
|
-
'expect',
|
147
|
-
'max-forwards',
|
148
|
-
'pragma',
|
149
|
-
'te',
|
150
|
-
'if-match',
|
151
|
-
'if-none-match',
|
152
|
-
'if-modified-since',
|
153
|
-
'if-unmodified-since',
|
154
|
-
'if-range',
|
155
|
-
'accept',
|
156
|
-
'proxy-authorization',
|
157
|
-
'from',
|
158
|
-
'referer',
|
159
|
-
'user-agent',
|
160
|
-
'x-amzn-trace-id'
|
161
|
-
],
|
162
|
-
uri_escape_path: false
|
163
|
-
)
|
164
|
-
end
|
165
|
-
|
166
262
|
end
|
167
263
|
end
|
168
264
|
end
|
data/lib/aws-sdk-s3/resource.rb
CHANGED
@@ -1,11 +1,25 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
# WARNING ABOUT GENERATED CODE
|
2
4
|
#
|
3
5
|
# This file is generated. See the contributing guide for more information:
|
4
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
5
7
|
#
|
6
8
|
# WARNING ABOUT GENERATED CODE
|
7
9
|
|
8
10
|
module Aws::S3
|
11
|
+
|
12
|
+
# This class provides a resource oriented interface for S3.
|
13
|
+
# To create a resource object:
|
14
|
+
#
|
15
|
+
# resource = Aws::S3::Resource.new(region: 'us-west-2')
|
16
|
+
#
|
17
|
+
# You can supply a client object with custom configuration that will be used for all resource operations.
|
18
|
+
# If you do not pass `:client`, a default client will be constructed.
|
19
|
+
#
|
20
|
+
# client = Aws::S3::Client.new(region: 'us-west-2')
|
21
|
+
# resource = Aws::S3::Resource.new(client: client)
|
22
|
+
#
|
9
23
|
class Resource
|
10
24
|
|
11
25
|
# @param options ({})
|
@@ -27,7 +41,7 @@ module Aws::S3
|
|
27
41
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
28
42
|
# bucket: "BucketName", # required
|
29
43
|
# create_bucket_configuration: {
|
30
|
-
# location_constraint: "
|
44
|
+
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
31
45
|
# },
|
32
46
|
# grant_full_control: "GrantFullControl",
|
33
47
|
# grant_read: "GrantRead",
|
@@ -40,7 +54,9 @@ module Aws::S3
|
|
40
54
|
# @option options [String] :acl
|
41
55
|
# The canned ACL to apply to the bucket.
|
42
56
|
# @option options [required, String] :bucket
|
57
|
+
# The name of the bucket to create.
|
43
58
|
# @option options [Types::CreateBucketConfiguration] :create_bucket_configuration
|
59
|
+
# The configuration information for the bucket.
|
44
60
|
# @option options [String] :grant_full_control
|
45
61
|
# Allows grantee the read, write, read ACP, and write ACP permissions on
|
46
62
|
# the bucket.
|
@@ -49,8 +65,10 @@ module Aws::S3
|
|
49
65
|
# @option options [String] :grant_read_acp
|
50
66
|
# Allows grantee to read the bucket ACL.
|
51
67
|
# @option options [String] :grant_write
|
52
|
-
# Allows grantee to create
|
53
|
-
#
|
68
|
+
# Allows grantee to create new objects in the bucket.
|
69
|
+
#
|
70
|
+
# For the bucket and object owners of existing objects, also allows
|
71
|
+
# deletions and overwrites of those objects.
|
54
72
|
# @option options [String] :grant_write_acp
|
55
73
|
# Allows grantee to write the ACL for the applicable bucket.
|
56
74
|
# @option options [Boolean] :object_lock_enabled_for_bucket
|
@@ -58,7 +76,7 @@ module Aws::S3
|
|
58
76
|
# bucket.
|
59
77
|
# @return [Bucket]
|
60
78
|
def create_bucket(options = {})
|
61
|
-
|
79
|
+
@client.create_bucket(options)
|
62
80
|
Bucket.new(
|
63
81
|
name: options[:bucket],
|
64
82
|
client: @client
|