aws-sdk-s3 1.174.0 → 1.176.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.
@@ -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*.
@@ -1232,9 +1242,13 @@ module Aws::S3
1232
1242
  # * <b>Directory buckets </b> - For directory buckets, you must make
1233
1243
  # requests for this API operation to the Zonal endpoint. These
1234
1244
  # endpoints support virtual-hosted-style requests in the format
1235
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
1236
- # `. Path-style requests are not supported. For more information, see
1237
- # [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*.
1238
1252
  #
1239
1253
  # * VPC endpoints don't support cross-Region requests (including
1240
1254
  # copies). If you're using VPC endpoints, your source and destination
@@ -1246,13 +1260,13 @@ module Aws::S3
1246
1260
  # Both the Region that you want to copy the object from and the Region
1247
1261
  # that you want to copy the object to must be enabled for your account.
1248
1262
  # For more information about how to enable a Region for your account,
1249
- # 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
1250
1264
  # *Amazon Web Services Account Management Guide*.
1251
1265
  #
1252
1266
  # Amazon S3 transfer acceleration does not support cross-Region copies.
1253
1267
  # If you request a cross-Region copy using a transfer acceleration
1254
1268
  # endpoint, you get a `400 Bad Request` error. For more information, see
1255
- # [Transfer Acceleration][4].
1269
+ # [Transfer Acceleration][5].
1256
1270
  #
1257
1271
  # Authentication and authorization
1258
1272
  #
@@ -1260,7 +1274,7 @@ module Aws::S3
1260
1274
  # IAM credentials (access key ID and secret access key for the IAM
1261
1275
  # identities). All headers with the `x-amz-` prefix, including
1262
1276
  # `x-amz-copy-source`, must be signed. For more information, see [REST
1263
- # Authentication][5].
1277
+ # Authentication][6].
1264
1278
  #
1265
1279
  # **Directory buckets** - You must use the IAM credentials to
1266
1280
  # authenticate and authorize your access to the `CopyObject` API
@@ -1308,9 +1322,9 @@ module Aws::S3
1308
1322
  # identity-based policies and KMS key policies for the KMS key.
1309
1323
  #
1310
1324
  # For example policies, see [Example bucket policies for S3 Express
1311
- # One Zone][6] and [Amazon Web Services Identity and Access
1325
+ # One Zone][7] and [Amazon Web Services Identity and Access
1312
1326
  # Management (IAM) identity-based policies for S3 Express One
1313
- # Zone][7] in the *Amazon S3 User Guide*.
1327
+ # Zone][8] in the *Amazon S3 User Guide*.
1314
1328
  #
1315
1329
  # Response and special errors
1316
1330
  #
@@ -1333,7 +1347,7 @@ module Aws::S3
1333
1347
  # response is embedded in the `200 OK` response. For example, in a
1334
1348
  # cross-region copy, you may encounter throttling and receive a
1335
1349
  # `200 OK` response. For more information, see [Resolve the Error
1336
- # 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`
1337
1351
  # status code means the copy was accepted, but it doesn't mean
1338
1352
  # the copy is complete. Another example is when you disconnect
1339
1353
  # from Amazon S3 before the copy is complete, Amazon S3 might
@@ -1357,32 +1371,33 @@ module Aws::S3
1357
1371
  # result in a data retrieval charge for the source if the source
1358
1372
  # storage class bills for data retrieval. If the copy source is in a
1359
1373
  # different region, the data transfer is billed to the copy source
1360
- # account. For pricing information, see [Amazon S3 pricing][9].
1374
+ # account. For pricing information, see [Amazon S3 pricing][10].
1361
1375
  #
1362
1376
  # HTTP Host header syntax
1363
1377
  #
1364
1378
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
1365
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
1379
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
1366
1380
  #
1367
1381
  # The following operations are related to `CopyObject`:
1368
1382
  #
1369
- # * [PutObject][10]
1383
+ # * [PutObject][11]
1370
1384
  #
1371
- # * [GetObject][11]
1385
+ # * [GetObject][12]
1372
1386
  #
1373
1387
  #
1374
1388
  #
1375
1389
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
1376
1390
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
1377
- # [3]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
1378
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
1379
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
1380
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
1381
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
1382
- # [8]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
1383
- # [9]: http://aws.amazon.com/s3/pricing/
1384
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
1385
- # [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
1386
1401
  #
1387
1402
  # @option params [String] :acl
1388
1403
  # The canned access control list (ACL) to apply to the object.
@@ -1422,14 +1437,22 @@ module Aws::S3
1422
1437
  #
1423
1438
  # **Directory buckets** - When you use this operation with a directory
1424
1439
  # bucket, you must use virtual-hosted-style requests in the format `
1425
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
1426
- # are not supported. Directory bucket names must be unique in the chosen
1427
- # Availability Zone. Bucket names must follow the format `
1428
- # 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, `
1429
1444
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1430
1445
  # naming restrictions, see [Directory bucket naming rules][1] in the
1431
1446
  # *Amazon S3 User Guide*.
1432
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
+ #
1433
1456
  # **Access points** - When you use this action with an access point, you
1434
1457
  # must provide the alias of the access point in place of the bucket name
1435
1458
  # or specify the access point ARN. When using the access point ARN, you
@@ -2282,10 +2305,13 @@ module Aws::S3
2282
2305
  # * <b>Directory buckets </b> - For directory buckets, you must make
2283
2306
  # requests for this API operation to the Regional endpoint. These
2284
2307
  # endpoints support path-style requests in the format
2285
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
2308
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2286
2309
  # Virtual-hosted-style requests aren't supported. For more
2287
- # information, see [Regional and Zonal endpoints][4] in the *Amazon S3
2288
- # 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*.
2289
2315
  #
2290
2316
  # </note>
2291
2317
  #
@@ -2327,17 +2353,17 @@ module Aws::S3
2327
2353
  # disabled. If you would like to share data with users outside of
2328
2354
  # your account, you can use bucket policies as needed. For more
2329
2355
  # information, see [Controlling ownership of objects and disabling
2330
- # ACLs for your bucket ][5] and [Blocking public access to your
2331
- # 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*.
2332
2358
  #
2333
2359
  # * **S3 Block Public Access** - If your specific use case requires
2334
2360
  # granting public access to your S3 resources, you can disable
2335
2361
  # Block Public Access. Specifically, you can create a new bucket
2336
2362
  # with Block Public Access enabled, then separately call the [
2337
- # `DeletePublicAccessBlock` ][7] API. To use this operation, you
2363
+ # `DeletePublicAccessBlock` ][8] API. To use this operation, you
2338
2364
  # must have the `s3:PutBucketPublicAccessBlock` permission. For
2339
2365
  # more information about S3 Block Public Access, see [Blocking
2340
- # 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
2341
2367
  # User Guide*.
2342
2368
  # * **Directory bucket permissions** - You must have the
2343
2369
  # `s3express:CreateBucket` permission in an IAM identity-based
@@ -2346,7 +2372,7 @@ module Aws::S3
2346
2372
  # performed by the Amazon Web Services account that owns the
2347
2373
  # resource. For more information about directory bucket policies and
2348
2374
  # permissions, see [Amazon Web Services Identity and Access
2349
- # 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
2350
2376
  # User Guide*.
2351
2377
  #
2352
2378
  # The permissions for ACLs, Object Lock, S3 Object Ownership, and S3
@@ -2356,21 +2382,21 @@ module Aws::S3
2356
2382
  # enforced (ACLs disabled). These settings can't be modified.
2357
2383
  #
2358
2384
  # For more information about permissions for creating and working
2359
- # with directory buckets, see [Directory buckets][9] in the *Amazon
2385
+ # with directory buckets, see [Directory buckets][10] in the *Amazon
2360
2386
  # S3 User Guide*. For more information about supported S3 features
2361
- # for directory buckets, see [Features of S3 Express One Zone][10]
2387
+ # for directory buckets, see [Features of S3 Express One Zone][11]
2362
2388
  # in the *Amazon S3 User Guide*.
2363
2389
  #
2364
2390
  # HTTP Host header syntax
2365
2391
  #
2366
2392
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
2367
- # `s3express-control.region.amazonaws.com`.
2393
+ # `s3express-control.region-code.amazonaws.com`.
2368
2394
  #
2369
2395
  # The following operations are related to `CreateBucket`:
2370
2396
  #
2371
- # * [PutObject][11]
2397
+ # * [PutObject][12]
2372
2398
  #
2373
- # * [DeleteBucket][12]
2399
+ # * [DeleteBucket][13]
2374
2400
  #
2375
2401
  #
2376
2402
  #
@@ -2378,14 +2404,15 @@ module Aws::S3
2378
2404
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
2379
2405
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
2380
2406
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2381
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2382
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
2383
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
2384
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
2385
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
2386
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
2387
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
2388
- # [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
2389
2416
  #
2390
2417
  # @option params [String] :acl
2391
2418
  # The canned ACL to apply to the bucket.
@@ -2403,13 +2430,14 @@ module Aws::S3
2403
2430
  #
2404
2431
  # <b>Directory buckets </b> - When you use this operation with a
2405
2432
  # directory bucket, you must use path-style requests in the format
2406
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
2433
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2407
2434
  # Virtual-hosted-style requests aren't supported. Directory bucket
2408
- # names must be unique in the chosen Availability Zone. Bucket names
2409
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
2410
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
2411
- # bucket naming restrictions, see [Directory bucket naming rules][2] in
2412
- # 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*
2413
2441
  #
2414
2442
  #
2415
2443
  #
@@ -2506,33 +2534,33 @@ module Aws::S3
2506
2534
  # * {Types::CreateBucketOutput#location #location} => String
2507
2535
  #
2508
2536
  #
2509
- # @example Example: To create a bucket
2537
+ # @example Example: To create a bucket in a specific region
2510
2538
  #
2511
- # # The following example creates a bucket.
2539
+ # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
2512
2540
  #
2513
2541
  # resp = client.create_bucket({
2514
2542
  # bucket: "examplebucket",
2543
+ # create_bucket_configuration: {
2544
+ # location_constraint: "eu-west-1",
2545
+ # },
2515
2546
  # })
2516
2547
  #
2517
2548
  # resp.to_h outputs the following:
2518
2549
  # {
2519
- # location: "/examplebucket",
2550
+ # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
2520
2551
  # }
2521
2552
  #
2522
- # @example Example: To create a bucket in a specific region
2553
+ # @example Example: To create a bucket
2523
2554
  #
2524
- # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
2555
+ # # The following example creates a bucket.
2525
2556
  #
2526
2557
  # resp = client.create_bucket({
2527
2558
  # bucket: "examplebucket",
2528
- # create_bucket_configuration: {
2529
- # location_constraint: "eu-west-1",
2530
- # },
2531
2559
  # })
2532
2560
  #
2533
2561
  # resp.to_h outputs the following:
2534
2562
  # {
2535
- # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
2563
+ # location: "/examplebucket",
2536
2564
  # }
2537
2565
  #
2538
2566
  # @example Request syntax with placeholder values
@@ -2543,11 +2571,11 @@ module Aws::S3
2543
2571
  # create_bucket_configuration: {
2544
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
2545
2573
  # location: {
2546
- # type: "AvailabilityZone", # accepts AvailabilityZone
2574
+ # type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
2547
2575
  # name: "LocationNameAsString",
2548
2576
  # },
2549
2577
  # bucket: {
2550
- # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone
2578
+ # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
2551
2579
  # type: "Directory", # accepts Directory
2552
2580
  # },
2553
2581
  # },
@@ -2573,6 +2601,90 @@ module Aws::S3
2573
2601
  req.send_request(options)
2574
2602
  end
2575
2603
 
2604
+ # Creates a metadata table configuration for a general purpose bucket.
2605
+ # For more information, see [Accelerating data discovery with S3
2606
+ # Metadata][1] in the *Amazon S3 User Guide*.
2607
+ #
2608
+ # Permissions
2609
+ #
2610
+ # : To use this operation, you must have the following permissions. For
2611
+ # more information, see [Setting up permissions for configuring
2612
+ # metadata tables][2] in the *Amazon S3 User Guide*.
2613
+ #
2614
+ # If you also want to integrate your table bucket with Amazon Web
2615
+ # Services analytics services so that you can query your metadata
2616
+ # table, you need additional permissions. For more information, see [
2617
+ # Integrating Amazon S3 Tables with Amazon Web Services analytics
2618
+ # services][3] in the *Amazon S3 User Guide*.
2619
+ #
2620
+ # * `s3:CreateBucketMetadataTableConfiguration`
2621
+ #
2622
+ # * `s3tables:CreateNamespace`
2623
+ #
2624
+ # * `s3tables:GetTable`
2625
+ #
2626
+ # * `s3tables:CreateTable`
2627
+ #
2628
+ # * `s3tables:PutTablePolicy`
2629
+ #
2630
+ # The following operations are related to
2631
+ # `CreateBucketMetadataTableConfiguration`:
2632
+ #
2633
+ # * [DeleteBucketMetadataTableConfiguration][4]
2634
+ #
2635
+ # * [GetBucketMetadataTableConfiguration][5]
2636
+ #
2637
+ #
2638
+ #
2639
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
2640
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
2641
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-aws.html
2642
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
2643
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
2644
+ #
2645
+ # @option params [required, String] :bucket
2646
+ # The general purpose bucket that you want to create the metadata table
2647
+ # configuration in.
2648
+ #
2649
+ # @option params [String] :content_md5
2650
+ # The `Content-MD5` header for the metadata table configuration.
2651
+ #
2652
+ # @option params [String] :checksum_algorithm
2653
+ # The checksum algorithm to use with your metadata table configuration.
2654
+ #
2655
+ # @option params [required, Types::MetadataTableConfiguration] :metadata_table_configuration
2656
+ # The contents of your metadata table configuration.
2657
+ #
2658
+ # @option params [String] :expected_bucket_owner
2659
+ # The expected owner of the general purpose bucket that contains your
2660
+ # metadata table configuration.
2661
+ #
2662
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2663
+ #
2664
+ # @example Request syntax with placeholder values
2665
+ #
2666
+ # resp = client.create_bucket_metadata_table_configuration({
2667
+ # bucket: "BucketName", # required
2668
+ # content_md5: "ContentMD5",
2669
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
2670
+ # metadata_table_configuration: { # required
2671
+ # s3_tables_destination: { # required
2672
+ # table_bucket_arn: "S3TablesBucketArn", # required
2673
+ # table_name: "S3TablesName", # required
2674
+ # },
2675
+ # },
2676
+ # expected_bucket_owner: "AccountId",
2677
+ # })
2678
+ #
2679
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketMetadataTableConfiguration AWS API Documentation
2680
+ #
2681
+ # @overload create_bucket_metadata_table_configuration(params = {})
2682
+ # @param [Hash] params ({})
2683
+ def create_bucket_metadata_table_configuration(params = {}, options = {})
2684
+ req = build_request(:create_bucket_metadata_table_configuration, params)
2685
+ req.send_request(options)
2686
+ end
2687
+
2576
2688
  # This action initiates a multipart upload and returns an upload ID.
2577
2689
  # This upload ID is used to associate all of the parts in the specific
2578
2690
  # multipart upload. You specify this upload ID in each of your
@@ -2604,9 +2716,13 @@ module Aws::S3
2604
2716
  # * <b>Directory buckets </b> - For directory buckets, you must make
2605
2717
  # requests for this API operation to the Zonal endpoint. These
2606
2718
  # endpoints support virtual-hosted-style requests in the format
2607
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
2608
- # `. Path-style requests are not supported. For more information, see
2609
- # [Regional and Zonal endpoints][4] in the *Amazon S3 User Guide*.
2719
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
2720
+ # `. Path-style requests are not supported. For more information about
2721
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
2722
+ # for directory buckets in Availability Zones][4] in the *Amazon S3
2723
+ # User Guide*. For more information about endpoints in Local Zones,
2724
+ # see [Available Local Zone for directory buckets][5] in the *Amazon
2725
+ # S3 User Guide*.
2610
2726
  #
2611
2727
  # </note>
2612
2728
  #
@@ -2618,7 +2734,7 @@ module Aws::S3
2618
2734
  # sign each request individually. There is nothing special about
2619
2735
  # signing multipart upload requests. For more information about
2620
2736
  # signing, see [Authenticating Requests (Amazon Web Services Signature
2621
- # Version 4)][5] in the *Amazon S3 User Guide*.
2737
+ # Version 4)][6] in the *Amazon S3 User Guide*.
2622
2738
  #
2623
2739
  # Permissions
2624
2740
  # : * **General purpose bucket permissions** - To perform a multipart
@@ -2631,13 +2747,13 @@ module Aws::S3
2631
2747
  # `UploadPartCopy` APIs. These permissions are required because
2632
2748
  # Amazon S3 must decrypt and read data from the encrypted file parts
2633
2749
  # before it completes the multipart upload. For more information,
2634
- # see [Multipart upload API and permissions][6] and [Protecting data
2635
- # using server-side encryption with Amazon Web Services KMS][7] in
2750
+ # see [Multipart upload API and permissions][7] and [Protecting data
2751
+ # using server-side encryption with Amazon Web Services KMS][8] in
2636
2752
  # the *Amazon S3 User Guide*.
2637
2753
  #
2638
2754
  # * **Directory bucket permissions** - To grant access to this API
2639
2755
  # operation on a directory bucket, we recommend that you use the [
2640
- # `CreateSession` ][8] API operation for session-based
2756
+ # `CreateSession` ][9] API operation for session-based
2641
2757
  # authorization. Specifically, you grant the
2642
2758
  # `s3express:CreateSession` permission to the directory bucket in a
2643
2759
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -2648,7 +2764,7 @@ module Aws::S3
2648
2764
  # token for use. Amazon Web Services CLI or SDKs create session and
2649
2765
  # refresh the session token automatically to avoid service
2650
2766
  # interruptions when a session expires. For more information about
2651
- # authorization, see [ `CreateSession` ][8].
2767
+ # authorization, see [ `CreateSession` ][9].
2652
2768
  #
2653
2769
  # Encryption
2654
2770
  # : * **General purpose buckets** - Server-side encryption is for data
