aws-sdk-s3 1.88.1 → 1.105.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (53) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +833 -0
  3. data/LICENSE.txt +202 -0
  4. data/VERSION +1 -0
  5. data/lib/aws-sdk-s3/arn/access_point_arn.rb +14 -11
  6. data/lib/aws-sdk-s3/arn/multi_region_access_point_arn.rb +68 -0
  7. data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +69 -0
  8. data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +9 -10
  9. data/lib/aws-sdk-s3/bucket.rb +30 -29
  10. data/lib/aws-sdk-s3/bucket_acl.rb +9 -6
  11. data/lib/aws-sdk-s3/bucket_cors.rb +8 -7
  12. data/lib/aws-sdk-s3/bucket_lifecycle.rb +6 -5
  13. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +3 -3
  14. data/lib/aws-sdk-s3/bucket_logging.rb +6 -6
  15. data/lib/aws-sdk-s3/bucket_notification.rb +4 -4
  16. data/lib/aws-sdk-s3/bucket_policy.rb +6 -5
  17. data/lib/aws-sdk-s3/bucket_request_payment.rb +8 -8
  18. data/lib/aws-sdk-s3/bucket_tagging.rb +6 -5
  19. data/lib/aws-sdk-s3/bucket_versioning.rb +13 -10
  20. data/lib/aws-sdk-s3/bucket_website.rb +6 -5
  21. data/lib/aws-sdk-s3/client.rb +1823 -1323
  22. data/lib/aws-sdk-s3/client_api.rb +65 -1
  23. data/lib/aws-sdk-s3/customizations/bucket.rb +8 -3
  24. data/lib/aws-sdk-s3/customizations/object.rb +41 -16
  25. data/lib/aws-sdk-s3/encryption/client.rb +1 -1
  26. data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +0 -4
  27. data/lib/aws-sdk-s3/encryptionV2/client.rb +1 -1
  28. data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +0 -4
  29. data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +0 -4
  30. data/lib/aws-sdk-s3/errors.rb +1 -1
  31. data/lib/aws-sdk-s3/event_streams.rb +1 -1
  32. data/lib/aws-sdk-s3/file_downloader.rb +6 -1
  33. data/lib/aws-sdk-s3/file_uploader.rb +3 -3
  34. data/lib/aws-sdk-s3/multipart_upload.rb +7 -7
  35. data/lib/aws-sdk-s3/multipart_upload_part.rb +9 -8
  36. data/lib/aws-sdk-s3/object.rb +164 -75
  37. data/lib/aws-sdk-s3/object_acl.rb +10 -7
  38. data/lib/aws-sdk-s3/object_summary.rb +75 -71
  39. data/lib/aws-sdk-s3/object_version.rb +18 -17
  40. data/lib/aws-sdk-s3/plugins/accelerate.rb +7 -1
  41. data/lib/aws-sdk-s3/plugins/arn.rb +91 -42
  42. data/lib/aws-sdk-s3/plugins/bucket_dns.rb +1 -1
  43. data/lib/aws-sdk-s3/plugins/dualstack.rb +25 -31
  44. data/lib/aws-sdk-s3/plugins/get_bucket_location_fix.rb +1 -1
  45. data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +11 -10
  46. data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +25 -0
  47. data/lib/aws-sdk-s3/plugins/s3_signer.rb +35 -5
  48. data/lib/aws-sdk-s3/presigner.rb +19 -5
  49. data/lib/aws-sdk-s3/resource.rb +5 -3
  50. data/lib/aws-sdk-s3/types.rb +1397 -845
  51. data/lib/aws-sdk-s3/waiters.rb +1 -1
  52. data/lib/aws-sdk-s3.rb +2 -2
  53. metadata +17 -12
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -182,7 +182,7 @@ module Aws::S3
182
182
  # })
183
183
  # @param [Hash] options ({})
184
184
  # @option options [String] :expected_bucket_owner
185
- # The account id of the expected bucket owner. If the bucket is owned by
185
+ # The account ID of the expected bucket owner. If the bucket is owned by
186
186
  # a different account, the request will fail with an HTTP `403 (Access
187
187
  # Denied)` error.
188
188
  # @return [EmptyStructure]
@@ -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,8 +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 Developer
217
- # Guide*.
217
+ # Resource Sharing][1] in the *Amazon S3 User Guide*.
218
218
  #
219
219
  #
220
220
  #
@@ -224,14 +224,15 @@ module Aws::S3
224
224
  # used as a message integrity check to verify that the request body was
225
225
  # not corrupted in transit. For more information, go to [RFC 1864.][1]
