aws-sdk-s3 1.169.0 → 1.175.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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 `AbortMultupartUpload` operation to abort all 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://bucket_name.s3express-az_id.region.amazonaws.com/key-name
581
- # `. Path-style requests are not supported. For more information, see
582
- # [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
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][3] in the *Amazon S3 User Guide*.
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` ][4] API operation for session-based
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` ][4].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][5]
617
+ # * [CreateMultipartUpload][6]
614
618
  #
615
- # * [UploadPart][6]
619
+ # * [UploadPart][7]
616
620
  #
617
- # * [CompleteMultipartUpload][7]
621
+ # * [CompleteMultipartUpload][8]
618
622
  #
619
623
  # * [ListParts][1]
620
624
  #
621
- # * [ListMultipartUploads][8]
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/dev/mpuAndPermissions.html
628
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
629
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
630
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
631
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
632
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
640
- # are not supported. Directory bucket names must be unique in the chosen
641
- # Availability Zone. Bucket names must follow the format `
642
- # bucket_base_name--az-id--x-s3` (for example, `
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
796
- # Path-style requests are not supported. For more information, see
797
- # [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
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][6] in the *Amazon S3 User
826
+ # [Multipart Upload and Permissions][7] in the *Amazon S3 User
805
827
  # Guide*.
806
828
  #
807
- # If you provide an [additional checksum value][7] in your
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` ][8] API operation for session-based
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` ][8].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][9]
890
+ # * [CreateMultipartUpload][10]
872
891
  #
873
892
  # * [UploadPart][1]
874
893
  #
875
- # * [AbortMultipartUpload][10]
894
+ # * [AbortMultipartUpload][11]
876
895
  #
877
- # * [ListParts][11]
896
+ # * [ListParts][12]
878
897
  #
879
- # * [ListMultipartUploads][12]
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/dev/mpuAndPermissions.html
889
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
890
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
891
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
892
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
893
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
894
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
902
- # are not supported. Directory bucket names must be unique in the chosen
903
- # Availability Zone. Bucket names must follow the format `
904
- # bucket_base_name--az-id--x-s3` (for example, `
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name
1204
- # `. Path-style requests are not supported. For more information, see
1205
- # [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
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][3] in the
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][4].
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][5].
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][6] and [Amazon Web Services Identity and Access
1325
+ # One Zone][7] and [Amazon Web Services Identity and Access
1282
1326
  # Management (IAM) identity-based policies for S3 Express One
1283
- # Zone][7] in the *Amazon S3 User Guide*.
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][8]. The `200 OK`
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][9].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][10]
1383
+ # * [PutObject][11]
1340
1384
  #
1341
- # * [GetObject][11]
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/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
1348
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
1349
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
1350
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
1351
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
1352
- # [8]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
1353
- # [9]: http://aws.amazon.com/s3/pricing/
1354
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
1355
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
1396
- # are not supported. Directory bucket names must be unique in the chosen
1397
- # Availability Zone. Bucket names must follow the format `
1398
- # bucket_base_name--az-id--x-s3` (for example, `
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.region_code.amazonaws.com/bucket-name `.
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 Zonal endpoints][4] in the *Amazon S3
2258
- # User Guide*.
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 ][5] and [Blocking public access to your
2301
- # Amazon S3 storage ][6] in the *Amazon S3 User Guide*.
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` ][7] API. To use this operation, you
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 ][6] in the *Amazon S3
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][8] in the *Amazon S3
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][9] in the *Amazon
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][10]
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][11]
2397
+ # * [PutObject][12]
2343
2398
  #