@@ -2675,7 +2791,7 @@ module Aws::S3
2675
2791
  # the destination bucket, the encryption setting in your request
2676
2792
  # takes precedence. If you choose to provide your own encryption
2677
2793
  # key, the request headers you provide in [UploadPart][1] and
2678
- # [UploadPartCopy][9] requests must match the headers you used in
2794
+ # [UploadPartCopy][10] requests must match the headers you used in
2679
2795
  # the `CreateMultipartUpload` request.
2680
2796
  #
2681
2797
  # * Use KMS keys (SSE-KMS) that include the Amazon Web Services
@@ -2700,9 +2816,9 @@ module Aws::S3
2700
2816
  # actions on the key. These permissions are required because
2701
2817
  # Amazon S3 must decrypt and read data from the encrypted file
2702
2818
  # parts before it completes the multipart upload. For more
2703
- # information, see [Multipart upload API and permissions][6] and
2819
+ # information, see [Multipart upload API and permissions][7] and
2704
2820
  # [Protecting data using server-side encryption with Amazon Web
2705
- # Services KMS][7] in the *Amazon S3 User Guide*.
2821
+ # Services KMS][8] in the *Amazon S3 User Guide*.
2706
2822
  #
2707
2823
  # * If your Identity and Access Management (IAM) user or role is
2708
2824
  # in the same Amazon Web Services account as the KMS key, then
@@ -2717,13 +2833,13 @@ module Aws::S3
2717
2833
  # For information about configuring any of the officially
2718
2834
  # supported Amazon Web Services SDKs and Amazon Web Services
2719
2835
  # CLI, see [Specifying the Signature Version in Request
2720
- # Authentication][10] in the *Amazon S3 User Guide*.
2836
+ # Authentication][11] in the *Amazon S3 User Guide*.
2721
2837
  #
2722
2838
  # </note>
2723
2839
  #
2724
2840
  # For more information about server-side encryption with KMS keys
2725
2841
  # (SSE-KMS), see [Protecting Data Using Server-Side Encryption
2726
- # with KMS keys][7] in the *Amazon S3 User Guide*.
2842
+ # with KMS keys][8] in the *Amazon S3 User Guide*.
2727
2843
  #
2728
2844
  # * Use customer-provided encryption keys (SSE-C) – If you want to
2729
2845
  # manage your own encryption keys, provide all the following
@@ -2737,7 +2853,7 @@ module Aws::S3
2737
2853
  # For more information about server-side encryption with
2738
2854
  # customer-provided encryption keys (SSE-C), see [ Protecting data
2739
2855
  # using server-side encryption with customer-provided encryption
2740
- # keys (SSE-C)][11] in the *Amazon S3 User Guide*.
2856
+ # keys (SSE-C)][12] in the *Amazon S3 User Guide*.
2741
2857
  # * **Directory buckets** - For directory buckets, there are only two
2742
2858
  # supported options for server-side encryption: server-side
2743
2859
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
@@ -2747,13 +2863,13 @@ module Aws::S3
2747
2863
  # default encryption in your `CreateSession` requests or `PUT`
2748
2864
  # object requests. Then, new objects are automatically encrypted
2749
2865
  # with the desired encryption settings. For more information, see
2750
- # [Protecting data with server-side encryption][12] in the *Amazon
2866
+ # [Protecting data with server-side encryption][13] in the *Amazon
2751
2867
  # S3 User Guide*. For more information about the encryption
2752
2868
  # overriding behaviors in directory buckets, see [Specifying
2753
- # server-side encryption with KMS for new object uploads][13].
2869
+ # server-side encryption with KMS for new object uploads][14].
2754
2870
  #
2755
- # In the Zonal endpoint API calls (except [CopyObject][14] and
2756
- # [UploadPartCopy][9]) using the REST API, the encryption request
2871
+ # In the Zonal endpoint API calls (except [CopyObject][15] and
2872
+ # [UploadPartCopy][10]) using the REST API, the encryption request
2757
2873
  # headers must match the encryption settings that are specified in
2758
2874
  # the `CreateSession` request. You can't override the values of the
2759
2875
  # encryption settings (`x-amz-server-side-encryption`,
@@ -2773,7 +2889,7 @@ module Aws::S3
2773
2889
  # configuration for the `CreateSession` request. It's not supported
2774
2890
  # to override the encryption settings values in the `CreateSession`
2775
2891
  # request. So in the Zonal endpoint API calls (except
2776
- # [CopyObject][14] and [UploadPartCopy][9]), the encryption request
2892
+ # [CopyObject][15] and [UploadPartCopy][10]), the encryption request
2777
2893
  # headers must match the default encryption configuration of the
2778
2894
  # directory bucket.
2779
2895
  #
@@ -2789,19 +2905,19 @@ module Aws::S3
2789
2905
  # HTTP Host header syntax
2790
2906
  #
2791
2907
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
2792
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
2908
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
2793
2909
  #
2794
2910
  # The following operations are related to `CreateMultipartUpload`:
2795
2911
  #
2796
2912
  # * [UploadPart][1]
2797
2913
  #
2798
- # * [CompleteMultipartUpload][15]
2914
+ # * [CompleteMultipartUpload][16]
2799
2915
  #
2800
- # * [AbortMultipartUpload][16]
2916
+ # * [AbortMultipartUpload][17]
2801
2917
  #
2802
- # * [ListParts][17]
2918
+ # * [ListParts][18]
2803
2919
  #
2804
- # * [ListMultipartUploads][18]
2920
+ # * [ListMultipartUploads][19]
2805
2921
  #
2806
2922
  #
2807
2923
  #
@@ -2809,20 +2925,21 @@ module Aws::S3
2809
2925
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
2810
2926
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
2811
2927
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2812
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
2813
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
2814
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
2815
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
2816
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
2817
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
2818
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
2819
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
2820
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
2821
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
2822
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
2823
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
2824
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
2825
- # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
2928
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
2929
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
2930
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
2931
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
2932
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
2933
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
2934
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
2935
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
2936
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
2937
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
2938
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
2939
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
2940
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
2941
+ # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
2942
+ # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
2826
2943
  #
2827
2944
  # @option params [String] :acl
2828
2945
  # The canned ACL to apply to the object. Amazon S3 supports a set of
@@ -2855,10 +2972,10 @@ module Aws::S3
2855
2972
  #
2856
2973
  # **Directory buckets** - When you use this operation with a directory
2857
2974
  # bucket, you must use virtual-hosted-style requests in the format `
2858
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
2859
- # are not supported. Directory bucket names must be unique in the chosen
2860
- # Availability Zone. Bucket names must follow the format `
2861
- # bucket_base_name--az-id--x-s3` (for example, `
2975
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
2976
+ # requests are not supported. Directory bucket names must be unique in
2977
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
2978
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
2862
2979
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
2863
2980
  # naming restrictions, see [Directory bucket naming rules][1] in the
2864
2981
  # *Amazon S3 User Guide*.
@@ -3555,23 +3672,27 @@ module Aws::S3
3555
3672
  #
3556
3673
  # <note markdown="1"> * You must make requests for this API operation to the Zonal endpoint.
3557
3674
  # These endpoints support virtual-hosted-style requests in the format
3558
- # `https://bucket_name.s3express-az_id.region.amazonaws.com`.
3559
- # Path-style requests are not supported. For more information, see
3560
- # [Regional and Zonal endpoints][3] in the *Amazon S3 User Guide*.
3675
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
3676
+ # Path-style requests are not supported. For more information about
3677
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
3678
+ # for directory buckets in Availability Zones][3] in the *Amazon S3
3679
+ # User Guide*. For more information about endpoints in Local Zones,
3680
+ # see [Available Local Zone for directory buckets][4] in the *Amazon
3681
+ # S3 User Guide*.
3561
3682
  #
3562
3683
  # * <b> <code>CopyObject</code> API operation</b> - Unlike other Zonal
3563
3684
  # endpoint API operations, the `CopyObject` API operation doesn't use
3564
3685
  # the temporary security credentials returned from the `CreateSession`
3565
3686
  # API operation for authentication and authorization. For information
3566
3687
  # about authentication and authorization of the `CopyObject` API
3567
- # operation on directory buckets, see [CopyObject][4].
3688
+ # operation on directory buckets, see [CopyObject][5].
3568
3689
  #
3569
3690
  # * <b> <code>HeadBucket</code> API operation</b> - Unlike other Zonal
3570
3691
  # endpoint API operations, the `HeadBucket` API operation doesn't use
3571
3692
  # the temporary security credentials returned from the `CreateSession`
3572
3693
  # API operation for authentication and authorization. For information
3573
3694
  # about authentication and authorization of the `HeadBucket` API
3574
- # operation on directory buckets, see [HeadBucket][5].
3695
+ # operation on directory buckets, see [HeadBucket][6].
3575
3696
  #
3576
3697
  # </note>
3577
3698
  #
@@ -3583,10 +3704,10 @@ module Aws::S3
3583
3704
  # can have the `s3express:SessionMode` condition key to control who
3584
3705
  # can create a `ReadWrite` or `ReadOnly` session. For more information
3585
3706
  # about `ReadWrite` or `ReadOnly` sessions, see [
3586
- # `x-amz-create-session-mode` ][6]. For example policies, see [Example
3587
- # bucket policies for S3 Express One Zone][7] and [Amazon Web Services
3707
+ # `x-amz-create-session-mode` ][7]. For example policies, see [Example
3708
+ # bucket policies for S3 Express One Zone][8] and [Amazon Web Services
3588
3709
  # Identity and Access Management (IAM) identity-based policies for S3
3589
- # Express One Zone][8] in the *Amazon S3 User Guide*.
3710
+ # Express One Zone][9] in the *Amazon S3 User Guide*.
3590
3711
  #
3591
3712
  # To grant cross-account access to Zonal endpoint API operations, the
3592
3713
  # bucket policy should also grant both accounts the
@@ -3607,32 +3728,32 @@ module Aws::S3
3607
3728
  # requests or `PUT` object requests. Then, new objects are
3608
3729
  # automatically encrypted with the desired encryption settings. For
3609
3730
  # more information, see [Protecting data with server-side
3610
- # encryption][9] in the *Amazon S3 User Guide*. For more information
3731
+ # encryption][10] in the *Amazon S3 User Guide*. For more information
3611
3732
  # about the encryption overriding behaviors in directory buckets, see
3612
3733
  # [Specifying server-side encryption with KMS for new object
3613
- # uploads][10].
3734
+ # uploads][11].
3614
3735
  #
3615
- # For [Zonal endpoint (object-level) API operations][11] except
3616
- # [CopyObject][4] and [UploadPartCopy][12], you authenticate and
3617
- # authorize requests through [CreateSession][13] for low latency. To
3736
+ # For [Zonal endpoint (object-level) API operations][12] except
3737
+ # [CopyObject][5] and [UploadPartCopy][13], you authenticate and
3738
+ # authorize requests through [CreateSession][14] for low latency. To
3618
3739
  # encrypt new objects in a directory bucket with SSE-KMS, you must
3619
3740
  # specify SSE-KMS as the directory bucket's default encryption
3620
3741
  # configuration with a KMS key (specifically, a [customer managed
3621
- # key][14]). Then, when a session is created for Zonal endpoint API
3742
+ # key][15]). Then, when a session is created for Zonal endpoint API
3622
3743
  # operations, new objects are automatically encrypted and decrypted
3623
3744
  # with SSE-KMS and S3 Bucket Keys during the session.
3624
3745
  #
3625
- # <note markdown="1"> Only 1 [customer managed key][14] is supported per directory bucket
3746
+ # <note markdown="1"> Only 1 [customer managed key][15] is supported per directory bucket
3626
3747
  # for the lifetime of the bucket. The [Amazon Web Services managed
3627
- # key][15] (`aws/s3`) isn't supported. After you specify SSE-KMS as
3748
+ # key][16] (`aws/s3`) isn't supported. After you specify SSE-KMS as
3628
3749
  # your bucket's default encryption configuration with a customer
3629
3750
  # managed key, you can't change the customer managed key for the
3630
3751
  # bucket's SSE-KMS configuration.
3631
3752
  #
3632
3753
  # </note>
3633
3754
  #
3634
- # In the Zonal endpoint API calls (except [CopyObject][4] and
3635
- # [UploadPartCopy][12]) using the REST API, you can't override the
3755
+ # In the Zonal endpoint API calls (except [CopyObject][5] and
3756
+ # [UploadPartCopy][13]) using the REST API, you can't override the
3636
3757
  # values of the encryption settings (`x-amz-server-side-encryption`,
3637
3758
  # `x-amz-server-side-encryption-aws-kms-key-id`,
3638
3759
  # `x-amz-server-side-encryption-context`, and
@@ -3648,8 +3769,8 @@ module Aws::S3
3648
3769
  # Web Services SDKs use the bucket's default encryption configuration
3649
3770
  # for the `CreateSession` request. It's not supported to override the
3650
3771
  # encryption settings values in the `CreateSession` request. Also, in
3651
- # the Zonal endpoint API calls (except [CopyObject][4] and
3652
- # [UploadPartCopy][12]), it's not supported to override the values of
3772
+ # the Zonal endpoint API calls (except [CopyObject][5] and
3773
+ # [UploadPartCopy][13]), it's not supported to override the values of
3653
3774
  # the encryption settings from the `CreateSession` request.
3654
3775
  #
3655
3776
  # </note>
@@ -3657,25 +3778,26 @@ module Aws::S3
3657
3778
  # HTTP Host header syntax
3658
3779
  #
3659
3780
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
3660
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
3781
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
3661
3782
  #
3662
3783
  #
3663
3784
  #
3664
3785
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
3665
3786
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-optimizing-performance-guidelines-design-patterns.html#s3-express-optimizing-performance-session-authentication
3666
3787
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
3667
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
3668
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
3669
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
3670
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
3671
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
3672
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3673
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
3674
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
3675
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
3676
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
3677
- # [14]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
3678
- # [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
3788
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
3789
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
3790
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
3791
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
3792
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
3793
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
3794
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3795
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
3796
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
3797
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
3798
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
3799
+ # [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
3800
+ # [16]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
3679
3801
  #
3680
3802
  # @option params [String] :session_mode
3681
3803
  # Specifies the mode of the session that will be created, either
@@ -3817,10 +3939,13 @@ module Aws::S3
3817
3939
  # * <b>Directory buckets </b> - For directory buckets, you must make
3818
3940
  # requests for this API operation to the Regional endpoint. These
3819
3941
  # endpoints support path-style requests in the format
3820
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
3942
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
3821
3943
  # Virtual-hosted-style requests aren't supported. For more
3822
- # information, see [Regional and Zonal endpoints][1] in the *Amazon S3
3823
- # User Guide*.
3944
+ # information about endpoints in Availability Zones, see [Regional and
3945
+ # Zonal endpoints for directory buckets in Availability Zones][1] in
3946
+ # the *Amazon S3 User Guide*. For more information about endpoints in
3947
+ # Local Zones, see [Available Local Zone for directory buckets][2] in
3948
+ # the *Amazon S3 User Guide*.
3824
3949
  #
3825
3950
  # </note>
3826
3951
  #
@@ -3835,39 +3960,41 @@ module Aws::S3
3835
3960
  # performed by the Amazon Web Services account that owns the
3836
3961
  # resource. For more information about directory bucket policies and
3837
3962
  # permissions, see [Amazon Web Services Identity and Access
3838
- # Management (IAM) for S3 Express One Zone][2] in the *Amazon S3
3963
+ # Management (IAM) for S3 Express One Zone][3] in the *Amazon S3
3839
3964
  # User Guide*.
3840
3965
  #
3841
3966
  # HTTP Host header syntax
3842
3967
  #
3843
3968
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
3844
- # `s3express-control.region.amazonaws.com`.
3969
+ # `s3express-control.region-code.amazonaws.com`.
3845
3970
  #
3846
3971
  # The following operations are related to `DeleteBucket`:
3847
3972
  #
3848
- # * [CreateBucket][3]
3973
+ # * [CreateBucket][4]
3849
3974
  #
3850
- # * [DeleteObject][4]
3975
+ # * [DeleteObject][5]
3851
3976
  #
3852
3977
  #
3853
3978
  #
3854
3979
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
3855
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
3856
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
3857
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
3980
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
3981
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
3982
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
3983
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
3858
3984
  #
3859
3985
  # @option params [required, String] :bucket
3860
3986
  # Specifies the bucket being deleted.
3861
3987
  #
3862
3988
  # <b>Directory buckets </b> - When you use this operation with a
3863
3989
  # directory bucket, you must use path-style requests in the format
3864
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
3990
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
3865
3991
  # Virtual-hosted-style requests aren't supported. Directory bucket
3866
- # names must be unique in the chosen Availability Zone. Bucket names
3867
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
3868
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
3869
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
3870
- # the *Amazon S3 User Guide*
3992
+ # names must be unique in the chosen Zone (Availability Zone or Local
3993
+ # Zone). Bucket names must also follow the format `
3994
+ # bucket-base-name--zone-id--x-s3` (for example, `
3995
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
3996
+ # naming restrictions, see [Directory bucket naming rules][1] in the
3997
+ # *Amazon S3 User Guide*
3871
3998
  #
3872
3999
  #
3873
4000
  #
@@ -4076,7 +4203,7 @@ module Aws::S3
4076
4203
  # HTTP Host header syntax
4077
4204
  #
4078
4205
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
4079
- # `s3express-control.region.amazonaws.com`.
4206
+ # `s3express-control.region-code.amazonaws.com`.
4080
4207
  #
4081
4208
  # The following operations are related to `DeleteBucketEncryption`:
4082
4209
  #
@@ -4100,13 +4227,14 @@ module Aws::S3
4100
4227
  #
4101
4228
  # <b>Directory buckets </b> - When you use this operation with a
4102
4229
  # directory bucket, you must use path-style requests in the format
4103
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4230
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4104
4231
  # Virtual-hosted-style requests aren't supported. Directory bucket
