aws-sdk-s3 1.169.0 → 1.175.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|
|