aws-sdk-s3 1.91.0 → 1.94.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (36) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +29 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3.rb +1 -1
  5. data/lib/aws-sdk-s3/arn/access_point_arn.rb +4 -6
  6. data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +64 -0
  7. data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +4 -6
  8. data/lib/aws-sdk-s3/bucket.rb +6 -6
  9. data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
  10. data/lib/aws-sdk-s3/bucket_cors.rb +3 -4
  11. data/lib/aws-sdk-s3/bucket_lifecycle.rb +2 -2
  12. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +2 -2
  13. data/lib/aws-sdk-s3/bucket_logging.rb +1 -1
  14. data/lib/aws-sdk-s3/bucket_notification.rb +1 -1
  15. data/lib/aws-sdk-s3/bucket_policy.rb +2 -2
  16. data/lib/aws-sdk-s3/bucket_request_payment.rb +1 -1
  17. data/lib/aws-sdk-s3/bucket_tagging.rb +2 -2
  18. data/lib/aws-sdk-s3/bucket_versioning.rb +3 -3
  19. data/lib/aws-sdk-s3/bucket_website.rb +2 -2
  20. data/lib/aws-sdk-s3/client.rb +758 -482
  21. data/lib/aws-sdk-s3/client_api.rb +58 -0
  22. data/lib/aws-sdk-s3/customizations/object.rb +30 -11
  23. data/lib/aws-sdk-s3/file_uploader.rb +2 -2
  24. data/lib/aws-sdk-s3/multipart_upload.rb +3 -3
  25. data/lib/aws-sdk-s3/multipart_upload_part.rb +4 -4
  26. data/lib/aws-sdk-s3/object.rb +96 -10
  27. data/lib/aws-sdk-s3/object_acl.rb +1 -1
  28. data/lib/aws-sdk-s3/object_summary.rb +9 -9
  29. data/lib/aws-sdk-s3/object_version.rb +4 -4
  30. data/lib/aws-sdk-s3/plugins/arn.rb +57 -34
  31. data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +9 -9
  32. data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +25 -0
  33. data/lib/aws-sdk-s3/plugins/s3_signer.rb +6 -0
  34. data/lib/aws-sdk-s3/presigner.rb +12 -3
  35. data/lib/aws-sdk-s3/types.rb +567 -243
  36. metadata +7 -6
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 636ac1e884ea1d364e0b61e983f2909ca410a2ae75dc47bff647702fe44b50b9
4
- data.tar.gz: d346da52b018b74a81dcbe6562484b549fc510839df04ddf5f8be3a7a293c08b
3
+ metadata.gz: 9ce5ec00762e55e690d481b9b204ed60e801ccb615a02dc75143a51c43cc4f71
4
+ data.tar.gz: 792694ad4064f09de5b5d505f46c5aeac024eb75dbfd2866294df01ff8bf2f6c
5
5
  SHA512:
6
- metadata.gz: ad99171231e4947f5ba29716d83af34a1caa45ed08a32c09ef824cb1ef9d723de8a9e0722d3c05c9cbaabf4dda4fbc300f84bd84b765a16ae51c21633fa8e358
7
- data.tar.gz: fb2ec2f3d14b98adcc4111dd615b27f19498d509321beb9f7d944bec4375ff374a06c5931806205226387cdc7f4e604ebd3f9e0182b515093bb7f29431f1b3ca
6
+ metadata.gz: 9e968125f14dce1b6d3216c7429e0032a208812beb90e879be41c61b9dea09ecc9d87954d0aa81f324c7abd67facaf77b1e74b0fbe7869fcedf293a6f258c2ad
7
+ data.tar.gz: 694e1f8d67abe81aad12733d58442ff8fcca505cfce8b79941cd5d790e99c4dc23e52884984519a1c9709d0472c2301ea8ec00295bd4cb848609492937525255
data/CHANGELOG.md CHANGED
@@ -1,6 +1,35 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.94.1 (2021-05-05)
5
+ ------------------
6
+
7
+ * Issue - Expose presigned request status to the request handler stack #2513
8
+
9
+ 1.94.0 (2021-04-27)
10
+ ------------------
11
+
12
+ * Feature - Allow S3 Presigner to sign non http verbs like (upload_part, multipart_upload_abort, etc.) #2511
13
+
14
+ 1.93.1 (2021-04-12)
15
+ ------------------
16
+
17
+ * Issue - Fix FIPS and global endpoint behavior for S3 ARNs.
18
+
19
+ * Issue - Increases `multipart_threshold` default from 15 megabytes to 100 megabytes.
20
+
21
+ 1.93.0 (2021-03-24)
22
+ ------------------
23
+
24
+ * Feature - Documentation updates for Amazon S3
25
+
26
+ 1.92.0 (2021-03-18)
27
+ ------------------
28
+
29
+ * Feature - S3 Object Lambda is a new S3 feature that enables users to apply their own custom code to process the output of a standard S3 GET request by automatically invoking a Lambda function with a GET request
30
+
31
+ * Feature - Support S3 Object Lambda ARNs in the `bucket:` parameter.
32
+
4
33
  1.91.0 (2021-03-10)