4105
- # names must be unique in the chosen Availability Zone. Bucket names
4106
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
4107
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
4108
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
4109
- # the *Amazon S3 User Guide*
4232
+ # names must be unique in the chosen Zone (Availability Zone or Local
4233
+ # Zone). Bucket names must also follow the format `
4234
+ # bucket-base-name--zone-id--x-s3` (for example, `
4235
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4236
+ # naming restrictions, see [Directory bucket naming rules][1] in the
4237
+ # *Amazon S3 User Guide*
4110
4238
  #
4111
4239
  #
4112
4240
  #
@@ -4308,10 +4436,13 @@ module Aws::S3
4308
4436
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
4309
4437
  # requests for this API operation to the Regional endpoint. These
4310
4438
  # endpoints support path-style requests in the format
4311
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
4439
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
4312
4440
  # `. Virtual-hosted-style requests aren't supported. For more
4313
- # information, see [Regional and Zonal endpoints][3] in the *Amazon
4314
- # S3 User Guide*.
4441
+ # information about endpoints in Availability Zones, see [Regional
4442
+ # and Zonal endpoints for directory buckets in Availability
4443
+ # Zones][3] in the *Amazon S3 User Guide*. For more information
4444
+ # about endpoints in Local Zones, see [Available Local Zone for
4445
+ # directory buckets][4] in the *Amazon S3 User Guide*.
4315
4446
  #
4316
4447
  # </note>
4317
4448
  # ^
@@ -4322,22 +4453,23 @@ module Aws::S3
4322
4453
  # `s3express-control.region.amazonaws.com`.
4323
4454
  #
4324
4455
  # For more information about the object expiration, see [Elements to
4325
- # Describe Lifecycle Actions][4].
4456
+ # Describe Lifecycle Actions][5].
4326
4457
  #
4327
4458
  # Related actions include:
4328
4459
  #
4329
- # * [PutBucketLifecycleConfiguration][5]
4460
+ # * [PutBucketLifecycleConfiguration][6]
4330
4461
  #
4331
- # * [GetBucketLifecycleConfiguration][6]
4462
+ # * [GetBucketLifecycleConfiguration][7]
4332
4463
  #
4333
4464
  #
4334
4465
  #
4335
4466
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
4336
4467
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4337
4468
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4338
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
4339
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
4340
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
4469
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
4470
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
4471
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
4472
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
4341
4473
  #
4342
4474
  # @option params [required, String] :bucket
4343
4475
  # The bucket name of the lifecycle to delete.
@@ -4379,6 +4511,57 @@ module Aws::S3
4379
4511
  req.send_request(options)
4380
4512
  end
4381
4513
 
4514
+ # Deletes a metadata table configuration from a general purpose bucket.
4515
+ # For more information, see [Accelerating data discovery with S3
4516
+ # Metadata][1] in the *Amazon S3 User Guide*.
4517
+ #
4518
+ # Permissions
4519
+ #
4520
+ # : To use this operation, you must have the
4521
+ # `s3:DeleteBucketMetadataTableConfiguration` permission. For more
4522
+ # information, see [Setting up permissions for configuring metadata
4523
+ # tables][2] in the *Amazon S3 User Guide*.
4524
+ #
4525
+ # The following operations are related to
4526
+ # `DeleteBucketMetadataTableConfiguration`:
4527
+ #
4528
+ # * [CreateBucketMetadataTableConfiguration][3]
4529
+ #
4530
+ # * [GetBucketMetadataTableConfiguration][4]
4531
+ #
4532
+ #
4533
+ #
4534
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
4535
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
4536
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataTableConfiguration.html
4537
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
4538
+ #
4539
+ # @option params [required, String] :bucket
4540
+ # The general purpose bucket that you want to remove the metadata table
4541
+ # configuration from.
4542
+ #
4543
+ # @option params [String] :expected_bucket_owner
4544
+ # The expected bucket owner of the general purpose bucket that you want
4545
+ # to remove the metadata table configuration from.
4546
+ #
4547
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4548
+ #
4549
+ # @example Request syntax with placeholder values
4550
+ #
4551
+ # resp = client.delete_bucket_metadata_table_configuration({
4552
+ # bucket: "BucketName", # required
4553
+ # expected_bucket_owner: "AccountId",
4554
+ # })
4555
+ #
4556
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetadataTableConfiguration AWS API Documentation
4557
+ #
4558
+ # @overload delete_bucket_metadata_table_configuration(params = {})
4559
+ # @param [Hash] params ({})
4560
+ def delete_bucket_metadata_table_configuration(params = {}, options = {})
4561
+ req = build_request(:delete_bucket_metadata_table_configuration, params)
4562
+ req.send_request(options)
4563
+ end
4564
+
4382
4565
  # <note markdown="1"> This operation is not supported for directory buckets.
4383
4566
  #
4384
4567
  # </note>
@@ -4504,9 +4687,13 @@ module Aws::S3
4504
4687
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
4505
4688
  # requests for this API operation to the Regional endpoint. These
4506
4689
  # endpoints support path-style requests in the format
4507
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4508
- # Virtual-hosted-style requests aren't supported. For more information,
4509
- # see [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
4690
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4691
+ # Virtual-hosted-style requests aren't supported. For more information
4692
+ # about endpoints in Availability Zones, see [Regional and Zonal
4693
+ # endpoints for directory buckets in Availability Zones][1] in the
4694
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
4695
+ # Zones, see [Available Local Zone for directory buckets][2] in the
4696
+ # *Amazon S3 User Guide*.
4510
4697
  #
4511
4698
  # </note>
4512
4699
  #
@@ -4536,7 +4723,7 @@ module Aws::S3
4536
4723
  # * **General purpose bucket permissions** - The
4537
4724
  # `s3:DeleteBucketPolicy` permission is required in a policy. For
4538
4725
  # more information about general purpose buckets bucket policies,
4539
- # see [Using Bucket Policies and User Policies][2] in the *Amazon S3
4726
+ # see [Using Bucket Policies and User Policies][3] in the *Amazon S3
4540
4727
  # User Guide*.
4541
4728
  #
4542
4729
  # * **Directory bucket permissions** - To grant access to this API
@@ -4547,39 +4734,41 @@ module Aws::S3
4547
4734
  # Services account that owns the resource. For more information
4548
4735
  # about directory bucket policies and permissions, see [Amazon Web
4549
4736
  # Services Identity and Access Management (IAM) for S3 Express One
4550
- # Zone][3] in the *Amazon S3 User Guide*.
4737
+ # Zone][4] in the *Amazon S3 User Guide*.
4551
4738
  #
4552
4739
  # HTTP Host header syntax
4553
4740
  #
4554
4741
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
4555
- # `s3express-control.region.amazonaws.com`.
4742
+ # `s3express-control.region-code.amazonaws.com`.
4556
4743
  #
4557
4744
  # The following operations are related to `DeleteBucketPolicy`
4558
4745
  #
4559
- # * [CreateBucket][4]
4746
+ # * [CreateBucket][5]
4560
4747
  #
4561
- # * [DeleteObject][5]
4748
+ # * [DeleteObject][6]
4562
4749
  #
4563
4750
  #
4564
4751
  #
4565
4752
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4566
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
4567
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4568
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
4569
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
4753
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
4754
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
4755
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4756
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
4757
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
4570
4758
  #
4571
4759
  # @option params [required, String] :bucket
4572
4760
  # The bucket name.
4573
4761
  #
4574
4762
  # <b>Directory buckets </b> - When you use this operation with a
4575
4763
  # directory bucket, you must use path-style requests in the format
4576
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4764
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4577
4765
  # Virtual-hosted-style requests aren't supported. Directory bucket
4578
- # names must be unique in the chosen Availability Zone. Bucket names
4579
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
4580
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
4581
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
4582
- # the *Amazon S3 User Guide*
4766
+ # names must be unique in the chosen Zone (Availability Zone or Local
4767
+ # Zone). Bucket names must also follow the format `
4768
+ # bucket-base-name--zone-id--x-s3` (for example, `
4769
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4770
+ # naming restrictions, see [Directory bucket naming rules][1] in the
4771
+ # *Amazon S3 User Guide*
4583
4772
  #
4584
4773
  #
4585
4774
  #
@@ -4818,33 +5007,71 @@ module Aws::S3
4818
5007
  end
4819
5008
 
4820
5009
  # Removes an object from a bucket. The behavior depends on the bucket's
4821
- # versioning state. For more information, see [Best practices to
4822
- # consider before deleting an object][1].
5010
+ # versioning state:
5011
+ #
5012
+ # * If bucket versioning is not enabled, the operation permanently
5013
+ # deletes the object.
5014
+ #
5015
+ # * If bucket versioning is enabled, the operation inserts a delete
5016
+ # marker, which becomes the current version of the object. To
5017
+ # permanently delete an object in a versioned bucket, you must include
5018
+ # the object’s `versionId` in the request. For more information about
5019
+ # versioning-enabled buckets, see [Deleting object versions from a
5020
+ # versioning-enabled bucket][1].
5021
+ #
5022
+ # * If bucket versioning is suspended, the operation removes the object
5023
+ # that has a null `versionId`, if there is one, and inserts a delete
5024
+ # marker that becomes the current version of the object. If there
5025
+ # isn't an object with a null `versionId`, and all versions of the
5026
+ # object have a `versionId`, Amazon S3 does not remove the object and
5027
+ # only inserts a delete marker. To permanently delete an object that
5028
+ # has a `versionId`, you must include the object’s `versionId` in the
5029
+ # request. For more information about versioning-suspended buckets,
5030
+ # see [Deleting objects from versioning-suspended buckets][2].
5031
+ #
5032
+ # <note markdown="1"> * **Directory buckets** - S3 Versioning isn't enabled and supported
5033
+ # for directory buckets. For this API operation, only the `null` value
5034
+ # of the version ID is supported by directory buckets. You can only
5035
+ # specify `null` to the `versionId` query parameter in the request.
5036
+ #
5037
+ # * **Directory buckets** - For directory buckets, you must make
5038
+ # requests for this API operation to the Zonal endpoint. These
5039
+ # endpoints support virtual-hosted-style requests in the format
5040
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
5041
+ # `. Path-style requests are not supported. For more information about
5042
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
5043
+ # for directory buckets in Availability Zones][3] in the *Amazon S3
5044
+ # User Guide*. For more information about endpoints in Local Zones,
5045
+ # see [Available Local Zone for directory buckets][4] in the *Amazon
5046
+ # S3 User Guide*.
5047
+ #
5048
+ # </note>
4823
5049
  #
4824
5050
  # To remove a specific version, you must use the `versionId` query
4825
5051
  # parameter. Using this query parameter permanently deletes the version.
4826
5052
  # If the object deleted is a delete marker, Amazon S3 sets the response
4827
- # header `x-amz-delete-marker` to true. If the object you want to delete
4828
- # is in a bucket where the bucket versioning configuration is MFA delete
4829
- # enabled, you must include the `x-amz-mfa` request header in the DELETE
4830
- # `versionId` request. Requests that include `x-amz-mfa` must use HTTPS.
4831
- # For more information about MFA delete and to see example requests, see
4832
- # [Using MFA delete][2] and [Sample request][3] in the *Amazon S3 User
4833
- # Guide*.
5053
+ # header `x-amz-delete-marker` to true.
4834
5054
  #
4835
- # <note markdown="1"> * S3 Versioning isn't enabled and supported for directory buckets.
4836
- # For this API operation, only the `null` value of the version ID is
4837
- # supported by directory buckets. You can only specify `null` to the
4838
- # `versionId` query parameter in the request.
5055
+ # If the object you want to delete is in a bucket where the bucket
5056
+ # versioning configuration is MFA Delete enabled, you must include the
5057
+ # `x-amz-mfa` request header in the DELETE `versionId` request. Requests
5058
+ # that include `x-amz-mfa` must use HTTPS. For more information about
5059
+ # MFA Delete, see [Using MFA Delete][5] in the *Amazon S3 User Guide*.
5060
+ # To see sample requests that use versioning, see [Sample Request][6].
4839
5061
  #
4840
- # * For directory buckets, you must make requests for this API operation
4841
- # to the Zonal endpoint. These endpoints support virtual-hosted-style
4842
- # requests in the format
4843
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
4844
- # `. Path-style requests are not supported. For more information, see
4845
- # [Regional and Zonal endpoints][4] in the *Amazon S3 User Guide*.
5062
+ # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
5063
+ # buckets.
5064
+ #
5065
+ # </note>
5066
+ #
5067
+ # You can delete objects by explicitly calling DELETE Object or calling
5068
+ # ([PutBucketLifecycle][7]) to enable Amazon S3 to remove them for you.
5069
+ # If you want to block users or accounts from removing or deleting
5070
+ # objects from your bucket, you must deny them the `s3:DeleteObject`,
5071
+ # `s3:DeleteObjectVersion`, and `s3:PutLifeCycleConfiguration` actions.
4846
5072
  #
4847
- # * MFA delete is not supported by directory buckets.
5073
+ # <note markdown="1"> **Directory buckets** - S3 Lifecycle is not supported by directory
5074
+ # buckets.
4848
5075
  #
4849
5076
  # </note>
4850
5077
  #
@@ -4856,51 +5083,56 @@ module Aws::S3
4856
5083
  # * <b> <code>s3:DeleteObject</code> </b> - To delete an object from
4857
5084
  # a bucket, you must always have the `s3:DeleteObject` permission.
4858
5085
  #
4859
- # <note markdown="1"> You can also use PutBucketLifecycle to delete objects in Amazon
4860
- # S3.
4861
- #
4862
- # </note>
4863
- #
4864
5086
  # * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
4865
5087
  # specific version of an object from a versioning-enabled bucket,
4866
5088
  # you must have the `s3:DeleteObjectVersion` permission.
4867
- #
4868
- # * If you want to block users or accounts from removing or deleting
4869
- # objects from your bucket, you must deny them the
4870
- # `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
4871
- # `s3:PutLifeCycleConfiguration` permissions.
4872
- # * **Directory buckets permissions** - To grant access to this API
4873
- # operation on a directory bucket, we recommend that you use the
4874
- # CreateSession API operation for session-based authorization.
5089
+ # * **Directory bucket permissions** - To grant access to this API
5090
+ # operation on a directory bucket, we recommend that you use the [
5091
+ # `CreateSession` ][8] API operation for session-based
5092
+ # authorization. Specifically, you grant the
5093
+ # `s3express:CreateSession` permission to the directory bucket in a
5094
+ # bucket policy or an IAM identity-based policy. Then, you make the
5095
+ # `CreateSession` API call on the bucket to obtain a session token.
5096
+ # With the session token in your request header, you can make API
5097
+ # requests to this operation. After the session token expires, you
5098
+ # make another `CreateSession` API call to generate a new session
5099
+ # token for use. Amazon Web Services CLI or SDKs create session and
5100
+ # refresh the session token automatically to avoid service
5101
+ # interruptions when a session expires. For more information about
5102
+ # authorization, see [ `CreateSession` ][8].
4875
5103
  #
4876
5104
  # HTTP Host header syntax
4877
5105
  #
4878
5106
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
4879
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
5107
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
4880
5108
  #
4881
5109
  # The following action is related to `DeleteObject`:
4882
5110
  #
4883
- # * [PutObject][5]
5111
+ # * [PutObject][9]
4884
5112
  #
4885
5113
  # ^
4886
5114
  #
4887
5115
  #
4888
5116
  #
4889
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjects.html#DeletingObjects-best-practices
4890
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
4891
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
4892
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4893
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
5117
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
5118
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectsfromVersioningSuspendedBuckets.html
5119
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
5120
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
5121
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
5122
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
5123
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
5124
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
5125
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
4894
5126
  #
4895
5127
  # @option params [required, String] :bucket
4896
5128
  # The bucket name of the bucket containing the object.
4897
5129
  #
4898
5130
  # **Directory buckets** - When you use this operation with a directory
4899
5131
  # bucket, you must use virtual-hosted-style requests in the format `
4900
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
4901
- # are not supported. Directory bucket names must be unique in the chosen
4902
- # Availability Zone. Bucket names must follow the format `
4903
- # bucket_base_name--az-id--x-s3` (for example, `
5132
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
5133
+ # requests are not supported. Directory bucket names must be unique in
5134
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
5135
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
4904
5136
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4905
5137
  # naming restrictions, see [Directory bucket naming rules][1] in the
4906
5138
  # *Amazon S3 User Guide*.
@@ -5038,15 +5270,6 @@ module Aws::S3
5038
5270
  # * {Types::DeleteObjectOutput#request_charged #request_charged} => String
5039
5271
  #
5040
5272
  #
5041
- # @example Example: To delete an object (from a non-versioned bucket)
5042
- #
5043
- # # The following example deletes an object from a non-versioned bucket.
5044
- #
5045
- # resp = client.delete_object({
5046
- # bucket: "ExampleBucket",
5047
- # key: "HappyFace.jpg",
5048
- # })
5049
- #
5050
5273
  # @example Example: To delete an object
5051
5274
  #
5052
5275
  # # The following example deletes an object from an S3 bucket.
@@ -5060,6 +5283,15 @@ module Aws::S3
5060
5283
  # {
5061
5284
  # }
5062
5285
  #
5286
+ # @example Example: To delete an object (from a non-versioned bucket)
5287
+ #
5288
+ # # The following example deletes an object from a non-versioned bucket.
5289
+ #
5290
+ # resp = client.delete_object({
5291
+ # bucket: "ExampleBucket",
5292
+ # key: "HappyFace.jpg",
5293
+ # })
5294
+ #
5063
5295
  # @example Request syntax with placeholder values
5064
5296
  #
5065
5297
  # resp = client.delete_object({
@@ -5233,9 +5465,13 @@ module Aws::S3
5233
5465
  # * **Directory buckets** - For directory buckets, you must make
5234
5466
  # requests for this API operation to the Zonal endpoint. These
5235
5467
  # endpoints support virtual-hosted-style requests in the format
5236
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
5237
- # `. Path-style requests are not supported. For more information, see
5238
- # [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
5468
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
5469
+ # `. Path-style requests are not supported. For more information about
5470
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
5471
+ # for directory buckets in Availability Zones][1] in the *Amazon S3
5472
+ # User Guide*. For more information about endpoints in Local Zones,
5473
+ # see [Available Local Zone for directory buckets][2] in the *Amazon
5474
+ # S3 User Guide*.
5239
5475
  #
