aws-sdk-s3 1.173.0 → 1.175.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (21) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +10 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3/bucket.rb +22 -2
  5. data/lib/aws-sdk-s3/client.rb +969 -722
  6. data/lib/aws-sdk-s3/client_api.rb +2 -0
  7. data/lib/aws-sdk-s3/endpoint_provider.rb +36 -0
  8. data/lib/aws-sdk-s3/multipart_upload.rb +21 -0
  9. data/lib/aws-sdk-s3/object.rb +23 -1
  10. data/lib/aws-sdk-s3/object_summary.rb +20 -0
  11. data/lib/aws-sdk-s3/resource.rb +9 -8
  12. data/lib/aws-sdk-s3/types.rb +247 -116
  13. data/lib/aws-sdk-s3.rb +1 -1
  14. data/sig/bucket.rbs +3 -2
  15. data/sig/client.rbs +5 -3
  16. data/sig/multipart_upload.rbs +1 -0
  17. data/sig/object.rbs +1 -0
  18. data/sig/object_summary.rbs +1 -0
  19. data/sig/resource.rbs +2 -2
  20. data/sig/types.rbs +5 -3
  21. metadata +2 -2
data/lib/aws-sdk-s3/client.rb CHANGED
@@ -577,20 +577,24 @@ module Aws::S3
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*.
@@ -805,19 +810,23 @@ module Aws::S3
805
810
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
806
811
  # for this API operation to the Zonal endpoint. These endpoints support
807
812
  # virtual-hosted-style requests in the format
808
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
809
- # Path-style requests are not supported. For more information, see
810
- # [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*.
811
820
  #
812
821
  # </note>
813
822
  #
814
823
  # Permissions
815
824
  # : * **General purpose bucket permissions** - For information about
816
825
  # permissions required to use the multipart upload API, see
817
- # [Multipart Upload and Permissions][6] in the *Amazon S3 User
826
+ # [Multipart Upload and Permissions][7] in the *Amazon S3 User
818
827
  # Guide*.
819
828
  #
820
- # If you provide an [additional checksum value][7] in your
829
+ # If you provide an [additional checksum value][8] in your
821
830
  # `MultipartUpload` requests and the object is encrypted with Key
822
831
  # Management Service, you must have permission to use the
823
832
  # `kms:Decrypt` action for the `CompleteMultipartUpload` request to
@@ -825,7 +834,7 @@ module Aws::S3
825
834
  #
826
835
  # * **Directory bucket permissions** - To grant access to this API
827
836
  # operation on a directory bucket, we recommend that you use the [
828
- # `CreateSession` ][8] API operation for session-based
837
+ # `CreateSession` ][9] API operation for session-based
829
838
  # authorization. Specifically, you grant the
830
839
  # `s3express:CreateSession` permission to the directory bucket in a
831
840
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -836,7 +845,7 @@ module Aws::S3
836
845
  # token for use. Amazon Web Services CLI or SDKs create session and
837
846
  # refresh the session token automatically to avoid service
838
847
  # interruptions when a session expires. For more information about
839
- # authorization, see [ `CreateSession` ][8].
848
+ # authorization, see [ `CreateSession` ][9].
840
849
  #
841
850
  # If the object is encrypted with SSE-KMS, you must also have the
842
851
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -874,19 +883,19 @@ module Aws::S3
874
883
  # HTTP Host header syntax
875
884
  #
876
885
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
877
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
886
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
878
887
  #
879
888
  # The following operations are related to `CompleteMultipartUpload`:
880
889
  #
881
- # * [CreateMultipartUpload][9]
890
+ # * [CreateMultipartUpload][10]
882
891
  #
883
892
  # * [UploadPart][1]
884
893
  #
885
- # * [AbortMultipartUpload][10]
894
+ # * [AbortMultipartUpload][11]
886
895
  #
887
- # * [ListParts][11]
896
+ # * [ListParts][12]
888
897
  #
889
- # * [ListMultipartUploads][12]
898
+ # * [ListMultipartUploads][13]
890
899
  #
891
900
  #
892
901
  #
@@ -895,23 +904,24 @@ module Aws::S3
895
904
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html
896
905
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
897
906
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
898
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
899
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
900
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
901
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
902
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
903
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
904
- # [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
905
915
  #
906
916
  # @option params [required, String] :bucket
907
917
  # Name of the bucket to which the multipart upload was initiated.
908
918
  #
909
919
  # **Directory buckets** - When you use this operation with a directory
910
920
  # bucket, you must use virtual-hosted-style requests in the format `
911
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
912
- # are not supported. Directory bucket names must be unique in the chosen
913
- # Availability Zone. Bucket names must follow the format `
914
- # 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, `
915
925
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
916
926
  # naming restrictions, see [Directory bucket naming rules][1] in the
917
927
  # *Amazon S3 User Guide*.
@@ -1022,6 +1032,27 @@ module Aws::S3
1022
1032
  # you provide does not match the actual owner of the bucket, the request
1023
1033
  # fails with the HTTP status code `403 Forbidden` (access denied).
1024
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
+ #
1025
1056
  # @option params [String] :if_none_match
1026
1057
  # Uploads the object only if the object key name does not already exist
1027
1058
  # in the bucket specified. Otherwise, Amazon S3 returns a `412
@@ -1157,6 +1188,7 @@ module Aws::S3
1157
1188
  # checksum_sha256: "ChecksumSHA256",
1158
1189
  # request_payer: "requester", # accepts requester
1159
1190
  # expected_bucket_owner: "AccountId",
1191
+ # if_match: "IfMatch",
1160
1192
  # if_none_match: "IfNoneMatch",
1161
1193
  # sse_customer_algorithm: "SSECustomerAlgorithm",
1162
1194
  # sse_customer_key: "SSECustomerKey",
@@ -1210,9 +1242,13 @@ module Aws::S3
1210
1242
  # * <b>Directory buckets </b> - For directory buckets, you must make
1211
1243
  # requests for this API operation to the Zonal endpoint. These
1212
1244
  # endpoints support virtual-hosted-style requests in the format
1213
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
1214
- # `. Path-style requests are not supported. For more information, see
1215
- # [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*.
1216
1252
  #
1217
1253
  # * VPC endpoints don't support cross-Region requests (including
1218
1254
  # copies). If you're using VPC endpoints, your source and destination
@@ -1224,13 +1260,13 @@ module Aws::S3
1224
1260
  # Both the Region that you want to copy the object from and the Region
1225
1261
  # that you want to copy the object to must be enabled for your account.
1226
1262
  # For more information about how to enable a Region for your account,
1227
- # 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
1228
1264
  # *Amazon Web Services Account Management Guide*.
1229
1265
  #
1230
1266
  # Amazon S3 transfer acceleration does not support cross-Region copies.
1231
1267
  # If you request a cross-Region copy using a transfer acceleration
1232
1268
  # endpoint, you get a `400 Bad Request` error. For more information, see
1233
- # [Transfer Acceleration][4].
1269
+ # [Transfer Acceleration][5].
1234
1270
  #
1235
1271
  # Authentication and authorization
1236
1272
  #
@@ -1238,7 +1274,7 @@ module Aws::S3
1238
1274
  # IAM credentials (access key ID and secret access key for the IAM
1239
1275
  # identities). All headers with the `x-amz-` prefix, including
1240
1276
  # `x-amz-copy-source`, must be signed. For more information, see [REST
1241
- # Authentication][5].
1277
+ # Authentication][6].
1242
1278
  #
1243
1279
  # **Directory buckets** - You must use the IAM credentials to
1244
1280
  # authenticate and authorize your access to the `CopyObject` API
@@ -1286,9 +1322,9 @@ module Aws::S3
1286
1322
  # identity-based policies and KMS key policies for the KMS key.
1287
1323
  #
1288
1324
  # For example policies, see [Example bucket policies for S3 Express
1289
- # One Zone][6] and [Amazon Web Services Identity and Access
1325
+ # One Zone][7] and [Amazon Web Services Identity and Access
1290
1326
  # Management (IAM) identity-based policies for S3 Express One
1291
- # Zone][7] in the *Amazon S3 User Guide*.
1327
+ # Zone][8] in the *Amazon S3 User Guide*.
1292
1328
  #
1293
1329
  # Response and special errors
1294
1330
  #
@@ -1311,7 +1347,7 @@ module Aws::S3
1311
1347
  # response is embedded in the `200 OK` response. For example, in a
1312
1348
  # cross-region copy, you may encounter throttling and receive a
1313
1349
  # `200 OK` response. For more information, see [Resolve the Error
1314
- # 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`
1315
1351
  # status code means the copy was accepted, but it doesn't mean
1316
1352
  # the copy is complete. Another example is when you disconnect
1317
1353
  # from Amazon S3 before the copy is complete, Amazon S3 might
@@ -1335,32 +1371,33 @@ module Aws::S3
1335
1371
  # result in a data retrieval charge for the source if the source
1336
1372
  # storage class bills for data retrieval. If the copy source is in a
1337
1373
  # different region, the data transfer is billed to the copy source
1338
- # account. For pricing information, see [Amazon S3 pricing][9].
1374
+ # account. For pricing information, see [Amazon S3 pricing][10].
1339
1375
  #
1340
1376
  # HTTP Host header syntax
1341
1377
  #
1342
1378
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
1343
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
1379
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
1344
1380
  #
1345
1381
  # The following operations are related to `CopyObject`:
1346
1382
  #
1347
- # * [PutObject][10]
1383
+ # * [PutObject][11]
1348
1384
  #
1349
- # * [GetObject][11]
1385
+ # * [GetObject][12]
1350
1386
  #
1351
1387
  #
1352
1388
  #
1353
1389
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
1354
1390
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
1355
- # [3]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
1356
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
1357
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
1358
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
1359
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
1360
- # [8]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
1361
- # [9]: http://aws.amazon.com/s3/pricing/
1362
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
1363
- # [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
1364
1401
  #
1365
1402
  # @option params [String] :acl
1366
1403
  # The canned access control list (ACL) to apply to the object.
@@ -1400,14 +1437,22 @@ module Aws::S3
1400
1437
  #
1401
1438
  # **Directory buckets** - When you use this operation with a directory
1402
1439
  # bucket, you must use virtual-hosted-style requests in the format `
1403
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
1404
- # are not supported. Directory bucket names must be unique in the chosen
1405
- # Availability Zone. Bucket names must follow the format `
1406
- # 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, `
1407
1444
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1408
1445
  # naming restrictions, see [Directory bucket naming rules][1] in the
1409
1446
  # *Amazon S3 User Guide*.
1410
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
+ #
1411
1456
  # **Access points** - When you use this action with an access point, you
1412
1457
  # must provide the alias of the access point in place of the bucket name
1413
1458
  # or specify the access point ARN. When using the access point ARN, you
@@ -2260,10 +2305,13 @@ module Aws::S3
2260
2305
  # * <b>Directory buckets </b> - For directory buckets, you must make
2261
2306
  # requests for this API operation to the Regional endpoint. These
2262
2307
  # endpoints support path-style requests in the format
2263
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
2308
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2264
2309
  # Virtual-hosted-style requests aren't supported. For more
2265
- # information, see [Regional and Zonal endpoints][4] in the *Amazon S3
2266
- # 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*.
2267
2315
  #
2268
2316
  # </note>
2269
2317
  #
@@ -2305,17 +2353,17 @@ module Aws::S3
2305
2353
  # disabled. If you would like to share data with users outside of
2306
2354
  # your account, you can use bucket policies as needed. For more
2307
2355
  # information, see [Controlling ownership of objects and disabling
2308
- # ACLs for your bucket ][5] and [Blocking public access to your
2309
- # 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*.
2310
2358
  #
2311
2359
  # * **S3 Block Public Access** - If your specific use case requires
2312
2360
  # granting public access to your S3 resources, you can disable
2313
2361
  # Block Public Access. Specifically, you can create a new bucket
2314
2362
  # with Block Public Access enabled, then separately call the [
2315
- # `DeletePublicAccessBlock` ][7] API. To use this operation, you
2363
+ # `DeletePublicAccessBlock` ][8] API. To use this operation, you
2316
2364
  # must have the `s3:PutBucketPublicAccessBlock` permission. For
2317
2365
  # more information about S3 Block Public Access, see [Blocking
2318
- # 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
2319
2367
  # User Guide*.
2320
2368
  # * **Directory bucket permissions** - You must have the
2321
2369
  # `s3express:CreateBucket` permission in an IAM identity-based
@@ -2324,7 +2372,7 @@ module Aws::S3
2324
2372
  # performed by the Amazon Web Services account that owns the
2325
2373
  # resource. For more information about directory bucket policies and
2326
2374
  # permissions, see [Amazon Web Services Identity and Access
2327
- # 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
2328
2376
  # User Guide*.
2329
2377
  #
2330
2378
  # The permissions for ACLs, Object Lock, S3 Object Ownership, and S3
@@ -2334,21 +2382,21 @@ module Aws::S3
2334
2382
  # enforced (ACLs disabled). These settings can't be modified.
2335
2383
  #
2336
2384
  # For more information about permissions for creating and working
2337
- # with directory buckets, see [Directory buckets][9] in the *Amazon
2385
+ # with directory buckets, see [Directory buckets][10] in the *Amazon
2338
2386
  # S3 User Guide*. For more information about supported S3 features
2339
- # for directory buckets, see [Features of S3 Express One Zone][10]
2387
+ # for directory buckets, see [Features of S3 Express One Zone][11]
2340
2388
  # in the *Amazon S3 User Guide*.
2341
2389
  #
2342
2390
  # HTTP Host header syntax
2343
2391
  #
2344
2392
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
2345
- # `s3express-control.region.amazonaws.com`.
2393
+ # `s3express-control.region-code.amazonaws.com`.
2346
2394
  #
2347
2395
  # The following operations are related to `CreateBucket`:
2348
2396
  #
2349
- # * [PutObject][11]
2397
+ # * [PutObject][12]
2350
2398
  #
2351
- # * [DeleteBucket][12]
2399
+ # * [DeleteBucket][13]
2352
2400
  #
2353
2401
  #
2354
2402
  #