2344
- # * [DeleteBucket][12]
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/about-object-ownership.html
2353
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
2354
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
2355
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
2356
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
2357
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
2358
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
2359
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
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.region_code.amazonaws.com/bucket-name `.
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. Bucket names
2380
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
2381
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
2382
- # bucket naming restrictions, see [Directory bucket naming rules][2] in
2383
- # the *Amazon S3 User Guide*
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name
2579
- # `. Path-style requests are not supported. For more information, see
2580
- # [Regional and Zonal endpoints][4] in the *Amazon S3 User Guide*.
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)][5] in the *Amazon S3 User Guide*.
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][6] and [Protecting data
2606
- # using server-side encryption with Amazon Web Services KMS][7] in
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` ][8] API operation for session-based
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` ][8].
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][9] requests must match the headers you used in
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][6] and
2735
+ # information, see [Multipart upload API and permissions][7] and
2676
2736
  # [Protecting data using server-side encryption with Amazon Web
2677
- # Services KMS][7] in the *Amazon S3 User Guide*.
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][10] in the *Amazon S3 User Guide*.
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][7] in the *Amazon S3 User Guide*.
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)][11] in the *Amazon S3 User Guide*.
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][12] in the *Amazon
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][13].
2785
+ # server-side encryption with KMS for new object uploads][14].
2728
2786
  #
2729
- # In the Zonal endpoint API calls (except [CopyObject][14] and
2730
- # [UploadPartCopy][9]) using the REST API, the encryption request
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][14] and [UploadPartCopy][9]), the encryption request
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][15]
2830
+ # * [CompleteMultipartUpload][16]
2773
2831
  #
2774
- # * [AbortMultipartUpload][16]
2832
+ # * [AbortMultipartUpload][17]
2775
2833
  #
2776
- # * [ListParts][17]
2834
+ # * [ListParts][18]
2777
2835
  #
2778
- # * [ListMultipartUploads][18]
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/API/sig-v4-authenticating-requests.html
2787
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
2788
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
2789
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
2790
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
2791
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
2792
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
2793
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
2794
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
2795
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
2796
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
2797
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
2798
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
2799
- # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
2833
- # are not supported. Directory bucket names must be unique in the chosen
2834
- # Availability Zone. Bucket names must follow the format `
2835
- # bucket_base_name--az-id--x-s3` (for example, `
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://bucket_name.s3express-az_id.region.amazonaws.com`.
3533
- # Path-style requests are not supported. For more information, see
3534
- # [Regional and Zonal endpoints][3] in the *Amazon S3 User Guide*.
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][4].
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][5].
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` ][6]. For example policies, see [Example
3561
- # bucket policies for S3 Express One Zone][7] and [Amazon Web Services
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][8] in the *Amazon S3 User Guide*.
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][9] in the *Amazon S3 User Guide*. For more information
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][10].
3650
+ # uploads][11].
3588
3651
  #
3589
- # For [Zonal endpoint (object-level) API operations][11] except
3590
- # [CopyObject][4] and [UploadPartCopy][12], you authenticate and
3591
- # authorize requests through [CreateSession][13] for low latency. To
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][14]). Then, when a session is created for Zonal endpoint API
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][14] is supported per directory bucket
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][15] (`aws/s3`) isn't supported. After you specify SSE-KMS as
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][4] and
3609
- # [UploadPartCopy][12]) using the REST API, you can't override the
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][4] and
3626
- # [UploadPartCopy][12]), it's not supported to override the values of
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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/API/API_CopyObject.html
3642
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
3643
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
3644
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
3645
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
3646
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3647
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
3648
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
3649
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
3650
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
3651
- # [14]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
3652
- # [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
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.region_code.amazonaws.com/bucket-name `.
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 Zonal endpoints][1] in the *Amazon S3
3797
- # User Guide*.
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][2] in the *Amazon S3
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][3]
3889
+ # * [CreateBucket][4]
3823
3890
  #
3824
- # * [DeleteObject][4]
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-express-security-iam.html
3830
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
3831
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
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.region_code.amazonaws.com/bucket-name `.
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. Bucket names
3841
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
3842
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
3843
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
3844
- # the *Amazon S3 User Guide*
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 by directory buckets.
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 by directory buckets.
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.region_code.amazonaws.com/bucket-name `.
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. Bucket names
4080
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
4081
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
4082
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
4083
- # the *Amazon S3 User Guide*
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 by directory buckets.
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 by directory buckets.
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
- # To use this operation, you must have permission to perform the
4261
- # `s3:PutLifecycleConfiguration` action. By default, the bucket owner
4262
- # has this permission and the bucket owner can grant this permission to
4263
- # others.
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
- # There is usually some time lag before lifecycle configuration deletion
4266
- # is fully propagated to all the Amazon S3 systems.
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][1].
4372
+ # Describe Lifecycle Actions][5].
4270
4373
  #