5240
5476
  # </note>
5241
5477
  #
@@ -5253,7 +5489,7 @@ module Aws::S3
5253
5489
  # if there are non-versioned objects you are trying to delete. If you
5254
5490
  # provide an invalid token, whether there are versioned keys in the
5255
5491
  # request or not, the entire Multi-Object Delete request will fail. For
5256
- # information about MFA Delete, see [MFA Delete][2] in the *Amazon S3
5492
+ # information about MFA Delete, see [MFA Delete][3] in the *Amazon S3
5257
5493
  # User Guide*.
5258
5494
  #
5259
5495
  # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
@@ -5275,7 +5511,7 @@ module Aws::S3
5275
5511
  # you must specify the `s3:DeleteObjectVersion` permission.
5276
5512
  # * **Directory bucket permissions** - To grant access to this API
5277
5513
  # operation on a directory bucket, we recommend that you use the [
5278
- # `CreateSession` ][3] API operation for session-based
5514
+ # `CreateSession` ][4] API operation for session-based
5279
5515
  # authorization. Specifically, you grant the
5280
5516
  # `s3express:CreateSession` permission to the directory bucket in a
5281
5517
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -5286,7 +5522,7 @@ module Aws::S3
5286
5522
  # token for use. Amazon Web Services CLI or SDKs create session and
5287
5523
  # refresh the session token automatically to avoid service
5288
5524
  # interruptions when a session expires. For more information about
5289
- # authorization, see [ `CreateSession` ][3].
5525
+ # authorization, see [ `CreateSession` ][4].
5290
5526
  #
5291
5527
  # Content-MD5 request header
5292
5528
  # : * **General purpose bucket** - The Content-MD5 request header is
@@ -5303,40 +5539,41 @@ module Aws::S3
5303
5539
  # HTTP Host header syntax
5304
5540
  #
5305
5541
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
5306
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
5542
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
5307
5543
  #
5308
5544
  # The following operations are related to `DeleteObjects`:
5309
5545
  #
5310
- # * [CreateMultipartUpload][4]
5546
+ # * [CreateMultipartUpload][5]
5311
5547
  #
5312
- # * [UploadPart][5]
5548
+ # * [UploadPart][6]
5313
5549
  #
5314
- # * [CompleteMultipartUpload][6]
5550
+ # * [CompleteMultipartUpload][7]
5315
5551
  #
5316
- # * [ListParts][7]
5552
+ # * [ListParts][8]
5317
5553
  #
5318
- # * [AbortMultipartUpload][8]
5554
+ # * [AbortMultipartUpload][9]
5319
5555
  #
5320
5556
  #
5321
5557
  #
5322
5558
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
5323
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
5324
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
5325
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
5326
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
5327
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
5328
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
5329
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
5559
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
5560
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
5561
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
5562
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
5563
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
5564
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
5565
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
5566
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
5330
5567
  #
5331
5568
  # @option params [required, String] :bucket
5332
5569
  # The bucket name containing the objects to delete.
5333
5570
  #
5334
5571
  # **Directory buckets** - When you use this operation with a directory
5335
5572
  # bucket, you must use virtual-hosted-style requests in the format `
5336
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
5337
- # are not supported. Directory bucket names must be unique in the chosen
5338
- # Availability Zone. Bucket names must follow the format `
5339
- # bucket_base_name--az-id--x-s3` (for example, `
5573
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
5574
+ # requests are not supported. Directory bucket names must be unique in
5575
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
5576
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
5340
5577
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
5341
5578
  # naming restrictions, see [Directory bucket naming rules][1] in the
5342
5579
  # *Amazon S3 User Guide*.
@@ -5471,22 +5708,20 @@ module Aws::S3
5471
5708
  # * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
5472
5709
  #
5473
5710
  #
5474
- # @example Example: To delete multiple object versions from a versioned bucket
5711
+ # @example Example: To delete multiple objects from a versioned bucket
5475
5712
  #
5476
- # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
5477
- # # versions and returns the key and versions of deleted objects in the response.
5713
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
5714
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
5478
5715
  #
5479
5716
  # resp = client.delete_objects({
5480
5717
  # bucket: "examplebucket",
5481
5718
  # delete: {
5482
5719
  # objects: [
5483
5720
  # {
5484
- # key: "HappyFace.jpg",
5485
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5721
+ # key: "objectkey1",
5486
5722
  # },
5487
5723
  # {
5488
- # key: "HappyFace.jpg",
5489
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5724
+ # key: "objectkey2",
5490
5725
  # },
5491
5726
  # ],
5492
5727
  # quiet: false,
@@ -5497,30 +5732,34 @@ module Aws::S3
5497
5732
  # {
5498
5733
  # deleted: [
5499
5734
  # {
5500
- # key: "HappyFace.jpg",
5501
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5735
+ # delete_marker: true,
5736
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
5737
+ # key: "objectkey1",
5502
5738
  # },
5503
5739
  # {
5504
- # key: "HappyFace.jpg",
5505
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5740
+ # delete_marker: true,
5741
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
5742
+ # key: "objectkey2",
5506
5743
  # },
5507
5744
  # ],
5508
5745
  # }
5509
5746
  #
5510
- # @example Example: To delete multiple objects from a versioned bucket
5747
+ # @example Example: To delete multiple object versions from a versioned bucket
5511
5748
  #
5512
- # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
5513
- # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
5749
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
5750
+ # # versions and returns the key and versions of deleted objects in the response.
5514
5751
  #
5515
5752
  # resp = client.delete_objects({
5516
5753
  # bucket: "examplebucket",
5517
5754
  # delete: {
5518
5755
  # objects: [
5519
5756
  # {
5520
- # key: "objectkey1",
5757
+ # key: "HappyFace.jpg",
5758
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5521
5759
  # },
5522
5760
  # {
5523
- # key: "objectkey2",
5761
+ # key: "HappyFace.jpg",
5762
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5524
5763
  # },
5525
5764
  # ],
5526
5765
  # quiet: false,
@@ -5531,14 +5770,12 @@ module Aws::S3
5531
5770
  # {
5532
5771
  # deleted: [
5533
5772
  # {
5534
- # delete_marker: true,
5535
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
5536
- # key: "objectkey1",
5773
+ # key: "HappyFace.jpg",
5774
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5537
5775
  # },
5538
5776
  # {
5539
- # delete_marker: true,
5540
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
5541
- # key: "objectkey2",
5777
+ # key: "HappyFace.jpg",
5778
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5542
5779
  # },
5543
5780
  # ],
5544
5781
  # }
@@ -6083,7 +6320,7 @@ module Aws::S3
6083
6320
  # HTTP Host header syntax
6084
6321
  #
6085
6322
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
6086
- # `s3express-control.region.amazonaws.com`.
6323
+ # `s3express-control.region-code.amazonaws.com`.
6087
6324
  #
6088
6325
  # The following operations are related to `GetBucketEncryption`:
6089
6326
  #
@@ -6107,13 +6344,14 @@ module Aws::S3
6107
6344
  #
6108
6345
  # <b>Directory buckets </b> - When you use this operation with a
6109
6346
  # directory bucket, you must use path-style requests in the format
6110
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
6347
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
6111
6348
  # Virtual-hosted-style requests aren't supported. Directory bucket
6112
- # names must be unique in the chosen Availability Zone. Bucket names
6113
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
6114
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
6115
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
6116
- # the *Amazon S3 User Guide*
6349
+ # names must be unique in the chosen Zone (Availability Zone or Local
6350
+ # Zone). Bucket names must also follow the format `
6351
+ # bucket-base-name--zone-id--x-s3` (for example, `
6352
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
6353
+ # naming restrictions, see [Directory bucket naming rules][1] in the
6354
+ # *Amazon S3 User Guide*
6117
6355
  #
6118
6356
  #
6119
6357
  #
@@ -6490,10 +6728,13 @@ module Aws::S3
6490
6728
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
6491
6729
  # requests for this API operation to the Regional endpoint. These
6492
6730
  # endpoints support path-style requests in the format
6493
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
6731
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
6494
6732
  # `. Virtual-hosted-style requests aren't supported. For more
6495
- # information, see [Regional and Zonal endpoints][5] in the *Amazon
6496
- # S3 User Guide*.
6733
+ # information about endpoints in Availability Zones, see [Regional
6734
+ # and Zonal endpoints for directory buckets in Availability
6735
+ # Zones][5] in the *Amazon S3 User Guide*. For more information
6736
+ # about endpoints in Local Zones, see [Available Local Zone for
6737
+ # directory buckets][6] in the *Amazon S3 User Guide*.
6497
6738
  #
6498
6739
  # </note>
6499
6740
  #
@@ -6517,9 +6758,9 @@ module Aws::S3
6517
6758
  #
6518
6759
  # * [GetBucketLifecycle][2]
6519
6760
  #
6520
- # * [PutBucketLifecycle][6]
6761
+ # * [PutBucketLifecycle][7]
6521
6762
  #
6522
- # * [DeleteBucketLifecycle][7]
6763
+ # * [DeleteBucketLifecycle][8]
6523
6764
  #
6524
6765
  #
6525
6766
  #
@@ -6528,8 +6769,9 @@ module Aws::S3
6528
6769
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6529
6770
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
6530
6771
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
6531
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
6532
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
6772
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
6773
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
6774
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
6533
6775
  #
6534
6776
  # @option params [required, String] :bucket
6535
6777
  # The name of the bucket for which to get the lifecycle information.
@@ -6780,6 +7022,69 @@ module Aws::S3
6780
7022
  req.send_request(options)
6781
7023
  end
6782
7024
 
7025
+ # Retrieves the metadata table configuration for a general purpose
7026
+ # bucket. For more information, see [Accelerating data discovery with S3
7027
+ # Metadata][1] in the *Amazon S3 User Guide*.
7028
+ #
7029
+ # Permissions
7030
+ #
7031
+ # : To use this operation, you must have the
7032
+ # `s3:GetBucketMetadataTableConfiguration` permission. For more
7033
+ # information, see [Setting up permissions for configuring metadata
7034
+ # tables][2] in the *Amazon S3 User Guide*.
7035
+ #
7036
+ # The following operations are related to
7037
+ # `GetBucketMetadataTableConfiguration`:
7038
+ #
7039
+ # * [CreateBucketMetadataTableConfiguration][3]
7040
+ #
7041
+ # * [DeleteBucketMetadataTableConfiguration][4]
7042
+ #
7043
+ #
7044
+ #
7045
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
7046
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
7047
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataTableConfiguration.html
7048
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
7049
+ #
7050
+ # @option params [required, String] :bucket
7051
+ # The general purpose bucket that contains the metadata table
7052
+ # configuration that you want to retrieve.
7053
+ #
7054
+ # @option params [String] :expected_bucket_owner
7055
+ # The expected owner of the general purpose bucket that you want to
7056
+ # retrieve the metadata table configuration from.
7057
+ #
7058
+ # @return [Types::GetBucketMetadataTableConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7059
+ #
7060
+ # * {Types::GetBucketMetadataTableConfigurationOutput#get_bucket_metadata_table_configuration_result #get_bucket_metadata_table_configuration_result} => Types::GetBucketMetadataTableConfigurationResult
7061
+ #
7062
+ # @example Request syntax with placeholder values
7063
+ #
7064
+ # resp = client.get_bucket_metadata_table_configuration({
7065
+ # bucket: "BucketName", # required
7066
+ # expected_bucket_owner: "AccountId",
7067
+ # })
7068
+ #
7069
+ # @example Response structure
7070
+ #
7071
+ # resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_bucket_arn #=> String
7072
+ # resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_name #=> String
7073
+ # resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_arn #=> String
7074
+ # resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_namespace #=> String
7075
+ # resp.get_bucket_metadata_table_configuration_result.status #=> String
7076
+ # resp.get_bucket_metadata_table_configuration_result.error.error_code #=> String
7077
+ # resp.get_bucket_metadata_table_configuration_result.error.error_message #=> String
7078
+ #
7079
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataTableConfiguration AWS API Documentation
7080
+ #
7081
+ # @overload get_bucket_metadata_table_configuration(params = {})
7082
+ # @param [Hash] params ({})
7083
+ def get_bucket_metadata_table_configuration(params = {}, options = {})
7084
+ req = build_request(:get_bucket_metadata_table_configuration, params)
7085
+ req.send_request(options)
7086
+ end
7087
+
6783
7088
  # <note markdown="1"> This operation is not supported for directory buckets.
6784
7089
  #
6785
7090
  # </note>
@@ -7174,9 +7479,13 @@ module Aws::S3
7174
7479
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
7175
7480
  # requests for this API operation to the Regional endpoint. These
7176
7481
  # endpoints support path-style requests in the format
7177
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
7178
- # Virtual-hosted-style requests aren't supported. For more information,
7179
- # see [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
7482
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
7483
+ # Virtual-hosted-style requests aren't supported. For more information
7484
+ # about endpoints in Availability Zones, see [Regional and Zonal
7485
+ # endpoints for directory buckets in Availability Zones][1] in the
7486
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
7487
+ # Zones, see [Available Local Zone for directory buckets][2] in the
7488
+ # *Amazon S3 User Guide*.
7180
7489
  #
7181
7490
  # </note>
7182
7491
  #
@@ -7206,7 +7515,7 @@ module Aws::S3
7206
7515
  # * **General purpose bucket permissions** - The `s3:GetBucketPolicy`
7207
7516
  # permission is required in a policy. For more information about
7208
7517
  # general purpose buckets bucket policies, see [Using Bucket
7209
- # Policies and User Policies][2] in the *Amazon S3 User Guide*.
7518
+ # Policies and User Policies][3] in the *Amazon S3 User Guide*.
7210
7519
  #
7211
7520
  # * **Directory bucket permissions** - To grant access to this API
7212
7521
  # operation, you must have the `s3express:GetBucketPolicy`
@@ -7216,48 +7525,50 @@ module Aws::S3
7216
7525
  # Services account that owns the resource. For more information
7217
7526
  # about directory bucket policies and permissions, see [Amazon Web
7218
7527
  # Services Identity and Access Management (IAM) for S3 Express One
7219
- # Zone][3] in the *Amazon S3 User Guide*.
7528
+ # Zone][4] in the *Amazon S3 User Guide*.
7220
7529
  #
7221
7530
  # Example bucket policies
7222
7531
  #
7223
7532
  # : **General purpose buckets example bucket policies** - See [Bucket
7224
- # policy examples][4] in the *Amazon S3 User Guide*.
7533
+ # policy examples][5] in the *Amazon S3 User Guide*.
7225
7534
  #
7226
7535
  # **Directory bucket example bucket policies** - See [Example bucket
7227
- # policies for S3 Express One Zone][5] in the *Amazon S3 User Guide*.
7536
+ # policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
7228
7537
  #
7229
7538
  # HTTP Host header syntax
7230
7539
  #
7231
7540
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
7232
- # `s3express-control.region.amazonaws.com`.
7541
+ # `s3express-control.region-code.amazonaws.com`.
7233
7542
  #
7234
7543
  # The following action is related to `GetBucketPolicy`:
7235
7544
  #
7236
- # * [GetObject][6]
7545
+ # * [GetObject][7]
7237
7546
  #
7238
7547
  # ^
7239
7548
  #
7240
7549
  #
7241
7550
  #
7242
7551
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
7243
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
7244
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
7245
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
7246
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
7247
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
7552
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
7553
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
7554
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
7555
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
7556
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
7557
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
7248
7558
  #
7249
7559
  # @option params [required, String] :bucket
7250
7560
  # The bucket name to get the bucket policy for.
7251
7561
  #
7252
7562
  # <b>Directory buckets </b> - When you use this operation with a
7253
7563
  # directory bucket, you must use path-style requests in the format
7254
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
7564
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
7255
7565
  # Virtual-hosted-style requests aren't supported. Directory bucket
7256
- # names must be unique in the chosen Availability Zone. Bucket names
7257
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
7258
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
7259
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
7260
- # the *Amazon S3 User Guide*
7566
+ # names must be unique in the chosen Zone (Availability Zone or Local
7567
+ # Zone). Bucket names must also follow the format `
7568
+ # bucket-base-name--zone-id--x-s3` (for example, `
7569
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7570
+ # naming restrictions, see [Directory bucket naming rules][1] in the
7571
+ # *Amazon S3 User Guide*
7261
7572
  #
7262
7573
  # **Access points** - When you use this API operation with an access
7263
7574
  # point, provide the alias of the access point in place of the bucket
@@ -7860,9 +8171,13 @@ module Aws::S3
7860
8171
  # `/photos/2006/February/sample.jpg`. Also, when you make requests to
7861
8172
  # this API operation, your requests are sent to the Zonal endpoint.
7862
8173
  # These endpoints support virtual-hosted-style requests in the format
7863
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
7864
- # Path-style requests are not supported. For more information, see
7865
- # [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
8174
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
8175
+ # `. Path-style requests are not supported. For more information about
8176
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
8177
+ # directory buckets in Availability Zones][2] in the *Amazon S3 User
8178
+ # Guide*. For more information about endpoints in Local Zones, see
8179
+ # [Available Local Zone for directory buckets][3] in the *Amazon S3 User
8180
+ # Guide*.
7866
8181
  #
7867
8182
  # Permissions
7868
8183
  # : * **General purpose bucket permissions** - You must have the
@@ -7870,7 +8185,7 @@ module Aws::S3
7870
8185
  # have the `READ` access to the object (or version). If you grant
7871
8186
  # `READ` access to the anonymous user, the `GetObject` operation
7872
8187
  # returns the object without using an authorization header. For more
7873
- # information, see [Specifying permissions in a policy][3] in the
8188
+ # information, see [Specifying permissions in a policy][4] in the
7874
8189
  # *Amazon S3 User Guide*.
7875
8190
  #
7876
8191
  # If you include a `versionId` in your request header, you must have
@@ -7894,7 +8209,7 @@ module Aws::S3
7894
8209
  # returns an HTTP status code `403 Access Denied` error.