@@ -2356,14 +2404,15 @@ module Aws::S3
2356
2404
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
2357
2405
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
2358
2406
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2359
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2360
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
2361
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
2362
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
2363
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
2364
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
2365
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
2366
- # [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
2367
2416
  #
2368
2417
  # @option params [String] :acl
2369
2418
  # The canned ACL to apply to the bucket.
@@ -2381,13 +2430,14 @@ module Aws::S3
2381
2430
  #
2382
2431
  # <b>Directory buckets </b> - When you use this operation with a
2383
2432
  # directory bucket, you must use path-style requests in the format
2384
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
2433
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2385
2434
  # Virtual-hosted-style requests aren't supported. Directory bucket
2386
- # names must be unique in the chosen Availability Zone. Bucket names
2387
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
2388
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
2389
- # bucket naming restrictions, see [Directory bucket naming rules][2] in
2390
- # 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*
2391
2441
  #
2392
2442
  #
2393
2443
  #
@@ -2484,33 +2534,33 @@ module Aws::S3
2484
2534
  # * {Types::CreateBucketOutput#location #location} => String
2485
2535
  #
2486
2536
  #
2487
- # @example Example: To create a bucket
2537
+ # @example Example: To create a bucket in a specific region
2488
2538
  #
2489
- # # The following example creates a bucket.
2539
+ # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
2490
2540
  #
2491
2541
  # resp = client.create_bucket({
2492
2542
  # bucket: "examplebucket",
2543
+ # create_bucket_configuration: {
2544
+ # location_constraint: "eu-west-1",
2545
+ # },
2493
2546
  # })
2494
2547
  #
2495
2548
  # resp.to_h outputs the following:
2496
2549
  # {
2497
- # location: "/examplebucket",
2550
+ # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
2498
2551
  # }
2499
2552
  #
2500
- # @example Example: To create a bucket in a specific region
2553
+ # @example Example: To create a bucket
2501
2554
  #
2502
- # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
2555
+ # # The following example creates a bucket.
2503
2556
  #
2504
2557
  # resp = client.create_bucket({
2505
2558
  # bucket: "examplebucket",
2506
- # create_bucket_configuration: {
2507
- # location_constraint: "eu-west-1",
2508
- # },
2509
2559
  # })
2510
2560
  #
2511
2561
  # resp.to_h outputs the following:
2512
2562
  # {
2513
- # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
2563
+ # location: "/examplebucket",
2514
2564
  # }
2515
2565
  #
2516
2566
  # @example Request syntax with placeholder values
@@ -2521,11 +2571,11 @@ module Aws::S3
2521
2571
  # create_bucket_configuration: {
2522
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
2523
2573
  # location: {
2524
- # type: "AvailabilityZone", # accepts AvailabilityZone
2574
+ # type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
2525
2575
  # name: "LocationNameAsString",
2526
2576
  # },
2527
2577
  # bucket: {
2528
- # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone
2578
+ # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
2529
2579
  # type: "Directory", # accepts Directory
2530
2580
  # },
2531
2581
  # },
@@ -2582,9 +2632,13 @@ module Aws::S3
2582
2632
  # * <b>Directory buckets </b> - For directory buckets, you must make
2583
2633
  # requests for this API operation to the Zonal endpoint. These
2584
2634
  # endpoints support virtual-hosted-style requests in the format
2585
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
2586
- # `. Path-style requests are not supported. For more information, see
2587
- # [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*.
2588
2642
  #
2589
2643
  # </note>
2590
2644
  #
@@ -2596,7 +2650,7 @@ module Aws::S3
2596
2650
  # sign each request individually. There is nothing special about
2597
2651
  # signing multipart upload requests. For more information about
2598
2652
  # signing, see [Authenticating Requests (Amazon Web Services Signature
2599
- # Version 4)][5] in the *Amazon S3 User Guide*.
2653
+ # Version 4)][6] in the *Amazon S3 User Guide*.
2600
2654
  #
2601
2655
  # Permissions
2602
2656
  # : * **General purpose bucket permissions** - To perform a multipart
@@ -2609,13 +2663,13 @@ module Aws::S3
2609
2663
  # `UploadPartCopy` APIs. These permissions are required because
2610
2664
  # Amazon S3 must decrypt and read data from the encrypted file parts
2611
2665
  # before it completes the multipart upload. For more information,
2612
- # see [Multipart upload API and permissions][6] and [Protecting data
2613
- # 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
2614
2668
  # the *Amazon S3 User Guide*.
2615
2669
  #
2616
2670
  # * **Directory bucket permissions** - To grant access to this API
2617
2671
  # operation on a directory bucket, we recommend that you use the [
2618
- # `CreateSession` ][8] API operation for session-based
2672
+ # `CreateSession` ][9] API operation for session-based
2619
2673
  # authorization. Specifically, you grant the
2620
2674
  # `s3express:CreateSession` permission to the directory bucket in a
2621
2675
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -2626,7 +2680,7 @@ module Aws::S3
2626
2680
  # token for use. Amazon Web Services CLI or SDKs create session and
2627
2681
  # refresh the session token automatically to avoid service
2628
2682
  # interruptions when a session expires. For more information about
2629
- # authorization, see [ `CreateSession` ][8].
2683
+ # authorization, see [ `CreateSession` ][9].
2630
2684
  #
2631
2685
  # Encryption
2632
2686
  # : * **General purpose buckets** - Server-side encryption is for data
@@ -2653,7 +2707,7 @@ module Aws::S3
2653
2707
  # the destination bucket, the encryption setting in your request
2654
2708
  # takes precedence. If you choose to provide your own encryption
2655
2709
  # key, the request headers you provide in [UploadPart][1] and
2656
- # [UploadPartCopy][9] requests must match the headers you used in
2710
+ # [UploadPartCopy][10] requests must match the headers you used in
2657
2711
  # the `CreateMultipartUpload` request.
2658
2712
  #
2659
2713
  # * Use KMS keys (SSE-KMS) that include the Amazon Web Services
@@ -2678,9 +2732,9 @@ module Aws::S3
2678
2732
  # actions on the key. These permissions are required because
2679
2733
  # Amazon S3 must decrypt and read data from the encrypted file
2680
2734
  # parts before it completes the multipart upload. For more
2681
- # information, see [Multipart upload API and permissions][6] and
2735
+ # information, see [Multipart upload API and permissions][7] and
2682
2736
  # [Protecting data using server-side encryption with Amazon Web
2683
- # Services KMS][7] in the *Amazon S3 User Guide*.
2737
+ # Services KMS][8] in the *Amazon S3 User Guide*.
2684
2738
  #
2685
2739
  # * If your Identity and Access Management (IAM) user or role is
2686
2740
  # in the same Amazon Web Services account as the KMS key, then
@@ -2695,13 +2749,13 @@ module Aws::S3
2695
2749
  # For information about configuring any of the officially
2696
2750
  # supported Amazon Web Services SDKs and Amazon Web Services
2697
2751
  # CLI, see [Specifying the Signature Version in Request
2698
- # Authentication][10] in the *Amazon S3 User Guide*.
2752
+ # Authentication][11] in the *Amazon S3 User Guide*.
2699
2753
  #
2700
2754
  # </note>
2701
2755
  #
2702
2756
  # For more information about server-side encryption with KMS keys
2703
2757
  # (SSE-KMS), see [Protecting Data Using Server-Side Encryption
2704
- # with KMS keys][7] in the *Amazon S3 User Guide*.
2758
+ # with KMS keys][8] in the *Amazon S3 User Guide*.
2705
2759
  #
2706
2760
  # * Use customer-provided encryption keys (SSE-C) – If you want to
2707
2761
  # manage your own encryption keys, provide all the following
@@ -2715,7 +2769,7 @@ module Aws::S3
2715
2769
  # For more information about server-side encryption with
2716
2770
  # customer-provided encryption keys (SSE-C), see [ Protecting data
2717
2771
  # using server-side encryption with customer-provided encryption
2718
- # keys (SSE-C)][11] in the *Amazon S3 User Guide*.
2772
+ # keys (SSE-C)][12] in the *Amazon S3 User Guide*.
2719
2773
  # * **Directory buckets** - For directory buckets, there are only two
2720
2774
  # supported options for server-side encryption: server-side
2721
2775
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
@@ -2725,13 +2779,13 @@ module Aws::S3
2725
2779
  # default encryption in your `CreateSession` requests or `PUT`
2726
2780
  # object requests. Then, new objects are automatically encrypted
2727
2781
  # with the desired encryption settings. For more information, see
2728
- # [Protecting data with server-side encryption][12] in the *Amazon
2782
+ # [Protecting data with server-side encryption][13] in the *Amazon
2729
2783
  # S3 User Guide*. For more information about the encryption
2730
2784
  # overriding behaviors in directory buckets, see [Specifying
2731
- # server-side encryption with KMS for new object uploads][13].
2785
+ # server-side encryption with KMS for new object uploads][14].
2732
2786
  #
2733
- # In the Zonal endpoint API calls (except [CopyObject][14] and
2734
- # [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
2735
2789
  # headers must match the encryption settings that are specified in
2736
2790
  # the `CreateSession` request. You can't override the values of the
2737
2791
  # encryption settings (`x-amz-server-side-encryption`,
@@ -2751,7 +2805,7 @@ module Aws::S3
2751
2805
  # configuration for the `CreateSession` request. It's not supported
2752
2806
  # to override the encryption settings values in the `CreateSession`
2753
2807
  # request. So in the Zonal endpoint API calls (except
2754
- # [CopyObject][14] and [UploadPartCopy][9]), the encryption request
2808
+ # [CopyObject][15] and [UploadPartCopy][10]), the encryption request
2755
2809
  # headers must match the default encryption configuration of the
2756
2810
  # directory bucket.
2757
2811
  #
@@ -2767,19 +2821,19 @@ module Aws::S3
2767
2821
  # HTTP Host header syntax
2768
2822
  #
2769
2823
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
2770
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
2824
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
2771
2825
  #
2772
2826
  # The following operations are related to `CreateMultipartUpload`:
2773
2827
  #
2774
2828
  # * [UploadPart][1]
2775
2829
  #
2776
- # * [CompleteMultipartUpload][15]
2830
+ # * [CompleteMultipartUpload][16]
2777
2831
  #
2778
- # * [AbortMultipartUpload][16]
2832
+ # * [AbortMultipartUpload][17]
2779
2833
  #
2780
- # * [ListParts][17]
2834
+ # * [ListParts][18]
2781
2835
  #
2782
- # * [ListMultipartUploads][18]
2836
+ # * [ListMultipartUploads][19]
2783
2837
  #
2784
2838
  #
2785
2839
  #
@@ -2787,20 +2841,21 @@ module Aws::S3
2787
2841
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
2788
2842
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
2789
2843
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2790
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
2791
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
2792
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
2793
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
2794
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
2795
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
2796
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
2797
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
2798
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
2799
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
2800
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
2801
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
2802
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
2803
- # [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
2804
2859
  #
2805
2860
  # @option params [String] :acl
2806
2861
  # The canned ACL to apply to the object. Amazon S3 supports a set of
@@ -2833,10 +2888,10 @@ module Aws::S3
2833
2888
  #
2834
2889
  # **Directory buckets** - When you use this operation with a directory
2835
2890
  # bucket, you must use virtual-hosted-style requests in the format `
2836
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
2837
- # are not supported. Directory bucket names must be unique in the chosen
2838
- # Availability Zone. Bucket names must follow the format `
2839
- # 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, `
2840
2895
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
2841
2896
  # naming restrictions, see [Directory bucket naming rules][1] in the
2842
2897
  # *Amazon S3 User Guide*.
@@ -3533,23 +3588,27 @@ module Aws::S3
3533
3588
  #
3534
3589
  # <note markdown="1"> * You must make requests for this API operation to the Zonal endpoint.
3535
3590
  # These endpoints support virtual-hosted-style requests in the format
3536
- # `https://bucket_name.s3express-az_id.region.amazonaws.com`.
3537
- # Path-style requests are not supported. For more information, see
3538
- # [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*.
3539
3598
  #
3540
3599
  # * <b> <code>CopyObject</code> API operation</b> - Unlike other Zonal
3541
3600
  # endpoint API operations, the `CopyObject` API operation doesn't use
3542
3601
  # the temporary security credentials returned from the `CreateSession`
3543
3602
  # API operation for authentication and authorization. For information
3544
3603
  # about authentication and authorization of the `CopyObject` API
3545
- # operation on directory buckets, see [CopyObject][4].
3604
+ # operation on directory buckets, see [CopyObject][5].
3546
3605
  #
3547
3606
  # * <b> <code>HeadBucket</code> API operation</b> - Unlike other Zonal
3548
3607
  # endpoint API operations, the `HeadBucket` API operation doesn't use
3549
3608
  # the temporary security credentials returned from the `CreateSession`
3550
3609
  # API operation for authentication and authorization. For information
3551
3610
  # about authentication and authorization of the `HeadBucket` API
3552
- # operation on directory buckets, see [HeadBucket][5].
3611
+ # operation on directory buckets, see [HeadBucket][6].
3553
3612
  #
3554
3613
  # </note>
3555
3614
  #
@@ -3561,10 +3620,10 @@ module Aws::S3
3561
3620
  # can have the `s3express:SessionMode` condition key to control who
3562
3621
  # can create a `ReadWrite` or `ReadOnly` session. For more information
3563
3622
  # about `ReadWrite` or `ReadOnly` sessions, see [
3564
- # `x-amz-create-session-mode` ][6]. For example policies, see [Example
3565
- # 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
3566
3625
  # Identity and Access Management (IAM) identity-based policies for S3
3567
- # Express One Zone][8] in the *Amazon S3 User Guide*.
3626
+ # Express One Zone][9] in the *Amazon S3 User Guide*.
3568
3627
  #
3569
3628
  # To grant cross-account access to Zonal endpoint API operations, the
3570
3629
  # bucket policy should also grant both accounts the
@@ -3585,32 +3644,32 @@ module Aws::S3
3585
3644
  # requests or `PUT` object requests. Then, new objects are
3586
3645
  # automatically encrypted with the desired encryption settings. For
3587
3646
  # more information, see [Protecting data with server-side