5
34
  ------------------
6
35
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.91.0
1
+ 1.94.1
data/lib/aws-sdk-s3.rb CHANGED
@@ -69,6 +69,6 @@ require_relative 'aws-sdk-s3/event_streams'
69
69
  # @!group service
70
70
  module Aws::S3
71
71
 
72
- GEM_VERSION = '1.91.0'
72
+ GEM_VERSION = '1.94.1'
73
73
 
74
74
  end
@@ -9,8 +9,6 @@ module Aws
9
9
  @type, @access_point_name, @extra = @resource.split(/[:,\/]/)
10
10
  end
11
11
 
12
- attr_reader :access_point_name
13
-
14
12
  def support_dualstack?
15
13
  true
16
14
  end
@@ -21,12 +19,12 @@ module Aws
21
19
 
22
20
  def validate_arn!
23
21
  unless @service == 's3'
24
- raise ArgumentError, 'Must provide a valid S3 accesspoint ARN.'
22
+ raise ArgumentError, 'Must provide a valid S3 Access Point ARN.'
25
23
  end
26
24
 
27
25
  if @region.empty? || @account_id.empty?
28
26
  raise ArgumentError,
29
- 'S3 accesspoint ARNs must contain both a region '\
27
+ 'S3 Access Point ARNs must contain both a region '\
30
28
  'and an account id.'
31
29
  end
32
30
 
@@ -52,13 +50,13 @@ module Aws
52
50
  end
53
51
  end
54
52
 
55
- def host_url(region, dualstack = false, custom_endpoint = nil)
53
+ def host_url(region, fips = false, dualstack = false, custom_endpoint = nil)
56
54
  pfx = "#{@access_point_name}-#{@account_id}"
57
55
  if custom_endpoint
58
56
  "#{pfx}.#{custom_endpoint}"
59
57
  else
60
58
  sfx = Aws::Partitions::EndpointProvider.dns_suffix_for(region)
61
- "#{pfx}.s3-accesspoint#{'.dualstack' if dualstack}.#{region}.#{sfx}"
59
+ "#{pfx}.s3-accesspoint#{'-fips' if fips}#{'.dualstack' if dualstack}.#{region}.#{sfx}"
62
60
  end
63
61
  end
64
62
  end