7895
8210
  # * **Directory bucket permissions** - To grant access to this API
7896
8211
  # operation on a directory bucket, we recommend that you use the [
7897
- # `CreateSession` ][4] API operation for session-based
8212
+ # `CreateSession` ][5] API operation for session-based
7898
8213
  # authorization. Specifically, you grant the
7899
8214
  # `s3express:CreateSession` permission to the directory bucket in a
7900
8215
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -7905,7 +8220,7 @@ module Aws::S3
7905
8220
  # token for use. Amazon Web Services CLI or SDKs create session and
7906
8221
  # refresh the session token automatically to avoid service
7907
8222
  # interruptions when a session expires. For more information about
7908
- # authorization, see [ `CreateSession` ][4].
8223
+ # authorization, see [ `CreateSession` ][5].
7909
8224
  #
7910
8225
  # If the object is encrypted using SSE-KMS, you must also have the
7911
8226
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -7918,9 +8233,9 @@ module Aws::S3
7918
8233
  # storage class, the S3 Intelligent-Tiering Archive Access tier, or
7919
8234
  # the S3 Intelligent-Tiering Deep Archive Access tier, before you can
7920
8235
  # retrieve the object you must first restore a copy using
7921
- # [RestoreObject][5]. Otherwise, this operation returns an
8236
+ # [RestoreObject][6]. Otherwise, this operation returns an
7922
8237
  # `InvalidObjectState` error. For information about restoring archived
7923
- # objects, see [Restoring Archived Objects][6] in the *Amazon S3 User
8238
+ # objects, see [Restoring Archived Objects][7] in the *Amazon S3 User
7924
8239
  # Guide*.
7925
8240
  #
7926
8241
  # <b>Directory buckets </b> - For directory buckets, only the S3
@@ -7942,7 +8257,7 @@ module Aws::S3
7942
8257
  # **Directory buckets** - For directory buckets, there are only two
7943
8258
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
7944
8259
  # SSE-C isn't supported. For more information, see [Protecting data
7945
- # with server-side encryption][7] in the *Amazon S3 User Guide*.
8260
+ # with server-side encryption][8] in the *Amazon S3 User Guide*.
7946
8261
  #
7947
8262
  # Overriding response header values through the request
7948
8263
  #
@@ -7987,25 +8302,26 @@ module Aws::S3
7987
8302
  # HTTP Host header syntax
7988
8303
  #
7989
8304
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
7990
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
8305
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
7991
8306
  #
7992
8307
  # The following operations are related to `GetObject`:
7993
8308
  #
7994
- # * [ListBuckets][8]
8309
+ # * [ListBuckets][9]
7995
8310
  #
7996
- # * [GetObjectAcl][9]
8311
+ # * [GetObjectAcl][10]
7997
8312
  #
7998
8313
  #
7999
8314
  #
8000
8315
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
8001
8316
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
8002
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8003
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
8004
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
8005
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
8006
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
8007
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
8008
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
8317
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
8318
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8319
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
8320
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
8321
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
8322
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
8323
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
8324
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
8009
8325
  #
8010
8326
  # @option params [String, IO] :response_target
8011
8327
  # Where to write response data, file path, or IO object.
@@ -8015,10 +8331,10 @@ module Aws::S3
8015
8331
  #
8016
8332
  # **Directory buckets** - When you use this operation with a directory
8017
8333
  # bucket, you must use virtual-hosted-style requests in the format `
8018
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
8019
- # are not supported. Directory bucket names must be unique in the chosen
8020
- # Availability Zone. Bucket names must follow the format `
8021
- # bucket_base_name--az-id--x-s3` (for example, `
8334
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
8335
+ # requests are not supported. Directory bucket names must be unique in
8336
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
8337
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8022
8338
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8023
8339
  # naming restrictions, see [Directory bucket naming rules][1] in the
8024
8340
  # *Amazon S3 User Guide*.
@@ -8352,49 +8668,49 @@ module Aws::S3
8352
8668
  # * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
8353
8669
  #
8354
8670
  #
8355
- # @example Example: To retrieve an object
8671
+ # @example Example: To retrieve a byte range of an object
8356
8672
  #
8357
- # # The following example retrieves an object for an S3 bucket.
8673
+ # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
8674
+ # # specific byte range.
8358
8675
  #
8359
8676
  # resp = client.get_object({
8360
8677
  # bucket: "examplebucket",
8361
- # key: "HappyFace.jpg",
8678
+ # key: "SampleFile.txt",
8679
+ # range: "bytes=0-9",
8362
8680
  # })
8363
8681
  #
8364
8682
  # resp.to_h outputs the following:
8365
8683
  # {
8366
8684
  # accept_ranges: "bytes",
8367
- # content_length: 3191,
8368
- # content_type: "image/jpeg",
8369
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8370
- # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
8685
+ # content_length: 10,
8686
+ # content_range: "bytes 0-9/43",
8687
+ # content_type: "text/plain",
8688
+ # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
8689
+ # last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
8371
8690
  # metadata: {
8372
8691
  # },
8373
- # tag_count: 2,
8374
8692
  # version_id: "null",
8375
8693
  # }
8376
8694
  #
8377
- # @example Example: To retrieve a byte range of an object
8695
+ # @example Example: To retrieve an object
8378
8696
  #
8379
- # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
8380
- # # specific byte range.
8697
+ # # The following example retrieves an object for an S3 bucket.
8381
8698
  #
8382
8699
  # resp = client.get_object({
8383
8700
  # bucket: "examplebucket",
8384
- # key: "SampleFile.txt",
8385
- # range: "bytes=0-9",
8701
+ # key: "HappyFace.jpg",
8386
8702
  # })
8387
8703
  #
8388
8704
  # resp.to_h outputs the following:
8389
8705
  # {
8390
8706
  # accept_ranges: "bytes",
8391
- # content_length: 10,
8392
- # content_range: "bytes 0-9/43",
8393
- # content_type: "text/plain",
8394
- # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
8395
- # last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
8707
+ # content_length: 3191,
8708
+ # content_type: "image/jpeg",
8709
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8710
+ # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
8396
8711
  # metadata: {
8397
8712
  # },
8713
+ # tag_count: 2,
8398
8714
  # version_id: "null",
8399
8715
  # }
8400
8716
  #
@@ -8698,9 +9014,13 @@ module Aws::S3
8698
9014
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
8699
9015
  # for this API operation to the Zonal endpoint. These endpoints support
8700
9016
  # virtual-hosted-style requests in the format
8701
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
8702
- # Path-style requests are not supported. For more information, see
8703
- # [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
9017
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
9018
+ # `. Path-style requests are not supported. For more information about
9019
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
9020
+ # directory buckets in Availability Zones][1] in the *Amazon S3 User
9021
+ # Guide*. For more information about endpoints in Local Zones, see
9022
+ # [Available Local Zone for directory buckets][2] in the *Amazon S3 User
9023
+ # Guide*.
8704
9024
  #
8705
9025
  # </note>
8706
9026
  #
@@ -8713,7 +9033,7 @@ module Aws::S3
8713
9033
  # `s3:GetObjectVersionAttributes` permissions for this operation. If
8714
9034
  # the bucket is not versioned, you need the `s3:GetObject` and
8715
9035
  # `s3:GetObjectAttributes` permissions. For more information, see
8716
- # [Specifying Permissions in a Policy][2] in the *Amazon S3 User
9036
+ # [Specifying Permissions in a Policy][3] in the *Amazon S3 User
8717
9037
  # Guide*. If the object that you request does not exist, the error
8718
9038
  # Amazon S3 returns depends on whether you also have the
8719
9039
  # `s3:ListBucket` permission.
@@ -8727,7 +9047,7 @@ module Aws::S3
8727
9047
  # error.
8728
9048
  # * **Directory bucket permissions** - To grant access to this API
8729
9049
  # operation on a directory bucket, we recommend that you use the [
8730
- # `CreateSession` ][3] API operation for session-based
9050
+ # `CreateSession` ][4] API operation for session-based
8731
9051
  # authorization. Specifically, you grant the
8732
9052
  # `s3express:CreateSession` permission to the directory bucket in a
8733
9053
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -8738,7 +9058,7 @@ module Aws::S3
8738
9058
  # token for use. Amazon Web Services CLI or SDKs create session and
8739
9059
  # refresh the session token automatically to avoid service
8740
9060
  # interruptions when a session expires. For more information about
8741
- # authorization, see [ `CreateSession` ][3].
9061
+ # authorization, see [ `CreateSession` ][4].
8742
9062
  #
8743
9063
  # If the object is encrypted with SSE-KMS, you must also have the
8744
9064
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -8774,7 +9094,7 @@ module Aws::S3
8774
9094
  # * `x-amz-server-side-encryption-customer-key-MD5`
8775
9095
  #
8776
9096
  # For more information about SSE-C, see [Server-Side Encryption (Using
8777
- # Customer-Provided Encryption Keys)][4] in the *Amazon S3 User
9097
+ # Customer-Provided Encryption Keys)][5] in the *Amazon S3 User
8778
9098
  # Guide*.
8779
9099
  #
8780
9100
  # <note markdown="1"> **Directory bucket permissions** - For directory buckets, there are
@@ -8786,10 +9106,10 @@ module Aws::S3
8786
9106
  # encryption in your `CreateSession` requests or `PUT` object
8787
9107
  # requests. Then, new objects are automatically encrypted with the
8788
9108
  # desired encryption settings. For more information, see [Protecting
8789
- # data with server-side encryption][5] in the *Amazon S3 User Guide*.
9109
+ # data with server-side encryption][6] in the *Amazon S3 User Guide*.
8790
9110
  # For more information about the encryption overriding behaviors in
8791
9111
  # directory buckets, see [Specifying server-side encryption with KMS
8792
- # for new object uploads][6].
9112
+ # for new object uploads][7].
8793
9113
  #
8794
9114
  # </note>
8795
9115
  #
@@ -8812,7 +9132,7 @@ module Aws::S3
8812
9132
  #
8813
9133
  # * `If-Unmodified-Since` condition evaluates to `false`.
8814
9134
  # For more information about conditional requests, see [RFC
8815
- # 7232][7].
9135
+ # 7232][8].
8816
9136
  #
8817
9137
  # * If both of the `If-None-Match` and `If-Modified-Since` headers are
8818
9138
  # present in the request as follows, then Amazon S3 returns the HTTP
@@ -8822,58 +9142,59 @@ module Aws::S3
8822
9142
  #
8823
9143
  # * `If-Modified-Since` condition evaluates to `true`.
8824
9144
  # For more information about conditional requests, see [RFC
8825
- # 7232][7].
9145
+ # 7232][8].
8826
9146
  #
8827
9147
  # HTTP Host header syntax
8828
9148
  #
8829
9149
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
8830
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
9150
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
8831
9151
  #
8832
9152
  # The following actions are related to `GetObjectAttributes`:
8833
9153
  #
8834
- # * [GetObject][8]
9154
+ # * [GetObject][9]
8835
9155
  #
8836
- # * [GetObjectAcl][9]
9156
+ # * [GetObjectAcl][10]
8837
9157
  #
8838
- # * [GetObjectLegalHold][10]
9158
+ # * [GetObjectLegalHold][11]
8839
9159
  #
8840
- # * [GetObjectLockConfiguration][11]
9160
+ # * [GetObjectLockConfiguration][12]
8841
9161
  #
8842
- # * [GetObjectRetention][12]
9162
+ # * [GetObjectRetention][13]
8843
9163
  #
8844
- # * [GetObjectTagging][13]
9164
+ # * [GetObjectTagging][14]
8845
9165
  #
8846
- # * [HeadObject][14]
9166
+ # * [HeadObject][15]
8847
9167
  #
8848
- # * [ListParts][15]
9168
+ # * [ListParts][16]
8849
9169
  #
8850
9170
  #
8851
9171
  #
8852
9172
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
8853
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8854
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
8855
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
8856
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
8857
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
8858
- # [7]: https://tools.ietf.org/html/rfc7232
8859
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
8860
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
8861
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
8862
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
8863
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
8864
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
8865
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
8866
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
9173
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
9174
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
9175
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
9176
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
9177
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
9178
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
9179
+ # [8]: https://tools.ietf.org/html/rfc7232
9180
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
9181
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
9182
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
9183
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
9184
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
9185
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
9186
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
9187
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
8867
9188
  #
8868
9189
  # @option params [required, String] :bucket
8869
9190
  # The name of the bucket that contains the object.
8870
9191
  #
8871
9192
  # **Directory buckets** - When you use this operation with a directory
8872
9193
  # bucket, you must use virtual-hosted-style requests in the format `
8873
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
8874
- # are not supported. Directory bucket names must be unique in the chosen
8875
- # Availability Zone. Bucket names must follow the format `
8876
- # bucket_base_name--az-id--x-s3` (for example, `
9194
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
9195
+ # requests are not supported. Directory bucket names must be unique in
9196
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
9197
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8877
9198
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8878
9199
  # naming restrictions, see [Directory bucket naming rules][1] in the
8879
9200
  # *Amazon S3 User Guide*.
@@ -9407,49 +9728,49 @@ module Aws::S3
9407
9728
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
9408
9729
  #
9409
9730
  #
9410
- # @example Example: To retrieve tag set of a specific object version
9731
+ # @example Example: To retrieve tag set of an object
9411
9732
  #
9412
- # # The following example retrieves tag set of an object. The request specifies object version.
9733
+ # # The following example retrieves tag set of an object.
9413
9734
  #
9414
9735
  # resp = client.get_object_tagging({
9415
9736
  # bucket: "examplebucket",
9416
- # key: "exampleobject",
9417
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9737
+ # key: "HappyFace.jpg",
9418
9738
  # })
9419
9739
  #
9420
9740
  # resp.to_h outputs the following:
9421
9741
  # {
9422
9742
  # tag_set: [
9423
9743
  # {
9424
- # key: "Key1",
9425
- # value: "Value1",
9744
+ # key: "Key4",
9745
+ # value: "Value4",
9746
+ # },
9747
+ # {
9748
+ # key: "Key3",
9749
+ # value: "Value3",
9426
9750
  # },
9427
9751
  # ],
9428
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9752
+ # version_id: "null",
9429
9753
  # }
9430
9754
  #
9431
- # @example Example: To retrieve tag set of an object
9755
+ # @example Example: To retrieve tag set of a specific object version
9432
9756
  #
9433
- # # The following example retrieves tag set of an object.
9757
+ # # The following example retrieves tag set of an object. The request specifies object version.
9434
9758
  #
9435
9759
  # resp = client.get_object_tagging({
9436
9760
  # bucket: "examplebucket",
9437
- # key: "HappyFace.jpg",
9761
+ # key: "exampleobject",
9762
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9438
9763
  # })
9439
9764
  #
9440
9765
  # resp.to_h outputs the following:
9441
9766
  # {
9442
9767
  # tag_set: [
9443
9768
  # {
9444
- # key: "Key4",
9445
- # value: "Value4",
9446
- # },
9447
- # {
9448
- # key: "Key3",
9449
- # value: "Value3",
9769
+ # key: "Key1",
9770
+ # value: "Value1",
9450
9771
  # },
9451
9772
  # ],
9452
- # version_id: "null",
9773
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9453
9774
  # }
9454
9775
  #
9455
9776
  # @example Request syntax with placeholder values
@@ -9710,13 +10031,17 @@ module Aws::S3
9710
10031
  # HTTP Host header syntax
9711
10032
  #
9712
10033
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
9713
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
10034
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9714
10035
  #
9715
10036
  # <note markdown="1"> You must make requests for this API operation to the Zonal endpoint.
9716
10037
  # These endpoints support virtual-hosted-style requests in the format
9717
- # `https://bucket_name.s3express-az_id.region.amazonaws.com`.
9718
- # Path-style requests are not supported. For more information, see
9719
- # [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
10038
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
10039
+ # Path-style requests are not supported. For more information about
10040
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
10041
+ # for directory buckets in Availability Zones][5] in the *Amazon S3
10042
+ # User Guide*. For more information about endpoints in Local Zones,
10043
+ # see [Available Local Zone for directory buckets][6] in the *Amazon
10044
+ # S3 User Guide*.
9720
10045
  #
9721
10046
  # </note>
9722
10047
  #
@@ -9727,16 +10052,17 @@ module Aws::S3
9727
10052
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
9728
10053
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
9729
10054
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
10055
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
9730
10056
  #
9731
10057
  # @option params [required, String] :bucket
9732
10058
  # The bucket name.
9733
10059
  #
9734
10060
  # **Directory buckets** - When you use this operation with a directory
9735
10061
  # bucket, you must use virtual-hosted-style requests in the format `
9736
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
9737
- # are not supported. Directory bucket names must be unique in the chosen
9738
- # Availability Zone. Bucket names must follow the format `
9739
- # bucket_base_name--az-id--x-s3` (for example, `
10062
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
10063
+ # requests are not supported. Directory bucket names must be unique in
10064
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10065
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
9740
10066
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9741
10067
  # naming restrictions, see [Directory bucket naming rules][1] in the
9742
10068
  # *Amazon S3 User Guide*.
@@ -9810,7 +10136,7 @@ module Aws::S3
9810
10136
  #
9811
10137
  # @example Response structure
9812
10138
  #
9813
- # resp.bucket_location_type #=> String, one of "AvailabilityZone"
10139
+ # resp.bucket_location_type #=> String, one of "AvailabilityZone", "LocalZone"
9814
10140
  # resp.bucket_location_name #=> String
9815
10141
  # resp.bucket_region #=> String
9816
10142
  # resp.access_point_alias #=> Boolean
@@ -9955,22 +10281,26 @@ module Aws::S3
9955
10281
  # HTTP Host header syntax
9956
10282
  #
9957
10283
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
9958
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
10284
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9959
10285
  #
9960
10286
  # <note markdown="1"> For directory buckets, you must make requests for this API operation
9961
10287
  # to the Zonal endpoint. These endpoints support virtual-hosted-style
9962
10288
  # requests in the format