3588
- # encryption][9] in the *Amazon S3 User Guide*. For more information
3647
+ # encryption][10] in the *Amazon S3 User Guide*. For more information
3589
3648
  # about the encryption overriding behaviors in directory buckets, see
3590
3649
  # [Specifying server-side encryption with KMS for new object
3591
- # uploads][10].
3650
+ # uploads][11].
3592
3651
  #
3593
- # For [Zonal endpoint (object-level) API operations][11] except
3594
- # [CopyObject][4] and [UploadPartCopy][12], you authenticate and
3595
- # 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
3596
3655
  # encrypt new objects in a directory bucket with SSE-KMS, you must
3597
3656
  # specify SSE-KMS as the directory bucket's default encryption
3598
3657
  # configuration with a KMS key (specifically, a [customer managed
3599
- # 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
3600
3659
  # operations, new objects are automatically encrypted and decrypted
3601
3660
  # with SSE-KMS and S3 Bucket Keys during the session.
3602
3661
  #
3603
- # <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
3604
3663
  # for the lifetime of the bucket. The [Amazon Web Services managed
3605
- # 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
3606
3665
  # your bucket's default encryption configuration with a customer
3607
3666
  # managed key, you can't change the customer managed key for the
3608
3667
  # bucket's SSE-KMS configuration.
3609
3668
  #
3610
3669
  # </note>
3611
3670
  #
3612
- # In the Zonal endpoint API calls (except [CopyObject][4] and
3613
- # [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
3614
3673
  # values of the encryption settings (`x-amz-server-side-encryption`,
3615
3674
  # `x-amz-server-side-encryption-aws-kms-key-id`,
3616
3675
  # `x-amz-server-side-encryption-context`, and
@@ -3626,8 +3685,8 @@ module Aws::S3
3626
3685
  # Web Services SDKs use the bucket's default encryption configuration
3627
3686
  # for the `CreateSession` request. It's not supported to override the
3628
3687
  # encryption settings values in the `CreateSession` request. Also, in
3629
- # the Zonal endpoint API calls (except [CopyObject][4] and
3630
- # [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
3631
3690
  # the encryption settings from the `CreateSession` request.
3632
3691
  #
3633
3692
  # </note>
@@ -3635,25 +3694,26 @@ module Aws::S3
3635
3694
  # HTTP Host header syntax
3636
3695
  #
3637
3696
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
3638
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
3697
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
3639
3698
  #
3640
3699
  #
3641
3700
  #
3642
3701
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
3643
3702
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-optimizing-performance-guidelines-design-patterns.html#s3-express-optimizing-performance-session-authentication
3644
3703
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
3645
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
3646
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
3647
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
3648
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
3649
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
3650
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3651
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
3652
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
3653
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
3654
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
3655
- # [14]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
3656
- # [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
3657
3717
  #
3658
3718
  # @option params [String] :session_mode
3659
3719
  # Specifies the mode of the session that will be created, either
@@ -3795,10 +3855,13 @@ module Aws::S3
3795
3855
  # * <b>Directory buckets </b> - For directory buckets, you must make
3796
3856
  # requests for this API operation to the Regional endpoint. These
3797
3857
  # endpoints support path-style requests in the format
3798
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
3858
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
3799
3859
  # Virtual-hosted-style requests aren't supported. For more
3800
- # information, see [Regional and Zonal endpoints][1] in the *Amazon S3
3801
- # 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*.
3802
3865
  #
3803
3866
  # </note>
3804
3867
  #
@@ -3813,39 +3876,41 @@ module Aws::S3
3813
3876
  # performed by the Amazon Web Services account that owns the
3814
3877
  # resource. For more information about directory bucket policies and
3815
3878
  # permissions, see [Amazon Web Services Identity and Access
3816
- # 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
3817
3880
  # User Guide*.
3818
3881
  #
3819
3882
  # HTTP Host header syntax
3820
3883
  #
3821
3884
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
3822
- # `s3express-control.region.amazonaws.com`.
3885
+ # `s3express-control.region-code.amazonaws.com`.
3823
3886
  #
3824
3887
  # The following operations are related to `DeleteBucket`:
3825
3888
  #
3826
- # * [CreateBucket][3]
3889
+ # * [CreateBucket][4]
3827
3890
  #
3828
- # * [DeleteObject][4]
3891
+ # * [DeleteObject][5]
3829
3892
  #
3830
3893
  #
3831
3894
  #
3832
3895
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
3833
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
3834
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
3835
- # [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
3836
3900
  #
3837
3901
  # @option params [required, String] :bucket
3838
3902
  # Specifies the bucket being deleted.
3839
3903
  #
3840
3904
  # <b>Directory buckets </b> - When you use this operation with a
3841
3905
  # directory bucket, you must use path-style requests in the format
3842
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
3906
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
3843
3907
  # Virtual-hosted-style requests aren't supported. Directory bucket
3844
- # names must be unique in the chosen Availability Zone. Bucket names
3845
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
3846
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
3847
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
3848
- # 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*
3849
3914
  #
3850
3915
  #
3851
3916
  #
@@ -4054,7 +4119,7 @@ module Aws::S3
4054
4119
  # HTTP Host header syntax
4055
4120
  #
4056
4121
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
4057
- # `s3express-control.region.amazonaws.com`.
4122
+ # `s3express-control.region-code.amazonaws.com`.
4058
4123
  #
4059
4124
  # The following operations are related to `DeleteBucketEncryption`:
4060
4125
  #
@@ -4078,13 +4143,14 @@ module Aws::S3
4078
4143
  #
4079
4144
  # <b>Directory buckets </b> - When you use this operation with a
4080
4145
  # directory bucket, you must use path-style requests in the format
4081
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4146
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4082
4147
  # Virtual-hosted-style requests aren't supported. Directory bucket
4083
- # names must be unique in the chosen Availability Zone. Bucket names
4084
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
4085
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
4086
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
4087
- # 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*
4088
4154
  #
4089
4155
  #
4090
4156
  #
@@ -4286,10 +4352,13 @@ module Aws::S3
4286
4352
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
4287
4353
  # requests for this API operation to the Regional endpoint. These
4288
4354
  # endpoints support path-style requests in the format
4289
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
4355
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
4290
4356
  # `. Virtual-hosted-style requests aren't supported. For more
4291
- # information, see [Regional and Zonal endpoints][3] in the *Amazon
4292
- # S3 User Guide*.
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*.
4293
4362
  #
4294
4363
  # </note>
4295
4364
  # ^
@@ -4300,22 +4369,23 @@ module Aws::S3
4300
4369
  # `s3express-control.region.amazonaws.com`.
4301
4370
  #
4302
4371
  # For more information about the object expiration, see [Elements to
4303
- # Describe Lifecycle Actions][4].
4372
+ # Describe Lifecycle Actions][5].
4304
4373
  #
4305
4374
  # Related actions include:
4306
4375
  #
4307
- # * [PutBucketLifecycleConfiguration][5]
4376
+ # * [PutBucketLifecycleConfiguration][6]
4308
4377
  #
4309
- # * [GetBucketLifecycleConfiguration][6]
4378
+ # * [GetBucketLifecycleConfiguration][7]
4310
4379
  #
4311
4380
  #
4312
4381
  #
4313
4382
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
4314
4383
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4315
4384
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4316
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
4317
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
4318
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
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
4319
4389
  #
4320
4390
  # @option params [required, String] :bucket
4321
4391
  # The bucket name of the lifecycle to delete.
@@ -4482,9 +4552,13 @@ module Aws::S3
4482
4552
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
4483
4553
  # requests for this API operation to the Regional endpoint. These
4484
4554
  # endpoints support path-style requests in the format
4485
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4486
- # Virtual-hosted-style requests aren't supported. For more information,
4487
- # 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*.
4488
4562
  #
4489
4563
  # </note>
4490
4564
  #
@@ -4514,7 +4588,7 @@ module Aws::S3
4514
4588
  # * **General purpose bucket permissions** - The
4515
4589
  # `s3:DeleteBucketPolicy` permission is required in a policy. For
4516
4590
  # more information about general purpose buckets bucket policies,
4517
- # 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
4518
4592
  # User Guide*.
4519
4593
  #
4520
4594
  # * **Directory bucket permissions** - To grant access to this API
@@ -4525,39 +4599,41 @@ module Aws::S3
4525
4599
  # Services account that owns the resource. For more information
4526
4600
  # about directory bucket policies and permissions, see [Amazon Web
4527
4601
  # Services Identity and Access Management (IAM) for S3 Express One
4528
- # Zone][3] in the *Amazon S3 User Guide*.
4602
+ # Zone][4] in the *Amazon S3 User Guide*.
4529
4603
  #
4530
4604
  # HTTP Host header syntax
4531
4605
  #
4532
4606
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
4533
- # `s3express-control.region.amazonaws.com`.
4607
+ # `s3express-control.region-code.amazonaws.com`.
4534
4608
  #
4535
4609
  # The following operations are related to `DeleteBucketPolicy`
4536
4610
  #
4537
- # * [CreateBucket][4]
4611
+ # * [CreateBucket][5]
4538
4612
  #
4539
- # * [DeleteObject][5]
4613
+ # * [DeleteObject][6]
4540
4614
  #
4541
4615
  #
4542
4616
  #
4543
4617
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4544
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
4545
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4546
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
4547
- # [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
4548
4623
  #
4549
4624
  # @option params [required, String] :bucket
4550
4625
  # The bucket name.
4551
4626
  #
4552
4627
  # <b>Directory buckets </b> - When you use this operation with a
4553
4628
  # directory bucket, you must use path-style requests in the format
4554
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4629
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4555
4630
  # Virtual-hosted-style requests aren't supported. Directory bucket
4556
- # names must be unique in the chosen Availability Zone. Bucket names
4557
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
4558
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
4559
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
4560
- # 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*
4561
4637
  #
4562
4638
  #
4563
4639
  #
@@ -4796,33 +4872,71 @@ module Aws::S3
4796
4872
  end
4797
4873
 
4798
4874
  # Removes an object from a bucket. The behavior depends on the bucket's
4799
- # versioning state. For more information, see [Best practices to
4800
- # 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>
4801
4914
  #
4802
4915
  # To remove a specific version, you must use the `versionId` query
4803
4916
  # parameter. Using this query parameter permanently deletes the version.
4804
4917
  # If the object deleted is a delete marker, Amazon S3 sets the response
4805
- # header `x-amz-delete-marker` to true. If the object you want to delete
4806
- # is in a bucket where the bucket versioning configuration is MFA delete
4807
- # enabled, you must include the `x-amz-mfa` request header in the DELETE
4808
- # `versionId` request. Requests that include `x-amz-mfa` must use HTTPS.
4809
- # For more information about MFA delete and to see example requests, see
4810
- # [Using MFA delete][2] and [Sample request][3] in the *Amazon S3 User
4811
- # Guide*.
4918
+ # header `x-amz-delete-marker` to true.
4812
4919
  #
4813
- # <note markdown="1"> * S3 Versioning isn't enabled and supported for directory buckets.
4814
- # For this API operation, only the `null` value of the version ID is
4815
- # supported by directory buckets. You can only specify `null` to the
4816
- # `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].
4817
4926
  #
4818
- # * For directory buckets, you must make requests for this API operation
4819
- # to the Zonal endpoint. These endpoints support virtual-hosted-style
4820
- # requests in the format
4821
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
4822
- # `. Path-style requests are not supported. For more information, see
4823
- # [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>
4824
4931
  #
4825
- # * MFA delete is not supported by directory buckets.
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.
4937
+ #
4938
+ # <note markdown="1"> **Directory buckets** - S3 Lifecycle is not supported by directory
4939
+ # buckets.
4826
4940
  #
4827
4941
  # </note>
4828
4942
  #
@@ -4834,51 +4948,56 @@ module Aws::S3
4834
4948
  # * <b> <code>s3:DeleteObject</code> </b> - To delete an object from
4835
4949
  # a bucket, you must always have the `s3:DeleteObject` permission.
4836
4950
  #
4837
- # <note markdown="1"> You can also use PutBucketLifecycle to delete objects in Amazon
4838
- # S3.
4839
- #
4840
- # </note>
4841
- #
4842
4951
  # * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
4843
4952
  # specific version of an object from a versioning-enabled bucket,
4844
4953
  # you must have the `s3:DeleteObjectVersion` permission.
4845
- #
4846
- # * If you want to block users or accounts from removing or deleting
4847
- # objects from your bucket, you must deny them the
4848
- # `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
4849
- # `s3:PutLifeCycleConfiguration` permissions.
4850
- # * **Directory buckets permissions** - To grant access to this API
4851
- # operation on a directory bucket, we recommend that you use the
4852
- # 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].
4853
4968
  #
4854
4969
  # HTTP Host header syntax
4855
4970
  #
4856
4971
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
4857
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
4972
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
4858
4973
  #
4859
4974
  # The following action is related to `DeleteObject`:
4860
4975
  #
4861
- # * [PutObject][5]
4976
+ # * [PutObject][9]
4862
4977
  #
4863
4978
  # ^
4864
4979
  #
4865
4980
  #
4866
4981
  #
4867
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjects.html#DeletingObjects-best-practices
4868
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
4869
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
4870
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4871
- # [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
4872
4991
  #
4873
4992
  # @option params [required, String] :bucket
4874
4993
  # The bucket name of the bucket containing the object.
4875
4994
  #
4876
4995
  # **Directory buckets** - When you use this operation with a directory
4877
4996
  # bucket, you must use virtual-hosted-style requests in the format `
4878
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
4879
- # are not supported. Directory bucket names must be unique in the chosen
4880
- # Availability Zone. Bucket names must follow the format `
4881
- # 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, `
4882
5001
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4883
5002
  # naming restrictions, see [Directory bucket naming rules][1] in the
4884
5003
  # *Amazon S3 User Guide*.
@@ -5211,9 +5330,13 @@ module Aws::S3
5211
5330
  # * **Directory buckets** - For directory buckets, you must make
5212
5331
  # requests for this API operation to the Zonal endpoint. These
5213
5332
  # endpoints support virtual-hosted-style requests in the format