226
226
  #
227
- # For requests made using the AWS Command Line Interface (CLI) or AWS
228
- # SDKs, this field is calculated automatically.
227
+ # For requests made using the Amazon Web Services Command Line Interface
228
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
229
+ # automatically.
229
230
  #
230
231
  #
231
232
  #
232
233
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
233
234
  # @option options [String] :expected_bucket_owner
234
- # The account id of the expected bucket owner. If the bucket is owned by
235
+ # The account ID of the expected bucket owner. If the bucket is owned by
235
236
  # a different account, the request will fail with an HTTP `403 (Access
236
237
  # Denied)` error.
237
238
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -181,7 +181,7 @@ module Aws::S3
181
181
  # })
182
182
  # @param [Hash] options ({})
183
183
  # @option options [String] :expected_bucket_owner
184
- # The account id of the expected bucket owner. If the bucket is owned by
184
+ # The account ID of the expected bucket owner. If the bucket is owned by
185
185
  # a different account, the request will fail with an HTTP `403 (Access
186
186
  # Denied)` error.
187
187
  # @return [EmptyStructure]
@@ -228,11 +228,12 @@ module Aws::S3
228
228
  # })
229
229
  # @param [Hash] options ({})
230
230
  # @option options [String] :content_md5
231
- # For requests made using the AWS Command Line Interface (CLI) or AWS
232
- # SDKs, this field is calculated automatically.
231
+ # For requests made using the Amazon Web Services Command Line Interface
232
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
233
+ # automatically.
233
234
  # @option options [Types::LifecycleConfiguration] :lifecycle_configuration
234
235
  # @option options [String] :expected_bucket_owner
235
- # The account id of the expected bucket owner. If the bucket is owned by
236
+ # The account ID of the expected bucket owner. If the bucket is owned by
236
237
  # a different account, the request will fail with an HTTP `403 (Access
237
238
  # Denied)` error.
238
239
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -181,7 +181,7 @@ module Aws::S3
181
181
  # })
182
182
  # @param [Hash] options ({})
183
183
  # @option options [String] :expected_bucket_owner
184
- # The account id of the expected bucket owner. If the bucket is owned by
184
+ # The account ID of the expected bucket owner. If the bucket is owned by
185
185
  # a different account, the request will fail with an HTTP `403 (Access
186
186
  # Denied)` error.
187
187
  # @return [EmptyStructure]
@@ -249,7 +249,7 @@ module Aws::S3
249
249
  # @option options [Types::BucketLifecycleConfiguration] :lifecycle_configuration
250
250
  # Container for lifecycle rules. You can add as many as 1,000 rules.
251
251
  # @option options [String] :expected_bucket_owner
252
- # The account id of the expected bucket owner. If the bucket is owned by
252
+ # The account ID of the expected bucket owner. If the bucket is owned by
253
253
  # a different account, the request will fail with an HTTP `403 (Access
254
254
  # Denied)` error.
255
255
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -36,8 +36,7 @@ module Aws::S3
36
36
 
37
37
  # Describes where logs are stored and the prefix that Amazon S3 assigns
38
38
  # to all log object keys for a bucket. For more information, see [PUT
39
- # Bucket logging][1] in the *Amazon Simple Storage Service API
40
- # Reference*.
39
+ # Bucket logging][1] in the *Amazon S3 API Reference*.
41
40
  #
42
41
  #
43
42
  #
@@ -211,10 +210,11 @@ module Aws::S3
211
210
  # @option options [String] :content_md5
212
211
  # The MD5 hash of the `PutBucketLogging` request body.
213
212
  #
214
- # For requests made using the AWS Command Line Interface (CLI) or AWS
215
- # SDKs, this field is calculated automatically.
213
+ # For requests made using the Amazon Web Services Command Line Interface
214
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
215
+ # automatically.
216
216
  # @option options [String] :expected_bucket_owner
217
- # The account id of the expected bucket owner. If the bucket is owned by
217
+ # The account ID of the expected bucket owner. If the bucket is owned by
218
218
  # a different account, the request will fail with an HTTP `403 (Access
219
219
  # Denied)` error.
220
220
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -48,8 +48,8 @@ module Aws::S3
48
48
  data[:queue_configurations]
49
49
  end
50
50
 
51
- # Describes the AWS Lambda functions to invoke and the events for which
52
- # to invoke them.
51
+ # Describes the Lambda functions to invoke and the events for which to
52
+ # invoke them.
53
53
  # @return [Array<Types::LambdaFunctionConfiguration>]
54
54
  def lambda_function_configurations
55
55
  data[:lambda_function_configurations]