4271
4374
  # Related actions include:
4272
4375
  #
4273
- # * [PutBucketLifecycleConfiguration][2]
4376
+ # * [PutBucketLifecycleConfiguration][6]
4274
4377
  #
4275
- # * [GetBucketLifecycleConfiguration][3]
4378
+ # * [GetBucketLifecycleConfiguration][7]
4276
4379
  #
4277
4380
  #
4278
4381
  #
4279
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
4280
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
4281
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
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 by directory buckets.
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 by directory buckets.
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.region_code.amazonaws.com/bucket-name `.
4444
- # Virtual-hosted-style requests aren't supported. For more information,
4445
- # see [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
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][2] in the *Amazon S3
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][3] in the *Amazon S3 User Guide*.
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][4]
4611
+ # * [CreateBucket][5]
4496
4612
  #
4497
- # * [DeleteObject][5]
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/dev/using-iam-policies.html
4503
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4504
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
4505
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
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.region_code.amazonaws.com/bucket-name `.
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. Bucket names
4515
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
4516
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
4517
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
4518
- # the *Amazon S3 User Guide*
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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. For more information, see [Best practices to
4758
- # consider before deleting an object][1].
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. If the object you want to delete
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
- # <note markdown="1"> * S3 Versioning isn't enabled and supported for directory buckets.
4772
- # For this API operation, only the `null` value of the version ID is
4773
- # supported by directory buckets. You can only specify `null` to the
4774
- # `versionId` query parameter in the request.
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
- # * For directory buckets, you must make requests for this API operation
4777
- # to the Zonal endpoint. These endpoints support virtual-hosted-style
4778
- # requests in the format
4779
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
4780
- # `. Path-style requests are not supported. For more information, see
4781
- # [Regional and Zonal endpoints][4] in the *Amazon S3 User Guide*.
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
- # * MFA delete is not supported by directory buckets.
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
- # * If you want to block users or accounts from removing or deleting
4805
- # objects from your bucket, you must deny them the
4806
- # `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
4807
- # `s3:PutLifeCycleConfiguration` permissions.
4808
- #
4809
- # * **Directory buckets permissions** - To grant access to this API
4810
- # operation on a directory bucket, we recommend that you use the
4811
- # CreateSession API operation for session-based authorization.
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][5]
4976
+ # * [PutObject][9]
4821
4977
  #
4822
4978
  # ^
4823
4979
  #
4824
4980
  #
4825
4981
  #
4826
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjects.html#DeletingObjects-best-practices
4827
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
4828
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
4829
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4830
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
4838
- # are not supported. Directory bucket names must be unique in the chosen
4839
- # Availability Zone. Bucket names must follow the format `
4840
- # bucket_base_name--az-id--x-s3` (for example, `
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 by directory buckets.
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name
5128
- # `. Path-style requests are not supported. For more information, see
5129
- # [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
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][2] in the *Amazon S3
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` ][3] API operation for session-based
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` ][3].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][4]
5411
+ # * [CreateMultipartUpload][5]
5203
5412
  #
5204
- # * [UploadPart][5]
5413
+ # * [UploadPart][6]
5205
5414
  #
5206
- # * [CompleteMultipartUpload][6]
5415
+ # * [CompleteMultipartUpload][7]
5207
5416
  #
5208
- # * [ListParts][7]
5417
+ # * [ListParts][8]
5209
5418
  #