9963
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
9964
- # `. Path-style requests are not supported. For more information, see
9965
- # [Regional and Zonal endpoints][6] in the *Amazon S3 User Guide*.
10289
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
10290
+ # `. Path-style requests are not supported. For more information about
10291
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
10292
+ # for directory buckets in Availability Zones][6] in the *Amazon S3
10293
+ # User Guide*. For more information about endpoints in Local Zones,
10294
+ # see [Available Local Zone for directory buckets][7] in the *Amazon
10295
+ # S3 User Guide*.
9966
10296
  #
9967
10297
  # </note>
9968
10298
  #
9969
10299
  # The following actions are related to `HeadObject`:
9970
10300
  #
9971
- # * [GetObject][7]
10301
+ # * [GetObject][8]
9972
10302
  #
9973
- # * [GetObjectAttributes][8]
10303
+ # * [GetObjectAttributes][9]
9974
10304
  #
9975
10305
  #
9976
10306
  #
@@ -9980,18 +10310,19 @@ module Aws::S3
9980
10310
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
9981
10311
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
9982
10312
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
9983
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
9984
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
10313
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
10314
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
10315
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
9985
10316
  #
9986
10317
  # @option params [required, String] :bucket
9987
10318
  # The name of the bucket that contains the object.
9988
10319
  #
9989
10320
  # **Directory buckets** - When you use this operation with a directory
9990
10321
  # bucket, you must use virtual-hosted-style requests in the format `
9991
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
9992
- # are not supported. Directory bucket names must be unique in the chosen
9993
- # Availability Zone. Bucket names must follow the format `
9994
- # bucket_base_name--az-id--x-s3` (for example, `
10322
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
10323
+ # requests are not supported. Directory bucket names must be unique in
10324
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10325
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
9995
10326
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9996
10327
  # naming restrictions, see [Directory bucket naming rules][1] in the
9997
10328
  # *Amazon S3 User Guide*.
@@ -10895,9 +11226,13 @@ module Aws::S3
10895
11226
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
10896
11227
  # requests for this API operation to the Regional endpoint. These
10897
11228
  # endpoints support path-style requests in the format
10898
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
10899
- # Virtual-hosted-style requests aren't supported. For more information,
10900
- # see [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
11229
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
11230
+ # Virtual-hosted-style requests aren't supported. For more information
11231
+ # about endpoints in Availability Zones, see [Regional and Zonal
11232
+ # endpoints for directory buckets in Availability Zones][2] in the
11233
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
11234
+ # Zones, see [Available Local Zone for directory buckets][3] in the
11235
+ # *Amazon S3 User Guide*.
10901
11236
  #
10902
11237
  # </note>
10903
11238
  #
@@ -10909,7 +11244,7 @@ module Aws::S3
10909
11244
  # operation can only be performed by the Amazon Web Services account
10910
11245
  # that owns the resource. For more information about directory bucket
10911
11246
  # policies and permissions, see [Amazon Web Services Identity and
10912
- # Access Management (IAM) for S3 Express One Zone][3] in the *Amazon
11247
+ # Access Management (IAM) for S3 Express One Zone][4] in the *Amazon
10913
11248
  # S3 User Guide*.
10914
11249
  #
10915
11250
  # HTTP Host header syntax
@@ -10926,7 +11261,8 @@ module Aws::S3
10926
11261
  #
10927
11262
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
10928
11263
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
10929
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
11264
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
11265
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
10930
11266
  #
10931
11267
  # @option params [String] :continuation_token
10932
11268
  # `ContinuationToken` indicates to Amazon S3 that the list is being
@@ -11014,21 +11350,25 @@ module Aws::S3
11014
11350
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
11015
11351
  # for this API operation to the Zonal endpoint. These endpoints support
11016
11352
  # virtual-hosted-style requests in the format
11017
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
11018
- # Path-style requests are not supported. For more information, see
11019
- # [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
11353
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
11354
+ # `. Path-style requests are not supported. For more information about
11355
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
11356
+ # directory buckets in Availability Zones][2] in the *Amazon S3 User
11357
+ # Guide*. For more information about endpoints in Local Zones, see
11358
+ # [Available Local Zone for directory buckets][3] in the *Amazon S3 User
11359
+ # Guide*.
11020
11360
  #
11021
11361
  # </note>
11022
11362
  #
11023
11363
  # Permissions
11024
11364
  # : * **General purpose bucket permissions** - For information about
11025
11365
  # permissions required to use the multipart upload API, see
11026
- # [Multipart Upload and Permissions][3] in the *Amazon S3 User
11366
+ # [Multipart Upload and Permissions][4] in the *Amazon S3 User
11027
11367
  # Guide*.
11028
11368
  #
11029
11369
  # * **Directory bucket permissions** - To grant access to this API
11030
11370
  # operation on a directory bucket, we recommend that you use the [
11031
- # `CreateSession` ][4] API operation for session-based
11371
+ # `CreateSession` ][5] API operation for session-based
11032
11372
  # authorization. Specifically, you grant the
11033
11373
  # `s3express:CreateSession` permission to the directory bucket in a
11034
11374
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -11039,7 +11379,7 @@ module Aws::S3
11039
11379
  # token for use. Amazon Web Services CLI or SDKs create session and
11040
11380
  # refresh the session token automatically to avoid service
11041
11381
  # interruptions when a session expires. For more information about
11042
- # authorization, see [ `CreateSession` ][4].
11382
+ # authorization, see [ `CreateSession` ][5].
11043
11383
  #
11044
11384
  # Sorting of multipart uploads in response
11045
11385
  # : * **General purpose bucket** - In the `ListMultipartUploads`
@@ -11060,41 +11400,42 @@ module Aws::S3
11060
11400
  # HTTP Host header syntax
11061
11401
  #
11062
11402
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
11063
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
11403
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
11064
11404
  #
11065
11405
  # The following operations are related to `ListMultipartUploads`:
11066
11406
  #
11067
- # * [CreateMultipartUpload][5]
11407
+ # * [CreateMultipartUpload][6]
11068
11408
  #
11069
- # * [UploadPart][6]
11409
+ # * [UploadPart][7]
11070
11410
  #
11071
- # * [CompleteMultipartUpload][7]
11411
+ # * [CompleteMultipartUpload][8]
11072
11412
  #
11073
- # * [ListParts][8]
11413
+ # * [ListParts][9]
11074
11414
  #
11075
- # * [AbortMultipartUpload][9]
11415
+ # * [AbortMultipartUpload][10]
11076
11416
  #
11077
11417
  #
11078
11418
  #
11079
11419
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
11080
11420
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
11081
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11082
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
11083
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
11084
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
11085
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
11086
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
11087
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
11421
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
11422
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11423
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
11424
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
11425
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
11426
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
11427
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
11428
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
11088
11429
  #
11089
11430
  # @option params [required, String] :bucket
11090
11431
  # The name of the bucket to which the multipart upload was initiated.
11091
11432
  #
11092
11433
  # **Directory buckets** - When you use this operation with a directory
11093
11434
  # bucket, you must use virtual-hosted-style requests in the format `
11094
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11095
- # are not supported. Directory bucket names must be unique in the chosen
11096
- # Availability Zone. Bucket names must follow the format `
11097
- # bucket_base_name--az-id--x-s3` (for example, `
11435
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
11436
+ # requests are not supported. Directory bucket names must be unique in
11437
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11438
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11098
11439
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11099
11440
  # naming restrictions, see [Directory bucket naming rules][1] in the
11100
11441
  # *Amazon S3 User Guide*.
@@ -11687,10 +12028,10 @@ module Aws::S3
11687
12028
  #
11688
12029
  # **Directory buckets** - When you use this operation with a directory
11689
12030
  # bucket, you must use virtual-hosted-style requests in the format `
11690
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11691
- # are not supported. Directory bucket names must be unique in the chosen
11692
- # Availability Zone. Bucket names must follow the format `
11693
- # bucket_base_name--az-id--x-s3` (for example, `
12031
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
12032
+ # requests are not supported. Directory bucket names must be unique in
12033
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12034
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11694
12035
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11695
12036
  # naming restrictions, see [Directory bucket naming rules][1] in the
11696
12037
  # *Amazon S3 User Guide*.
@@ -11902,9 +12243,13 @@ module Aws::S3
11902
12243
  # * **Directory buckets** - For directory buckets, you must make
11903
12244
  # requests for this API operation to the Zonal endpoint. These
11904
12245
  # endpoints support virtual-hosted-style requests in the format
11905
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
11906
- # `. Path-style requests are not supported. For more information, see
11907
- # [Regional and Zonal endpoints][3] in the *Amazon S3 User Guide*.
12246
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
12247
+ # `. Path-style requests are not supported. For more information about
12248
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
12249
+ # for directory buckets in Availability Zones][3] in the *Amazon S3
12250
+ # User Guide*. For more information about endpoints in Local Zones,
12251
+ # see [Available Local Zone for directory buckets][4] in the *Amazon
12252
+ # S3 User Guide*.
11908
12253
  #
11909
12254
  # </note>
11910
12255
  #
@@ -11914,12 +12259,12 @@ module Aws::S3
11914
12259
  # to perform the `s3:ListBucket` action. The bucket owner has this
11915
12260
  # permission by default and can grant this permission to others. For
11916
12261
  # more information about permissions, see [Permissions Related to
11917
- # Bucket Subresource Operations][4] and [Managing Access Permissions
11918
- # to Your Amazon S3 Resources][5] in the *Amazon S3 User Guide*.
12262
+ # Bucket Subresource Operations][5] and [Managing Access Permissions
12263
+ # to Your Amazon S3 Resources][6] in the *Amazon S3 User Guide*.
11919
12264
  #
11920
12265
  # * **Directory bucket permissions** - To grant access to this API
11921
12266
  # operation on a directory bucket, we recommend that you use the [
11922
- # `CreateSession` ][6] API operation for session-based
12267
+ # `CreateSession` ][7] API operation for session-based
11923
12268
  # authorization. Specifically, you grant the
11924
12269
  # `s3express:CreateSession` permission to the directory bucket in a
11925
12270
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -11930,7 +12275,7 @@ module Aws::S3
11930
12275
  # token for use. Amazon Web Services CLI or SDKs create session and
11931
12276
  # refresh the session token automatically to avoid service
11932
12277
  # interruptions when a session expires. For more information about
11933
- # authorization, see [ `CreateSession` ][6].
12278
+ # authorization, see [ `CreateSession` ][7].
11934
12279
  #
11935
12280
  # Sorting order of returned objects
11936
12281
  # : * **General purpose bucket** - For general purpose buckets,
@@ -11943,41 +12288,42 @@ module Aws::S3
11943
12288
  # HTTP Host header syntax
11944
12289
  #
11945
12290
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
11946
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
12291
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
11947
12292
  #
11948
12293
  # This section describes the latest revision of this action. We
11949
12294
  # recommend that you use this revised API operation for application
11950
12295
  # development. For backward compatibility, Amazon S3 continues to
11951
- # support the prior version of this API operation, [ListObjects][7].
12296
+ # support the prior version of this API operation, [ListObjects][8].
11952
12297
  #
11953
12298
  # The following operations are related to `ListObjectsV2`:
11954
12299
  #
11955
- # * [GetObject][8]
12300
+ # * [GetObject][9]
11956
12301
  #
11957
- # * [PutObject][9]
12302
+ # * [PutObject][10]
11958
12303
  #
11959
- # * [CreateBucket][10]
12304
+ # * [CreateBucket][11]
11960
12305
  #
11961
12306
  #
11962
12307
  #
11963
12308
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
11964
12309
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
11965
12310
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
11966
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
11967
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
11968
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
11969
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
11970
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
11971
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
11972
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
12311
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
12312
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12313
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
12314
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
12315
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
12316
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
12317
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
12318
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
11973
12319
  #
11974
12320
  # @option params [required, String] :bucket
11975
12321
  # **Directory buckets** - When you use this operation with a directory
11976
12322
  # bucket, you must use virtual-hosted-style requests in the format `
11977
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11978
- # are not supported. Directory bucket names must be unique in the chosen
11979
- # Availability Zone. Bucket names must follow the format `
11980
- # bucket_base_name--az-id--x-s3` (for example, `
12323
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
12324
+ # requests are not supported. Directory bucket names must be unique in
12325
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12326
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11981
12327
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11982
12328
  # naming restrictions, see [Directory bucket naming rules][1] in the
11983
12329
  # *Amazon S3 User Guide*.
@@ -12245,16 +12591,20 @@ module Aws::S3
12245
12591
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
12246
12592
  # for this API operation to the Zonal endpoint. These endpoints support
12247
12593
  # virtual-hosted-style requests in the format
12248
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
12249
- # Path-style requests are not supported. For more information, see
12250
- # [Regional and Zonal endpoints][3] in the *Amazon S3 User Guide*.
12594
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
12595
+ # `. Path-style requests are not supported. For more information about
12596
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
12597
+ # directory buckets in Availability Zones][3] in the *Amazon S3 User
12598
+ # Guide*. For more information about endpoints in Local Zones, see
12599
+ # [Available Local Zone for directory buckets][4] in the *Amazon S3 User
12600
+ # Guide*.
12251
12601
  #
12252
12602
  # </note>
12253
12603
  #
12254
12604
  # Permissions
12255
12605
  # : * **General purpose bucket permissions** - For information about
12256
12606
  # permissions required to use the multipart upload API, see
12257
- # [Multipart Upload and Permissions][4] in the *Amazon S3 User
12607
+ # [Multipart Upload and Permissions][5] in the *Amazon S3 User
12258
12608
  # Guide*.
12259
12609
  #
12260
12610
  # If the upload was created using server-side encryption with Key
@@ -12265,7 +12615,7 @@ module Aws::S3
12265
12615
  #
12266
12616
  # * **Directory bucket permissions** - To grant access to this API
12267
12617
  # operation on a directory bucket, we recommend that you use the [
12268
- # `CreateSession` ][5] API operation for session-based
12618
+ # `CreateSession` ][6] API operation for session-based
12269
12619
  # authorization. Specifically, you grant the
12270
12620
  # `s3express:CreateSession` permission to the directory bucket in a
12271
12621
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -12276,49 +12626,50 @@ module Aws::S3
12276
12626
  # token for use. Amazon Web Services CLI or SDKs create session and
12277
12627
  # refresh the session token automatically to avoid service
12278
12628
  # interruptions when a session expires. For more information about
12279
- # authorization, see [ `CreateSession` ][5].
12629
+ # authorization, see [ `CreateSession` ][6].
12280
12630
  #
12281
12631
  # HTTP Host header syntax
12282
12632
  #
12283
12633
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
12284
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
12634
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
12285
12635
  #
12286
12636
  # The following operations are related to `ListParts`:
12287
12637
  #
12288
12638
  # * [CreateMultipartUpload][1]
12289
12639
  #
12290
- # * [UploadPart][6]
12640
+ # * [UploadPart][7]
12291
12641
  #
12292
- # * [CompleteMultipartUpload][7]
12642
+ # * [CompleteMultipartUpload][8]
12293
12643
  #
12294
- # * [AbortMultipartUpload][8]
12644
+ # * [AbortMultipartUpload][9]
12295
12645
  #
12296
- # * [GetObjectAttributes][9]
12646
+ # * [GetObjectAttributes][10]
12297
12647
  #
12298
- # * [ListMultipartUploads][10]
12648
+ # * [ListMultipartUploads][11]
12299
12649
  #
12300
12650
  #
12301
12651
  #
12302
12652
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
12303
12653
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
12304
12654
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
12305
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
12306
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
12307
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
12308
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
12309
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
12310
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
12311
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
12655
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
12656
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
12657
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
12658
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
12659
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
12660
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
12661
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
12662
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
12312
12663
  #
12313
12664
  # @option params [required, String] :bucket
12314
12665
  # The name of the bucket to which the parts are being uploaded.
12315
12666
  #
12316
12667
  # **Directory buckets** - When you use this operation with a directory
12317
12668
  # bucket, you must use virtual-hosted-style requests in the format `
12318
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
12319
- # are not supported. Directory bucket names must be unique in the chosen
12320
- # Availability Zone. Bucket names must follow the format `
12321
- # bucket_base_name--az-id--x-s3` (for example, `
12669
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
12670
+ # requests are not supported. Directory bucket names must be unique in
12671
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12672
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
12322
12673
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12323
12674
  # naming restrictions, see [Directory bucket naming rules][1] in the
12324
12675
  # *Amazon S3 User Guide*.
@@ -13255,9 +13606,13 @@ module Aws::S3
13255
13606
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
13256
13607
  # requests for this API operation to the Regional endpoint. These
13257
13608
  # endpoints support path-style requests in the format
13258
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
13259
- # Virtual-hosted-style requests aren't supported. For more information,
13260
- # see [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
13609
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
13610
+ # Virtual-hosted-style requests aren't supported. For more information
13611
+ # about endpoints in Availability Zones, see [Regional and Zonal
13612
+ # endpoints for directory buckets in Availability Zones][1] in the
13613
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
13614
+ # Zones, see [Available Local Zone for directory buckets][2] in the
13615
+ # *Amazon S3 User Guide*.
13261
13616
  #
13262
13617
  # </note>
13263
13618
  #
@@ -13271,12 +13626,12 @@ module Aws::S3
13271
13626
  # keys (SSE-KMS) or dual-layer server-side encryption with Amazon
13272
13627
  # Web Services KMS keys (DSSE-KMS). If you specify default
13273
13628
  # encryption by using SSE-KMS, you can also configure [Amazon S3
13274
- # Bucket Keys][2]. For information about the bucket default
13275
- # encryption feature, see [Amazon S3 Bucket Default Encryption][3]
13629
+ # Bucket Keys][3]. For information about the bucket default
13630
+ # encryption feature, see [Amazon S3 Bucket Default Encryption][4]
13276
13631
  # in the *Amazon S3 User Guide*.
13277
13632
  #
13278
13633
  # * If you use PutBucketEncryption to set your [default bucket
13279
- # encryption][3] to SSE-KMS, you should verify that your KMS key ID
13634
+ # encryption][4] to SSE-KMS, you should verify that your KMS key ID
13280
13635
  # is correct. Amazon S3 doesn't validate the KMS key ID provided in