5214
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
5215
- # `. Path-style requests are not supported. For more information, see
5216
- # [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*.
5217
5340
  #
5218
5341
  # </note>
5219
5342
  #
@@ -5231,7 +5354,7 @@ module Aws::S3
5231
5354
  # if there are non-versioned objects you are trying to delete. If you
5232
5355
  # provide an invalid token, whether there are versioned keys in the
5233
5356
  # request or not, the entire Multi-Object Delete request will fail. For
5234
- # 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
5235
5358
  # User Guide*.
5236
5359
  #
5237
5360
  # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
@@ -5253,7 +5376,7 @@ module Aws::S3
5253
5376
  # you must specify the `s3:DeleteObjectVersion` permission.
5254
5377
  # * **Directory bucket permissions** - To grant access to this API
5255
5378
  # operation on a directory bucket, we recommend that you use the [
5256
- # `CreateSession` ][3] API operation for session-based
5379
+ # `CreateSession` ][4] API operation for session-based
5257
5380
  # authorization. Specifically, you grant the
5258
5381
  # `s3express:CreateSession` permission to the directory bucket in a
5259
5382
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -5264,7 +5387,7 @@ module Aws::S3
5264
5387
  # token for use. Amazon Web Services CLI or SDKs create session and
5265
5388
  # refresh the session token automatically to avoid service
5266
5389
  # interruptions when a session expires. For more information about
5267
- # authorization, see [ `CreateSession` ][3].
5390
+ # authorization, see [ `CreateSession` ][4].
5268
5391
  #
5269
5392
  # Content-MD5 request header
5270
5393
  # : * **General purpose bucket** - The Content-MD5 request header is
@@ -5281,40 +5404,41 @@ module Aws::S3
5281
5404
  # HTTP Host header syntax
5282
5405
  #
5283
5406
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
5284
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
5407
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
5285
5408
  #
5286
5409
  # The following operations are related to `DeleteObjects`:
5287
5410
  #
5288
- # * [CreateMultipartUpload][4]
5411
+ # * [CreateMultipartUpload][5]
5289
5412
  #
5290
- # * [UploadPart][5]
5413
+ # * [UploadPart][6]
5291
5414
  #
5292
- # * [CompleteMultipartUpload][6]
5415
+ # * [CompleteMultipartUpload][7]
5293
5416
  #
5294
- # * [ListParts][7]
5417
+ # * [ListParts][8]
5295
5418
  #
5296
- # * [AbortMultipartUpload][8]
5419
+ # * [AbortMultipartUpload][9]
5297
5420
  #
5298
5421
  #
5299
5422
  #
5300
5423
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
5301
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
5302
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
5303
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
5304
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
5305
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
5306
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
5307
- # [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
5308
5432
  #
5309
5433
  # @option params [required, String] :bucket
5310
5434
  # The bucket name containing the objects to delete.
5311
5435
  #
5312
5436
  # **Directory buckets** - When you use this operation with a directory
5313
5437
  # bucket, you must use virtual-hosted-style requests in the format `
5314
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
5315
- # are not supported. Directory bucket names must be unique in the chosen
5316
- # Availability Zone. Bucket names must follow the format `
5317
- # 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, `
5318
5442
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
5319
5443
  # naming restrictions, see [Directory bucket naming rules][1] in the
5320
5444
  # *Amazon S3 User Guide*.
@@ -5449,22 +5573,20 @@ module Aws::S3
5449
5573
  # * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
5450
5574
  #
5451
5575
  #
5452
- # @example Example: To delete multiple object versions from a versioned bucket
5576
+ # @example Example: To delete multiple objects from a versioned bucket
5453
5577
  #
5454
- # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
5455
- # # versions and returns the key and versions of deleted objects in the response.
5578
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
5579
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
5456
5580
  #
5457
5581
  # resp = client.delete_objects({
5458
5582
  # bucket: "examplebucket",
5459
5583
  # delete: {
5460
5584
  # objects: [
5461
5585
  # {
5462
- # key: "HappyFace.jpg",
5463
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5586
+ # key: "objectkey1",
5464
5587
  # },
5465
5588
  # {
5466
- # key: "HappyFace.jpg",
5467
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5589
+ # key: "objectkey2",
5468
5590
  # },
5469
5591
  # ],
5470
5592
  # quiet: false,
@@ -5475,30 +5597,34 @@ module Aws::S3
5475
5597
  # {
5476
5598
  # deleted: [
5477
5599
  # {
5478
- # key: "HappyFace.jpg",
5479
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5600
+ # delete_marker: true,
5601
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
5602
+ # key: "objectkey1",
5480
5603
  # },
5481
5604
  # {
5482
- # key: "HappyFace.jpg",
5483
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5605
+ # delete_marker: true,
5606
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
5607
+ # key: "objectkey2",
5484
5608
  # },
5485
5609
  # ],
5486
5610
  # }
5487
5611
  #
5488
- # @example Example: To delete multiple objects from a versioned bucket
5612
+ # @example Example: To delete multiple object versions from a versioned bucket
5489
5613
  #
5490
- # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
5491
- # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
5614
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
5615
+ # # versions and returns the key and versions of deleted objects in the response.
5492
5616
  #
5493
5617
  # resp = client.delete_objects({
5494
5618
  # bucket: "examplebucket",
5495
5619
  # delete: {
5496
5620
  # objects: [
5497
5621
  # {
5498
- # key: "objectkey1",
5622
+ # key: "HappyFace.jpg",
5623
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5499
5624
  # },
5500
5625
  # {
5501
- # key: "objectkey2",
5626
+ # key: "HappyFace.jpg",
5627
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5502
5628
  # },
5503
5629
  # ],
5504
5630
  # quiet: false,
@@ -5509,14 +5635,12 @@ module Aws::S3
5509
5635
  # {
5510
5636
  # deleted: [
5511
5637
  # {
5512
- # delete_marker: true,
5513
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
5514
- # key: "objectkey1",
5638
+ # key: "HappyFace.jpg",
5639
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5515
5640
  # },
5516
5641
  # {
5517
- # delete_marker: true,
5518
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
5519
- # key: "objectkey2",
5642
+ # key: "HappyFace.jpg",
5643
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5520
5644
  # },
5521
5645
  # ],
5522
5646
  # }
@@ -6061,7 +6185,7 @@ module Aws::S3
6061
6185
  # HTTP Host header syntax
6062
6186
  #
6063
6187
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
6064
- # `s3express-control.region.amazonaws.com`.
6188
+ # `s3express-control.region-code.amazonaws.com`.
6065
6189
  #
6066
6190
  # The following operations are related to `GetBucketEncryption`:
6067
6191
  #
@@ -6085,13 +6209,14 @@ module Aws::S3
6085
6209
  #
6086
6210
  # <b>Directory buckets </b> - When you use this operation with a
6087
6211
  # directory bucket, you must use path-style requests in the format
6088
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
6212
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
6089
6213
  # Virtual-hosted-style requests aren't supported. Directory bucket
6090
- # names must be unique in the chosen Availability Zone. Bucket names
6091
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
6092
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
6093
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
6094
- # 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*
6095
6220
  #
6096
6221
  #
6097
6222
  #
@@ -6468,10 +6593,13 @@ module Aws::S3
6468
6593
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
6469
6594
  # requests for this API operation to the Regional endpoint. These
6470
6595
  # endpoints support path-style requests in the format
6471
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
6596
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
6472
6597
  # `. Virtual-hosted-style requests aren't supported. For more
6473
- # information, see [Regional and Zonal endpoints][5] in the *Amazon
6474
- # S3 User Guide*.
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*.
6475
6603
  #
6476
6604
  # </note>
6477
6605
  #
@@ -6495,9 +6623,9 @@ module Aws::S3
6495
6623
  #
6496
6624
  # * [GetBucketLifecycle][2]
6497
6625
  #
6498
- # * [PutBucketLifecycle][6]
6626
+ # * [PutBucketLifecycle][7]
6499
6627
  #
6500
- # * [DeleteBucketLifecycle][7]
6628
+ # * [DeleteBucketLifecycle][8]
6501
6629
  #
6502
6630
  #
6503
6631
  #
@@ -6506,8 +6634,9 @@ module Aws::S3
6506
6634
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6507
6635
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
6508
6636
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
6509
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
6510
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
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
6511
6640
  #
6512
6641
  # @option params [required, String] :bucket
6513
6642
  # The name of the bucket for which to get the lifecycle information.
@@ -7152,9 +7281,13 @@ module Aws::S3
7152
7281
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
7153
7282
  # requests for this API operation to the Regional endpoint. These
7154
7283
  # endpoints support path-style requests in the format
7155
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
7156
- # Virtual-hosted-style requests aren't supported. For more information,
7157
- # 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*.
7158
7291
  #
7159
7292
  # </note>
7160
7293
  #
@@ -7184,7 +7317,7 @@ module Aws::S3
7184
7317
  # * **General purpose bucket permissions** - The `s3:GetBucketPolicy`
7185
7318
  # permission is required in a policy. For more information about
7186
7319
  # general purpose buckets bucket policies, see [Using Bucket
7187
- # Policies and User Policies][2] in the *Amazon S3 User Guide*.
7320
+ # Policies and User Policies][3] in the *Amazon S3 User Guide*.
7188
7321
  #
7189
7322
  # * **Directory bucket permissions** - To grant access to this API
7190
7323
  # operation, you must have the `s3express:GetBucketPolicy`
@@ -7194,48 +7327,50 @@ module Aws::S3
7194
7327
  # Services account that owns the resource. For more information
7195
7328
  # about directory bucket policies and permissions, see [Amazon Web
7196
7329
  # Services Identity and Access Management (IAM) for S3 Express One
7197
- # Zone][3] in the *Amazon S3 User Guide*.
7330
+ # Zone][4] in the *Amazon S3 User Guide*.
7198
7331
  #
7199
7332
  # Example bucket policies
7200
7333
  #
7201
7334
  # : **General purpose buckets example bucket policies** - See [Bucket
7202
- # policy examples][4] in the *Amazon S3 User Guide*.
7335
+ # policy examples][5] in the *Amazon S3 User Guide*.
7203
7336
  #
7204
7337
  # **Directory bucket example bucket policies** - See [Example bucket
7205
- # 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*.
7206
7339
  #
7207
7340
  # HTTP Host header syntax
7208
7341
  #
7209
7342
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
7210
- # `s3express-control.region.amazonaws.com`.
7343
+ # `s3express-control.region-code.amazonaws.com`.
7211
7344
  #
7212
7345
  # The following action is related to `GetBucketPolicy`:
7213
7346
  #
7214
- # * [GetObject][6]
7347
+ # * [GetObject][7]
7215
7348
  #
7216
7349
  # ^
7217
7350
  #
7218
7351
  #
7219
7352
  #
7220
7353
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
7221
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
7222
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
7223
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
7224
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
7225
- # [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
7226
7360
  #
7227
7361
  # @option params [required, String] :bucket
7228
7362
  # The bucket name to get the bucket policy for.
7229
7363
  #
7230
7364
  # <b>Directory buckets </b> - When you use this operation with a
7231
7365
  # directory bucket, you must use path-style requests in the format
7232
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
7366
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
7233
7367
  # Virtual-hosted-style requests aren't supported. Directory bucket
7234
- # names must be unique in the chosen Availability Zone. Bucket names
7235
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
7236
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
7237
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
7238
- # 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*
7239
7374
  #
7240
7375
  # **Access points** - When you use this API operation with an access
7241
7376
  # point, provide the alias of the access point in place of the bucket
@@ -7838,9 +7973,13 @@ module Aws::S3
7838
7973
  # `/photos/2006/February/sample.jpg`. Also, when you make requests to
7839
7974
  # this API operation, your requests are sent to the Zonal endpoint.
7840
7975
  # These endpoints support virtual-hosted-style requests in the format
7841
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
7842
- # Path-style requests are not supported. For more information, see
7843
- # [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*.
7844
7983
  #
7845
7984
  # Permissions
7846
7985
  # : * **General purpose bucket permissions** - You must have the
@@ -7848,7 +7987,7 @@ module Aws::S3
7848
7987
  # have the `READ` access to the object (or version). If you grant
7849
7988
  # `READ` access to the anonymous user, the `GetObject` operation
7850
7989
  # returns the object without using an authorization header. For more
7851
- # information, see [Specifying permissions in a policy][3] in the
7990
+ # information, see [Specifying permissions in a policy][4] in the
7852
7991
  # *Amazon S3 User Guide*.
7853
7992
  #
7854
7993
  # If you include a `versionId` in your request header, you must have
@@ -7872,7 +8011,7 @@ module Aws::S3
7872
8011
  # returns an HTTP status code `403 Access Denied` error.
7873
8012
  # * **Directory bucket permissions** - To grant access to this API
7874
8013
  # operation on a directory bucket, we recommend that you use the [
7875
- # `CreateSession` ][4] API operation for session-based
8014
+ # `CreateSession` ][5] API operation for session-based
7876
8015
  # authorization. Specifically, you grant the
7877
8016
  # `s3express:CreateSession` permission to the directory bucket in a
7878
8017
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -7883,7 +8022,7 @@ module Aws::S3
7883
8022
  # token for use. Amazon Web Services CLI or SDKs create session and
7884
8023
  # refresh the session token automatically to avoid service
7885
8024
  # interruptions when a session expires. For more information about
7886
- # authorization, see [ `CreateSession` ][4].
8025
+ # authorization, see [ `CreateSession` ][5].
7887
8026
  #
7888
8027
  # If the object is encrypted using SSE-KMS, you must also have the
7889
8028
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -7896,9 +8035,9 @@ module Aws::S3
7896
8035
  # storage class, the S3 Intelligent-Tiering Archive Access tier, or
7897
8036
  # the S3 Intelligent-Tiering Deep Archive Access tier, before you can
7898
8037
  # retrieve the object you must first restore a copy using
7899
- # [RestoreObject][5]. Otherwise, this operation returns an
8038
+ # [RestoreObject][6]. Otherwise, this operation returns an
7900
8039
  # `InvalidObjectState` error. For information about restoring archived