5210
- # * [AbortMultipartUpload][8]
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/dev/Versioning.html#MultiFactorAuthenticationDelete
5216
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
5217
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
5218
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
5219
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
5220
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
5221
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
5229
- # are not supported. Directory bucket names must be unique in the chosen
5230
- # Availability Zone. Bucket names must follow the format `
5231
- # bucket_base_name--az-id--x-s3` (for example, `
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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.region_code.amazonaws.com/bucket-name `.
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. Bucket names
6002
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
6003
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
6004
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
6005
- # the *Amazon S3 User Guide*
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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
- # <note markdown="1"> This operation is not supported by directory buckets.
6335
- #
6336
- # </note>
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
- # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
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. The previous version of the API supported filtering
6342
- # based only on an object key name prefix, which is supported for
6343
- # backward compatibility. For the related API description, see
6344
- # [GetBucketLifecycle][1]. Accordingly, this section describes the
6345
- # latest API. The response describes the new filter element that you can
6346
- # use to specify a filter to select a subset of objects to which the
6347
- # rule applies. If you are using a previous version of the lifecycle
6348
- # configuration, it still works. For the earlier action,
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
- # Returns the lifecycle configuration information set on the bucket. For
6353
- # information about lifecycle configuration, see [Object Lifecycle
6354
- # Management][2].
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
- # To use this operation, you must have permission to perform the
6357
- # `s3:GetLifecycleConfiguration` action. The bucket owner has this
6358
- # permission, by default. The bucket owner can grant this permission to
6359
- # others. For more information about permissions, see [Permissions
6360
- # Related to Bucket Subresource Operations][3] and [Managing Access
6361
- # Permissions to Your Amazon S3 Resources][4].
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][1]
6624
+ # * [GetBucketLifecycle][2]
6377
6625
  #
6378
- # * [PutBucketLifecycle][5]
6626
+ # * [PutBucketLifecycle][7]
6379
6627
  #
6380
- # * [DeleteBucketLifecycle][6]
6628
+ # * [DeleteBucketLifecycle][8]
6381
6629
  #
6382
6630
  #
6383
6631
  #
6384
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
6385
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
6386
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6387
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6388
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
6389
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
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&lt;Types::LifecycleRule&gt;
@@ -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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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.region_code.amazonaws.com/bucket-name `.
7030
- # Virtual-hosted-style requests aren't supported. For more information,
7031
- # see [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
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][2] in the *Amazon S3 User Guide*.
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][3] in the *Amazon S3 User Guide*.
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][4] in the *Amazon S3 User Guide*.
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][5] in the *Amazon S3 User Guide*.
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][6]
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/dev/using-iam-policies.html
7096
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
7097
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
7098
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
7099
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
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.region_code.amazonaws.com/bucket-name `.
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. Bucket names
7109
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
7110
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
7111
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
7112
- # the *Amazon S3 User Guide*
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
7716
- # Path-style requests are not supported. For more information, see
7717
- # [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
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][3] in the
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` ][4] API operation for session-based
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` ][4].
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][5]. Otherwise, this operation returns an
8038
+ # [RestoreObject][6]. Otherwise, this operation returns an
7775
8039
  # `InvalidObjectState` error. For information about restoring archived
7776
- # objects, see [Restoring Archived Objects][6] in the *Amazon S3 User
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][7] in the *Amazon S3 User Guide*.
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][8]
8111
+ # * [ListBuckets][9]
7848
8112
  #
7849
- # * [GetObjectAcl][9]
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/dev/using-with-s3-actions.html
7856
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
7857
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
7858
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
7859
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
7860
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
7861
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
7872
- # are not supported. Directory bucket names must be unique in the chosen
7873
- # Availability Zone. Bucket names must follow the format `
7874
- # bucket_base_name--az-id--x-s3` (for example, `
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("Thu, 09 Oct 2014 22:57:28 GMT"),
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("Thu, 15 Dec 2016 01:19:41 GMT"),
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 by directory buckets.
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
8555
- # Path-style requests are not supported. For more information, see
8556
- # [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
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][2] in the *Amazon S3 User
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` ][3] API operation for session-based
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` ][3].
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)][4] in the *Amazon S3 User
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][5] in the *Amazon S3 User Guide*.
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][6].
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][7].
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][7].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][8]
8956
+ # * [GetObject][9]
8691
8957
  #
