aws-sdk-s3 1.171.0 → 1.173.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 +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +14 -0
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +5 -0
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +20 -0
- data/lib/aws-sdk-s3/client.rb +466 -306
- data/lib/aws-sdk-s3/client_api.rb +30 -0
- data/lib/aws-sdk-s3/errors.rb +44 -0
- data/lib/aws-sdk-s3/multipart_upload.rb +12 -0
- data/lib/aws-sdk-s3/object.rb +54 -0
- data/lib/aws-sdk-s3/object_summary.rb +54 -0
- data/lib/aws-sdk-s3/object_version.rb +43 -0
- data/lib/aws-sdk-s3/types.rb +246 -91
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +5 -1
- data/sig/client.rbs +12 -3
- data/sig/errors.rbs +8 -0
- data/sig/multipart_upload.rbs +2 -1
- data/sig/object.rbs +5 -1
- data/sig/object_summary.rbs +5 -1
- data/sig/object_version.rbs +4 -1
- data/sig/types.rbs +21 -0
- metadata +2 -2
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -703,6 +703,18 @@ module Aws::S3
|
|
703
703
|
# you provide does not match the actual owner of the bucket, the request
|
704
704
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
705
705
|
#
|
706
|
+
# @option params [Time,DateTime,Date,Integer,String] :if_match_initiated_time
|
707
|
+
# If present, this header aborts an in progress multipart upload only if
|
708
|
+
# it was initiated on the provided timestamp. If the initiated timestamp
|
709
|
+
# of the multipart upload does not match the provided value, the
|
710
|
+
# operation returns a `412 Precondition Failed` error. If the initiated
|
711
|
+
# timestamp matches or if the multipart upload doesn’t exist, the
|
712
|
+
# operation returns a `204 Success (No Content)` response.
|
713
|
+
#
|
714
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
715
|
+
#
|
716
|
+
# </note>
|
717
|
+
#
|
706
718
|
# @return [Types::AbortMultipartUploadOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
707
719
|
#
|
708
720
|
# * {Types::AbortMultipartUploadOutput#request_charged #request_charged} => String
|
@@ -730,6 +742,7 @@ module Aws::S3
|
|
730
742
|
# upload_id: "MultipartUploadId", # required
|
731
743
|
# request_payer: "requester", # accepts requester
|
732
744
|
# expected_bucket_owner: "AccountId",
|
745
|
+
# if_match_initiated_time: Time.now,
|
733
746
|
# })
|
734
747
|
#
|
735
748
|
# @example Response structure
|
@@ -837,7 +850,6 @@ module Aws::S3
|
|
837
850
|
# except the last part.
|
838
851
|
#
|
839
852
|
# * HTTP Status Code: 400 Bad Request
|
840
|
-
#
|
841
853
|
# * Error Code: `InvalidPart`
|
842
854
|
#
|
843
855
|
# * Description: One or more of the specified parts could not be
|
@@ -845,14 +857,12 @@ module Aws::S3
|
|
845
857
|
# ETag might not have matched the uploaded part's ETag.
|
846
858
|
#
|
847
859
|
# * HTTP Status Code: 400 Bad Request
|
848
|
-
#
|
849
860
|
# * Error Code: `InvalidPartOrder`
|
850
861
|
#
|
851
862
|
# * Description: The list of parts was not in ascending order. The
|
852
863
|
# parts list must be specified in order by part number.
|
853
864
|
#
|
854
865
|
# * HTTP Status Code: 400 Bad Request
|
855
|
-
#
|
856
866
|
# * Error Code: `NoSuchUpload`
|
857
867
|
#
|
858
868
|
# * Description: The specified multipart upload does not exist. The
|
@@ -1254,7 +1264,6 @@ module Aws::S3
|
|
1254
1264
|
# * If the destination bucket is a general purpose bucket, you must
|
1255
1265
|
# have <b> <code>s3:PutObject</code> </b> permission to write the
|
1256
1266
|
# object copy to the destination bucket.
|
1257
|
-
#
|
1258
1267
|
# * **Directory bucket permissions** - You must have permissions in a
|
1259
1268
|
# bucket policy or an IAM identity-based policy based on the source
|
1260
1269
|
# and destination bucket types in a `CopyObject` operation.
|
@@ -1272,7 +1281,6 @@ module Aws::S3
|
|
1272
1281
|
# `Action` element of a policy to write the object to the
|
1273
1282
|
# destination. The `s3express:SessionMode` condition key can't be
|
1274
1283
|
# set to `ReadOnly` on the copy destination bucket.
|
1275
|
-
#
|
1276
1284
|
# If the object is encrypted with SSE-KMS, you must also have the
|
1277
1285
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
1278
1286
|
# identity-based policies and KMS key policies for the KMS key.
|
@@ -2309,7 +2317,6 @@ module Aws::S3
|
|
2309
2317
|
# more information about S3 Block Public Access, see [Blocking
|
2310
2318
|
# public access to your Amazon S3 storage ][6] in the *Amazon S3
|
2311
2319
|
# User Guide*.
|
2312
|
-
#
|
2313
2320
|
# * **Directory bucket permissions** - You must have the
|
2314
2321
|
# `s3express:CreateBucket` permission in an IAM identity-based
|
2315
2322
|
# policy instead of a bucket policy. Cross-account access to this
|
@@ -2477,33 +2484,33 @@ module Aws::S3
|
|
2477
2484
|
# * {Types::CreateBucketOutput#location #location} => String
|
2478
2485
|
#
|
2479
2486
|
#
|
2480
|
-
# @example Example: To create a bucket
|
2487
|
+
# @example Example: To create a bucket
|
2481
2488
|
#
|
2482
|
-
# # The following example creates a bucket.
|
2489
|
+
# # The following example creates a bucket.
|
2483
2490
|
#
|
2484
2491
|
# resp = client.create_bucket({
|
2485
2492
|
# bucket: "examplebucket",
|
2486
|
-
# create_bucket_configuration: {
|
2487
|
-
# location_constraint: "eu-west-1",
|
2488
|
-
# },
|
2489
2493
|
# })
|
2490
2494
|
#
|
2491
2495
|
# resp.to_h outputs the following:
|
2492
2496
|
# {
|
2493
|
-
# location: "
|
2497
|
+
# location: "/examplebucket",
|
2494
2498
|
# }
|
2495
2499
|
#
|
2496
|
-
# @example Example: To create a bucket
|
2500
|
+
# @example Example: To create a bucket in a specific region
|
2497
2501
|
#
|
2498
|
-
# # The following example creates a bucket.
|
2502
|
+
# # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
|
2499
2503
|
#
|
2500
2504
|
# resp = client.create_bucket({
|
2501
2505
|
# bucket: "examplebucket",
|
2506
|
+
# create_bucket_configuration: {
|
2507
|
+
# location_constraint: "eu-west-1",
|
2508
|
+
# },
|
2502
2509
|
# })
|
2503
2510
|
#
|
2504
2511
|
# resp.to_h outputs the following:
|
2505
2512
|
# {
|
2506
|
-
# location: "/
|
2513
|
+
# location: "http://examplebucket.<Region>.s3.amazonaws.com/",
|
2507
2514
|
# }
|
2508
2515
|
#
|
2509
2516
|
# @example Request syntax with placeholder values
|
@@ -2660,7 +2667,6 @@ module Aws::S3
|
|
2660
2667
|
# * `x-amz-server-side-encryption-aws-kms-key-id`
|
2661
2668
|
#
|
2662
2669
|
# * `x-amz-server-side-encryption-context`
|
2663
|
-
#
|
2664
2670
|
# <note markdown="1"> * If you specify `x-amz-server-side-encryption:aws:kms`, but
|
2665
2671
|
# don't provide `x-amz-server-side-encryption-aws-kms-key-id`,
|
2666
2672
|
# Amazon S3 uses the Amazon Web Services managed key (`aws/s3`
|
@@ -2706,12 +2712,10 @@ module Aws::S3
|
|
2706
2712
|
# * `x-amz-server-side-encryption-customer-key`
|
2707
2713
|
#
|
2708
2714
|
# * `x-amz-server-side-encryption-customer-key-MD5`
|
2709
|
-
#
|
2710
2715
|
# For more information about server-side encryption with
|
2711
2716
|
# customer-provided encryption keys (SSE-C), see [ Protecting data
|
2712
2717
|
# using server-side encryption with customer-provided encryption
|
2713
2718
|
# keys (SSE-C)][11] in the *Amazon S3 User Guide*.
|
2714
|
-
#
|
2715
2719
|
# * **Directory buckets** - For directory buckets, there are only two
|
2716
2720
|
# supported options for server-side encryption: server-side
|
2717
2721
|
# encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
|
@@ -3885,7 +3889,7 @@ module Aws::S3
|
|
3885
3889
|
req.send_request(options)
|
3886
3890
|
end
|
3887
3891
|
|
3888
|
-
# <note markdown="1"> This operation is not supported
|
3892
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
3889
3893
|
#
|
3890
3894
|
# </note>
|
3891
3895
|
#
|
@@ -3951,7 +3955,7 @@ module Aws::S3
|
|
3951
3955
|
req.send_request(options)
|
3952
3956
|
end
|
3953
3957
|
|
3954
|
-
# <note markdown="1"> This operation is not supported
|
3958
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
3955
3959
|
#
|
3956
3960
|
# </note>
|
3957
3961
|
#
|
@@ -4115,7 +4119,7 @@ module Aws::S3
|
|
4115
4119
|
req.send_request(options)
|
4116
4120
|
end
|
4117
4121
|
|
4118
|
-
# <note markdown="1"> This operation is not supported
|
4122
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4119
4123
|
#
|
4120
4124
|
# </note>
|
4121
4125
|
#
|
@@ -4182,7 +4186,7 @@ module Aws::S3
|
|
4182
4186
|
req.send_request(options)
|
4183
4187
|
end
|
4184
4188
|
|
4185
|
-
# <note markdown="1"> This operation is not supported
|
4189
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4186
4190
|
#
|
4187
4191
|
# </note>
|
4188
4192
|
#
|
@@ -4247,38 +4251,71 @@ module Aws::S3
|
|
4247
4251
|
req.send_request(options)
|
4248
4252
|
end
|
4249
4253
|
|
4250
|
-
# <note markdown="1"> This operation is not supported by directory buckets.
|
4251
|
-
#
|
4252
|
-
# </note>
|
4253
|
-
#
|
4254
4254
|
# Deletes the lifecycle configuration from the specified bucket. Amazon
|
4255
4255
|
# S3 removes all the lifecycle configuration rules in the lifecycle
|
4256
4256
|
# subresource associated with the bucket. Your objects never expire, and
|
4257
4257
|
# Amazon S3 no longer automatically deletes any objects on the basis of
|
4258
4258
|
# rules contained in the deleted lifecycle configuration.
|
4259
4259
|
#
|
4260
|
-
#
|
4261
|
-
#
|
4262
|
-
#
|
4263
|
-
#
|
4260
|
+
# Permissions
|
4261
|
+
# : * **General purpose bucket permissions** - By default, all Amazon S3
|
4262
|
+
# resources are private, including buckets, objects, and related
|
4263
|
+
# subresources (for example, lifecycle configuration and website
|
4264
|
+
# configuration). Only the resource owner (that is, the Amazon Web
|
4265
|
+
# Services account that created it) can access the resource. The
|
4266
|
+
# resource owner can optionally grant access permissions to others
|
4267
|
+
# by writing an access policy. For this operation, a user must have
|
4268
|
+
# the `s3:PutLifecycleConfiguration` permission.
|
4269
|
+
#
|
4270
|
+
# For more information about permissions, see [Managing Access
|
4271
|
+
# Permissions to Your Amazon S3 Resources][1].
|
4272
|
+
# ^
|
4273
|
+
#
|
4274
|
+
# * **Directory bucket permissions** - You must have the
|
4275
|
+
# `s3express:PutLifecycleConfiguration` permission in an IAM
|
4276
|
+
# identity-based policy to use this operation. Cross-account access
|
4277
|
+
# to this API operation isn't supported. The resource owner can
|
4278
|
+
# optionally grant access permissions to others by creating a role
|
4279
|
+
# or user for them as long as they are within the same account as
|
4280
|
+
# the owner and resource.
|
4281
|
+
#
|
4282
|
+
# For more information about directory bucket policies and
|
4283
|
+
# permissions, see [Authorizing Regional endpoint APIs with IAM][2]
|
4284
|
+
# in the *Amazon S3 User Guide*.
|
4285
|
+
#
|
4286
|
+
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
4287
|
+
# requests for this API operation to the Regional endpoint. These
|
4288
|
+
# endpoints support path-style requests in the format
|
4289
|
+
# `https://s3express-control.region_code.amazonaws.com/bucket-name
|
4290
|
+
# `. Virtual-hosted-style requests aren't supported. For more
|
4291
|
+
# information, see [Regional and Zonal endpoints][3] in the *Amazon
|
4292
|
+
# S3 User Guide*.
|
4264
4293
|
#
|
4265
|
-
#
|
4266
|
-
#
|
4294
|
+
# </note>
|
4295
|
+
# ^
|
4296
|
+
#
|
4297
|
+
# HTTP Host header syntax
|
4298
|
+
#
|
4299
|
+
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
4300
|
+
# `s3express-control.region.amazonaws.com`.
|
4267
4301
|
#
|
4268
4302
|
# For more information about the object expiration, see [Elements to
|
4269
|
-
# Describe Lifecycle Actions][
|
4303
|
+
# Describe Lifecycle Actions][4].
|
4270
4304
|
#
|
4271
4305
|
# Related actions include:
|
4272
4306
|
#
|
4273
|
-
# * [PutBucketLifecycleConfiguration][
|
4307
|
+
# * [PutBucketLifecycleConfiguration][5]
|
4274
4308
|
#
|
4275
|
-
# * [GetBucketLifecycleConfiguration][
|
4309
|
+
# * [GetBucketLifecycleConfiguration][6]
|
4276
4310
|
#
|
4277
4311
|
#
|
4278
4312
|
#
|
4279
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4280
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4281
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4313
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
4314
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
4315
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
4316
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
|
4317
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
4318
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
4282
4319
|
#
|
4283
4320
|
# @option params [required, String] :bucket
|
4284
4321
|
# The bucket name of the lifecycle to delete.
|
@@ -4288,6 +4325,11 @@ module Aws::S3
|
|
4288
4325
|
# you provide does not match the actual owner of the bucket, the request
|
4289
4326
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
4290
4327
|
#
|
4328
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
4329
|
+
# supported for directory bucket lifecycle configurations.
|
4330
|
+
#
|
4331
|
+
# </note>
|
4332
|
+
#
|
4291
4333
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
4292
4334
|
#
|
4293
4335
|
#
|
@@ -4315,7 +4357,7 @@ module Aws::S3
|
|
4315
4357
|
req.send_request(options)
|
4316
4358
|
end
|
4317
4359
|
|
4318
|
-
# <note markdown="1"> This operation is not supported
|
4360
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4319
4361
|
#
|
4320
4362
|
# </note>
|
4321
4363
|
#
|
@@ -4385,7 +4427,7 @@ module Aws::S3
|
|
4385
4427
|
req.send_request(options)
|
4386
4428
|
end
|
4387
4429
|
|
4388
|
-
# <note markdown="1"> This operation is not supported
|
4430
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4389
4431
|
#
|
4390
4432
|
# </note>
|
4391
4433
|
#
|
@@ -4559,7 +4601,7 @@ module Aws::S3
|
|
4559
4601
|
req.send_request(options)
|
4560
4602
|
end
|
4561
4603
|
|
4562
|
-
# <note markdown="1"> This operation is not supported
|
4604
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4563
4605
|
#
|
4564
4606
|
# </note>
|
4565
4607
|
#
|
@@ -4629,7 +4671,7 @@ module Aws::S3
|
|
4629
4671
|
req.send_request(options)
|
4630
4672
|
end
|
4631
4673
|
|
4632
|
-
# <note markdown="1"> This operation is not supported
|
4674
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4633
4675
|
#
|
4634
4676
|
# </note>
|
4635
4677
|
#
|
@@ -4685,7 +4727,7 @@ module Aws::S3
|
|
4685
4727
|
req.send_request(options)
|
4686
4728
|
end
|
4687
4729
|
|
4688
|
-
# <note markdown="1"> This operation is not supported
|
4730
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4689
4731
|
#
|
4690
4732
|
# </note>
|
4691
4733
|
#
|
@@ -4805,7 +4847,6 @@ module Aws::S3
|
|
4805
4847
|
# objects from your bucket, you must deny them the
|
4806
4848
|
# `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
|
4807
4849
|
# `s3:PutLifeCycleConfiguration` permissions.
|
4808
|
-
#
|
4809
4850
|
# * **Directory buckets permissions** - To grant access to this API
|
4810
4851
|
# operation on a directory bucket, we recommend that you use the
|
4811
4852
|
# CreateSession API operation for session-based authorization.
|
@@ -4925,6 +4966,49 @@ module Aws::S3
|
|
4925
4966
|
# you provide does not match the actual owner of the bucket, the request
|
4926
4967
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
4927
4968
|
#
|
4969
|
+
# @option params [String] :if_match
|
4970
|
+
# The `If-Match` header field makes the request method conditional on
|
4971
|
+
# ETags. If the ETag value does not match, the operation returns a `412
|
4972
|
+
# Precondition Failed` error. If the ETag matches or if the object
|
4973
|
+
# doesn't exist, the operation will return a `204 Success (No Content)
|
4974
|
+
# response`.
|
4975
|
+
#
|
4976
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
4977
|
+
#
|
4978
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
4979
|
+
#
|
4980
|
+
# </note>
|
4981
|
+
#
|
4982
|
+
#
|
4983
|
+
#
|
4984
|
+
# [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
|
4985
|
+
#
|
4986
|
+
# @option params [Time,DateTime,Date,Integer,String] :if_match_last_modified_time
|
4987
|
+
# If present, the object is deleted only if its modification times
|
4988
|
+
# matches the provided `Timestamp`. If the `Timestamp` values do not
|
4989
|
+
# match, the operation returns a `412 Precondition Failed` error. If the
|
4990
|
+
# `Timestamp` matches or if the object doesn’t exist, the operation
|
4991
|
+
# returns a `204 Success (No Content)` response.
|
4992
|
+
#
|
4993
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
4994
|
+
#
|
4995
|
+
# </note>
|
4996
|
+
#
|
4997
|
+
# @option params [Integer] :if_match_size
|
4998
|
+
# If present, the object is deleted only if its size matches the
|
4999
|
+
# provided size in bytes. If the `Size` value does not match, the
|
5000
|
+
# operation returns a `412 Precondition Failed` error. If the `Size`
|
5001
|
+
# matches or if the object doesn’t exist, the operation returns a `204
|
5002
|
+
# Success (No Content)` response.
|
5003
|
+
#
|
5004
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
5005
|
+
#
|
5006
|
+
# </note>
|
5007
|
+
#
|
5008
|
+
# You can use the `If-Match`, `x-amz-if-match-last-modified-time` and
|
5009
|
+
# `x-amz-if-match-size` conditional headers in conjunction with
|
5010
|
+
# each-other or individually.
|
5011
|
+
#
|
4928
5012
|
# @return [Types::DeleteObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4929
5013
|
#
|
4930
5014
|
# * {Types::DeleteObjectOutput#delete_marker #delete_marker} => Boolean
|
@@ -4932,15 +5016,6 @@ module Aws::S3
|
|
4932
5016
|
# * {Types::DeleteObjectOutput#request_charged #request_charged} => String
|
4933
5017
|
#
|
4934
5018
|
#
|
4935
|
-
# @example Example: To delete an object (from a non-versioned bucket)
|
4936
|
-
#
|
4937
|
-
# # The following example deletes an object from a non-versioned bucket.
|
4938
|
-
#
|
4939
|
-
# resp = client.delete_object({
|
4940
|
-
# bucket: "ExampleBucket",
|
4941
|
-
# key: "HappyFace.jpg",
|
4942
|
-
# })
|
4943
|
-
#
|
4944
5019
|
# @example Example: To delete an object
|
4945
5020
|
#
|
4946
5021
|
# # The following example deletes an object from an S3 bucket.
|
@@ -4954,6 +5029,15 @@ module Aws::S3
|
|
4954
5029
|
# {
|
4955
5030
|
# }
|
4956
5031
|
#
|
5032
|
+
# @example Example: To delete an object (from a non-versioned bucket)
|
5033
|
+
#
|
5034
|
+
# # The following example deletes an object from a non-versioned bucket.
|
5035
|
+
#
|
5036
|
+
# resp = client.delete_object({
|
5037
|
+
# bucket: "ExampleBucket",
|
5038
|
+
# key: "HappyFace.jpg",
|
5039
|
+
# })
|
5040
|
+
#
|
4957
5041
|
# @example Request syntax with placeholder values
|
4958
5042
|
#
|
4959
5043
|
# resp = client.delete_object({
|
@@ -4964,6 +5048,9 @@ module Aws::S3
|
|
4964
5048
|
# request_payer: "requester", # accepts requester
|
4965
5049
|
# bypass_governance_retention: false,
|
4966
5050
|
# expected_bucket_owner: "AccountId",
|
5051
|
+
# if_match: "IfMatch",
|
5052
|
+
# if_match_last_modified_time: Time.now,
|
5053
|
+
# if_match_size: 1,
|
4967
5054
|
# })
|
4968
5055
|
#
|
4969
5056
|
# @example Response structure
|
@@ -4981,7 +5068,7 @@ module Aws::S3
|
|
4981
5068
|
req.send_request(options)
|
4982
5069
|
end
|
4983
5070
|
|
4984
|
-
# <note markdown="1"> This operation is not supported
|
5071
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4985
5072
|
#
|
4986
5073
|
# </note>
|
4987
5074
|
#
|
@@ -5164,7 +5251,6 @@ module Aws::S3
|
|
5164
5251
|
# * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
|
5165
5252
|
# specific version of an object from a versioning-enabled bucket,
|
5166
5253
|
# you must specify the `s3:DeleteObjectVersion` permission.
|
5167
|
-
#
|
5168
5254
|
# * **Directory bucket permissions** - To grant access to this API
|
5169
5255
|
# operation on a directory bucket, we recommend that you use the [
|
5170
5256
|
# `CreateSession` ][3] API operation for session-based
|
@@ -5363,20 +5449,22 @@ module Aws::S3
|
|
5363
5449
|
# * {Types::DeleteObjectsOutput#errors #errors} => Array<Types::Error>
|
5364
5450
|
#
|
5365
5451
|
#
|
5366
|
-
# @example Example: To delete multiple
|
5452
|
+
# @example Example: To delete multiple object versions from a versioned bucket
|
5367
5453
|
#
|
5368
|
-
# # The following example deletes objects from a bucket. The
|
5369
|
-
# #
|
5454
|
+
# # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
|
5455
|
+
# # versions and returns the key and versions of deleted objects in the response.
|
5370
5456
|
#
|
5371
5457
|
# resp = client.delete_objects({
|
5372
5458
|
# bucket: "examplebucket",
|
5373
5459
|
# delete: {
|
5374
5460
|
# objects: [
|
5375
5461
|
# {
|
5376
|
-
# key: "
|
5462
|
+
# key: "HappyFace.jpg",
|
5463
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
5377
5464
|
# },
|
5378
5465
|
# {
|
5379
|
-
# key: "
|
5466
|
+
# key: "HappyFace.jpg",
|
5467
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
5380
5468
|
# },
|
5381
5469
|
# ],
|
5382
5470
|
# quiet: false,
|
@@ -5387,34 +5475,30 @@ module Aws::S3
|
|
5387
5475
|
# {
|
5388
5476
|
# deleted: [
|
5389
5477
|
# {
|
5390
|
-
#
|
5391
|
-
#
|
5392
|
-
# key: "objectkey1",
|
5478
|
+
# key: "HappyFace.jpg",
|
5479
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
5393
5480
|
# },
|
5394
5481
|
# {
|
5395
|
-
#
|
5396
|
-
#
|
5397
|
-
# key: "objectkey2",
|
5482
|
+
# key: "HappyFace.jpg",
|
5483
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
5398
5484
|
# },
|
5399
5485
|
# ],
|
5400
5486
|
# }
|
5401
5487
|
#
|
5402
|
-
# @example Example: To delete multiple
|
5488
|
+
# @example Example: To delete multiple objects from a versioned bucket
|
5403
5489
|
#
|
5404
|
-
# # The following example deletes objects from a bucket. The
|
5405
|
-
# #
|
5490
|
+
# # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
|
5491
|
+
# # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
|
5406
5492
|
#
|
5407
5493
|
# resp = client.delete_objects({
|
5408
5494
|
# bucket: "examplebucket",
|
5409
5495
|
# delete: {
|
5410
5496
|
# objects: [
|
5411
5497
|
# {
|
5412
|
-
# key: "
|
5413
|
-
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
5498
|
+
# key: "objectkey1",
|
5414
5499
|
# },
|
5415
5500
|
# {
|
5416
|
-
# key: "
|
5417
|
-
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
5501
|
+
# key: "objectkey2",
|
5418
5502
|
# },
|
5419
5503
|
# ],
|
5420
5504
|
# quiet: false,
|
@@ -5425,12 +5509,14 @@ module Aws::S3
|
|
5425
5509
|
# {
|
5426
5510
|
# deleted: [
|
5427
5511
|
# {
|
5428
|
-
#
|
5429
|
-
#
|
5512
|
+
# delete_marker: true,
|
5513
|
+
# delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
|
5514
|
+
# key: "objectkey1",
|
5430
5515
|
# },
|
5431
5516
|
# {
|
5432
|
-
#
|
5433
|
-
#
|
5517
|
+
# delete_marker: true,
|
5518
|
+
# delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
|
5519
|
+
# key: "objectkey2",
|
5434
5520
|
# },
|
5435
5521
|
# ],
|
5436
5522
|
# }
|
@@ -5444,6 +5530,9 @@ module Aws::S3
|
|
5444
5530
|
# {
|
5445
5531
|
# key: "ObjectKey", # required
|
5446
5532
|
# version_id: "ObjectVersionId",
|
5533
|
+
# etag: "ETag",
|
5534
|
+
# last_modified_time: Time.now,
|
5535
|
+
# size: 1,
|
5447
5536
|
# },
|
5448
5537
|
# ],
|
5449
5538
|
# quiet: false,
|
@@ -5478,7 +5567,7 @@ module Aws::S3
|
|
5478
5567
|
req.send_request(options)
|
5479
5568
|
end
|
5480
5569
|
|
5481
|
-
# <note markdown="1"> This operation is not supported
|
5570
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5482
5571
|
#
|
5483
5572
|
# </note>
|
5484
5573
|
#
|
@@ -5535,7 +5624,7 @@ module Aws::S3
|
|
5535
5624
|
req.send_request(options)
|
5536
5625
|
end
|
5537
5626
|
|
5538
|
-
# <note markdown="1"> This operation is not supported
|
5627
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5539
5628
|
#
|
5540
5629
|
# </note>
|
5541
5630
|
#
|
@@ -5631,7 +5720,7 @@ module Aws::S3
|
|
5631
5720
|
req.send_request(options)
|
5632
5721
|
end
|
5633
5722
|
|
5634
|
-
# <note markdown="1"> This operation is not supported
|
5723
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5635
5724
|
#
|
5636
5725
|
# </note>
|
5637
5726
|
#
|
@@ -5727,7 +5816,7 @@ module Aws::S3
|
|
5727
5816
|
req.send_request(options)
|
5728
5817
|
end
|
5729
5818
|
|
5730
|
-
# <note markdown="1"> This operation is not supported
|
5819
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5731
5820
|
#
|
5732
5821
|
# </note>
|
5733
5822
|
#
|
@@ -5813,7 +5902,7 @@ module Aws::S3
|
|
5813
5902
|
req.send_request(options)
|
5814
5903
|
end
|
5815
5904
|
|
5816
|
-
# <note markdown="1"> This operation is not supported
|
5905
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5817
5906
|
#
|
5818
5907
|
# </note>
|
5819
5908
|
#
|
@@ -6046,7 +6135,7 @@ module Aws::S3
|
|
6046
6135
|
req.send_request(options)
|
6047
6136
|
end
|
6048
6137
|
|
6049
|
-
# <note markdown="1"> This operation is not supported
|
6138
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6050
6139
|
#
|
6051
6140
|
# </note>
|
6052
6141
|
#
|
@@ -6130,7 +6219,7 @@ module Aws::S3
|
|
6130
6219
|
req.send_request(options)
|
6131
6220
|
end
|
6132
6221
|
|
6133
|
-
# <note markdown="1"> This operation is not supported
|
6222
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6134
6223
|
#
|
6135
6224
|
# </note>
|
6136
6225
|
#
|
@@ -6219,7 +6308,7 @@ module Aws::S3
|
|
6219
6308
|
# version of this topic. This topic is provided for backward
|
6220
6309
|
# compatibility.
|
6221
6310
|
#
|
6222
|
-
# <note markdown="1"> This operation is not supported
|
6311
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6223
6312
|
#
|
6224
6313
|
# </note>
|
6225
6314
|
#
|
@@ -6331,34 +6420,65 @@ module Aws::S3
|
|
6331
6420
|
req.send_request(options)
|
6332
6421
|
end
|
6333
6422
|
|
6334
|
-
#
|
6335
|
-
#
|
6336
|
-
#
|
6423
|
+
# Returns the lifecycle configuration information set on the bucket. For
|
6424
|
+
# information about lifecycle configuration, see [Object Lifecycle
|
6425
|
+
# Management][1].
|
6337
6426
|
#
|
6338
|
-
#
|
6427
|
+
# Bucket lifecycle configuration now supports specifying a lifecycle
|
6339
6428
|
# rule using an object key name prefix, one or more object tags, object
|
6340
6429
|
# size, or any combination of these. Accordingly, this section describes
|
6341
|
-
# the latest API
|
6342
|
-
#
|
6343
|
-
#
|
6344
|
-
#
|
6345
|
-
#
|
6346
|
-
#
|
6347
|
-
#
|
6348
|
-
#
|
6430
|
+
# the latest API, which is compatible with the new functionality. The
|
6431
|
+
# previous version of the API supported filtering based only on an
|
6432
|
+
# object key name prefix, which is supported for general purpose buckets
|
6433
|
+
# for backward compatibility. For the related API description, see
|
6434
|
+
# [GetBucketLifecycle][2].
|
6435
|
+
#
|
6436
|
+
# <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
|
6437
|
+
# objects and cancelling multipart uploads. Expiring of versioned
|
6438
|
+
# objects, transitions and tag filters are not supported.
|
6349
6439
|
#
|
6350
6440
|
# </note>
|
6351
6441
|
#
|
6352
|
-
#
|
6353
|
-
#
|
6354
|
-
#
|
6442
|
+
# Permissions
|
6443
|
+
# : * **General purpose bucket permissions** - By default, all Amazon S3
|
6444
|
+
# resources are private, including buckets, objects, and related
|
6445
|
+
# subresources (for example, lifecycle configuration and website
|
6446
|
+
# configuration). Only the resource owner (that is, the Amazon Web
|
6447
|
+
# Services account that created it) can access the resource. The
|
6448
|
+
# resource owner can optionally grant access permissions to others
|
6449
|
+
# by writing an access policy. For this operation, a user must have
|
6450
|
+
# the `s3:GetLifecycleConfiguration` permission.
|
6451
|
+
#
|
6452
|
+
# For more information about permissions, see [Managing Access
|
6453
|
+
# Permissions to Your Amazon S3 Resources][3].
|
6454
|
+
# ^
|
6355
6455
|
#
|
6356
|
-
#
|
6357
|
-
#
|
6358
|
-
#
|
6359
|
-
#
|
6360
|
-
#
|
6361
|
-
#
|
6456
|
+
# * **Directory bucket permissions** - You must have the
|
6457
|
+
# `s3express:GetLifecycleConfiguration` permission in an IAM
|
6458
|
+
# identity-based policy to use this operation. Cross-account access
|
6459
|
+
# to this API operation isn't supported. The resource owner can
|
6460
|
+
# optionally grant access permissions to others by creating a role
|
6461
|
+
# or user for them as long as they are within the same account as
|
6462
|
+
# the owner and resource.
|
6463
|
+
#
|
6464
|
+
# For more information about directory bucket policies and
|
6465
|
+
# permissions, see [Authorizing Regional endpoint APIs with IAM][4]
|
6466
|
+
# in the *Amazon S3 User Guide*.
|
6467
|
+
#
|
6468
|
+
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
6469
|
+
# requests for this API operation to the Regional endpoint. These
|
6470
|
+
# endpoints support path-style requests in the format
|
6471
|
+
# `https://s3express-control.region_code.amazonaws.com/bucket-name
|
6472
|
+
# `. Virtual-hosted-style requests aren't supported. For more
|
6473
|
+
# information, see [Regional and Zonal endpoints][5] in the *Amazon
|
6474
|
+
# S3 User Guide*.
|
6475
|
+
#
|
6476
|
+
# </note>
|
6477
|
+
#
|
6478
|
+
# HTTP Host header syntax
|
6479
|
+
#
|
6480
|
+
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
6481
|
+
# `s3express-control.region.amazonaws.com`.
|
6362
6482
|
#
|
6363
6483
|
# `GetBucketLifecycleConfiguration` has the following special error:
|
6364
6484
|
#
|
@@ -6373,20 +6493,21 @@ module Aws::S3
|
|
6373
6493
|
# The following operations are related to
|
6374
6494
|
# `GetBucketLifecycleConfiguration`:
|
6375
6495
|
#
|
6376
|
-
# * [GetBucketLifecycle][
|
6496
|
+
# * [GetBucketLifecycle][2]
|
6377
6497
|
#
|
6378
|
-
# * [PutBucketLifecycle][
|
6498
|
+
# * [PutBucketLifecycle][6]
|
6379
6499
|
#
|
6380
|
-
# * [DeleteBucketLifecycle][
|
6500
|
+
# * [DeleteBucketLifecycle][7]
|
6381
6501
|
#
|
6382
6502
|
#
|
6383
6503
|
#
|
6384
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
6385
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
6386
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
6387
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-
|
6388
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
6389
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
6504
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
6505
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
|
6506
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
6507
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
6508
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
6509
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
6510
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
6390
6511
|
#
|
6391
6512
|
# @option params [required, String] :bucket
|
6392
6513
|
# The name of the bucket for which to get the lifecycle information.
|
@@ -6396,6 +6517,11 @@ module Aws::S3
|
|
6396
6517
|
# you provide does not match the actual owner of the bucket, the request
|
6397
6518
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
6398
6519
|
#
|
6520
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
6521
|
+
# supported for directory bucket lifecycle configurations.
|
6522
|
+
#
|
6523
|
+
# </note>
|
6524
|
+
#
|
6399
6525
|
# @return [Types::GetBucketLifecycleConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
6400
6526
|
#
|
6401
6527
|
# * {Types::GetBucketLifecycleConfigurationOutput#rules #rules} => Array<Types::LifecycleRule>
|
@@ -6476,7 +6602,7 @@ module Aws::S3
|
|
6476
6602
|
req.send_request(options)
|
6477
6603
|
end
|
6478
6604
|
|
6479
|
-
# <note markdown="1"> This operation is not supported
|
6605
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6480
6606
|
#
|
6481
6607
|
# </note>
|
6482
6608
|
#
|
@@ -6573,7 +6699,7 @@ module Aws::S3
|
|
6573
6699
|
req.send_request(options)
|
6574
6700
|
end
|
6575
6701
|
|
6576
|
-
# <note markdown="1"> This operation is not supported
|
6702
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6577
6703
|
#
|
6578
6704
|
# </note>
|
6579
6705
|
#
|
@@ -6632,7 +6758,7 @@ module Aws::S3
|
|
6632
6758
|
req.send_request(options)
|
6633
6759
|
end
|
6634
6760
|
|
6635
|
-
# <note markdown="1"> This operation is not supported
|
6761
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6636
6762
|
#
|
6637
6763
|
# </note>
|
6638
6764
|
#
|
@@ -6718,7 +6844,7 @@ module Aws::S3
|
|
6718
6844
|
req.send_request(options)
|
6719
6845
|
end
|
6720
6846
|
|
6721
|
-
# <note markdown="1"> This operation is not supported
|
6847
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6722
6848
|
#
|
6723
6849
|
# </note>
|
6724
6850
|
#
|
@@ -6849,7 +6975,7 @@ module Aws::S3
|
|
6849
6975
|
req.send_request(options)
|
6850
6976
|
end
|
6851
6977
|
|
6852
|
-
# <note markdown="1"> This operation is not supported
|
6978
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6853
6979
|
#
|
6854
6980
|
# </note>
|
6855
6981
|
#
|
@@ -6964,7 +7090,7 @@ module Aws::S3
|
|
6964
7090
|
req.send_request(options)
|
6965
7091
|
end
|
6966
7092
|
|
6967
|
-
# <note markdown="1"> This operation is not supported
|
7093
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6968
7094
|
#
|
6969
7095
|
# </note>
|
6970
7096
|
#
|
@@ -7181,7 +7307,7 @@ module Aws::S3
|
|
7181
7307
|
req.send_request(options, &block)
|
7182
7308
|
end
|
7183
7309
|
|
7184
|
-
# <note markdown="1"> This operation is not supported
|
7310
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7185
7311
|
#
|
7186
7312
|
# </note>
|
7187
7313
|
#
|
@@ -7246,7 +7372,7 @@ module Aws::S3
|
|
7246
7372
|
req.send_request(options)
|
7247
7373
|
end
|
7248
7374
|
|
7249
|
-
# <note markdown="1"> This operation is not supported
|
7375
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7250
7376
|
#
|
7251
7377
|
# </note>
|
7252
7378
|
#
|
@@ -7369,7 +7495,7 @@ module Aws::S3
|
|
7369
7495
|
req.send_request(options)
|
7370
7496
|
end
|
7371
7497
|
|
7372
|
-
# <note markdown="1"> This operation is not supported
|
7498
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7373
7499
|
#
|
7374
7500
|
# </note>
|
7375
7501
|
#
|
@@ -7435,7 +7561,7 @@ module Aws::S3
|
|
7435
7561
|
req.send_request(options)
|
7436
7562
|
end
|
7437
7563
|
|
7438
|
-
# <note markdown="1"> This operation is not supported
|
7564
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7439
7565
|
#
|
7440
7566
|
# </note>
|
7441
7567
|
#
|
@@ -7521,7 +7647,7 @@ module Aws::S3
|
|
7521
7647
|
req.send_request(options)
|
7522
7648
|
end
|
7523
7649
|
|
7524
|
-
# <note markdown="1"> This operation is not supported
|
7650
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7525
7651
|
#
|
7526
7652
|
# </note>
|
7527
7653
|
#
|
@@ -7598,7 +7724,7 @@ module Aws::S3
|
|
7598
7724
|
req.send_request(options)
|
7599
7725
|
end
|
7600
7726
|
|
7601
|
-
# <note markdown="1"> This operation is not supported
|
7727
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7602
7728
|
#
|
7603
7729
|
# </note>
|
7604
7730
|
#
|
@@ -7744,7 +7870,6 @@ module Aws::S3
|
|
7744
7870
|
#
|
7745
7871
|
# * If you don’t have the `s3:ListBucket` permission, Amazon S3
|
7746
7872
|
# returns an HTTP status code `403 Access Denied` error.
|
7747
|
-
#
|
7748
7873
|
# * **Directory bucket permissions** - To grant access to this API
|
7749
7874
|
# operation on a directory bucket, we recommend that you use the [
|
7750
7875
|
# `CreateSession` ][4] API operation for session-based
|
@@ -8205,49 +8330,49 @@ module Aws::S3
|
|
8205
8330
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
8206
8331
|
#
|
8207
8332
|
#
|
8208
|
-
# @example Example: To retrieve an object
|
8333
|
+
# @example Example: To retrieve a byte range of an object
|
8209
8334
|
#
|
8210
|
-
# # The following example retrieves an object for an S3 bucket.
|
8335
|
+
# # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
|
8336
|
+
# # specific byte range.
|
8211
8337
|
#
|
8212
8338
|
# resp = client.get_object({
|
8213
8339
|
# bucket: "examplebucket",
|
8214
|
-
# key: "
|
8340
|
+
# key: "SampleFile.txt",
|
8341
|
+
# range: "bytes=0-9",
|
8215
8342
|
# })
|
8216
8343
|
#
|
8217
8344
|
# resp.to_h outputs the following:
|
8218
8345
|
# {
|
8219
8346
|
# accept_ranges: "bytes",
|
8220
|
-
# content_length:
|
8221
|
-
#
|
8222
|
-
#
|
8223
|
-
#
|
8347
|
+
# content_length: 10,
|
8348
|
+
# content_range: "bytes 0-9/43",
|
8349
|
+
# content_type: "text/plain",
|
8350
|
+
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
8351
|
+
# last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
|
8224
8352
|
# metadata: {
|
8225
8353
|
# },
|
8226
|
-
# tag_count: 2,
|
8227
8354
|
# version_id: "null",
|
8228
8355
|
# }
|
8229
8356
|
#
|
8230
|
-
# @example Example: To retrieve
|
8357
|
+
# @example Example: To retrieve an object
|
8231
8358
|
#
|
8232
|
-
# # The following example retrieves an object for an S3 bucket.
|
8233
|
-
# # specific byte range.
|
8359
|
+
# # The following example retrieves an object for an S3 bucket.
|
8234
8360
|
#
|
8235
8361
|
# resp = client.get_object({
|
8236
8362
|
# bucket: "examplebucket",
|
8237
|
-
# key: "
|
8238
|
-
# range: "bytes=0-9",
|
8363
|
+
# key: "HappyFace.jpg",
|
8239
8364
|
# })
|
8240
8365
|
#
|
8241
8366
|
# resp.to_h outputs the following:
|
8242
8367
|
# {
|
8243
8368
|
# accept_ranges: "bytes",
|
8244
|
-
# content_length:
|
8245
|
-
#
|
8246
|
-
#
|
8247
|
-
#
|
8248
|
-
# last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
|
8369
|
+
# content_length: 3191,
|
8370
|
+
# content_type: "image/jpeg",
|
8371
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
8372
|
+
# last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
|
8249
8373
|
# metadata: {
|
8250
8374
|
# },
|
8375
|
+
# tag_count: 2,
|
8251
8376
|
# version_id: "null",
|
8252
8377
|
# }
|
8253
8378
|
#
|
@@ -8356,7 +8481,7 @@ module Aws::S3
|
|
8356
8481
|
req.send_request(options, &block)
|
8357
8482
|
end
|
8358
8483
|
|
8359
|
-
# <note markdown="1"> This operation is not supported
|
8484
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
8360
8485
|
#
|
8361
8486
|
# </note>
|
8362
8487
|
#
|
@@ -8578,7 +8703,6 @@ module Aws::S3
|
|
8578
8703
|
# * If you don't have the `s3:ListBucket` permission, Amazon S3
|
8579
8704
|
# returns an HTTP status code `403 Forbidden` ("access denied")
|
8580
8705
|
# error.
|
8581
|
-
#
|
8582
8706
|
# * **Directory bucket permissions** - To grant access to this API
|
8583
8707
|
# operation on a directory bucket, we recommend that you use the [
|
8584
8708
|
# `CreateSession` ][3] API operation for session-based
|
@@ -8665,7 +8789,6 @@ module Aws::S3
|
|
8665
8789
|
# * `If-Match` condition evaluates to `true`.
|
8666
8790
|
#
|
8667
8791
|
# * `If-Unmodified-Since` condition evaluates to `false`.
|
8668
|
-
#
|
8669
8792
|
# For more information about conditional requests, see [RFC
|
8670
8793
|
# 7232][7].
|
8671
8794
|
#
|
@@ -8676,7 +8799,6 @@ module Aws::S3
|
|
8676
8799
|
# * `If-None-Match` condition evaluates to `false`.
|
8677
8800
|
#
|
8678
8801
|
# * `If-Modified-Since` condition evaluates to `true`.
|
8679
|
-
#
|
8680
8802
|
# For more information about conditional requests, see [RFC
|
8681
8803
|
# 7232][7].
|
8682
8804
|
#
|
@@ -8902,7 +9024,7 @@ module Aws::S3
|
|
8902
9024
|
req.send_request(options)
|
8903
9025
|
end
|
8904
9026
|
|
8905
|
-
# <note markdown="1"> This operation is not supported
|
9027
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
8906
9028
|
#
|
8907
9029
|
# </note>
|
8908
9030
|
#
|
@@ -8998,7 +9120,7 @@ module Aws::S3
|
|
8998
9120
|
req.send_request(options)
|
8999
9121
|
end
|
9000
9122
|
|
9001
|
-
# <note markdown="1"> This operation is not supported
|
9123
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9002
9124
|
#
|
9003
9125
|
# </note>
|
9004
9126
|
#
|
@@ -9068,7 +9190,7 @@ module Aws::S3
|
|
9068
9190
|
req.send_request(options)
|
9069
9191
|
end
|
9070
9192
|
|
9071
|
-
# <note markdown="1"> This operation is not supported
|
9193
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9072
9194
|
#
|
9073
9195
|
# </note>
|
9074
9196
|
#
|
@@ -9165,7 +9287,7 @@ module Aws::S3
|
|
9165
9287
|
req.send_request(options)
|
9166
9288
|
end
|
9167
9289
|
|
9168
|
-
# <note markdown="1"> This operation is not supported
|
9290
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9169
9291
|
#
|
9170
9292
|
# </note>
|
9171
9293
|
#
|
@@ -9334,7 +9456,7 @@ module Aws::S3
|
|
9334
9456
|
req.send_request(options)
|
9335
9457
|
end
|
9336
9458
|
|
9337
|
-
# <note markdown="1"> This operation is not supported
|
9459
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9338
9460
|
#
|
9339
9461
|
# </note>
|
9340
9462
|
#
|
@@ -9435,7 +9557,7 @@ module Aws::S3
|
|
9435
9557
|
req.send_request(options, &block)
|
9436
9558
|
end
|
9437
9559
|
|
9438
|
-
# <note markdown="1"> This operation is not supported
|
9560
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9439
9561
|
#
|
9440
9562
|
# </note>
|
9441
9563
|
#
|
@@ -9726,7 +9848,6 @@ module Aws::S3
|
|
9726
9848
|
#
|
9727
9849
|
# * If you don’t have the `s3:ListBucket` permission, Amazon S3
|
9728
9850
|
# returns an HTTP status code `403 Forbidden` error.
|
9729
|
-
#
|
9730
9851
|
# * **Directory bucket permissions** - To grant access to this API
|
9731
9852
|
# operation on a directory bucket, we recommend that you use the [
|
9732
9853
|
# `CreateSession` ][3] API operation for session-based
|
@@ -9798,7 +9919,7 @@ module Aws::S3
|
|
9798
9919
|
# a `405 Method Not Allowed` error and the `Last-Modified:
|
9799
9920
|
# timestamp` response header.
|
9800
9921
|
#
|
9801
|
-
# <note markdown="1"> * **Directory buckets** - Delete marker is not supported
|
9922
|
+
# <note markdown="1"> * **Directory buckets** - Delete marker is not supported for
|
9802
9923
|
# directory buckets.
|
9803
9924
|
#
|
9804
9925
|
# * **Directory buckets** - S3 Versioning isn't enabled and supported
|
@@ -10209,7 +10330,7 @@ module Aws::S3
|
|
10209
10330
|
req.send_request(options)
|
10210
10331
|
end
|
10211
10332
|
|
10212
|
-
# <note markdown="1"> This operation is not supported
|
10333
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10213
10334
|
#
|
10214
10335
|
# </note>
|
10215
10336
|
#
|
@@ -10310,7 +10431,7 @@ module Aws::S3
|
|
10310
10431
|
req.send_request(options)
|
10311
10432
|
end
|
10312
10433
|
|
10313
|
-
# <note markdown="1"> This operation is not supported
|
10434
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10314
10435
|
#
|
10315
10436
|
# </note>
|
10316
10437
|
#
|
@@ -10402,7 +10523,7 @@ module Aws::S3
|
|
10402
10523
|
req.send_request(options)
|
10403
10524
|
end
|
10404
10525
|
|
10405
|
-
# <note markdown="1"> This operation is not supported
|
10526
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10406
10527
|
#
|
10407
10528
|
# </note>
|
10408
10529
|
#
|
@@ -10504,7 +10625,7 @@ module Aws::S3
|
|
10504
10625
|
req.send_request(options)
|
10505
10626
|
end
|
10506
10627
|
|
10507
|
-
# <note markdown="1"> This operation is not supported
|
10628
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10508
10629
|
#
|
10509
10630
|
# </note>
|
10510
10631
|
#
|
@@ -10606,24 +10727,25 @@ module Aws::S3
|
|
10606
10727
|
req.send_request(options)
|
10607
10728
|
end
|
10608
10729
|
|
10609
|
-
# <note markdown="1"> This operation is not supported
|
10730
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10610
10731
|
#
|
10611
10732
|
# </note>
|
10612
10733
|
#
|
10613
10734
|
# Returns a list of all buckets owned by the authenticated sender of the
|
10614
|
-
# request. To use this operation, you must
|
10615
|
-
# `s3:ListAllMyBuckets`
|
10735
|
+
# request. To grant IAM permission to use this operation, you must add
|
10736
|
+
# the `s3:ListAllMyBuckets` policy action.
|
10616
10737
|
#
|
10617
10738
|
# For information about Amazon S3 buckets, see [Creating, configuring,
|
10618
10739
|
# and working with Amazon S3 buckets][1].
|
10619
10740
|
#
|
10620
|
-
# We strongly recommend using only paginated requests.
|
10621
|
-
# requests are only supported for Amazon Web
|
10622
|
-
# the default general purpose bucket quota of
|
10623
|
-
# approved general purpose bucket quota above
|
10624
|
-
# paginated requests to list your
|
10625
|
-
# ListBuckets requests will be
|
10626
|
-
#
|
10741
|
+
# We strongly recommend using only paginated `ListBuckets` requests.
|
10742
|
+
# Unpaginated `ListBuckets` requests are only supported for Amazon Web
|
10743
|
+
# Services accounts set to the default general purpose bucket quota of
|
10744
|
+
# 10,000. If you have an approved general purpose bucket quota above
|
10745
|
+
# 10,000, you must send paginated `ListBuckets` requests to list your
|
10746
|
+
# account’s buckets. All unpaginated `ListBuckets` requests will be
|
10747
|
+
# rejected for Amazon Web Services accounts with a general purpose
|
10748
|
+
# bucket quota greater than 10,000.
|
10627
10749
|
#
|
10628
10750
|
#
|
10629
10751
|
#
|
@@ -10909,7 +11031,6 @@ module Aws::S3
|
|
10909
11031
|
# initiation time. Among uploads with the same key, the one that
|
10910
11032
|
# was initiated first will appear before the ones that were
|
10911
11033
|
# initiated later.
|
10912
|
-
#
|
10913
11034
|
# * **Directory bucket** - In the `ListMultipartUploads` response, the
|
10914
11035
|
# multipart uploads aren't sorted lexicographically based on the
|
10915
11036
|
# object keys.
|
@@ -11122,97 +11243,97 @@ module Aws::S3
|
|
11122
11243
|
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
11123
11244
|
#
|
11124
11245
|
#
|
11125
|
-
# @example Example:
|
11246
|
+
# @example Example: To list in-progress multipart uploads on a bucket
|
11126
11247
|
#
|
11127
|
-
# # The following example
|
11128
|
-
# # setup of multipart uploads.
|
11248
|
+
# # The following example lists in-progress multipart uploads on a specific bucket.
|
11129
11249
|
#
|
11130
11250
|
# resp = client.list_multipart_uploads({
|
11131
11251
|
# bucket: "examplebucket",
|
11132
|
-
# key_marker: "nextkeyfrompreviousresponse",
|
11133
|
-
# max_uploads: 2,
|
11134
|
-
# upload_id_marker: "valuefrompreviousresponse",
|
11135
11252
|
# })
|
11136
11253
|
#
|
11137
11254
|
# resp.to_h outputs the following:
|
11138
11255
|
# {
|
11139
|
-
# bucket: "acl1",
|
11140
|
-
# is_truncated: true,
|
11141
|
-
# key_marker: "",
|
11142
|
-
# max_uploads: 2,
|
11143
|
-
# next_key_marker: "someobjectkey",
|
11144
|
-
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
11145
|
-
# upload_id_marker: "",
|
11146
11256
|
# uploads: [
|
11147
11257
|
# {
|
11148
11258
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
11149
11259
|
# initiator: {
|
11150
|
-
# display_name: "
|
11260
|
+
# display_name: "display-name",
|
11151
11261
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
11152
11262
|
# },
|
11153
11263
|
# key: "JavaFile",
|
11154
11264
|
# owner: {
|
11155
|
-
# display_name: "
|
11156
|
-
# id: "
|
11265
|
+
# display_name: "display-name",
|
11266
|
+
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
11157
11267
|
# },
|
11158
11268
|
# storage_class: "STANDARD",
|
11159
|
-
# upload_id: "
|
11269
|
+
# upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
11160
11270
|
# },
|
11161
11271
|
# {
|
11162
11272
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
11163
11273
|
# initiator: {
|
11164
|
-
# display_name: "
|
11274
|
+
# display_name: "display-name",
|
11165
11275
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
11166
11276
|
# },
|
11167
11277
|
# key: "JavaFile",
|
11168
11278
|
# owner: {
|
11169
|
-
# display_name: "
|
11279
|
+
# display_name: "display-name",
|
11170
11280
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
11171
11281
|
# },
|
11172
11282
|
# storage_class: "STANDARD",
|
11173
|
-
# upload_id: "
|
11283
|
+
# upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
11174
11284
|
# },
|
11175
11285
|
# ],
|
11176
11286
|
# }
|
11177
11287
|
#
|
11178
|
-
# @example Example:
|
11288
|
+
# @example Example: List next set of multipart uploads when previous result is truncated
|
11179
11289
|
#
|
11180
|
-
# # The following example
|
11290
|
+
# # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
|
11291
|
+
# # setup of multipart uploads.
|
11181
11292
|
#
|
11182
11293
|
# resp = client.list_multipart_uploads({
|
11183
11294
|
# bucket: "examplebucket",
|
11295
|
+
# key_marker: "nextkeyfrompreviousresponse",
|
11296
|
+
# max_uploads: 2,
|
11297
|
+
# upload_id_marker: "valuefrompreviousresponse",
|
11184
11298
|
# })
|
11185
11299
|
#
|
11186
11300
|
# resp.to_h outputs the following:
|
11187
11301
|
# {
|
11302
|
+
# bucket: "acl1",
|
11303
|
+
# is_truncated: true,
|
11304
|
+
# key_marker: "",
|
11305
|
+
# max_uploads: 2,
|
11306
|
+
# next_key_marker: "someobjectkey",
|
11307
|
+
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
11308
|
+
# upload_id_marker: "",
|
11188
11309
|
# uploads: [
|
11189
11310
|
# {
|
11190
11311
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
11191
11312
|
# initiator: {
|
11192
|
-
# display_name: "display-name",
|
11313
|
+
# display_name: "ownder-display-name",
|
11193
11314
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
11194
11315
|
# },
|
11195
11316
|
# key: "JavaFile",
|
11196
11317
|
# owner: {
|
11197
|
-
# display_name: "
|
11198
|
-
# id: "
|
11318
|
+
# display_name: "mohanataws",
|
11319
|
+
# id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
11199
11320
|
# },
|
11200
11321
|
# storage_class: "STANDARD",
|
11201
|
-
# upload_id: "
|
11322
|
+
# upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
11202
11323
|
# },
|
11203
11324
|
# {
|
11204
11325
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
11205
11326
|
# initiator: {
|
11206
|
-
# display_name: "display-name",
|
11327
|
+
# display_name: "ownder-display-name",
|
11207
11328
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
11208
11329
|
# },
|
11209
11330
|
# key: "JavaFile",
|
11210
11331
|
# owner: {
|
11211
|
-
# display_name: "display-name",
|
11332
|
+
# display_name: "ownder-display-name",
|
11212
11333
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
11213
11334
|
# },
|
11214
11335
|
# storage_class: "STANDARD",
|
11215
|
-
# upload_id: "
|
11336
|
+
# upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
11216
11337
|
# },
|
11217
11338
|
# ],
|
11218
11339
|
# }
|
@@ -11266,7 +11387,7 @@ module Aws::S3
|
|
11266
11387
|
req.send_request(options)
|
11267
11388
|
end
|
11268
11389
|
|
11269
|
-
# <note markdown="1"> This operation is not supported
|
11390
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
11270
11391
|
#
|
11271
11392
|
# </note>
|
11272
11393
|
#
|
@@ -11505,7 +11626,7 @@ module Aws::S3
|
|
11505
11626
|
req.send_request(options)
|
11506
11627
|
end
|
11507
11628
|
|
11508
|
-
# <note markdown="1"> This operation is not supported
|
11629
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
11509
11630
|
#
|
11510
11631
|
# </note>
|
11511
11632
|
#
|
@@ -12399,7 +12520,7 @@ module Aws::S3
|
|
12399
12520
|
req.send_request(options)
|
12400
12521
|
end
|
12401
12522
|
|
12402
|
-
# <note markdown="1"> This operation is not supported
|
12523
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
12403
12524
|
#
|
12404
12525
|
# </note>
|
12405
12526
|
#
|
@@ -12498,7 +12619,7 @@ module Aws::S3
|
|
12498
12619
|
req.send_request(options)
|
12499
12620
|
end
|
12500
12621
|
|
12501
|
-
# <note markdown="1"> This operation is not supported
|
12622
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
12502
12623
|
#
|
12503
12624
|
# </note>
|
12504
12625
|
#
|
@@ -12589,7 +12710,6 @@ module Aws::S3
|
|
12589
12710
|
# General Reference.
|
12590
12711
|
#
|
12591
12712
|
# </note>
|
12592
|
-
#
|
12593
12713
|
# For example, the following `x-amz-grant-write` header grants
|
12594
12714
|
# create, overwrite, and delete objects permission to LogDelivery
|
12595
12715
|
# group predefined by Amazon S3 and two Amazon Web Services accounts
|
@@ -12792,7 +12912,7 @@ module Aws::S3
|
|
12792
12912
|
req.send_request(options)
|
12793
12913
|
end
|
12794
12914
|
|
12795
|
-
# <note markdown="1"> This operation is not supported
|
12915
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
12796
12916
|
#
|
12797
12917
|
# </note>
|
12798
12918
|
#
|
@@ -12830,14 +12950,12 @@ module Aws::S3
|
|
12830
12950
|
# * *Code: InvalidArgument*
|
12831
12951
|
#
|
12832
12952
|
# * *Cause: Invalid argument.*
|
12833
|
-
#
|
12834
12953
|
# * * *HTTP Error: HTTP 400 Bad Request*
|
12835
12954
|
#
|
12836
12955
|
# * *Code: TooManyConfigurations*
|
12837
12956
|
#
|
12838
12957
|
# * *Cause: You are attempting to create a new configuration but have
|
12839
12958
|
# already reached the 1,000-configuration limit.*
|
12840
|
-
#
|
12841
12959
|
# * * *HTTP Error: HTTP 403 Forbidden*
|
12842
12960
|
#
|
12843
12961
|
# * *Code: AccessDenied*
|
@@ -12930,7 +13048,7 @@ module Aws::S3
|
|
12930
13048
|
req.send_request(options)
|
12931
13049
|
end
|
12932
13050
|
|
12933
|
-
# <note markdown="1"> This operation is not supported
|
13051
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
12934
13052
|
#
|
12935
13053
|
# </note>
|
12936
13054
|
#
|
@@ -13139,7 +13257,6 @@ module Aws::S3
|
|
13139
13257
|
# encryption][3] to SSE-KMS, you should verify that your KMS key ID
|
13140
13258
|
# is correct. Amazon S3 doesn't validate the KMS key ID provided in
|
13141
13259
|
# PutBucketEncryption requests.
|
13142
|
-
#
|
13143
13260
|
# * <b>Directory buckets </b> - You can optionally configure default
|
13144
13261
|
# encryption for a bucket by using server-side encryption with Key
|
13145
13262
|
# Management Service (KMS) keys (SSE-KMS).
|
@@ -13338,7 +13455,7 @@ module Aws::S3
|
|
13338
13455
|
req.send_request(options)
|
13339
13456
|
end
|
13340
13457
|
|
13341
|
-
# <note markdown="1"> This operation is not supported
|
13458
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
13342
13459
|
#
|
13343
13460
|
# </note>
|
13344
13461
|
#
|
@@ -13463,7 +13580,7 @@ module Aws::S3
|
|
13463
13580
|
req.send_request(options)
|
13464
13581
|
end
|
13465
13582
|
|
13466
|
-
# <note markdown="1"> This operation is not supported
|
13583
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
13467
13584
|
#
|
13468
13585
|
# </note>
|
13469
13586
|
#
|
@@ -13615,15 +13732,15 @@ module Aws::S3
|
|
13615
13732
|
req.send_request(options)
|
13616
13733
|
end
|
13617
13734
|
|
13618
|
-
# <note markdown="1"> This operation is not supported by directory buckets.
|
13619
|
-
#
|
13620
|
-
# </note>
|
13621
|
-
#
|
13622
13735
|
# For an updated version of this API, see
|
13623
13736
|
# [PutBucketLifecycleConfiguration][1]. This version has been
|
13624
13737
|
# deprecated. Existing lifecycle configurations will work. For new
|
13625
13738
|
# lifecycle configurations, use the updated API.
|
13626
13739
|
#
|
13740
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
13741
|
+
#
|
13742
|
+
# </note>
|
13743
|
+
#
|
13627
13744
|
# Creates a new lifecycle configuration for the bucket or replaces an
|
13628
13745
|
# existing lifecycle configuration. For information about lifecycle
|
13629
13746
|
# configuration, see [Object Lifecycle Management][2] in the *Amazon S3
|
@@ -13766,10 +13883,6 @@ module Aws::S3
|
|
13766
13883
|
req.send_request(options)
|
13767
13884
|
end
|
13768
13885
|
|
13769
|
-
# <note markdown="1"> This operation is not supported by directory buckets.
|
13770
|
-
#
|
13771
|
-
# </note>
|
13772
|
-
#
|
13773
13886
|
# Creates a new lifecycle configuration for the bucket or replaces an
|
13774
13887
|
# existing lifecycle configuration. Keep in mind that this will
|
13775
13888
|
# overwrite an existing lifecycle configuration, so if you want to
|
@@ -13778,6 +13891,8 @@ module Aws::S3
|
|
13778
13891
|
# configuration, see [Managing your storage lifecycle][1].
|
13779
13892
|
#
|
13780
13893
|
# Rules
|
13894
|
+
# Permissions
|
13895
|
+
# HTTP Host header syntax
|
13781
13896
|
#
|
13782
13897
|
# : You specify the lifecycle configuration in your request body. The
|
13783
13898
|
# lifecycle configuration is specified as XML consisting of one or
|
@@ -13789,8 +13904,14 @@ module Aws::S3
|
|
13789
13904
|
# size, or any combination of these. Accordingly, this section
|
13790
13905
|
# describes the latest API. The previous version of the API supported
|
13791
13906
|
# filtering based only on an object key name prefix, which is
|
13792
|
-
# supported for backward compatibility
|
13793
|
-
# description, see [PutBucketLifecycle][2].
|
13907
|
+
# supported for backward compatibility for general purpose buckets.
|
13908
|
+
# For the related API description, see [PutBucketLifecycle][2].
|
13909
|
+
#
|
13910
|
+
# <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
|
13911
|
+
# objects and cancelling multipart uploads. Expiring of versioned
|
13912
|
+
# objects,transitions and tag filters are not supported.
|
13913
|
+
#
|
13914
|
+
# </note>
|
13794
13915
|
#
|
13795
13916
|
# A lifecycle rule consists of the following:
|
13796
13917
|
#
|
@@ -13810,40 +13931,61 @@ module Aws::S3
|
|
13810
13931
|
#
|
13811
13932
|
# For more information, see [Object Lifecycle Management][3] and
|
13812
13933
|
# [Lifecycle Configuration Elements][4].
|
13934
|
+
# : * **General purpose bucket permissions** - By default, all Amazon S3
|
13935
|
+
# resources are private, including buckets, objects, and related
|
13936
|
+
# subresources (for example, lifecycle configuration and website
|
13937
|
+
# configuration). Only the resource owner (that is, the Amazon Web
|
13938
|
+
# Services account that created it) can access the resource. The
|
13939
|
+
# resource owner can optionally grant access permissions to others
|
13940
|
+
# by writing an access policy. For this operation, a user must have
|
13941
|
+
# the `s3:PutLifecycleConfiguration` permission.
|
13813
13942
|
#
|
13814
|
-
#
|
13943
|
+
# You can also explicitly deny permissions. An explicit deny also
|
13944
|
+
# supersedes any other permissions. If you want to block users or
|
13945
|
+
# accounts from removing or deleting objects from your bucket, you
|
13946
|
+
# must deny them permissions for the following actions:
|
13947
|
+
#
|
13948
|
+
# * `s3:DeleteObject`
|
13815
13949
|
#
|
13816
|
-
# :
|
13817
|
-
# objects, and related subresources (for example, lifecycle
|
13818
|
-
# configuration and website configuration). Only the resource owner
|
13819
|
-
# (that is, the Amazon Web Services account that created it) can
|
13820
|
-
# access the resource. The resource owner can optionally grant access
|
13821
|
-
# permissions to others by writing an access policy. For this
|
13822
|
-
# operation, a user must get the `s3:PutLifecycleConfiguration`
|
13823
|
-
# permission.
|
13950
|
+
# * `s3:DeleteObjectVersion`
|
13824
13951
|
#
|
13825
|
-
#
|
13826
|
-
# supersedes any other permissions. If you want to block users or
|
13827
|
-
# accounts from removing or deleting objects from your bucket, you
|
13828
|
-
# must deny them permissions for the following actions:
|
13952
|
+
# * `s3:PutLifecycleConfiguration`
|
13829
13953
|
#
|
13830
|
-
#
|
13954
|
+
# For more information about permissions, see [Managing Access
|
13955
|
+
# Permissions to Your Amazon S3 Resources][5].
|
13956
|
+
# ^
|
13831
13957
|
#
|
13832
|
-
# *
|
13958
|
+
# * **Directory bucket permissions** - You must have the
|
13959
|
+
# `s3express:PutLifecycleConfiguration` permission in an IAM
|
13960
|
+
# identity-based policy to use this operation. Cross-account access
|
13961
|
+
# to this API operation isn't supported. The resource owner can
|
13962
|
+
# optionally grant access permissions to others by creating a role
|
13963
|
+
# or user for them as long as they are within the same account as
|
13964
|
+
# the owner and resource.
|
13965
|
+
#
|
13966
|
+
# For more information about directory bucket policies and
|
13967
|
+
# permissions, see [Authorizing Regional endpoint APIs with IAM][6]
|
13968
|
+
# in the *Amazon S3 User Guide*.
|
13833
13969
|
#
|
13834
|
-
#
|
13970
|
+
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
13971
|
+
# requests for this API operation to the Regional endpoint. These
|
13972
|
+
# endpoints support path-style requests in the format
|
13973
|
+
# `https://s3express-control.region_code.amazonaws.com/bucket-name
|
13974
|
+
# `. Virtual-hosted-style requests aren't supported. For more
|
13975
|
+
# information, see [Regional and Zonal endpoints][7] in the *Amazon
|
13976
|
+
# S3 User Guide*.
|
13835
13977
|
#
|
13836
|
-
#
|
13837
|
-
# Permissions to Your Amazon S3 Resources][5].
|
13978
|
+
# </note>
|
13838
13979
|
#
|
13839
|
-
# The
|
13840
|
-
#
|
13980
|
+
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
13981
|
+
# `s3express-control.region.amazonaws.com`.
|
13841
13982
|
#
|
13842
|
-
#
|
13983
|
+
# The following operations are related to
|
13984
|
+
# `PutBucketLifecycleConfiguration`:
|
13843
13985
|
#
|
13844
|
-
#
|
13986
|
+
# * [GetBucketLifecycleConfiguration][8]
|
13845
13987
|
#
|
13846
|
-
#
|
13988
|
+
# * [DeleteBucketLifecycle][9]
|
13847
13989
|
#
|
13848
13990
|
#
|
13849
13991
|
#
|
@@ -13852,9 +13994,10 @@ module Aws::S3
|
|
13852
13994
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
13853
13995
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
|
13854
13996
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
13855
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13856
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13857
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
13997
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
13998
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
13999
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
14000
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
13858
14001
|
#
|
13859
14002
|
# @option params [required, String] :bucket
|
13860
14003
|
# The name of the bucket for which to set the configuration.
|
@@ -13883,10 +14026,20 @@ module Aws::S3
|
|
13883
14026
|
# you provide does not match the actual owner of the bucket, the request
|
13884
14027
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
13885
14028
|
#
|
14029
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
14030
|
+
# supported for directory bucket lifecycle configurations.
|
14031
|
+
#
|
14032
|
+
# </note>
|
14033
|
+
#
|
13886
14034
|
# @option params [String] :transition_default_minimum_object_size
|
13887
14035
|
# Indicates which default minimum object size behavior is applied to the
|
13888
14036
|
# lifecycle configuration.
|
13889
14037
|
#
|
14038
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
14039
|
+
# supported for directory bucket lifecycle configurations.
|
14040
|
+
#
|
14041
|
+
# </note>
|
14042
|
+
#
|
13890
14043
|
# * `all_storage_classes_128K` - Objects smaller than 128 KB will not
|
13891
14044
|
# transition to any storage class by default.
|
13892
14045
|
#
|
@@ -14010,7 +14163,7 @@ module Aws::S3
|
|
14010
14163
|
req.send_request(options)
|
14011
14164
|
end
|
14012
14165
|
|
14013
|
-
# <note markdown="1"> This operation is not supported
|
14166
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14014
14167
|
#
|
14015
14168
|
# </note>
|
14016
14169
|
#
|
@@ -14193,7 +14346,7 @@ module Aws::S3
|
|
14193
14346
|
req.send_request(options)
|
14194
14347
|
end
|
14195
14348
|
|
14196
|
-
# <note markdown="1"> This operation is not supported
|
14349
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14197
14350
|
#
|
14198
14351
|
# </note>
|
14199
14352
|
#
|
@@ -14297,7 +14450,7 @@ module Aws::S3
|
|
14297
14450
|
req.send_request(options)
|
14298
14451
|
end
|
14299
14452
|
|
14300
|
-
# <note markdown="1"> This operation is not supported
|
14453
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14301
14454
|
#
|
14302
14455
|
# </note>
|
14303
14456
|
#
|
@@ -14383,7 +14536,7 @@ module Aws::S3
|
|
14383
14536
|
req.send_request(options)
|
14384
14537
|
end
|
14385
14538
|
|
14386
|
-
# <note markdown="1"> This operation is not supported
|
14539
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14387
14540
|
#
|
14388
14541
|
# </note>
|
14389
14542
|
#
|
@@ -14567,7 +14720,7 @@ module Aws::S3
|
|
14567
14720
|
req.send_request(options)
|
14568
14721
|
end
|
14569
14722
|
|
14570
|
-
# <note markdown="1"> This operation is not supported
|
14723
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14571
14724
|
#
|
14572
14725
|
# </note>
|
14573
14726
|
#
|
@@ -14836,7 +14989,7 @@ module Aws::S3
|
|
14836
14989
|
req.send_request(options)
|
14837
14990
|
end
|
14838
14991
|
|
14839
|
-
# <note markdown="1"> This operation is not supported
|
14992
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14840
14993
|
#
|
14841
14994
|
# </note>
|
14842
14995
|
#
|
@@ -15074,7 +15227,7 @@ module Aws::S3
|
|
15074
15227
|
req.send_request(options)
|
15075
15228
|
end
|
15076
15229
|
|
15077
|
-
# <note markdown="1"> This operation is not supported
|
15230
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
15078
15231
|
#
|
15079
15232
|
# </note>
|
15080
15233
|
#
|
@@ -15171,7 +15324,7 @@ module Aws::S3
|
|
15171
15324
|
req.send_request(options)
|
15172
15325
|
end
|
15173
15326
|
|
15174
|
-
# <note markdown="1"> This operation is not supported
|
15327
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
15175
15328
|
#
|
15176
15329
|
# </note>
|
15177
15330
|
#
|
@@ -15322,7 +15475,7 @@ module Aws::S3
|
|
15322
15475
|
req.send_request(options)
|
15323
15476
|
end
|
15324
15477
|
|
15325
|
-
# <note markdown="1"> This operation is not supported
|
15478
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
15326
15479
|
#
|
15327
15480
|
# </note>
|
15328
15481
|
#
|
@@ -15461,7 +15614,7 @@ module Aws::S3
|
|
15461
15614
|
req.send_request(options)
|
15462
15615
|
end
|
15463
15616
|
|
15464
|
-
# <note markdown="1"> This operation is not supported
|
15617
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
15465
15618
|
#
|
15466
15619
|
# </note>
|
15467
15620
|
#
|
@@ -15711,7 +15864,6 @@ module Aws::S3
|
|
15711
15864
|
# * <b> <code>s3:PutObjectTagging</code> </b> - To successfully set
|
15712
15865
|
# the tag-set with your `PutObject` request, you must have the
|
15713
15866
|
# `s3:PutObjectTagging`.
|
15714
|
-
#
|
15715
15867
|
# * **Directory bucket permissions** - To grant access to this API
|
15716
15868
|
# operation on a directory bucket, we recommend that you use the [
|
15717
15869
|
# `CreateSession` ][5] API operation for session-based
|
@@ -16080,6 +16232,17 @@ module Aws::S3
|
|
16080
16232
|
# @option params [required, String] :key
|
16081
16233
|
# Object key for which the PUT action was initiated.
|
16082
16234
|
#
|
16235
|
+
# @option params [Integer] :write_offset_bytes
|
16236
|
+
# Specifies the offset for appending data to existing objects in bytes.
|
16237
|
+
# The offset must be equal to the size of the existing object being
|
16238
|
+
# appended to. If no object exists, setting this header to 0 will create
|
16239
|
+
# a new object.
|
16240
|
+
#
|
16241
|
+
# <note markdown="1"> This functionality is only supported for objects in the Amazon S3
|
16242
|
+
# Express One Zone storage class in directory buckets.
|
16243
|
+
#
|
16244
|
+
# </note>
|
16245
|
+
#
|
16083
16246
|
# @option params [Hash<String,String>] :metadata
|
16084
16247
|
# A map of metadata to store with the object in S3.
|
16085
16248
|
#
|
@@ -16382,6 +16545,7 @@ module Aws::S3
|
|
16382
16545
|
# * {Types::PutObjectOutput#ssekms_key_id #ssekms_key_id} => String
|
16383
16546
|
# * {Types::PutObjectOutput#ssekms_encryption_context #ssekms_encryption_context} => String
|
16384
16547
|
# * {Types::PutObjectOutput#bucket_key_enabled #bucket_key_enabled} => Boolean
|
16548
|
+
# * {Types::PutObjectOutput#size #size} => Integer
|
16385
16549
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
16386
16550
|
#
|
16387
16551
|
#
|
@@ -16421,24 +16585,21 @@ module Aws::S3
|
|
16421
16585
|
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
16422
16586
|
# }
|
16423
16587
|
#
|
16424
|
-
# @example Example: To upload an object
|
16588
|
+
# @example Example: To upload an object
|
16425
16589
|
#
|
16426
|
-
# # The following example uploads an object. The
|
16427
|
-
# #
|
16590
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
16591
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
16428
16592
|
#
|
16429
16593
|
# resp = client.put_object({
|
16430
|
-
# body: "
|
16594
|
+
# body: "HappyFace.jpg",
|
16431
16595
|
# bucket: "examplebucket",
|
16432
|
-
# key: "
|
16433
|
-
# server_side_encryption: "AES256",
|
16434
|
-
# tagging: "key1=value1&key2=value2",
|
16596
|
+
# key: "HappyFace.jpg",
|
16435
16597
|
# })
|
16436
16598
|
#
|
16437
16599
|
# resp.to_h outputs the following:
|
16438
16600
|
# {
|
16439
16601
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16440
|
-
#
|
16441
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
16602
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
16442
16603
|
# }
|
16443
16604
|
#
|
16444
16605
|
# @example Example: To upload object and specify user-defined metadata
|
@@ -16462,57 +16623,60 @@ module Aws::S3
|
|
16462
16623
|
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
16463
16624
|
# }
|
16464
16625
|
#
|
16465
|
-
# @example Example: To
|
16626
|
+
# @example Example: To create an object.
|
16466
16627
|
#
|
16467
|
-
# # The following example
|
16468
|
-
# # storage class and use server-side encryption.
|
16628
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
16469
16629
|
#
|
16470
16630
|
# resp = client.put_object({
|
16471
|
-
# body: "
|
16631
|
+
# body: "filetoupload",
|
16472
16632
|
# bucket: "examplebucket",
|
16473
|
-
# key: "
|
16474
|
-
# server_side_encryption: "AES256",
|
16475
|
-
# storage_class: "STANDARD_IA",
|
16633
|
+
# key: "objectkey",
|
16476
16634
|
# })
|
16477
16635
|
#
|
16478
16636
|
# resp.to_h outputs the following:
|
16479
16637
|
# {
|
16480
16638
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16481
|
-
#
|
16482
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
16639
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
16483
16640
|
# }
|
16484
16641
|
#
|
16485
|
-
# @example Example: To
|
16642
|
+
# @example Example: To upload an object (specify optional headers)
|
16486
16643
|
#
|
16487
|
-
# # The following example
|
16644
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
16645
|
+
# # storage class and use server-side encryption.
|
16488
16646
|
#
|
16489
16647
|
# resp = client.put_object({
|
16490
|
-
# body: "
|
16648
|
+
# body: "HappyFace.jpg",
|
16491
16649
|
# bucket: "examplebucket",
|
16492
|
-
# key: "
|
16650
|
+
# key: "HappyFace.jpg",
|
16651
|
+
# server_side_encryption: "AES256",
|
16652
|
+
# storage_class: "STANDARD_IA",
|
16493
16653
|
# })
|
16494
16654
|
#
|
16495
16655
|
# resp.to_h outputs the following:
|
16496
16656
|
# {
|
16497
16657
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16498
|
-
#
|
16658
|
+
# server_side_encryption: "AES256",
|
16659
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
16499
16660
|
# }
|
16500
16661
|
#
|
16501
|
-
# @example Example: To upload an object
|
16662
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
16502
16663
|
#
|
16503
|
-
# # The following example uploads an object
|
16504
|
-
# #
|
16664
|
+
# # The following example uploads an object. The request specifies the optional server-side encryption option. The request
|
16665
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
16505
16666
|
#
|
16506
16667
|
# resp = client.put_object({
|
16507
|
-
# body: "
|
16668
|
+
# body: "filetoupload",
|
16508
16669
|
# bucket: "examplebucket",
|
16509
|
-
# key: "
|
16670
|
+
# key: "exampleobject",
|
16671
|
+
# server_side_encryption: "AES256",
|
16672
|
+
# tagging: "key1=value1&key2=value2",
|
16510
16673
|
# })
|
16511
16674
|
#
|
16512
16675
|
# resp.to_h outputs the following:
|
16513
16676
|
# {
|
16514
16677
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16515
|
-
#
|
16678
|
+
# server_side_encryption: "AES256",
|
16679
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
16516
16680
|
# }
|
16517
16681
|
#
|
16518
16682
|
# @example Streaming a file from disk
|
@@ -16546,6 +16710,7 @@ module Aws::S3
|
|
16546
16710
|
# grant_read_acp: "GrantReadACP",
|
16547
16711
|
# grant_write_acp: "GrantWriteACP",
|
16548
16712
|
# key: "ObjectKey", # required
|
16713
|
+
# write_offset_bytes: 1,
|
16549
16714
|
# metadata: {
|
16550
16715
|
# "MetadataKey" => "MetadataValue",
|
16551
16716
|
# },
|
@@ -16581,6 +16746,7 @@ module Aws::S3
|
|
16581
16746
|
# resp.ssekms_key_id #=> String
|
16582
16747
|
# resp.ssekms_encryption_context #=> String
|
16583
16748
|
# resp.bucket_key_enabled #=> Boolean
|
16749
|
+
# resp.size #=> Integer
|
16584
16750
|
# resp.request_charged #=> String, one of "requester"
|
16585
16751
|
#
|
16586
16752
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject AWS API Documentation
|
@@ -16592,7 +16758,7 @@ module Aws::S3
|
|
16592
16758
|
req.send_request(options)
|
16593
16759
|
end
|
16594
16760
|
|
16595
|
-
# <note markdown="1"> This operation is not supported
|
16761
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
16596
16762
|
#
|
16597
16763
|
# </note>
|
16598
16764
|
#
|
@@ -16676,7 +16842,6 @@ module Aws::S3
|
|
16676
16842
|
# General Reference.
|
16677
16843
|
#
|
16678
16844
|
# </note>
|
16679
|
-
#
|
16680
16845
|
# For example, the following `x-amz-grant-read` header grants list
|
16681
16846
|
# objects permission to the two Amazon Web Services accounts
|
16682
16847
|
# identified by their email addresses.
|
@@ -16962,7 +17127,7 @@ module Aws::S3
|
|
16962
17127
|
req.send_request(options)
|
16963
17128
|
end
|
16964
17129
|
|
16965
|
-
# <note markdown="1"> This operation is not supported
|
17130
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
16966
17131
|
#
|
16967
17132
|
# </note>
|
16968
17133
|
#
|
@@ -17081,7 +17246,7 @@ module Aws::S3
|
|
17081
17246
|
req.send_request(options)
|
17082
17247
|
end
|
17083
17248
|
|
17084
|
-
# <note markdown="1"> This operation is not supported
|
17249
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17085
17250
|
#
|
17086
17251
|
# </note>
|
17087
17252
|
#
|
@@ -17200,7 +17365,7 @@ module Aws::S3
|
|
17200
17365
|
req.send_request(options)
|
17201
17366
|
end
|
17202
17367
|
|
17203
|
-
# <note markdown="1"> This operation is not supported
|
17368
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17204
17369
|
#
|
17205
17370
|
# </note>
|
17206
17371
|
#
|
@@ -17329,7 +17494,7 @@ module Aws::S3
|
|
17329
17494
|
req.send_request(options)
|
17330
17495
|
end
|
17331
17496
|
|
17332
|
-
# <note markdown="1"> This operation is not supported
|
17497
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17333
17498
|
#
|
17334
17499
|
# </note>
|
17335
17500
|
#
|
@@ -17528,7 +17693,7 @@ module Aws::S3
|
|
17528
17693
|
req.send_request(options)
|
17529
17694
|
end
|
17530
17695
|
|
17531
|
-
# <note markdown="1"> This operation is not supported
|
17696
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17532
17697
|
#
|
17533
17698
|
# </note>
|
17534
17699
|
#
|
@@ -17636,7 +17801,7 @@ module Aws::S3
|
|
17636
17801
|
req.send_request(options)
|
17637
17802
|
end
|
17638
17803
|
|
17639
|
-
# <note markdown="1"> This operation is not supported
|
17804
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17640
17805
|
#
|
17641
17806
|
# </note>
|
17642
17807
|
#
|
@@ -17782,7 +17947,6 @@ module Aws::S3
|
|
17782
17947
|
# * *HTTP Status Code: 409 Conflict*
|
17783
17948
|
#
|
17784
17949
|
# * *SOAP Fault Code Prefix: Client*
|
17785
|
-
#
|
17786
17950
|
# * * *Code: GlacierExpeditedRetrievalNotAvailable*
|
17787
17951
|
#
|
17788
17952
|
# * *Cause: expedited retrievals are currently not available. Try
|
@@ -18021,7 +18185,7 @@ module Aws::S3
|
|
18021
18185
|
req.send_request(options)
|
18022
18186
|
end
|
18023
18187
|
|
18024
|
-
# <note markdown="1"> This operation is not supported
|
18188
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
18025
18189
|
#
|
18026
18190
|
# </note>
|
18027
18191
|
#
|
@@ -18569,7 +18733,6 @@ module Aws::S3
|
|
18569
18733
|
# * x-amz-server-side-encryption-customer-key
|
18570
18734
|
#
|
18571
18735
|
# * x-amz-server-side-encryption-customer-key-MD5
|
18572
|
-
#
|
18573
18736
|
# For more information, see [Using Server-Side Encryption][11] in
|
18574
18737
|
# the *Amazon S3 User Guide*.
|
18575
18738
|
#
|
@@ -18970,7 +19133,6 @@ module Aws::S3
|
|
18970
19133
|
# permissions required to use the multipart upload API, see
|
18971
19134
|
# [Multipart upload and permissions][8] and [Multipart upload API
|
18972
19135
|
# and permissions][9] in the *Amazon S3 User Guide*.
|
18973
|
-
#
|
18974
19136
|
# * **Directory bucket permissions** - You must have permissions in a
|
18975
19137
|
# bucket policy or an IAM identity-based policy based on the source
|
18976
19138
|
# and destination bucket types in an `UploadPartCopy` operation.
|
@@ -18988,7 +19150,6 @@ module Aws::S3
|
|
18988
19150
|
# `Action` element of a policy to write the object to the
|
18989
19151
|
# destination. The `s3express:SessionMode` condition key cannot be
|
18990
19152
|
# set to `ReadOnly` on the copy destination.
|
18991
|
-
#
|
18992
19153
|
# If the object is encrypted with SSE-KMS, you must also have the
|
18993
19154
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
18994
19155
|
# identity-based policies and KMS key policies for the KMS key.
|
@@ -19033,7 +19194,6 @@ module Aws::S3
|
|
19033
19194
|
# been aborted or completed.
|
19034
19195
|
#
|
19035
19196
|
# * HTTP Status Code: 404 Not Found
|
19036
|
-
#
|
19037
19197
|
# * Error Code: `InvalidRequest`
|
19038
19198
|
#
|
19039
19199
|
# * Description: The specified copy source is not supported as a
|
@@ -19457,7 +19617,7 @@ module Aws::S3
|
|
19457
19617
|
req.send_request(options)
|
19458
19618
|
end
|
19459
19619
|
|
19460
|
-
# <note markdown="1"> This operation is not supported
|
19620
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
19461
19621
|
#
|
19462
19622
|
# </note>
|
19463
19623
|
#
|
@@ -19866,7 +20026,7 @@ module Aws::S3
|
|
19866
20026
|
tracer: tracer
|
19867
20027
|
)
|
19868
20028
|
context[:gem_name] = 'aws-sdk-s3'
|
19869
|
-
context[:gem_version] = '1.
|
20029
|
+
context[:gem_version] = '1.173.0'
|
19870
20030
|
Seahorse::Client::Request.new(handlers, context)
|
19871
20031
|
end
|
19872
20032
|
|