13281
13636
  # PutBucketEncryption requests.
13282
13637
  # * <b>Directory buckets </b> - You can optionally configure default
@@ -13290,28 +13645,28 @@ module Aws::S3
13290
13645
  # encrypted with the desired encryption settings. For more
13291
13646
  # information about the encryption overriding behaviors in directory
13292
13647
  # buckets, see [Specifying server-side encryption with KMS for new
13293
- # object uploads][4].
13648
+ # object uploads][5].
13294
13649
  #
13295
13650
  # * Your SSE-KMS configuration can only support 1 [customer managed
13296
- # key][5] per directory bucket for the lifetime of the bucket. The
13297
- # [Amazon Web Services managed key][6] (`aws/s3`) isn't supported.
13651
+ # key][6] per directory bucket for the lifetime of the bucket. The
13652
+ # [Amazon Web Services managed key][7] (`aws/s3`) isn't supported.
13298
13653
  #
13299
13654
  # * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
13300
13655
  # in a directory bucket and can’t be disabled. S3 Bucket Keys
13301
13656
  # aren't supported, when you copy SSE-KMS encrypted objects from
13302
13657
  # general purpose buckets to directory buckets, from directory
13303
13658
  # buckets to general purpose buckets, or between directory buckets,
13304
- # through [CopyObject][7], [UploadPartCopy][8], [the Copy operation
13305
- # in Batch Operations][9], or [the import jobs][10]. In this case,
13659
+ # through [CopyObject][8], [UploadPartCopy][9], [the Copy operation
13660
+ # in Batch Operations][10], or [the import jobs][11]. In this case,
13306
13661
  # Amazon S3 makes a call to KMS every time a copy request is made
13307
13662
  # for a KMS-encrypted object.
13308
13663
  #
13309
- # * When you specify an [KMS customer managed key][5] for encryption
13664
+ # * When you specify an [KMS customer managed key][6] for encryption
13310
13665
  # in your directory bucket, only use the key ID or key ARN. The key
13311
13666
  # alias format of the KMS key isn't supported.
13312
13667
  #
13313
13668
  # * For directory buckets, if you use PutBucketEncryption to set your
13314
- # [default bucket encryption][3] to SSE-KMS, Amazon S3 validates the
13669
+ # [default bucket encryption][4] to SSE-KMS, Amazon S3 validates the
13315
13670
  # KMS key ID provided in PutBucketEncryption requests.
13316
13671
  #
13317
13672
  # </note>
@@ -13324,7 +13679,7 @@ module Aws::S3
13324
13679
  #
13325
13680
  # Also, this action requires Amazon Web Services Signature Version 4.
13326
13681
  # For more information, see [ Authenticating Requests (Amazon Web
13327
- # Services Signature Version 4)][11].
13682
+ # Services Signature Version 4)][12].
13328
13683
  #
13329
13684
  # Permissions
13330
13685
  # : * **General purpose bucket permissions** - The
@@ -13332,8 +13687,8 @@ module Aws::S3
13332
13687
  # policy. The bucket owner has this permission by default. The
13333
13688
  # bucket owner can grant this permission to others. For more
13334
13689
  # information about permissions, see [Permissions Related to Bucket
13335
- # Operations][12] and [Managing Access Permissions to Your Amazon S3
13336
- # Resources][13] in the *Amazon S3 User Guide*.
13690
+ # Operations][13] and [Managing Access Permissions to Your Amazon S3
13691
+ # Resources][14] in the *Amazon S3 User Guide*.
13337
13692
  #
13338
13693
  # * **Directory bucket permissions** - To grant access to this API
13339
13694
  # operation, you must have the
@@ -13343,7 +13698,7 @@ module Aws::S3
13343
13698
  # only be performed by the Amazon Web Services account that owns the
13344
13699
  # resource. For more information about directory bucket policies and
13345
13700
  # permissions, see [Amazon Web Services Identity and Access
13346
- # Management (IAM) for S3 Express One Zone][14] in the *Amazon S3
13701
+ # Management (IAM) for S3 Express One Zone][15] in the *Amazon S3
13347
13702
  # User Guide*.
13348
13703
  #
13349
13704
  # To set a directory bucket default encryption with SSE-KMS, you
@@ -13354,32 +13709,33 @@ module Aws::S3
13354
13709
  # HTTP Host header syntax
13355
13710
  #
13356
13711
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
13357
- # `s3express-control.region.amazonaws.com`.
13712
+ # `s3express-control.region-code.amazonaws.com`.
13358
13713
  #
13359
13714
  # The following operations are related to `PutBucketEncryption`:
13360
13715
  #
13361
- # * [GetBucketEncryption][15]
13716
+ # * [GetBucketEncryption][16]
13362
13717
  #
13363
- # * [DeleteBucketEncryption][16]
13718
+ # * [DeleteBucketEncryption][17]
13364
13719
  #
13365
13720
  #
13366
13721
  #
13367
13722
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
13368
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
13369
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
13370
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
13371
- # [5]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
13372
- # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
13373
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
13374
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
13375
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
13376
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
13377
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
13378
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
13379
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
13380
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
13381
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
13382
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
13723
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
13724
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
13725
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
13726
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
13727
+ # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
13728
+ # [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
13729
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
13730
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
13731
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
13732
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
13733
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
13734
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
13735
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
13736
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
13737
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
13738
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
13383
13739
  #
13384
13740
  # @option params [required, String] :bucket
13385
13741
  # Specifies default encryption for a bucket using server-side encryption
@@ -13387,13 +13743,14 @@ module Aws::S3
13387
13743
  #
13388
13744
  # <b>Directory buckets </b> - When you use this operation with a
13389
13745
  # directory bucket, you must use path-style requests in the format
13390
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
13746
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
13391
13747
  # Virtual-hosted-style requests aren't supported. Directory bucket
13392
- # names must be unique in the chosen Availability Zone. Bucket names
13393
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
13394
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
13395
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
13396
- # the *Amazon S3 User Guide*
13748
+ # names must be unique in the chosen Zone (Availability Zone or Local
13749
+ # Zone). Bucket names must also follow the format `
13750
+ # bucket-base-name--zone-id--x-s3` (for example, `
13751
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
13752
+ # naming restrictions, see [Directory bucket naming rules][1] in the
13753
+ # *Amazon S3 User Guide*
13397
13754
  #
13398
13755
  #
13399
13756
  #
@@ -13912,6 +14269,16 @@ module Aws::S3
13912
14269
  # lifecycle configuration. For information about lifecycle
13913
14270
  # configuration, see [Managing your storage lifecycle][1].
13914
14271
  #
14272
+ # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
14273
+ # rule using an object key name prefix, one or more object tags, object
14274
+ # size, or any combination of these. Accordingly, this section describes
14275
+ # the latest API. The previous version of the API supported filtering
14276
+ # based only on an object key name prefix, which is supported for
14277
+ # backward compatibility. For the related API description, see
14278
+ # [PutBucketLifecycle][2].
14279
+ #
14280
+ # </note>
14281
+ #
13915
14282
  # Rules
13916
14283
  # Permissions
13917
14284
  # HTTP Host header syntax
@@ -13992,10 +14359,13 @@ module Aws::S3
13992
14359
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
13993
14360
  # requests for this API operation to the Regional endpoint. These
13994
14361
  # endpoints support path-style requests in the format
13995
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
14362
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
13996
14363
  # `. Virtual-hosted-style requests aren't supported. For more
13997
- # information, see [Regional and Zonal endpoints][7] in the *Amazon
13998
- # S3 User Guide*.
14364
+ # information about endpoints in Availability Zones, see [Regional
14365
+ # and Zonal endpoints for directory buckets in Availability
14366
+ # Zones][7] in the *Amazon S3 User Guide*. For more information
14367
+ # about endpoints in Local Zones, see [Available Local Zone for
14368
+ # directory buckets][8] in the *Amazon S3 User Guide*.
13999
14369
  #
14000
14370
  # </note>
14001
14371
  #
@@ -14005,9 +14375,9 @@ module Aws::S3
14005
14375
  # The following operations are related to
14006
14376
  # `PutBucketLifecycleConfiguration`:
14007
14377
  #
14008
- # * [GetBucketLifecycleConfiguration][8]
14378
+ # * [GetBucketLifecycleConfiguration][9]
14009
14379
  #
14010
- # * [DeleteBucketLifecycle][9]
14380
+ # * [DeleteBucketLifecycle][10]
14011
14381
  #
14012
14382
  #
14013
14383
  #
@@ -14018,8 +14388,9 @@ module Aws::S3
14018
14388
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
14019
14389
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14020
14390
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
14021
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
14022
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
14391
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
14392
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
14393
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
14023
14394
  #
14024
14395
  # @option params [required, String] :bucket
14025
14396
  # The name of the bucket for which to set the configuration.
@@ -14816,9 +15187,13 @@ module Aws::S3
14816
15187
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
14817
15188
  # requests for this API operation to the Regional endpoint. These
14818
15189
  # endpoints support path-style requests in the format
14819
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
14820
- # Virtual-hosted-style requests aren't supported. For more information,
14821
- # see [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
15190
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
15191
+ # Virtual-hosted-style requests aren't supported. For more information
15192
+ # about endpoints in Availability Zones, see [Regional and Zonal
15193
+ # endpoints for directory buckets in Availability Zones][1] in the
15194
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
15195
+ # Zones, see [Available Local Zone for directory buckets][2] in the
15196
+ # *Amazon S3 User Guide*.
14822
15197
  #
14823
15198
  # </note>
14824
15199
  #
@@ -14848,7 +15223,7 @@ module Aws::S3
14848
15223
  # * **General purpose bucket permissions** - The `s3:PutBucketPolicy`
14849
15224
  # permission is required in a policy. For more information about
14850
15225
  # general purpose buckets bucket policies, see [Using Bucket
14851
- # Policies and User Policies][2] in the *Amazon S3 User Guide*.
15226
+ # Policies and User Policies][3] in the *Amazon S3 User Guide*.
14852
15227
  #
14853
15228
  # * **Directory bucket permissions** - To grant access to this API
14854
15229
  # operation, you must have the `s3express:PutBucketPolicy`
@@ -14858,49 +15233,51 @@ module Aws::S3
14858
15233
  # Services account that owns the resource. For more information
14859
15234
  # about directory bucket policies and permissions, see [Amazon Web
14860
15235
  # Services Identity and Access Management (IAM) for S3 Express One
14861
- # Zone][3] in the *Amazon S3 User Guide*.
15236
+ # Zone][4] in the *Amazon S3 User Guide*.
14862
15237
  #
14863
15238
  # Example bucket policies
14864
15239
  #
14865
15240
  # : **General purpose buckets example bucket policies** - See [Bucket
14866
- # policy examples][4] in the *Amazon S3 User Guide*.
15241
+ # policy examples][5] in the *Amazon S3 User Guide*.
14867
15242
  #
14868
15243
  # **Directory bucket example bucket policies** - See [Example bucket
14869
- # policies for S3 Express One Zone][5] in the *Amazon S3 User Guide*.
15244
+ # policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
14870
15245
  #
14871
15246
  # HTTP Host header syntax
14872
15247
  #
14873
15248
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
14874
- # `s3express-control.region.amazonaws.com`.
15249
+ # `s3express-control.region-code.amazonaws.com`.
14875
15250
  #
14876
15251
  # The following operations are related to `PutBucketPolicy`:
14877
15252
  #
14878
- # * [CreateBucket][6]
15253
+ # * [CreateBucket][7]
14879
15254
  #
14880
- # * [DeleteBucket][7]
15255
+ # * [DeleteBucket][8]
14881
15256
  #
14882
15257
  #
14883
15258
  #
14884
15259
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
14885
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
14886
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14887
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
14888
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
14889
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
14890
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
15260
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
15261
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
15262
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
15263
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
15264
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
15265
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
15266
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
14891
15267
  #
14892
15268
  # @option params [required, String] :bucket
14893
15269
  # The name of the bucket.
14894
15270
  #
14895
15271
  # <b>Directory buckets </b> - When you use this operation with a
14896
15272
  # directory bucket, you must use path-style requests in the format
14897
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
15273
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
14898
15274
  # Virtual-hosted-style requests aren't supported. Directory bucket
14899
- # names must be unique in the chosen Availability Zone. Bucket names
14900
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
14901
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
14902
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
14903
- # the *Amazon S3 User Guide*
15275
+ # names must be unique in the chosen Zone (Availability Zone or Local
15276
+ # Zone). Bucket names must also follow the format `
15277
+ # bucket-base-name--zone-id--x-s3` (for example, `
15278
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15279
+ # naming restrictions, see [Directory bucket naming rules][1] in the
15280
+ # *Amazon S3 User Guide*
14904
15281
  #
14905
15282
  #
14906
15283
  #
@@ -15838,9 +16215,13 @@ module Aws::S3
15838
16215
  # * **Directory buckets** - For directory buckets, you must make
15839
16216
  # requests for this API operation to the Zonal endpoint. These
15840
16217
  # endpoints support virtual-hosted-style requests in the format
15841
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
15842
- # `. Path-style requests are not supported. For more information, see
15843
- # [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
16218
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
16219
+ # `. Path-style requests are not supported. For more information about
16220
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
16221
+ # for directory buckets in Availability Zones][1] in the *Amazon S3
16222
+ # User Guide*. For more information about endpoints in Local Zones,
16223
+ # see [Available Local Zone for directory buckets][2] in the *Amazon
16224
+ # S3 User Guide*.
15844
16225
  #
15845
16226
  # </note>
15846
16227
  #
@@ -15850,7 +16231,7 @@ module Aws::S3
15850
16231
  # modify this behavior:
15851
16232
  #
15852
16233
  # * **S3 Object Lock** - To prevent objects from being deleted or
15853
- # overwritten, you can use [Amazon S3 Object Lock][2] in the *Amazon
16234
+ # overwritten, you can use [Amazon S3 Object Lock][3] in the *Amazon
15854
16235
  # S3 User Guide*.
15855
16236
  #
15856
16237
  # <note markdown="1"> This functionality is not supported for directory buckets.
@@ -15864,9 +16245,9 @@ module Aws::S3
15864
16245
  # automatically generates a unique version ID of that object being
15865
16246
  # stored in Amazon S3. You can retrieve, replace, or delete any
15866
16247
  # version of the object. For more information about versioning, see
15867
- # [Adding Objects to Versioning-Enabled Buckets][3] in the *Amazon S3
16248
+ # [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
15868
16249
  # User Guide*. For information about returning the versioning state of
15869
- # a bucket, see [GetBucketVersioning][4].
16250
+ # a bucket, see [GetBucketVersioning][5].
15870
16251
  #
15871
16252
  # <note markdown="1"> This functionality is not supported for directory buckets.
15872
16253
  #
@@ -15890,7 +16271,7 @@ module Aws::S3
15890
16271
  # `s3:PutObjectTagging`.
15891
16272
  # * **Directory bucket permissions** - To grant access to this API
15892
16273
  # operation on a directory bucket, we recommend that you use the [
15893
- # `CreateSession` ][5] API operation for session-based
16274
+ # `CreateSession` ][6] API operation for session-based
15894
16275
  # authorization. Specifically, you grant the
15895
16276
  # `s3express:CreateSession` permission to the directory bucket in a
15896
16277
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -15901,7 +16282,7 @@ module Aws::S3
15901
16282
  # token for use. Amazon Web Services CLI or SDKs create session and
15902
16283
  # refresh the session token automatically to avoid service
15903
16284
  # interruptions when a session expires. For more information about
15904
- # authorization, see [ `CreateSession` ][5].
16285
+ # authorization, see [ `CreateSession` ][6].
15905
16286
  #
15906
16287
  # If the object is encrypted with SSE-KMS, you must also have the
15907
16288
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -15922,23 +16303,24 @@ module Aws::S3
15922
16303
  # HTTP Host header syntax
15923
16304
  #
15924
16305
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
15925
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
16306
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
15926
16307
  #
15927
16308
  # For more information about related Amazon S3 APIs, see the following:
15928
16309
  #
15929
- # * [CopyObject][6]
16310
+ # * [CopyObject][7]
15930
16311
  #
15931
- # * [DeleteObject][7]
16312
+ # * [DeleteObject][8]
15932
16313
  #
15933
16314
  #
15934
16315
  #
15935
16316
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
15936
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
15937
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
15938
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
15939
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
15940
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
15941
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
16317
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
16318
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
16319
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
16320
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
16321
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
16322
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
16323
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
15942
16324
  #
15943
16325
  # @option params [String] :acl
15944
16326
  # The canned ACL to apply to the object. For more information, see
@@ -15986,10 +16368,10 @@ module Aws::S3
15986
16368
  #
15987
16369
  # **Directory buckets** - When you use this operation with a directory
15988
16370
  # bucket, you must use virtual-hosted-style requests in the format `
15989
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
15990
- # are not supported. Directory bucket names must be unique in the chosen
15991
- # Availability Zone. Bucket names must follow the format `
15992
- # bucket_base_name--az-id--x-s3` (for example, `
16371
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
16372
+ # requests are not supported. Directory bucket names must be unique in
16373
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
16374
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
15993
16375
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15994
16376
  # naming restrictions, see [Directory bucket naming rules][1] in the
15995
16377
  # *Amazon S3 User Guide*.
@@ -16593,59 +16975,44 @@ module Aws::S3
16593
16975
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
16594
16976
  #
16595
16977
  #
16596
- # @example Example: To upload an object and specify server-side encryption and object tags
16597
- #
16598
- # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
16599
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
16600
- #
16601
- # resp = client.put_object({
16602
- # body: "filetoupload",
16603
- # bucket: "examplebucket",
16604
- # key: "exampleobject",
16605
- # server_side_encryption: "AES256",
16606
- # tagging: "key1=value1&key2=value2",
16607
- # })
16608
- #
16609
- # resp.to_h outputs the following:
16610
- # {
16611
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16612
- # server_side_encryption: "AES256",
16613
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16614
- # }
16615
- #
16616
- # @example Example: To upload an object
16978
+ # @example Example: To upload an object (specify optional headers)
16617
16979
  #