8692
- # * [GetObjectAcl][9]
8958
+ # * [GetObjectAcl][10]
8693
8959
  #
8694
- # * [GetObjectLegalHold][10]
8960
+ # * [GetObjectLegalHold][11]
8695
8961
  #
8696
- # * [GetObjectLockConfiguration][11]
8962
+ # * [GetObjectLockConfiguration][12]
8697
8963
  #
8698
- # * [GetObjectRetention][12]
8964
+ # * [GetObjectRetention][13]
8699
8965
  #
8700
- # * [GetObjectTagging][13]
8966
+ # * [GetObjectTagging][14]
8701
8967
  #
8702
- # * [HeadObject][14]
8968
+ # * [HeadObject][15]
8703
8969
  #
8704
- # * [ListParts][15]
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/dev/using-with-s3-actions.html
8710
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
8711
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
8712
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
8713
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
8714
- # [7]: https://tools.ietf.org/html/rfc7232
8715
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
8716
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
8717
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
8718
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
8719
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
8720
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
8721
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
8722
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
8730
- # are not supported. Directory bucket names must be unique in the chosen
8731
- # Availability Zone. Bucket names must follow the format `
8732
- # bucket_base_name--az-id--x-s3` (for example, `
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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&lt;Types::Tag&gt;
9264
9531
  #
9265
9532
  #
9266
- # @example Example: To retrieve tag set of a specific object version
9533
+ # @example Example: To retrieve tag set of an object
9267
9534
  #
9268
- # # The following example retrieves tag set of an object. The request specifies object version.
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: "exampleobject",
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: "Key1",
9281
- # value: "Value1",
9546
+ # key: "Key4",
9547
+ # value: "Value4",
9548
+ # },
9549
+ # {
9550
+ # key: "Key3",
9551
+ # value: "Value3",
9282
9552
  # },
9283
9553
  # ],
9284
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9554
+ # version_id: "null",
9285
9555
  # }
9286
9556
  #
9287
- # @example Example: To retrieve tag set of an object
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: "HappyFace.jpg",
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: "Key4",
9301
- # value: "Value4",
9302
- # },
9303
- # {
9304
- # key: "Key3",
9305
- # value: "Value3",
9571
+ # key: "Key1",
9572
+ # value: "Value1",
9306
9573
  # },
9307
9574
  # ],
9308
- # version_id: "null",
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 by directory buckets.
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 by directory buckets.
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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://bucket_name.s3express-az_id.region.amazonaws.com`.
9574
- # Path-style requests are not supported. For more information, see
9575
- # [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
9593
- # are not supported. Directory bucket names must be unique in the chosen
9594
- # Availability Zone. Bucket names must follow the format `
9595
- # bucket_base_name--az-id--x-s3` (for example, `
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 by
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name
9821
- # `. Path-style requests are not supported. For more information, see
9822
- # [Regional and Zonal endpoints][6] in the *Amazon S3 User Guide*.
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][7]
10103
+ # * [GetObject][8]
9829
10104
  #
