aws-sdk-s3 1.174.0 → 1.176.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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