@@ -253,7 +253,7 @@ module Aws::S3
253
253
  # bucket. If this element is empty, notifications are turned off for the
254
254
  # bucket.
255
255
  # @option options [String] :expected_bucket_owner
256
- # The account id of the expected bucket owner. If the bucket is owned by
256
+ # The account ID of the expected bucket owner. If the bucket is owned by
257
257
  # a different account, the request will fail with an HTTP `403 (Access
258
258
  # Denied)` error.
259
259
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -181,7 +181,7 @@ module Aws::S3
181
181
  # })
182
182
  # @param [Hash] options ({})
183
183
  # @option options [String] :expected_bucket_owner
184
- # The account id of the expected bucket owner. If the bucket is owned by
184
+ # The account ID of the expected bucket owner. If the bucket is owned by
185
185
  # a different account, the request will fail with an HTTP `403 (Access
186
186
  # Denied)` error.
187
187
  # @return [EmptyStructure]
@@ -203,15 +203,16 @@ module Aws::S3
203
203
  # @option options [String] :content_md5
204
204
  # The MD5 hash of the request body.
205
205
  #
206
- # For requests made using the AWS Command Line Interface (CLI) or AWS
207
- # SDKs, this field is calculated automatically.
206
+ # For requests made using the Amazon Web Services Command Line Interface
207
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
208
+ # automatically.
208
209
  # @option options [Boolean] :confirm_remove_self_bucket_access
209
210
  # Set this parameter to true to confirm that you want to remove your
210
211
  # permissions to change this bucket policy in the future.
211
212
  # @option options [required, String] :policy
212
213
  # The bucket policy as a JSON document.
213
214
  # @option options [String] :expected_bucket_owner
214
- # The account id of the expected bucket owner. If the bucket is owned by
215
+ # The account ID of the expected bucket owner. If the bucket is owned by
215
216
  # a different account, the request will fail with an HTTP `403 (Access
216
217
  # Denied)` error.
217
218
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -185,13 +185,13 @@ module Aws::S3
185
185
  # })
186
186
  # @param [Hash] options ({})
187
187
  # @option options [String] :content_md5
188
- # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
189
- # this header as a message integrity check to verify that the request
190
- # body was not corrupted in transit. For more information, see [RFC
191
- # 1864][1].
188
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
189
+ # header as a message integrity check to verify that the request body
190
+ # was not corrupted in transit. For more information, see [RFC 1864][1].
192
191
  #
193
- # For requests made using the AWS Command Line Interface (CLI) or AWS
194
- # SDKs, this field is calculated automatically.
192
+ # For requests made using the Amazon Web Services Command Line Interface
193
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
194
+ # automatically.
195
195
  #
196
196
  #
197
197
  #
@@ -199,7 +199,7 @@ module Aws::S3
199
199
  # @option options [required, Types::RequestPaymentConfiguration] :request_payment_configuration
200
200
  # Container for Payer.
201
201
  # @option options [String] :expected_bucket_owner
202
- # The account id of the expected bucket owner. If the bucket is owned by
202
+ # The account ID of the expected bucket owner. If the bucket is owned by
203
203
  # a different account, the request will fail with an HTTP `403 (Access
204
204
  # Denied)` error.
205
205
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -181,7 +181,7 @@ module Aws::S3
181
181
  # })
182
182
  # @param [Hash] options ({})
183
183
  # @option options [String] :expected_bucket_owner
184
- # The account id of the expected bucket owner. If the bucket is owned by
184
+ # The account ID of the expected bucket owner. If the bucket is owned by
185
185
  # a different account, the request will fail with an HTTP `403 (Access
186
186
  # Denied)` error.
187
187
  # @return [EmptyStructure]
@@ -211,8 +211,9 @@ module Aws::S3
211
211
  # header as a message integrity check to verify that the request body
212
212
  # was not corrupted in transit. For more information, see [RFC 1864][1].
213
213
  #
214
- # For requests made using the AWS Command Line Interface (CLI) or AWS
215
- # SDKs, this field is calculated automatically.
214
+ # For requests made using the Amazon Web Services Command Line Interface
215
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
216
+ # automatically.
216
217
  #
217
218
  #
218
219
  #
@@ -220,7 +221,7 @@ module Aws::S3
220
221
  # @option options [required, Types::Tagging] :tagging
221
222
  # Container for the `TagSet` and `Tag` elements.
222
223
  # @option options [String] :expected_bucket_owner
223
- # The account id of the expected bucket owner. If the bucket is owned by
224
+ # The account ID of the expected bucket owner. If the bucket is owned by
224
225
  # a different account, the request will fail with an HTTP `403 (Access