9830
- # * [GetObjectAttributes][8]
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/API/API_GetObject.html
9841
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
9849
- # are not supported. Directory bucket names must be unique in the chosen
9850
- # Availability Zone. Bucket names must follow the format `
9851
- # bucket_base_name--az-id--x-s3` (for example, `
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("Thu, 15 Dec 2016 01:19:41 GMT"),
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 have the
10615
- # `s3:ListAllMyBuckets` permission.
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.region_code.amazonaws.com/bucket-name `.
10739
- # Virtual-hosted-style requests aren't supported. For more information,
10740
- # see [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
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][3] in the *Amazon
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-express-security-iam.html
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 `AbortMultupartUpload` operation to abort all the in-progress
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
10853
- # Path-style requests are not supported. For more information, see
10854
- # [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
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][3] in the *Amazon S3 User
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` ][4] API operation for session-based
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` ][4].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][5]
11209
+ # * [CreateMultipartUpload][6]
10904
11210
  #
10905
- # * [UploadPart][6]
11211
+ # * [UploadPart][7]
10906
11212
  #
10907
- # * [CompleteMultipartUpload][7]
11213
+ # * [CompleteMultipartUpload][8]
10908
11214
  #
10909
- # * [ListParts][8]
11215
+ # * [ListParts][9]
10910
11216
  #
10911
- # * [AbortMultipartUpload][9]
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/dev/mpuAndPermissions.html
10918
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
10919
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
10920
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
10921
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
10922
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
10923
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
10931
- # are not supported. Directory bucket names must be unique in the chosen
10932
- # Availability Zone. Bucket names must follow the format `
10933
- # bucket_base_name--az-id--x-s3` (for example, `
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 by directory buckets.
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 by directory buckets.
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11527
- # are not supported. Directory bucket names must be unique in the chosen
11528
- # Availability Zone. Bucket names must follow the format `
11529
- # bucket_base_name--az-id--x-s3` (for example, `
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name
11742
- # `. Path-style requests are not supported. For more information, see
11743
- # [Regional and Zonal endpoints][3] in the *Amazon S3 User Guide*.
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][4] and [Managing Access Permissions
11754
- # to Your Amazon S3 Resources][5] in the *Amazon S3 User Guide*.
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` ][6] API operation for session-based
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` ][6].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][7].
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][8]
12102
+ # * [GetObject][9]
11792
12103
  #
11793
- # * [PutObject][9]
12104
+ # * [PutObject][10]
11794
12105
  #
11795
- # * [CreateBucket][10]
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/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
11803
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
11804
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
11805
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
11806
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
11807
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
11808
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11814
- # are not supported. Directory bucket names must be unique in the chosen
11815
- # Availability Zone. Bucket names must follow the format `
11816
- # bucket_base_name--az-id--x-s3` (for example, `
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
12085
- # Path-style requests are not supported. For more information, see
12086
- # [Regional and Zonal endpoints][3] in the *Amazon S3 User Guide*.
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][4] in the *Amazon S3 User
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` ][5] API operation for session-based
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` ][5].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][6]
12442
+ # * [UploadPart][7]
12127
12443
  #
12128
- # * [CompleteMultipartUpload][7]
12444
+ # * [CompleteMultipartUpload][8]
12129
12445
  #
12130
- # * [AbortMultipartUpload][8]
12446
+ # * [AbortMultipartUpload][9]
12131
12447
  #
12132
- # * [GetObjectAttributes][9]
12448
+ # * [GetObjectAttributes][10]
12133
12449
  #
12134
- # * [ListMultipartUploads][10]
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/dev/mpuAndPermissions.html
12142
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
12143
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
12144
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
12145
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
12146
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
12147
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
12155
- # are not supported. Directory bucket names must be unique in the chosen
12156
- # Availability Zone. Bucket names must follow the format `
12157
- # bucket_base_name--az-id--x-s3` (for example, `
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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.region_code.amazonaws.com/bucket-name `.
13098
- # Virtual-hosted-style requests aren't supported. For more information,
13099
- # see [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
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][2]. For information about the bucket default
13114
- # encryption feature, see [Amazon S3 Bucket Default Encryption][3]
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][3] to SSE-KMS, you should verify that your KMS key ID
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][4].
13450
+ # object uploads][5].
13134
13451
  #
13135
13452
  # * Your SSE-KMS configuration can only support 1 [customer managed
13136
- # key][5] per directory bucket for the lifetime of the bucket. The
13137
- # [Amazon Web Services managed key][6] (`aws/s3`) isn't supported.
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][7], [UploadPartCopy][8], [the Copy operation
13145
- # in Batch Operations][9], or [the import jobs][10]. In this case,
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][5] for encryption
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][3] to SSE-KMS, Amazon S3 validates the
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)][11].
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][12] and [Managing Access Permissions to Your Amazon S3
13176
- # Resources][13] in the *Amazon S3 User Guide*.
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][14] in the *Amazon S3
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][15]
13518
+ # * [GetBucketEncryption][16]
13202
13519
  #
13203
- # * [DeleteBucketEncryption][16]
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/dev/bucket-key.html
13209
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
13210
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
13211
- # [5]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
13212
- # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
13213
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
13214
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
13215
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
13216
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
13217
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
13218
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
13219
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
13220
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
13221
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
13222
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
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.region_code.amazonaws.com/bucket-name `.
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. Bucket names
13233
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
13234
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
13235
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
13236
- # the *Amazon S3 User Guide*
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 by directory buckets.
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 by directory buckets.
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. For the related API
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
- # Permissions
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
- # : By default, all Amazon S3 resources are private, including buckets,
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
- # You can also explicitly deny permissions. An explicit deny also
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
- # * `s3:DeleteObject`
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
- # * `s3:DeleteObjectVersion`
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
- # * `s3:PutLifecycleConfiguration`
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
- # For more information about permissions, see [Managing Access
13816
- # Permissions to Your Amazon S3 Resources][5].
14172
+ # </note>
13817
14173
  #