7901
- # objects, see [Restoring Archived Objects][6] in the *Amazon S3 User
8040
+ # objects, see [Restoring Archived Objects][7] in the *Amazon S3 User
7902
8041
  # Guide*.
7903
8042
  #
7904
8043
  # <b>Directory buckets </b> - For directory buckets, only the S3
@@ -7920,7 +8059,7 @@ module Aws::S3
7920
8059
  # **Directory buckets** - For directory buckets, there are only two
7921
8060
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
7922
8061
  # SSE-C isn't supported. For more information, see [Protecting data
7923
- # with server-side encryption][7] in the *Amazon S3 User Guide*.
8062
+ # with server-side encryption][8] in the *Amazon S3 User Guide*.
7924
8063
  #
7925
8064
  # Overriding response header values through the request
7926
8065
  #
@@ -7965,25 +8104,26 @@ module Aws::S3
7965
8104
  # HTTP Host header syntax
7966
8105
  #
7967
8106
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
7968
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
8107
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
7969
8108
  #
7970
8109
  # The following operations are related to `GetObject`:
7971
8110
  #
7972
- # * [ListBuckets][8]
8111
+ # * [ListBuckets][9]
7973
8112
  #
7974
- # * [GetObjectAcl][9]
8113
+ # * [GetObjectAcl][10]
7975
8114
  #
7976
8115
  #
7977
8116
  #
7978
8117
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
7979
8118
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
7980
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
7981
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
7982
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
7983
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
7984
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
7985
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
7986
- # [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
7987
8127
  #
7988
8128
  # @option params [String, IO] :response_target
7989
8129
  # Where to write response data, file path, or IO object.
@@ -7993,10 +8133,10 @@ module Aws::S3
7993
8133
  #
7994
8134
  # **Directory buckets** - When you use this operation with a directory
7995
8135
  # bucket, you must use virtual-hosted-style requests in the format `
7996
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
7997
- # are not supported. Directory bucket names must be unique in the chosen
7998
- # Availability Zone. Bucket names must follow the format `
7999
- # 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, `
8000
8140
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8001
8141
  # naming restrictions, see [Directory bucket naming rules][1] in the
8002
8142
  # *Amazon S3 User Guide*.
@@ -8676,9 +8816,13 @@ module Aws::S3
8676
8816
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
8677
8817
  # for this API operation to the Zonal endpoint. These endpoints support
8678
8818
  # virtual-hosted-style requests in the format
8679
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
8680
- # Path-style requests are not supported. For more information, see
8681
- # [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*.
8682
8826
  #
8683
8827
  # </note>
8684
8828
  #
@@ -8691,7 +8835,7 @@ module Aws::S3
8691
8835
  # `s3:GetObjectVersionAttributes` permissions for this operation. If
8692
8836
  # the bucket is not versioned, you need the `s3:GetObject` and
8693
8837
  # `s3:GetObjectAttributes` permissions. For more information, see
8694
- # [Specifying Permissions in a Policy][2] in the *Amazon S3 User
8838
+ # [Specifying Permissions in a Policy][3] in the *Amazon S3 User
8695
8839
  # Guide*. If the object that you request does not exist, the error
8696
8840
  # Amazon S3 returns depends on whether you also have the
8697
8841
  # `s3:ListBucket` permission.
@@ -8705,7 +8849,7 @@ module Aws::S3
8705
8849
  # error.
8706
8850
  # * **Directory bucket permissions** - To grant access to this API
8707
8851
  # operation on a directory bucket, we recommend that you use the [
8708
- # `CreateSession` ][3] API operation for session-based
8852
+ # `CreateSession` ][4] API operation for session-based
8709
8853
  # authorization. Specifically, you grant the
8710
8854
  # `s3express:CreateSession` permission to the directory bucket in a
8711
8855
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -8716,7 +8860,7 @@ module Aws::S3
8716
8860
  # token for use. Amazon Web Services CLI or SDKs create session and
8717
8861
  # refresh the session token automatically to avoid service
8718
8862
  # interruptions when a session expires. For more information about
8719
- # authorization, see [ `CreateSession` ][3].
8863
+ # authorization, see [ `CreateSession` ][4].
8720
8864
  #
8721
8865
  # If the object is encrypted with SSE-KMS, you must also have the
8722
8866
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -8752,7 +8896,7 @@ module Aws::S3
8752
8896
  # * `x-amz-server-side-encryption-customer-key-MD5`
8753
8897
  #
8754
8898
  # For more information about SSE-C, see [Server-Side Encryption (Using
8755
- # Customer-Provided Encryption Keys)][4] in the *Amazon S3 User
8899
+ # Customer-Provided Encryption Keys)][5] in the *Amazon S3 User
8756
8900
  # Guide*.
8757
8901
  #
8758
8902
  # <note markdown="1"> **Directory bucket permissions** - For directory buckets, there are
@@ -8764,10 +8908,10 @@ module Aws::S3
8764
8908
  # encryption in your `CreateSession` requests or `PUT` object
8765
8909
  # requests. Then, new objects are automatically encrypted with the
8766
8910
  # desired encryption settings. For more information, see [Protecting
8767
- # 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*.
8768
8912
  # For more information about the encryption overriding behaviors in
8769
8913
  # directory buckets, see [Specifying server-side encryption with KMS
8770
- # for new object uploads][6].
8914
+ # for new object uploads][7].
8771
8915
  #
8772
8916
  # </note>
8773
8917
  #
@@ -8790,7 +8934,7 @@ module Aws::S3
8790
8934
  #
8791
8935
  # * `If-Unmodified-Since` condition evaluates to `false`.
8792
8936
  # For more information about conditional requests, see [RFC
8793
- # 7232][7].
8937
+ # 7232][8].
8794
8938
  #
8795
8939
  # * If both of the `If-None-Match` and `If-Modified-Since` headers are
8796
8940
  # present in the request as follows, then Amazon S3 returns the HTTP
@@ -8800,58 +8944,59 @@ module Aws::S3
8800
8944
  #
8801
8945
  # * `If-Modified-Since` condition evaluates to `true`.
8802
8946
  # For more information about conditional requests, see [RFC
8803
- # 7232][7].
8947
+ # 7232][8].
8804
8948
  #
8805
8949
  # HTTP Host header syntax
8806
8950
  #
8807
8951
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
8808
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
8952
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
8809
8953
  #
8810
8954
  # The following actions are related to `GetObjectAttributes`:
8811
8955
  #
8812
- # * [GetObject][8]
8956
+ # * [GetObject][9]
8813
8957
  #
8814
- # * [GetObjectAcl][9]
8958
+ # * [GetObjectAcl][10]
8815
8959
  #
8816
- # * [GetObjectLegalHold][10]
8960
+ # * [GetObjectLegalHold][11]
8817
8961
  #
8818
- # * [GetObjectLockConfiguration][11]
8962
+ # * [GetObjectLockConfiguration][12]
8819
8963
  #
8820
- # * [GetObjectRetention][12]
8964
+ # * [GetObjectRetention][13]
8821
8965
  #
8822
- # * [GetObjectTagging][13]
8966
+ # * [GetObjectTagging][14]
8823
8967
  #
8824
- # * [HeadObject][14]
8968
+ # * [HeadObject][15]
8825
8969
  #
8826
- # * [ListParts][15]
8970
+ # * [ListParts][16]
8827
8971
  #
8828
8972
  #
8829
8973
  #
8830
8974
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
8831
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8832
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
8833
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
8834
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
8835
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
8836
- # [7]: https://tools.ietf.org/html/rfc7232
8837
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
8838
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
8839
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
8840
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
8841
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
8842
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
8843
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
8844
- # [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
8845
8990
  #
8846
8991
  # @option params [required, String] :bucket
8847
8992
  # The name of the bucket that contains the object.
8848
8993
  #
8849
8994
  # **Directory buckets** - When you use this operation with a directory
8850
8995
  # bucket, you must use virtual-hosted-style requests in the format `
8851
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
8852
- # are not supported. Directory bucket names must be unique in the chosen
8853
- # Availability Zone. Bucket names must follow the format `
8854
- # 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, `
8855
9000
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8856
9001
  # naming restrictions, see [Directory bucket naming rules][1] in the
8857
9002
  # *Amazon S3 User Guide*.
@@ -9688,13 +9833,17 @@ module Aws::S3
9688
9833
  # HTTP Host header syntax
9689
9834
  #
9690
9835
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
9691
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
9836
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9692
9837
  #
9693
9838
  # <note markdown="1"> You must make requests for this API operation to the Zonal endpoint.
9694
9839
  # These endpoints support virtual-hosted-style requests in the format
9695
- # `https://bucket_name.s3express-az_id.region.amazonaws.com`.
9696
- # Path-style requests are not supported. For more information, see
9697
- # [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*.
9698
9847
  #
9699
9848
  # </note>
9700
9849
  #
@@ -9705,16 +9854,17 @@ module Aws::S3
9705
9854
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
9706
9855
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
9707
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
9708
9858
  #
9709
9859
  # @option params [required, String] :bucket
9710
9860
  # The bucket name.
9711
9861
  #
9712
9862
  # **Directory buckets** - When you use this operation with a directory
9713
9863
  # bucket, you must use virtual-hosted-style requests in the format `
9714
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
9715
- # are not supported. Directory bucket names must be unique in the chosen
9716
- # Availability Zone. Bucket names must follow the format `
9717
- # 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, `
9718
9868
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9719
9869
  # naming restrictions, see [Directory bucket naming rules][1] in the
9720
9870
  # *Amazon S3 User Guide*.
@@ -9788,7 +9938,7 @@ module Aws::S3
9788
9938
  #
9789
9939
  # @example Response structure
9790
9940
  #
9791
- # resp.bucket_location_type #=> String, one of "AvailabilityZone"
9941
+ # resp.bucket_location_type #=> String, one of "AvailabilityZone", "LocalZone"
9792
9942
  # resp.bucket_location_name #=> String
9793
9943
  # resp.bucket_region #=> String
9794
9944
  # resp.access_point_alias #=> Boolean
@@ -9933,22 +10083,26 @@ module Aws::S3
9933
10083
  # HTTP Host header syntax
9934
10084
  #
9935
10085
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
9936
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
10086
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9937
10087
  #
9938
10088
  # <note markdown="1"> For directory buckets, you must make requests for this API operation
9939
10089
  # to the Zonal endpoint. These endpoints support virtual-hosted-style
9940
10090
  # requests in the format
9941
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
9942
- # `. Path-style requests are not supported. For more information, see
9943
- # [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*.
9944
10098
  #
9945
10099
  # </note>
9946
10100
  #
9947
10101
  # The following actions are related to `HeadObject`:
9948
10102
  #
9949
- # * [GetObject][7]
10103
+ # * [GetObject][8]
9950
10104
  #
9951
- # * [GetObjectAttributes][8]
10105
+ # * [GetObjectAttributes][9]
9952
10106
  #
9953
10107
  #
9954
10108
  #
@@ -9958,18 +10112,19 @@ module Aws::S3
9958
10112
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
9959
10113
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
9960
10114
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
9961
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
9962
- # [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
9963
10118
  #
9964
10119
  # @option params [required, String] :bucket
9965
10120
  # The name of the bucket that contains the object.
9966
10121
  #
9967
10122
  # **Directory buckets** - When you use this operation with a directory
9968
10123
  # bucket, you must use virtual-hosted-style requests in the format `
9969
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
9970
- # are not supported. Directory bucket names must be unique in the chosen
9971
- # Availability Zone. Bucket names must follow the format `
9972
- # 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, `
9973
10128
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9974
10129
  # naming restrictions, see [Directory bucket naming rules][1] in the
9975
10130
  # *Amazon S3 User Guide*.
@@ -10873,9 +11028,13 @@ module Aws::S3
10873
11028
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
10874
11029
  # requests for this API operation to the Regional endpoint. These
10875
11030
  # endpoints support path-style requests in the format
10876
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
10877
- # Virtual-hosted-style requests aren't supported. For more information,
10878
- # 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*.
10879
11038
  #
10880
11039
  # </note>
10881
11040
  #
@@ -10887,7 +11046,7 @@ module Aws::S3
10887
11046
  # operation can only be performed by the Amazon Web Services account
10888
11047
  # that owns the resource. For more information about directory bucket
10889
11048
  # policies and permissions, see [Amazon Web Services Identity and
10890
- # 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
10891
11050
  # S3 User Guide*.
10892
11051
  #
10893
11052
  # HTTP Host header syntax
@@ -10904,7 +11063,8 @@ module Aws::S3
10904
11063
  #
10905
11064
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
10906
11065
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
10907
- # [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
10908
11068
  #
10909
11069
  # @option params [String] :continuation_token
10910
11070
  # `ContinuationToken` indicates to Amazon S3 that the list is being
@@ -10992,21 +11152,25 @@ module Aws::S3
10992
11152
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
10993
11153
  # for this API operation to the Zonal endpoint. These endpoints support
10994
11154
  # virtual-hosted-style requests in the format
10995
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
10996
- # Path-style requests are not supported. For more information, see
10997
- # [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*.
10998
11162
  #
10999
11163
  # </note>
11000
11164
  #
11001
11165
  # Permissions
11002
11166
  # : * **General purpose bucket permissions** - For information about
11003
11167
  # permissions required to use the multipart upload API, see
11004
- # [Multipart Upload and Permissions][3] in the *Amazon S3 User
11168
+ # [Multipart Upload and Permissions][4] in the *Amazon S3 User
11005
11169
  # Guide*.
11006
11170
  #
11007
11171
  # * **Directory bucket permissions** - To grant access to this API
11008
11172
  # operation on a directory bucket, we recommend that you use the [
11009
- # `CreateSession` ][4] API operation for session-based
11173
+ # `CreateSession` ][5] API operation for session-based
11010
11174
  # authorization. Specifically, you grant the
11011
11175
  # `s3express:CreateSession` permission to the directory bucket in a
11012
11176
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -11017,7 +11181,7 @@ module Aws::S3
11017
11181
  # token for use. Amazon Web Services CLI or SDKs create session and
11018
11182
  # refresh the session token automatically to avoid service
11019
11183
  # interruptions when a session expires. For more information about
11020
- # authorization, see [ `CreateSession` ][4].
11184
+ # authorization, see [ `CreateSession` ][5].
11021
11185
  #