225
226
  # Denied)` error.
226
227
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -197,8 +197,9 @@ module Aws::S3
197
197
  # body was not corrupted in transit. For more information, see [RFC
198
198
  # 1864][1].
199
199
  #
200
- # For requests made using the AWS Command Line Interface (CLI) or AWS
201
- # SDKs, this field is calculated automatically.
200
+ # For requests made using the Amazon Web Services Command Line Interface
201
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
202
+ # automatically.
202
203
  #
203
204
  #
204
205
  #
@@ -207,7 +208,7 @@ module Aws::S3
207
208
  # The concatenation of the authentication device's serial number, a
208
209
  # space, and the value that is displayed on your authentication device.
209
210
  # @option options [String] :expected_bucket_owner
210
- # The account id of the expected bucket owner. If the bucket is owned by
211
+ # The account ID of the expected bucket owner. If the bucket is owned by
211
212
  # a different account, the request will fail with an HTTP `403 (Access
212
213
  # Denied)` error.
213
214
  # @return [EmptyStructure]
@@ -240,8 +241,9 @@ module Aws::S3
240
241
  # body was not corrupted in transit. For more information, see [RFC
241
242
  # 1864][1].
242
243
  #
243
- # For requests made using the AWS Command Line Interface (CLI) or AWS
244
- # SDKs, this field is calculated automatically.
244
+ # For requests made using the Amazon Web Services Command Line Interface
245
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
246
+ # automatically.
245
247
  #
246
248
  #
247
249
  #
@@ -252,7 +254,7 @@ module Aws::S3
252
254
  # @option options [required, Types::VersioningConfiguration] :versioning_configuration
253
255
  # Container for setting the versioning state.
254
256
  # @option options [String] :expected_bucket_owner
255
- # The account id of the expected bucket owner. If the bucket is owned by
257
+ # The account ID of the expected bucket owner. If the bucket is owned by
256
258
  # a different account, the request will fail with an HTTP `403 (Access
257
259
  # Denied)` error.
258
260
  # @return [EmptyStructure]
@@ -276,8 +278,9 @@ module Aws::S3
276
278
  # body was not corrupted in transit. For more information, see [RFC
277
279
  # 1864][1].
278
280
  #
279
- # For requests made using the AWS Command Line Interface (CLI) or AWS
280
- # SDKs, this field is calculated automatically.
281
+ # For requests made using the Amazon Web Services Command Line Interface
282
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
283
+ # automatically.
281
284
  #
282
285
  #
283
286
  #
@@ -286,7 +289,7 @@ module Aws::S3
286
289
  # The concatenation of the authentication device's serial number, a
287
290
  # space, and the value that is displayed on your authentication device.
288
291
  # @option options [String] :expected_bucket_owner
289
- # The account id of the expected bucket owner. If the bucket is owned by
292
+ # The account ID of the expected bucket owner. If the bucket is owned by
290
293
  # a different account, the request will fail with an HTTP `403 (Access
291
294
  # Denied)` error.
292
295
  # @return [EmptyStructure]
@@ -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/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -203,7 +203,7 @@ module Aws::S3
203
203
  # })
204
204
  # @param [Hash] options ({})
205
205
  # @option options [String] :expected_bucket_owner
206
- # The account id of the expected bucket owner. If the bucket is owned by
206
+ # The account ID of the expected bucket owner. If the bucket is owned by
207
207
  # a different account, the request will fail with an HTTP `403 (Access
208
208
  # Denied)` error.
209
209
  # @return [EmptyStructure]
@@ -252,8 +252,9 @@ module Aws::S3
252
252
  # header as a message integrity check to verify that the request body
253
253
  # was not corrupted in transit. For more information, see [RFC 1864][1].
254
254
  #
255
- # For requests made using the AWS Command Line Interface (CLI) or AWS
256
- # SDKs, this field is calculated automatically.
255
+ # For requests made using the Amazon Web Services Command Line Interface
256
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
257
+ # automatically.
257
258
  #
258
259
  #
259
260
  #
@@ -261,7 +262,7 @@ module Aws::S3
261
262
  # @option options [required, Types::WebsiteConfiguration] :website_configuration
262
263
  # Container for the request.
263
264
  # @option options [String] :expected_bucket_owner
264
- # The account id of the expected bucket owner. If the bucket is owned by
265
+ # The account ID of the expected bucket owner. If the bucket is owned by
265
266
  # a different account, the request will fail with an HTTP `403 (Access
266
267
  # Denied)` error.
267
268
  # @return [EmptyStructure]