@@ -0,0 +1,64 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Aws
4
+ module S3
5
+ # @api private
6
+ class ObjectLambdaARN < Aws::ARN
7
+ def initialize(options)
8
+ super(options)
9
+ @type, @access_point_name, @extra = @resource.split(/[:,\/]/)
10
+ end
11
+
12
+ def support_dualstack?
13
+ false
14
+ end
15
+
16
+ def support_fips?
17
+ true
18
+ end
19
+
20
+ def validate_arn!
21
+ unless @service == 's3-object-lambda'
22
+ raise ArgumentError, 'Must provide a valid S3 Object Lambdas ARN.'
23
+ end
24
+
25
+ if @region.empty? || @account_id.empty?
26
+ raise ArgumentError,
27
+ 'S3 Object Lambdas ARNs must contain both a region '\
28
+ 'and an account id.'
29
+ end
30
+
31
+ if @type != 'accesspoint'
32
+ raise ArgumentError, 'Invalid ARN, resource format is not correct.'
33
+ end
34
+
35
+ if @access_point_name.nil? || @access_point_name.empty?
36
+ raise ArgumentError, 'Missing ARN accesspoint name.'
37
+ end
38
+
39
+ if @extra
40
+ raise ArgumentError,
41
+ 'ARN accesspoint resource must be a single value.'
42
+ end
43
+
44
+ unless Seahorse::Util.host_label?(
45
+ "#{@access_point_name}-#{@account_id}"
46
+ )
47
+ raise ArgumentError,
48
+ "#{@access_point_name}-#{@account_id} is not a valid "\
49
+ 'host label.'
50
+ end
51
+ end
52
+
53
+ def host_url(region, fips = false, _dualstack = false, custom_endpoint = nil)
54
+ pfx = "#{@access_point_name}-#{@account_id}"
55
+ if custom_endpoint
56
+ "#{pfx}.#{custom_endpoint}"
57
+ else
58
+ sfx = Aws::Partitions::EndpointProvider.dns_suffix_for(region)
59
+ "#{pfx}.s3-object-lambda#{'-fips' if fips}.#{region}.#{sfx}"
60
+ end
61
+ end
62
+ end
63
+ end
64
+ end
@@ -10,8 +10,6 @@ module Aws
10
10
  @resource.split(/[:,\/]/)
11
11
  end
12
12
 
13
- attr_reader :outpost_id, :access_point_name
14
-
15
13
  def support_dualstack?
16
14
  false
17
15
  end
@@ -22,17 +20,17 @@ module Aws
22
20
 
23
21
  def validate_arn!
24
22
  unless @service == 's3-outposts'
25
- raise ArgumentError, 'Must provide a valid S3 outposts ARN.'
23
+ raise ArgumentError, 'Must provide a valid S3 Outposts ARN.'
26
24
  end
27
25
 
28
26
  if @region.empty? || @account_id.empty?
29
27
  raise ArgumentError,
30
- 'S3 accesspoint ARNs must contain both a region '\
28
+ 'S3 Outpost ARNs must contain both a region '\
31
29
  'and an account id.'
32
30
  end
33
31
 
34
32
  if @type != 'outpost' && @subtype != 'accesspoint'
35
- raise ArgumentError, 'Invalid ARN, resource format is not correct'
33
+ raise ArgumentError, 'Invalid ARN, resource format is not correct.'
36
34
  end
37
35
 
38
36
  if @outpost_id.nil? || @outpost_id.empty?
@@ -62,7 +60,7 @@ module Aws
62
60
  end
63
61
 
64
62
  # Outpost ARNs currently do not support dualstack
65
- def host_url(region, _dualstack = false, custom_endpoint = nil)
63
+ def host_url(region, _fips = false, _dualstack = false, custom_endpoint = nil)
66
64
  pfx = "#{@access_point_name}-#{@account_id}.#{@outpost_id}"
67
65
  if custom_endpoint
68
66
  "#{pfx}.#{custom_endpoint}"
@@ -266,7 +266,7 @@ module Aws::S3
266
266
  # })
267
267
  # @param [Hash] options ({})
268
268
  # @option options [String] :expected_bucket_owner
269
- # The account id of the expected bucket owner. If the bucket is owned by
269
+ # The account ID of the expected bucket owner. If the bucket is owned by
270
270
  # a different account, the request will fail with an HTTP `403 (Access
271
271
  # Denied)` error.
272
272
  # @return [EmptyStructure]
@@ -316,7 +316,7 @@ module Aws::S3
316
316
  # Governance-type Object Lock in place. You must have sufficient
317
317
  # permissions to perform this operation.
318
318
  # @option options [String] :expected_bucket_owner