11022
11186
  # Sorting of multipart uploads in response
11023
11187
  # : * **General purpose bucket** - In the `ListMultipartUploads`
@@ -11038,41 +11202,42 @@ module Aws::S3
11038
11202
  # HTTP Host header syntax
11039
11203
  #
11040
11204
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
11041
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
11205
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
11042
11206
  #
11043
11207
  # The following operations are related to `ListMultipartUploads`:
11044
11208
  #
11045
- # * [CreateMultipartUpload][5]
11209
+ # * [CreateMultipartUpload][6]
11046
11210
  #
11047
- # * [UploadPart][6]
11211
+ # * [UploadPart][7]
11048
11212
  #
11049
- # * [CompleteMultipartUpload][7]
11213
+ # * [CompleteMultipartUpload][8]
11050
11214
  #
11051
- # * [ListParts][8]
11215
+ # * [ListParts][9]
11052
11216
  #
11053
- # * [AbortMultipartUpload][9]
11217
+ # * [AbortMultipartUpload][10]
11054
11218
  #
11055
11219
  #
11056
11220
  #
11057
11221
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
11058
11222
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
11059
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11060
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
11061
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
11062
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
11063
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
11064
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
11065
- # [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
11066
11231
  #
11067
11232
  # @option params [required, String] :bucket
11068
11233
  # The name of the bucket to which the multipart upload was initiated.
11069
11234
  #
11070
11235
  # **Directory buckets** - When you use this operation with a directory
11071
11236
  # bucket, you must use virtual-hosted-style requests in the format `
11072
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11073
- # are not supported. Directory bucket names must be unique in the chosen
11074
- # Availability Zone. Bucket names must follow the format `
11075
- # 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, `
11076
11241
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11077
11242
  # naming restrictions, see [Directory bucket naming rules][1] in the
11078
11243
  # *Amazon S3 User Guide*.
@@ -11665,10 +11830,10 @@ module Aws::S3
11665
11830
  #
11666
11831
  # **Directory buckets** - When you use this operation with a directory
11667
11832
  # bucket, you must use virtual-hosted-style requests in the format `
11668
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11669
- # are not supported. Directory bucket names must be unique in the chosen
11670
- # Availability Zone. Bucket names must follow the format `
11671
- # 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, `
11672
11837
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11673
11838
  # naming restrictions, see [Directory bucket naming rules][1] in the
11674
11839
  # *Amazon S3 User Guide*.
@@ -11880,9 +12045,13 @@ module Aws::S3
11880
12045
  # * **Directory buckets** - For directory buckets, you must make
11881
12046
  # requests for this API operation to the Zonal endpoint. These
11882
12047
  # endpoints support virtual-hosted-style requests in the format
11883
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
11884
- # `. Path-style requests are not supported. For more information, see
11885
- # [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*.
11886
12055
  #
11887
12056
  # </note>
11888
12057
  #
@@ -11892,12 +12061,12 @@ module Aws::S3
11892
12061
  # to perform the `s3:ListBucket` action. The bucket owner has this
11893
12062
  # permission by default and can grant this permission to others. For
11894
12063
  # more information about permissions, see [Permissions Related to
11895
- # Bucket Subresource Operations][4] and [Managing Access Permissions
11896
- # 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*.
11897
12066
  #
11898
12067
  # * **Directory bucket permissions** - To grant access to this API
11899
12068
  # operation on a directory bucket, we recommend that you use the [
11900
- # `CreateSession` ][6] API operation for session-based
12069
+ # `CreateSession` ][7] API operation for session-based
11901
12070
  # authorization. Specifically, you grant the
11902
12071
  # `s3express:CreateSession` permission to the directory bucket in a
11903
12072
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -11908,7 +12077,7 @@ module Aws::S3
11908
12077
  # token for use. Amazon Web Services CLI or SDKs create session and
11909
12078
  # refresh the session token automatically to avoid service
11910
12079
  # interruptions when a session expires. For more information about
11911
- # authorization, see [ `CreateSession` ][6].
12080
+ # authorization, see [ `CreateSession` ][7].
11912
12081
  #
11913
12082
  # Sorting order of returned objects
11914
12083
  # : * **General purpose bucket** - For general purpose buckets,
@@ -11921,41 +12090,42 @@ module Aws::S3
11921
12090
  # HTTP Host header syntax
11922
12091
  #
11923
12092
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
11924
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
12093
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
11925
12094
  #
11926
12095
  # This section describes the latest revision of this action. We
11927
12096
  # recommend that you use this revised API operation for application
11928
12097
  # development. For backward compatibility, Amazon S3 continues to
11929
- # support the prior version of this API operation, [ListObjects][7].
12098
+ # support the prior version of this API operation, [ListObjects][8].
11930
12099
  #
11931
12100
  # The following operations are related to `ListObjectsV2`:
11932
12101
  #
11933
- # * [GetObject][8]
12102
+ # * [GetObject][9]
11934
12103
  #
11935
- # * [PutObject][9]
12104
+ # * [PutObject][10]
11936
12105
  #
11937
- # * [CreateBucket][10]
12106
+ # * [CreateBucket][11]
11938
12107
  #
11939
12108
  #
11940
12109
  #
11941
12110
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
11942
12111
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
11943
12112
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
11944
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
11945
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
11946
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
11947
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
11948
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
11949
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
11950
- # [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
11951
12121
  #
11952
12122
  # @option params [required, String] :bucket
11953
12123
  # **Directory buckets** - When you use this operation with a directory
11954
12124
  # bucket, you must use virtual-hosted-style requests in the format `
11955
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11956
- # are not supported. Directory bucket names must be unique in the chosen
11957
- # Availability Zone. Bucket names must follow the format `
11958
- # 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, `
11959
12129
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11960
12130
  # naming restrictions, see [Directory bucket naming rules][1] in the
11961
12131
  # *Amazon S3 User Guide*.
@@ -12223,16 +12393,20 @@ module Aws::S3
12223
12393
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
12224
12394
  # for this API operation to the Zonal endpoint. These endpoints support
12225
12395
  # virtual-hosted-style requests in the format
12226
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
12227
- # Path-style requests are not supported. For more information, see
12228
- # [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*.
12229
12403
  #
12230
12404
  # </note>
12231
12405
  #
12232
12406
  # Permissions
12233
12407
  # : * **General purpose bucket permissions** - For information about
12234
12408
  # permissions required to use the multipart upload API, see
12235
- # [Multipart Upload and Permissions][4] in the *Amazon S3 User
12409
+ # [Multipart Upload and Permissions][5] in the *Amazon S3 User
12236
12410
  # Guide*.
12237
12411
  #
12238
12412
  # If the upload was created using server-side encryption with Key
@@ -12243,7 +12417,7 @@ module Aws::S3
12243
12417
  #
12244
12418
  # * **Directory bucket permissions** - To grant access to this API
12245
12419
  # operation on a directory bucket, we recommend that you use the [
12246
- # `CreateSession` ][5] API operation for session-based
12420
+ # `CreateSession` ][6] API operation for session-based
12247
12421
  # authorization. Specifically, you grant the
12248
12422
  # `s3express:CreateSession` permission to the directory bucket in a
12249
12423
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -12254,49 +12428,50 @@ module Aws::S3
12254
12428
  # token for use. Amazon Web Services CLI or SDKs create session and
12255
12429
  # refresh the session token automatically to avoid service
12256
12430
  # interruptions when a session expires. For more information about
12257
- # authorization, see [ `CreateSession` ][5].
12431
+ # authorization, see [ `CreateSession` ][6].
12258
12432
  #
12259
12433
  # HTTP Host header syntax
12260
12434
  #
12261
12435
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
12262
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
12436
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
12263
12437
  #
12264
12438
  # The following operations are related to `ListParts`:
12265
12439
  #
12266
12440
  # * [CreateMultipartUpload][1]
12267
12441
  #
12268
- # * [UploadPart][6]
12442
+ # * [UploadPart][7]
12269
12443
  #
12270
- # * [CompleteMultipartUpload][7]
12444
+ # * [CompleteMultipartUpload][8]
12271
12445
  #
12272
- # * [AbortMultipartUpload][8]
12446
+ # * [AbortMultipartUpload][9]
12273
12447
  #
12274
- # * [GetObjectAttributes][9]
12448
+ # * [GetObjectAttributes][10]
12275
12449
  #
12276
- # * [ListMultipartUploads][10]
12450
+ # * [ListMultipartUploads][11]
12277
12451
  #
12278
12452
  #
12279
12453
  #
12280
12454
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
12281
12455
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
12282
12456
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
12283
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
12284
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
12285
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
12286
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
12287
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
12288
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
12289
- # [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
12290
12465
  #
12291
12466
  # @option params [required, String] :bucket
12292
12467
  # The name of the bucket to which the parts are being uploaded.
12293
12468
  #
12294
12469
  # **Directory buckets** - When you use this operation with a directory
12295
12470
  # bucket, you must use virtual-hosted-style requests in the format `
12296
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
12297
- # are not supported. Directory bucket names must be unique in the chosen
12298
- # Availability Zone. Bucket names must follow the format `
12299
- # 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, `
12300
12475
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12301
12476
  # naming restrictions, see [Directory bucket naming rules][1] in the
12302
12477
  # *Amazon S3 User Guide*.
@@ -13233,9 +13408,13 @@ module Aws::S3
13233
13408
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
13234
13409
  # requests for this API operation to the Regional endpoint. These
13235
13410
  # endpoints support path-style requests in the format
13236
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
13237
- # Virtual-hosted-style requests aren't supported. For more information,
13238
- # 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*.
13239
13418
  #
13240
13419
  # </note>
13241
13420
  #
@@ -13249,12 +13428,12 @@ module Aws::S3
13249
13428
  # keys (SSE-KMS) or dual-layer server-side encryption with Amazon
13250
13429
  # Web Services KMS keys (DSSE-KMS). If you specify default
13251
13430
  # encryption by using SSE-KMS, you can also configure [Amazon S3
13252
- # Bucket Keys][2]. For information about the bucket default
13253
- # 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]
13254
13433
  # in the *Amazon S3 User Guide*.
13255
13434
  #
13256
13435
  # * If you use PutBucketEncryption to set your [default bucket
13257
- # 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
13258
13437
  # is correct. Amazon S3 doesn't validate the KMS key ID provided in
13259
13438
  # PutBucketEncryption requests.
13260
13439
  # * <b>Directory buckets </b> - You can optionally configure default
@@ -13268,28 +13447,28 @@ module Aws::S3
13268
13447
  # encrypted with the desired encryption settings. For more
13269
13448
  # information about the encryption overriding behaviors in directory
13270
13449
  # buckets, see [Specifying server-side encryption with KMS for new
13271
- # object uploads][4].
13450
+ # object uploads][5].
13272
13451
  #
13273
13452
  # * Your SSE-KMS configuration can only support 1 [customer managed
13274
- # key][5] per directory bucket for the lifetime of the bucket. The
13275
- # [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.
13276
13455
  #
13277
13456
  # * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
13278
13457
  # in a directory bucket and can’t be disabled. S3 Bucket Keys
13279
13458
  # aren't supported, when you copy SSE-KMS encrypted objects from
13280
13459
  # general purpose buckets to directory buckets, from directory
13281
13460
  # buckets to general purpose buckets, or between directory buckets,
13282
- # through [CopyObject][7], [UploadPartCopy][8], [the Copy operation
13283
- # 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,
13284
13463
  # Amazon S3 makes a call to KMS every time a copy request is made
13285
13464
  # for a KMS-encrypted object.
13286
13465
  #
13287
- # * When you specify an [KMS customer managed key][5] for encryption
13466
+ # * When you specify an [KMS customer managed key][6] for encryption
13288
13467
  # in your directory bucket, only use the key ID or key ARN. The key
13289
13468
  # alias format of the KMS key isn't supported.
13290
13469
  #
13291
13470
  # * For directory buckets, if you use PutBucketEncryption to set your
13292
- # [default bucket encryption][3] to SSE-KMS, Amazon S3 validates the
13471
+ # [default bucket encryption][4] to SSE-KMS, Amazon S3 validates the
13293
13472
  # KMS key ID provided in PutBucketEncryption requests.
13294
13473
  #
13295
13474
  # </note>
@@ -13302,7 +13481,7 @@ module Aws::S3
13302
13481
  #
13303
13482
  # Also, this action requires Amazon Web Services Signature Version 4.
13304
13483
  # For more information, see [ Authenticating Requests (Amazon Web
13305
- # Services Signature Version 4)][11].
13484
+ # Services Signature Version 4)][12].
13306
13485
  #
13307
13486
  # Permissions
13308
13487
  # : * **General purpose bucket permissions** - The
@@ -13310,8 +13489,8 @@ module Aws::S3
13310
13489
  # policy. The bucket owner has this permission by default. The
13311
13490
  # bucket owner can grant this permission to others. For more
13312
13491
  # information about permissions, see [Permissions Related to Bucket
13313
- # Operations][12] and [Managing Access Permissions to Your Amazon S3
13314
- # 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*.
13315
13494
  #
13316
13495
  # * **Directory bucket permissions** - To grant access to this API
13317
13496
  # operation, you must have the
@@ -13321,7 +13500,7 @@ module Aws::S3
13321
13500
  # only be performed by the Amazon Web Services account that owns the
13322
13501
  # resource. For more information about directory bucket policies and
13323
13502
  # permissions, see [Amazon Web Services Identity and Access
13324
- # 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
13325
13504
  # User Guide*.
13326
13505
  #
13327
13506
  # To set a directory bucket default encryption with SSE-KMS, you
@@ -13332,32 +13511,33 @@ module Aws::S3
13332
13511
  # HTTP Host header syntax
13333
13512
  #
13334
13513
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
13335
- # `s3express-control.region.amazonaws.com`.
13514
+ # `s3express-control.region-code.amazonaws.com`.
13336
13515
  #
13337
13516
  # The following operations are related to `PutBucketEncryption`:
13338
13517
  #
13339
- # * [GetBucketEncryption][15]
13518
+ # * [GetBucketEncryption][16]
13340
13519
  #