13818
- # The following operations are related to
13819
- # `PutBucketLifecycleConfiguration`:
14174
+ # : <b>Directory buckets </b> - The HTTP Host header syntax is
14175
+ # `s3express-control.region.amazonaws.com`.
13820
14176
  #
13821
- # * [Examples of Lifecycle Configuration][6]
14177
+ # The following operations are related to
14178
+ # `PutBucketLifecycleConfiguration`:
13822
14179
  #
13823
- # * [GetBucketLifecycleConfiguration][7]
14180
+ # * [GetBucketLifecycleConfiguration][9]
13824
14181
  #
13825
- # * [DeleteBucketLifecycle][8]
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/dev/lifecycle-configuration-examples.html
13835
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
13836
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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.region_code.amazonaws.com/bucket-name `.
14624
- # Virtual-hosted-style requests aren't supported. For more information,
14625
- # see [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
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][2] in the *Amazon S3 User Guide*.
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][3] in the *Amazon S3 User Guide*.
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][4] in the *Amazon S3 User Guide*.
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][5] in the *Amazon S3 User Guide*.
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][6]
15055
+ # * [CreateBucket][7]
14683
15056
  #
14684
- # * [DeleteBucket][7]
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/dev/using-iam-policies.html
14690
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14691
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
14692
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
14693
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
14694
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
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.region_code.amazonaws.com/bucket-name `.
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. Bucket names
14704
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
14705
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
14706
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
14707
- # the *Amazon S3 User Guide*
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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. We
15310
- # recommend that you wait for 15 minutes after enabling versioning
15311
- # before issuing write operations (`PUT` or `DELETE`) on objects in the
15312
- # bucket.
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 by directory buckets.
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name
15644
- # `. Path-style requests are not supported. For more information, see
15645
- # [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
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][2] in the *Amazon
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][3] in the *Amazon S3
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][4].
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` ][5] API operation for session-based
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` ][5].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][6]
16112
+ # * [CopyObject][7]
15733
16113
  #
15734
- # * [DeleteObject][7]
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/object-lock.html
15740
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
15741
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
15742
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
15743
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
15744
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
15793
- # are not supported. Directory bucket names must be unique in the chosen
15794
- # Availability Zone. Bucket names must follow the format `
15795
- # bucket_base_name--az-id--x-s3` (for example, `
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 create an object.
16780
+ # @example Example: To upload object and specify user-defined metadata
16368
16781
  #
16369
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
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: "objectkey",
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: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
16798
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16381
16799
  # }
16382
16800
  #
16383
- # @example Example: To upload object and specify user-defined metadata
16801
+ # @example Example: To upload an object and specify optional tags
16384
16802
  #
16385
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
16386
- # # enabled, S3 returns version ID in response.
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: "filetoupload",
16807
+ # body: "c:\\HappyFace.jpg",
16390
16808
  # bucket: "examplebucket",
16391
- # key: "exampleobject",
16392
- # metadata: {
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: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
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 to a versioning-enabled bucket. The source file is specified using Windows file
16407
- # # syntax. S3 returns VersionId of the newly created object.
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
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
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 (specify optional headers)
16857
+ # @example Example: To upload an object
16440
16858
  #
