aws-sdk-s3 1.169.0 → 1.175.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 +35 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +36 -2
- 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 +1314 -886
- data/lib/aws-sdk-s3/client_api.rb +32 -0
- data/lib/aws-sdk-s3/endpoint_provider.rb +36 -0
- data/lib/aws-sdk-s3/errors.rb +44 -0
- data/lib/aws-sdk-s3/multipart_upload.rb +33 -0
- data/lib/aws-sdk-s3/object.rb +77 -1
- data/lib/aws-sdk-s3/object_summary.rb +74 -0
- data/lib/aws-sdk-s3/object_version.rb +43 -0
- data/lib/aws-sdk-s3/plugins/http_200_errors.rb +3 -3
- data/lib/aws-sdk-s3/resource.rb +9 -8
- data/lib/aws-sdk-s3/types.rb +502 -208
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +8 -3
- data/sig/client.rbs +17 -6
- data/sig/errors.rbs +8 -0
- data/sig/multipart_upload.rbs +3 -1
- data/sig/object.rbs +6 -1
- data/sig/object_summary.rbs +6 -1
- data/sig/object_version.rbs +4 -1
- data/sig/resource.rbs +2 -2
- data/sig/types.rbs +26 -3
- metadata +2 -2
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -571,26 +571,30 @@ module Aws::S3
|
|
571
571
|
# in-progress multipart uploads are aborted or completed. To delete
|
572
572
|
# these in-progress multipart uploads, use the `ListMultipartUploads`
|
573
573
|
# operation to list the in-progress multipart uploads in the bucket
|
574
|
-
# and use the `
|
574
|
+
# and use the `AbortMultipartUpload` operation to abort all the
|
575
575
|
# in-progress multipart uploads.
|
576
576
|
#
|
577
577
|
# * **Directory buckets** - For directory buckets, you must make
|
578
578
|
# requests for this API operation to the Zonal endpoint. These
|
579
579
|
# endpoints support virtual-hosted-style requests in the format
|
580
|
-
# `https://
|
581
|
-
# `. Path-style requests are not supported. For more information
|
582
|
-
# [Regional and Zonal endpoints
|
580
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
581
|
+
# `. Path-style requests are not supported. For more information about
|
582
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
583
|
+
# for directory buckets in Availability Zones][2] in the *Amazon S3
|
584
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
585
|
+
# see [Available Local Zone for directory buckets][3] in the *Amazon
|
586
|
+
# S3 User Guide*.
|
583
587
|
#
|
584
588
|
# </note>
|
585
589
|
#
|
586
590
|
# Permissions
|
587
591
|
# : * **General purpose bucket permissions** - For information about
|
588
592
|
# permissions required to use the multipart upload, see [Multipart
|
589
|
-
# Upload and Permissions][
|
593
|
+
# Upload and Permissions][4] in the *Amazon S3 User Guide*.
|
590
594
|
#
|
591
595
|
# * **Directory bucket permissions** - To grant access to this API
|
592
596
|
# operation on a directory bucket, we recommend that you use the [
|
593
|
-
# `CreateSession` ][
|
597
|
+
# `CreateSession` ][5] API operation for session-based
|
594
598
|
# authorization. Specifically, you grant the
|
595
599
|
# `s3express:CreateSession` permission to the directory bucket in a
|
596
600
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -601,45 +605,46 @@ module Aws::S3
|
|
601
605
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
602
606
|
# refresh the session token automatically to avoid service
|
603
607
|
# interruptions when a session expires. For more information about
|
604
|
-
# authorization, see [ `CreateSession` ][
|
608
|
+
# authorization, see [ `CreateSession` ][5].
|
605
609
|
#
|
606
610
|
# HTTP Host header syntax
|
607
611
|
#
|
608
612
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
609
|
-
#
|
613
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
610
614
|
#
|
611
615
|
# The following operations are related to `AbortMultipartUpload`:
|
612
616
|
#
|
613
|
-
# * [CreateMultipartUpload][
|
617
|
+
# * [CreateMultipartUpload][6]
|
614
618
|
#
|
615
|
-
# * [UploadPart][
|
619
|
+
# * [UploadPart][7]
|
616
620
|
#
|
617
|
-
# * [CompleteMultipartUpload][
|
621
|
+
# * [CompleteMultipartUpload][8]
|
618
622
|
#
|
619
623
|
# * [ListParts][1]
|
620
624
|
#
|
621
|
-
# * [ListMultipartUploads][
|
625
|
+
# * [ListMultipartUploads][9]
|
622
626
|
#
|
623
627
|
#
|
624
628
|
#
|
625
629
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
626
630
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
627
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
628
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
629
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
630
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
631
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
632
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
631
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
632
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
633
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
634
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
635
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
636
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
637
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
633
638
|
#
|
634
639
|
# @option params [required, String] :bucket
|
635
640
|
# The bucket name to which the upload was taking place.
|
636
641
|
#
|
637
642
|
# **Directory buckets** - When you use this operation with a directory
|
638
643
|
# bucket, you must use virtual-hosted-style requests in the format `
|
639
|
-
#
|
640
|
-
# are not supported. Directory bucket names must be unique in
|
641
|
-
# Availability Zone. Bucket names must
|
642
|
-
#
|
644
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
645
|
+
# requests are not supported. Directory bucket names must be unique in
|
646
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
647
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
643
648
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
644
649
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
645
650
|
# *Amazon S3 User Guide*.
|
@@ -703,6 +708,18 @@ module Aws::S3
|
|
703
708
|
# you provide does not match the actual owner of the bucket, the request
|
704
709
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
705
710
|
#
|
711
|
+
# @option params [Time,DateTime,Date,Integer,String] :if_match_initiated_time
|
712
|
+
# If present, this header aborts an in progress multipart upload only if
|
713
|
+
# it was initiated on the provided timestamp. If the initiated timestamp
|
714
|
+
# of the multipart upload does not match the provided value, the
|
715
|
+
# operation returns a `412 Precondition Failed` error. If the initiated
|
716
|
+
# timestamp matches or if the multipart upload doesn’t exist, the
|
717
|
+
# operation returns a `204 Success (No Content)` response.
|
718
|
+
#
|
719
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
720
|
+
#
|
721
|
+
# </note>
|
722
|
+
#
|
706
723
|
# @return [Types::AbortMultipartUploadOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
707
724
|
#
|
708
725
|
# * {Types::AbortMultipartUploadOutput#request_charged #request_charged} => String
|
@@ -730,6 +747,7 @@ module Aws::S3
|
|
730
747
|
# upload_id: "MultipartUploadId", # required
|
731
748
|
# request_payer: "requester", # accepts requester
|
732
749
|
# expected_bucket_owner: "AccountId",
|
750
|
+
# if_match_initiated_time: Time.now,
|
733
751
|
# })
|
734
752
|
#
|
735
753
|
# @example Response structure
|
@@ -792,19 +810,23 @@ module Aws::S3
|
|
792
810
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
793
811
|
# for this API operation to the Zonal endpoint. These endpoints support
|
794
812
|
# virtual-hosted-style requests in the format
|
795
|
-
# `https://
|
796
|
-
# Path-style requests are not supported. For more information
|
797
|
-
# [Regional and Zonal endpoints
|
813
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
814
|
+
# `. Path-style requests are not supported. For more information about
|
815
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
816
|
+
# directory buckets in Availability Zones][5] in the *Amazon S3 User
|
817
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
818
|
+
# [Available Local Zone for directory buckets][6] in the *Amazon S3 User
|
819
|
+
# Guide*.
|
798
820
|
#
|
799
821
|
# </note>
|
800
822
|
#
|
801
823
|
# Permissions
|
802
824
|
# : * **General purpose bucket permissions** - For information about
|
803
825
|
# permissions required to use the multipart upload API, see
|
804
|
-
# [Multipart Upload and Permissions][
|
826
|
+
# [Multipart Upload and Permissions][7] in the *Amazon S3 User
|
805
827
|
# Guide*.
|
806
828
|
#
|
807
|
-
# If you provide an [additional checksum value][
|
829
|
+
# If you provide an [additional checksum value][8] in your
|
808
830
|
# `MultipartUpload` requests and the object is encrypted with Key
|
809
831
|
# Management Service, you must have permission to use the
|
810
832
|
# `kms:Decrypt` action for the `CompleteMultipartUpload` request to
|
@@ -812,7 +834,7 @@ module Aws::S3
|
|
812
834
|
#
|
813
835
|
# * **Directory bucket permissions** - To grant access to this API
|
814
836
|
# operation on a directory bucket, we recommend that you use the [
|
815
|
-
# `CreateSession` ][
|
837
|
+
# `CreateSession` ][9] API operation for session-based
|
816
838
|
# authorization. Specifically, you grant the
|
817
839
|
# `s3express:CreateSession` permission to the directory bucket in a
|
818
840
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -823,7 +845,7 @@ module Aws::S3
|
|
823
845
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
824
846
|
# refresh the session token automatically to avoid service
|
825
847
|
# interruptions when a session expires. For more information about
|
826
|
-
# authorization, see [ `CreateSession` ][
|
848
|
+
# authorization, see [ `CreateSession` ][9].
|
827
849
|
#
|
828
850
|
# If the object is encrypted with SSE-KMS, you must also have the
|
829
851
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -837,7 +859,6 @@ module Aws::S3
|
|
837
859
|
# except the last part.
|
838
860
|
#
|
839
861
|
# * HTTP Status Code: 400 Bad Request
|
840
|
-
#
|
841
862
|
# * Error Code: `InvalidPart`
|
842
863
|
#
|
843
864
|
# * Description: One or more of the specified parts could not be
|
@@ -845,14 +866,12 @@ module Aws::S3
|
|
845
866
|
# ETag might not have matched the uploaded part's ETag.
|
846
867
|
#
|
847
868
|
# * HTTP Status Code: 400 Bad Request
|
848
|
-
#
|
849
869
|
# * Error Code: `InvalidPartOrder`
|
850
870
|
#
|
851
871
|
# * Description: The list of parts was not in ascending order. The
|
852
872
|
# parts list must be specified in order by part number.
|
853
873
|
#
|
854
874
|
# * HTTP Status Code: 400 Bad Request
|
855
|
-
#
|
856
875
|
# * Error Code: `NoSuchUpload`
|
857
876
|
#
|
858
877
|
# * Description: The specified multipart upload does not exist. The
|
@@ -864,19 +883,19 @@ module Aws::S3
|
|
864
883
|
# HTTP Host header syntax
|
865
884
|
#
|
866
885
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
867
|
-
#
|
886
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
868
887
|
#
|
869
888
|
# The following operations are related to `CompleteMultipartUpload`:
|
870
889
|
#
|
871
|
-
# * [CreateMultipartUpload][
|
890
|
+
# * [CreateMultipartUpload][10]
|
872
891
|
#
|
873
892
|
# * [UploadPart][1]
|
874
893
|
#
|
875
|
-
# * [AbortMultipartUpload][
|
894
|
+
# * [AbortMultipartUpload][11]
|
876
895
|
#
|
877
|
-
# * [ListParts][
|
896
|
+
# * [ListParts][12]
|
878
897
|
#
|
879
|
-
# * [ListMultipartUploads][
|
898
|
+
# * [ListMultipartUploads][13]
|
880
899
|
#
|
881
900
|
#
|
882
901
|
#
|
@@ -885,23 +904,24 @@ module Aws::S3
|
|
885
904
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html
|
886
905
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
887
906
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
888
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
889
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
890
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
891
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
892
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
893
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
894
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
907
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
908
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
909
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
|
910
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
911
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
912
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
913
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
914
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
895
915
|
#
|
896
916
|
# @option params [required, String] :bucket
|
897
917
|
# Name of the bucket to which the multipart upload was initiated.
|
898
918
|
#
|
899
919
|
# **Directory buckets** - When you use this operation with a directory
|
900
920
|
# bucket, you must use virtual-hosted-style requests in the format `
|
901
|
-
#
|
902
|
-
# are not supported. Directory bucket names must be unique in
|
903
|
-
# Availability Zone. Bucket names must
|
904
|
-
#
|
921
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
922
|
+
# requests are not supported. Directory bucket names must be unique in
|
923
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
924
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
905
925
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
906
926
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
907
927
|
# *Amazon S3 User Guide*.
|
@@ -1012,6 +1032,27 @@ module Aws::S3
|
|
1012
1032
|
# you provide does not match the actual owner of the bucket, the request
|
1013
1033
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
1014
1034
|
#
|
1035
|
+
# @option params [String] :if_match
|
1036
|
+
# Uploads the object only if the ETag (entity tag) value provided during
|
1037
|
+
# the WRITE operation matches the ETag of the object in S3. If the ETag
|
1038
|
+
# values do not match, the operation returns a `412 Precondition Failed`
|
1039
|
+
# error.
|
1040
|
+
#
|
1041
|
+
# If a conflicting operation occurs during the upload S3 returns a `409
|
1042
|
+
# ConditionalRequestConflict` response. On a 409 failure you should
|
1043
|
+
# fetch the object's ETag, re-initiate the multipart upload with
|
1044
|
+
# `CreateMultipartUpload`, and re-upload each part.
|
1045
|
+
#
|
1046
|
+
# Expects the ETag value as a string.
|
1047
|
+
#
|
1048
|
+
# For more information about conditional requests, see [RFC 7232][1], or
|
1049
|
+
# [Conditional requests][2] in the *Amazon S3 User Guide*.
|
1050
|
+
#
|
1051
|
+
#
|
1052
|
+
#
|
1053
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
1054
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
|
1055
|
+
#
|
1015
1056
|
# @option params [String] :if_none_match
|
1016
1057
|
# Uploads the object only if the object key name does not already exist
|
1017
1058
|
# in the bucket specified. Otherwise, Amazon S3 returns a `412
|
@@ -1147,6 +1188,7 @@ module Aws::S3
|
|
1147
1188
|
# checksum_sha256: "ChecksumSHA256",
|
1148
1189
|
# request_payer: "requester", # accepts requester
|
1149
1190
|
# expected_bucket_owner: "AccountId",
|
1191
|
+
# if_match: "IfMatch",
|
1150
1192
|
# if_none_match: "IfNoneMatch",
|
1151
1193
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
1152
1194
|
# sse_customer_key: "SSECustomerKey",
|
@@ -1200,9 +1242,13 @@ module Aws::S3
|
|
1200
1242
|
# * <b>Directory buckets </b> - For directory buckets, you must make
|
1201
1243
|
# requests for this API operation to the Zonal endpoint. These
|
1202
1244
|
# endpoints support virtual-hosted-style requests in the format
|
1203
|
-
# `https://
|
1204
|
-
# `. Path-style requests are not supported. For more information
|
1205
|
-
# [Regional and Zonal endpoints
|
1245
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
1246
|
+
# `. Path-style requests are not supported. For more information about
|
1247
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
1248
|
+
# for directory buckets in Availability Zones][2] in the *Amazon S3
|
1249
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
1250
|
+
# see [Available Local Zone for directory buckets][3] in the *Amazon
|
1251
|
+
# S3 User Guide*.
|
1206
1252
|
#
|
1207
1253
|
# * VPC endpoints don't support cross-Region requests (including
|
1208
1254
|
# copies). If you're using VPC endpoints, your source and destination
|
@@ -1214,13 +1260,13 @@ module Aws::S3
|
|
1214
1260
|
# Both the Region that you want to copy the object from and the Region
|
1215
1261
|
# that you want to copy the object to must be enabled for your account.
|
1216
1262
|
# For more information about how to enable a Region for your account,
|
1217
|
-
# see [Enable or disable a Region for standalone accounts][
|
1263
|
+
# see [Enable or disable a Region for standalone accounts][4] in the
|
1218
1264
|
# *Amazon Web Services Account Management Guide*.
|
1219
1265
|
#
|
1220
1266
|
# Amazon S3 transfer acceleration does not support cross-Region copies.
|
1221
1267
|
# If you request a cross-Region copy using a transfer acceleration
|
1222
1268
|
# endpoint, you get a `400 Bad Request` error. For more information, see
|
1223
|
-
# [Transfer Acceleration][
|
1269
|
+
# [Transfer Acceleration][5].
|
1224
1270
|
#
|
1225
1271
|
# Authentication and authorization
|
1226
1272
|
#
|
@@ -1228,7 +1274,7 @@ module Aws::S3
|
|
1228
1274
|
# IAM credentials (access key ID and secret access key for the IAM
|
1229
1275
|
# identities). All headers with the `x-amz-` prefix, including
|
1230
1276
|
# `x-amz-copy-source`, must be signed. For more information, see [REST
|
1231
|
-
# Authentication][
|
1277
|
+
# Authentication][6].
|
1232
1278
|
#
|
1233
1279
|
# **Directory buckets** - You must use the IAM credentials to
|
1234
1280
|
# authenticate and authorize your access to the `CopyObject` API
|
@@ -1254,7 +1300,6 @@ module Aws::S3
|
|
1254
1300
|
# * If the destination bucket is a general purpose bucket, you must
|
1255
1301
|
# have <b> <code>s3:PutObject</code> </b> permission to write the
|
1256
1302
|
# object copy to the destination bucket.
|
1257
|
-
#
|
1258
1303
|
# * **Directory bucket permissions** - You must have permissions in a
|
1259
1304
|
# bucket policy or an IAM identity-based policy based on the source
|
1260
1305
|
# and destination bucket types in a `CopyObject` operation.
|
@@ -1272,15 +1317,14 @@ module Aws::S3
|
|
1272
1317
|
# `Action` element of a policy to write the object to the
|
1273
1318
|
# destination. The `s3express:SessionMode` condition key can't be
|
1274
1319
|
# set to `ReadOnly` on the copy destination bucket.
|
1275
|
-
#
|
1276
1320
|
# If the object is encrypted with SSE-KMS, you must also have the
|
1277
1321
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
1278
1322
|
# identity-based policies and KMS key policies for the KMS key.
|
1279
1323
|
#
|
1280
1324
|
# For example policies, see [Example bucket policies for S3 Express
|
1281
|
-
# One Zone][
|
1325
|
+
# One Zone][7] and [Amazon Web Services Identity and Access
|
1282
1326
|
# Management (IAM) identity-based policies for S3 Express One
|
1283
|
-
# Zone][
|
1327
|
+
# Zone][8] in the *Amazon S3 User Guide*.
|
1284
1328
|
#
|
1285
1329
|
# Response and special errors
|
1286
1330
|
#
|
@@ -1303,7 +1347,7 @@ module Aws::S3
|
|
1303
1347
|
# response is embedded in the `200 OK` response. For example, in a
|
1304
1348
|
# cross-region copy, you may encounter throttling and receive a
|
1305
1349
|
# `200 OK` response. For more information, see [Resolve the Error
|
1306
|
-
# 200 response when copying objects to Amazon S3][
|
1350
|
+
# 200 response when copying objects to Amazon S3][9]. The `200 OK`
|
1307
1351
|
# status code means the copy was accepted, but it doesn't mean
|
1308
1352
|
# the copy is complete. Another example is when you disconnect
|
1309
1353
|
# from Amazon S3 before the copy is complete, Amazon S3 might
|
@@ -1327,32 +1371,33 @@ module Aws::S3
|
|
1327
1371
|
# result in a data retrieval charge for the source if the source
|
1328
1372
|
# storage class bills for data retrieval. If the copy source is in a
|
1329
1373
|
# different region, the data transfer is billed to the copy source
|
1330
|
-
# account. For pricing information, see [Amazon S3 pricing][
|
1374
|
+
# account. For pricing information, see [Amazon S3 pricing][10].
|
1331
1375
|
#
|
1332
1376
|
# HTTP Host header syntax
|
1333
1377
|
#
|
1334
1378
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
1335
|
-
#
|
1379
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
1336
1380
|
#
|
1337
1381
|
# The following operations are related to `CopyObject`:
|
1338
1382
|
#
|
1339
|
-
# * [PutObject][
|
1383
|
+
# * [PutObject][11]
|
1340
1384
|
#
|
1341
|
-
# * [GetObject][
|
1385
|
+
# * [GetObject][12]
|
1342
1386
|
#
|
1343
1387
|
#
|
1344
1388
|
#
|
1345
1389
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
|
1346
1390
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
1347
|
-
# [3]: https://docs.aws.amazon.com/
|
1348
|
-
# [4]: https://docs.aws.amazon.com/
|
1349
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1350
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1351
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-
|
1352
|
-
# [8]: https://
|
1353
|
-
# [9]:
|
1354
|
-
# [10]:
|
1355
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1391
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
1392
|
+
# [4]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
|
1393
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
|
1394
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
1395
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
1396
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
1397
|
+
# [9]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
|
1398
|
+
# [10]: http://aws.amazon.com/s3/pricing/
|
1399
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
1400
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
1356
1401
|
#
|
1357
1402
|
# @option params [String] :acl
|
1358
1403
|
# The canned access control list (ACL) to apply to the object.
|
@@ -1392,14 +1437,22 @@ module Aws::S3
|
|
1392
1437
|
#
|
1393
1438
|
# **Directory buckets** - When you use this operation with a directory
|
1394
1439
|
# bucket, you must use virtual-hosted-style requests in the format `
|
1395
|
-
#
|
1396
|
-
# are not supported. Directory bucket names must be unique in
|
1397
|
-
# Availability Zone. Bucket names must
|
1398
|
-
#
|
1440
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
1441
|
+
# requests are not supported. Directory bucket names must be unique in
|
1442
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
1443
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
1399
1444
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
1400
1445
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
1401
1446
|
# *Amazon S3 User Guide*.
|
1402
1447
|
#
|
1448
|
+
# <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
|
1449
|
+
# supported when the source or destination bucket is in Amazon Web
|
1450
|
+
# Services Local Zones. The source and destination buckets must have the
|
1451
|
+
# same parent Amazon Web Services Region. Otherwise, you get an HTTP
|
1452
|
+
# `400 Bad Request` error with the error code `InvalidRequest`.
|
1453
|
+
#
|
1454
|
+
# </note>
|
1455
|
+
#
|
1403
1456
|
# **Access points** - When you use this action with an access point, you
|
1404
1457
|
# must provide the alias of the access point in place of the bucket name
|
1405
1458
|
# or specify the access point ARN. When using the access point ARN, you
|
@@ -2252,10 +2305,13 @@ module Aws::S3
|
|
2252
2305
|
# * <b>Directory buckets </b> - For directory buckets, you must make
|
2253
2306
|
# requests for this API operation to the Regional endpoint. These
|
2254
2307
|
# endpoints support path-style requests in the format
|
2255
|
-
# `https://s3express-control.
|
2308
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
2256
2309
|
# Virtual-hosted-style requests aren't supported. For more
|
2257
|
-
# information, see [Regional and
|
2258
|
-
#
|
2310
|
+
# information about endpoints in Availability Zones, see [Regional and
|
2311
|
+
# Zonal endpoints for directory buckets in Availability Zones][4] in
|
2312
|
+
# the *Amazon S3 User Guide*. For more information about endpoints in
|
2313
|
+
# Local Zones, see [Available Local Zone for directory buckets][5] in
|
2314
|
+
# the *Amazon S3 User Guide*.
|
2259
2315
|
#
|
2260
2316
|
# </note>
|
2261
2317
|
#
|
@@ -2297,19 +2353,18 @@ module Aws::S3
|
|
2297
2353
|
# disabled. If you would like to share data with users outside of
|
2298
2354
|
# your account, you can use bucket policies as needed. For more
|
2299
2355
|
# information, see [Controlling ownership of objects and disabling
|
2300
|
-
# ACLs for your bucket ][
|
2301
|
-
# Amazon S3 storage ][
|
2356
|
+
# ACLs for your bucket ][6] and [Blocking public access to your
|
2357
|
+
# Amazon S3 storage ][7] in the *Amazon S3 User Guide*.
|
2302
2358
|
#
|
2303
2359
|
# * **S3 Block Public Access** - If your specific use case requires
|
2304
2360
|
# granting public access to your S3 resources, you can disable
|
2305
2361
|
# Block Public Access. Specifically, you can create a new bucket
|
2306
2362
|
# with Block Public Access enabled, then separately call the [
|
2307
|
-
# `DeletePublicAccessBlock` ][
|
2363
|
+
# `DeletePublicAccessBlock` ][8] API. To use this operation, you
|
2308
2364
|
# must have the `s3:PutBucketPublicAccessBlock` permission. For
|
2309
2365
|
# more information about S3 Block Public Access, see [Blocking
|
2310
|
-
# public access to your Amazon S3 storage ][
|
2366
|
+
# public access to your Amazon S3 storage ][7] in the *Amazon S3
|
2311
2367
|
# User Guide*.
|
2312
|
-
#
|
2313
2368
|
# * **Directory bucket permissions** - You must have the
|
2314
2369
|
# `s3express:CreateBucket` permission in an IAM identity-based
|
2315
2370
|
# policy instead of a bucket policy. Cross-account access to this
|
@@ -2317,7 +2372,7 @@ module Aws::S3
|
|
2317
2372
|
# performed by the Amazon Web Services account that owns the
|
2318
2373
|
# resource. For more information about directory bucket policies and
|
2319
2374
|
# permissions, see [Amazon Web Services Identity and Access
|
2320
|
-
# Management (IAM) for S3 Express One Zone][
|
2375
|
+
# Management (IAM) for S3 Express One Zone][9] in the *Amazon S3
|
2321
2376
|
# User Guide*.
|
2322
2377
|
#
|
2323
2378
|
# The permissions for ACLs, Object Lock, S3 Object Ownership, and S3
|
@@ -2327,21 +2382,21 @@ module Aws::S3
|
|
2327
2382
|
# enforced (ACLs disabled). These settings can't be modified.
|
2328
2383
|
#
|
2329
2384
|
# For more information about permissions for creating and working
|
2330
|
-
# with directory buckets, see [Directory buckets][
|
2385
|
+
# with directory buckets, see [Directory buckets][10] in the *Amazon
|
2331
2386
|
# S3 User Guide*. For more information about supported S3 features
|
2332
|
-
# for directory buckets, see [Features of S3 Express One Zone][
|
2387
|
+
# for directory buckets, see [Features of S3 Express One Zone][11]
|
2333
2388
|
# in the *Amazon S3 User Guide*.
|
2334
2389
|
#
|
2335
2390
|
# HTTP Host header syntax
|
2336
2391
|
#
|
2337
2392
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
2338
|
-
# `s3express-control.region.amazonaws.com`.
|
2393
|
+
# `s3express-control.region-code.amazonaws.com`.
|
2339
2394
|
#
|
2340
2395
|
# The following operations are related to `CreateBucket`:
|
2341
2396
|
#
|
2342
|
-
# * [PutObject][
|
2397
|
+
# * [PutObject][12]
|
2343
2398
|
#
|
2344
|
-
# * [DeleteBucket][
|
2399
|
+
# * [DeleteBucket][13]
|
2345
2400
|
#
|
2346
2401
|
#
|
2347
2402
|
#
|
@@ -2349,14 +2404,15 @@ module Aws::S3
|
|
2349
2404
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
|
2350
2405
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
|
2351
2406
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
2352
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
2353
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
2354
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2355
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2356
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
2357
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
2358
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2359
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2407
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
2408
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
2409
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
|
2410
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
|
2411
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
2412
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
|
2413
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
|
2414
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
2415
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
2360
2416
|
#
|
2361
2417
|
# @option params [String] :acl
|
2362
2418
|
# The canned ACL to apply to the bucket.
|
@@ -2374,13 +2430,14 @@ module Aws::S3
|
|
2374
2430
|
#
|
2375
2431
|
# <b>Directory buckets </b> - When you use this operation with a
|
2376
2432
|
# directory bucket, you must use path-style requests in the format
|
2377
|
-
# `https://s3express-control.
|
2433
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
2378
2434
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
2379
|
-
# names must be unique in the chosen Availability Zone
|
2380
|
-
# must also follow the format `
|
2381
|
-
#
|
2382
|
-
#
|
2383
|
-
#
|
2435
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
2436
|
+
# Zone). Bucket names must also follow the format `
|
2437
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
2438
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
2439
|
+
# naming restrictions, see [Directory bucket naming rules][2] in the
|
2440
|
+
# *Amazon S3 User Guide*
|
2384
2441
|
#
|
2385
2442
|
#
|
2386
2443
|
#
|
@@ -2514,11 +2571,11 @@ module Aws::S3
|
|
2514
2571
|
# create_bucket_configuration: {
|
2515
2572
|
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
2516
2573
|
# location: {
|
2517
|
-
# type: "AvailabilityZone", # accepts AvailabilityZone
|
2574
|
+
# type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
|
2518
2575
|
# name: "LocationNameAsString",
|
2519
2576
|
# },
|
2520
2577
|
# bucket: {
|
2521
|
-
# data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone
|
2578
|
+
# data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
|
2522
2579
|
# type: "Directory", # accepts Directory
|
2523
2580
|
# },
|
2524
2581
|
# },
|
@@ -2575,9 +2632,13 @@ module Aws::S3
|
|
2575
2632
|
# * <b>Directory buckets </b> - For directory buckets, you must make
|
2576
2633
|
# requests for this API operation to the Zonal endpoint. These
|
2577
2634
|
# endpoints support virtual-hosted-style requests in the format
|
2578
|
-
# `https://
|
2579
|
-
# `. Path-style requests are not supported. For more information
|
2580
|
-
# [Regional and Zonal endpoints
|
2635
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
2636
|
+
# `. Path-style requests are not supported. For more information about
|
2637
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
2638
|
+
# for directory buckets in Availability Zones][4] in the *Amazon S3
|
2639
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
2640
|
+
# see [Available Local Zone for directory buckets][5] in the *Amazon
|
2641
|
+
# S3 User Guide*.
|
2581
2642
|
#
|
2582
2643
|
# </note>
|
2583
2644
|
#
|
@@ -2589,7 +2650,7 @@ module Aws::S3
|
|
2589
2650
|
# sign each request individually. There is nothing special about
|
2590
2651
|
# signing multipart upload requests. For more information about
|
2591
2652
|
# signing, see [Authenticating Requests (Amazon Web Services Signature
|
2592
|
-
# Version 4)][
|
2653
|
+
# Version 4)][6] in the *Amazon S3 User Guide*.
|
2593
2654
|
#
|
2594
2655
|
# Permissions
|
2595
2656
|
# : * **General purpose bucket permissions** - To perform a multipart
|
@@ -2602,13 +2663,13 @@ module Aws::S3
|
|
2602
2663
|
# `UploadPartCopy` APIs. These permissions are required because
|
2603
2664
|
# Amazon S3 must decrypt and read data from the encrypted file parts
|
2604
2665
|
# before it completes the multipart upload. For more information,
|
2605
|
-
# see [Multipart upload API and permissions][
|
2606
|
-
# using server-side encryption with Amazon Web Services KMS][
|
2666
|
+
# see [Multipart upload API and permissions][7] and [Protecting data
|
2667
|
+
# using server-side encryption with Amazon Web Services KMS][8] in
|
2607
2668
|
# the *Amazon S3 User Guide*.
|
2608
2669
|
#
|
2609
2670
|
# * **Directory bucket permissions** - To grant access to this API
|
2610
2671
|
# operation on a directory bucket, we recommend that you use the [
|
2611
|
-
# `CreateSession` ][
|
2672
|
+
# `CreateSession` ][9] API operation for session-based
|
2612
2673
|
# authorization. Specifically, you grant the
|
2613
2674
|
# `s3express:CreateSession` permission to the directory bucket in a
|
2614
2675
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -2619,7 +2680,7 @@ module Aws::S3
|
|
2619
2680
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
2620
2681
|
# refresh the session token automatically to avoid service
|
2621
2682
|
# interruptions when a session expires. For more information about
|
2622
|
-
# authorization, see [ `CreateSession` ][
|
2683
|
+
# authorization, see [ `CreateSession` ][9].
|
2623
2684
|
#
|
2624
2685
|
# Encryption
|
2625
2686
|
# : * **General purpose buckets** - Server-side encryption is for data
|
@@ -2646,7 +2707,7 @@ module Aws::S3
|
|
2646
2707
|
# the destination bucket, the encryption setting in your request
|
2647
2708
|
# takes precedence. If you choose to provide your own encryption
|
2648
2709
|
# key, the request headers you provide in [UploadPart][1] and
|
2649
|
-
# [UploadPartCopy][
|
2710
|
+
# [UploadPartCopy][10] requests must match the headers you used in
|
2650
2711
|
# the `CreateMultipartUpload` request.
|
2651
2712
|
#
|
2652
2713
|
# * Use KMS keys (SSE-KMS) that include the Amazon Web Services
|
@@ -2660,7 +2721,6 @@ module Aws::S3
|
|
2660
2721
|
# * `x-amz-server-side-encryption-aws-kms-key-id`
|
2661
2722
|
#
|
2662
2723
|
# * `x-amz-server-side-encryption-context`
|
2663
|
-
#
|
2664
2724
|
# <note markdown="1"> * If you specify `x-amz-server-side-encryption:aws:kms`, but
|
2665
2725
|
# don't provide `x-amz-server-side-encryption-aws-kms-key-id`,
|
2666
2726
|
# Amazon S3 uses the Amazon Web Services managed key (`aws/s3`
|
@@ -2672,9 +2732,9 @@ module Aws::S3
|
|
2672
2732
|
# actions on the key. These permissions are required because
|
2673
2733
|
# Amazon S3 must decrypt and read data from the encrypted file
|
2674
2734
|
# parts before it completes the multipart upload. For more
|
2675
|
-
# information, see [Multipart upload API and permissions][
|
2735
|
+
# information, see [Multipart upload API and permissions][7] and
|
2676
2736
|
# [Protecting data using server-side encryption with Amazon Web
|
2677
|
-
# Services KMS][
|
2737
|
+
# Services KMS][8] in the *Amazon S3 User Guide*.
|
2678
2738
|
#
|
2679
2739
|
# * If your Identity and Access Management (IAM) user or role is
|
2680
2740
|
# in the same Amazon Web Services account as the KMS key, then
|
@@ -2689,13 +2749,13 @@ module Aws::S3
|
|
2689
2749
|
# For information about configuring any of the officially
|
2690
2750
|
# supported Amazon Web Services SDKs and Amazon Web Services
|
2691
2751
|
# CLI, see [Specifying the Signature Version in Request
|
2692
|
-
# Authentication][
|
2752
|
+
# Authentication][11] in the *Amazon S3 User Guide*.
|
2693
2753
|
#
|
2694
2754
|
# </note>
|
2695
2755
|
#
|
2696
2756
|
# For more information about server-side encryption with KMS keys
|
2697
2757
|
# (SSE-KMS), see [Protecting Data Using Server-Side Encryption
|
2698
|
-
# with KMS keys][
|
2758
|
+
# with KMS keys][8] in the *Amazon S3 User Guide*.
|
2699
2759
|
#
|
2700
2760
|
# * Use customer-provided encryption keys (SSE-C) – If you want to
|
2701
2761
|
# manage your own encryption keys, provide all the following
|
@@ -2706,12 +2766,10 @@ module Aws::S3
|
|
2706
2766
|
# * `x-amz-server-side-encryption-customer-key`
|
2707
2767
|
#
|
2708
2768
|
# * `x-amz-server-side-encryption-customer-key-MD5`
|
2709
|
-
#
|
2710
2769
|
# For more information about server-side encryption with
|
2711
2770
|
# customer-provided encryption keys (SSE-C), see [ Protecting data
|
2712
2771
|
# using server-side encryption with customer-provided encryption
|
2713
|
-
# keys (SSE-C)][
|
2714
|
-
#
|
2772
|
+
# keys (SSE-C)][12] in the *Amazon S3 User Guide*.
|
2715
2773
|
# * **Directory buckets** - For directory buckets, there are only two
|
2716
2774
|
# supported options for server-side encryption: server-side
|
2717
2775
|
# encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
|
@@ -2721,13 +2779,13 @@ module Aws::S3
|
|
2721
2779
|
# default encryption in your `CreateSession` requests or `PUT`
|
2722
2780
|
# object requests. Then, new objects are automatically encrypted
|
2723
2781
|
# with the desired encryption settings. For more information, see
|
2724
|
-
# [Protecting data with server-side encryption][
|
2782
|
+
# [Protecting data with server-side encryption][13] in the *Amazon
|
2725
2783
|
# S3 User Guide*. For more information about the encryption
|
2726
2784
|
# overriding behaviors in directory buckets, see [Specifying
|
2727
|
-
# server-side encryption with KMS for new object uploads][
|
2785
|
+
# server-side encryption with KMS for new object uploads][14].
|
2728
2786
|
#
|
2729
|
-
# In the Zonal endpoint API calls (except [CopyObject][
|
2730
|
-
# [UploadPartCopy][
|
2787
|
+
# In the Zonal endpoint API calls (except [CopyObject][15] and
|
2788
|
+
# [UploadPartCopy][10]) using the REST API, the encryption request
|
2731
2789
|
# headers must match the encryption settings that are specified in
|
2732
2790
|
# the `CreateSession` request. You can't override the values of the
|
2733
2791
|
# encryption settings (`x-amz-server-side-encryption`,
|
@@ -2747,7 +2805,7 @@ module Aws::S3
|
|
2747
2805
|
# configuration for the `CreateSession` request. It's not supported
|
2748
2806
|
# to override the encryption settings values in the `CreateSession`
|
2749
2807
|
# request. So in the Zonal endpoint API calls (except
|
2750
|
-
# [CopyObject][
|
2808
|
+
# [CopyObject][15] and [UploadPartCopy][10]), the encryption request
|
2751
2809
|
# headers must match the default encryption configuration of the
|
2752
2810
|
# directory bucket.
|
2753
2811
|
#
|
@@ -2763,19 +2821,19 @@ module Aws::S3
|
|
2763
2821
|
# HTTP Host header syntax
|
2764
2822
|
#
|
2765
2823
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
2766
|
-
#
|
2824
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
2767
2825
|
#
|
2768
2826
|
# The following operations are related to `CreateMultipartUpload`:
|
2769
2827
|
#
|
2770
2828
|
# * [UploadPart][1]
|
2771
2829
|
#
|
2772
|
-
# * [CompleteMultipartUpload][
|
2830
|
+
# * [CompleteMultipartUpload][16]
|
2773
2831
|
#
|
2774
|
-
# * [AbortMultipartUpload][
|
2832
|
+
# * [AbortMultipartUpload][17]
|
2775
2833
|
#
|
2776
|
-
# * [ListParts][
|
2834
|
+
# * [ListParts][18]
|
2777
2835
|
#
|
2778
|
-
# * [ListMultipartUploads][
|
2836
|
+
# * [ListMultipartUploads][19]
|
2779
2837
|
#
|
2780
2838
|
#
|
2781
2839
|
#
|
@@ -2783,20 +2841,21 @@ module Aws::S3
|
|
2783
2841
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
2784
2842
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
|
2785
2843
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
2786
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2787
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2788
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
2789
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2790
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2791
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2792
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2793
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
2794
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-
|
2795
|
-
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2796
|
-
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2797
|
-
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2798
|
-
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2799
|
-
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
2844
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
2845
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
2846
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
2847
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
|
2848
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
2849
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
2850
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
|
2851
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
|
2852
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
2853
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
2854
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
2855
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
2856
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
2857
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
2858
|
+
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
2800
2859
|
#
|
2801
2860
|
# @option params [String] :acl
|
2802
2861
|
# The canned ACL to apply to the object. Amazon S3 supports a set of
|
@@ -2829,10 +2888,10 @@ module Aws::S3
|
|
2829
2888
|
#
|
2830
2889
|
# **Directory buckets** - When you use this operation with a directory
|
2831
2890
|
# bucket, you must use virtual-hosted-style requests in the format `
|
2832
|
-
#
|
2833
|
-
# are not supported. Directory bucket names must be unique in
|
2834
|
-
# Availability Zone. Bucket names must
|
2835
|
-
#
|
2891
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
2892
|
+
# requests are not supported. Directory bucket names must be unique in
|
2893
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
2894
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
2836
2895
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
2837
2896
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
2838
2897
|
# *Amazon S3 User Guide*.
|
@@ -3529,23 +3588,27 @@ module Aws::S3
|
|
3529
3588
|
#
|
3530
3589
|
# <note markdown="1"> * You must make requests for this API operation to the Zonal endpoint.
|
3531
3590
|
# These endpoints support virtual-hosted-style requests in the format
|
3532
|
-
# `https://
|
3533
|
-
# Path-style requests are not supported. For more information
|
3534
|
-
# [Regional and Zonal endpoints
|
3591
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
3592
|
+
# Path-style requests are not supported. For more information about
|
3593
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
3594
|
+
# for directory buckets in Availability Zones][3] in the *Amazon S3
|
3595
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
3596
|
+
# see [Available Local Zone for directory buckets][4] in the *Amazon
|
3597
|
+
# S3 User Guide*.
|
3535
3598
|
#
|
3536
3599
|
# * <b> <code>CopyObject</code> API operation</b> - Unlike other Zonal
|
3537
3600
|
# endpoint API operations, the `CopyObject` API operation doesn't use
|
3538
3601
|
# the temporary security credentials returned from the `CreateSession`
|
3539
3602
|
# API operation for authentication and authorization. For information
|
3540
3603
|
# about authentication and authorization of the `CopyObject` API
|
3541
|
-
# operation on directory buckets, see [CopyObject][
|
3604
|
+
# operation on directory buckets, see [CopyObject][5].
|
3542
3605
|
#
|
3543
3606
|
# * <b> <code>HeadBucket</code> API operation</b> - Unlike other Zonal
|
3544
3607
|
# endpoint API operations, the `HeadBucket` API operation doesn't use
|
3545
3608
|
# the temporary security credentials returned from the `CreateSession`
|
3546
3609
|
# API operation for authentication and authorization. For information
|
3547
3610
|
# about authentication and authorization of the `HeadBucket` API
|
3548
|
-
# operation on directory buckets, see [HeadBucket][
|
3611
|
+
# operation on directory buckets, see [HeadBucket][6].
|
3549
3612
|
#
|
3550
3613
|
# </note>
|
3551
3614
|
#
|
@@ -3557,10 +3620,10 @@ module Aws::S3
|
|
3557
3620
|
# can have the `s3express:SessionMode` condition key to control who
|
3558
3621
|
# can create a `ReadWrite` or `ReadOnly` session. For more information
|
3559
3622
|
# about `ReadWrite` or `ReadOnly` sessions, see [
|
3560
|
-
# `x-amz-create-session-mode` ][
|
3561
|
-
# bucket policies for S3 Express One Zone][
|
3623
|
+
# `x-amz-create-session-mode` ][7]. For example policies, see [Example
|
3624
|
+
# bucket policies for S3 Express One Zone][8] and [Amazon Web Services
|
3562
3625
|
# Identity and Access Management (IAM) identity-based policies for S3
|
3563
|
-
# Express One Zone][
|
3626
|
+
# Express One Zone][9] in the *Amazon S3 User Guide*.
|
3564
3627
|
#
|
3565
3628
|
# To grant cross-account access to Zonal endpoint API operations, the
|
3566
3629
|
# bucket policy should also grant both accounts the
|
@@ -3581,32 +3644,32 @@ module Aws::S3
|
|
3581
3644
|
# requests or `PUT` object requests. Then, new objects are
|
3582
3645
|
# automatically encrypted with the desired encryption settings. For
|
3583
3646
|
# more information, see [Protecting data with server-side
|
3584
|
-
# encryption][
|
3647
|
+
# encryption][10] in the *Amazon S3 User Guide*. For more information
|
3585
3648
|
# about the encryption overriding behaviors in directory buckets, see
|
3586
3649
|
# [Specifying server-side encryption with KMS for new object
|
3587
|
-
# uploads][
|
3650
|
+
# uploads][11].
|
3588
3651
|
#
|
3589
|
-
# For [Zonal endpoint (object-level) API operations][
|
3590
|
-
# [CopyObject][
|
3591
|
-
# authorize requests through [CreateSession][
|
3652
|
+
# For [Zonal endpoint (object-level) API operations][12] except
|
3653
|
+
# [CopyObject][5] and [UploadPartCopy][13], you authenticate and
|
3654
|
+
# authorize requests through [CreateSession][14] for low latency. To
|
3592
3655
|
# encrypt new objects in a directory bucket with SSE-KMS, you must
|
3593
3656
|
# specify SSE-KMS as the directory bucket's default encryption
|
3594
3657
|
# configuration with a KMS key (specifically, a [customer managed
|
3595
|
-
# key][
|
3658
|
+
# key][15]). Then, when a session is created for Zonal endpoint API
|
3596
3659
|
# operations, new objects are automatically encrypted and decrypted
|
3597
3660
|
# with SSE-KMS and S3 Bucket Keys during the session.
|
3598
3661
|
#
|
3599
|
-
# <note markdown="1"> Only 1 [customer managed key][
|
3662
|
+
# <note markdown="1"> Only 1 [customer managed key][15] is supported per directory bucket
|
3600
3663
|
# for the lifetime of the bucket. The [Amazon Web Services managed
|
3601
|
-
# key][
|
3664
|
+
# key][16] (`aws/s3`) isn't supported. After you specify SSE-KMS as
|
3602
3665
|
# your bucket's default encryption configuration with a customer
|
3603
3666
|
# managed key, you can't change the customer managed key for the
|
3604
3667
|
# bucket's SSE-KMS configuration.
|
3605
3668
|
#
|
3606
3669
|
# </note>
|
3607
3670
|
#
|
3608
|
-
# In the Zonal endpoint API calls (except [CopyObject][
|
3609
|
-
# [UploadPartCopy][
|
3671
|
+
# In the Zonal endpoint API calls (except [CopyObject][5] and
|
3672
|
+
# [UploadPartCopy][13]) using the REST API, you can't override the
|
3610
3673
|
# values of the encryption settings (`x-amz-server-side-encryption`,
|
3611
3674
|
# `x-amz-server-side-encryption-aws-kms-key-id`,
|
3612
3675
|
# `x-amz-server-side-encryption-context`, and
|
@@ -3622,8 +3685,8 @@ module Aws::S3
|
|
3622
3685
|
# Web Services SDKs use the bucket's default encryption configuration
|
3623
3686
|
# for the `CreateSession` request. It's not supported to override the
|
3624
3687
|
# encryption settings values in the `CreateSession` request. Also, in
|
3625
|
-
# the Zonal endpoint API calls (except [CopyObject][
|
3626
|
-
# [UploadPartCopy][
|
3688
|
+
# the Zonal endpoint API calls (except [CopyObject][5] and
|
3689
|
+
# [UploadPartCopy][13]), it's not supported to override the values of
|
3627
3690
|
# the encryption settings from the `CreateSession` request.
|
3628
3691
|
#
|
3629
3692
|
# </note>
|
@@ -3631,25 +3694,26 @@ module Aws::S3
|
|
3631
3694
|
# HTTP Host header syntax
|
3632
3695
|
#
|
3633
3696
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
3634
|
-
#
|
3697
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
3635
3698
|
#
|
3636
3699
|
#
|
3637
3700
|
#
|
3638
3701
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
|
3639
3702
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-optimizing-performance-guidelines-design-patterns.html#s3-express-optimizing-performance-session-authentication
|
3640
3703
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
3641
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3642
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
3643
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
3644
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3645
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-
|
3646
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-
|
3647
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-
|
3648
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-
|
3649
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3650
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
3651
|
-
# [14]: https://docs.aws.amazon.com/
|
3652
|
-
# [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#
|
3704
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
3705
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
3706
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
|
3707
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
|
3708
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
3709
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
3710
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
3711
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
3712
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
|
3713
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
3714
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
3715
|
+
# [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
|
3716
|
+
# [16]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
|
3653
3717
|
#
|
3654
3718
|
# @option params [String] :session_mode
|
3655
3719
|
# Specifies the mode of the session that will be created, either
|
@@ -3791,10 +3855,13 @@ module Aws::S3
|
|
3791
3855
|
# * <b>Directory buckets </b> - For directory buckets, you must make
|
3792
3856
|
# requests for this API operation to the Regional endpoint. These
|
3793
3857
|
# endpoints support path-style requests in the format
|
3794
|
-
# `https://s3express-control.
|
3858
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
3795
3859
|
# Virtual-hosted-style requests aren't supported. For more
|
3796
|
-
# information, see [Regional and
|
3797
|
-
#
|
3860
|
+
# information about endpoints in Availability Zones, see [Regional and
|
3861
|
+
# Zonal endpoints for directory buckets in Availability Zones][1] in
|
3862
|
+
# the *Amazon S3 User Guide*. For more information about endpoints in
|
3863
|
+
# Local Zones, see [Available Local Zone for directory buckets][2] in
|
3864
|
+
# the *Amazon S3 User Guide*.
|
3798
3865
|
#
|
3799
3866
|
# </note>
|
3800
3867
|
#
|
@@ -3809,39 +3876,41 @@ module Aws::S3
|
|
3809
3876
|
# performed by the Amazon Web Services account that owns the
|
3810
3877
|
# resource. For more information about directory bucket policies and
|
3811
3878
|
# permissions, see [Amazon Web Services Identity and Access
|
3812
|
-
# Management (IAM) for S3 Express One Zone][
|
3879
|
+
# Management (IAM) for S3 Express One Zone][3] in the *Amazon S3
|
3813
3880
|
# User Guide*.
|
3814
3881
|
#
|
3815
3882
|
# HTTP Host header syntax
|
3816
3883
|
#
|
3817
3884
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
3818
|
-
# `s3express-control.region.amazonaws.com`.
|
3885
|
+
# `s3express-control.region-code.amazonaws.com`.
|
3819
3886
|
#
|
3820
3887
|
# The following operations are related to `DeleteBucket`:
|
3821
3888
|
#
|
3822
|
-
# * [CreateBucket][
|
3889
|
+
# * [CreateBucket][4]
|
3823
3890
|
#
|
3824
|
-
# * [DeleteObject][
|
3891
|
+
# * [DeleteObject][5]
|
3825
3892
|
#
|
3826
3893
|
#
|
3827
3894
|
#
|
3828
3895
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
3829
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-
|
3830
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3831
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
3896
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
3897
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
3898
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
3899
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
3832
3900
|
#
|
3833
3901
|
# @option params [required, String] :bucket
|
3834
3902
|
# Specifies the bucket being deleted.
|
3835
3903
|
#
|
3836
3904
|
# <b>Directory buckets </b> - When you use this operation with a
|
3837
3905
|
# directory bucket, you must use path-style requests in the format
|
3838
|
-
# `https://s3express-control.
|
3906
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
3839
3907
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
3840
|
-
# names must be unique in the chosen Availability Zone
|
3841
|
-
# must also follow the format `
|
3842
|
-
#
|
3843
|
-
#
|
3844
|
-
#
|
3908
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
3909
|
+
# Zone). Bucket names must also follow the format `
|
3910
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
3911
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
3912
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
3913
|
+
# *Amazon S3 User Guide*
|
3845
3914
|
#
|
3846
3915
|
#
|
3847
3916
|
#
|
@@ -3885,7 +3954,7 @@ module Aws::S3
|
|
3885
3954
|
req.send_request(options)
|
3886
3955
|
end
|
3887
3956
|
|
3888
|
-
# <note markdown="1"> This operation is not supported
|
3957
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
3889
3958
|
#
|
3890
3959
|
# </note>
|
3891
3960
|
#
|
@@ -3951,7 +4020,7 @@ module Aws::S3
|
|
3951
4020
|
req.send_request(options)
|
3952
4021
|
end
|
3953
4022
|
|
3954
|
-
# <note markdown="1"> This operation is not supported
|
4023
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
3955
4024
|
#
|
3956
4025
|
# </note>
|
3957
4026
|
#
|
@@ -4050,7 +4119,7 @@ module Aws::S3
|
|
4050
4119
|
# HTTP Host header syntax
|
4051
4120
|
#
|
4052
4121
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
4053
|
-
# `s3express-control.region.amazonaws.com`.
|
4122
|
+
# `s3express-control.region-code.amazonaws.com`.
|
4054
4123
|
#
|
4055
4124
|
# The following operations are related to `DeleteBucketEncryption`:
|
4056
4125
|
#
|
@@ -4074,13 +4143,14 @@ module Aws::S3
|
|
4074
4143
|
#
|
4075
4144
|
# <b>Directory buckets </b> - When you use this operation with a
|
4076
4145
|
# directory bucket, you must use path-style requests in the format
|
4077
|
-
# `https://s3express-control.
|
4146
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
4078
4147
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
4079
|
-
# names must be unique in the chosen Availability Zone
|
4080
|
-
# must also follow the format `
|
4081
|
-
#
|
4082
|
-
#
|
4083
|
-
#
|
4148
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
4149
|
+
# Zone). Bucket names must also follow the format `
|
4150
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
4151
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4152
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4153
|
+
# *Amazon S3 User Guide*
|
4084
4154
|
#
|
4085
4155
|
#
|
4086
4156
|
#
|
@@ -4115,7 +4185,7 @@ module Aws::S3
|
|
4115
4185
|
req.send_request(options)
|
4116
4186
|
end
|
4117
4187
|
|
4118
|
-
# <note markdown="1"> This operation is not supported
|
4188
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4119
4189
|
#
|
4120
4190
|
# </note>
|
4121
4191
|
#
|
@@ -4182,7 +4252,7 @@ module Aws::S3
|
|
4182
4252
|
req.send_request(options)
|
4183
4253
|
end
|
4184
4254
|
|
4185
|
-
# <note markdown="1"> This operation is not supported
|
4255
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4186
4256
|
#
|
4187
4257
|
# </note>
|
4188
4258
|
#
|
@@ -4247,38 +4317,75 @@ module Aws::S3
|
|
4247
4317
|
req.send_request(options)
|
4248
4318
|
end
|
4249
4319
|
|
4250
|
-
# <note markdown="1"> This operation is not supported by directory buckets.
|
4251
|
-
#
|
4252
|
-
# </note>
|
4253
|
-
#
|
4254
4320
|
# Deletes the lifecycle configuration from the specified bucket. Amazon
|
4255
4321
|
# S3 removes all the lifecycle configuration rules in the lifecycle
|
4256
4322
|
# subresource associated with the bucket. Your objects never expire, and
|
4257
4323
|
# Amazon S3 no longer automatically deletes any objects on the basis of
|
4258
4324
|
# rules contained in the deleted lifecycle configuration.
|
4259
4325
|
#
|
4260
|
-
#
|
4261
|
-
#
|
4262
|
-
#
|
4263
|
-
#
|
4326
|
+
# Permissions
|
4327
|
+
# : * **General purpose bucket permissions** - By default, all Amazon S3
|
4328
|
+
# resources are private, including buckets, objects, and related
|
4329
|
+
# subresources (for example, lifecycle configuration and website
|
4330
|
+
# configuration). Only the resource owner (that is, the Amazon Web
|
4331
|
+
# Services account that created it) can access the resource. The
|
4332
|
+
# resource owner can optionally grant access permissions to others
|
4333
|
+
# by writing an access policy. For this operation, a user must have
|
4334
|
+
# the `s3:PutLifecycleConfiguration` permission.
|
4335
|
+
#
|
4336
|
+
# For more information about permissions, see [Managing Access
|
4337
|
+
# Permissions to Your Amazon S3 Resources][1].
|
4338
|
+
# ^
|
4264
4339
|
#
|
4265
|
-
#
|
4266
|
-
#
|
4340
|
+
# * **Directory bucket permissions** - You must have the
|
4341
|
+
# `s3express:PutLifecycleConfiguration` permission in an IAM
|
4342
|
+
# identity-based policy to use this operation. Cross-account access
|
4343
|
+
# to this API operation isn't supported. The resource owner can
|
4344
|
+
# optionally grant access permissions to others by creating a role
|
4345
|
+
# or user for them as long as they are within the same account as
|
4346
|
+
# the owner and resource.
|
4347
|
+
#
|
4348
|
+
# For more information about directory bucket policies and
|
4349
|
+
# permissions, see [Authorizing Regional endpoint APIs with IAM][2]
|
4350
|
+
# in the *Amazon S3 User Guide*.
|
4351
|
+
#
|
4352
|
+
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
4353
|
+
# requests for this API operation to the Regional endpoint. These
|
4354
|
+
# endpoints support path-style requests in the format
|
4355
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name
|
4356
|
+
# `. Virtual-hosted-style requests aren't supported. For more
|
4357
|
+
# information about endpoints in Availability Zones, see [Regional
|
4358
|
+
# and Zonal endpoints for directory buckets in Availability
|
4359
|
+
# Zones][3] in the *Amazon S3 User Guide*. For more information
|
4360
|
+
# about endpoints in Local Zones, see [Available Local Zone for
|
4361
|
+
# directory buckets][4] in the *Amazon S3 User Guide*.
|
4362
|
+
#
|
4363
|
+
# </note>
|
4364
|
+
# ^
|
4365
|
+
#
|
4366
|
+
# HTTP Host header syntax
|
4367
|
+
#
|
4368
|
+
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
4369
|
+
# `s3express-control.region.amazonaws.com`.
|
4267
4370
|
#
|
4268
4371
|
# For more information about the object expiration, see [Elements to
|
4269
|
-
# Describe Lifecycle Actions][
|
4372
|
+
# Describe Lifecycle Actions][5].
|
4270
4373
|
#
|
4271
4374
|
# Related actions include:
|
4272
4375
|
#
|
4273
|
-
# * [PutBucketLifecycleConfiguration][
|
4376
|
+
# * [PutBucketLifecycleConfiguration][6]
|
4274
4377
|
#
|
4275
|
-
# * [GetBucketLifecycleConfiguration][
|
4378
|
+
# * [GetBucketLifecycleConfiguration][7]
|
4276
4379
|
#
|
4277
4380
|
#
|
4278
4381
|
#
|
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/
|
4382
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
4383
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
4384
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
4385
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
4386
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
|
4387
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
4388
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
4282
4389
|
#
|
4283
4390
|
# @option params [required, String] :bucket
|
4284
4391
|
# The bucket name of the lifecycle to delete.
|
@@ -4288,6 +4395,11 @@ module Aws::S3
|
|
4288
4395
|
# you provide does not match the actual owner of the bucket, the request
|
4289
4396
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
4290
4397
|
#
|
4398
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
4399
|
+
# supported for directory bucket lifecycle configurations.
|
4400
|
+
#
|
4401
|
+
# </note>
|
4402
|
+
#
|
4291
4403
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
4292
4404
|
#
|
4293
4405
|
#
|
@@ -4315,7 +4427,7 @@ module Aws::S3
|
|
4315
4427
|
req.send_request(options)
|
4316
4428
|
end
|
4317
4429
|
|
4318
|
-
# <note markdown="1"> This operation is not supported
|
4430
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4319
4431
|
#
|
4320
4432
|
# </note>
|
4321
4433
|
#
|
@@ -4385,7 +4497,7 @@ module Aws::S3
|
|
4385
4497
|
req.send_request(options)
|
4386
4498
|
end
|
4387
4499
|
|
4388
|
-
# <note markdown="1"> This operation is not supported
|
4500
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4389
4501
|
#
|
4390
4502
|
# </note>
|
4391
4503
|
#
|
@@ -4440,9 +4552,13 @@ module Aws::S3
|
|
4440
4552
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
4441
4553
|
# requests for this API operation to the Regional endpoint. These
|
4442
4554
|
# endpoints support path-style requests in the format
|
4443
|
-
# `https://s3express-control.
|
4444
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
4445
|
-
#
|
4555
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
4556
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
4557
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
4558
|
+
# endpoints for directory buckets in Availability Zones][1] in the
|
4559
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
4560
|
+
# Zones, see [Available Local Zone for directory buckets][2] in the
|
4561
|
+
# *Amazon S3 User Guide*.
|
4446
4562
|
#
|
4447
4563
|
# </note>
|
4448
4564
|
#
|
@@ -4472,7 +4588,7 @@ module Aws::S3
|
|
4472
4588
|
# * **General purpose bucket permissions** - The
|
4473
4589
|
# `s3:DeleteBucketPolicy` permission is required in a policy. For
|
4474
4590
|
# more information about general purpose buckets bucket policies,
|
4475
|
-
# see [Using Bucket Policies and User Policies][
|
4591
|
+
# see [Using Bucket Policies and User Policies][3] in the *Amazon S3
|
4476
4592
|
# User Guide*.
|
4477
4593
|
#
|
4478
4594
|
# * **Directory bucket permissions** - To grant access to this API
|
@@ -4483,39 +4599,41 @@ module Aws::S3
|
|
4483
4599
|
# Services account that owns the resource. For more information
|
4484
4600
|
# about directory bucket policies and permissions, see [Amazon Web
|
4485
4601
|
# Services Identity and Access Management (IAM) for S3 Express One
|
4486
|
-
# Zone][
|
4602
|
+
# Zone][4] in the *Amazon S3 User Guide*.
|
4487
4603
|
#
|
4488
4604
|
# HTTP Host header syntax
|
4489
4605
|
#
|
4490
4606
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
4491
|
-
# `s3express-control.region.amazonaws.com`.
|
4607
|
+
# `s3express-control.region-code.amazonaws.com`.
|
4492
4608
|
#
|
4493
4609
|
# The following operations are related to `DeleteBucketPolicy`
|
4494
4610
|
#
|
4495
|
-
# * [CreateBucket][
|
4611
|
+
# * [CreateBucket][5]
|
4496
4612
|
#
|
4497
|
-
# * [DeleteObject][
|
4613
|
+
# * [DeleteObject][6]
|
4498
4614
|
#
|
4499
4615
|
#
|
4500
4616
|
#
|
4501
4617
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
4502
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4503
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4504
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4505
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
4618
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
4619
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
4620
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
4621
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
4622
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
4506
4623
|
#
|
4507
4624
|
# @option params [required, String] :bucket
|
4508
4625
|
# The bucket name.
|
4509
4626
|
#
|
4510
4627
|
# <b>Directory buckets </b> - When you use this operation with a
|
4511
4628
|
# directory bucket, you must use path-style requests in the format
|
4512
|
-
# `https://s3express-control.
|
4629
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
4513
4630
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
4514
|
-
# names must be unique in the chosen Availability Zone
|
4515
|
-
# must also follow the format `
|
4516
|
-
#
|
4517
|
-
#
|
4518
|
-
#
|
4631
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
4632
|
+
# Zone). Bucket names must also follow the format `
|
4633
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
4634
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4635
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4636
|
+
# *Amazon S3 User Guide*
|
4519
4637
|
#
|
4520
4638
|
#
|
4521
4639
|
#
|
@@ -4559,7 +4677,7 @@ module Aws::S3
|
|
4559
4677
|
req.send_request(options)
|
4560
4678
|
end
|
4561
4679
|
|
4562
|
-
# <note markdown="1"> This operation is not supported
|
4680
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4563
4681
|
#
|
4564
4682
|
# </note>
|
4565
4683
|
#
|
@@ -4629,7 +4747,7 @@ module Aws::S3
|
|
4629
4747
|
req.send_request(options)
|
4630
4748
|
end
|
4631
4749
|
|
4632
|
-
# <note markdown="1"> This operation is not supported
|
4750
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4633
4751
|
#
|
4634
4752
|
# </note>
|
4635
4753
|
#
|
@@ -4685,7 +4803,7 @@ module Aws::S3
|
|
4685
4803
|
req.send_request(options)
|
4686
4804
|
end
|
4687
4805
|
|
4688
|
-
# <note markdown="1"> This operation is not supported
|
4806
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4689
4807
|
#
|
4690
4808
|
# </note>
|
4691
4809
|
#
|
@@ -4754,33 +4872,71 @@ module Aws::S3
|
|
4754
4872
|
end
|
4755
4873
|
|
4756
4874
|
# Removes an object from a bucket. The behavior depends on the bucket's
|
4757
|
-
# versioning state
|
4758
|
-
#
|
4875
|
+
# versioning state:
|
4876
|
+
#
|
4877
|
+
# * If bucket versioning is not enabled, the operation permanently
|
4878
|
+
# deletes the object.
|
4879
|
+
#
|
4880
|
+
# * If bucket versioning is enabled, the operation inserts a delete
|
4881
|
+
# marker, which becomes the current version of the object. To
|
4882
|
+
# permanently delete an object in a versioned bucket, you must include
|
4883
|
+
# the object’s `versionId` in the request. For more information about
|
4884
|
+
# versioning-enabled buckets, see [Deleting object versions from a
|
4885
|
+
# versioning-enabled bucket][1].
|
4886
|
+
#
|
4887
|
+
# * If bucket versioning is suspended, the operation removes the object
|
4888
|
+
# that has a null `versionId`, if there is one, and inserts a delete
|
4889
|
+
# marker that becomes the current version of the object. If there
|
4890
|
+
# isn't an object with a null `versionId`, and all versions of the
|
4891
|
+
# object have a `versionId`, Amazon S3 does not remove the object and
|
4892
|
+
# only inserts a delete marker. To permanently delete an object that
|
4893
|
+
# has a `versionId`, you must include the object’s `versionId` in the
|
4894
|
+
# request. For more information about versioning-suspended buckets,
|
4895
|
+
# see [Deleting objects from versioning-suspended buckets][2].
|
4896
|
+
#
|
4897
|
+
# <note markdown="1"> * **Directory buckets** - S3 Versioning isn't enabled and supported
|
4898
|
+
# for directory buckets. For this API operation, only the `null` value
|
4899
|
+
# of the version ID is supported by directory buckets. You can only
|
4900
|
+
# specify `null` to the `versionId` query parameter in the request.
|
4901
|
+
#
|
4902
|
+
# * **Directory buckets** - For directory buckets, you must make
|
4903
|
+
# requests for this API operation to the Zonal endpoint. These
|
4904
|
+
# endpoints support virtual-hosted-style requests in the format
|
4905
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
4906
|
+
# `. Path-style requests are not supported. For more information about
|
4907
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
4908
|
+
# for directory buckets in Availability Zones][3] in the *Amazon S3
|
4909
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
4910
|
+
# see [Available Local Zone for directory buckets][4] in the *Amazon
|
4911
|
+
# S3 User Guide*.
|
4912
|
+
#
|
4913
|
+
# </note>
|
4759
4914
|
#
|
4760
4915
|
# To remove a specific version, you must use the `versionId` query
|
4761
4916
|
# parameter. Using this query parameter permanently deletes the version.
|
4762
4917
|
# If the object deleted is a delete marker, Amazon S3 sets the response
|
4763
|
-
# header `x-amz-delete-marker` to true.
|
4764
|
-
# is in a bucket where the bucket versioning configuration is MFA delete
|
4765
|
-
# enabled, you must include the `x-amz-mfa` request header in the DELETE
|
4766
|
-
# `versionId` request. Requests that include `x-amz-mfa` must use HTTPS.
|
4767
|
-
# For more information about MFA delete and to see example requests, see
|
4768
|
-
# [Using MFA delete][2] and [Sample request][3] in the *Amazon S3 User
|
4769
|
-
# Guide*.
|
4918
|
+
# header `x-amz-delete-marker` to true.
|
4770
4919
|
#
|
4771
|
-
#
|
4772
|
-
#
|
4773
|
-
#
|
4774
|
-
#
|
4920
|
+
# If the object you want to delete is in a bucket where the bucket
|
4921
|
+
# versioning configuration is MFA Delete enabled, you must include the
|
4922
|
+
# `x-amz-mfa` request header in the DELETE `versionId` request. Requests
|
4923
|
+
# that include `x-amz-mfa` must use HTTPS. For more information about
|
4924
|
+
# MFA Delete, see [Using MFA Delete][5] in the *Amazon S3 User Guide*.
|
4925
|
+
# To see sample requests that use versioning, see [Sample Request][6].
|
4775
4926
|
#
|
4776
|
-
#
|
4777
|
-
#
|
4778
|
-
#
|
4779
|
-
#
|
4780
|
-
#
|
4781
|
-
#
|
4927
|
+
# <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
|
4928
|
+
# buckets.
|
4929
|
+
#
|
4930
|
+
# </note>
|
4931
|
+
#
|
4932
|
+
# You can delete objects by explicitly calling DELETE Object or calling
|
4933
|
+
# ([PutBucketLifecycle][7]) to enable Amazon S3 to remove them for you.
|
4934
|
+
# If you want to block users or accounts from removing or deleting
|
4935
|
+
# objects from your bucket, you must deny them the `s3:DeleteObject`,
|
4936
|
+
# `s3:DeleteObjectVersion`, and `s3:PutLifeCycleConfiguration` actions.
|
4782
4937
|
#
|
4783
|
-
#
|
4938
|
+
# <note markdown="1"> **Directory buckets** - S3 Lifecycle is not supported by directory
|
4939
|
+
# buckets.
|
4784
4940
|
#
|
4785
4941
|
# </note>
|
4786
4942
|
#
|
@@ -4792,52 +4948,56 @@ module Aws::S3
|
|
4792
4948
|
# * <b> <code>s3:DeleteObject</code> </b> - To delete an object from
|
4793
4949
|
# a bucket, you must always have the `s3:DeleteObject` permission.
|
4794
4950
|
#
|
4795
|
-
# <note markdown="1"> You can also use PutBucketLifecycle to delete objects in Amazon
|
4796
|
-
# S3.
|
4797
|
-
#
|
4798
|
-
# </note>
|
4799
|
-
#
|
4800
4951
|
# * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
|
4801
4952
|
# specific version of an object from a versioning-enabled bucket,
|
4802
4953
|
# you must have the `s3:DeleteObjectVersion` permission.
|
4803
|
-
#
|
4804
|
-
#
|
4805
|
-
#
|
4806
|
-
#
|
4807
|
-
#
|
4808
|
-
#
|
4809
|
-
#
|
4810
|
-
#
|
4811
|
-
#
|
4954
|
+
# * **Directory bucket permissions** - To grant access to this API
|
4955
|
+
# operation on a directory bucket, we recommend that you use the [
|
4956
|
+
# `CreateSession` ][8] API operation for session-based
|
4957
|
+
# authorization. Specifically, you grant the
|
4958
|
+
# `s3express:CreateSession` permission to the directory bucket in a
|
4959
|
+
# bucket policy or an IAM identity-based policy. Then, you make the
|
4960
|
+
# `CreateSession` API call on the bucket to obtain a session token.
|
4961
|
+
# With the session token in your request header, you can make API
|
4962
|
+
# requests to this operation. After the session token expires, you
|
4963
|
+
# make another `CreateSession` API call to generate a new session
|
4964
|
+
# token for use. Amazon Web Services CLI or SDKs create session and
|
4965
|
+
# refresh the session token automatically to avoid service
|
4966
|
+
# interruptions when a session expires. For more information about
|
4967
|
+
# authorization, see [ `CreateSession` ][8].
|
4812
4968
|
#
|
4813
4969
|
# HTTP Host header syntax
|
4814
4970
|
#
|
4815
4971
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
4816
|
-
#
|
4972
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
4817
4973
|
#
|
4818
4974
|
# The following action is related to `DeleteObject`:
|
4819
4975
|
#
|
4820
|
-
# * [PutObject][
|
4976
|
+
# * [PutObject][9]
|
4821
4977
|
#
|
4822
4978
|
# ^
|
4823
4979
|
#
|
4824
4980
|
#
|
4825
4981
|
#
|
4826
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
4827
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4828
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4829
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-
|
4830
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4982
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
|
4983
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectsfromVersioningSuspendedBuckets.html
|
4984
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
4985
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
4986
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
|
4987
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
|
4988
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
4989
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
4990
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
4831
4991
|
#
|
4832
4992
|
# @option params [required, String] :bucket
|
4833
4993
|
# The bucket name of the bucket containing the object.
|
4834
4994
|
#
|
4835
4995
|
# **Directory buckets** - When you use this operation with a directory
|
4836
4996
|
# bucket, you must use virtual-hosted-style requests in the format `
|
4837
|
-
#
|
4838
|
-
# are not supported. Directory bucket names must be unique in
|
4839
|
-
# Availability Zone. Bucket names must
|
4840
|
-
#
|
4997
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
4998
|
+
# requests are not supported. Directory bucket names must be unique in
|
4999
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
5000
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
4841
5001
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4842
5002
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4843
5003
|
# *Amazon S3 User Guide*.
|
@@ -4925,6 +5085,49 @@ module Aws::S3
|
|
4925
5085
|
# you provide does not match the actual owner of the bucket, the request
|
4926
5086
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
4927
5087
|
#
|
5088
|
+
# @option params [String] :if_match
|
5089
|
+
# The `If-Match` header field makes the request method conditional on
|
5090
|
+
# ETags. If the ETag value does not match, the operation returns a `412
|
5091
|
+
# Precondition Failed` error. If the ETag matches or if the object
|
5092
|
+
# doesn't exist, the operation will return a `204 Success (No Content)
|
5093
|
+
# response`.
|
5094
|
+
#
|
5095
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
5096
|
+
#
|
5097
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
5098
|
+
#
|
5099
|
+
# </note>
|
5100
|
+
#
|
5101
|
+
#
|
5102
|
+
#
|
5103
|
+
# [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
|
5104
|
+
#
|
5105
|
+
# @option params [Time,DateTime,Date,Integer,String] :if_match_last_modified_time
|
5106
|
+
# If present, the object is deleted only if its modification times
|
5107
|
+
# matches the provided `Timestamp`. If the `Timestamp` values do not
|
5108
|
+
# match, the operation returns a `412 Precondition Failed` error. If the
|
5109
|
+
# `Timestamp` matches or if the object doesn’t exist, the operation
|
5110
|
+
# returns a `204 Success (No Content)` response.
|
5111
|
+
#
|
5112
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
5113
|
+
#
|
5114
|
+
# </note>
|
5115
|
+
#
|
5116
|
+
# @option params [Integer] :if_match_size
|
5117
|
+
# If present, the object is deleted only if its size matches the
|
5118
|
+
# provided size in bytes. If the `Size` value does not match, the
|
5119
|
+
# operation returns a `412 Precondition Failed` error. If the `Size`
|
5120
|
+
# matches or if the object doesn’t exist, the operation returns a `204
|
5121
|
+
# Success (No Content)` response.
|
5122
|
+
#
|
5123
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
5124
|
+
#
|
5125
|
+
# </note>
|
5126
|
+
#
|
5127
|
+
# You can use the `If-Match`, `x-amz-if-match-last-modified-time` and
|
5128
|
+
# `x-amz-if-match-size` conditional headers in conjunction with
|
5129
|
+
# each-other or individually.
|
5130
|
+
#
|
4928
5131
|
# @return [Types::DeleteObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4929
5132
|
#
|
4930
5133
|
# * {Types::DeleteObjectOutput#delete_marker #delete_marker} => Boolean
|
@@ -4932,15 +5135,6 @@ module Aws::S3
|
|
4932
5135
|
# * {Types::DeleteObjectOutput#request_charged #request_charged} => String
|
4933
5136
|
#
|
4934
5137
|
#
|
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
5138
|
# @example Example: To delete an object
|
4945
5139
|
#
|
4946
5140
|
# # The following example deletes an object from an S3 bucket.
|
@@ -4954,6 +5148,15 @@ module Aws::S3
|
|
4954
5148
|
# {
|
4955
5149
|
# }
|
4956
5150
|
#
|
5151
|
+
# @example Example: To delete an object (from a non-versioned bucket)
|
5152
|
+
#
|
5153
|
+
# # The following example deletes an object from a non-versioned bucket.
|
5154
|
+
#
|
5155
|
+
# resp = client.delete_object({
|
5156
|
+
# bucket: "ExampleBucket",
|
5157
|
+
# key: "HappyFace.jpg",
|
5158
|
+
# })
|
5159
|
+
#
|
4957
5160
|
# @example Request syntax with placeholder values
|
4958
5161
|
#
|
4959
5162
|
# resp = client.delete_object({
|
@@ -4964,6 +5167,9 @@ module Aws::S3
|
|
4964
5167
|
# request_payer: "requester", # accepts requester
|
4965
5168
|
# bypass_governance_retention: false,
|
4966
5169
|
# expected_bucket_owner: "AccountId",
|
5170
|
+
# if_match: "IfMatch",
|
5171
|
+
# if_match_last_modified_time: Time.now,
|
5172
|
+
# if_match_size: 1,
|
4967
5173
|
# })
|
4968
5174
|
#
|
4969
5175
|
# @example Response structure
|
@@ -4981,7 +5187,7 @@ module Aws::S3
|
|
4981
5187
|
req.send_request(options)
|
4982
5188
|
end
|
4983
5189
|
|
4984
|
-
# <note markdown="1"> This operation is not supported
|
5190
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
4985
5191
|
#
|
4986
5192
|
# </note>
|
4987
5193
|
#
|
@@ -5124,9 +5330,13 @@ module Aws::S3
|
|
5124
5330
|
# * **Directory buckets** - For directory buckets, you must make
|
5125
5331
|
# requests for this API operation to the Zonal endpoint. These
|
5126
5332
|
# endpoints support virtual-hosted-style requests in the format
|
5127
|
-
# `https://
|
5128
|
-
# `. Path-style requests are not supported. For more information
|
5129
|
-
# [Regional and Zonal endpoints
|
5333
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
5334
|
+
# `. Path-style requests are not supported. For more information about
|
5335
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
5336
|
+
# for directory buckets in Availability Zones][1] in the *Amazon S3
|
5337
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
5338
|
+
# see [Available Local Zone for directory buckets][2] in the *Amazon
|
5339
|
+
# S3 User Guide*.
|
5130
5340
|
#
|
5131
5341
|
# </note>
|
5132
5342
|
#
|
@@ -5144,7 +5354,7 @@ module Aws::S3
|
|
5144
5354
|
# if there are non-versioned objects you are trying to delete. If you
|
5145
5355
|
# provide an invalid token, whether there are versioned keys in the
|
5146
5356
|
# request or not, the entire Multi-Object Delete request will fail. For
|
5147
|
-
# information about MFA Delete, see [MFA Delete][
|
5357
|
+
# information about MFA Delete, see [MFA Delete][3] in the *Amazon S3
|
5148
5358
|
# User Guide*.
|
5149
5359
|
#
|
5150
5360
|
# <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
|
@@ -5164,10 +5374,9 @@ module Aws::S3
|
|
5164
5374
|
# * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
|
5165
5375
|
# specific version of an object from a versioning-enabled bucket,
|
5166
5376
|
# you must specify the `s3:DeleteObjectVersion` permission.
|
5167
|
-
#
|
5168
5377
|
# * **Directory bucket permissions** - To grant access to this API
|
5169
5378
|
# operation on a directory bucket, we recommend that you use the [
|
5170
|
-
# `CreateSession` ][
|
5379
|
+
# `CreateSession` ][4] API operation for session-based
|
5171
5380
|
# authorization. Specifically, you grant the
|
5172
5381
|
# `s3express:CreateSession` permission to the directory bucket in a
|
5173
5382
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -5178,7 +5387,7 @@ module Aws::S3
|
|
5178
5387
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
5179
5388
|
# refresh the session token automatically to avoid service
|
5180
5389
|
# interruptions when a session expires. For more information about
|
5181
|
-
# authorization, see [ `CreateSession` ][
|
5390
|
+
# authorization, see [ `CreateSession` ][4].
|
5182
5391
|
#
|
5183
5392
|
# Content-MD5 request header
|
5184
5393
|
# : * **General purpose bucket** - The Content-MD5 request header is
|
@@ -5195,40 +5404,41 @@ module Aws::S3
|
|
5195
5404
|
# HTTP Host header syntax
|
5196
5405
|
#
|
5197
5406
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
5198
|
-
#
|
5407
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
5199
5408
|
#
|
5200
5409
|
# The following operations are related to `DeleteObjects`:
|
5201
5410
|
#
|
5202
|
-
# * [CreateMultipartUpload][
|
5411
|
+
# * [CreateMultipartUpload][5]
|
5203
5412
|
#
|
5204
|
-
# * [UploadPart][
|
5413
|
+
# * [UploadPart][6]
|
5205
5414
|
#
|
5206
|
-
# * [CompleteMultipartUpload][
|
5415
|
+
# * [CompleteMultipartUpload][7]
|
5207
5416
|
#
|
5208
|
-
# * [ListParts][
|
5417
|
+
# * [ListParts][8]
|
5209
5418
|
#
|
5210
|
-
# * [AbortMultipartUpload][
|
5419
|
+
# * [AbortMultipartUpload][9]
|
5211
5420
|
#
|
5212
5421
|
#
|
5213
5422
|
#
|
5214
5423
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
5215
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
5216
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
5217
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
5218
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
5219
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
5220
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
5221
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
5424
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
5425
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
|
5426
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
5427
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
5428
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
5429
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
5430
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
5431
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
5222
5432
|
#
|
5223
5433
|
# @option params [required, String] :bucket
|
5224
5434
|
# The bucket name containing the objects to delete.
|
5225
5435
|
#
|
5226
5436
|
# **Directory buckets** - When you use this operation with a directory
|
5227
5437
|
# bucket, you must use virtual-hosted-style requests in the format `
|
5228
|
-
#
|
5229
|
-
# are not supported. Directory bucket names must be unique in
|
5230
|
-
# Availability Zone. Bucket names must
|
5231
|
-
#
|
5438
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
5439
|
+
# requests are not supported. Directory bucket names must be unique in
|
5440
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
5441
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
5232
5442
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
5233
5443
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
5234
5444
|
# *Amazon S3 User Guide*.
|
@@ -5444,6 +5654,9 @@ module Aws::S3
|
|
5444
5654
|
# {
|
5445
5655
|
# key: "ObjectKey", # required
|
5446
5656
|
# version_id: "ObjectVersionId",
|
5657
|
+
# etag: "ETag",
|
5658
|
+
# last_modified_time: Time.now,
|
5659
|
+
# size: 1,
|
5447
5660
|
# },
|
5448
5661
|
# ],
|
5449
5662
|
# quiet: false,
|
@@ -5478,7 +5691,7 @@ module Aws::S3
|
|
5478
5691
|
req.send_request(options)
|
5479
5692
|
end
|
5480
5693
|
|
5481
|
-
# <note markdown="1"> This operation is not supported
|
5694
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5482
5695
|
#
|
5483
5696
|
# </note>
|
5484
5697
|
#
|
@@ -5535,7 +5748,7 @@ module Aws::S3
|
|
5535
5748
|
req.send_request(options)
|
5536
5749
|
end
|
5537
5750
|
|
5538
|
-
# <note markdown="1"> This operation is not supported
|
5751
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5539
5752
|
#
|
5540
5753
|
# </note>
|
5541
5754
|
#
|
@@ -5631,7 +5844,7 @@ module Aws::S3
|
|
5631
5844
|
req.send_request(options)
|
5632
5845
|
end
|
5633
5846
|
|
5634
|
-
# <note markdown="1"> This operation is not supported
|
5847
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5635
5848
|
#
|
5636
5849
|
# </note>
|
5637
5850
|
#
|
@@ -5727,7 +5940,7 @@ module Aws::S3
|
|
5727
5940
|
req.send_request(options)
|
5728
5941
|
end
|
5729
5942
|
|
5730
|
-
# <note markdown="1"> This operation is not supported
|
5943
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5731
5944
|
#
|
5732
5945
|
# </note>
|
5733
5946
|
#
|
@@ -5813,7 +6026,7 @@ module Aws::S3
|
|
5813
6026
|
req.send_request(options)
|
5814
6027
|
end
|
5815
6028
|
|
5816
|
-
# <note markdown="1"> This operation is not supported
|
6029
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
5817
6030
|
#
|
5818
6031
|
# </note>
|
5819
6032
|
#
|
@@ -5972,7 +6185,7 @@ module Aws::S3
|
|
5972
6185
|
# HTTP Host header syntax
|
5973
6186
|
#
|
5974
6187
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
5975
|
-
# `s3express-control.region.amazonaws.com`.
|
6188
|
+
# `s3express-control.region-code.amazonaws.com`.
|
5976
6189
|
#
|
5977
6190
|
# The following operations are related to `GetBucketEncryption`:
|
5978
6191
|
#
|
@@ -5996,13 +6209,14 @@ module Aws::S3
|
|
5996
6209
|
#
|
5997
6210
|
# <b>Directory buckets </b> - When you use this operation with a
|
5998
6211
|
# directory bucket, you must use path-style requests in the format
|
5999
|
-
# `https://s3express-control.
|
6212
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
6000
6213
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
6001
|
-
# names must be unique in the chosen Availability Zone
|
6002
|
-
# must also follow the format `
|
6003
|
-
#
|
6004
|
-
#
|
6005
|
-
#
|
6214
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
6215
|
+
# Zone). Bucket names must also follow the format `
|
6216
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
6217
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
6218
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
6219
|
+
# *Amazon S3 User Guide*
|
6006
6220
|
#
|
6007
6221
|
#
|
6008
6222
|
#
|
@@ -6046,7 +6260,7 @@ module Aws::S3
|
|
6046
6260
|
req.send_request(options)
|
6047
6261
|
end
|
6048
6262
|
|
6049
|
-
# <note markdown="1"> This operation is not supported
|
6263
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6050
6264
|
#
|
6051
6265
|
# </note>
|
6052
6266
|
#
|
@@ -6130,7 +6344,7 @@ module Aws::S3
|
|
6130
6344
|
req.send_request(options)
|
6131
6345
|
end
|
6132
6346
|
|
6133
|
-
# <note markdown="1"> This operation is not supported
|
6347
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6134
6348
|
#
|
6135
6349
|
# </note>
|
6136
6350
|
#
|
@@ -6219,7 +6433,7 @@ module Aws::S3
|
|
6219
6433
|
# version of this topic. This topic is provided for backward
|
6220
6434
|
# compatibility.
|
6221
6435
|
#
|
6222
|
-
# <note markdown="1"> This operation is not supported
|
6436
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6223
6437
|
#
|
6224
6438
|
# </note>
|
6225
6439
|
#
|
@@ -6331,34 +6545,68 @@ module Aws::S3
|
|
6331
6545
|
req.send_request(options)
|
6332
6546
|
end
|
6333
6547
|
|
6334
|
-
#
|
6335
|
-
#
|
6336
|
-
#
|
6548
|
+
# Returns the lifecycle configuration information set on the bucket. For
|
6549
|
+
# information about lifecycle configuration, see [Object Lifecycle
|
6550
|
+
# Management][1].
|
6337
6551
|
#
|
6338
|
-
#
|
6552
|
+
# Bucket lifecycle configuration now supports specifying a lifecycle
|
6339
6553
|
# rule using an object key name prefix, one or more object tags, object
|
6340
6554
|
# size, or any combination of these. Accordingly, this section describes
|
6341
|
-
# the latest API
|
6342
|
-
#
|
6343
|
-
#
|
6344
|
-
#
|
6345
|
-
#
|
6346
|
-
#
|
6347
|
-
#
|
6348
|
-
#
|
6555
|
+
# the latest API, which is compatible with the new functionality. The
|
6556
|
+
# previous version of the API supported filtering based only on an
|
6557
|
+
# object key name prefix, which is supported for general purpose buckets
|
6558
|
+
# for backward compatibility. For the related API description, see
|
6559
|
+
# [GetBucketLifecycle][2].
|
6560
|
+
#
|
6561
|
+
# <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
|
6562
|
+
# objects and cancelling multipart uploads. Expiring of versioned
|
6563
|
+
# objects, transitions and tag filters are not supported.
|
6349
6564
|
#
|
6350
6565
|
# </note>
|
6351
6566
|
#
|
6352
|
-
#
|
6353
|
-
#
|
6354
|
-
#
|
6567
|
+
# Permissions
|
6568
|
+
# : * **General purpose bucket permissions** - By default, all Amazon S3
|
6569
|
+
# resources are private, including buckets, objects, and related
|
6570
|
+
# subresources (for example, lifecycle configuration and website
|
6571
|
+
# configuration). Only the resource owner (that is, the Amazon Web
|
6572
|
+
# Services account that created it) can access the resource. The
|
6573
|
+
# resource owner can optionally grant access permissions to others
|
6574
|
+
# by writing an access policy. For this operation, a user must have
|
6575
|
+
# the `s3:GetLifecycleConfiguration` permission.
|
6576
|
+
#
|
6577
|
+
# For more information about permissions, see [Managing Access
|
6578
|
+
# Permissions to Your Amazon S3 Resources][3].
|
6579
|
+
# ^
|
6355
6580
|
#
|
6356
|
-
#
|
6357
|
-
#
|
6358
|
-
#
|
6359
|
-
#
|
6360
|
-
#
|
6361
|
-
#
|
6581
|
+
# * **Directory bucket permissions** - You must have the
|
6582
|
+
# `s3express:GetLifecycleConfiguration` permission in an IAM
|
6583
|
+
# identity-based policy to use this operation. Cross-account access
|
6584
|
+
# to this API operation isn't supported. The resource owner can
|
6585
|
+
# optionally grant access permissions to others by creating a role
|
6586
|
+
# or user for them as long as they are within the same account as
|
6587
|
+
# the owner and resource.
|
6588
|
+
#
|
6589
|
+
# For more information about directory bucket policies and
|
6590
|
+
# permissions, see [Authorizing Regional endpoint APIs with IAM][4]
|
6591
|
+
# in the *Amazon S3 User Guide*.
|
6592
|
+
#
|
6593
|
+
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
6594
|
+
# requests for this API operation to the Regional endpoint. These
|
6595
|
+
# endpoints support path-style requests in the format
|
6596
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name
|
6597
|
+
# `. Virtual-hosted-style requests aren't supported. For more
|
6598
|
+
# information about endpoints in Availability Zones, see [Regional
|
6599
|
+
# and Zonal endpoints for directory buckets in Availability
|
6600
|
+
# Zones][5] in the *Amazon S3 User Guide*. For more information
|
6601
|
+
# about endpoints in Local Zones, see [Available Local Zone for
|
6602
|
+
# directory buckets][6] in the *Amazon S3 User Guide*.
|
6603
|
+
#
|
6604
|
+
# </note>
|
6605
|
+
#
|
6606
|
+
# HTTP Host header syntax
|
6607
|
+
#
|
6608
|
+
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
6609
|
+
# `s3express-control.region.amazonaws.com`.
|
6362
6610
|
#
|
6363
6611
|
# `GetBucketLifecycleConfiguration` has the following special error:
|
6364
6612
|
#
|
@@ -6373,20 +6621,22 @@ module Aws::S3
|
|
6373
6621
|
# The following operations are related to
|
6374
6622
|
# `GetBucketLifecycleConfiguration`:
|
6375
6623
|
#
|
6376
|
-
# * [GetBucketLifecycle][
|
6624
|
+
# * [GetBucketLifecycle][2]
|
6377
6625
|
#
|
6378
|
-
# * [PutBucketLifecycle][
|
6626
|
+
# * [PutBucketLifecycle][7]
|
6379
6627
|
#
|
6380
|
-
# * [DeleteBucketLifecycle][
|
6628
|
+
# * [DeleteBucketLifecycle][8]
|
6381
6629
|
#
|
6382
6630
|
#
|
6383
6631
|
#
|
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/
|
6632
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
6633
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
|
6634
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
6635
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
6636
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
6637
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
6638
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
6639
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
6390
6640
|
#
|
6391
6641
|
# @option params [required, String] :bucket
|
6392
6642
|
# The name of the bucket for which to get the lifecycle information.
|
@@ -6396,6 +6646,11 @@ module Aws::S3
|
|
6396
6646
|
# you provide does not match the actual owner of the bucket, the request
|
6397
6647
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
6398
6648
|
#
|
6649
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
6650
|
+
# supported for directory bucket lifecycle configurations.
|
6651
|
+
#
|
6652
|
+
# </note>
|
6653
|
+
#
|
6399
6654
|
# @return [Types::GetBucketLifecycleConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
6400
6655
|
#
|
6401
6656
|
# * {Types::GetBucketLifecycleConfigurationOutput#rules #rules} => Array<Types::LifecycleRule>
|
@@ -6476,7 +6731,7 @@ module Aws::S3
|
|
6476
6731
|
req.send_request(options)
|
6477
6732
|
end
|
6478
6733
|
|
6479
|
-
# <note markdown="1"> This operation is not supported
|
6734
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6480
6735
|
#
|
6481
6736
|
# </note>
|
6482
6737
|
#
|
@@ -6573,7 +6828,7 @@ module Aws::S3
|
|
6573
6828
|
req.send_request(options)
|
6574
6829
|
end
|
6575
6830
|
|
6576
|
-
# <note markdown="1"> This operation is not supported
|
6831
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6577
6832
|
#
|
6578
6833
|
# </note>
|
6579
6834
|
#
|
@@ -6632,7 +6887,7 @@ module Aws::S3
|
|
6632
6887
|
req.send_request(options)
|
6633
6888
|
end
|
6634
6889
|
|
6635
|
-
# <note markdown="1"> This operation is not supported
|
6890
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6636
6891
|
#
|
6637
6892
|
# </note>
|
6638
6893
|
#
|
@@ -6718,7 +6973,7 @@ module Aws::S3
|
|
6718
6973
|
req.send_request(options)
|
6719
6974
|
end
|
6720
6975
|
|
6721
|
-
# <note markdown="1"> This operation is not supported
|
6976
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6722
6977
|
#
|
6723
6978
|
# </note>
|
6724
6979
|
#
|
@@ -6849,7 +7104,7 @@ module Aws::S3
|
|
6849
7104
|
req.send_request(options)
|
6850
7105
|
end
|
6851
7106
|
|
6852
|
-
# <note markdown="1"> This operation is not supported
|
7107
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6853
7108
|
#
|
6854
7109
|
# </note>
|
6855
7110
|
#
|
@@ -6964,7 +7219,7 @@ module Aws::S3
|
|
6964
7219
|
req.send_request(options)
|
6965
7220
|
end
|
6966
7221
|
|
6967
|
-
# <note markdown="1"> This operation is not supported
|
7222
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
6968
7223
|
#
|
6969
7224
|
# </note>
|
6970
7225
|
#
|
@@ -7026,9 +7281,13 @@ module Aws::S3
|
|
7026
7281
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
7027
7282
|
# requests for this API operation to the Regional endpoint. These
|
7028
7283
|
# endpoints support path-style requests in the format
|
7029
|
-
# `https://s3express-control.
|
7030
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
7031
|
-
#
|
7284
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
7285
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
7286
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
7287
|
+
# endpoints for directory buckets in Availability Zones][1] in the
|
7288
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
7289
|
+
# Zones, see [Available Local Zone for directory buckets][2] in the
|
7290
|
+
# *Amazon S3 User Guide*.
|
7032
7291
|
#
|
7033
7292
|
# </note>
|
7034
7293
|
#
|
@@ -7058,7 +7317,7 @@ module Aws::S3
|
|
7058
7317
|
# * **General purpose bucket permissions** - The `s3:GetBucketPolicy`
|
7059
7318
|
# permission is required in a policy. For more information about
|
7060
7319
|
# general purpose buckets bucket policies, see [Using Bucket
|
7061
|
-
# Policies and User Policies][
|
7320
|
+
# Policies and User Policies][3] in the *Amazon S3 User Guide*.
|
7062
7321
|
#
|
7063
7322
|
# * **Directory bucket permissions** - To grant access to this API
|
7064
7323
|
# operation, you must have the `s3express:GetBucketPolicy`
|
@@ -7068,48 +7327,50 @@ module Aws::S3
|
|
7068
7327
|
# Services account that owns the resource. For more information
|
7069
7328
|
# about directory bucket policies and permissions, see [Amazon Web
|
7070
7329
|
# Services Identity and Access Management (IAM) for S3 Express One
|
7071
|
-
# Zone][
|
7330
|
+
# Zone][4] in the *Amazon S3 User Guide*.
|
7072
7331
|
#
|
7073
7332
|
# Example bucket policies
|
7074
7333
|
#
|
7075
7334
|
# : **General purpose buckets example bucket policies** - See [Bucket
|
7076
|
-
# policy examples][
|
7335
|
+
# policy examples][5] in the *Amazon S3 User Guide*.
|
7077
7336
|
#
|
7078
7337
|
# **Directory bucket example bucket policies** - See [Example bucket
|
7079
|
-
# policies for S3 Express One Zone][
|
7338
|
+
# policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
|
7080
7339
|
#
|
7081
7340
|
# HTTP Host header syntax
|
7082
7341
|
#
|
7083
7342
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
7084
|
-
# `s3express-control.region.amazonaws.com`.
|
7343
|
+
# `s3express-control.region-code.amazonaws.com`.
|
7085
7344
|
#
|
7086
7345
|
# The following action is related to `GetBucketPolicy`:
|
7087
7346
|
#
|
7088
|
-
# * [GetObject][
|
7347
|
+
# * [GetObject][7]
|
7089
7348
|
#
|
7090
7349
|
# ^
|
7091
7350
|
#
|
7092
7351
|
#
|
7093
7352
|
#
|
7094
7353
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
7095
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7096
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7097
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
7098
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
7099
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7354
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
7355
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
7356
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
7357
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
|
7358
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
7359
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
7100
7360
|
#
|
7101
7361
|
# @option params [required, String] :bucket
|
7102
7362
|
# The bucket name to get the bucket policy for.
|
7103
7363
|
#
|
7104
7364
|
# <b>Directory buckets </b> - When you use this operation with a
|
7105
7365
|
# directory bucket, you must use path-style requests in the format
|
7106
|
-
# `https://s3express-control.
|
7366
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
7107
7367
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
7108
|
-
# names must be unique in the chosen Availability Zone
|
7109
|
-
# must also follow the format `
|
7110
|
-
#
|
7111
|
-
#
|
7112
|
-
#
|
7368
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
7369
|
+
# Zone). Bucket names must also follow the format `
|
7370
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
7371
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
7372
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
7373
|
+
# *Amazon S3 User Guide*
|
7113
7374
|
#
|
7114
7375
|
# **Access points** - When you use this API operation with an access
|
7115
7376
|
# point, provide the alias of the access point in place of the bucket
|
@@ -7181,7 +7442,7 @@ module Aws::S3
|
|
7181
7442
|
req.send_request(options, &block)
|
7182
7443
|
end
|
7183
7444
|
|
7184
|
-
# <note markdown="1"> This operation is not supported
|
7445
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7185
7446
|
#
|
7186
7447
|
# </note>
|
7187
7448
|
#
|
@@ -7246,7 +7507,7 @@ module Aws::S3
|
|
7246
7507
|
req.send_request(options)
|
7247
7508
|
end
|
7248
7509
|
|
7249
|
-
# <note markdown="1"> This operation is not supported
|
7510
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7250
7511
|
#
|
7251
7512
|
# </note>
|
7252
7513
|
#
|
@@ -7369,7 +7630,7 @@ module Aws::S3
|
|
7369
7630
|
req.send_request(options)
|
7370
7631
|
end
|
7371
7632
|
|
7372
|
-
# <note markdown="1"> This operation is not supported
|
7633
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7373
7634
|
#
|
7374
7635
|
# </note>
|
7375
7636
|
#
|
@@ -7435,7 +7696,7 @@ module Aws::S3
|
|
7435
7696
|
req.send_request(options)
|
7436
7697
|
end
|
7437
7698
|
|
7438
|
-
# <note markdown="1"> This operation is not supported
|
7699
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7439
7700
|
#
|
7440
7701
|
# </note>
|
7441
7702
|
#
|
@@ -7521,7 +7782,7 @@ module Aws::S3
|
|
7521
7782
|
req.send_request(options)
|
7522
7783
|
end
|
7523
7784
|
|
7524
|
-
# <note markdown="1"> This operation is not supported
|
7785
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7525
7786
|
#
|
7526
7787
|
# </note>
|
7527
7788
|
#
|
@@ -7598,7 +7859,7 @@ module Aws::S3
|
|
7598
7859
|
req.send_request(options)
|
7599
7860
|
end
|
7600
7861
|
|
7601
|
-
# <note markdown="1"> This operation is not supported
|
7862
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
7602
7863
|
#
|
7603
7864
|
# </note>
|
7604
7865
|
#
|
@@ -7712,9 +7973,13 @@ module Aws::S3
|
|
7712
7973
|
# `/photos/2006/February/sample.jpg`. Also, when you make requests to
|
7713
7974
|
# this API operation, your requests are sent to the Zonal endpoint.
|
7714
7975
|
# These endpoints support virtual-hosted-style requests in the format
|
7715
|
-
# `https://
|
7716
|
-
# Path-style requests are not supported. For more information
|
7717
|
-
# [Regional and Zonal endpoints
|
7976
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
7977
|
+
# `. Path-style requests are not supported. For more information about
|
7978
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
7979
|
+
# directory buckets in Availability Zones][2] in the *Amazon S3 User
|
7980
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
7981
|
+
# [Available Local Zone for directory buckets][3] in the *Amazon S3 User
|
7982
|
+
# Guide*.
|
7718
7983
|
#
|
7719
7984
|
# Permissions
|
7720
7985
|
# : * **General purpose bucket permissions** - You must have the
|
@@ -7722,7 +7987,7 @@ module Aws::S3
|
|
7722
7987
|
# have the `READ` access to the object (or version). If you grant
|
7723
7988
|
# `READ` access to the anonymous user, the `GetObject` operation
|
7724
7989
|
# returns the object without using an authorization header. For more
|
7725
|
-
# information, see [Specifying permissions in a policy][
|
7990
|
+
# information, see [Specifying permissions in a policy][4] in the
|
7726
7991
|
# *Amazon S3 User Guide*.
|
7727
7992
|
#
|
7728
7993
|
# If you include a `versionId` in your request header, you must have
|
@@ -7744,10 +8009,9 @@ module Aws::S3
|
|
7744
8009
|
#
|
7745
8010
|
# * If you don’t have the `s3:ListBucket` permission, Amazon S3
|
7746
8011
|
# returns an HTTP status code `403 Access Denied` error.
|
7747
|
-
#
|
7748
8012
|
# * **Directory bucket permissions** - To grant access to this API
|
7749
8013
|
# operation on a directory bucket, we recommend that you use the [
|
7750
|
-
# `CreateSession` ][
|
8014
|
+
# `CreateSession` ][5] API operation for session-based
|
7751
8015
|
# authorization. Specifically, you grant the
|
7752
8016
|
# `s3express:CreateSession` permission to the directory bucket in a
|
7753
8017
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -7758,7 +8022,7 @@ module Aws::S3
|
|
7758
8022
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
7759
8023
|
# refresh the session token automatically to avoid service
|
7760
8024
|
# interruptions when a session expires. For more information about
|
7761
|
-
# authorization, see [ `CreateSession` ][
|
8025
|
+
# authorization, see [ `CreateSession` ][5].
|
7762
8026
|
#
|
7763
8027
|
# If the object is encrypted using SSE-KMS, you must also have the
|
7764
8028
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -7771,9 +8035,9 @@ module Aws::S3
|
|
7771
8035
|
# storage class, the S3 Intelligent-Tiering Archive Access tier, or
|
7772
8036
|
# the S3 Intelligent-Tiering Deep Archive Access tier, before you can
|
7773
8037
|
# retrieve the object you must first restore a copy using
|
7774
|
-
# [RestoreObject][
|
8038
|
+
# [RestoreObject][6]. Otherwise, this operation returns an
|
7775
8039
|
# `InvalidObjectState` error. For information about restoring archived
|
7776
|
-
# objects, see [Restoring Archived Objects][
|
8040
|
+
# objects, see [Restoring Archived Objects][7] in the *Amazon S3 User
|
7777
8041
|
# Guide*.
|
7778
8042
|
#
|
7779
8043
|
# <b>Directory buckets </b> - For directory buckets, only the S3
|
@@ -7795,7 +8059,7 @@ module Aws::S3
|
|
7795
8059
|
# **Directory buckets** - For directory buckets, there are only two
|
7796
8060
|
# supported options for server-side encryption: SSE-S3 and SSE-KMS.
|
7797
8061
|
# SSE-C isn't supported. For more information, see [Protecting data
|
7798
|
-
# with server-side encryption][
|
8062
|
+
# with server-side encryption][8] in the *Amazon S3 User Guide*.
|
7799
8063
|
#
|
7800
8064
|
# Overriding response header values through the request
|
7801
8065
|
#
|
@@ -7840,25 +8104,26 @@ module Aws::S3
|
|
7840
8104
|
# HTTP Host header syntax
|
7841
8105
|
#
|
7842
8106
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
7843
|
-
#
|
8107
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
7844
8108
|
#
|
7845
8109
|
# The following operations are related to `GetObject`:
|
7846
8110
|
#
|
7847
|
-
# * [ListBuckets][
|
8111
|
+
# * [ListBuckets][9]
|
7848
8112
|
#
|
7849
|
-
# * [GetObjectAcl][
|
8113
|
+
# * [GetObjectAcl][10]
|
7850
8114
|
#
|
7851
8115
|
#
|
7852
8116
|
#
|
7853
8117
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
|
7854
8118
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
7855
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7856
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7857
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
7858
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7859
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7860
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7861
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8119
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
8120
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
8121
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
8122
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
|
8123
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
|
8124
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
8125
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
|
8126
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
|
7862
8127
|
#
|
7863
8128
|
# @option params [String, IO] :response_target
|
7864
8129
|
# Where to write response data, file path, or IO object.
|
@@ -7868,10 +8133,10 @@ module Aws::S3
|
|
7868
8133
|
#
|
7869
8134
|
# **Directory buckets** - When you use this operation with a directory
|
7870
8135
|
# bucket, you must use virtual-hosted-style requests in the format `
|
7871
|
-
#
|
7872
|
-
# are not supported. Directory bucket names must be unique in
|
7873
|
-
# Availability Zone. Bucket names must
|
7874
|
-
#
|
8136
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
8137
|
+
# requests are not supported. Directory bucket names must be unique in
|
8138
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
8139
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
7875
8140
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
7876
8141
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
7877
8142
|
# *Amazon S3 User Guide*.
|
@@ -8223,7 +8488,7 @@ module Aws::S3
|
|
8223
8488
|
# content_range: "bytes 0-9/43",
|
8224
8489
|
# content_type: "text/plain",
|
8225
8490
|
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
8226
|
-
# last_modified: Time.parse("
|
8491
|
+
# last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
|
8227
8492
|
# metadata: {
|
8228
8493
|
# },
|
8229
8494
|
# version_id: "null",
|
@@ -8244,7 +8509,7 @@ module Aws::S3
|
|
8244
8509
|
# content_length: 3191,
|
8245
8510
|
# content_type: "image/jpeg",
|
8246
8511
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
8247
|
-
# last_modified: Time.parse("
|
8512
|
+
# last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
|
8248
8513
|
# metadata: {
|
8249
8514
|
# },
|
8250
8515
|
# tag_count: 2,
|
@@ -8356,7 +8621,7 @@ module Aws::S3
|
|
8356
8621
|
req.send_request(options, &block)
|
8357
8622
|
end
|
8358
8623
|
|
8359
|
-
# <note markdown="1"> This operation is not supported
|
8624
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
8360
8625
|
#
|
8361
8626
|
# </note>
|
8362
8627
|
#
|
@@ -8551,9 +8816,13 @@ module Aws::S3
|
|
8551
8816
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
8552
8817
|
# for this API operation to the Zonal endpoint. These endpoints support
|
8553
8818
|
# virtual-hosted-style requests in the format
|
8554
|
-
# `https://
|
8555
|
-
# Path-style requests are not supported. For more information
|
8556
|
-
# [Regional and Zonal endpoints
|
8819
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
8820
|
+
# `. Path-style requests are not supported. For more information about
|
8821
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
8822
|
+
# directory buckets in Availability Zones][1] in the *Amazon S3 User
|
8823
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
8824
|
+
# [Available Local Zone for directory buckets][2] in the *Amazon S3 User
|
8825
|
+
# Guide*.
|
8557
8826
|
#
|
8558
8827
|
# </note>
|
8559
8828
|
#
|
@@ -8566,7 +8835,7 @@ module Aws::S3
|
|
8566
8835
|
# `s3:GetObjectVersionAttributes` permissions for this operation. If
|
8567
8836
|
# the bucket is not versioned, you need the `s3:GetObject` and
|
8568
8837
|
# `s3:GetObjectAttributes` permissions. For more information, see
|
8569
|
-
# [Specifying Permissions in a Policy][
|
8838
|
+
# [Specifying Permissions in a Policy][3] in the *Amazon S3 User
|
8570
8839
|
# Guide*. If the object that you request does not exist, the error
|
8571
8840
|
# Amazon S3 returns depends on whether you also have the
|
8572
8841
|
# `s3:ListBucket` permission.
|
@@ -8578,10 +8847,9 @@ module Aws::S3
|
|
8578
8847
|
# * If you don't have the `s3:ListBucket` permission, Amazon S3
|
8579
8848
|
# returns an HTTP status code `403 Forbidden` ("access denied")
|
8580
8849
|
# error.
|
8581
|
-
#
|
8582
8850
|
# * **Directory bucket permissions** - To grant access to this API
|
8583
8851
|
# operation on a directory bucket, we recommend that you use the [
|
8584
|
-
# `CreateSession` ][
|
8852
|
+
# `CreateSession` ][4] API operation for session-based
|
8585
8853
|
# authorization. Specifically, you grant the
|
8586
8854
|
# `s3express:CreateSession` permission to the directory bucket in a
|
8587
8855
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -8592,7 +8860,7 @@ module Aws::S3
|
|
8592
8860
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
8593
8861
|
# refresh the session token automatically to avoid service
|
8594
8862
|
# interruptions when a session expires. For more information about
|
8595
|
-
# authorization, see [ `CreateSession` ][
|
8863
|
+
# authorization, see [ `CreateSession` ][4].
|
8596
8864
|
#
|
8597
8865
|
# If the object is encrypted with SSE-KMS, you must also have the
|
8598
8866
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -8628,7 +8896,7 @@ module Aws::S3
|
|
8628
8896
|
# * `x-amz-server-side-encryption-customer-key-MD5`
|
8629
8897
|
#
|
8630
8898
|
# For more information about SSE-C, see [Server-Side Encryption (Using
|
8631
|
-
# Customer-Provided Encryption Keys)][
|
8899
|
+
# Customer-Provided Encryption Keys)][5] in the *Amazon S3 User
|
8632
8900
|
# Guide*.
|
8633
8901
|
#
|
8634
8902
|
# <note markdown="1"> **Directory bucket permissions** - For directory buckets, there are
|
@@ -8640,10 +8908,10 @@ module Aws::S3
|
|
8640
8908
|
# encryption in your `CreateSession` requests or `PUT` object
|
8641
8909
|
# requests. Then, new objects are automatically encrypted with the
|
8642
8910
|
# desired encryption settings. For more information, see [Protecting
|
8643
|
-
# data with server-side encryption][
|
8911
|
+
# data with server-side encryption][6] in the *Amazon S3 User Guide*.
|
8644
8912
|
# For more information about the encryption overriding behaviors in
|
8645
8913
|
# directory buckets, see [Specifying server-side encryption with KMS
|
8646
|
-
# for new object uploads][
|
8914
|
+
# for new object uploads][7].
|
8647
8915
|
#
|
8648
8916
|
# </note>
|
8649
8917
|
#
|
@@ -8665,9 +8933,8 @@ module Aws::S3
|
|
8665
8933
|
# * `If-Match` condition evaluates to `true`.
|
8666
8934
|
#
|
8667
8935
|
# * `If-Unmodified-Since` condition evaluates to `false`.
|
8668
|
-
#
|
8669
8936
|
# For more information about conditional requests, see [RFC
|
8670
|
-
# 7232][
|
8937
|
+
# 7232][8].
|
8671
8938
|
#
|
8672
8939
|
# * If both of the `If-None-Match` and `If-Modified-Since` headers are
|
8673
8940
|
# present in the request as follows, then Amazon S3 returns the HTTP
|
@@ -8676,60 +8943,60 @@ module Aws::S3
|
|
8676
8943
|
# * `If-None-Match` condition evaluates to `false`.
|
8677
8944
|
#
|
8678
8945
|
# * `If-Modified-Since` condition evaluates to `true`.
|
8679
|
-
#
|
8680
8946
|
# For more information about conditional requests, see [RFC
|
8681
|
-
# 7232][
|
8947
|
+
# 7232][8].
|
8682
8948
|
#
|
8683
8949
|
# HTTP Host header syntax
|
8684
8950
|
#
|
8685
8951
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
8686
|
-
#
|
8952
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
8687
8953
|
#
|
8688
8954
|
# The following actions are related to `GetObjectAttributes`:
|
8689
8955
|
#
|
8690
|
-
# * [GetObject][
|
8956
|
+
# * [GetObject][9]
|
8691
8957
|
#
|
8692
|
-
# * [GetObjectAcl][
|
8958
|
+
# * [GetObjectAcl][10]
|
8693
8959
|
#
|
8694
|
-
# * [GetObjectLegalHold][
|
8960
|
+
# * [GetObjectLegalHold][11]
|
8695
8961
|
#
|
8696
|
-
# * [GetObjectLockConfiguration][
|
8962
|
+
# * [GetObjectLockConfiguration][12]
|
8697
8963
|
#
|
8698
|
-
# * [GetObjectRetention][
|
8964
|
+
# * [GetObjectRetention][13]
|
8699
8965
|
#
|
8700
|
-
# * [GetObjectTagging][
|
8966
|
+
# * [GetObjectTagging][14]
|
8701
8967
|
#
|
8702
|
-
# * [HeadObject][
|
8968
|
+
# * [HeadObject][15]
|
8703
8969
|
#
|
8704
|
-
# * [ListParts][
|
8970
|
+
# * [ListParts][16]
|
8705
8971
|
#
|
8706
8972
|
#
|
8707
8973
|
#
|
8708
8974
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
8709
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
8710
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
8711
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
8712
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
8713
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-
|
8714
|
-
# [7]: https://
|
8715
|
-
# [8]: https://
|
8716
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8717
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8718
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8719
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8720
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8721
|
-
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8722
|
-
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8975
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
8976
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
8977
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
8978
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
8979
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
8980
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
8981
|
+
# [8]: https://tools.ietf.org/html/rfc7232
|
8982
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
8983
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
|
8984
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
|
8985
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
|
8986
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
|
8987
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
|
8988
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
|
8989
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
8723
8990
|
#
|
8724
8991
|
# @option params [required, String] :bucket
|
8725
8992
|
# The name of the bucket that contains the object.
|
8726
8993
|
#
|
8727
8994
|
# **Directory buckets** - When you use this operation with a directory
|
8728
8995
|
# bucket, you must use virtual-hosted-style requests in the format `
|
8729
|
-
#
|
8730
|
-
# are not supported. Directory bucket names must be unique in
|
8731
|
-
# Availability Zone. Bucket names must
|
8732
|
-
#
|
8996
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
8997
|
+
# requests are not supported. Directory bucket names must be unique in
|
8998
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
8999
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
8733
9000
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
8734
9001
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
8735
9002
|
# *Amazon S3 User Guide*.
|
@@ -8902,7 +9169,7 @@ module Aws::S3
|
|
8902
9169
|
req.send_request(options)
|
8903
9170
|
end
|
8904
9171
|
|
8905
|
-
# <note markdown="1"> This operation is not supported
|
9172
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
8906
9173
|
#
|
8907
9174
|
# </note>
|
8908
9175
|
#
|
@@ -8998,7 +9265,7 @@ module Aws::S3
|
|
8998
9265
|
req.send_request(options)
|
8999
9266
|
end
|
9000
9267
|
|
9001
|
-
# <note markdown="1"> This operation is not supported
|
9268
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9002
9269
|
#
|
9003
9270
|
# </note>
|
9004
9271
|
#
|
@@ -9068,7 +9335,7 @@ module Aws::S3
|
|
9068
9335
|
req.send_request(options)
|
9069
9336
|
end
|
9070
9337
|
|
9071
|
-
# <note markdown="1"> This operation is not supported
|
9338
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9072
9339
|
#
|
9073
9340
|
# </note>
|
9074
9341
|
#
|
@@ -9165,7 +9432,7 @@ module Aws::S3
|
|
9165
9432
|
req.send_request(options)
|
9166
9433
|
end
|
9167
9434
|
|
9168
|
-
# <note markdown="1"> This operation is not supported
|
9435
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9169
9436
|
#
|
9170
9437
|
# </note>
|
9171
9438
|
#
|
@@ -9263,49 +9530,49 @@ module Aws::S3
|
|
9263
9530
|
# * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
|
9264
9531
|
#
|
9265
9532
|
#
|
9266
|
-
# @example Example: To retrieve tag set of
|
9533
|
+
# @example Example: To retrieve tag set of an object
|
9267
9534
|
#
|
9268
|
-
# # The following example retrieves tag set of an object.
|
9535
|
+
# # The following example retrieves tag set of an object.
|
9269
9536
|
#
|
9270
9537
|
# resp = client.get_object_tagging({
|
9271
9538
|
# bucket: "examplebucket",
|
9272
|
-
# key: "
|
9273
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9539
|
+
# key: "HappyFace.jpg",
|
9274
9540
|
# })
|
9275
9541
|
#
|
9276
9542
|
# resp.to_h outputs the following:
|
9277
9543
|
# {
|
9278
9544
|
# tag_set: [
|
9279
9545
|
# {
|
9280
|
-
# key: "
|
9281
|
-
# value: "
|
9546
|
+
# key: "Key4",
|
9547
|
+
# value: "Value4",
|
9548
|
+
# },
|
9549
|
+
# {
|
9550
|
+
# key: "Key3",
|
9551
|
+
# value: "Value3",
|
9282
9552
|
# },
|
9283
9553
|
# ],
|
9284
|
-
# version_id: "
|
9554
|
+
# version_id: "null",
|
9285
9555
|
# }
|
9286
9556
|
#
|
9287
|
-
# @example Example: To retrieve tag set of
|
9557
|
+
# @example Example: To retrieve tag set of a specific object version
|
9288
9558
|
#
|
9289
|
-
# # The following example retrieves tag set of an object.
|
9559
|
+
# # The following example retrieves tag set of an object. The request specifies object version.
|
9290
9560
|
#
|
9291
9561
|
# resp = client.get_object_tagging({
|
9292
9562
|
# bucket: "examplebucket",
|
9293
|
-
# key: "
|
9563
|
+
# key: "exampleobject",
|
9564
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9294
9565
|
# })
|
9295
9566
|
#
|
9296
9567
|
# resp.to_h outputs the following:
|
9297
9568
|
# {
|
9298
9569
|
# tag_set: [
|
9299
9570
|
# {
|
9300
|
-
# key: "
|
9301
|
-
# value: "
|
9302
|
-
# },
|
9303
|
-
# {
|
9304
|
-
# key: "Key3",
|
9305
|
-
# value: "Value3",
|
9571
|
+
# key: "Key1",
|
9572
|
+
# value: "Value1",
|
9306
9573
|
# },
|
9307
9574
|
# ],
|
9308
|
-
# version_id: "
|
9575
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9309
9576
|
# }
|
9310
9577
|
#
|
9311
9578
|
# @example Request syntax with placeholder values
|
@@ -9334,7 +9601,7 @@ module Aws::S3
|
|
9334
9601
|
req.send_request(options)
|
9335
9602
|
end
|
9336
9603
|
|
9337
|
-
# <note markdown="1"> This operation is not supported
|
9604
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9338
9605
|
#
|
9339
9606
|
# </note>
|
9340
9607
|
#
|
@@ -9435,7 +9702,7 @@ module Aws::S3
|
|
9435
9702
|
req.send_request(options, &block)
|
9436
9703
|
end
|
9437
9704
|
|
9438
|
-
# <note markdown="1"> This operation is not supported
|
9705
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
9439
9706
|
#
|
9440
9707
|
# </note>
|
9441
9708
|
#
|
@@ -9566,13 +9833,17 @@ module Aws::S3
|
|
9566
9833
|
# HTTP Host header syntax
|
9567
9834
|
#
|
9568
9835
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
9569
|
-
#
|
9836
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
9570
9837
|
#
|
9571
9838
|
# <note markdown="1"> You must make requests for this API operation to the Zonal endpoint.
|
9572
9839
|
# These endpoints support virtual-hosted-style requests in the format
|
9573
|
-
# `https://
|
9574
|
-
# Path-style requests are not supported. For more information
|
9575
|
-
# [Regional and Zonal endpoints
|
9840
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
9841
|
+
# Path-style requests are not supported. For more information about
|
9842
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
9843
|
+
# for directory buckets in Availability Zones][5] in the *Amazon S3
|
9844
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
9845
|
+
# see [Available Local Zone for directory buckets][6] in the *Amazon
|
9846
|
+
# S3 User Guide*.
|
9576
9847
|
#
|
9577
9848
|
# </note>
|
9578
9849
|
#
|
@@ -9583,16 +9854,17 @@ module Aws::S3
|
|
9583
9854
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
9584
9855
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
9585
9856
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
9857
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
9586
9858
|
#
|
9587
9859
|
# @option params [required, String] :bucket
|
9588
9860
|
# The bucket name.
|
9589
9861
|
#
|
9590
9862
|
# **Directory buckets** - When you use this operation with a directory
|
9591
9863
|
# bucket, you must use virtual-hosted-style requests in the format `
|
9592
|
-
#
|
9593
|
-
# are not supported. Directory bucket names must be unique in
|
9594
|
-
# Availability Zone. Bucket names must
|
9595
|
-
#
|
9864
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
9865
|
+
# requests are not supported. Directory bucket names must be unique in
|
9866
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
9867
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
9596
9868
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
9597
9869
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
9598
9870
|
# *Amazon S3 User Guide*.
|
@@ -9666,7 +9938,7 @@ module Aws::S3
|
|
9666
9938
|
#
|
9667
9939
|
# @example Response structure
|
9668
9940
|
#
|
9669
|
-
# resp.bucket_location_type #=> String, one of "AvailabilityZone"
|
9941
|
+
# resp.bucket_location_type #=> String, one of "AvailabilityZone", "LocalZone"
|
9670
9942
|
# resp.bucket_location_name #=> String
|
9671
9943
|
# resp.bucket_region #=> String
|
9672
9944
|
# resp.access_point_alias #=> Boolean
|
@@ -9726,7 +9998,6 @@ module Aws::S3
|
|
9726
9998
|
#
|
9727
9999
|
# * If you don’t have the `s3:ListBucket` permission, Amazon S3
|
9728
10000
|
# returns an HTTP status code `403 Forbidden` error.
|
9729
|
-
#
|
9730
10001
|
# * **Directory bucket permissions** - To grant access to this API
|
9731
10002
|
# operation on a directory bucket, we recommend that you use the [
|
9732
10003
|
# `CreateSession` ][3] API operation for session-based
|
@@ -9798,7 +10069,7 @@ module Aws::S3
|
|
9798
10069
|
# a `405 Method Not Allowed` error and the `Last-Modified:
|
9799
10070
|
# timestamp` response header.
|
9800
10071
|
#
|
9801
|
-
# <note markdown="1"> * **Directory buckets** - Delete marker is not supported
|
10072
|
+
# <note markdown="1"> * **Directory buckets** - Delete marker is not supported for
|
9802
10073
|
# directory buckets.
|
9803
10074
|
#
|
9804
10075
|
# * **Directory buckets** - S3 Versioning isn't enabled and supported
|
@@ -9812,22 +10083,26 @@ module Aws::S3
|
|
9812
10083
|
# HTTP Host header syntax
|
9813
10084
|
#
|
9814
10085
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
9815
|
-
#
|
10086
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
9816
10087
|
#
|
9817
10088
|
# <note markdown="1"> For directory buckets, you must make requests for this API operation
|
9818
10089
|
# to the Zonal endpoint. These endpoints support virtual-hosted-style
|
9819
10090
|
# requests in the format
|
9820
|
-
# `https://
|
9821
|
-
# `. Path-style requests are not supported. For more information
|
9822
|
-
# [Regional and Zonal endpoints
|
10091
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
10092
|
+
# `. Path-style requests are not supported. For more information about
|
10093
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
10094
|
+
# for directory buckets in Availability Zones][6] in the *Amazon S3
|
10095
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
10096
|
+
# see [Available Local Zone for directory buckets][7] in the *Amazon
|
10097
|
+
# S3 User Guide*.
|
9823
10098
|
#
|
9824
10099
|
# </note>
|
9825
10100
|
#
|
9826
10101
|
# The following actions are related to `HeadObject`:
|
9827
10102
|
#
|
9828
|
-
# * [GetObject][
|
10103
|
+
# * [GetObject][8]
|
9829
10104
|
#
|
9830
|
-
# * [GetObjectAttributes][
|
10105
|
+
# * [GetObjectAttributes][9]
|
9831
10106
|
#
|
9832
10107
|
#
|
9833
10108
|
#
|
@@ -9837,18 +10112,19 @@ module Aws::S3
|
|
9837
10112
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
9838
10113
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
9839
10114
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
9840
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
9841
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
10115
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
10116
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
10117
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
|
9842
10118
|
#
|
9843
10119
|
# @option params [required, String] :bucket
|
9844
10120
|
# The name of the bucket that contains the object.
|
9845
10121
|
#
|
9846
10122
|
# **Directory buckets** - When you use this operation with a directory
|
9847
10123
|
# bucket, you must use virtual-hosted-style requests in the format `
|
9848
|
-
#
|
9849
|
-
# are not supported. Directory bucket names must be unique in
|
9850
|
-
# Availability Zone. Bucket names must
|
9851
|
-
#
|
10124
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
10125
|
+
# requests are not supported. Directory bucket names must be unique in
|
10126
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
10127
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
9852
10128
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
9853
10129
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
9854
10130
|
# *Amazon S3 User Guide*.
|
@@ -10123,7 +10399,7 @@ module Aws::S3
|
|
10123
10399
|
# content_length: 3191,
|
10124
10400
|
# content_type: "image/jpeg",
|
10125
10401
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
10126
|
-
# last_modified: Time.parse("
|
10402
|
+
# last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
|
10127
10403
|
# metadata: {
|
10128
10404
|
# },
|
10129
10405
|
# version_id: "null",
|
@@ -10209,7 +10485,7 @@ module Aws::S3
|
|
10209
10485
|
req.send_request(options)
|
10210
10486
|
end
|
10211
10487
|
|
10212
|
-
# <note markdown="1"> This operation is not supported
|
10488
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10213
10489
|
#
|
10214
10490
|
# </note>
|
10215
10491
|
#
|
@@ -10310,7 +10586,7 @@ module Aws::S3
|
|
10310
10586
|
req.send_request(options)
|
10311
10587
|
end
|
10312
10588
|
|
10313
|
-
# <note markdown="1"> This operation is not supported
|
10589
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10314
10590
|
#
|
10315
10591
|
# </note>
|
10316
10592
|
#
|
@@ -10402,7 +10678,7 @@ module Aws::S3
|
|
10402
10678
|
req.send_request(options)
|
10403
10679
|
end
|
10404
10680
|
|
10405
|
-
# <note markdown="1"> This operation is not supported
|
10681
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10406
10682
|
#
|
10407
10683
|
# </note>
|
10408
10684
|
#
|
@@ -10504,7 +10780,7 @@ module Aws::S3
|
|
10504
10780
|
req.send_request(options)
|
10505
10781
|
end
|
10506
10782
|
|
10507
|
-
# <note markdown="1"> This operation is not supported
|
10783
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10508
10784
|
#
|
10509
10785
|
# </note>
|
10510
10786
|
#
|
@@ -10606,17 +10882,26 @@ module Aws::S3
|
|
10606
10882
|
req.send_request(options)
|
10607
10883
|
end
|
10608
10884
|
|
10609
|
-
# <note markdown="1"> This operation is not supported
|
10885
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
10610
10886
|
#
|
10611
10887
|
# </note>
|
10612
10888
|
#
|
10613
10889
|
# Returns a list of all buckets owned by the authenticated sender of the
|
10614
|
-
# request. To use this operation, you must
|
10615
|
-
# `s3:ListAllMyBuckets`
|
10890
|
+
# request. To grant IAM permission to use this operation, you must add
|
10891
|
+
# the `s3:ListAllMyBuckets` policy action.
|
10616
10892
|
#
|
10617
10893
|
# For information about Amazon S3 buckets, see [Creating, configuring,
|
10618
10894
|
# and working with Amazon S3 buckets][1].
|
10619
10895
|
#
|
10896
|
+
# We strongly recommend using only paginated `ListBuckets` requests.
|
10897
|
+
# Unpaginated `ListBuckets` requests are only supported for Amazon Web
|
10898
|
+
# Services accounts set to the default general purpose bucket quota of
|
10899
|
+
# 10,000. If you have an approved general purpose bucket quota above
|
10900
|
+
# 10,000, you must send paginated `ListBuckets` requests to list your
|
10901
|
+
# account’s buckets. All unpaginated `ListBuckets` requests will be
|
10902
|
+
# rejected for Amazon Web Services accounts with a general purpose
|
10903
|
+
# bucket quota greater than 10,000.
|
10904
|
+
#
|
10620
10905
|
#
|
10621
10906
|
#
|
10622
10907
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
|
@@ -10636,6 +10921,14 @@ module Aws::S3
|
|
10636
10921
|
#
|
10637
10922
|
# Required: No.
|
10638
10923
|
#
|
10924
|
+
# <note markdown="1"> If you specify the `bucket-region`, `prefix`, or `continuation-token`
|
10925
|
+
# query parameters without using `max-buckets` to set the maximum number
|
10926
|
+
# of buckets returned in the response, Amazon S3 applies a default page
|
10927
|
+
# size of 10,000 and provides a continuation token if there are more
|
10928
|
+
# buckets.
|
10929
|
+
#
|
10930
|
+
# </note>
|
10931
|
+
#
|
10639
10932
|
# @option params [String] :prefix
|
10640
10933
|
# Limits the response to bucket names that begin with the specified
|
10641
10934
|
# bucket name prefix.
|
@@ -10735,9 +11028,13 @@ module Aws::S3
|
|
10735
11028
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
10736
11029
|
# requests for this API operation to the Regional endpoint. These
|
10737
11030
|
# endpoints support path-style requests in the format
|
10738
|
-
# `https://s3express-control.
|
10739
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
10740
|
-
#
|
11031
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
11032
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
11033
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
11034
|
+
# endpoints for directory buckets in Availability Zones][2] in the
|
11035
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
11036
|
+
# Zones, see [Available Local Zone for directory buckets][3] in the
|
11037
|
+
# *Amazon S3 User Guide*.
|
10741
11038
|
#
|
10742
11039
|
# </note>
|
10743
11040
|
#
|
@@ -10749,7 +11046,7 @@ module Aws::S3
|
|
10749
11046
|
# operation can only be performed by the Amazon Web Services account
|
10750
11047
|
# that owns the resource. For more information about directory bucket
|
10751
11048
|
# policies and permissions, see [Amazon Web Services Identity and
|
10752
|
-
# Access Management (IAM) for S3 Express One Zone][
|
11049
|
+
# Access Management (IAM) for S3 Express One Zone][4] in the *Amazon
|
10753
11050
|
# S3 User Guide*.
|
10754
11051
|
#
|
10755
11052
|
# HTTP Host header syntax
|
@@ -10757,11 +11054,17 @@ module Aws::S3
|
|
10757
11054
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
10758
11055
|
# `s3express-control.region.amazonaws.com`.
|
10759
11056
|
#
|
11057
|
+
# <note markdown="1"> The `BucketRegion` response element is not part of the
|
11058
|
+
# `ListDirectoryBuckets` Response Syntax.
|
11059
|
+
#
|
11060
|
+
# </note>
|
11061
|
+
#
|
10760
11062
|
#
|
10761
11063
|
#
|
10762
11064
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
|
10763
11065
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
10764
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-
|
11066
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
11067
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
10765
11068
|
#
|
10766
11069
|
# @option params [String] :continuation_token
|
10767
11070
|
# `ContinuationToken` indicates to Amazon S3 that the list is being
|
@@ -10815,7 +11118,7 @@ module Aws::S3
|
|
10815
11118
|
# multipart uploads are aborted or completed. To delete these
|
10816
11119
|
# in-progress multipart uploads, use the `ListMultipartUploads`
|
10817
11120
|
# operation to list the in-progress multipart uploads in the bucket and
|
10818
|
-
# use the `
|
11121
|
+
# use the `AbortMultipartUpload` operation to abort all the in-progress
|
10819
11122
|
# multipart uploads.
|
10820
11123
|
#
|
10821
11124
|
# </note>
|
@@ -10849,21 +11152,25 @@ module Aws::S3
|
|
10849
11152
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
10850
11153
|
# for this API operation to the Zonal endpoint. These endpoints support
|
10851
11154
|
# virtual-hosted-style requests in the format
|
10852
|
-
# `https://
|
10853
|
-
# Path-style requests are not supported. For more information
|
10854
|
-
# [Regional and Zonal endpoints
|
11155
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
11156
|
+
# `. Path-style requests are not supported. For more information about
|
11157
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
11158
|
+
# directory buckets in Availability Zones][2] in the *Amazon S3 User
|
11159
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
11160
|
+
# [Available Local Zone for directory buckets][3] in the *Amazon S3 User
|
11161
|
+
# Guide*.
|
10855
11162
|
#
|
10856
11163
|
# </note>
|
10857
11164
|
#
|
10858
11165
|
# Permissions
|
10859
11166
|
# : * **General purpose bucket permissions** - For information about
|
10860
11167
|
# permissions required to use the multipart upload API, see
|
10861
|
-
# [Multipart Upload and Permissions][
|
11168
|
+
# [Multipart Upload and Permissions][4] in the *Amazon S3 User
|
10862
11169
|
# Guide*.
|
10863
11170
|
#
|
10864
11171
|
# * **Directory bucket permissions** - To grant access to this API
|
10865
11172
|
# operation on a directory bucket, we recommend that you use the [
|
10866
|
-
# `CreateSession` ][
|
11173
|
+
# `CreateSession` ][5] API operation for session-based
|
10867
11174
|
# authorization. Specifically, you grant the
|
10868
11175
|
# `s3express:CreateSession` permission to the directory bucket in a
|
10869
11176
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -10874,7 +11181,7 @@ module Aws::S3
|
|
10874
11181
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
10875
11182
|
# refresh the session token automatically to avoid service
|
10876
11183
|
# interruptions when a session expires. For more information about
|
10877
|
-
# authorization, see [ `CreateSession` ][
|
11184
|
+
# authorization, see [ `CreateSession` ][5].
|
10878
11185
|
#
|
10879
11186
|
# Sorting of multipart uploads in response
|
10880
11187
|
# : * **General purpose bucket** - In the `ListMultipartUploads`
|
@@ -10888,7 +11195,6 @@ module Aws::S3
|
|
10888
11195
|
# initiation time. Among uploads with the same key, the one that
|
10889
11196
|
# was initiated first will appear before the ones that were
|
10890
11197
|
# initiated later.
|
10891
|
-
#
|
10892
11198
|
# * **Directory bucket** - In the `ListMultipartUploads` response, the
|
10893
11199
|
# multipart uploads aren't sorted lexicographically based on the
|
10894
11200
|
# object keys.
|
@@ -10896,41 +11202,42 @@ module Aws::S3
|
|
10896
11202
|
# HTTP Host header syntax
|
10897
11203
|
#
|
10898
11204
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
10899
|
-
#
|
11205
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
10900
11206
|
#
|
10901
11207
|
# The following operations are related to `ListMultipartUploads`:
|
10902
11208
|
#
|
10903
|
-
# * [CreateMultipartUpload][
|
11209
|
+
# * [CreateMultipartUpload][6]
|
10904
11210
|
#
|
10905
|
-
# * [UploadPart][
|
11211
|
+
# * [UploadPart][7]
|
10906
11212
|
#
|
10907
|
-
# * [CompleteMultipartUpload][
|
11213
|
+
# * [CompleteMultipartUpload][8]
|
10908
11214
|
#
|
10909
|
-
# * [ListParts][
|
11215
|
+
# * [ListParts][9]
|
10910
11216
|
#
|
10911
|
-
# * [AbortMultipartUpload][
|
11217
|
+
# * [AbortMultipartUpload][10]
|
10912
11218
|
#
|
10913
11219
|
#
|
10914
11220
|
#
|
10915
11221
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
10916
11222
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
10917
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10918
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10919
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
10920
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
10921
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
10922
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
10923
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
11223
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
11224
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
11225
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
11226
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
11227
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
11228
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
11229
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
11230
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
10924
11231
|
#
|
10925
11232
|
# @option params [required, String] :bucket
|
10926
11233
|
# The name of the bucket to which the multipart upload was initiated.
|
10927
11234
|
#
|
10928
11235
|
# **Directory buckets** - When you use this operation with a directory
|
10929
11236
|
# bucket, you must use virtual-hosted-style requests in the format `
|
10930
|
-
#
|
10931
|
-
# are not supported. Directory bucket names must be unique in
|
10932
|
-
# Availability Zone. Bucket names must
|
10933
|
-
#
|
11237
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
11238
|
+
# requests are not supported. Directory bucket names must be unique in
|
11239
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
11240
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
10934
11241
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
10935
11242
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
10936
11243
|
# *Amazon S3 User Guide*.
|
@@ -11245,7 +11552,7 @@ module Aws::S3
|
|
11245
11552
|
req.send_request(options)
|
11246
11553
|
end
|
11247
11554
|
|
11248
|
-
# <note markdown="1"> This operation is not supported
|
11555
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
11249
11556
|
#
|
11250
11557
|
# </note>
|
11251
11558
|
#
|
@@ -11484,7 +11791,7 @@ module Aws::S3
|
|
11484
11791
|
req.send_request(options)
|
11485
11792
|
end
|
11486
11793
|
|
11487
|
-
# <note markdown="1"> This operation is not supported
|
11794
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
11488
11795
|
#
|
11489
11796
|
# </note>
|
11490
11797
|
#
|
@@ -11523,10 +11830,10 @@ module Aws::S3
|
|
11523
11830
|
#
|
11524
11831
|
# **Directory buckets** - When you use this operation with a directory
|
11525
11832
|
# bucket, you must use virtual-hosted-style requests in the format `
|
11526
|
-
#
|
11527
|
-
# are not supported. Directory bucket names must be unique in
|
11528
|
-
# Availability Zone. Bucket names must
|
11529
|
-
#
|
11833
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
11834
|
+
# requests are not supported. Directory bucket names must be unique in
|
11835
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
11836
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
11530
11837
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
11531
11838
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
11532
11839
|
# *Amazon S3 User Guide*.
|
@@ -11738,9 +12045,13 @@ module Aws::S3
|
|
11738
12045
|
# * **Directory buckets** - For directory buckets, you must make
|
11739
12046
|
# requests for this API operation to the Zonal endpoint. These
|
11740
12047
|
# endpoints support virtual-hosted-style requests in the format
|
11741
|
-
# `https://
|
11742
|
-
# `. Path-style requests are not supported. For more information
|
11743
|
-
# [Regional and Zonal endpoints
|
12048
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
12049
|
+
# `. Path-style requests are not supported. For more information about
|
12050
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
12051
|
+
# for directory buckets in Availability Zones][3] in the *Amazon S3
|
12052
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
12053
|
+
# see [Available Local Zone for directory buckets][4] in the *Amazon
|
12054
|
+
# S3 User Guide*.
|
11744
12055
|
#
|
11745
12056
|
# </note>
|
11746
12057
|
#
|
@@ -11750,12 +12061,12 @@ module Aws::S3
|
|
11750
12061
|
# to perform the `s3:ListBucket` action. The bucket owner has this
|
11751
12062
|
# permission by default and can grant this permission to others. For
|
11752
12063
|
# more information about permissions, see [Permissions Related to
|
11753
|
-
# Bucket Subresource Operations][
|
11754
|
-
# to Your Amazon S3 Resources][
|
12064
|
+
# Bucket Subresource Operations][5] and [Managing Access Permissions
|
12065
|
+
# to Your Amazon S3 Resources][6] in the *Amazon S3 User Guide*.
|
11755
12066
|
#
|
11756
12067
|
# * **Directory bucket permissions** - To grant access to this API
|
11757
12068
|
# operation on a directory bucket, we recommend that you use the [
|
11758
|
-
# `CreateSession` ][
|
12069
|
+
# `CreateSession` ][7] API operation for session-based
|
11759
12070
|
# authorization. Specifically, you grant the
|
11760
12071
|
# `s3express:CreateSession` permission to the directory bucket in a
|
11761
12072
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -11766,7 +12077,7 @@ module Aws::S3
|
|
11766
12077
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
11767
12078
|
# refresh the session token automatically to avoid service
|
11768
12079
|
# interruptions when a session expires. For more information about
|
11769
|
-
# authorization, see [ `CreateSession` ][
|
12080
|
+
# authorization, see [ `CreateSession` ][7].
|
11770
12081
|
#
|
11771
12082
|
# Sorting order of returned objects
|
11772
12083
|
# : * **General purpose bucket** - For general purpose buckets,
|
@@ -11779,41 +12090,42 @@ module Aws::S3
|
|
11779
12090
|
# HTTP Host header syntax
|
11780
12091
|
#
|
11781
12092
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
11782
|
-
#
|
12093
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
11783
12094
|
#
|
11784
12095
|
# This section describes the latest revision of this action. We
|
11785
12096
|
# recommend that you use this revised API operation for application
|
11786
12097
|
# development. For backward compatibility, Amazon S3 continues to
|
11787
|
-
# support the prior version of this API operation, [ListObjects][
|
12098
|
+
# support the prior version of this API operation, [ListObjects][8].
|
11788
12099
|
#
|
11789
12100
|
# The following operations are related to `ListObjectsV2`:
|
11790
12101
|
#
|
11791
|
-
# * [GetObject][
|
12102
|
+
# * [GetObject][9]
|
11792
12103
|
#
|
11793
|
-
# * [PutObject][
|
12104
|
+
# * [PutObject][10]
|
11794
12105
|
#
|
11795
|
-
# * [CreateBucket][
|
12106
|
+
# * [CreateBucket][11]
|
11796
12107
|
#
|
11797
12108
|
#
|
11798
12109
|
#
|
11799
12110
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
|
11800
12111
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
|
11801
12112
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
11802
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
11803
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-
|
11804
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11805
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
11806
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
11807
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
11808
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12113
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
12114
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
12115
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
12116
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
12117
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
|
12118
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
12119
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
12120
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
11809
12121
|
#
|
11810
12122
|
# @option params [required, String] :bucket
|
11811
12123
|
# **Directory buckets** - When you use this operation with a directory
|
11812
12124
|
# bucket, you must use virtual-hosted-style requests in the format `
|
11813
|
-
#
|
11814
|
-
# are not supported. Directory bucket names must be unique in
|
11815
|
-
# Availability Zone. Bucket names must
|
11816
|
-
#
|
12125
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
12126
|
+
# requests are not supported. Directory bucket names must be unique in
|
12127
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
12128
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
11817
12129
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
11818
12130
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
11819
12131
|
# *Amazon S3 User Guide*.
|
@@ -12081,16 +12393,20 @@ module Aws::S3
|
|
12081
12393
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
12082
12394
|
# for this API operation to the Zonal endpoint. These endpoints support
|
12083
12395
|
# virtual-hosted-style requests in the format
|
12084
|
-
# `https://
|
12085
|
-
# Path-style requests are not supported. For more information
|
12086
|
-
# [Regional and Zonal endpoints
|
12396
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
12397
|
+
# `. Path-style requests are not supported. For more information about
|
12398
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
12399
|
+
# directory buckets in Availability Zones][3] in the *Amazon S3 User
|
12400
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
12401
|
+
# [Available Local Zone for directory buckets][4] in the *Amazon S3 User
|
12402
|
+
# Guide*.
|
12087
12403
|
#
|
12088
12404
|
# </note>
|
12089
12405
|
#
|
12090
12406
|
# Permissions
|
12091
12407
|
# : * **General purpose bucket permissions** - For information about
|
12092
12408
|
# permissions required to use the multipart upload API, see
|
12093
|
-
# [Multipart Upload and Permissions][
|
12409
|
+
# [Multipart Upload and Permissions][5] in the *Amazon S3 User
|
12094
12410
|
# Guide*.
|
12095
12411
|
#
|
12096
12412
|
# If the upload was created using server-side encryption with Key
|
@@ -12101,7 +12417,7 @@ module Aws::S3
|
|
12101
12417
|
#
|
12102
12418
|
# * **Directory bucket permissions** - To grant access to this API
|
12103
12419
|
# operation on a directory bucket, we recommend that you use the [
|
12104
|
-
# `CreateSession` ][
|
12420
|
+
# `CreateSession` ][6] API operation for session-based
|
12105
12421
|
# authorization. Specifically, you grant the
|
12106
12422
|
# `s3express:CreateSession` permission to the directory bucket in a
|
12107
12423
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -12112,49 +12428,50 @@ module Aws::S3
|
|
12112
12428
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
12113
12429
|
# refresh the session token automatically to avoid service
|
12114
12430
|
# interruptions when a session expires. For more information about
|
12115
|
-
# authorization, see [ `CreateSession` ][
|
12431
|
+
# authorization, see [ `CreateSession` ][6].
|
12116
12432
|
#
|
12117
12433
|
# HTTP Host header syntax
|
12118
12434
|
#
|
12119
12435
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
12120
|
-
#
|
12436
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
12121
12437
|
#
|
12122
12438
|
# The following operations are related to `ListParts`:
|
12123
12439
|
#
|
12124
12440
|
# * [CreateMultipartUpload][1]
|
12125
12441
|
#
|
12126
|
-
# * [UploadPart][
|
12442
|
+
# * [UploadPart][7]
|
12127
12443
|
#
|
12128
|
-
# * [CompleteMultipartUpload][
|
12444
|
+
# * [CompleteMultipartUpload][8]
|
12129
12445
|
#
|
12130
|
-
# * [AbortMultipartUpload][
|
12446
|
+
# * [AbortMultipartUpload][9]
|
12131
12447
|
#
|
12132
|
-
# * [GetObjectAttributes][
|
12448
|
+
# * [GetObjectAttributes][10]
|
12133
12449
|
#
|
12134
|
-
# * [ListMultipartUploads][
|
12450
|
+
# * [ListMultipartUploads][11]
|
12135
12451
|
#
|
12136
12452
|
#
|
12137
12453
|
#
|
12138
12454
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
12139
12455
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
12140
12456
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
12141
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12142
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12143
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12144
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12145
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12146
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12147
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12457
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
12458
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
12459
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
12460
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
12461
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
12462
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
12463
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
|
12464
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
12148
12465
|
#
|
12149
12466
|
# @option params [required, String] :bucket
|
12150
12467
|
# The name of the bucket to which the parts are being uploaded.
|
12151
12468
|
#
|
12152
12469
|
# **Directory buckets** - When you use this operation with a directory
|
12153
12470
|
# bucket, you must use virtual-hosted-style requests in the format `
|
12154
|
-
#
|
12155
|
-
# are not supported. Directory bucket names must be unique in
|
12156
|
-
# Availability Zone. Bucket names must
|
12157
|
-
#
|
12471
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
12472
|
+
# requests are not supported. Directory bucket names must be unique in
|
12473
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
12474
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
12158
12475
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
12159
12476
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
12160
12477
|
# *Amazon S3 User Guide*.
|
@@ -12378,7 +12695,7 @@ module Aws::S3
|
|
12378
12695
|
req.send_request(options)
|
12379
12696
|
end
|
12380
12697
|
|
12381
|
-
# <note markdown="1"> This operation is not supported
|
12698
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
12382
12699
|
#
|
12383
12700
|
# </note>
|
12384
12701
|
#
|
@@ -12477,7 +12794,7 @@ module Aws::S3
|
|
12477
12794
|
req.send_request(options)
|
12478
12795
|
end
|
12479
12796
|
|
12480
|
-
# <note markdown="1"> This operation is not supported
|
12797
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
12481
12798
|
#
|
12482
12799
|
# </note>
|
12483
12800
|
#
|
@@ -12568,7 +12885,6 @@ module Aws::S3
|
|
12568
12885
|
# General Reference.
|
12569
12886
|
#
|
12570
12887
|
# </note>
|
12571
|
-
#
|
12572
12888
|
# For example, the following `x-amz-grant-write` header grants
|
12573
12889
|
# create, overwrite, and delete objects permission to LogDelivery
|
12574
12890
|
# group predefined by Amazon S3 and two Amazon Web Services accounts
|
@@ -12771,7 +13087,7 @@ module Aws::S3
|
|
12771
13087
|
req.send_request(options)
|
12772
13088
|
end
|
12773
13089
|
|
12774
|
-
# <note markdown="1"> This operation is not supported
|
13090
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
12775
13091
|
#
|
12776
13092
|
# </note>
|
12777
13093
|
#
|
@@ -12809,14 +13125,12 @@ module Aws::S3
|
|
12809
13125
|
# * *Code: InvalidArgument*
|
12810
13126
|
#
|
12811
13127
|
# * *Cause: Invalid argument.*
|
12812
|
-
#
|
12813
13128
|
# * * *HTTP Error: HTTP 400 Bad Request*
|
12814
13129
|
#
|
12815
13130
|
# * *Code: TooManyConfigurations*
|
12816
13131
|
#
|
12817
13132
|
# * *Cause: You are attempting to create a new configuration but have
|
12818
13133
|
# already reached the 1,000-configuration limit.*
|
12819
|
-
#
|
12820
13134
|
# * * *HTTP Error: HTTP 403 Forbidden*
|
12821
13135
|
#
|
12822
13136
|
# * *Code: AccessDenied*
|
@@ -12909,7 +13223,7 @@ module Aws::S3
|
|
12909
13223
|
req.send_request(options)
|
12910
13224
|
end
|
12911
13225
|
|
12912
|
-
# <note markdown="1"> This operation is not supported
|
13226
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
12913
13227
|
#
|
12914
13228
|
# </note>
|
12915
13229
|
#
|
@@ -13094,9 +13408,13 @@ module Aws::S3
|
|
13094
13408
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
13095
13409
|
# requests for this API operation to the Regional endpoint. These
|
13096
13410
|
# endpoints support path-style requests in the format
|
13097
|
-
# `https://s3express-control.
|
13098
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
13099
|
-
#
|
13411
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
13412
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
13413
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
13414
|
+
# endpoints for directory buckets in Availability Zones][1] in the
|
13415
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
13416
|
+
# Zones, see [Available Local Zone for directory buckets][2] in the
|
13417
|
+
# *Amazon S3 User Guide*.
|
13100
13418
|
#
|
13101
13419
|
# </note>
|
13102
13420
|
#
|
@@ -13110,15 +13428,14 @@ module Aws::S3
|
|
13110
13428
|
# keys (SSE-KMS) or dual-layer server-side encryption with Amazon
|
13111
13429
|
# Web Services KMS keys (DSSE-KMS). If you specify default
|
13112
13430
|
# encryption by using SSE-KMS, you can also configure [Amazon S3
|
13113
|
-
# Bucket Keys][
|
13114
|
-
# encryption feature, see [Amazon S3 Bucket Default Encryption][
|
13431
|
+
# Bucket Keys][3]. For information about the bucket default
|
13432
|
+
# encryption feature, see [Amazon S3 Bucket Default Encryption][4]
|
13115
13433
|
# in the *Amazon S3 User Guide*.
|
13116
13434
|
#
|
13117
13435
|
# * If you use PutBucketEncryption to set your [default bucket
|
13118
|
-
# encryption][
|
13436
|
+
# encryption][4] to SSE-KMS, you should verify that your KMS key ID
|
13119
13437
|
# is correct. Amazon S3 doesn't validate the KMS key ID provided in
|
13120
13438
|
# PutBucketEncryption requests.
|
13121
|
-
#
|
13122
13439
|
# * <b>Directory buckets </b> - You can optionally configure default
|
13123
13440
|
# encryption for a bucket by using server-side encryption with Key
|
13124
13441
|
# Management Service (KMS) keys (SSE-KMS).
|
@@ -13130,28 +13447,28 @@ module Aws::S3
|
|
13130
13447
|
# encrypted with the desired encryption settings. For more
|
13131
13448
|
# information about the encryption overriding behaviors in directory
|
13132
13449
|
# buckets, see [Specifying server-side encryption with KMS for new
|
13133
|
-
# object uploads][
|
13450
|
+
# object uploads][5].
|
13134
13451
|
#
|
13135
13452
|
# * Your SSE-KMS configuration can only support 1 [customer managed
|
13136
|
-
# key][
|
13137
|
-
# [Amazon Web Services managed key][
|
13453
|
+
# key][6] per directory bucket for the lifetime of the bucket. The
|
13454
|
+
# [Amazon Web Services managed key][7] (`aws/s3`) isn't supported.
|
13138
13455
|
#
|
13139
13456
|
# * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
|
13140
13457
|
# in a directory bucket and can’t be disabled. S3 Bucket Keys
|
13141
13458
|
# aren't supported, when you copy SSE-KMS encrypted objects from
|
13142
13459
|
# general purpose buckets to directory buckets, from directory
|
13143
13460
|
# buckets to general purpose buckets, or between directory buckets,
|
13144
|
-
# through [CopyObject][
|
13145
|
-
# in Batch Operations][
|
13461
|
+
# through [CopyObject][8], [UploadPartCopy][9], [the Copy operation
|
13462
|
+
# in Batch Operations][10], or [the import jobs][11]. In this case,
|
13146
13463
|
# Amazon S3 makes a call to KMS every time a copy request is made
|
13147
13464
|
# for a KMS-encrypted object.
|
13148
13465
|
#
|
13149
|
-
# * When you specify an [KMS customer managed key][
|
13466
|
+
# * When you specify an [KMS customer managed key][6] for encryption
|
13150
13467
|
# in your directory bucket, only use the key ID or key ARN. The key
|
13151
13468
|
# alias format of the KMS key isn't supported.
|
13152
13469
|
#
|
13153
13470
|
# * For directory buckets, if you use PutBucketEncryption to set your
|
13154
|
-
# [default bucket encryption][
|
13471
|
+
# [default bucket encryption][4] to SSE-KMS, Amazon S3 validates the
|
13155
13472
|
# KMS key ID provided in PutBucketEncryption requests.
|
13156
13473
|
#
|
13157
13474
|
# </note>
|
@@ -13164,7 +13481,7 @@ module Aws::S3
|
|
13164
13481
|
#
|
13165
13482
|
# Also, this action requires Amazon Web Services Signature Version 4.
|
13166
13483
|
# For more information, see [ Authenticating Requests (Amazon Web
|
13167
|
-
# Services Signature Version 4)][
|
13484
|
+
# Services Signature Version 4)][12].
|
13168
13485
|
#
|
13169
13486
|
# Permissions
|
13170
13487
|
# : * **General purpose bucket permissions** - The
|
@@ -13172,8 +13489,8 @@ module Aws::S3
|
|
13172
13489
|
# policy. The bucket owner has this permission by default. The
|
13173
13490
|
# bucket owner can grant this permission to others. For more
|
13174
13491
|
# information about permissions, see [Permissions Related to Bucket
|
13175
|
-
# Operations][
|
13176
|
-
# Resources][
|
13492
|
+
# Operations][13] and [Managing Access Permissions to Your Amazon S3
|
13493
|
+
# Resources][14] in the *Amazon S3 User Guide*.
|
13177
13494
|
#
|
13178
13495
|
# * **Directory bucket permissions** - To grant access to this API
|
13179
13496
|
# operation, you must have the
|
@@ -13183,7 +13500,7 @@ module Aws::S3
|
|
13183
13500
|
# only be performed by the Amazon Web Services account that owns the
|
13184
13501
|
# resource. For more information about directory bucket policies and
|
13185
13502
|
# permissions, see [Amazon Web Services Identity and Access
|
13186
|
-
# Management (IAM) for S3 Express One Zone][
|
13503
|
+
# Management (IAM) for S3 Express One Zone][15] in the *Amazon S3
|
13187
13504
|
# User Guide*.
|
13188
13505
|
#
|
13189
13506
|
# To set a directory bucket default encryption with SSE-KMS, you
|
@@ -13194,32 +13511,33 @@ module Aws::S3
|
|
13194
13511
|
# HTTP Host header syntax
|
13195
13512
|
#
|
13196
13513
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
13197
|
-
# `s3express-control.region.amazonaws.com`.
|
13514
|
+
# `s3express-control.region-code.amazonaws.com`.
|
13198
13515
|
#
|
13199
13516
|
# The following operations are related to `PutBucketEncryption`:
|
13200
13517
|
#
|
13201
|
-
# * [GetBucketEncryption][
|
13518
|
+
# * [GetBucketEncryption][16]
|
13202
13519
|
#
|
13203
|
-
# * [DeleteBucketEncryption][
|
13520
|
+
# * [DeleteBucketEncryption][17]
|
13204
13521
|
#
|
13205
13522
|
#
|
13206
13523
|
#
|
13207
13524
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
13208
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13209
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-
|
13210
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13211
|
-
# [5]: https://docs.aws.amazon.com/
|
13212
|
-
# [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#
|
13213
|
-
# [7]: https://docs.aws.amazon.com/
|
13214
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
13215
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13216
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
13217
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13218
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13219
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-
|
13220
|
-
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-
|
13221
|
-
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13222
|
-
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
13525
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
13526
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
|
13527
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
13528
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
13529
|
+
# [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
|
13530
|
+
# [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
|
13531
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
13532
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
13533
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
|
13534
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
|
13535
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
13536
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
13537
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
13538
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
13539
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
13540
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
13223
13541
|
#
|
13224
13542
|
# @option params [required, String] :bucket
|
13225
13543
|
# Specifies default encryption for a bucket using server-side encryption
|
@@ -13227,13 +13545,14 @@ module Aws::S3
|
|
13227
13545
|
#
|
13228
13546
|
# <b>Directory buckets </b> - When you use this operation with a
|
13229
13547
|
# directory bucket, you must use path-style requests in the format
|
13230
|
-
# `https://s3express-control.
|
13548
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
13231
13549
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
13232
|
-
# names must be unique in the chosen Availability Zone
|
13233
|
-
# must also follow the format `
|
13234
|
-
#
|
13235
|
-
#
|
13236
|
-
#
|
13550
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
13551
|
+
# Zone). Bucket names must also follow the format `
|
13552
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
13553
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
13554
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
13555
|
+
# *Amazon S3 User Guide*
|
13237
13556
|
#
|
13238
13557
|
#
|
13239
13558
|
#
|
@@ -13317,7 +13636,7 @@ module Aws::S3
|
|
13317
13636
|
req.send_request(options)
|
13318
13637
|
end
|
13319
13638
|
|
13320
|
-
# <note markdown="1"> This operation is not supported
|
13639
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
13321
13640
|
#
|
13322
13641
|
# </note>
|
13323
13642
|
#
|
@@ -13442,7 +13761,7 @@ module Aws::S3
|
|
13442
13761
|
req.send_request(options)
|
13443
13762
|
end
|
13444
13763
|
|
13445
|
-
# <note markdown="1"> This operation is not supported
|
13764
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
13446
13765
|
#
|
13447
13766
|
# </note>
|
13448
13767
|
#
|
@@ -13594,15 +13913,15 @@ module Aws::S3
|
|
13594
13913
|
req.send_request(options)
|
13595
13914
|
end
|
13596
13915
|
|
13597
|
-
# <note markdown="1"> This operation is not supported by directory buckets.
|
13598
|
-
#
|
13599
|
-
# </note>
|
13600
|
-
#
|
13601
13916
|
# For an updated version of this API, see
|
13602
13917
|
# [PutBucketLifecycleConfiguration][1]. This version has been
|
13603
13918
|
# deprecated. Existing lifecycle configurations will work. For new
|
13604
13919
|
# lifecycle configurations, use the updated API.
|
13605
13920
|
#
|
13921
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
13922
|
+
#
|
13923
|
+
# </note>
|
13924
|
+
#
|
13606
13925
|
# Creates a new lifecycle configuration for the bucket or replaces an
|
13607
13926
|
# existing lifecycle configuration. For information about lifecycle
|
13608
13927
|
# configuration, see [Object Lifecycle Management][2] in the *Amazon S3
|
@@ -13745,10 +14064,6 @@ module Aws::S3
|
|
13745
14064
|
req.send_request(options)
|
13746
14065
|
end
|
13747
14066
|
|
13748
|
-
# <note markdown="1"> This operation is not supported by directory buckets.
|
13749
|
-
#
|
13750
|
-
# </note>
|
13751
|
-
#
|
13752
14067
|
# Creates a new lifecycle configuration for the bucket or replaces an
|
13753
14068
|
# existing lifecycle configuration. Keep in mind that this will
|
13754
14069
|
# overwrite an existing lifecycle configuration, so if you want to
|
@@ -13756,7 +14071,19 @@ module Aws::S3
|
|
13756
14071
|
# lifecycle configuration. For information about lifecycle
|
13757
14072
|
# configuration, see [Managing your storage lifecycle][1].
|
13758
14073
|
#
|
14074
|
+
# <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
|
14075
|
+
# rule using an object key name prefix, one or more object tags, object
|
14076
|
+
# size, or any combination of these. Accordingly, this section describes
|
14077
|
+
# the latest API. The previous version of the API supported filtering
|
14078
|
+
# based only on an object key name prefix, which is supported for
|
14079
|
+
# backward compatibility. For the related API description, see
|
14080
|
+
# [PutBucketLifecycle][2].
|
14081
|
+
#
|
14082
|
+
# </note>
|
14083
|
+
#
|
13759
14084
|
# Rules
|
14085
|
+
# Permissions
|
14086
|
+
# HTTP Host header syntax
|
13760
14087
|
#
|
13761
14088
|
# : You specify the lifecycle configuration in your request body. The
|
13762
14089
|
# lifecycle configuration is specified as XML consisting of one or
|
@@ -13768,8 +14095,14 @@ module Aws::S3
|
|
13768
14095
|
# size, or any combination of these. Accordingly, this section
|
13769
14096
|
# describes the latest API. The previous version of the API supported
|
13770
14097
|
# filtering based only on an object key name prefix, which is
|
13771
|
-
# supported for backward compatibility
|
13772
|
-
# description, see [PutBucketLifecycle][2].
|
14098
|
+
# supported for backward compatibility for general purpose buckets.
|
14099
|
+
# For the related API description, see [PutBucketLifecycle][2].
|
14100
|
+
#
|
14101
|
+
# <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
|
14102
|
+
# objects and cancelling multipart uploads. Expiring of versioned
|
14103
|
+
# objects,transitions and tag filters are not supported.
|
14104
|
+
#
|
14105
|
+
# </note>
|
13773
14106
|
#
|
13774
14107
|
# A lifecycle rule consists of the following:
|
13775
14108
|
#
|
@@ -13789,40 +14122,64 @@ module Aws::S3
|
|
13789
14122
|
#
|
13790
14123
|
# For more information, see [Object Lifecycle Management][3] and
|
13791
14124
|
# [Lifecycle Configuration Elements][4].
|
14125
|
+
# : * **General purpose bucket permissions** - By default, all Amazon S3
|
14126
|
+
# resources are private, including buckets, objects, and related
|
14127
|
+
# subresources (for example, lifecycle configuration and website
|
14128
|
+
# configuration). Only the resource owner (that is, the Amazon Web
|
14129
|
+
# Services account that created it) can access the resource. The
|
14130
|
+
# resource owner can optionally grant access permissions to others
|
14131
|
+
# by writing an access policy. For this operation, a user must have
|
14132
|
+
# the `s3:PutLifecycleConfiguration` permission.
|
13792
14133
|
#
|
13793
|
-
#
|
14134
|
+
# You can also explicitly deny permissions. An explicit deny also
|
14135
|
+
# supersedes any other permissions. If you want to block users or
|
14136
|
+
# accounts from removing or deleting objects from your bucket, you
|
14137
|
+
# must deny them permissions for the following actions:
|
13794
14138
|
#
|
13795
|
-
# :
|
13796
|
-
# objects, and related subresources (for example, lifecycle
|
13797
|
-
# configuration and website configuration). Only the resource owner
|
13798
|
-
# (that is, the Amazon Web Services account that created it) can
|
13799
|
-
# access the resource. The resource owner can optionally grant access
|
13800
|
-
# permissions to others by writing an access policy. For this
|
13801
|
-
# operation, a user must get the `s3:PutLifecycleConfiguration`
|
13802
|
-
# permission.
|
14139
|
+
# * `s3:DeleteObject`
|
13803
14140
|
#
|
13804
|
-
#
|
13805
|
-
# supersedes any other permissions. If you want to block users or
|
13806
|
-
# accounts from removing or deleting objects from your bucket, you
|
13807
|
-
# must deny them permissions for the following actions:
|
14141
|
+
# * `s3:DeleteObjectVersion`
|
13808
14142
|
#
|
13809
|
-
#
|
14143
|
+
# * `s3:PutLifecycleConfiguration`
|
14144
|
+
#
|
14145
|
+
# For more information about permissions, see [Managing Access
|
14146
|
+
# Permissions to Your Amazon S3 Resources][5].
|
14147
|
+
# ^
|
13810
14148
|
#
|
13811
|
-
# *
|
14149
|
+
# * **Directory bucket permissions** - You must have the
|
14150
|
+
# `s3express:PutLifecycleConfiguration` permission in an IAM
|
14151
|
+
# identity-based policy to use this operation. Cross-account access
|
14152
|
+
# to this API operation isn't supported. The resource owner can
|
14153
|
+
# optionally grant access permissions to others by creating a role
|
14154
|
+
# or user for them as long as they are within the same account as
|
14155
|
+
# the owner and resource.
|
14156
|
+
#
|
14157
|
+
# For more information about directory bucket policies and
|
14158
|
+
# permissions, see [Authorizing Regional endpoint APIs with IAM][6]
|
14159
|
+
# in the *Amazon S3 User Guide*.
|
13812
14160
|
#
|
13813
|
-
#
|
14161
|
+
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
14162
|
+
# requests for this API operation to the Regional endpoint. These
|
14163
|
+
# endpoints support path-style requests in the format
|
14164
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name
|
14165
|
+
# `. Virtual-hosted-style requests aren't supported. For more
|
14166
|
+
# information about endpoints in Availability Zones, see [Regional
|
14167
|
+
# and Zonal endpoints for directory buckets in Availability
|
14168
|
+
# Zones][7] in the *Amazon S3 User Guide*. For more information
|
14169
|
+
# about endpoints in Local Zones, see [Available Local Zone for
|
14170
|
+
# directory buckets][8] in the *Amazon S3 User Guide*.
|
13814
14171
|
#
|
13815
|
-
#
|
13816
|
-
# Permissions to Your Amazon S3 Resources][5].
|
14172
|
+
# </note>
|
13817
14173
|
#
|
13818
|
-
# The
|
13819
|
-
#
|
14174
|
+
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
14175
|
+
# `s3express-control.region.amazonaws.com`.
|
13820
14176
|
#
|
13821
|
-
#
|
14177
|
+
# The following operations are related to
|
14178
|
+
# `PutBucketLifecycleConfiguration`:
|
13822
14179
|
#
|
13823
|
-
#
|
14180
|
+
# * [GetBucketLifecycleConfiguration][9]
|
13824
14181
|
#
|
13825
|
-
#
|
14182
|
+
# * [DeleteBucketLifecycle][10]
|
13826
14183
|
#
|
13827
14184
|
#
|
13828
14185
|
#
|
@@ -13831,9 +14188,11 @@ module Aws::S3
|
|
13831
14188
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
13832
14189
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
|
13833
14190
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
13834
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13835
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13836
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14191
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
14192
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
14193
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
14194
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
14195
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
13837
14196
|
#
|
13838
14197
|
# @option params [required, String] :bucket
|
13839
14198
|
# The name of the bucket for which to set the configuration.
|
@@ -13862,10 +14221,20 @@ module Aws::S3
|
|
13862
14221
|
# you provide does not match the actual owner of the bucket, the request
|
13863
14222
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
13864
14223
|
#
|
14224
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
14225
|
+
# supported for directory bucket lifecycle configurations.
|
14226
|
+
#
|
14227
|
+
# </note>
|
14228
|
+
#
|
13865
14229
|
# @option params [String] :transition_default_minimum_object_size
|
13866
14230
|
# Indicates which default minimum object size behavior is applied to the
|
13867
14231
|
# lifecycle configuration.
|
13868
14232
|
#
|
14233
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
14234
|
+
# supported for directory bucket lifecycle configurations.
|
14235
|
+
#
|
14236
|
+
# </note>
|
14237
|
+
#
|
13869
14238
|
# * `all_storage_classes_128K` - Objects smaller than 128 KB will not
|
13870
14239
|
# transition to any storage class by default.
|
13871
14240
|
#
|
@@ -13989,7 +14358,7 @@ module Aws::S3
|
|
13989
14358
|
req.send_request(options)
|
13990
14359
|
end
|
13991
14360
|
|
13992
|
-
# <note markdown="1"> This operation is not supported
|
14361
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
13993
14362
|
#
|
13994
14363
|
# </note>
|
13995
14364
|
#
|
@@ -14172,7 +14541,7 @@ module Aws::S3
|
|
14172
14541
|
req.send_request(options)
|
14173
14542
|
end
|
14174
14543
|
|
14175
|
-
# <note markdown="1"> This operation is not supported
|
14544
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14176
14545
|
#
|
14177
14546
|
# </note>
|
14178
14547
|
#
|
@@ -14276,7 +14645,7 @@ module Aws::S3
|
|
14276
14645
|
req.send_request(options)
|
14277
14646
|
end
|
14278
14647
|
|
14279
|
-
# <note markdown="1"> This operation is not supported
|
14648
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14280
14649
|
#
|
14281
14650
|
# </note>
|
14282
14651
|
#
|
@@ -14362,7 +14731,7 @@ module Aws::S3
|
|
14362
14731
|
req.send_request(options)
|
14363
14732
|
end
|
14364
14733
|
|
14365
|
-
# <note markdown="1"> This operation is not supported
|
14734
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14366
14735
|
#
|
14367
14736
|
# </note>
|
14368
14737
|
#
|
@@ -14546,7 +14915,7 @@ module Aws::S3
|
|
14546
14915
|
req.send_request(options)
|
14547
14916
|
end
|
14548
14917
|
|
14549
|
-
# <note markdown="1"> This operation is not supported
|
14918
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14550
14919
|
#
|
14551
14920
|
# </note>
|
14552
14921
|
#
|
@@ -14620,9 +14989,13 @@ module Aws::S3
|
|
14620
14989
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
14621
14990
|
# requests for this API operation to the Regional endpoint. These
|
14622
14991
|
# endpoints support path-style requests in the format
|
14623
|
-
# `https://s3express-control.
|
14624
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
14625
|
-
#
|
14992
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
14993
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
14994
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
14995
|
+
# endpoints for directory buckets in Availability Zones][1] in the
|
14996
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
14997
|
+
# Zones, see [Available Local Zone for directory buckets][2] in the
|
14998
|
+
# *Amazon S3 User Guide*.
|
14626
14999
|
#
|
14627
15000
|
# </note>
|
14628
15001
|
#
|
@@ -14652,7 +15025,7 @@ module Aws::S3
|
|
14652
15025
|
# * **General purpose bucket permissions** - The `s3:PutBucketPolicy`
|
14653
15026
|
# permission is required in a policy. For more information about
|
14654
15027
|
# general purpose buckets bucket policies, see [Using Bucket
|
14655
|
-
# Policies and User Policies][
|
15028
|
+
# Policies and User Policies][3] in the *Amazon S3 User Guide*.
|
14656
15029
|
#
|
14657
15030
|
# * **Directory bucket permissions** - To grant access to this API
|
14658
15031
|
# operation, you must have the `s3express:PutBucketPolicy`
|
@@ -14662,49 +15035,51 @@ module Aws::S3
|
|
14662
15035
|
# Services account that owns the resource. For more information
|
14663
15036
|
# about directory bucket policies and permissions, see [Amazon Web
|
14664
15037
|
# Services Identity and Access Management (IAM) for S3 Express One
|
14665
|
-
# Zone][
|
15038
|
+
# Zone][4] in the *Amazon S3 User Guide*.
|
14666
15039
|
#
|
14667
15040
|
# Example bucket policies
|
14668
15041
|
#
|
14669
15042
|
# : **General purpose buckets example bucket policies** - See [Bucket
|
14670
|
-
# policy examples][
|
15043
|
+
# policy examples][5] in the *Amazon S3 User Guide*.
|
14671
15044
|
#
|
14672
15045
|
# **Directory bucket example bucket policies** - See [Example bucket
|
14673
|
-
# policies for S3 Express One Zone][
|
15046
|
+
# policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
|
14674
15047
|
#
|
14675
15048
|
# HTTP Host header syntax
|
14676
15049
|
#
|
14677
15050
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
14678
|
-
# `s3express-control.region.amazonaws.com`.
|
15051
|
+
# `s3express-control.region-code.amazonaws.com`.
|
14679
15052
|
#
|
14680
15053
|
# The following operations are related to `PutBucketPolicy`:
|
14681
15054
|
#
|
14682
|
-
# * [CreateBucket][
|
15055
|
+
# * [CreateBucket][7]
|
14683
15056
|
#
|
14684
|
-
# * [DeleteBucket][
|
15057
|
+
# * [DeleteBucket][8]
|
14685
15058
|
#
|
14686
15059
|
#
|
14687
15060
|
#
|
14688
15061
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
14689
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14690
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14691
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
14692
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
14693
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14694
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
15062
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
15063
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
15064
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
15065
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
|
15066
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
15067
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
15068
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
14695
15069
|
#
|
14696
15070
|
# @option params [required, String] :bucket
|
14697
15071
|
# The name of the bucket.
|
14698
15072
|
#
|
14699
15073
|
# <b>Directory buckets </b> - When you use this operation with a
|
14700
15074
|
# directory bucket, you must use path-style requests in the format
|
14701
|
-
# `https://s3express-control.
|
15075
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
14702
15076
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
14703
|
-
# names must be unique in the chosen Availability Zone
|
14704
|
-
# must also follow the format `
|
14705
|
-
#
|
14706
|
-
#
|
14707
|
-
#
|
15077
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
15078
|
+
# Zone). Bucket names must also follow the format `
|
15079
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
15080
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
15081
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
15082
|
+
# *Amazon S3 User Guide*
|
14708
15083
|
#
|
14709
15084
|
#
|
14710
15085
|
#
|
@@ -14815,7 +15190,7 @@ module Aws::S3
|
|
14815
15190
|
req.send_request(options)
|
14816
15191
|
end
|
14817
15192
|
|
14818
|
-
# <note markdown="1"> This operation is not supported
|
15193
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14819
15194
|
#
|
14820
15195
|
# </note>
|
14821
15196
|
#
|
@@ -15053,7 +15428,7 @@ module Aws::S3
|
|
15053
15428
|
req.send_request(options)
|
15054
15429
|
end
|
15055
15430
|
|
15056
|
-
# <note markdown="1"> This operation is not supported
|
15431
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
15057
15432
|
#
|
15058
15433
|
# </note>
|
15059
15434
|
#
|
@@ -15150,7 +15525,7 @@ module Aws::S3
|
|
15150
15525
|
req.send_request(options)
|
15151
15526
|
end
|
15152
15527
|
|
15153
|
-
# <note markdown="1"> This operation is not supported
|
15528
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
15154
15529
|
#
|
15155
15530
|
# </note>
|
15156
15531
|
#
|
@@ -15301,15 +15676,17 @@ module Aws::S3
|
|
15301
15676
|
req.send_request(options)
|
15302
15677
|
end
|
15303
15678
|
|
15304
|
-
# <note markdown="1"> This operation is not supported
|
15679
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
15305
15680
|
#
|
15306
15681
|
# </note>
|
15307
15682
|
#
|
15308
15683
|
# <note markdown="1"> When you enable versioning on a bucket for the first time, it might
|
15309
|
-
# take a short amount of time for the change to be fully propagated.
|
15310
|
-
#
|
15311
|
-
#
|
15312
|
-
#
|
15684
|
+
# take a short amount of time for the change to be fully propagated.
|
15685
|
+
# While this change is propagating, you may encounter intermittent `HTTP
|
15686
|
+
# 404 NoSuchKey` errors for requests to objects created or updated after
|
15687
|
+
# enabling versioning. We recommend that you wait for 15 minutes after
|
15688
|
+
# enabling versioning before issuing write operations (`PUT` or
|
15689
|
+
# `DELETE`) on objects in the bucket.
|
15313
15690
|
#
|
15314
15691
|
# </note>
|
15315
15692
|
#
|
@@ -15440,7 +15817,7 @@ module Aws::S3
|
|
15440
15817
|
req.send_request(options)
|
15441
15818
|
end
|
15442
15819
|
|
15443
|
-
# <note markdown="1"> This operation is not supported
|
15820
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
15444
15821
|
#
|
15445
15822
|
# </note>
|
15446
15823
|
#
|
@@ -15640,9 +16017,13 @@ module Aws::S3
|
|
15640
16017
|
# * **Directory buckets** - For directory buckets, you must make
|
15641
16018
|
# requests for this API operation to the Zonal endpoint. These
|
15642
16019
|
# endpoints support virtual-hosted-style requests in the format
|
15643
|
-
# `https://
|
15644
|
-
# `. Path-style requests are not supported. For more information
|
15645
|
-
# [Regional and Zonal endpoints
|
16020
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
16021
|
+
# `. Path-style requests are not supported. For more information about
|
16022
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
16023
|
+
# for directory buckets in Availability Zones][1] in the *Amazon S3
|
16024
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
16025
|
+
# see [Available Local Zone for directory buckets][2] in the *Amazon
|
16026
|
+
# S3 User Guide*.
|
15646
16027
|
#
|
15647
16028
|
# </note>
|
15648
16029
|
#
|
@@ -15652,7 +16033,7 @@ module Aws::S3
|
|
15652
16033
|
# modify this behavior:
|
15653
16034
|
#
|
15654
16035
|
# * **S3 Object Lock** - To prevent objects from being deleted or
|
15655
|
-
# overwritten, you can use [Amazon S3 Object Lock][
|
16036
|
+
# overwritten, you can use [Amazon S3 Object Lock][3] in the *Amazon
|
15656
16037
|
# S3 User Guide*.
|
15657
16038
|
#
|
15658
16039
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
@@ -15666,9 +16047,9 @@ module Aws::S3
|
|
15666
16047
|
# automatically generates a unique version ID of that object being
|
15667
16048
|
# stored in Amazon S3. You can retrieve, replace, or delete any
|
15668
16049
|
# version of the object. For more information about versioning, see
|
15669
|
-
# [Adding Objects to Versioning-Enabled Buckets][
|
16050
|
+
# [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
|
15670
16051
|
# User Guide*. For information about returning the versioning state of
|
15671
|
-
# a bucket, see [GetBucketVersioning][
|
16052
|
+
# a bucket, see [GetBucketVersioning][5].
|
15672
16053
|
#
|
15673
16054
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
15674
16055
|
#
|
@@ -15690,10 +16071,9 @@ module Aws::S3
|
|
15690
16071
|
# * <b> <code>s3:PutObjectTagging</code> </b> - To successfully set
|
15691
16072
|
# the tag-set with your `PutObject` request, you must have the
|
15692
16073
|
# `s3:PutObjectTagging`.
|
15693
|
-
#
|
15694
16074
|
# * **Directory bucket permissions** - To grant access to this API
|
15695
16075
|
# operation on a directory bucket, we recommend that you use the [
|
15696
|
-
# `CreateSession` ][
|
16076
|
+
# `CreateSession` ][6] API operation for session-based
|
15697
16077
|
# authorization. Specifically, you grant the
|
15698
16078
|
# `s3express:CreateSession` permission to the directory bucket in a
|
15699
16079
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -15704,7 +16084,7 @@ module Aws::S3
|
|
15704
16084
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
15705
16085
|
# refresh the session token automatically to avoid service
|
15706
16086
|
# interruptions when a session expires. For more information about
|
15707
|
-
# authorization, see [ `CreateSession` ][
|
16087
|
+
# authorization, see [ `CreateSession` ][6].
|
15708
16088
|
#
|
15709
16089
|
# If the object is encrypted with SSE-KMS, you must also have the
|
15710
16090
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -15725,23 +16105,24 @@ module Aws::S3
|
|
15725
16105
|
# HTTP Host header syntax
|
15726
16106
|
#
|
15727
16107
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
15728
|
-
#
|
16108
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
15729
16109
|
#
|
15730
16110
|
# For more information about related Amazon S3 APIs, see the following:
|
15731
16111
|
#
|
15732
|
-
# * [CopyObject][
|
16112
|
+
# * [CopyObject][7]
|
15733
16113
|
#
|
15734
|
-
# * [DeleteObject][
|
16114
|
+
# * [DeleteObject][8]
|
15735
16115
|
#
|
15736
16116
|
#
|
15737
16117
|
#
|
15738
16118
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
15739
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
15740
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
15741
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
15742
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
15743
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
15744
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
16119
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
16120
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
|
16121
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
|
16122
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
16123
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
16124
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
16125
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
15745
16126
|
#
|
15746
16127
|
# @option params [String] :acl
|
15747
16128
|
# The canned ACL to apply to the object. For more information, see
|
@@ -15789,10 +16170,10 @@ module Aws::S3
|
|
15789
16170
|
#
|
15790
16171
|
# **Directory buckets** - When you use this operation with a directory
|
15791
16172
|
# bucket, you must use virtual-hosted-style requests in the format `
|
15792
|
-
#
|
15793
|
-
# are not supported. Directory bucket names must be unique in
|
15794
|
-
# Availability Zone. Bucket names must
|
15795
|
-
#
|
16173
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
16174
|
+
# requests are not supported. Directory bucket names must be unique in
|
16175
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
16176
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
15796
16177
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
15797
16178
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
15798
16179
|
# *Amazon S3 User Guide*.
|
@@ -16000,6 +16381,26 @@ module Aws::S3
|
|
16000
16381
|
#
|
16001
16382
|
# [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
|
16002
16383
|
#
|
16384
|
+
# @option params [String] :if_match
|
16385
|
+
# Uploads the object only if the ETag (entity tag) value provided during
|
16386
|
+
# the WRITE operation matches the ETag of the object in S3. If the ETag
|
16387
|
+
# values do not match, the operation returns a `412 Precondition Failed`
|
16388
|
+
# error.
|
16389
|
+
#
|
16390
|
+
# If a conflicting operation occurs during the upload S3 returns a `409
|
16391
|
+
# ConditionalRequestConflict` response. On a 409 failure you should
|
16392
|
+
# fetch the object's ETag and retry the upload.
|
16393
|
+
#
|
16394
|
+
# Expects the ETag value as a string.
|
16395
|
+
#
|
16396
|
+
# For more information about conditional requests, see [RFC 7232][1], or
|
16397
|
+
# [Conditional requests][2] in the *Amazon S3 User Guide*.
|
16398
|
+
#
|
16399
|
+
#
|
16400
|
+
#
|
16401
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
16402
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
|
16403
|
+
#
|
16003
16404
|
# @option params [String] :if_none_match
|
16004
16405
|
# Uploads the object only if the object key name does not already exist
|
16005
16406
|
# in the bucket specified. Otherwise, Amazon S3 returns a `412
|
@@ -16059,6 +16460,17 @@ module Aws::S3
|
|
16059
16460
|
# @option params [required, String] :key
|
16060
16461
|
# Object key for which the PUT action was initiated.
|
16061
16462
|
#
|
16463
|
+
# @option params [Integer] :write_offset_bytes
|
16464
|
+
# Specifies the offset for appending data to existing objects in bytes.
|
16465
|
+
# The offset must be equal to the size of the existing object being
|
16466
|
+
# appended to. If no object exists, setting this header to 0 will create
|
16467
|
+
# a new object.
|
16468
|
+
#
|
16469
|
+
# <note markdown="1"> This functionality is only supported for objects in the Amazon S3
|
16470
|
+
# Express One Zone storage class in directory buckets.
|
16471
|
+
#
|
16472
|
+
# </note>
|
16473
|
+
#
|
16062
16474
|
# @option params [Hash<String,String>] :metadata
|
16063
16475
|
# A map of metadata to store with the object in S3.
|
16064
16476
|
#
|
@@ -16361,61 +16773,67 @@ module Aws::S3
|
|
16361
16773
|
# * {Types::PutObjectOutput#ssekms_key_id #ssekms_key_id} => String
|
16362
16774
|
# * {Types::PutObjectOutput#ssekms_encryption_context #ssekms_encryption_context} => String
|
16363
16775
|
# * {Types::PutObjectOutput#bucket_key_enabled #bucket_key_enabled} => Boolean
|
16776
|
+
# * {Types::PutObjectOutput#size #size} => Integer
|
16364
16777
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
16365
16778
|
#
|
16366
16779
|
#
|
16367
|
-
# @example Example: To
|
16780
|
+
# @example Example: To upload object and specify user-defined metadata
|
16368
16781
|
#
|
16369
|
-
# # The following example creates an object.
|
16782
|
+
# # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
|
16783
|
+
# # enabled, S3 returns version ID in response.
|
16370
16784
|
#
|
16371
16785
|
# resp = client.put_object({
|
16372
16786
|
# body: "filetoupload",
|
16373
16787
|
# bucket: "examplebucket",
|
16374
|
-
# key: "
|
16788
|
+
# key: "exampleobject",
|
16789
|
+
# metadata: {
|
16790
|
+
# "metadata1" => "value1",
|
16791
|
+
# "metadata2" => "value2",
|
16792
|
+
# },
|
16375
16793
|
# })
|
16376
16794
|
#
|
16377
16795
|
# resp.to_h outputs the following:
|
16378
16796
|
# {
|
16379
16797
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16380
|
-
# version_id: "
|
16798
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
16381
16799
|
# }
|
16382
16800
|
#
|
16383
|
-
# @example Example: To upload object and specify
|
16801
|
+
# @example Example: To upload an object and specify optional tags
|
16384
16802
|
#
|
16385
|
-
# # The following example
|
16386
|
-
# #
|
16803
|
+
# # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
|
16804
|
+
# # S3 returns version ID of the newly created object.
|
16387
16805
|
#
|
16388
16806
|
# resp = client.put_object({
|
16389
|
-
# body: "
|
16807
|
+
# body: "c:\\HappyFace.jpg",
|
16390
16808
|
# bucket: "examplebucket",
|
16391
|
-
# key: "
|
16392
|
-
#
|
16393
|
-
# "metadata1" => "value1",
|
16394
|
-
# "metadata2" => "value2",
|
16395
|
-
# },
|
16809
|
+
# key: "HappyFace.jpg",
|
16810
|
+
# tagging: "key1=value1&key2=value2",
|
16396
16811
|
# })
|
16397
16812
|
#
|
16398
16813
|
# resp.to_h outputs the following:
|
16399
16814
|
# {
|
16400
16815
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16401
|
-
# version_id: "
|
16816
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
16402
16817
|
# }
|
16403
16818
|
#
|
16404
|
-
# @example Example: To upload an object
|
16819
|
+
# @example Example: To upload an object (specify optional headers)
|
16405
16820
|
#
|
16406
|
-
# # The following example uploads an object
|
16407
|
-
# #
|
16821
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
16822
|
+
# # storage class and use server-side encryption.
|
16408
16823
|
#
|
16409
16824
|
# resp = client.put_object({
|
16410
16825
|
# body: "HappyFace.jpg",
|
16411
16826
|
# bucket: "examplebucket",
|
16412
16827
|
# key: "HappyFace.jpg",
|
16828
|
+
# server_side_encryption: "AES256",
|
16829
|
+
# storage_class: "STANDARD_IA",
|
16413
16830
|
# })
|
16414
16831
|
#
|
16415
16832
|
# resp.to_h outputs the following:
|
16416
16833
|
# {
|
16417
16834
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16418
|
-
#
|
16835
|
+
# server_side_encryption: "AES256",
|
16836
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
16419
16837
|
# }
|
16420
16838
|
#
|
16421
16839
|
# @example Example: To upload an object and specify canned ACL.
|
@@ -16436,62 +16854,57 @@ module Aws::S3
|
|
16436
16854
|
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
16437
16855
|
# }
|
16438
16856
|
#
|
16439
|
-
# @example Example: To upload an object
|
16857
|
+
# @example Example: To upload an object
|
16440
16858
|
#
|
16441
|
-
# # The following example uploads an object
|
16442
|
-
# #
|
16859
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
16860
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
16443
16861
|
#
|
16444
16862
|
# resp = client.put_object({
|
16445
16863
|
# body: "HappyFace.jpg",
|
16446
16864
|
# bucket: "examplebucket",
|
16447
16865
|
# key: "HappyFace.jpg",
|
16448
|
-
# server_side_encryption: "AES256",
|
16449
|
-
# storage_class: "STANDARD_IA",
|
16450
16866
|
# })
|
16451
16867
|
#
|
16452
16868
|
# resp.to_h outputs the following:
|
16453
16869
|
# {
|
16454
16870
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16455
|
-
#
|
16456
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
16871
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
16457
16872
|
# }
|
16458
16873
|
#
|
16459
|
-
# @example Example: To upload an object and specify
|
16874
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
16460
16875
|
#
|
16461
|
-
# # The following example uploads an object. The request specifies optional
|
16462
|
-
# # S3 returns version ID
|
16876
|
+
# # The following example uploads an object. The request specifies the optional server-side encryption option. The request
|
16877
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
16463
16878
|
#
|
16464
16879
|
# resp = client.put_object({
|
16465
|
-
# body: "
|
16880
|
+
# body: "filetoupload",
|
16466
16881
|
# bucket: "examplebucket",
|
16467
|
-
# key: "
|
16882
|
+
# key: "exampleobject",
|
16883
|
+
# server_side_encryption: "AES256",
|
16468
16884
|
# tagging: "key1=value1&key2=value2",
|
16469
16885
|
# })
|
16470
16886
|
#
|
16471
16887
|
# resp.to_h outputs the following:
|
16472
16888
|
# {
|
16473
16889
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16474
|
-
#
|
16890
|
+
# server_side_encryption: "AES256",
|
16891
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
16475
16892
|
# }
|
16476
16893
|
#
|
16477
|
-
# @example Example: To
|
16894
|
+
# @example Example: To create an object.
|
16478
16895
|
#
|
16479
|
-
# # The following example
|
16480
|
-
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
16896
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
16481
16897
|
#
|
16482
16898
|
# resp = client.put_object({
|
16483
16899
|
# body: "filetoupload",
|
16484
16900
|
# bucket: "examplebucket",
|
16485
|
-
# key: "
|
16486
|
-
# server_side_encryption: "AES256",
|
16487
|
-
# tagging: "key1=value1&key2=value2",
|
16901
|
+
# key: "objectkey",
|
16488
16902
|
# })
|
16489
16903
|
#
|
16490
16904
|
# resp.to_h outputs the following:
|
16491
16905
|
# {
|
16492
16906
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16493
|
-
#
|
16494
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
16907
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
16495
16908
|
# }
|
16496
16909
|
#
|
16497
16910
|
# @example Streaming a file from disk
|
@@ -16519,12 +16932,14 @@ module Aws::S3
|
|
16519
16932
|
# checksum_sha1: "ChecksumSHA1",
|
16520
16933
|
# checksum_sha256: "ChecksumSHA256",
|
16521
16934
|
# expires: Time.now,
|
16935
|
+
# if_match: "IfMatch",
|
16522
16936
|
# if_none_match: "IfNoneMatch",
|
16523
16937
|
# grant_full_control: "GrantFullControl",
|
16524
16938
|
# grant_read: "GrantRead",
|
16525
16939
|
# grant_read_acp: "GrantReadACP",
|
16526
16940
|
# grant_write_acp: "GrantWriteACP",
|
16527
16941
|
# key: "ObjectKey", # required
|
16942
|
+
# write_offset_bytes: 1,
|
16528
16943
|
# metadata: {
|
16529
16944
|
# "MetadataKey" => "MetadataValue",
|
16530
16945
|
# },
|
@@ -16560,6 +16975,7 @@ module Aws::S3
|
|
16560
16975
|
# resp.ssekms_key_id #=> String
|
16561
16976
|
# resp.ssekms_encryption_context #=> String
|
16562
16977
|
# resp.bucket_key_enabled #=> Boolean
|
16978
|
+
# resp.size #=> Integer
|
16563
16979
|
# resp.request_charged #=> String, one of "requester"
|
16564
16980
|
#
|
16565
16981
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject AWS API Documentation
|
@@ -16571,7 +16987,7 @@ module Aws::S3
|
|
16571
16987
|
req.send_request(options)
|
16572
16988
|
end
|
16573
16989
|
|
16574
|
-
# <note markdown="1"> This operation is not supported
|
16990
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
16575
16991
|
#
|
16576
16992
|
# </note>
|
16577
16993
|
#
|
@@ -16655,7 +17071,6 @@ module Aws::S3
|
|
16655
17071
|
# General Reference.
|
16656
17072
|
#
|
16657
17073
|
# </note>
|
16658
|
-
#
|
16659
17074
|
# For example, the following `x-amz-grant-read` header grants list
|
16660
17075
|
# objects permission to the two Amazon Web Services accounts
|
16661
17076
|
# identified by their email addresses.
|
@@ -16941,7 +17356,7 @@ module Aws::S3
|
|
16941
17356
|
req.send_request(options)
|
16942
17357
|
end
|
16943
17358
|
|
16944
|
-
# <note markdown="1"> This operation is not supported
|
17359
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
16945
17360
|
#
|
16946
17361
|
# </note>
|
16947
17362
|
#
|
@@ -17060,7 +17475,7 @@ module Aws::S3
|
|
17060
17475
|
req.send_request(options)
|
17061
17476
|
end
|
17062
17477
|
|
17063
|
-
# <note markdown="1"> This operation is not supported
|
17478
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17064
17479
|
#
|
17065
17480
|
# </note>
|
17066
17481
|
#
|
@@ -17179,7 +17594,7 @@ module Aws::S3
|
|
17179
17594
|
req.send_request(options)
|
17180
17595
|
end
|
17181
17596
|
|
17182
|
-
# <note markdown="1"> This operation is not supported
|
17597
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17183
17598
|
#
|
17184
17599
|
# </note>
|
17185
17600
|
#
|
@@ -17308,7 +17723,7 @@ module Aws::S3
|
|
17308
17723
|
req.send_request(options)
|
17309
17724
|
end
|
17310
17725
|
|
17311
|
-
# <note markdown="1"> This operation is not supported
|
17726
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17312
17727
|
#
|
17313
17728
|
# </note>
|
17314
17729
|
#
|
@@ -17507,7 +17922,7 @@ module Aws::S3
|
|
17507
17922
|
req.send_request(options)
|
17508
17923
|
end
|
17509
17924
|
|
17510
|
-
# <note markdown="1"> This operation is not supported
|
17925
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17511
17926
|
#
|
17512
17927
|
# </note>
|
17513
17928
|
#
|
@@ -17615,7 +18030,7 @@ module Aws::S3
|
|
17615
18030
|
req.send_request(options)
|
17616
18031
|
end
|
17617
18032
|
|
17618
|
-
# <note markdown="1"> This operation is not supported
|
18033
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
17619
18034
|
#
|
17620
18035
|
# </note>
|
17621
18036
|
#
|
@@ -17761,7 +18176,6 @@ module Aws::S3
|
|
17761
18176
|
# * *HTTP Status Code: 409 Conflict*
|
17762
18177
|
#
|
17763
18178
|
# * *SOAP Fault Code Prefix: Client*
|
17764
|
-
#
|
17765
18179
|
# * * *Code: GlacierExpeditedRetrievalNotAvailable*
|
17766
18180
|
#
|
17767
18181
|
# * *Cause: expedited retrievals are currently not available. Try
|
@@ -18000,7 +18414,7 @@ module Aws::S3
|
|
18000
18414
|
req.send_request(options)
|
18001
18415
|
end
|
18002
18416
|
|
18003
|
-
# <note markdown="1"> This operation is not supported
|
18417
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
18004
18418
|
#
|
18005
18419
|
# </note>
|
18006
18420
|
#
|
@@ -18454,9 +18868,13 @@ module Aws::S3
|
|
18454
18868
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
18455
18869
|
# for this API operation to the Zonal endpoint. These endpoints support
|
18456
18870
|
# virtual-hosted-style requests in the format
|
18457
|
-
# `https://
|
18458
|
-
# Path-style requests are not supported. For more information
|
18459
|
-
# [Regional and Zonal endpoints
|
18871
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
18872
|
+
# `. Path-style requests are not supported. For more information about
|
18873
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
18874
|
+
# directory buckets in Availability Zones][5] in the *Amazon S3 User
|
18875
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
18876
|
+
# [Available Local Zone for directory buckets][6] in the *Amazon S3 User
|
18877
|
+
# Guide*.
|
18460
18878
|
#
|
18461
18879
|
# </note>
|
18462
18880
|
#
|
@@ -18473,15 +18891,15 @@ module Aws::S3
|
|
18473
18891
|
# These permissions are required because Amazon S3 must decrypt and
|
18474
18892
|
# read data from the encrypted file parts before it completes the
|
18475
18893
|
# multipart upload. For more information about KMS permissions, see
|
18476
|
-
# [Protecting data using server-side encryption with KMS][
|
18894
|
+
# [Protecting data using server-side encryption with KMS][7] in the
|
18477
18895
|
# *Amazon S3 User Guide*. For information about the permissions
|
18478
18896
|
# required to use the multipart upload API, see [Multipart upload
|
18479
|
-
# and permissions][
|
18897
|
+
# and permissions][8] and [Multipart upload API and permissions][9]
|
18480
18898
|
# in the *Amazon S3 User Guide*.
|
18481
18899
|
#
|
18482
18900
|
# * **Directory bucket permissions** - To grant access to this API
|
18483
18901
|
# operation on a directory bucket, we recommend that you use the [
|
18484
|
-
# `CreateSession` ][
|
18902
|
+
# `CreateSession` ][10] API operation for session-based
|
18485
18903
|
# authorization. Specifically, you grant the
|
18486
18904
|
# `s3express:CreateSession` permission to the directory bucket in a
|
18487
18905
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -18492,7 +18910,7 @@ module Aws::S3
|
|
18492
18910
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
18493
18911
|
# refresh the session token automatically to avoid service
|
18494
18912
|
# interruptions when a session expires. For more information about
|
18495
|
-
# authorization, see [ `CreateSession` ][
|
18913
|
+
# authorization, see [ `CreateSession` ][10].
|
18496
18914
|
#
|
18497
18915
|
# If the object is encrypted with SSE-KMS, you must also have the
|
18498
18916
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -18508,7 +18926,7 @@ module Aws::S3
|
|
18508
18926
|
# then Amazon Web Services S3 uses the `x-amz-content-sha256` header
|
18509
18927
|
# as a checksum instead of `Content-MD5`. For more information see
|
18510
18928
|
# [Authenticating Requests: Using the Authorization Header (Amazon Web
|
18511
|
-
# Services Signature Version 4)][
|
18929
|
+
# Services Signature Version 4)][11].
|
18512
18930
|
#
|
18513
18931
|
# <note markdown="1"> **Directory buckets** - MD5 is not supported by directory buckets.
|
18514
18932
|
# You can use checksum algorithms to check object integrity.
|
@@ -18548,8 +18966,7 @@ module Aws::S3
|
|
18548
18966
|
# * x-amz-server-side-encryption-customer-key
|
18549
18967
|
#
|
18550
18968
|
# * x-amz-server-side-encryption-customer-key-MD5
|
18551
|
-
#
|
18552
|
-
# For more information, see [Using Server-Side Encryption][11] in
|
18969
|
+
# For more information, see [Using Server-Side Encryption][12] in
|
18553
18970
|
# the *Amazon S3 User Guide*.
|
18554
18971
|
#
|
18555
18972
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
@@ -18571,19 +18988,19 @@ module Aws::S3
|
|
18571
18988
|
# HTTP Host header syntax
|
18572
18989
|
#
|
18573
18990
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
18574
|
-
#
|
18991
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
18575
18992
|
#
|
18576
18993
|
# The following operations are related to `UploadPart`:
|
18577
18994
|
#
|
18578
18995
|
# * [CreateMultipartUpload][2]
|
18579
18996
|
#
|
18580
|
-
# * [CompleteMultipartUpload][
|
18997
|
+
# * [CompleteMultipartUpload][13]
|
18581
18998
|
#
|
18582
|
-
# * [AbortMultipartUpload][
|
18999
|
+
# * [AbortMultipartUpload][14]
|
18583
19000
|
#
|
18584
|
-
# * [ListParts][
|
19001
|
+
# * [ListParts][15]
|
18585
19002
|
#
|
18586
|
-
# * [ListMultipartUploads][
|
19003
|
+
# * [ListMultipartUploads][16]
|
18587
19004
|
#
|
18588
19005
|
#
|
18589
19006
|
#
|
@@ -18592,16 +19009,17 @@ module Aws::S3
|
|
18592
19009
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
|
18593
19010
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
18594
19011
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
18595
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
18596
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
18597
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/
|
18598
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/
|
18599
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
18600
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/
|
18601
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
18602
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
18603
|
-
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
18604
|
-
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
19012
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
19013
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
|
19014
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
19015
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
19016
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
19017
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
|
19018
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
19019
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
19020
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
19021
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
19022
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
18605
19023
|
#
|
18606
19024
|
# @option params [String, StringIO, File] :body
|
18607
19025
|
# Object data.
|
@@ -18611,10 +19029,10 @@ module Aws::S3
|
|
18611
19029
|
#
|
18612
19030
|
# **Directory buckets** - When you use this operation with a directory
|
18613
19031
|
# bucket, you must use virtual-hosted-style requests in the format `
|
18614
|
-
#
|
18615
|
-
# are not supported. Directory bucket names must be unique in
|
18616
|
-
# Availability Zone. Bucket names must
|
18617
|
-
#
|
19032
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
19033
|
+
# requests are not supported. Directory bucket names must be unique in
|
19034
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
19035
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
18618
19036
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
18619
19037
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
18620
19038
|
# *Amazon S3 User Guide*.
|
@@ -18895,9 +19313,13 @@ module Aws::S3
|
|
18895
19313
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
18896
19314
|
# for this API operation to the Zonal endpoint. These endpoints support
|
18897
19315
|
# virtual-hosted-style requests in the format
|
18898
|
-
# `https://
|
18899
|
-
# Path-style requests are not supported. For more information
|
18900
|
-
# [Regional and Zonal endpoints
|
19316
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
19317
|
+
# `. Path-style requests are not supported. For more information about
|
19318
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
19319
|
+
# directory buckets in Availability Zones][5] in the *Amazon S3 User
|
19320
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
19321
|
+
# [Available Local Zone for directory buckets][6] in the *Amazon S3 User
|
19322
|
+
# Guide*.
|
18901
19323
|
#
|
18902
19324
|
# </note>
|
18903
19325
|
#
|
@@ -18907,7 +19329,7 @@ module Aws::S3
|
|
18907
19329
|
# using IAM credentials (access key ID and secret access key for the
|
18908
19330
|
# IAM identities). All headers with the `x-amz-` prefix, including
|
18909
19331
|
# `x-amz-copy-source`, must be signed. For more information, see [REST
|
18910
|
-
# Authentication][
|
19332
|
+
# Authentication][7].
|
18911
19333
|
#
|
18912
19334
|
# **Directory buckets** - You must use IAM credentials to authenticate
|
18913
19335
|
# and authorize your access to the `UploadPartCopy` API operation,
|
@@ -18944,12 +19366,11 @@ module Aws::S3
|
|
18944
19366
|
# permissions are required because Amazon S3 must decrypt and read
|
18945
19367
|
# data from the encrypted file parts before it completes the
|
18946
19368
|
# multipart upload. For more information about KMS permissions,
|
18947
|
-
# see [Protecting data using server-side encryption with KMS][
|
19369
|
+
# see [Protecting data using server-side encryption with KMS][8]
|
18948
19370
|
# in the *Amazon S3 User Guide*. For information about the
|
18949
19371
|
# permissions required to use the multipart upload API, see
|
18950
|
-
# [Multipart upload and permissions][
|
18951
|
-
# and permissions][
|
18952
|
-
#
|
19372
|
+
# [Multipart upload and permissions][9] and [Multipart upload API
|
19373
|
+
# and permissions][10] in the *Amazon S3 User Guide*.
|
18953
19374
|
# * **Directory bucket permissions** - You must have permissions in a
|
18954
19375
|
# bucket policy or an IAM identity-based policy based on the source
|
18955
19376
|
# and destination bucket types in an `UploadPartCopy` operation.
|
@@ -18967,20 +19388,19 @@ module Aws::S3
|
|
18967
19388
|
# `Action` element of a policy to write the object to the
|
18968
19389
|
# destination. The `s3express:SessionMode` condition key cannot be
|
18969
19390
|
# set to `ReadOnly` on the copy destination.
|
18970
|
-
#
|
18971
19391
|
# If the object is encrypted with SSE-KMS, you must also have the
|
18972
19392
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
18973
19393
|
# identity-based policies and KMS key policies for the KMS key.
|
18974
19394
|
#
|
18975
19395
|
# For example policies, see [Example bucket policies for S3 Express
|
18976
|
-
# One Zone][
|
19396
|
+
# One Zone][11] and [Amazon Web Services Identity and Access
|
18977
19397
|
# Management (IAM) identity-based policies for S3 Express One
|
18978
|
-
# Zone][
|
19398
|
+
# Zone][12] in the *Amazon S3 User Guide*.
|
18979
19399
|
#
|
18980
19400
|
# Encryption
|
18981
19401
|
# : * <b>General purpose buckets </b> - For information about using
|
18982
19402
|
# server-side encryption with customer-provided encryption keys with
|
18983
|
-
# the `UploadPartCopy` operation, see [CopyObject][
|
19403
|
+
# the `UploadPartCopy` operation, see [CopyObject][13] and
|
18984
19404
|
# [UploadPart][2].
|
18985
19405
|
#
|
18986
19406
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
@@ -18988,7 +19408,7 @@ module Aws::S3
|
|
18988
19408
|
# encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
|
18989
19409
|
# server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
|
18990
19410
|
# more information, see [Protecting data with server-side
|
18991
|
-
# encryption][
|
19411
|
+
# encryption][14] in the *Amazon S3 User Guide*.
|
18992
19412
|
#
|
18993
19413
|
# <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
|
18994
19414
|
# operation and an `UploadPartCopy` operation, the request headers
|
@@ -19000,7 +19420,7 @@ module Aws::S3
|
|
19000
19420
|
# S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
|
19001
19421
|
# objects from general purpose buckets to directory buckets, from
|
19002
19422
|
# directory buckets to general purpose buckets, or between directory
|
19003
|
-
# buckets, through [UploadPartCopy][
|
19423
|
+
# buckets, through [UploadPartCopy][15]. In this case, Amazon S3
|
19004
19424
|
# makes a call to KMS every time a copy request is made for a
|
19005
19425
|
# KMS-encrypted object.
|
19006
19426
|
#
|
@@ -19012,7 +19432,6 @@ module Aws::S3
|
|
19012
19432
|
# been aborted or completed.
|
19013
19433
|
#
|
19014
19434
|
# * HTTP Status Code: 404 Not Found
|
19015
|
-
#
|
19016
19435
|
# * Error Code: `InvalidRequest`
|
19017
19436
|
#
|
19018
19437
|
# * Description: The specified copy source is not supported as a
|
@@ -19023,21 +19442,21 @@ module Aws::S3
|
|
19023
19442
|
# HTTP Host header syntax
|
19024
19443
|
#
|
19025
19444
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
19026
|
-
#
|
19445
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
19027
19446
|
#
|
19028
19447
|
# The following operations are related to `UploadPartCopy`:
|
19029
19448
|
#
|
19030
|
-
# * [CreateMultipartUpload][
|
19449
|
+
# * [CreateMultipartUpload][16]
|
19031
19450
|
#
|
19032
19451
|
# * [UploadPart][2]
|
19033
19452
|
#
|
19034
|
-
# * [CompleteMultipartUpload][
|
19453
|
+
# * [CompleteMultipartUpload][17]
|
19035
19454
|
#
|
19036
|
-
# * [AbortMultipartUpload][
|
19455
|
+
# * [AbortMultipartUpload][18]
|
19037
19456
|
#
|
19038
|
-
# * [ListParts][
|
19457
|
+
# * [ListParts][19]
|
19039
19458
|
#
|
19040
|
-
# * [ListMultipartUploads][
|
19459
|
+
# * [ListMultipartUploads][20]
|
19041
19460
|
#
|
19042
19461
|
#
|
19043
19462
|
#
|
@@ -19046,34 +19465,43 @@ module Aws::S3
|
|
19046
19465
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
19047
19466
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
|
19048
19467
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
19049
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
19050
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
19051
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/
|
19052
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/
|
19053
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
19054
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-
|
19055
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
19056
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/
|
19057
|
-
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/
|
19058
|
-
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
19059
|
-
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
19060
|
-
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
19061
|
-
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
19062
|
-
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
19468
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
19469
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
19470
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
|
19471
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
19472
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
19473
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
19474
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
19475
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
19476
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
19477
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
19478
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
19479
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
19480
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
19481
|
+
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
19482
|
+
# [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
19063
19483
|
#
|
19064
19484
|
# @option params [required, String] :bucket
|
19065
19485
|
# The bucket name.
|
19066
19486
|
#
|
19067
19487
|
# **Directory buckets** - When you use this operation with a directory
|
19068
19488
|
# bucket, you must use virtual-hosted-style requests in the format `
|
19069
|
-
#
|
19070
|
-
# are not supported. Directory bucket names must be unique in
|
19071
|
-
# Availability Zone. Bucket names must
|
19072
|
-
#
|
19489
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
19490
|
+
# requests are not supported. Directory bucket names must be unique in
|
19491
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
19492
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
19073
19493
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
19074
19494
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
19075
19495
|
# *Amazon S3 User Guide*.
|
19076
19496
|
#
|
19497
|
+
# <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
|
19498
|
+
# supported when the source or destination bucket is in Amazon Web
|
19499
|
+
# Services Local Zones. The source and destination buckets must have the
|
19500
|
+
# same parent Amazon Web Services Region. Otherwise, you get an HTTP
|
19501
|
+
# `400 Bad Request` error with the error code `InvalidRequest`.
|
19502
|
+
#
|
19503
|
+
# </note>
|
19504
|
+
#
|
19077
19505
|
# **Access points** - When you use this action with an access point, you
|
19078
19506
|
# must provide the alias of the access point in place of the bucket name
|
19079
19507
|
# or specify the access point ARN. When using the access point ARN, you
|
@@ -19345,45 +19773,45 @@ module Aws::S3
|
|
19345
19773
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
19346
19774
|
#
|
19347
19775
|
#
|
19348
|
-
# @example Example: To upload a part by copying
|
19776
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
19349
19777
|
#
|
19350
|
-
# # The following example uploads a part of a multipart upload by copying
|
19351
|
-
# # data source.
|
19778
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
19352
19779
|
#
|
19353
19780
|
# resp = client.upload_part_copy({
|
19354
19781
|
# bucket: "examplebucket",
|
19355
19782
|
# copy_source: "/bucketname/sourceobjectkey",
|
19356
|
-
# copy_source_range: "bytes=1-100000",
|
19357
19783
|
# key: "examplelargeobject",
|
19358
|
-
# part_number:
|
19784
|
+
# part_number: 1,
|
19359
19785
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
19360
19786
|
# })
|
19361
19787
|
#
|
19362
19788
|
# resp.to_h outputs the following:
|
19363
19789
|
# {
|
19364
19790
|
# copy_part_result: {
|
19365
|
-
# etag: "\"
|
19366
|
-
# last_modified: Time.parse("2016-12-29T21:
|
19791
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
19792
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
19367
19793
|
# },
|
19368
19794
|
# }
|
19369
19795
|
#
|
19370
|
-
# @example Example: To upload a part by copying
|
19796
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
19371
19797
|
#
|
19372
|
-
# # The following example uploads a part of a multipart upload by copying
|
19798
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
19799
|
+
# # data source.
|
19373
19800
|
#
|
19374
19801
|
# resp = client.upload_part_copy({
|
19375
19802
|
# bucket: "examplebucket",
|
19376
19803
|
# copy_source: "/bucketname/sourceobjectkey",
|
19804
|
+
# copy_source_range: "bytes=1-100000",
|
19377
19805
|
# key: "examplelargeobject",
|
19378
|
-
# part_number:
|
19806
|
+
# part_number: 2,
|
19379
19807
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
19380
19808
|
# })
|
19381
19809
|
#
|
19382
19810
|
# resp.to_h outputs the following:
|
19383
19811
|
# {
|
19384
19812
|
# copy_part_result: {
|
19385
|
-
# etag: "\"
|
19386
|
-
# last_modified: Time.parse("2016-12-29T21:
|
19813
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
19814
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
19387
19815
|
# },
|
19388
19816
|
# }
|
19389
19817
|
#
|
@@ -19436,7 +19864,7 @@ module Aws::S3
|
|
19436
19864
|
req.send_request(options)
|
19437
19865
|
end
|
19438
19866
|
|
19439
|
-
# <note markdown="1"> This operation is not supported
|
19867
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
19440
19868
|
#
|
19441
19869
|
# </note>
|
19442
19870
|
#
|
@@ -19845,7 +20273,7 @@ module Aws::S3
|
|
19845
20273
|
tracer: tracer
|
19846
20274
|
)
|
19847
20275
|
context[:gem_name] = 'aws-sdk-s3'
|
19848
|
-
context[:gem_version] = '1.
|
20276
|
+
context[:gem_version] = '1.175.0'
|
19849
20277
|
Seahorse::Client::Request.new(handlers, context)
|
19850
20278
|
end
|
19851
20279
|
|