13341
- # * [DeleteBucketEncryption][16]
13520
+ # * [DeleteBucketEncryption][17]
13342
13521
  #
13343
13522
  #
13344
13523
  #
13345
13524
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
13346
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
13347
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
13348
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
13349
- # [5]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
13350
- # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
13351
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
13352
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
13353
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
13354
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
13355
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
13356
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
13357
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
13358
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
13359
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
13360
- # [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
13361
13541
  #
13362
13542
  # @option params [required, String] :bucket
13363
13543
  # Specifies default encryption for a bucket using server-side encryption
@@ -13365,13 +13545,14 @@ module Aws::S3
13365
13545
  #
13366
13546
  # <b>Directory buckets </b> - When you use this operation with a
13367
13547
  # directory bucket, you must use path-style requests in the format
13368
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
13548
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
13369
13549
  # Virtual-hosted-style requests aren't supported. Directory bucket
13370
- # names must be unique in the chosen Availability Zone. Bucket names
13371
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
13372
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
13373
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
13374
- # 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*
13375
13556
  #
13376
13557
  #
13377
13558
  #
@@ -13890,6 +14071,16 @@ module Aws::S3
13890
14071
  # lifecycle configuration. For information about lifecycle
13891
14072
  # configuration, see [Managing your storage lifecycle][1].
13892
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
+ #
13893
14084
  # Rules
13894
14085
  # Permissions
13895
14086
  # HTTP Host header syntax
@@ -13970,10 +14161,13 @@ module Aws::S3
13970
14161
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
13971
14162
  # requests for this API operation to the Regional endpoint. These
13972
14163
  # endpoints support path-style requests in the format
13973
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
14164
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
13974
14165
  # `. Virtual-hosted-style requests aren't supported. For more
13975
- # information, see [Regional and Zonal endpoints][7] in the *Amazon
13976
- # S3 User Guide*.
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*.
13977
14171
  #
13978
14172
  # </note>
13979
14173
  #
@@ -13983,9 +14177,9 @@ module Aws::S3
13983
14177
  # The following operations are related to
13984
14178
  # `PutBucketLifecycleConfiguration`:
13985
14179
  #
13986
- # * [GetBucketLifecycleConfiguration][8]
14180
+ # * [GetBucketLifecycleConfiguration][9]
13987
14181
  #
13988
- # * [DeleteBucketLifecycle][9]
14182
+ # * [DeleteBucketLifecycle][10]
13989
14183
  #
13990
14184
  #
13991
14185
  #
@@ -13996,8 +14190,9 @@ module Aws::S3
13996
14190
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
13997
14191
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
13998
14192
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
13999
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
14000
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
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
14001
14196
  #
14002
14197
  # @option params [required, String] :bucket
14003
14198
  # The name of the bucket for which to set the configuration.
@@ -14794,9 +14989,13 @@ module Aws::S3
14794
14989
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
14795
14990
  # requests for this API operation to the Regional endpoint. These
14796
14991
  # endpoints support path-style requests in the format
14797
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
14798
- # Virtual-hosted-style requests aren't supported. For more information,
14799
- # 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*.
14800
14999
  #
14801
15000
  # </note>
14802
15001
  #
@@ -14826,7 +15025,7 @@ module Aws::S3
14826
15025
  # * **General purpose bucket permissions** - The `s3:PutBucketPolicy`
14827
15026
  # permission is required in a policy. For more information about
14828
15027
  # general purpose buckets bucket policies, see [Using Bucket
14829
- # Policies and User Policies][2] in the *Amazon S3 User Guide*.
15028
+ # Policies and User Policies][3] in the *Amazon S3 User Guide*.
14830
15029
  #
14831
15030
  # * **Directory bucket permissions** - To grant access to this API
14832
15031
  # operation, you must have the `s3express:PutBucketPolicy`
@@ -14836,49 +15035,51 @@ module Aws::S3
14836
15035
  # Services account that owns the resource. For more information
14837
15036
  # about directory bucket policies and permissions, see [Amazon Web
14838
15037
  # Services Identity and Access Management (IAM) for S3 Express One
14839
- # Zone][3] in the *Amazon S3 User Guide*.
15038
+ # Zone][4] in the *Amazon S3 User Guide*.
14840
15039
  #
14841
15040
  # Example bucket policies
14842
15041
  #
14843
15042
  # : **General purpose buckets example bucket policies** - See [Bucket
14844
- # policy examples][4] in the *Amazon S3 User Guide*.
15043
+ # policy examples][5] in the *Amazon S3 User Guide*.
14845
15044
  #
14846
15045
  # **Directory bucket example bucket policies** - See [Example bucket
14847
- # 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*.
14848
15047
  #
14849
15048
  # HTTP Host header syntax
14850
15049
  #
14851
15050
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
14852
- # `s3express-control.region.amazonaws.com`.
15051
+ # `s3express-control.region-code.amazonaws.com`.
14853
15052
  #
14854
15053
  # The following operations are related to `PutBucketPolicy`:
14855
15054
  #
14856
- # * [CreateBucket][6]
15055
+ # * [CreateBucket][7]
14857
15056
  #
14858
- # * [DeleteBucket][7]
15057
+ # * [DeleteBucket][8]
14859
15058
  #
14860
15059
  #
14861
15060
  #
14862
15061
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
14863
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
14864
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14865
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
14866
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
14867
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
14868
- # [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
14869
15069
  #
14870
15070
  # @option params [required, String] :bucket
14871
15071
  # The name of the bucket.
14872
15072
  #
14873
15073
  # <b>Directory buckets </b> - When you use this operation with a
14874
15074
  # directory bucket, you must use path-style requests in the format
14875
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
15075
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
14876
15076
  # Virtual-hosted-style requests aren't supported. Directory bucket
14877
- # names must be unique in the chosen Availability Zone. Bucket names
14878
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
14879
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
14880
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
14881
- # 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*
14882
15083
  #
14883
15084
  #
14884
15085
  #
@@ -15480,10 +15681,12 @@ module Aws::S3
15480
15681
  # </note>
15481
15682
  #
15482
15683
  # <note markdown="1"> When you enable versioning on a bucket for the first time, it might
15483
- # take a short amount of time for the change to be fully propagated. We
15484
- # recommend that you wait for 15 minutes after enabling versioning
15485
- # before issuing write operations (`PUT` or `DELETE`) on objects in the
15486
- # 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.
15487
15690
  #
15488
15691
  # </note>
15489
15692
  #
@@ -15814,9 +16017,13 @@ module Aws::S3
15814
16017
  # * **Directory buckets** - For directory buckets, you must make
15815
16018
  # requests for this API operation to the Zonal endpoint. These
15816
16019
  # endpoints support virtual-hosted-style requests in the format
15817
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
15818
- # `. Path-style requests are not supported. For more information, see
15819
- # [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*.
15820
16027
  #
15821
16028
  # </note>
15822
16029
  #
@@ -15826,7 +16033,7 @@ module Aws::S3
15826
16033
  # modify this behavior:
15827
16034
  #
15828
16035
  # * **S3 Object Lock** - To prevent objects from being deleted or
15829
- # 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
15830
16037
  # S3 User Guide*.
15831
16038
  #
15832
16039
  # <note markdown="1"> This functionality is not supported for directory buckets.
@@ -15840,9 +16047,9 @@ module Aws::S3
15840
16047
  # automatically generates a unique version ID of that object being
15841
16048
  # stored in Amazon S3. You can retrieve, replace, or delete any
15842
16049
  # version of the object. For more information about versioning, see
15843
- # [Adding Objects to Versioning-Enabled Buckets][3] in the *Amazon S3
16050
+ # [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
15844
16051
  # User Guide*. For information about returning the versioning state of
15845
- # a bucket, see [GetBucketVersioning][4].
16052
+ # a bucket, see [GetBucketVersioning][5].
15846
16053
  #
15847
16054
  # <note markdown="1"> This functionality is not supported for directory buckets.
15848
16055
  #
@@ -15866,7 +16073,7 @@ module Aws::S3
15866
16073
  # `s3:PutObjectTagging`.
15867
16074
  # * **Directory bucket permissions** - To grant access to this API
15868
16075
  # operation on a directory bucket, we recommend that you use the [
15869
- # `CreateSession` ][5] API operation for session-based
16076
+ # `CreateSession` ][6] API operation for session-based
15870
16077
  # authorization. Specifically, you grant the
15871
16078
  # `s3express:CreateSession` permission to the directory bucket in a
15872
16079
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -15877,7 +16084,7 @@ module Aws::S3
15877
16084
  # token for use. Amazon Web Services CLI or SDKs create session and
15878
16085
  # refresh the session token automatically to avoid service
15879
16086
  # interruptions when a session expires. For more information about
15880
- # authorization, see [ `CreateSession` ][5].
16087
+ # authorization, see [ `CreateSession` ][6].
15881
16088
  #
15882
16089
  # If the object is encrypted with SSE-KMS, you must also have the
15883
16090
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -15898,23 +16105,24 @@ module Aws::S3
15898
16105
  # HTTP Host header syntax
15899
16106
  #
15900
16107
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
15901
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
16108
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
15902
16109
  #
15903
16110
  # For more information about related Amazon S3 APIs, see the following:
15904
16111
  #
15905
- # * [CopyObject][6]
16112
+ # * [CopyObject][7]
15906
16113
  #
15907
- # * [DeleteObject][7]
16114
+ # * [DeleteObject][8]
15908
16115
  #
15909
16116
  #
15910
16117
  #
15911
16118
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
15912
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
15913
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
15914
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
15915
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
15916
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
15917
- # [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
15918
16126
  #
15919
16127
  # @option params [String] :acl
15920
16128
  # The canned ACL to apply to the object. For more information, see
@@ -15962,10 +16170,10 @@ module Aws::S3
15962
16170
  #
15963
16171
  # **Directory buckets** - When you use this operation with a directory
15964
16172
  # bucket, you must use virtual-hosted-style requests in the format `
15965
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
15966
- # are not supported. Directory bucket names must be unique in the chosen
15967
- # Availability Zone. Bucket names must follow the format `
15968
- # 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, `
15969
16177
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15970
16178
  # naming restrictions, see [Directory bucket naming rules][1] in the
15971
16179
  # *Amazon S3 User Guide*.
@@ -16173,6 +16381,26 @@ module Aws::S3
16173
16381
  #
16174
16382
  # [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
16175
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
+ #
16176
16404
  # @option params [String] :if_none_match
16177
16405
  # Uploads the object only if the object key name does not already exist
16178
16406
  # in the bucket specified. Otherwise, Amazon S3 returns a `412
@@ -16549,134 +16777,134 @@ module Aws::S3
16549
16777
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
16550
16778
  #
16551
16779
  #
16552
- # @example Example: To upload an object and specify optional tags
16780
+ # @example Example: To upload object and specify user-defined metadata
16553
16781
  #
16554
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
16555
- # # S3 returns version ID of the newly created object.
16782
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
16783
+ # # enabled, S3 returns version ID in response.
16556
16784
  #
16557
16785
  # resp = client.put_object({
16558
- # body: "c:\\HappyFace.jpg",
16786
+ # body: "filetoupload",
16559
16787
  # bucket: "examplebucket",
16560
- # key: "HappyFace.jpg",
16561
- # tagging: "key1=value1&key2=value2",
16788
+ # key: "exampleobject",
16789
+ # metadata: {
16790
+ # "metadata1" => "value1",
16791
+ # "metadata2" => "value2",
16792
+ # },
16562
16793
  # })
16563
16794
  #
16564
16795
  # resp.to_h outputs the following:
16565
16796
  # {
16566
16797
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16567
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
16798
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16568
16799
  # }
16569
16800
  #
16570
- # @example Example: To upload an object and specify canned ACL.
16801
+ # @example Example: To upload an object and specify optional tags
16571
16802
  #
16572
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
16573
- # # access to authenticated users. If the bucket is versioning 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.
16574
16805
  #
16575
16806
  # resp = client.put_object({
16576
- # acl: "authenticated-read",
16577
- # body: "filetoupload",
16807
+ # body: "c:\\HappyFace.jpg",
16578
16808
  # bucket: "examplebucket",
16579
- # key: "exampleobject",
16809
+ # key: "HappyFace.jpg",
16810
+ # tagging: "key1=value1&key2=value2",
16580
16811
  # })
16581
16812
  #
16582
16813
  # resp.to_h outputs the following:
16583
16814
  # {
16584
16815
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16585
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
16816
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
16586
16817
  # }
16587
16818
  #
16588
- # @example Example: To upload an object
16819
+ # @example Example: To upload an object (specify optional headers)
16589
16820
  #
16590
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
16591
- # # syntax. S3 returns VersionId of the newly created object.
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.
16592
16823
  #
16593
16824
  # resp = client.put_object({
16594
16825
  # body: "HappyFace.jpg",
16595
16826
  # bucket: "examplebucket",
16596
16827
  # key: "HappyFace.jpg",
16828
+ # server_side_encryption: "AES256",
16829
+ # storage_class: "STANDARD_IA",
16597
16830
  # })
16598
16831
  #
16599
16832
  # resp.to_h outputs the following:
16600
16833
  # {
16601
16834
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16602
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16835
+ # server_side_encryption: "AES256",
16836
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16603
16837
  # }
16604
16838
  #
16605
- # @example Example: To upload object and specify user-defined metadata
16839
+ # @example Example: To upload an object and specify canned ACL.
16606
16840
  #
16607
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
16608
- # # enabled, S3 returns version ID in response.
16841
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
16842
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
16609
16843
  #
16610
16844
  # resp = client.put_object({
16845
+ # acl: "authenticated-read",
16611
16846
  # body: "filetoupload",
16612
16847
  # bucket: "examplebucket",
16613
16848
  # key: "exampleobject",
16614
- # metadata: {
16615
- # "metadata1" => "value1",
16616
- # "metadata2" => "value2",
16617
- # },
16618
16849
  # })
16619
16850
  #
16620
16851
  # resp.to_h outputs the following:
16621
16852
  # {
16622
16853
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16623
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16854
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
16624
16855
  # }
16625
16856
  #