16441
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
16442
- # # storage class and use server-side encryption.
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
- # server_side_encryption: "AES256",
16456
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16871
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16457
16872
  # }
16458
16873
  #
16459
- # @example Example: To upload an object and specify optional tags
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 object tags. The bucket is versioned, therefore
16462
- # # S3 returns version ID of the newly created object.
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: "c:\\HappyFace.jpg",
16880
+ # body: "filetoupload",
16466
16881
  # bucket: "examplebucket",
16467
- # key: "HappyFace.jpg",
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
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
16890
+ # server_side_encryption: "AES256",
16891
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16475
16892
  # }
16476
16893
  #
16477
- # @example Example: To upload an object and specify server-side encryption and object tags
16894
+ # @example Example: To create an object.
16478
16895
  #
16479
- # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
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: "exampleobject",
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
- # server_side_encryption: "AES256",
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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 by directory buckets.
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
18458
- # Path-style requests are not supported. For more information, see
18459
- # [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
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][6] in the
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][7] and [Multipart upload API and permissions][8]
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` ][9] API operation for session-based
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` ][9].
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)][10].
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][12]
18997
+ # * [CompleteMultipartUpload][13]
18581
18998
  #
18582
- # * [AbortMultipartUpload][13]
18999
+ # * [AbortMultipartUpload][14]
18583
19000
  #
18584
- # * [ListParts][14]
19001
+ # * [ListParts][15]
18585
19002
  #
18586
- # * [ListMultipartUploads][15]
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/UsingKMSEncryption.html
18596
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
18597
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
18598
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
18599
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
18600
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
18601
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
18602
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
18603
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
18604
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
18615
- # are not supported. Directory bucket names must be unique in the chosen
18616
- # Availability Zone. Bucket names must follow the format `
18617
- # bucket_base_name--az-id--x-s3` (for example, `
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://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
18899
- # Path-style requests are not supported. For more information, see
18900
- # [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
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][6].
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][7]
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][8] and [Multipart upload API
18951
- # and permissions][9] in the *Amazon S3 User Guide*.
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][10] and [Amazon Web Services Identity and Access
19396
+ # One Zone][11] and [Amazon Web Services Identity and Access
18977
19397
  # Management (IAM) identity-based policies for S3 Express One
18978
- # Zone][11] in the *Amazon S3 User Guide*.
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][12] and
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][13] in the *Amazon S3 User Guide*.
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][14]. In this case, Amazon S3
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
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][15]
19449
+ # * [CreateMultipartUpload][16]
19031
19450
  #
19032
19451
  # * [UploadPart][2]
19033
19452
  #
19034
- # * [CompleteMultipartUpload][16]
19453
+ # * [CompleteMultipartUpload][17]
19035
19454
  #
19036
- # * [AbortMultipartUpload][17]
19455
+ # * [AbortMultipartUpload][18]
19037
19456
  #
19038
- # * [ListParts][18]
19457
+ # * [ListParts][19]
19039
19458
  #
19040
- # * [ListMultipartUploads][19]
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/dev/RESTAuthentication.html
19050
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19051
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
19052
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
19053
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
19054
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
19055
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
19056
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
19057
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
19058
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
19059
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
19060
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
19061
- # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
19062
- # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
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
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
19070
- # are not supported. Directory bucket names must be unique in the chosen
19071
- # Availability Zone. Bucket names must follow the format `
19072
- # bucket_base_name--az-id--x-s3` (for example, `
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 byte range from an existing object as data source
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 a specified byte range from an existing object as
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: 2,
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: "\"65d16d19e65a7508a51f043180edcc36\"",
19366
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
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 data from an existing object as data source
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 data from an existing object as data source.
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: 1,
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: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
19386
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
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 by directory buckets.
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.169.0'
20276
+ context[:gem_version] = '1.175.0'
19849
20277
  Seahorse::Client::Request.new(handlers, context)
19850
20278
  end
19851
20279