16618
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
16619
- # # syntax. S3 returns VersionId of the newly created object.
16980
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
16981
+ # # storage class and use server-side encryption.
16620
16982
  #
16621
16983
  # resp = client.put_object({
16622
16984
  # body: "HappyFace.jpg",
16623
16985
  # bucket: "examplebucket",
16624
16986
  # key: "HappyFace.jpg",
16987
+ # server_side_encryption: "AES256",
16988
+ # storage_class: "STANDARD_IA",
16625
16989
  # })
16626
16990
  #
16627
16991
  # resp.to_h outputs the following:
16628
16992
  # {
16629
16993
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16630
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16994
+ # server_side_encryption: "AES256",
16995
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16631
16996
  # }
16632
16997
  #
16633
- # @example Example: To upload an object and specify optional tags
16998
+ # @example Example: To upload an object and specify server-side encryption and object tags
16634
16999
  #
16635
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
16636
- # # S3 returns version ID of the newly created object.
17000
+ # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
17001
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
16637
17002
  #
16638
17003
  # resp = client.put_object({
16639
- # body: "c:\\HappyFace.jpg",
17004
+ # body: "filetoupload",
16640
17005
  # bucket: "examplebucket",
16641
- # key: "HappyFace.jpg",
17006
+ # key: "exampleobject",
17007
+ # server_side_encryption: "AES256",
16642
17008
  # tagging: "key1=value1&key2=value2",
16643
17009
  # })
16644
17010
  #
16645
17011
  # resp.to_h outputs the following:
16646
17012
  # {
16647
17013
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16648
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
17014
+ # server_side_encryption: "AES256",
17015
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16649
17016
  # }
16650
17017
  #
16651
17018
  # @example Example: To upload object and specify user-defined metadata
@@ -16687,24 +17054,39 @@ module Aws::S3
16687
17054
  # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
16688
17055
  # }
16689
17056
  #
16690
- # @example Example: To upload an object (specify optional headers)
17057
+ # @example Example: To upload an object and specify optional tags
16691
17058
  #
16692
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
16693
- # # storage class and use server-side encryption.
17059
+ # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
17060
+ # # S3 returns version ID of the newly created object.
17061
+ #
17062
+ # resp = client.put_object({
17063
+ # body: "c:\\HappyFace.jpg",
17064
+ # bucket: "examplebucket",
17065
+ # key: "HappyFace.jpg",
17066
+ # tagging: "key1=value1&key2=value2",
17067
+ # })
17068
+ #
17069
+ # resp.to_h outputs the following:
17070
+ # {
17071
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17072
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
17073
+ # }
17074
+ #
17075
+ # @example Example: To upload an object
17076
+ #
17077
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
17078
+ # # syntax. S3 returns VersionId of the newly created object.
16694
17079
  #
16695
17080
  # resp = client.put_object({
16696
17081
  # body: "HappyFace.jpg",
16697
17082
  # bucket: "examplebucket",
16698
17083
  # key: "HappyFace.jpg",
16699
- # server_side_encryption: "AES256",
16700
- # storage_class: "STANDARD_IA",
16701
17084
  # })
16702
17085
  #
16703
17086
  # resp.to_h outputs the following:
16704
17087
  # {
16705
17088
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16706
- # server_side_encryption: "AES256",
16707
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
17089
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16708
17090
  # }
16709
17091
  #
16710
17092
  # @example Example: To create an object.
@@ -18684,9 +19066,13 @@ module Aws::S3
18684
19066
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
18685
19067
  # for this API operation to the Zonal endpoint. These endpoints support
18686
19068
  # virtual-hosted-style requests in the format
18687
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
18688
- # Path-style requests are not supported. For more information, see
18689
- # [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
19069
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
19070
+ # `. Path-style requests are not supported. For more information about
19071
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
19072
+ # directory buckets in Availability Zones][5] in the *Amazon S3 User
19073
+ # Guide*. For more information about endpoints in Local Zones, see
19074
+ # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
19075
+ # Guide*.
18690
19076
  #
18691
19077
  # </note>
18692
19078
  #
@@ -18703,15 +19089,15 @@ module Aws::S3
18703
19089
  # These permissions are required because Amazon S3 must decrypt and
18704
19090
  # read data from the encrypted file parts before it completes the
18705
19091
  # multipart upload. For more information about KMS permissions, see
18706
- # [Protecting data using server-side encryption with KMS][6] in the
19092
+ # [Protecting data using server-side encryption with KMS][7] in the
18707
19093
  # *Amazon S3 User Guide*. For information about the permissions
18708
19094
  # required to use the multipart upload API, see [Multipart upload
18709
- # and permissions][7] and [Multipart upload API and permissions][8]
19095
+ # and permissions][8] and [Multipart upload API and permissions][9]
18710
19096
  # in the *Amazon S3 User Guide*.
18711
19097
  #
18712
19098
  # * **Directory bucket permissions** - To grant access to this API
18713
19099
  # operation on a directory bucket, we recommend that you use the [
18714
- # `CreateSession` ][9] API operation for session-based
19100
+ # `CreateSession` ][10] API operation for session-based
18715
19101
  # authorization. Specifically, you grant the
18716
19102
  # `s3express:CreateSession` permission to the directory bucket in a
18717
19103
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -18722,7 +19108,7 @@ module Aws::S3
18722
19108
  # token for use. Amazon Web Services CLI or SDKs create session and
18723
19109
  # refresh the session token automatically to avoid service
18724
19110
  # interruptions when a session expires. For more information about
18725
- # authorization, see [ `CreateSession` ][9].
19111
+ # authorization, see [ `CreateSession` ][10].
18726
19112
  #
18727
19113
  # If the object is encrypted with SSE-KMS, you must also have the
18728
19114
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -18738,7 +19124,7 @@ module Aws::S3
18738
19124
  # then Amazon Web Services S3 uses the `x-amz-content-sha256` header
18739
19125
  # as a checksum instead of `Content-MD5`. For more information see
18740
19126
  # [Authenticating Requests: Using the Authorization Header (Amazon Web
18741
- # Services Signature Version 4)][10].
19127
+ # Services Signature Version 4)][11].
18742
19128
  #
18743
19129
  # <note markdown="1"> **Directory buckets** - MD5 is not supported by directory buckets.
18744
19130
  # You can use checksum algorithms to check object integrity.
@@ -18778,7 +19164,7 @@ module Aws::S3
18778
19164
  # * x-amz-server-side-encryption-customer-key
18779
19165
  #
18780
19166
  # * x-amz-server-side-encryption-customer-key-MD5
18781
- # For more information, see [Using Server-Side Encryption][11] in
19167
+ # For more information, see [Using Server-Side Encryption][12] in
18782
19168
  # the *Amazon S3 User Guide*.
18783
19169
  #
18784
19170
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -18800,19 +19186,19 @@ module Aws::S3
18800
19186
  # HTTP Host header syntax
18801
19187
  #
18802
19188
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
18803
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
19189
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
18804
19190
  #
18805
19191
  # The following operations are related to `UploadPart`:
18806
19192
  #
18807
19193
  # * [CreateMultipartUpload][2]
18808
19194
  #
18809
- # * [CompleteMultipartUpload][12]
19195
+ # * [CompleteMultipartUpload][13]
18810
19196
  #
18811
- # * [AbortMultipartUpload][13]
19197
+ # * [AbortMultipartUpload][14]
18812
19198
  #
18813
- # * [ListParts][14]
19199
+ # * [ListParts][15]
18814
19200
  #
18815
- # * [ListMultipartUploads][15]
19201
+ # * [ListMultipartUploads][16]
18816
19202
  #
18817
19203
  #
18818
19204
  #
@@ -18821,16 +19207,17 @@ module Aws::S3
18821
19207
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
18822
19208
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
18823
19209
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
18824
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
18825
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
18826
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
18827
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
18828
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
18829
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
18830
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
18831
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
18832
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
18833
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
19210
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
19211
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19212
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
19213
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
19214
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
19215
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
19216
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
19217
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
19218
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
19219
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
19220
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
18834
19221
  #
18835
19222
  # @option params [String, StringIO, File] :body
18836
19223
  # Object data.
@@ -18840,10 +19227,10 @@ module Aws::S3
18840
19227
  #
18841
19228
  # **Directory buckets** - When you use this operation with a directory
18842
19229
  # bucket, you must use virtual-hosted-style requests in the format `
18843
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
18844
- # are not supported. Directory bucket names must be unique in the chosen
18845
- # Availability Zone. Bucket names must follow the format `
18846
- # bucket_base_name--az-id--x-s3` (for example, `
19230
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
19231
+ # requests are not supported. Directory bucket names must be unique in
19232
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
19233
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
18847
19234
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18848
19235
  # naming restrictions, see [Directory bucket naming rules][1] in the
18849
19236
  # *Amazon S3 User Guide*.
@@ -19124,9 +19511,13 @@ module Aws::S3
19124
19511
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
19125
19512
  # for this API operation to the Zonal endpoint. These endpoints support
19126
19513
  # virtual-hosted-style requests in the format
19127
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
19128
- # Path-style requests are not supported. For more information, see
19129
- # [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
19514
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
19515
+ # `. Path-style requests are not supported. For more information about
19516
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
19517
+ # directory buckets in Availability Zones][5] in the *Amazon S3 User
19518
+ # Guide*. For more information about endpoints in Local Zones, see
19519
+ # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
19520
+ # Guide*.
19130
19521
  #
19131
19522
  # </note>
19132
19523
  #
@@ -19136,7 +19527,7 @@ module Aws::S3
19136
19527
  # using IAM credentials (access key ID and secret access key for the
19137
19528
  # IAM identities). All headers with the `x-amz-` prefix, including
19138
19529
  # `x-amz-copy-source`, must be signed. For more information, see [REST
19139
- # Authentication][6].
19530
+ # Authentication][7].
19140
19531
  #
19141
19532
  # **Directory buckets** - You must use IAM credentials to authenticate
19142
19533
  # and authorize your access to the `UploadPartCopy` API operation,
@@ -19173,11 +19564,11 @@ module Aws::S3
19173
19564
  # permissions are required because Amazon S3 must decrypt and read
19174
19565
  # data from the encrypted file parts before it completes the
19175
19566
  # multipart upload. For more information about KMS permissions,
19176
- # see [Protecting data using server-side encryption with KMS][7]
19567
+ # see [Protecting data using server-side encryption with KMS][8]
19177
19568
  # in the *Amazon S3 User Guide*. For information about the
19178
19569
  # permissions required to use the multipart upload API, see
19179
- # [Multipart upload and permissions][8] and [Multipart upload API
19180
- # and permissions][9] in the *Amazon S3 User Guide*.
19570
+ # [Multipart upload and permissions][9] and [Multipart upload API
19571
+ # and permissions][10] in the *Amazon S3 User Guide*.
19181
19572
  # * **Directory bucket permissions** - You must have permissions in a
19182
19573
  # bucket policy or an IAM identity-based policy based on the source
19183
19574
  # and destination bucket types in an `UploadPartCopy` operation.
@@ -19200,14 +19591,14 @@ module Aws::S3
19200
19591
  # identity-based policies and KMS key policies for the KMS key.
19201
19592
  #
19202
19593
  # For example policies, see [Example bucket policies for S3 Express
19203
- # One Zone][10] and [Amazon Web Services Identity and Access
19594
+ # One Zone][11] and [Amazon Web Services Identity and Access
19204
19595
  # Management (IAM) identity-based policies for S3 Express One
19205
- # Zone][11] in the *Amazon S3 User Guide*.
19596
+ # Zone][12] in the *Amazon S3 User Guide*.
19206
19597
  #
19207
19598
  # Encryption
19208
19599
  # : * <b>General purpose buckets </b> - For information about using
19209
19600
  # server-side encryption with customer-provided encryption keys with
19210
- # the `UploadPartCopy` operation, see [CopyObject][12] and
19601
+ # the `UploadPartCopy` operation, see [CopyObject][13] and
19211
19602
  # [UploadPart][2].
19212
19603
  #
19213
19604
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -19215,7 +19606,7 @@ module Aws::S3
19215
19606
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
19216
19607
  # server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
19217
19608
  # more information, see [Protecting data with server-side
19218
- # encryption][13] in the *Amazon S3 User Guide*.
19609
+ # encryption][14] in the *Amazon S3 User Guide*.
19219
19610
  #
19220
19611
  # <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
19221
19612
  # operation and an `UploadPartCopy` operation, the request headers
@@ -19227,7 +19618,7 @@ module Aws::S3
19227
19618
  # S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
19228
19619
  # objects from general purpose buckets to directory buckets, from
19229
19620
  # directory buckets to general purpose buckets, or between directory
19230
- # buckets, through [UploadPartCopy][14]. In this case, Amazon S3
19621
+ # buckets, through [UploadPartCopy][15]. In this case, Amazon S3
19231
19622
  # makes a call to KMS every time a copy request is made for a
19232
19623
  # KMS-encrypted object.
19233
19624
  #
@@ -19249,21 +19640,21 @@ module Aws::S3
19249
19640
  # HTTP Host header syntax
19250
19641
  #
19251
19642
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
19252
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
19643
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
19253
19644
  #
19254
19645
  # The following operations are related to `UploadPartCopy`:
19255
19646
  #
19256
- # * [CreateMultipartUpload][15]
19647
+ # * [CreateMultipartUpload][16]
19257
19648
  #
19258
19649
  # * [UploadPart][2]
19259
19650
  #
19260
- # * [CompleteMultipartUpload][16]
19651
+ # * [CompleteMultipartUpload][17]
19261
19652
  #
19262
- # * [AbortMultipartUpload][17]
19653
+ # * [AbortMultipartUpload][18]
19263
19654
  #
19264
- # * [ListParts][18]
19655
+ # * [ListParts][19]
19265
19656
  #
19266
- # * [ListMultipartUploads][19]
19657
+ # * [ListMultipartUploads][20]
19267
19658
  #
19268
19659
  #
19269
19660
  #
@@ -19272,34 +19663,43 @@ module Aws::S3
19272
19663
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
19273
19664
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
19274
19665
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
19275
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
19276
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19277
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
19278
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
19279
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
19280
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
19281
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
19282
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
19283
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
19284
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
19285
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
19286
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
19287
- # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
19288
- # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
19666
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
19667
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
19668
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19669
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
19670
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
19671
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
19672
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
19673
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
19674
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
19675
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
19676
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
19677
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
19678
+ # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
19679
+ # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
19680
+ # [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
19289
19681
  #
19290
19682
  # @option params [required, String] :bucket
19291
19683
  # The bucket name.
19292
19684
  #
19293
19685
  # **Directory buckets** - When you use this operation with a directory
19294
19686
  # bucket, you must use virtual-hosted-style requests in the format `
19295
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
19296
- # are not supported. Directory bucket names must be unique in the chosen
19297
- # Availability Zone. Bucket names must follow the format `
19298
- # bucket_base_name--az-id--x-s3` (for example, `
19687
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
19688
+ # requests are not supported. Directory bucket names must be unique in
19689
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
19690
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
19299
19691
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
19300
19692
  # naming restrictions, see [Directory bucket naming rules][1] in the
19301
19693
  # *Amazon S3 User Guide*.
19302
19694
  #
19695
+ # <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
19696
+ # supported when the source or destination bucket is in Amazon Web
19697
+ # Services Local Zones. The source and destination buckets must have the
19698
+ # same parent Amazon Web Services Region. Otherwise, you get an HTTP
19699
+ # `400 Bad Request` error with the error code `InvalidRequest`.
19700
+ #
19701
+ # </note>
19702
+ #
19303
19703
  # **Access points** - When you use this action with an access point, you
19304
19704
  # must provide the alias of the access point in place of the bucket name
19305
19705
  # or specify the access point ARN. When using the access point ARN, you
@@ -19571,45 +19971,45 @@ module Aws::S3
19571
19971
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
19572
19972
  #
19573
19973
  #
19574
- # @example Example: To upload a part by copying data from an existing object as data source
19974
+ # @example Example: To upload a part by copying byte range from an existing object as data source
19575
19975
  #
19576
- # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
19976
+ # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
19977
+ # # data source.
19577
19978
  #
19578
19979
  # resp = client.upload_part_copy({
19579
19980
  # bucket: "examplebucket",
19580
19981
  # copy_source: "/bucketname/sourceobjectkey",
19982
+ # copy_source_range: "bytes=1-100000",
19581
19983
  # key: "examplelargeobject",
19582
- # part_number: 1,
19984
+ # part_number: 2,
19583
19985
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
19584
19986
  # })
19585
19987
  #
19586
19988
  # resp.to_h outputs the following:
19587
19989
  # {
19588
19990
  # copy_part_result: {
19589
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
19590
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
19991
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
19992
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
19591
19993
  # },
19592
19994
  # }
19593
19995
  #
19594
- # @example Example: To upload a part by copying byte range from an existing object as data source
19996
+ # @example Example: To upload a part by copying data from an existing object as data source
19595
19997
  #
19596
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
19597
- # # data source.
19998
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
19598
19999
  #
19599
20000
  # resp = client.upload_part_copy({
19600
20001
  # bucket: "examplebucket",
19601
20002
  # copy_source: "/bucketname/sourceobjectkey",
19602
- # copy_source_range: "bytes=1-100000",
19603
20003
  # key: "examplelargeobject",
19604
- # part_number: 2,
20004
+ # part_number: 1,
19605
20005
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
19606
20006
  # })
19607
20007
  #
19608
20008
  # resp.to_h outputs the following:
19609
20009
  # {
19610
20010
  # copy_part_result: {
19611
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
19612
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
20011
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
20012
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
19613
20013
  # },
19614
20014
  # }
19615
20015
  #
@@ -20071,7 +20471,7 @@ module Aws::S3
20071
20471
  tracer: tracer
20072
20472
  )
20073
20473
  context[:gem_name] = 'aws-sdk-s3'
20074
- context[:gem_version] = '1.174.0'
20474
+ context[:gem_version] = '1.176.0'
20075
20475
  Seahorse::Client::Request.new(handlers, context)
20076
20476
  end
20077
20477