16626
- # @example Example: To create an object.
16857
+ # @example Example: To upload an object
16627
16858
  #
16628
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
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.
16629
16861
  #
16630
16862
  # resp = client.put_object({
16631
- # body: "filetoupload",
16863
+ # body: "HappyFace.jpg",
16632
16864
  # bucket: "examplebucket",
16633
- # key: "objectkey",
16865
+ # key: "HappyFace.jpg",
16634
16866
  # })
16635
16867
  #
16636
16868
  # resp.to_h outputs the following:
16637
16869
  # {
16638
16870
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16639
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
16871
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16640
16872
  # }
16641
16873
  #
16642
- # @example Example: To upload an object (specify optional headers)
16874
+ # @example Example: To upload an object and specify server-side encryption and object tags
16643
16875
  #
16644
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
16645
- # # storage class and use server-side encryption.
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.
16646
16878
  #
16647
16879
  # resp = client.put_object({
16648
- # body: "HappyFace.jpg",
16880
+ # body: "filetoupload",
16649
16881
  # bucket: "examplebucket",
16650
- # key: "HappyFace.jpg",
16882
+ # key: "exampleobject",
16651
16883
  # server_side_encryption: "AES256",
16652
- # storage_class: "STANDARD_IA",
16884
+ # tagging: "key1=value1&key2=value2",
16653
16885
  # })
16654
16886
  #
16655
16887
  # resp.to_h outputs the following:
16656
16888
  # {
16657
16889
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16658
16890
  # server_side_encryption: "AES256",
16659
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16891
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16660
16892
  # }
16661
16893
  #
16662
- # @example Example: To upload an object and specify server-side encryption and object tags
16894
+ # @example Example: To create an object.
16663
16895
  #
16664
- # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
16665
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
16896
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
16666
16897
  #
16667
16898
  # resp = client.put_object({
16668
16899
  # body: "filetoupload",
16669
16900
  # bucket: "examplebucket",
16670
- # key: "exampleobject",
16671
- # server_side_encryption: "AES256",
16672
- # tagging: "key1=value1&key2=value2",
16901
+ # key: "objectkey",
16673
16902
  # })
16674
16903
  #
16675
16904
  # resp.to_h outputs the following:
16676
16905
  # {
16677
16906
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16678
- # server_side_encryption: "AES256",
16679
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16907
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
16680
16908
  # }
16681
16909
  #
16682
16910
  # @example Streaming a file from disk
@@ -16704,6 +16932,7 @@ module Aws::S3
16704
16932
  # checksum_sha1: "ChecksumSHA1",
16705
16933
  # checksum_sha256: "ChecksumSHA256",
16706
16934
  # expires: Time.now,
16935
+ # if_match: "IfMatch",
16707
16936
  # if_none_match: "IfNoneMatch",
16708
16937
  # grant_full_control: "GrantFullControl",
16709
16938
  # grant_read: "GrantRead",
@@ -18639,9 +18868,13 @@ module Aws::S3
18639
18868
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
18640
18869
  # for this API operation to the Zonal endpoint. These endpoints support
18641
18870
  # virtual-hosted-style requests in the format
18642
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
18643
- # Path-style requests are not supported. For more information, see
18644
- # [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*.
18645
18878
  #
18646
18879
  # </note>
18647
18880
  #
@@ -18658,15 +18891,15 @@ module Aws::S3
18658
18891
  # These permissions are required because Amazon S3 must decrypt and
18659
18892
  # read data from the encrypted file parts before it completes the
18660
18893
  # multipart upload. For more information about KMS permissions, see
18661
- # [Protecting data using server-side encryption with KMS][6] in the
18894
+ # [Protecting data using server-side encryption with KMS][7] in the
18662
18895
  # *Amazon S3 User Guide*. For information about the permissions
18663
18896
  # required to use the multipart upload API, see [Multipart upload
18664
- # and permissions][7] and [Multipart upload API and permissions][8]
18897
+ # and permissions][8] and [Multipart upload API and permissions][9]
18665
18898
  # in the *Amazon S3 User Guide*.
18666
18899
  #
18667
18900
  # * **Directory bucket permissions** - To grant access to this API
18668
18901
  # operation on a directory bucket, we recommend that you use the [
18669
- # `CreateSession` ][9] API operation for session-based
18902
+ # `CreateSession` ][10] API operation for session-based
18670
18903
  # authorization. Specifically, you grant the
18671
18904
  # `s3express:CreateSession` permission to the directory bucket in a
18672
18905
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -18677,7 +18910,7 @@ module Aws::S3
18677
18910
  # token for use. Amazon Web Services CLI or SDKs create session and
18678
18911
  # refresh the session token automatically to avoid service
18679
18912
  # interruptions when a session expires. For more information about
18680
- # authorization, see [ `CreateSession` ][9].
18913
+ # authorization, see [ `CreateSession` ][10].
18681
18914
  #
18682
18915
  # If the object is encrypted with SSE-KMS, you must also have the
18683
18916
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -18693,7 +18926,7 @@ module Aws::S3
18693
18926
  # then Amazon Web Services S3 uses the `x-amz-content-sha256` header
18694
18927
  # as a checksum instead of `Content-MD5`. For more information see
18695
18928
  # [Authenticating Requests: Using the Authorization Header (Amazon Web
18696
- # Services Signature Version 4)][10].
18929
+ # Services Signature Version 4)][11].
18697
18930
  #
18698
18931
  # <note markdown="1"> **Directory buckets** - MD5 is not supported by directory buckets.
18699
18932
  # You can use checksum algorithms to check object integrity.
@@ -18733,7 +18966,7 @@ module Aws::S3
18733
18966
  # * x-amz-server-side-encryption-customer-key
18734
18967
  #
18735
18968
  # * x-amz-server-side-encryption-customer-key-MD5
18736
- # For more information, see [Using Server-Side Encryption][11] in
18969
+ # For more information, see [Using Server-Side Encryption][12] in
18737
18970
  # the *Amazon S3 User Guide*.
18738
18971
  #
18739
18972
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -18755,19 +18988,19 @@ module Aws::S3
18755
18988
  # HTTP Host header syntax
18756
18989
  #
18757
18990
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
18758
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
18991
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
18759
18992
  #
18760
18993
  # The following operations are related to `UploadPart`:
18761
18994
  #
18762
18995
  # * [CreateMultipartUpload][2]
18763
18996
  #
18764
- # * [CompleteMultipartUpload][12]
18997
+ # * [CompleteMultipartUpload][13]
18765
18998
  #
18766
- # * [AbortMultipartUpload][13]
18999
+ # * [AbortMultipartUpload][14]
18767
19000
  #
18768
- # * [ListParts][14]
19001
+ # * [ListParts][15]
18769
19002
  #
18770
- # * [ListMultipartUploads][15]
19003
+ # * [ListMultipartUploads][16]
18771
19004
  #
18772
19005
  #
18773
19006
  #
@@ -18776,16 +19009,17 @@ module Aws::S3
18776
19009
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
18777
19010
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
18778
19011
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
18779
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
18780
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
18781
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
18782
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
18783
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
18784
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
18785
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
18786
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
18787
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
18788
- # [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
18789
19023
  #
18790
19024
  # @option params [String, StringIO, File] :body
18791
19025
  # Object data.
@@ -18795,10 +19029,10 @@ module Aws::S3
18795
19029
  #
18796
19030
  # **Directory buckets** - When you use this operation with a directory
18797
19031
  # bucket, you must use virtual-hosted-style requests in the format `
18798
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
18799
- # are not supported. Directory bucket names must be unique in the chosen
18800
- # Availability Zone. Bucket names must follow the format `
18801
- # 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, `
18802
19036
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18803
19037
  # naming restrictions, see [Directory bucket naming rules][1] in the
18804
19038
  # *Amazon S3 User Guide*.
@@ -19079,9 +19313,13 @@ module Aws::S3
19079
19313
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
19080
19314
  # for this API operation to the Zonal endpoint. These endpoints support
19081
19315
  # virtual-hosted-style requests in the format
19082
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
19083
- # Path-style requests are not supported. For more information, see
19084
- # [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*.
19085
19323
  #
19086
19324
  # </note>
19087
19325
  #
@@ -19091,7 +19329,7 @@ module Aws::S3
19091
19329
  # using IAM credentials (access key ID and secret access key for the
19092
19330
  # IAM identities). All headers with the `x-amz-` prefix, including
19093
19331
  # `x-amz-copy-source`, must be signed. For more information, see [REST
19094
- # Authentication][6].
19332
+ # Authentication][7].
19095
19333
  #
19096
19334
  # **Directory buckets** - You must use IAM credentials to authenticate
19097
19335
  # and authorize your access to the `UploadPartCopy` API operation,
@@ -19128,11 +19366,11 @@ module Aws::S3
19128
19366
  # permissions are required because Amazon S3 must decrypt and read
19129
19367
  # data from the encrypted file parts before it completes the
19130
19368
  # multipart upload. For more information about KMS permissions,
19131
- # see [Protecting data using server-side encryption with KMS][7]
19369
+ # see [Protecting data using server-side encryption with KMS][8]
19132
19370
  # in the *Amazon S3 User Guide*. For information about the
19133
19371
  # permissions required to use the multipart upload API, see
19134
- # [Multipart upload and permissions][8] and [Multipart upload API
19135
- # and permissions][9] in the *Amazon S3 User Guide*.
19372
+ # [Multipart upload and permissions][9] and [Multipart upload API
19373
+ # and permissions][10] in the *Amazon S3 User Guide*.
19136
19374
  # * **Directory bucket permissions** - You must have permissions in a
19137
19375
  # bucket policy or an IAM identity-based policy based on the source
19138
19376
  # and destination bucket types in an `UploadPartCopy` operation.
@@ -19155,14 +19393,14 @@ module Aws::S3
19155
19393
  # identity-based policies and KMS key policies for the KMS key.
19156
19394
  #
19157
19395
  # For example policies, see [Example bucket policies for S3 Express
19158
- # One Zone][10] and [Amazon Web Services Identity and Access
19396
+ # One Zone][11] and [Amazon Web Services Identity and Access
19159
19397
  # Management (IAM) identity-based policies for S3 Express One
19160
- # Zone][11] in the *Amazon S3 User Guide*.
19398
+ # Zone][12] in the *Amazon S3 User Guide*.
19161
19399
  #
19162
19400
  # Encryption
19163
19401
  # : * <b>General purpose buckets </b> - For information about using
19164
19402
  # server-side encryption with customer-provided encryption keys with
19165
- # the `UploadPartCopy` operation, see [CopyObject][12] and
19403
+ # the `UploadPartCopy` operation, see [CopyObject][13] and
19166
19404
  # [UploadPart][2].
19167
19405
  #
19168
19406
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -19170,7 +19408,7 @@ module Aws::S3
19170
19408
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
19171
19409
  # server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
19172
19410
  # more information, see [Protecting data with server-side
19173
- # encryption][13] in the *Amazon S3 User Guide*.
19411
+ # encryption][14] in the *Amazon S3 User Guide*.
19174
19412
  #
19175
19413
  # <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
19176
19414
  # operation and an `UploadPartCopy` operation, the request headers
@@ -19182,7 +19420,7 @@ module Aws::S3
19182
19420
  # S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
19183
19421
  # objects from general purpose buckets to directory buckets, from
19184
19422
  # directory buckets to general purpose buckets, or between directory
19185
- # buckets, through [UploadPartCopy][14]. In this case, Amazon S3
19423
+ # buckets, through [UploadPartCopy][15]. In this case, Amazon S3
19186
19424
  # makes a call to KMS every time a copy request is made for a
19187
19425
  # KMS-encrypted object.
19188
19426
  #
@@ -19204,21 +19442,21 @@ module Aws::S3
19204
19442
  # HTTP Host header syntax
19205
19443
  #
19206
19444
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
19207
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
19445
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
19208
19446
  #
19209
19447
  # The following operations are related to `UploadPartCopy`:
19210
19448
  #
19211
- # * [CreateMultipartUpload][15]
19449
+ # * [CreateMultipartUpload][16]
19212
19450
  #
19213
19451
  # * [UploadPart][2]
19214
19452
  #
19215
- # * [CompleteMultipartUpload][16]
19453
+ # * [CompleteMultipartUpload][17]
19216
19454
  #
19217
- # * [AbortMultipartUpload][17]
19455
+ # * [AbortMultipartUpload][18]
19218
19456
  #
19219
- # * [ListParts][18]
19457
+ # * [ListParts][19]
19220
19458
  #
19221
- # * [ListMultipartUploads][19]
19459
+ # * [ListMultipartUploads][20]
19222
19460
  #
19223
19461
  #
19224
19462
  #
@@ -19227,34 +19465,43 @@ module Aws::S3
19227
19465
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
19228
19466
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
19229
19467
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
19230
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
19231
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19232
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
19233
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
19234
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
19235
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
19236
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
19237
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
19238
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
19239
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
19240
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
19241
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
19242
- # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
19243
- # [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
19244
19483
  #
19245
19484
  # @option params [required, String] :bucket
19246
19485
  # The bucket name.
19247
19486
  #
19248
19487
  # **Directory buckets** - When you use this operation with a directory
19249
19488
  # bucket, you must use virtual-hosted-style requests in the format `
19250
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
19251
- # are not supported. Directory bucket names must be unique in the chosen
19252
- # Availability Zone. Bucket names must follow the format `
19253
- # 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, `
19254
19493
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
19255
19494
  # naming restrictions, see [Directory bucket naming rules][1] in the
19256
19495
  # *Amazon S3 User Guide*.
19257
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
+ #
19258
19505
  # **Access points** - When you use this action with an access point, you
19259
19506
  # must provide the alias of the access point in place of the bucket name
19260
19507
  # or specify the access point ARN. When using the access point ARN, you
@@ -20026,7 +20273,7 @@ module Aws::S3
20026
20273
  tracer: tracer
20027
20274
  )
20028
20275
  context[:gem_name] = 'aws-sdk-s3'
20029
- context[:gem_version] = '1.173.0'
20276
+ context[:gem_version] = '1.175.0'
20030
20277
  Seahorse::Client::Request.new(handlers, context)
20031
20278
  end
20032
20279