319
- # The account id of the expected bucket owner. If the bucket is owned by
319
+ # The account ID of the expected bucket owner. If the bucket is owned by
320
320
  # a different account, the request will fail with an HTTP `403 (Access
321
321
  # Denied)` error.
322
322
  # @return [Types::DeleteObjectsOutput]
@@ -560,7 +560,7 @@ module Aws::S3
560
560
  #
561
561
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
562
562
  # @option options [String] :expected_bucket_owner
563
- # The account id of the expected bucket owner. If the bucket is owned by
563
+ # The account ID of the expected bucket owner. If the bucket is owned by
564
564
  # a different account, the request will fail with an HTTP `403 (Access
565
565
  # Denied)` error.
566
566
  # @return [Object]
@@ -668,7 +668,7 @@ module Aws::S3
668
668
  # list only if they have an upload ID lexicographically greater than the
669
669
  # specified `upload-id-marker`.
670
670
  # @option options [String] :expected_bucket_owner
671
- # The account id of the expected bucket owner. If the bucket is owned by
671
+ # The account ID of the expected bucket owner. If the bucket is owned by
672
672
  # a different account, the request will fail with an HTTP `403 (Access
673
673
  # Denied)` error.
674
674
  # @return [MultipartUpload::Collection]
@@ -748,7 +748,7 @@ module Aws::S3
748
748
  # @option options [String] :version_id_marker
749
749
  # Specifies the object version you want to start listing from.
750
750
  # @option options [String] :expected_bucket_owner
751
- # The account id of the expected bucket owner. If the bucket is owned by
751
+ # The account ID of the expected bucket owner. If the bucket is owned by
752
752
  # a different account, the request will fail with an HTTP `403 (Access
753
753
  # Denied)` error.
754
754
  # @return [ObjectVersion::Collection]
@@ -804,7 +804,7 @@ module Aws::S3
804
804
  # the list objects request in V2 style. Bucket owners need not specify
805
805
  # this parameter in their requests.
806
806
  # @option options [String] :expected_bucket_owner
807
- # The account id of the expected bucket owner. If the bucket is owned by
807
+ # The account ID of the expected bucket owner. If the bucket is owned by
808
808
  # a different account, the request will fail with an HTTP `403 (Access
809
809
  # Denied)` error.
810
810
  # @return [ObjectSummary::Collection]
@@ -240,7 +240,7 @@ module Aws::S3
240
240
  # @option options [String] :grant_write_acp
241
241
  # Allows grantee to write the ACL for the applicable bucket.
242
242
  # @option options [String] :expected_bucket_owner
243
- # The account id of the expected bucket owner. If the bucket is owned by
243
+ # The account ID of the expected bucket owner. If the bucket is owned by
244
244
  # a different account, the request will fail with an HTTP `403 (Access
245
245
  # Denied)` error.
246
246
  # @return [EmptyStructure]
@@ -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]
@@ -214,8 +214,7 @@ module Aws::S3
214
214
  # @option options [required, Types::CORSConfiguration] :cors_configuration
215
215
  # Describes the cross-origin access configuration for objects in an
216
216
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
217
- # Resource Sharing][1] in the *Amazon Simple Storage Service User
218
- # Guide*.
217
+ # Resource Sharing][1] in the *Amazon S3 User Guide*.
219
218
  #
220
219
  #
221
220
  #
@@ -232,7 +231,7 @@ module Aws::S3
232
231
  #
233
232
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
234
233
  # @option options [String] :expected_bucket_owner
235
- # The account id of the expected bucket owner. If the bucket is owned by
234
+ # The account ID of the expected bucket owner. If the bucket is owned by
236
235
  # a different account, the request will fail with an HTTP `403 (Access
237
236
  # Denied)` error.
238
237
  # @return [EmptyStructure]
@@ -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]
@@ -232,7 +232,7 @@ module Aws::S3
232
232
  # SDKs, this field is calculated automatically.
233
233
  # @option options [Types::LifecycleConfiguration] :lifecycle_configuration
234
234
  # @option options [String] :expected_bucket_owner
235
- # 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
236
236
  # a different account, the request will fail with an HTTP `403 (Access
237
237
  # Denied)` error.
238
238
  # @return [EmptyStructure]
@@ -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]
@@ -214,7 +214,7 @@ module Aws::S3
214
214
  # For requests made using the AWS Command Line Interface (CLI) or AWS
215
215
  # SDKs, this field is calculated 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]
@@ -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]
@@ -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,7 +211,7 @@ module Aws::S3
211
211
  # @option options [required, String] :policy
212
212
  # The bucket policy as a JSON document.
213
213
  # @option options [String] :expected_bucket_owner
214
- # The account id of the expected bucket owner. If the bucket is owned by
214
+ # The account ID of the expected bucket owner. If the bucket is owned by
215
215
  # a different account, the request will fail with an HTTP `403 (Access
216
216
  # Denied)` error.
217
217
  # @return [EmptyStructure]
@@ -198,7 +198,7 @@ module Aws::S3
198
198
  # @option options [required, Types::RequestPaymentConfiguration] :request_payment_configuration
199
199
  # Container for Payer.
200
200
  # @option options [String] :expected_bucket_owner
201
- # The account id of the expected bucket owner. If the bucket is owned by
201
+ # The account ID of the expected bucket owner. If the bucket is owned by
202
202
  # a different account, the request will fail with an HTTP `403 (Access
203
203
  # Denied)` error.
204
204
  # @return [EmptyStructure]
@@ -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]
@@ -220,7 +220,7 @@ module Aws::S3
220
220
  # @option options [required, Types::Tagging] :tagging
221
221
  # Container for the `TagSet` and `Tag` elements.
222
222
  # @option options [String] :expected_bucket_owner
223
- # The account id of the expected bucket owner. If the bucket is owned by
223
+ # The account ID of the expected bucket owner. If the bucket is owned by
224
224
  # a different account, the request will fail with an HTTP `403 (Access
225
225
  # Denied)` error.
226
226
  # @return [EmptyStructure]
@@ -207,7 +207,7 @@ module Aws::S3
207
207
  # The concatenation of the authentication device's serial number, a
208
208
  # space, and the value that is displayed on your authentication device.
209
209
  # @option options [String] :expected_bucket_owner
210
- # The account id of the expected bucket owner. If the bucket is owned by
210
+ # The account ID of the expected bucket owner. If the bucket is owned by
211
211
  # a different account, the request will fail with an HTTP `403 (Access
212
212
  # Denied)` error.
213
213
  # @return [EmptyStructure]
@@ -252,7 +252,7 @@ module Aws::S3
252
252
  # @option options [required, Types::VersioningConfiguration] :versioning_configuration
253
253
  # Container for setting the versioning state.
254
254
  # @option options [String] :expected_bucket_owner
255
- # The account id of the expected bucket owner. If the bucket is owned by
255
+ # The account ID of the expected bucket owner. If the bucket is owned by
256
256
  # a different account, the request will fail with an HTTP `403 (Access
257
257
  # Denied)` error.
258
258
  # @return [EmptyStructure]
@@ -286,7 +286,7 @@ module Aws::S3
286
286
  # The concatenation of the authentication device's serial number, a
287
287
  # space, and the value that is displayed on your authentication device.
288
288
  # @option options [String] :expected_bucket_owner
289
- # The account id of the expected bucket owner. If the bucket is owned by
289
+ # The account ID of the expected bucket owner. If the bucket is owned by
290
290
  # a different account, the request will fail with an HTTP `403 (Access
291
291
  # Denied)` error.
292
292
  # @return [EmptyStructure]
@@ -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]
@@ -261,7 +261,7 @@ module Aws::S3
261
261
  # @option options [required, Types::WebsiteConfiguration] :website_configuration
262
262
  # Container for the request.
263
263
  # @option options [String] :expected_bucket_owner
264
- # The account id of the expected bucket owner. If the bucket is owned by
264
+ # The account ID of the expected bucket owner. If the bucket is owned by
265
265
  # a different account, the request will fail with an HTTP `403 (Access
266
266
  # Denied)` error.
267
267
  # @return [EmptyStructure]