aws-sdk-s3 1.174.0 → 1.175.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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
  # },
@@ -2604,9 +2632,13 @@ module Aws::S3
2604
2632
  # * <b>Directory buckets </b> - For directory buckets, you must make
2605
2633
  # requests for this API operation to the Zonal endpoint. These
2606
2634
  # 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*.
2635
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
2636
+ # `. Path-style requests are not supported. For more information about
2637
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
2638
+ # for directory buckets in Availability Zones][4] in the *Amazon S3
2639
+ # User Guide*. For more information about endpoints in Local Zones,
2640
+ # see [Available Local Zone for directory buckets][5] in the *Amazon
2641
+ # S3 User Guide*.
2610
2642
  #
2611
2643
  # </note>
2612
2644
  #
@@ -2618,7 +2650,7 @@ module Aws::S3
2618
2650
  # sign each request individually. There is nothing special about
2619
2651
  # signing multipart upload requests. For more information about
2620
2652
  # signing, see [Authenticating Requests (Amazon Web Services Signature
2621
- # Version 4)][5] in the *Amazon S3 User Guide*.
2653
+ # Version 4)][6] in the *Amazon S3 User Guide*.
2622
2654
  #
2623
2655
  # Permissions
2624
2656
  # : * **General purpose bucket permissions** - To perform a multipart
@@ -2631,13 +2663,13 @@ module Aws::S3
2631
2663
  # `UploadPartCopy` APIs. These permissions are required because
2632
2664
  # Amazon S3 must decrypt and read data from the encrypted file parts
2633
2665
  # 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
2666
+ # see [Multipart upload API and permissions][7] and [Protecting data
2667
+ # using server-side encryption with Amazon Web Services KMS][8] in
2636
2668
  # the *Amazon S3 User Guide*.
2637
2669
  #
2638
2670
  # * **Directory bucket permissions** - To grant access to this API
2639
2671
  # operation on a directory bucket, we recommend that you use the [
2640
- # `CreateSession` ][8] API operation for session-based
2672
+ # `CreateSession` ][9] API operation for session-based
2641
2673
  # authorization. Specifically, you grant the
2642
2674
  # `s3express:CreateSession` permission to the directory bucket in a
2643
2675
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -2648,7 +2680,7 @@ module Aws::S3
2648
2680
  # token for use. Amazon Web Services CLI or SDKs create session and
2649
2681
  # refresh the session token automatically to avoid service
2650
2682
  # interruptions when a session expires. For more information about
2651
- # authorization, see [ `CreateSession` ][8].
2683
+ # authorization, see [ `CreateSession` ][9].
2652
2684
  #
2653
2685
  # Encryption
2654
2686
  # : * **General purpose buckets** - Server-side encryption is for data
@@ -2675,7 +2707,7 @@ module Aws::S3
2675
2707
  # the destination bucket, the encryption setting in your request
2676
2708
  # takes precedence. If you choose to provide your own encryption
2677
2709
  # key, the request headers you provide in [UploadPart][1] and
2678
- # [UploadPartCopy][9] requests must match the headers you used in
2710
+ # [UploadPartCopy][10] requests must match the headers you used in
2679
2711
  # the `CreateMultipartUpload` request.
2680
2712
  #
2681
2713
  # * Use KMS keys (SSE-KMS) that include the Amazon Web Services
@@ -2700,9 +2732,9 @@ module Aws::S3
2700
2732
  # actions on the key. These permissions are required because
2701
2733
  # Amazon S3 must decrypt and read data from the encrypted file
2702
2734
  # parts before it completes the multipart upload. For more
2703
- # information, see [Multipart upload API and permissions][6] and
2735
+ # information, see [Multipart upload API and permissions][7] and
2704
2736
  # [Protecting data using server-side encryption with Amazon Web
2705
- # Services KMS][7] in the *Amazon S3 User Guide*.
2737
+ # Services KMS][8] in the *Amazon S3 User Guide*.
2706
2738
  #
2707
2739
  # * If your Identity and Access Management (IAM) user or role is
2708
2740
  # in the same Amazon Web Services account as the KMS key, then
@@ -2717,13 +2749,13 @@ module Aws::S3
2717
2749
  # For information about configuring any of the officially
2718
2750
  # supported Amazon Web Services SDKs and Amazon Web Services
2719
2751
  # CLI, see [Specifying the Signature Version in Request
2720
- # Authentication][10] in the *Amazon S3 User Guide*.
2752
+ # Authentication][11] in the *Amazon S3 User Guide*.
2721
2753
  #
2722
2754
  # </note>
2723
2755
  #
2724
2756
  # For more information about server-side encryption with KMS keys
2725
2757
  # (SSE-KMS), see [Protecting Data Using Server-Side Encryption
2726
- # with KMS keys][7] in the *Amazon S3 User Guide*.
2758
+ # with KMS keys][8] in the *Amazon S3 User Guide*.
2727
2759
  #
2728
2760
  # * Use customer-provided encryption keys (SSE-C) – If you want to
2729
2761
  # manage your own encryption keys, provide all the following
@@ -2737,7 +2769,7 @@ module Aws::S3
2737
2769
  # For more information about server-side encryption with
2738
2770
  # customer-provided encryption keys (SSE-C), see [ Protecting data
2739
2771
  # using server-side encryption with customer-provided encryption
2740
- # keys (SSE-C)][11] in the *Amazon S3 User Guide*.
2772
+ # keys (SSE-C)][12] in the *Amazon S3 User Guide*.
2741
2773
  # * **Directory buckets** - For directory buckets, there are only two
2742
2774
  # supported options for server-side encryption: server-side
2743
2775
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
@@ -2747,13 +2779,13 @@ module Aws::S3
2747
2779
  # default encryption in your `CreateSession` requests or `PUT`
2748
2780
  # object requests. Then, new objects are automatically encrypted
2749
2781
  # with the desired encryption settings. For more information, see
2750
- # [Protecting data with server-side encryption][12] in the *Amazon
2782
+ # [Protecting data with server-side encryption][13] in the *Amazon
2751
2783
  # S3 User Guide*. For more information about the encryption
2752
2784
  # overriding behaviors in directory buckets, see [Specifying
2753
- # server-side encryption with KMS for new object uploads][13].
2785
+ # server-side encryption with KMS for new object uploads][14].
2754
2786
  #
2755
- # In the Zonal endpoint API calls (except [CopyObject][14] and
2756
- # [UploadPartCopy][9]) using the REST API, the encryption request
2787
+ # In the Zonal endpoint API calls (except [CopyObject][15] and
2788
+ # [UploadPartCopy][10]) using the REST API, the encryption request
2757
2789
  # headers must match the encryption settings that are specified in
2758
2790
  # the `CreateSession` request. You can't override the values of the
2759
2791
  # encryption settings (`x-amz-server-side-encryption`,
@@ -2773,7 +2805,7 @@ module Aws::S3
2773
2805
  # configuration for the `CreateSession` request. It's not supported
2774
2806
  # to override the encryption settings values in the `CreateSession`
2775
2807
  # request. So in the Zonal endpoint API calls (except
2776
- # [CopyObject][14] and [UploadPartCopy][9]), the encryption request
2808
+ # [CopyObject][15] and [UploadPartCopy][10]), the encryption request
2777
2809
  # headers must match the default encryption configuration of the
2778
2810
  # directory bucket.
2779
2811
  #
@@ -2789,19 +2821,19 @@ module Aws::S3
2789
2821
  # HTTP Host header syntax
2790
2822
  #
2791
2823
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
2792
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
2824
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
2793
2825
  #
2794
2826
  # The following operations are related to `CreateMultipartUpload`:
2795
2827
  #
2796
2828
  # * [UploadPart][1]
2797
2829
  #
2798
- # * [CompleteMultipartUpload][15]
2830
+ # * [CompleteMultipartUpload][16]
2799
2831
  #
2800
- # * [AbortMultipartUpload][16]
2832
+ # * [AbortMultipartUpload][17]
2801
2833
  #
2802
- # * [ListParts][17]
2834
+ # * [ListParts][18]
2803
2835
  #
2804
- # * [ListMultipartUploads][18]
2836
+ # * [ListMultipartUploads][19]
2805
2837
  #
2806
2838
  #
2807
2839
  #
@@ -2809,20 +2841,21 @@ module Aws::S3
2809
2841
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
2810
2842
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
2811
2843
  # [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
2844
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
2845
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
2846
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
2847
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
2848
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
2849
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
2850
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
2851
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
2852
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
2853
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
2854
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
2855
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
2856
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
2857
+ # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
2858
+ # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
2826
2859
  #
2827
2860
  # @option params [String] :acl
2828
2861
  # The canned ACL to apply to the object. Amazon S3 supports a set of
@@ -2855,10 +2888,10 @@ module Aws::S3
2855
2888
  #
2856
2889
  # **Directory buckets** - When you use this operation with a directory
2857
2890
  # 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, `
2891
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
2892
+ # requests are not supported. Directory bucket names must be unique in
2893
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
2894
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
2862
2895
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
2863
2896
  # naming restrictions, see [Directory bucket naming rules][1] in the
2864
2897
  # *Amazon S3 User Guide*.
@@ -3555,23 +3588,27 @@ module Aws::S3
3555
3588
  #
3556
3589
  # <note markdown="1"> * You must make requests for this API operation to the Zonal endpoint.
3557
3590
  # 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*.
3591
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
3592
+ # Path-style requests are not supported. For more information about
3593
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
3594
+ # for directory buckets in Availability Zones][3] in the *Amazon S3
3595
+ # User Guide*. For more information about endpoints in Local Zones,
3596
+ # see [Available Local Zone for directory buckets][4] in the *Amazon
3597
+ # S3 User Guide*.
3561
3598
  #
3562
3599
  # * <b> <code>CopyObject</code> API operation</b> - Unlike other Zonal
3563
3600
  # endpoint API operations, the `CopyObject` API operation doesn't use
3564
3601
  # the temporary security credentials returned from the `CreateSession`
3565
3602
  # API operation for authentication and authorization. For information
3566
3603
  # about authentication and authorization of the `CopyObject` API
3567
- # operation on directory buckets, see [CopyObject][4].
3604
+ # operation on directory buckets, see [CopyObject][5].
3568
3605
  #
3569
3606
  # * <b> <code>HeadBucket</code> API operation</b> - Unlike other Zonal
3570
3607
  # endpoint API operations, the `HeadBucket` API operation doesn't use
3571
3608
  # the temporary security credentials returned from the `CreateSession`
3572
3609
  # API operation for authentication and authorization. For information
3573
3610
  # about authentication and authorization of the `HeadBucket` API
3574
- # operation on directory buckets, see [HeadBucket][5].
3611
+ # operation on directory buckets, see [HeadBucket][6].
3575
3612
  #
3576
3613
  # </note>
3577
3614
  #
@@ -3583,10 +3620,10 @@ module Aws::S3
3583
3620
  # can have the `s3express:SessionMode` condition key to control who
3584
3621
  # can create a `ReadWrite` or `ReadOnly` session. For more information
3585
3622
  # 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
3623
+ # `x-amz-create-session-mode` ][7]. For example policies, see [Example
3624
+ # bucket policies for S3 Express One Zone][8] and [Amazon Web Services
3588
3625
  # Identity and Access Management (IAM) identity-based policies for S3
3589
- # Express One Zone][8] in the *Amazon S3 User Guide*.
3626
+ # Express One Zone][9] in the *Amazon S3 User Guide*.
3590
3627
  #
3591
3628
  # To grant cross-account access to Zonal endpoint API operations, the
3592
3629
  # bucket policy should also grant both accounts the
@@ -3607,32 +3644,32 @@ module Aws::S3
3607
3644
  # requests or `PUT` object requests. Then, new objects are
3608
3645
  # automatically encrypted with the desired encryption settings. For
3609
3646
  # more information, see [Protecting data with server-side
3610
- # encryption][9] in the *Amazon S3 User Guide*. For more information
3647
+ # encryption][10] in the *Amazon S3 User Guide*. For more information
3611
3648
  # about the encryption overriding behaviors in directory buckets, see
3612
3649
  # [Specifying server-side encryption with KMS for new object
3613
- # uploads][10].
3650
+ # uploads][11].
3614
3651
  #
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
3652
+ # For [Zonal endpoint (object-level) API operations][12] except
3653
+ # [CopyObject][5] and [UploadPartCopy][13], you authenticate and
3654
+ # authorize requests through [CreateSession][14] for low latency. To
3618
3655
  # encrypt new objects in a directory bucket with SSE-KMS, you must
3619
3656
  # specify SSE-KMS as the directory bucket's default encryption
3620
3657
  # configuration with a KMS key (specifically, a [customer managed
3621
- # key][14]). Then, when a session is created for Zonal endpoint API
3658
+ # key][15]). Then, when a session is created for Zonal endpoint API
3622
3659
  # operations, new objects are automatically encrypted and decrypted
3623
3660
  # with SSE-KMS and S3 Bucket Keys during the session.
3624
3661
  #
3625
- # <note markdown="1"> Only 1 [customer managed key][14] is supported per directory bucket
3662
+ # <note markdown="1"> Only 1 [customer managed key][15] is supported per directory bucket
3626
3663
  # 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
3664
+ # key][16] (`aws/s3`) isn't supported. After you specify SSE-KMS as
3628
3665
  # your bucket's default encryption configuration with a customer
3629
3666
  # managed key, you can't change the customer managed key for the
3630
3667
  # bucket's SSE-KMS configuration.
3631
3668
  #
3632
3669
  # </note>
3633
3670
  #
3634
- # In the Zonal endpoint API calls (except [CopyObject][4] and
3635
- # [UploadPartCopy][12]) using the REST API, you can't override the
3671
+ # In the Zonal endpoint API calls (except [CopyObject][5] and
3672
+ # [UploadPartCopy][13]) using the REST API, you can't override the
3636
3673
  # values of the encryption settings (`x-amz-server-side-encryption`,
3637
3674
  # `x-amz-server-side-encryption-aws-kms-key-id`,
3638
3675
  # `x-amz-server-side-encryption-context`, and
@@ -3648,8 +3685,8 @@ module Aws::S3
3648
3685
  # Web Services SDKs use the bucket's default encryption configuration
3649
3686
  # for the `CreateSession` request. It's not supported to override the
3650
3687
  # 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
3688
+ # the Zonal endpoint API calls (except [CopyObject][5] and
3689
+ # [UploadPartCopy][13]), it's not supported to override the values of
3653
3690
  # the encryption settings from the `CreateSession` request.
3654
3691
  #
3655
3692
  # </note>
@@ -3657,25 +3694,26 @@ module Aws::S3
3657
3694
  # HTTP Host header syntax
3658
3695
  #
3659
3696
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
3660
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
3697
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
3661
3698
  #
3662
3699
  #
3663
3700
  #
3664
3701
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
3665
3702
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-optimizing-performance-guidelines-design-patterns.html#s3-express-optimizing-performance-session-authentication
3666
3703
  # [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
3704
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
3705
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
3706
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
3707
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
3708
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
3709
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
3710
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3711
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
3712
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
3713
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
3714
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
3715
+ # [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
3716
+ # [16]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
3679
3717
  #
3680
3718
  # @option params [String] :session_mode
3681
3719
  # Specifies the mode of the session that will be created, either
@@ -3817,10 +3855,13 @@ module Aws::S3
3817
3855
  # * <b>Directory buckets </b> - For directory buckets, you must make
3818
3856
  # requests for this API operation to the Regional endpoint. These
3819
3857
  # endpoints support path-style requests in the format
3820
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
3858
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
3821
3859
  # Virtual-hosted-style requests aren't supported. For more
3822
- # information, see [Regional and Zonal endpoints][1] in the *Amazon S3
3823
- # User Guide*.
3860
+ # information about endpoints in Availability Zones, see [Regional and
3861
+ # Zonal endpoints for directory buckets in Availability Zones][1] in
3862
+ # the *Amazon S3 User Guide*. For more information about endpoints in
3863
+ # Local Zones, see [Available Local Zone for directory buckets][2] in
3864
+ # the *Amazon S3 User Guide*.
3824
3865
  #
3825
3866
  # </note>
3826
3867
  #
@@ -3835,39 +3876,41 @@ module Aws::S3
3835
3876
  # performed by the Amazon Web Services account that owns the
3836
3877
  # resource. For more information about directory bucket policies and
3837
3878
  # permissions, see [Amazon Web Services Identity and Access
3838
- # Management (IAM) for S3 Express One Zone][2] in the *Amazon S3
3879
+ # Management (IAM) for S3 Express One Zone][3] in the *Amazon S3
3839
3880
  # User Guide*.
3840
3881
  #
3841
3882
  # HTTP Host header syntax
3842
3883
  #
3843
3884
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
3844
- # `s3express-control.region.amazonaws.com`.
3885
+ # `s3express-control.region-code.amazonaws.com`.
3845
3886
  #
3846
3887
  # The following operations are related to `DeleteBucket`:
3847
3888
  #
3848
- # * [CreateBucket][3]
3889
+ # * [CreateBucket][4]
3849
3890
  #
3850
- # * [DeleteObject][4]
3891
+ # * [DeleteObject][5]
3851
3892
  #
3852
3893
  #
3853
3894
  #
3854
3895
  # [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
3896
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
3897
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
3898
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
3899
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
3858
3900
  #
3859
3901
  # @option params [required, String] :bucket
3860
3902
  # Specifies the bucket being deleted.
3861
3903
  #
3862
3904
  # <b>Directory buckets </b> - When you use this operation with a
3863
3905
  # directory bucket, you must use path-style requests in the format
3864
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
3906
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
3865
3907
  # 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*
3908
+ # names must be unique in the chosen Zone (Availability Zone or Local
3909
+ # Zone). Bucket names must also follow the format `
3910
+ # bucket-base-name--zone-id--x-s3` (for example, `
3911
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
3912
+ # naming restrictions, see [Directory bucket naming rules][1] in the
3913
+ # *Amazon S3 User Guide*
3871
3914
  #
3872
3915
  #
3873
3916
  #
@@ -4076,7 +4119,7 @@ module Aws::S3
4076
4119
  # HTTP Host header syntax
4077
4120
  #
4078
4121
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
4079
- # `s3express-control.region.amazonaws.com`.
4122
+ # `s3express-control.region-code.amazonaws.com`.
4080
4123
  #
4081
4124
  # The following operations are related to `DeleteBucketEncryption`:
4082
4125
  #
@@ -4100,13 +4143,14 @@ module Aws::S3
4100
4143
  #
4101
4144
  # <b>Directory buckets </b> - When you use this operation with a
4102
4145
  # directory bucket, you must use path-style requests in the format
4103
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4146
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4104
4147
  # 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*
4148
+ # names must be unique in the chosen Zone (Availability Zone or Local
4149
+ # Zone). Bucket names must also follow the format `
4150
+ # bucket-base-name--zone-id--x-s3` (for example, `
4151
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4152
+ # naming restrictions, see [Directory bucket naming rules][1] in the
4153
+ # *Amazon S3 User Guide*
4110
4154
  #
4111
4155
  #
4112
4156
  #
@@ -4308,10 +4352,13 @@ module Aws::S3
4308
4352
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
4309
4353
  # requests for this API operation to the Regional endpoint. These
4310
4354
  # endpoints support path-style requests in the format
4311
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
4355
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
4312
4356
  # `. Virtual-hosted-style requests aren't supported. For more
4313
- # information, see [Regional and Zonal endpoints][3] in the *Amazon
4314
- # S3 User Guide*.
4357
+ # information about endpoints in Availability Zones, see [Regional
4358
+ # and Zonal endpoints for directory buckets in Availability
4359
+ # Zones][3] in the *Amazon S3 User Guide*. For more information
4360
+ # about endpoints in Local Zones, see [Available Local Zone for
4361
+ # directory buckets][4] in the *Amazon S3 User Guide*.
4315
4362
  #
4316
4363
  # </note>
4317
4364
  # ^
@@ -4322,22 +4369,23 @@ module Aws::S3
4322
4369
  # `s3express-control.region.amazonaws.com`.
4323
4370
  #
4324
4371
  # For more information about the object expiration, see [Elements to
4325
- # Describe Lifecycle Actions][4].
4372
+ # Describe Lifecycle Actions][5].
4326
4373
  #
4327
4374
  # Related actions include:
4328
4375
  #
4329
- # * [PutBucketLifecycleConfiguration][5]
4376
+ # * [PutBucketLifecycleConfiguration][6]
4330
4377
  #
4331
- # * [GetBucketLifecycleConfiguration][6]
4378
+ # * [GetBucketLifecycleConfiguration][7]
4332
4379
  #
4333
4380
  #
4334
4381
  #
4335
4382
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
4336
4383
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4337
4384
  # [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
4385
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
4386
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
4387
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
4388
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
4341
4389
  #
4342
4390
  # @option params [required, String] :bucket
4343
4391
  # The bucket name of the lifecycle to delete.
@@ -4504,9 +4552,13 @@ module Aws::S3
4504
4552
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
4505
4553
  # requests for this API operation to the Regional endpoint. These
4506
4554
  # 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*.
4555
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4556
+ # Virtual-hosted-style requests aren't supported. For more information
4557
+ # about endpoints in Availability Zones, see [Regional and Zonal
4558
+ # endpoints for directory buckets in Availability Zones][1] in the
4559
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
4560
+ # Zones, see [Available Local Zone for directory buckets][2] in the
4561
+ # *Amazon S3 User Guide*.
4510
4562
  #
4511
4563
  # </note>
4512
4564
  #
@@ -4536,7 +4588,7 @@ module Aws::S3
4536
4588
  # * **General purpose bucket permissions** - The
4537
4589
  # `s3:DeleteBucketPolicy` permission is required in a policy. For
4538
4590
  # more information about general purpose buckets bucket policies,
4539
- # see [Using Bucket Policies and User Policies][2] in the *Amazon S3
4591
+ # see [Using Bucket Policies and User Policies][3] in the *Amazon S3
4540
4592
  # User Guide*.
4541
4593
  #
4542
4594
  # * **Directory bucket permissions** - To grant access to this API
@@ -4547,39 +4599,41 @@ module Aws::S3
4547
4599
  # Services account that owns the resource. For more information
4548
4600
  # about directory bucket policies and permissions, see [Amazon Web
4549
4601
  # Services Identity and Access Management (IAM) for S3 Express One
4550
- # Zone][3] in the *Amazon S3 User Guide*.
4602
+ # Zone][4] in the *Amazon S3 User Guide*.
4551
4603
  #
4552
4604
  # HTTP Host header syntax
4553
4605
  #
4554
4606
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
4555
- # `s3express-control.region.amazonaws.com`.
4607
+ # `s3express-control.region-code.amazonaws.com`.
4556
4608
  #
4557
4609
  # The following operations are related to `DeleteBucketPolicy`
4558
4610
  #
4559
- # * [CreateBucket][4]
4611
+ # * [CreateBucket][5]
4560
4612
  #
4561
- # * [DeleteObject][5]
4613
+ # * [DeleteObject][6]
4562
4614
  #
4563
4615
  #
4564
4616
  #
4565
4617
  # [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
4618
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
4619
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
4620
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4621
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
4622
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
4570
4623
  #
4571
4624
  # @option params [required, String] :bucket
4572
4625
  # The bucket name.
4573
4626
  #
4574
4627
  # <b>Directory buckets </b> - When you use this operation with a
4575
4628
  # directory bucket, you must use path-style requests in the format
4576
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4629
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4577
4630
  # 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*
4631
+ # names must be unique in the chosen Zone (Availability Zone or Local
4632
+ # Zone). Bucket names must also follow the format `
4633
+ # bucket-base-name--zone-id--x-s3` (for example, `
4634
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4635
+ # naming restrictions, see [Directory bucket naming rules][1] in the
4636
+ # *Amazon S3 User Guide*
4583
4637
  #
4584
4638
  #
4585
4639
  #
@@ -4818,33 +4872,71 @@ module Aws::S3
4818
4872
  end
4819
4873
 
4820
4874
  # 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].
4875
+ # versioning state:
4876
+ #
4877
+ # * If bucket versioning is not enabled, the operation permanently
4878
+ # deletes the object.
4879
+ #
4880
+ # * If bucket versioning is enabled, the operation inserts a delete
4881
+ # marker, which becomes the current version of the object. To
4882
+ # permanently delete an object in a versioned bucket, you must include
4883
+ # the object’s `versionId` in the request. For more information about
4884
+ # versioning-enabled buckets, see [Deleting object versions from a
4885
+ # versioning-enabled bucket][1].
4886
+ #
4887
+ # * If bucket versioning is suspended, the operation removes the object
4888
+ # that has a null `versionId`, if there is one, and inserts a delete
4889
+ # marker that becomes the current version of the object. If there
4890
+ # isn't an object with a null `versionId`, and all versions of the
4891
+ # object have a `versionId`, Amazon S3 does not remove the object and
4892
+ # only inserts a delete marker. To permanently delete an object that
4893
+ # has a `versionId`, you must include the object’s `versionId` in the
4894
+ # request. For more information about versioning-suspended buckets,
4895
+ # see [Deleting objects from versioning-suspended buckets][2].
4896
+ #
4897
+ # <note markdown="1"> * **Directory buckets** - S3 Versioning isn't enabled and supported
4898
+ # for directory buckets. For this API operation, only the `null` value
4899
+ # of the version ID is supported by directory buckets. You can only
4900
+ # specify `null` to the `versionId` query parameter in the request.
4901
+ #
4902
+ # * **Directory buckets** - For directory buckets, you must make
4903
+ # requests for this API operation to the Zonal endpoint. These
4904
+ # endpoints support virtual-hosted-style requests in the format
4905
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
4906
+ # `. Path-style requests are not supported. For more information about
4907
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
4908
+ # for directory buckets in Availability Zones][3] in the *Amazon S3
4909
+ # User Guide*. For more information about endpoints in Local Zones,
4910
+ # see [Available Local Zone for directory buckets][4] in the *Amazon
4911
+ # S3 User Guide*.
4912
+ #
4913
+ # </note>
4823
4914
  #
4824
4915
  # To remove a specific version, you must use the `versionId` query
4825
4916
  # parameter. Using this query parameter permanently deletes the version.
4826
4917
  # 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*.
4918
+ # header `x-amz-delete-marker` to true.
4834
4919
  #
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.
4920
+ # If the object you want to delete is in a bucket where the bucket
4921
+ # versioning configuration is MFA Delete enabled, you must include the
4922
+ # `x-amz-mfa` request header in the DELETE `versionId` request. Requests
4923
+ # that include `x-amz-mfa` must use HTTPS. For more information about
4924
+ # MFA Delete, see [Using MFA Delete][5] in the *Amazon S3 User Guide*.
4925
+ # To see sample requests that use versioning, see [Sample Request][6].
4839
4926
  #
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*.
4927
+ # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
4928
+ # buckets.
4846
4929
  #
4847
- # * MFA delete is not supported by directory buckets.
4930
+ # </note>
4931
+ #
4932
+ # You can delete objects by explicitly calling DELETE Object or calling
4933
+ # ([PutBucketLifecycle][7]) to enable Amazon S3 to remove them for you.
4934
+ # If you want to block users or accounts from removing or deleting
4935
+ # objects from your bucket, you must deny them the `s3:DeleteObject`,
4936
+ # `s3:DeleteObjectVersion`, and `s3:PutLifeCycleConfiguration` actions.
4937
+ #
4938
+ # <note markdown="1"> **Directory buckets** - S3 Lifecycle is not supported by directory
4939
+ # buckets.
4848
4940
  #
4849
4941
  # </note>
4850
4942
  #
@@ -4856,51 +4948,56 @@ module Aws::S3
4856
4948
  # * <b> <code>s3:DeleteObject</code> </b> - To delete an object from
4857
4949
  # a bucket, you must always have the `s3:DeleteObject` permission.
4858
4950
  #
4859
- # <note markdown="1"> You can also use PutBucketLifecycle to delete objects in Amazon
4860
- # S3.
4861
- #
4862
- # </note>
4863
- #
4864
4951
  # * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
4865
4952
  # specific version of an object from a versioning-enabled bucket,
4866
4953
  # 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.
4954
+ # * **Directory bucket permissions** - To grant access to this API
4955
+ # operation on a directory bucket, we recommend that you use the [
4956
+ # `CreateSession` ][8] API operation for session-based
4957
+ # authorization. Specifically, you grant the
4958
+ # `s3express:CreateSession` permission to the directory bucket in a
4959
+ # bucket policy or an IAM identity-based policy. Then, you make the
4960
+ # `CreateSession` API call on the bucket to obtain a session token.
4961
+ # With the session token in your request header, you can make API
4962
+ # requests to this operation. After the session token expires, you
4963
+ # make another `CreateSession` API call to generate a new session
4964
+ # token for use. Amazon Web Services CLI or SDKs create session and
4965
+ # refresh the session token automatically to avoid service
4966
+ # interruptions when a session expires. For more information about
4967
+ # authorization, see [ `CreateSession` ][8].
4875
4968
  #
4876
4969
  # HTTP Host header syntax
4877
4970
  #
4878
4971
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
4879
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
4972
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
4880
4973
  #
4881
4974
  # The following action is related to `DeleteObject`:
4882
4975
  #
4883
- # * [PutObject][5]
4976
+ # * [PutObject][9]
4884
4977
  #
4885
4978
  # ^
4886
4979
  #
4887
4980
  #
4888
4981
  #
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
4982
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
4983
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectsfromVersioningSuspendedBuckets.html
4984
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4985
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
4986
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
4987
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
4988
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
4989
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
4990
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
4894
4991
  #
4895
4992
  # @option params [required, String] :bucket
4896
4993
  # The bucket name of the bucket containing the object.
4897
4994
  #
4898
4995
  # **Directory buckets** - When you use this operation with a directory
4899
4996
  # 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, `
4997
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
4998
+ # requests are not supported. Directory bucket names must be unique in
4999
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
5000
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
4904
5001
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4905
5002
  # naming restrictions, see [Directory bucket naming rules][1] in the
4906
5003
  # *Amazon S3 User Guide*.
@@ -5038,15 +5135,6 @@ module Aws::S3
5038
5135
  # * {Types::DeleteObjectOutput#request_charged #request_charged} => String
5039
5136
  #
5040
5137
  #
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
5138
  # @example Example: To delete an object
5051
5139
  #
5052
5140
  # # The following example deletes an object from an S3 bucket.
@@ -5060,6 +5148,15 @@ module Aws::S3
5060
5148
  # {
5061
5149
  # }
5062
5150
  #
5151
+ # @example Example: To delete an object (from a non-versioned bucket)
5152
+ #
5153
+ # # The following example deletes an object from a non-versioned bucket.
5154
+ #
5155
+ # resp = client.delete_object({
5156
+ # bucket: "ExampleBucket",
5157
+ # key: "HappyFace.jpg",
5158
+ # })
5159
+ #
5063
5160
  # @example Request syntax with placeholder values
5064
5161
  #
5065
5162
  # resp = client.delete_object({
@@ -5233,9 +5330,13 @@ module Aws::S3
5233
5330
  # * **Directory buckets** - For directory buckets, you must make
5234
5331
  # requests for this API operation to the Zonal endpoint. These
5235
5332
  # 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*.
5333
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
5334
+ # `. Path-style requests are not supported. For more information about
5335
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
5336
+ # for directory buckets in Availability Zones][1] in the *Amazon S3
5337
+ # User Guide*. For more information about endpoints in Local Zones,
5338
+ # see [Available Local Zone for directory buckets][2] in the *Amazon
5339
+ # S3 User Guide*.
5239
5340
  #
5240
5341
  # </note>
5241
5342
  #
@@ -5253,7 +5354,7 @@ module Aws::S3
5253
5354
  # if there are non-versioned objects you are trying to delete. If you
5254
5355
  # provide an invalid token, whether there are versioned keys in the
5255
5356
  # 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
5357
+ # information about MFA Delete, see [MFA Delete][3] in the *Amazon S3
5257
5358
  # User Guide*.
5258
5359
  #
5259
5360
  # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
@@ -5275,7 +5376,7 @@ module Aws::S3
5275
5376
  # you must specify the `s3:DeleteObjectVersion` permission.
5276
5377
  # * **Directory bucket permissions** - To grant access to this API
5277
5378
  # operation on a directory bucket, we recommend that you use the [
5278
- # `CreateSession` ][3] API operation for session-based
5379
+ # `CreateSession` ][4] API operation for session-based
5279
5380
  # authorization. Specifically, you grant the
5280
5381
  # `s3express:CreateSession` permission to the directory bucket in a
5281
5382
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -5286,7 +5387,7 @@ module Aws::S3
5286
5387
  # token for use. Amazon Web Services CLI or SDKs create session and
5287
5388
  # refresh the session token automatically to avoid service
5288
5389
  # interruptions when a session expires. For more information about
5289
- # authorization, see [ `CreateSession` ][3].
5390
+ # authorization, see [ `CreateSession` ][4].
5290
5391
  #
5291
5392
  # Content-MD5 request header
5292
5393
  # : * **General purpose bucket** - The Content-MD5 request header is
@@ -5303,40 +5404,41 @@ module Aws::S3
5303
5404
  # HTTP Host header syntax
5304
5405
  #
5305
5406
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
5306
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
5407
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
5307
5408
  #
5308
5409
  # The following operations are related to `DeleteObjects`:
5309
5410
  #
5310
- # * [CreateMultipartUpload][4]
5411
+ # * [CreateMultipartUpload][5]
5311
5412
  #
5312
- # * [UploadPart][5]
5413
+ # * [UploadPart][6]
5313
5414
  #
5314
- # * [CompleteMultipartUpload][6]
5415
+ # * [CompleteMultipartUpload][7]
5315
5416
  #
5316
- # * [ListParts][7]
5417
+ # * [ListParts][8]
5317
5418
  #
5318
- # * [AbortMultipartUpload][8]
5419
+ # * [AbortMultipartUpload][9]
5319
5420
  #
5320
5421
  #
5321
5422
  #
5322
5423
  # [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
5424
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
5425
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
5426
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
5427
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
5428
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
5429
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
5430
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
5431
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
5330
5432
  #
5331
5433
  # @option params [required, String] :bucket
5332
5434
  # The bucket name containing the objects to delete.
5333
5435
  #
5334
5436
  # **Directory buckets** - When you use this operation with a directory
5335
5437
  # 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, `
5438
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
5439
+ # requests are not supported. Directory bucket names must be unique in
5440
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
5441
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
5340
5442
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
5341
5443
  # naming restrictions, see [Directory bucket naming rules][1] in the
5342
5444
  # *Amazon S3 User Guide*.
@@ -5471,22 +5573,20 @@ module Aws::S3
5471
5573
  # * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
5472
5574
  #
5473
5575
  #
5474
- # @example Example: To delete multiple object versions from a versioned bucket
5576
+ # @example Example: To delete multiple objects from a versioned bucket
5475
5577
  #
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.
5578
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
5579
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
5478
5580
  #
5479
5581
  # resp = client.delete_objects({
5480
5582
  # bucket: "examplebucket",
5481
5583
  # delete: {
5482
5584
  # objects: [
5483
5585
  # {
5484
- # key: "HappyFace.jpg",
5485
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5586
+ # key: "objectkey1",
5486
5587
  # },
5487
5588
  # {
5488
- # key: "HappyFace.jpg",
5489
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5589
+ # key: "objectkey2",
5490
5590
  # },
5491
5591
  # ],
5492
5592
  # quiet: false,
@@ -5497,30 +5597,34 @@ module Aws::S3
5497
5597
  # {
5498
5598
  # deleted: [
5499
5599
  # {
5500
- # key: "HappyFace.jpg",
5501
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5600
+ # delete_marker: true,
5601
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
5602
+ # key: "objectkey1",
5502
5603
  # },
5503
5604
  # {
5504
- # key: "HappyFace.jpg",
5505
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5605
+ # delete_marker: true,
5606
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
5607
+ # key: "objectkey2",
5506
5608
  # },
5507
5609
  # ],
5508
5610
  # }
5509
5611
  #
5510
- # @example Example: To delete multiple objects from a versioned bucket
5612
+ # @example Example: To delete multiple object versions from a versioned bucket
5511
5613
  #
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.
5614
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
5615
+ # # versions and returns the key and versions of deleted objects in the response.
5514
5616
  #
5515
5617
  # resp = client.delete_objects({
5516
5618
  # bucket: "examplebucket",
5517
5619
  # delete: {
5518
5620
  # objects: [
5519
5621
  # {
5520
- # key: "objectkey1",
5622
+ # key: "HappyFace.jpg",
5623
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5521
5624
  # },
5522
5625
  # {
5523
- # key: "objectkey2",
5626
+ # key: "HappyFace.jpg",
5627
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5524
5628
  # },
5525
5629
  # ],
5526
5630
  # quiet: false,
@@ -5531,14 +5635,12 @@ module Aws::S3
5531
5635
  # {
5532
5636
  # deleted: [
5533
5637
  # {
5534
- # delete_marker: true,
5535
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
5536
- # key: "objectkey1",
5638
+ # key: "HappyFace.jpg",
5639
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5537
5640
  # },
5538
5641
  # {
5539
- # delete_marker: true,
5540
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
5541
- # key: "objectkey2",
5642
+ # key: "HappyFace.jpg",
5643
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5542
5644
  # },
5543
5645
  # ],
5544
5646
  # }
@@ -6083,7 +6185,7 @@ module Aws::S3
6083
6185
  # HTTP Host header syntax
6084
6186
  #
6085
6187
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
6086
- # `s3express-control.region.amazonaws.com`.
6188
+ # `s3express-control.region-code.amazonaws.com`.
6087
6189
  #
6088
6190
  # The following operations are related to `GetBucketEncryption`:
6089
6191
  #
@@ -6107,13 +6209,14 @@ module Aws::S3
6107
6209
  #
6108
6210
  # <b>Directory buckets </b> - When you use this operation with a
6109
6211
  # directory bucket, you must use path-style requests in the format
6110
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
6212
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
6111
6213
  # 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*
6214
+ # names must be unique in the chosen Zone (Availability Zone or Local
6215
+ # Zone). Bucket names must also follow the format `
6216
+ # bucket-base-name--zone-id--x-s3` (for example, `
6217
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
6218
+ # naming restrictions, see [Directory bucket naming rules][1] in the
6219
+ # *Amazon S3 User Guide*
6117
6220
  #
6118
6221
  #
6119
6222
  #
@@ -6490,10 +6593,13 @@ module Aws::S3
6490
6593
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
6491
6594
  # requests for this API operation to the Regional endpoint. These
6492
6595
  # endpoints support path-style requests in the format
6493
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
6596
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
6494
6597
  # `. Virtual-hosted-style requests aren't supported. For more
6495
- # information, see [Regional and Zonal endpoints][5] in the *Amazon
6496
- # S3 User Guide*.
6598
+ # information about endpoints in Availability Zones, see [Regional
6599
+ # and Zonal endpoints for directory buckets in Availability
6600
+ # Zones][5] in the *Amazon S3 User Guide*. For more information
6601
+ # about endpoints in Local Zones, see [Available Local Zone for
6602
+ # directory buckets][6] in the *Amazon S3 User Guide*.
6497
6603
  #
6498
6604
  # </note>
6499
6605
  #
@@ -6517,9 +6623,9 @@ module Aws::S3
6517
6623
  #
6518
6624
  # * [GetBucketLifecycle][2]
6519
6625
  #
6520
- # * [PutBucketLifecycle][6]
6626
+ # * [PutBucketLifecycle][7]
6521
6627
  #
6522
- # * [DeleteBucketLifecycle][7]
6628
+ # * [DeleteBucketLifecycle][8]
6523
6629
  #
6524
6630
  #
6525
6631
  #
@@ -6528,8 +6634,9 @@ module Aws::S3
6528
6634
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6529
6635
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
6530
6636
  # [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
6637
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
6638
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
6639
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
6533
6640
  #
6534
6641
  # @option params [required, String] :bucket
6535
6642
  # The name of the bucket for which to get the lifecycle information.
@@ -7174,9 +7281,13 @@ module Aws::S3
7174
7281
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
7175
7282
  # requests for this API operation to the Regional endpoint. These
7176
7283
  # 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*.
7284
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
7285
+ # Virtual-hosted-style requests aren't supported. For more information
7286
+ # about endpoints in Availability Zones, see [Regional and Zonal
7287
+ # endpoints for directory buckets in Availability Zones][1] in the
7288
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
7289
+ # Zones, see [Available Local Zone for directory buckets][2] in the
7290
+ # *Amazon S3 User Guide*.
7180
7291
  #
7181
7292
  # </note>
7182
7293
  #
@@ -7206,7 +7317,7 @@ module Aws::S3
7206
7317
  # * **General purpose bucket permissions** - The `s3:GetBucketPolicy`
7207
7318
  # permission is required in a policy. For more information about
7208
7319
  # general purpose buckets bucket policies, see [Using Bucket
7209
- # Policies and User Policies][2] in the *Amazon S3 User Guide*.
7320
+ # Policies and User Policies][3] in the *Amazon S3 User Guide*.
7210
7321
  #
7211
7322
  # * **Directory bucket permissions** - To grant access to this API
7212
7323
  # operation, you must have the `s3express:GetBucketPolicy`
@@ -7216,48 +7327,50 @@ module Aws::S3
7216
7327
  # Services account that owns the resource. For more information
7217
7328
  # about directory bucket policies and permissions, see [Amazon Web
7218
7329
  # Services Identity and Access Management (IAM) for S3 Express One
7219
- # Zone][3] in the *Amazon S3 User Guide*.
7330
+ # Zone][4] in the *Amazon S3 User Guide*.
7220
7331
  #
7221
7332
  # Example bucket policies
7222
7333
  #
7223
7334
  # : **General purpose buckets example bucket policies** - See [Bucket
7224
- # policy examples][4] in the *Amazon S3 User Guide*.
7335
+ # policy examples][5] in the *Amazon S3 User Guide*.
7225
7336
  #
7226
7337
  # **Directory bucket example bucket policies** - See [Example bucket
7227
- # policies for S3 Express One Zone][5] in the *Amazon S3 User Guide*.
7338
+ # policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
7228
7339
  #
7229
7340
  # HTTP Host header syntax
7230
7341
  #
7231
7342
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
7232
- # `s3express-control.region.amazonaws.com`.
7343
+ # `s3express-control.region-code.amazonaws.com`.
7233
7344
  #
7234
7345
  # The following action is related to `GetBucketPolicy`:
7235
7346
  #
7236
- # * [GetObject][6]
7347
+ # * [GetObject][7]
7237
7348
  #
7238
7349
  # ^
7239
7350
  #
7240
7351
  #
7241
7352
  #
7242
7353
  # [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
7354
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
7355
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
7356
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
7357
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
7358
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
7359
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
7248
7360
  #
7249
7361
  # @option params [required, String] :bucket
7250
7362
  # The bucket name to get the bucket policy for.
7251
7363
  #
7252
7364
  # <b>Directory buckets </b> - When you use this operation with a
7253
7365
  # directory bucket, you must use path-style requests in the format
7254
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
7366
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
7255
7367
  # 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*
7368
+ # names must be unique in the chosen Zone (Availability Zone or Local
7369
+ # Zone). Bucket names must also follow the format `
7370
+ # bucket-base-name--zone-id--x-s3` (for example, `
7371
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7372
+ # naming restrictions, see [Directory bucket naming rules][1] in the
7373
+ # *Amazon S3 User Guide*
7261
7374
  #
7262
7375
  # **Access points** - When you use this API operation with an access
7263
7376
  # point, provide the alias of the access point in place of the bucket
@@ -7860,9 +7973,13 @@ module Aws::S3
7860
7973
  # `/photos/2006/February/sample.jpg`. Also, when you make requests to
7861
7974
  # this API operation, your requests are sent to the Zonal endpoint.
7862
7975
  # 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*.
7976
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
7977
+ # `. Path-style requests are not supported. For more information about
7978
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
7979
+ # directory buckets in Availability Zones][2] in the *Amazon S3 User
7980
+ # Guide*. For more information about endpoints in Local Zones, see
7981
+ # [Available Local Zone for directory buckets][3] in the *Amazon S3 User
7982
+ # Guide*.
7866
7983
  #
7867
7984
  # Permissions
7868
7985
  # : * **General purpose bucket permissions** - You must have the
@@ -7870,7 +7987,7 @@ module Aws::S3
7870
7987
  # have the `READ` access to the object (or version). If you grant
7871
7988
  # `READ` access to the anonymous user, the `GetObject` operation
7872
7989
  # returns the object without using an authorization header. For more
7873
- # information, see [Specifying permissions in a policy][3] in the
7990
+ # information, see [Specifying permissions in a policy][4] in the
7874
7991
  # *Amazon S3 User Guide*.
7875
7992
  #
7876
7993
  # If you include a `versionId` in your request header, you must have
@@ -7894,7 +8011,7 @@ module Aws::S3
7894
8011
  # returns an HTTP status code `403 Access Denied` error.
7895
8012
  # * **Directory bucket permissions** - To grant access to this API
7896
8013
  # operation on a directory bucket, we recommend that you use the [
7897
- # `CreateSession` ][4] API operation for session-based
8014
+ # `CreateSession` ][5] API operation for session-based
7898
8015
  # authorization. Specifically, you grant the
7899
8016
  # `s3express:CreateSession` permission to the directory bucket in a
7900
8017
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -7905,7 +8022,7 @@ module Aws::S3
7905
8022
  # token for use. Amazon Web Services CLI or SDKs create session and
7906
8023
  # refresh the session token automatically to avoid service
7907
8024
  # interruptions when a session expires. For more information about
7908
- # authorization, see [ `CreateSession` ][4].
8025
+ # authorization, see [ `CreateSession` ][5].
7909
8026
  #
7910
8027
  # If the object is encrypted using SSE-KMS, you must also have the
7911
8028
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -7918,9 +8035,9 @@ module Aws::S3
7918
8035
  # storage class, the S3 Intelligent-Tiering Archive Access tier, or
7919
8036
  # the S3 Intelligent-Tiering Deep Archive Access tier, before you can
7920
8037
  # retrieve the object you must first restore a copy using
7921
- # [RestoreObject][5]. Otherwise, this operation returns an
8038
+ # [RestoreObject][6]. Otherwise, this operation returns an
7922
8039
  # `InvalidObjectState` error. For information about restoring archived
7923
- # objects, see [Restoring Archived Objects][6] in the *Amazon S3 User
8040
+ # objects, see [Restoring Archived Objects][7] in the *Amazon S3 User
7924
8041
  # Guide*.
7925
8042
  #
7926
8043
  # <b>Directory buckets </b> - For directory buckets, only the S3
@@ -7942,7 +8059,7 @@ module Aws::S3
7942
8059
  # **Directory buckets** - For directory buckets, there are only two
7943
8060
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
7944
8061
  # SSE-C isn't supported. For more information, see [Protecting data
7945
- # with server-side encryption][7] in the *Amazon S3 User Guide*.
8062
+ # with server-side encryption][8] in the *Amazon S3 User Guide*.
7946
8063
  #
7947
8064
  # Overriding response header values through the request
7948
8065
  #
@@ -7987,25 +8104,26 @@ module Aws::S3
7987
8104
  # HTTP Host header syntax
7988
8105
  #
7989
8106
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
7990
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
8107
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
7991
8108
  #
7992
8109
  # The following operations are related to `GetObject`:
7993
8110
  #
7994
- # * [ListBuckets][8]
8111
+ # * [ListBuckets][9]
7995
8112
  #
7996
- # * [GetObjectAcl][9]
8113
+ # * [GetObjectAcl][10]
7997
8114
  #
7998
8115
  #
7999
8116
  #
8000
8117
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
8001
8118
  # [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
8119
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
8120
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8121
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
8122
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
8123
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
8124
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
8125
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
8126
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
8009
8127
  #
8010
8128
  # @option params [String, IO] :response_target
8011
8129
  # Where to write response data, file path, or IO object.
@@ -8015,10 +8133,10 @@ module Aws::S3
8015
8133
  #
8016
8134
  # **Directory buckets** - When you use this operation with a directory
8017
8135
  # 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, `
8136
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
8137
+ # requests are not supported. Directory bucket names must be unique in
8138
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
8139
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8022
8140
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8023
8141
  # naming restrictions, see [Directory bucket naming rules][1] in the
8024
8142
  # *Amazon S3 User Guide*.
@@ -8352,49 +8470,49 @@ module Aws::S3
8352
8470
  # * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
8353
8471
  #
8354
8472
  #
8355
- # @example Example: To retrieve an object
8473
+ # @example Example: To retrieve a byte range of an object
8356
8474
  #
8357
- # # The following example retrieves an object for an S3 bucket.
8475
+ # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
8476
+ # # specific byte range.
8358
8477
  #
8359
8478
  # resp = client.get_object({
8360
8479
  # bucket: "examplebucket",
8361
- # key: "HappyFace.jpg",
8480
+ # key: "SampleFile.txt",
8481
+ # range: "bytes=0-9",
8362
8482
  # })
8363
8483
  #
8364
8484
  # resp.to_h outputs the following:
8365
8485
  # {
8366
8486
  # 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"),
8487
+ # content_length: 10,
8488
+ # content_range: "bytes 0-9/43",
8489
+ # content_type: "text/plain",
8490
+ # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
8491
+ # last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
8371
8492
  # metadata: {
8372
8493
  # },
8373
- # tag_count: 2,
8374
8494
  # version_id: "null",
8375
8495
  # }
8376
8496
  #
8377
- # @example Example: To retrieve a byte range of an object
8497
+ # @example Example: To retrieve an object
8378
8498
  #
8379
- # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
8380
- # # specific byte range.
8499
+ # # The following example retrieves an object for an S3 bucket.
8381
8500
  #
8382
8501
  # resp = client.get_object({
8383
8502
  # bucket: "examplebucket",
8384
- # key: "SampleFile.txt",
8385
- # range: "bytes=0-9",
8503
+ # key: "HappyFace.jpg",
8386
8504
  # })
8387
8505
  #
8388
8506
  # resp.to_h outputs the following:
8389
8507
  # {
8390
8508
  # 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"),
8509
+ # content_length: 3191,
8510
+ # content_type: "image/jpeg",
8511
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8512
+ # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
8396
8513
  # metadata: {
8397
8514
  # },
8515
+ # tag_count: 2,
8398
8516
  # version_id: "null",
8399
8517
  # }
8400
8518
  #
@@ -8698,9 +8816,13 @@ module Aws::S3
8698
8816
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
8699
8817
  # for this API operation to the Zonal endpoint. These endpoints support
8700
8818
  # 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*.
8819
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
8820
+ # `. Path-style requests are not supported. For more information about
8821
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
8822
+ # directory buckets in Availability Zones][1] in the *Amazon S3 User
8823
+ # Guide*. For more information about endpoints in Local Zones, see
8824
+ # [Available Local Zone for directory buckets][2] in the *Amazon S3 User
8825
+ # Guide*.
8704
8826
  #
8705
8827
  # </note>
8706
8828
  #
@@ -8713,7 +8835,7 @@ module Aws::S3
8713
8835
  # `s3:GetObjectVersionAttributes` permissions for this operation. If
8714
8836
  # the bucket is not versioned, you need the `s3:GetObject` and
8715
8837
  # `s3:GetObjectAttributes` permissions. For more information, see
8716
- # [Specifying Permissions in a Policy][2] in the *Amazon S3 User
8838
+ # [Specifying Permissions in a Policy][3] in the *Amazon S3 User
8717
8839
  # Guide*. If the object that you request does not exist, the error
8718
8840
  # Amazon S3 returns depends on whether you also have the
8719
8841
  # `s3:ListBucket` permission.
@@ -8727,7 +8849,7 @@ module Aws::S3
8727
8849
  # error.
8728
8850
  # * **Directory bucket permissions** - To grant access to this API
8729
8851
  # operation on a directory bucket, we recommend that you use the [
8730
- # `CreateSession` ][3] API operation for session-based
8852
+ # `CreateSession` ][4] API operation for session-based
8731
8853
  # authorization. Specifically, you grant the
8732
8854
  # `s3express:CreateSession` permission to the directory bucket in a
8733
8855
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -8738,7 +8860,7 @@ module Aws::S3
8738
8860
  # token for use. Amazon Web Services CLI or SDKs create session and
8739
8861
  # refresh the session token automatically to avoid service
8740
8862
  # interruptions when a session expires. For more information about
8741
- # authorization, see [ `CreateSession` ][3].
8863
+ # authorization, see [ `CreateSession` ][4].
8742
8864
  #
8743
8865
  # If the object is encrypted with SSE-KMS, you must also have the
8744
8866
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -8774,7 +8896,7 @@ module Aws::S3
8774
8896
  # * `x-amz-server-side-encryption-customer-key-MD5`
8775
8897
  #
8776
8898
  # For more information about SSE-C, see [Server-Side Encryption (Using
8777
- # Customer-Provided Encryption Keys)][4] in the *Amazon S3 User
8899
+ # Customer-Provided Encryption Keys)][5] in the *Amazon S3 User
8778
8900
  # Guide*.
8779
8901
  #
8780
8902
  # <note markdown="1"> **Directory bucket permissions** - For directory buckets, there are
@@ -8786,10 +8908,10 @@ module Aws::S3
8786
8908
  # encryption in your `CreateSession` requests or `PUT` object
8787
8909
  # requests. Then, new objects are automatically encrypted with the
8788
8910
  # desired encryption settings. For more information, see [Protecting
8789
- # data with server-side encryption][5] in the *Amazon S3 User Guide*.
8911
+ # data with server-side encryption][6] in the *Amazon S3 User Guide*.
8790
8912
  # For more information about the encryption overriding behaviors in
8791
8913
  # directory buckets, see [Specifying server-side encryption with KMS
8792
- # for new object uploads][6].
8914
+ # for new object uploads][7].
8793
8915
  #
8794
8916
  # </note>
8795
8917
  #
@@ -8812,7 +8934,7 @@ module Aws::S3
8812
8934
  #
8813
8935
  # * `If-Unmodified-Since` condition evaluates to `false`.
8814
8936
  # For more information about conditional requests, see [RFC
8815
- # 7232][7].
8937
+ # 7232][8].
8816
8938
  #
8817
8939
  # * If both of the `If-None-Match` and `If-Modified-Since` headers are
8818
8940
  # present in the request as follows, then Amazon S3 returns the HTTP
@@ -8822,58 +8944,59 @@ module Aws::S3
8822
8944
  #
8823
8945
  # * `If-Modified-Since` condition evaluates to `true`.
8824
8946
  # For more information about conditional requests, see [RFC
8825
- # 7232][7].
8947
+ # 7232][8].
8826
8948
  #
8827
8949
  # HTTP Host header syntax
8828
8950
  #
8829
8951
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
8830
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
8952
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
8831
8953
  #
8832
8954
  # The following actions are related to `GetObjectAttributes`:
8833
8955
  #
8834
- # * [GetObject][8]
8956
+ # * [GetObject][9]
8835
8957
  #
8836
- # * [GetObjectAcl][9]
8958
+ # * [GetObjectAcl][10]
8837
8959
  #
8838
- # * [GetObjectLegalHold][10]
8960
+ # * [GetObjectLegalHold][11]
8839
8961
  #
8840
- # * [GetObjectLockConfiguration][11]
8962
+ # * [GetObjectLockConfiguration][12]
8841
8963
  #
8842
- # * [GetObjectRetention][12]
8964
+ # * [GetObjectRetention][13]
8843
8965
  #
8844
- # * [GetObjectTagging][13]
8966
+ # * [GetObjectTagging][14]
8845
8967
  #
8846
- # * [HeadObject][14]
8968
+ # * [HeadObject][15]
8847
8969
  #
8848
- # * [ListParts][15]
8970
+ # * [ListParts][16]
8849
8971
  #
8850
8972
  #
8851
8973
  #
8852
8974
  # [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
8975
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
8976
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8977
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
8978
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
8979
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
8980
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
8981
+ # [8]: https://tools.ietf.org/html/rfc7232
8982
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
8983
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
8984
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
8985
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
8986
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
8987
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
8988
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
8989
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
8867
8990
  #
8868
8991
  # @option params [required, String] :bucket
8869
8992
  # The name of the bucket that contains the object.
8870
8993
  #
8871
8994
  # **Directory buckets** - When you use this operation with a directory
8872
8995
  # 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, `
8996
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
8997
+ # requests are not supported. Directory bucket names must be unique in
8998
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
8999
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8877
9000
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8878
9001
  # naming restrictions, see [Directory bucket naming rules][1] in the
8879
9002
  # *Amazon S3 User Guide*.
@@ -9407,49 +9530,49 @@ module Aws::S3
9407
9530
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
9408
9531
  #
9409
9532
  #
9410
- # @example Example: To retrieve tag set of a specific object version
9533
+ # @example Example: To retrieve tag set of an object
9411
9534
  #
9412
- # # The following example retrieves tag set of an object. The request specifies object version.
9535
+ # # The following example retrieves tag set of an object.
9413
9536
  #
9414
9537
  # resp = client.get_object_tagging({
9415
9538
  # bucket: "examplebucket",
9416
- # key: "exampleobject",
9417
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9539
+ # key: "HappyFace.jpg",
9418
9540
  # })
9419
9541
  #
9420
9542
  # resp.to_h outputs the following:
9421
9543
  # {
9422
9544
  # tag_set: [
9423
9545
  # {
9424
- # key: "Key1",
9425
- # value: "Value1",
9546
+ # key: "Key4",
9547
+ # value: "Value4",
9548
+ # },
9549
+ # {
9550
+ # key: "Key3",
9551
+ # value: "Value3",
9426
9552
  # },
9427
9553
  # ],
9428
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9554
+ # version_id: "null",
9429
9555
  # }
9430
9556
  #
9431
- # @example Example: To retrieve tag set of an object
9557
+ # @example Example: To retrieve tag set of a specific object version
9432
9558
  #
9433
- # # The following example retrieves tag set of an object.
9559
+ # # The following example retrieves tag set of an object. The request specifies object version.
9434
9560
  #
9435
9561
  # resp = client.get_object_tagging({
9436
9562
  # bucket: "examplebucket",
9437
- # key: "HappyFace.jpg",
9563
+ # key: "exampleobject",
9564
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9438
9565
  # })
9439
9566
  #
9440
9567
  # resp.to_h outputs the following:
9441
9568
  # {
9442
9569
  # tag_set: [
9443
9570
  # {
9444
- # key: "Key4",
9445
- # value: "Value4",
9446
- # },
9447
- # {
9448
- # key: "Key3",
9449
- # value: "Value3",
9571
+ # key: "Key1",
9572
+ # value: "Value1",
9450
9573
  # },
9451
9574
  # ],
9452
- # version_id: "null",
9575
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9453
9576
  # }
9454
9577
  #
9455
9578
  # @example Request syntax with placeholder values
@@ -9710,13 +9833,17 @@ module Aws::S3
9710
9833
  # HTTP Host header syntax
9711
9834
  #
9712
9835
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
9713
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
9836
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9714
9837
  #
9715
9838
  # <note markdown="1"> You must make requests for this API operation to the Zonal endpoint.
9716
9839
  # 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*.
9840
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9841
+ # Path-style requests are not supported. For more information about
9842
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
9843
+ # for directory buckets in Availability Zones][5] in the *Amazon S3
9844
+ # User Guide*. For more information about endpoints in Local Zones,
9845
+ # see [Available Local Zone for directory buckets][6] in the *Amazon
9846
+ # S3 User Guide*.
9720
9847
  #
9721
9848
  # </note>
9722
9849
  #
@@ -9727,16 +9854,17 @@ module Aws::S3
9727
9854
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
9728
9855
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
9729
9856
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
9857
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
9730
9858
  #
9731
9859
  # @option params [required, String] :bucket
9732
9860
  # The bucket name.
9733
9861
  #
9734
9862
  # **Directory buckets** - When you use this operation with a directory
9735
9863
  # 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, `
9864
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
9865
+ # requests are not supported. Directory bucket names must be unique in
9866
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
9867
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
9740
9868
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9741
9869
  # naming restrictions, see [Directory bucket naming rules][1] in the
9742
9870
  # *Amazon S3 User Guide*.
@@ -9810,7 +9938,7 @@ module Aws::S3
9810
9938
  #
9811
9939
  # @example Response structure
9812
9940
  #
9813
- # resp.bucket_location_type #=> String, one of "AvailabilityZone"
9941
+ # resp.bucket_location_type #=> String, one of "AvailabilityZone", "LocalZone"
9814
9942
  # resp.bucket_location_name #=> String
9815
9943
  # resp.bucket_region #=> String
9816
9944
  # resp.access_point_alias #=> Boolean
@@ -9955,22 +10083,26 @@ module Aws::S3
9955
10083
  # HTTP Host header syntax
9956
10084
  #
9957
10085
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
9958
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
10086
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9959
10087
  #
9960
10088
  # <note markdown="1"> For directory buckets, you must make requests for this API operation
9961
10089
  # to the Zonal endpoint. These endpoints support virtual-hosted-style
9962
10090
  # 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*.
10091
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
10092
+ # `. Path-style requests are not supported. For more information about
10093
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
10094
+ # for directory buckets in Availability Zones][6] in the *Amazon S3
10095
+ # User Guide*. For more information about endpoints in Local Zones,
10096
+ # see [Available Local Zone for directory buckets][7] in the *Amazon
10097
+ # S3 User Guide*.
9966
10098
  #
9967
10099
  # </note>
9968
10100
  #
9969
10101
  # The following actions are related to `HeadObject`:
9970
10102
  #
9971
- # * [GetObject][7]
10103
+ # * [GetObject][8]
9972
10104
  #
9973
- # * [GetObjectAttributes][8]
10105
+ # * [GetObjectAttributes][9]
9974
10106
  #
9975
10107
  #
9976
10108
  #
@@ -9980,18 +10112,19 @@ module Aws::S3
9980
10112
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
9981
10113
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
9982
10114
  # [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
10115
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
10116
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
10117
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
9985
10118
  #
9986
10119
  # @option params [required, String] :bucket
9987
10120
  # The name of the bucket that contains the object.
9988
10121
  #
9989
10122
  # **Directory buckets** - When you use this operation with a directory
9990
10123
  # 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, `
10124
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
10125
+ # requests are not supported. Directory bucket names must be unique in
10126
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10127
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
9995
10128
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9996
10129
  # naming restrictions, see [Directory bucket naming rules][1] in the
9997
10130
  # *Amazon S3 User Guide*.
@@ -10895,9 +11028,13 @@ module Aws::S3
10895
11028
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
10896
11029
  # requests for this API operation to the Regional endpoint. These
10897
11030
  # 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*.
11031
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
11032
+ # Virtual-hosted-style requests aren't supported. For more information
11033
+ # about endpoints in Availability Zones, see [Regional and Zonal
11034
+ # endpoints for directory buckets in Availability Zones][2] in the
11035
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
11036
+ # Zones, see [Available Local Zone for directory buckets][3] in the
11037
+ # *Amazon S3 User Guide*.
10901
11038
  #
10902
11039
  # </note>
10903
11040
  #
@@ -10909,7 +11046,7 @@ module Aws::S3
10909
11046
  # operation can only be performed by the Amazon Web Services account
10910
11047
  # that owns the resource. For more information about directory bucket
10911
11048
  # policies and permissions, see [Amazon Web Services Identity and
10912
- # Access Management (IAM) for S3 Express One Zone][3] in the *Amazon
11049
+ # Access Management (IAM) for S3 Express One Zone][4] in the *Amazon
10913
11050
  # S3 User Guide*.
10914
11051
  #
10915
11052
  # HTTP Host header syntax
@@ -10926,7 +11063,8 @@ module Aws::S3
10926
11063
  #
10927
11064
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
10928
11065
  # [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
11066
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
11067
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
10930
11068
  #
10931
11069
  # @option params [String] :continuation_token
10932
11070
  # `ContinuationToken` indicates to Amazon S3 that the list is being
@@ -11014,21 +11152,25 @@ module Aws::S3
11014
11152
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
11015
11153
  # for this API operation to the Zonal endpoint. These endpoints support
11016
11154
  # 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*.
11155
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
11156
+ # `. Path-style requests are not supported. For more information about
11157
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
11158
+ # directory buckets in Availability Zones][2] in the *Amazon S3 User
11159
+ # Guide*. For more information about endpoints in Local Zones, see
11160
+ # [Available Local Zone for directory buckets][3] in the *Amazon S3 User
11161
+ # Guide*.
11020
11162
  #
11021
11163
  # </note>
11022
11164
  #
11023
11165
  # Permissions
11024
11166
  # : * **General purpose bucket permissions** - For information about
11025
11167
  # permissions required to use the multipart upload API, see
11026
- # [Multipart Upload and Permissions][3] in the *Amazon S3 User
11168
+ # [Multipart Upload and Permissions][4] in the *Amazon S3 User
11027
11169
  # Guide*.
11028
11170
  #
11029
11171
  # * **Directory bucket permissions** - To grant access to this API
11030
11172
  # operation on a directory bucket, we recommend that you use the [
11031
- # `CreateSession` ][4] API operation for session-based
11173
+ # `CreateSession` ][5] API operation for session-based
11032
11174
  # authorization. Specifically, you grant the
11033
11175
  # `s3express:CreateSession` permission to the directory bucket in a
11034
11176
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -11039,7 +11181,7 @@ module Aws::S3
11039
11181
  # token for use. Amazon Web Services CLI or SDKs create session and
11040
11182
  # refresh the session token automatically to avoid service
11041
11183
  # interruptions when a session expires. For more information about
11042
- # authorization, see [ `CreateSession` ][4].
11184
+ # authorization, see [ `CreateSession` ][5].
11043
11185
  #
11044
11186
  # Sorting of multipart uploads in response
11045
11187
  # : * **General purpose bucket** - In the `ListMultipartUploads`
@@ -11060,41 +11202,42 @@ module Aws::S3
11060
11202
  # HTTP Host header syntax
11061
11203
  #
11062
11204
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
11063
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
11205
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
11064
11206
  #
11065
11207
  # The following operations are related to `ListMultipartUploads`:
11066
11208
  #
11067
- # * [CreateMultipartUpload][5]
11209
+ # * [CreateMultipartUpload][6]
11068
11210
  #
11069
- # * [UploadPart][6]
11211
+ # * [UploadPart][7]
11070
11212
  #
11071
- # * [CompleteMultipartUpload][7]
11213
+ # * [CompleteMultipartUpload][8]
11072
11214
  #
11073
- # * [ListParts][8]
11215
+ # * [ListParts][9]
11074
11216
  #
11075
- # * [AbortMultipartUpload][9]
11217
+ # * [AbortMultipartUpload][10]
11076
11218
  #
11077
11219
  #
11078
11220
  #
11079
11221
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
11080
11222
  # [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
11223
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
11224
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11225
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
11226
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
11227
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
11228
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
11229
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
11230
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
11088
11231
  #
11089
11232
  # @option params [required, String] :bucket
11090
11233
  # The name of the bucket to which the multipart upload was initiated.
11091
11234
  #
11092
11235
  # **Directory buckets** - When you use this operation with a directory
11093
11236
  # 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, `
11237
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
11238
+ # requests are not supported. Directory bucket names must be unique in
11239
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11240
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11098
11241
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11099
11242
  # naming restrictions, see [Directory bucket naming rules][1] in the
11100
11243
  # *Amazon S3 User Guide*.
@@ -11687,10 +11830,10 @@ module Aws::S3
11687
11830
  #
11688
11831
  # **Directory buckets** - When you use this operation with a directory
11689
11832
  # 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, `
11833
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
11834
+ # requests are not supported. Directory bucket names must be unique in
11835
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11836
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11694
11837
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11695
11838
  # naming restrictions, see [Directory bucket naming rules][1] in the
11696
11839
  # *Amazon S3 User Guide*.
@@ -11902,9 +12045,13 @@ module Aws::S3
11902
12045
  # * **Directory buckets** - For directory buckets, you must make
11903
12046
  # requests for this API operation to the Zonal endpoint. These
11904
12047
  # 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*.
12048
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
12049
+ # `. Path-style requests are not supported. For more information about
12050
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
12051
+ # for directory buckets in Availability Zones][3] in the *Amazon S3
12052
+ # User Guide*. For more information about endpoints in Local Zones,
12053
+ # see [Available Local Zone for directory buckets][4] in the *Amazon
12054
+ # S3 User Guide*.
11908
12055
  #
11909
12056
  # </note>
11910
12057
  #
@@ -11914,12 +12061,12 @@ module Aws::S3
11914
12061
  # to perform the `s3:ListBucket` action. The bucket owner has this
11915
12062
  # permission by default and can grant this permission to others. For
11916
12063
  # 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*.
12064
+ # Bucket Subresource Operations][5] and [Managing Access Permissions
12065
+ # to Your Amazon S3 Resources][6] in the *Amazon S3 User Guide*.
11919
12066
  #
11920
12067
  # * **Directory bucket permissions** - To grant access to this API
11921
12068
  # operation on a directory bucket, we recommend that you use the [
11922
- # `CreateSession` ][6] API operation for session-based
12069
+ # `CreateSession` ][7] API operation for session-based
11923
12070
  # authorization. Specifically, you grant the
11924
12071
  # `s3express:CreateSession` permission to the directory bucket in a
11925
12072
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -11930,7 +12077,7 @@ module Aws::S3
11930
12077
  # token for use. Amazon Web Services CLI or SDKs create session and
11931
12078
  # refresh the session token automatically to avoid service
11932
12079
  # interruptions when a session expires. For more information about
11933
- # authorization, see [ `CreateSession` ][6].
12080
+ # authorization, see [ `CreateSession` ][7].
11934
12081
  #
11935
12082
  # Sorting order of returned objects
11936
12083
  # : * **General purpose bucket** - For general purpose buckets,
@@ -11943,41 +12090,42 @@ module Aws::S3
11943
12090
  # HTTP Host header syntax
11944
12091
  #
11945
12092
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
11946
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
12093
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
11947
12094
  #
11948
12095
  # This section describes the latest revision of this action. We
11949
12096
  # recommend that you use this revised API operation for application
11950
12097
  # development. For backward compatibility, Amazon S3 continues to
11951
- # support the prior version of this API operation, [ListObjects][7].
12098
+ # support the prior version of this API operation, [ListObjects][8].
11952
12099
  #
11953
12100
  # The following operations are related to `ListObjectsV2`:
11954
12101
  #
11955
- # * [GetObject][8]
12102
+ # * [GetObject][9]
11956
12103
  #
11957
- # * [PutObject][9]
12104
+ # * [PutObject][10]
11958
12105
  #
11959
- # * [CreateBucket][10]
12106
+ # * [CreateBucket][11]
11960
12107
  #
11961
12108
  #
11962
12109
  #
11963
12110
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
11964
12111
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
11965
12112
  # [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
12113
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
12114
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12115
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
12116
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
12117
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
12118
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
12119
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
12120
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
11973
12121
  #
11974
12122
  # @option params [required, String] :bucket
11975
12123
  # **Directory buckets** - When you use this operation with a directory
11976
12124
  # 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, `
12125
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
12126
+ # requests are not supported. Directory bucket names must be unique in
12127
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12128
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11981
12129
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11982
12130
  # naming restrictions, see [Directory bucket naming rules][1] in the
11983
12131
  # *Amazon S3 User Guide*.
@@ -12245,16 +12393,20 @@ module Aws::S3
12245
12393
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
12246
12394
  # for this API operation to the Zonal endpoint. These endpoints support
12247
12395
  # 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*.
12396
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
12397
+ # `. Path-style requests are not supported. For more information about
12398
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
12399
+ # directory buckets in Availability Zones][3] in the *Amazon S3 User
12400
+ # Guide*. For more information about endpoints in Local Zones, see
12401
+ # [Available Local Zone for directory buckets][4] in the *Amazon S3 User
12402
+ # Guide*.
12251
12403
  #
12252
12404
  # </note>
12253
12405
  #
12254
12406
  # Permissions
12255
12407
  # : * **General purpose bucket permissions** - For information about
12256
12408
  # permissions required to use the multipart upload API, see
12257
- # [Multipart Upload and Permissions][4] in the *Amazon S3 User
12409
+ # [Multipart Upload and Permissions][5] in the *Amazon S3 User
12258
12410
  # Guide*.
12259
12411
  #
12260
12412
  # If the upload was created using server-side encryption with Key
@@ -12265,7 +12417,7 @@ module Aws::S3
12265
12417
  #
12266
12418
  # * **Directory bucket permissions** - To grant access to this API
12267
12419
  # operation on a directory bucket, we recommend that you use the [
12268
- # `CreateSession` ][5] API operation for session-based
12420
+ # `CreateSession` ][6] API operation for session-based
12269
12421
  # authorization. Specifically, you grant the
12270
12422
  # `s3express:CreateSession` permission to the directory bucket in a
12271
12423
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -12276,49 +12428,50 @@ module Aws::S3
12276
12428
  # token for use. Amazon Web Services CLI or SDKs create session and
12277
12429
  # refresh the session token automatically to avoid service
12278
12430
  # interruptions when a session expires. For more information about
12279
- # authorization, see [ `CreateSession` ][5].
12431
+ # authorization, see [ `CreateSession` ][6].
12280
12432
  #
12281
12433
  # HTTP Host header syntax
12282
12434
  #
12283
12435
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
12284
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
12436
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
12285
12437
  #
12286
12438
  # The following operations are related to `ListParts`:
12287
12439
  #
12288
12440
  # * [CreateMultipartUpload][1]
12289
12441
  #
12290
- # * [UploadPart][6]
12442
+ # * [UploadPart][7]
12291
12443
  #
12292
- # * [CompleteMultipartUpload][7]
12444
+ # * [CompleteMultipartUpload][8]
12293
12445
  #
12294
- # * [AbortMultipartUpload][8]
12446
+ # * [AbortMultipartUpload][9]
12295
12447
  #
12296
- # * [GetObjectAttributes][9]
12448
+ # * [GetObjectAttributes][10]
12297
12449
  #
12298
- # * [ListMultipartUploads][10]
12450
+ # * [ListMultipartUploads][11]
12299
12451
  #
12300
12452
  #
12301
12453
  #
12302
12454
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
12303
12455
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
12304
12456
  # [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
12457
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
12458
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
12459
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
12460
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
12461
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
12462
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
12463
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
12464
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
12312
12465
  #
12313
12466
  # @option params [required, String] :bucket
12314
12467
  # The name of the bucket to which the parts are being uploaded.
12315
12468
  #
12316
12469
  # **Directory buckets** - When you use this operation with a directory
12317
12470
  # 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, `
12471
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
12472
+ # requests are not supported. Directory bucket names must be unique in
12473
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12474
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
12322
12475
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12323
12476
  # naming restrictions, see [Directory bucket naming rules][1] in the
12324
12477
  # *Amazon S3 User Guide*.
@@ -13255,9 +13408,13 @@ module Aws::S3
13255
13408
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
13256
13409
  # requests for this API operation to the Regional endpoint. These
13257
13410
  # 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*.
13411
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
13412
+ # Virtual-hosted-style requests aren't supported. For more information
13413
+ # about endpoints in Availability Zones, see [Regional and Zonal
13414
+ # endpoints for directory buckets in Availability Zones][1] in the
13415
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
13416
+ # Zones, see [Available Local Zone for directory buckets][2] in the
13417
+ # *Amazon S3 User Guide*.
13261
13418
  #
13262
13419
  # </note>
13263
13420
  #
@@ -13271,12 +13428,12 @@ module Aws::S3
13271
13428
  # keys (SSE-KMS) or dual-layer server-side encryption with Amazon
13272
13429
  # Web Services KMS keys (DSSE-KMS). If you specify default
13273
13430
  # 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]
13431
+ # Bucket Keys][3]. For information about the bucket default
13432
+ # encryption feature, see [Amazon S3 Bucket Default Encryption][4]
13276
13433
  # in the *Amazon S3 User Guide*.
13277
13434
  #
13278
13435
  # * If you use PutBucketEncryption to set your [default bucket
13279
- # encryption][3] to SSE-KMS, you should verify that your KMS key ID
13436
+ # encryption][4] to SSE-KMS, you should verify that your KMS key ID
13280
13437
  # is correct. Amazon S3 doesn't validate the KMS key ID provided in
13281
13438
  # PutBucketEncryption requests.
13282
13439
  # * <b>Directory buckets </b> - You can optionally configure default
@@ -13290,28 +13447,28 @@ module Aws::S3
13290
13447
  # encrypted with the desired encryption settings. For more
13291
13448
  # information about the encryption overriding behaviors in directory
13292
13449
  # buckets, see [Specifying server-side encryption with KMS for new
13293
- # object uploads][4].
13450
+ # object uploads][5].
13294
13451
  #
13295
13452
  # * 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.
13453
+ # key][6] per directory bucket for the lifetime of the bucket. The
13454
+ # [Amazon Web Services managed key][7] (`aws/s3`) isn't supported.
13298
13455
  #
13299
13456
  # * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
13300
13457
  # in a directory bucket and can’t be disabled. S3 Bucket Keys
13301
13458
  # aren't supported, when you copy SSE-KMS encrypted objects from
13302
13459
  # general purpose buckets to directory buckets, from directory
13303
13460
  # 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,
13461
+ # through [CopyObject][8], [UploadPartCopy][9], [the Copy operation
13462
+ # in Batch Operations][10], or [the import jobs][11]. In this case,
13306
13463
  # Amazon S3 makes a call to KMS every time a copy request is made
13307
13464
  # for a KMS-encrypted object.
13308
13465
  #
13309
- # * When you specify an [KMS customer managed key][5] for encryption
13466
+ # * When you specify an [KMS customer managed key][6] for encryption
13310
13467
  # in your directory bucket, only use the key ID or key ARN. The key
13311
13468
  # alias format of the KMS key isn't supported.
13312
13469
  #
13313
13470
  # * For directory buckets, if you use PutBucketEncryption to set your
13314
- # [default bucket encryption][3] to SSE-KMS, Amazon S3 validates the
13471
+ # [default bucket encryption][4] to SSE-KMS, Amazon S3 validates the
13315
13472
  # KMS key ID provided in PutBucketEncryption requests.
13316
13473
  #
13317
13474
  # </note>
@@ -13324,7 +13481,7 @@ module Aws::S3
13324
13481
  #
13325
13482
  # Also, this action requires Amazon Web Services Signature Version 4.
13326
13483
  # For more information, see [ Authenticating Requests (Amazon Web
13327
- # Services Signature Version 4)][11].
13484
+ # Services Signature Version 4)][12].
13328
13485
  #
13329
13486
  # Permissions
13330
13487
  # : * **General purpose bucket permissions** - The
@@ -13332,8 +13489,8 @@ module Aws::S3
13332
13489
  # policy. The bucket owner has this permission by default. The
13333
13490
  # bucket owner can grant this permission to others. For more
13334
13491
  # 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*.
13492
+ # Operations][13] and [Managing Access Permissions to Your Amazon S3
13493
+ # Resources][14] in the *Amazon S3 User Guide*.
13337
13494
  #
13338
13495
  # * **Directory bucket permissions** - To grant access to this API
13339
13496
  # operation, you must have the
@@ -13343,7 +13500,7 @@ module Aws::S3
13343
13500
  # only be performed by the Amazon Web Services account that owns the
13344
13501
  # resource. For more information about directory bucket policies and
13345
13502
  # permissions, see [Amazon Web Services Identity and Access
13346
- # Management (IAM) for S3 Express One Zone][14] in the *Amazon S3
13503
+ # Management (IAM) for S3 Express One Zone][15] in the *Amazon S3
13347
13504
  # User Guide*.
13348
13505
  #
13349
13506
  # To set a directory bucket default encryption with SSE-KMS, you
@@ -13354,32 +13511,33 @@ module Aws::S3
13354
13511
  # HTTP Host header syntax
13355
13512
  #
13356
13513
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
13357
- # `s3express-control.region.amazonaws.com`.
13514
+ # `s3express-control.region-code.amazonaws.com`.
13358
13515
  #
13359
13516
  # The following operations are related to `PutBucketEncryption`:
13360
13517
  #
13361
- # * [GetBucketEncryption][15]
13518
+ # * [GetBucketEncryption][16]
13362
13519
  #
13363
- # * [DeleteBucketEncryption][16]
13520
+ # * [DeleteBucketEncryption][17]
13364
13521
  #
13365
13522
  #
13366
13523
  #
13367
13524
  # [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
13525
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
13526
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
13527
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
13528
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
13529
+ # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
13530
+ # [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
13531
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
13532
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
13533
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
13534
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
13535
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
13536
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
13537
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
13538
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
13539
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
13540
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
13383
13541
  #
13384
13542
  # @option params [required, String] :bucket
13385
13543
  # Specifies default encryption for a bucket using server-side encryption
@@ -13387,13 +13545,14 @@ module Aws::S3
13387
13545
  #
13388
13546
  # <b>Directory buckets </b> - When you use this operation with a
13389
13547
  # directory bucket, you must use path-style requests in the format
13390
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
13548
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
13391
13549
  # 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*
13550
+ # names must be unique in the chosen Zone (Availability Zone or Local
13551
+ # Zone). Bucket names must also follow the format `
13552
+ # bucket-base-name--zone-id--x-s3` (for example, `
13553
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
13554
+ # naming restrictions, see [Directory bucket naming rules][1] in the
13555
+ # *Amazon S3 User Guide*
13397
13556
  #
13398
13557
  #
13399
13558
  #
@@ -13912,6 +14071,16 @@ module Aws::S3
13912
14071
  # lifecycle configuration. For information about lifecycle
13913
14072
  # configuration, see [Managing your storage lifecycle][1].
13914
14073
  #
14074
+ # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
14075
+ # rule using an object key name prefix, one or more object tags, object
14076
+ # size, or any combination of these. Accordingly, this section describes
14077
+ # the latest API. The previous version of the API supported filtering
14078
+ # based only on an object key name prefix, which is supported for
14079
+ # backward compatibility. For the related API description, see
14080
+ # [PutBucketLifecycle][2].
14081
+ #
14082
+ # </note>
14083
+ #
13915
14084
  # Rules
13916
14085
  # Permissions
13917
14086
  # HTTP Host header syntax
@@ -13992,10 +14161,13 @@ module Aws::S3
13992
14161
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
13993
14162
  # requests for this API operation to the Regional endpoint. These
13994
14163
  # endpoints support path-style requests in the format
13995
- # `https://s3express-control.region_code.amazonaws.com/bucket-name
14164
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
13996
14165
  # `. Virtual-hosted-style requests aren't supported. For more
13997
- # information, see [Regional and Zonal endpoints][7] in the *Amazon
13998
- # S3 User Guide*.
14166
+ # information about endpoints in Availability Zones, see [Regional
14167
+ # and Zonal endpoints for directory buckets in Availability
14168
+ # Zones][7] in the *Amazon S3 User Guide*. For more information
14169
+ # about endpoints in Local Zones, see [Available Local Zone for
14170
+ # directory buckets][8] in the *Amazon S3 User Guide*.
13999
14171
  #
14000
14172
  # </note>
14001
14173
  #
@@ -14005,9 +14177,9 @@ module Aws::S3
14005
14177
  # The following operations are related to
14006
14178
  # `PutBucketLifecycleConfiguration`:
14007
14179
  #
14008
- # * [GetBucketLifecycleConfiguration][8]
14180
+ # * [GetBucketLifecycleConfiguration][9]
14009
14181
  #
14010
- # * [DeleteBucketLifecycle][9]
14182
+ # * [DeleteBucketLifecycle][10]
14011
14183
  #
14012
14184
  #
14013
14185
  #
@@ -14018,8 +14190,9 @@ module Aws::S3
14018
14190
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
14019
14191
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14020
14192
  # [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
14193
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
14194
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
14195
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
14023
14196
  #
14024
14197
  # @option params [required, String] :bucket
14025
14198
  # The name of the bucket for which to set the configuration.
@@ -14816,9 +14989,13 @@ module Aws::S3
14816
14989
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
14817
14990
  # requests for this API operation to the Regional endpoint. These
14818
14991
  # 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*.
14992
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
14993
+ # Virtual-hosted-style requests aren't supported. For more information
14994
+ # about endpoints in Availability Zones, see [Regional and Zonal
14995
+ # endpoints for directory buckets in Availability Zones][1] in the
14996
+ # *Amazon S3 User Guide*. For more information about endpoints in Local
14997
+ # Zones, see [Available Local Zone for directory buckets][2] in the
14998
+ # *Amazon S3 User Guide*.
14822
14999
  #
14823
15000
  # </note>
14824
15001
  #
@@ -14848,7 +15025,7 @@ module Aws::S3
14848
15025
  # * **General purpose bucket permissions** - The `s3:PutBucketPolicy`
14849
15026
  # permission is required in a policy. For more information about
14850
15027
  # general purpose buckets bucket policies, see [Using Bucket
14851
- # Policies and User Policies][2] in the *Amazon S3 User Guide*.
15028
+ # Policies and User Policies][3] in the *Amazon S3 User Guide*.
14852
15029
  #
14853
15030
  # * **Directory bucket permissions** - To grant access to this API
14854
15031
  # operation, you must have the `s3express:PutBucketPolicy`
@@ -14858,49 +15035,51 @@ module Aws::S3
14858
15035
  # Services account that owns the resource. For more information
14859
15036
  # about directory bucket policies and permissions, see [Amazon Web
14860
15037
  # Services Identity and Access Management (IAM) for S3 Express One
14861
- # Zone][3] in the *Amazon S3 User Guide*.
15038
+ # Zone][4] in the *Amazon S3 User Guide*.
14862
15039
  #
14863
15040
  # Example bucket policies
14864
15041
  #
14865
15042
  # : **General purpose buckets example bucket policies** - See [Bucket
14866
- # policy examples][4] in the *Amazon S3 User Guide*.
15043
+ # policy examples][5] in the *Amazon S3 User Guide*.
14867
15044
  #
14868
15045
  # **Directory bucket example bucket policies** - See [Example bucket
14869
- # policies for S3 Express One Zone][5] in the *Amazon S3 User Guide*.
15046
+ # policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
14870
15047
  #
14871
15048
  # HTTP Host header syntax
14872
15049
  #
14873
15050
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
14874
- # `s3express-control.region.amazonaws.com`.
15051
+ # `s3express-control.region-code.amazonaws.com`.
14875
15052
  #
14876
15053
  # The following operations are related to `PutBucketPolicy`:
14877
15054
  #
14878
- # * [CreateBucket][6]
15055
+ # * [CreateBucket][7]
14879
15056
  #
14880
- # * [DeleteBucket][7]
15057
+ # * [DeleteBucket][8]
14881
15058
  #
14882
15059
  #
14883
15060
  #
14884
15061
  # [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
15062
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
15063
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
15064
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
15065
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
15066
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
15067
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
15068
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
14891
15069
  #
14892
15070
  # @option params [required, String] :bucket
14893
15071
  # The name of the bucket.
14894
15072
  #
14895
15073
  # <b>Directory buckets </b> - When you use this operation with a
14896
15074
  # directory bucket, you must use path-style requests in the format
14897
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
15075
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
14898
15076
  # 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*
15077
+ # names must be unique in the chosen Zone (Availability Zone or Local
15078
+ # Zone). Bucket names must also follow the format `
15079
+ # bucket-base-name--zone-id--x-s3` (for example, `
15080
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15081
+ # naming restrictions, see [Directory bucket naming rules][1] in the
15082
+ # *Amazon S3 User Guide*
14904
15083
  #
14905
15084
  #
14906
15085
  #
@@ -15838,9 +16017,13 @@ module Aws::S3
15838
16017
  # * **Directory buckets** - For directory buckets, you must make
15839
16018
  # requests for this API operation to the Zonal endpoint. These
15840
16019
  # 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*.
16020
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
16021
+ # `. Path-style requests are not supported. For more information about
16022
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
16023
+ # for directory buckets in Availability Zones][1] in the *Amazon S3
16024
+ # User Guide*. For more information about endpoints in Local Zones,
16025
+ # see [Available Local Zone for directory buckets][2] in the *Amazon
16026
+ # S3 User Guide*.
15844
16027
  #
15845
16028
  # </note>
15846
16029
  #
@@ -15850,7 +16033,7 @@ module Aws::S3
15850
16033
  # modify this behavior:
15851
16034
  #
15852
16035
  # * **S3 Object Lock** - To prevent objects from being deleted or
15853
- # overwritten, you can use [Amazon S3 Object Lock][2] in the *Amazon
16036
+ # overwritten, you can use [Amazon S3 Object Lock][3] in the *Amazon
15854
16037
  # S3 User Guide*.
15855
16038
  #
15856
16039
  # <note markdown="1"> This functionality is not supported for directory buckets.
@@ -15864,9 +16047,9 @@ module Aws::S3
15864
16047
  # automatically generates a unique version ID of that object being
15865
16048
  # stored in Amazon S3. You can retrieve, replace, or delete any
15866
16049
  # version of the object. For more information about versioning, see
15867
- # [Adding Objects to Versioning-Enabled Buckets][3] in the *Amazon S3
16050
+ # [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
15868
16051
  # User Guide*. For information about returning the versioning state of
15869
- # a bucket, see [GetBucketVersioning][4].
16052
+ # a bucket, see [GetBucketVersioning][5].
15870
16053
  #
15871
16054
  # <note markdown="1"> This functionality is not supported for directory buckets.
15872
16055
  #
@@ -15890,7 +16073,7 @@ module Aws::S3
15890
16073
  # `s3:PutObjectTagging`.
15891
16074
  # * **Directory bucket permissions** - To grant access to this API
15892
16075
  # operation on a directory bucket, we recommend that you use the [
15893
- # `CreateSession` ][5] API operation for session-based
16076
+ # `CreateSession` ][6] API operation for session-based
15894
16077
  # authorization. Specifically, you grant the
15895
16078
  # `s3express:CreateSession` permission to the directory bucket in a
15896
16079
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -15901,7 +16084,7 @@ module Aws::S3
15901
16084
  # token for use. Amazon Web Services CLI or SDKs create session and
15902
16085
  # refresh the session token automatically to avoid service
15903
16086
  # interruptions when a session expires. For more information about
15904
- # authorization, see [ `CreateSession` ][5].
16087
+ # authorization, see [ `CreateSession` ][6].
15905
16088
  #
15906
16089
  # If the object is encrypted with SSE-KMS, you must also have the
15907
16090
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -15922,23 +16105,24 @@ module Aws::S3
15922
16105
  # HTTP Host header syntax
15923
16106
  #
15924
16107
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
15925
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
16108
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
15926
16109
  #
15927
16110
  # For more information about related Amazon S3 APIs, see the following:
15928
16111
  #
15929
- # * [CopyObject][6]
16112
+ # * [CopyObject][7]
15930
16113
  #
15931
- # * [DeleteObject][7]
16114
+ # * [DeleteObject][8]
15932
16115
  #
15933
16116
  #
15934
16117
  #
15935
16118
  # [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
16119
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
16120
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
16121
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
16122
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
16123
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
16124
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
16125
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
15942
16126
  #
15943
16127
  # @option params [String] :acl
15944
16128
  # The canned ACL to apply to the object. For more information, see
@@ -15986,10 +16170,10 @@ module Aws::S3
15986
16170
  #
15987
16171
  # **Directory buckets** - When you use this operation with a directory
15988
16172
  # 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, `
16173
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
16174
+ # requests are not supported. Directory bucket names must be unique in
16175
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
16176
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
15993
16177
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15994
16178
  # naming restrictions, see [Directory bucket naming rules][1] in the
15995
16179
  # *Amazon S3 User Guide*.
@@ -16593,41 +16777,25 @@ module Aws::S3
16593
16777
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
16594
16778
  #
16595
16779
  #
16596
- # @example Example: To upload an object and specify server-side encryption and object tags
16780
+ # @example Example: To upload object and specify user-defined metadata
16597
16781
  #
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.
16782
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
16783
+ # # enabled, S3 returns version ID in response.
16600
16784
  #
16601
16785
  # resp = client.put_object({
16602
16786
  # body: "filetoupload",
16603
16787
  # bucket: "examplebucket",
16604
16788
  # 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
16617
- #
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.
16620
- #
16621
- # resp = client.put_object({
16622
- # body: "HappyFace.jpg",
16623
- # bucket: "examplebucket",
16624
- # key: "HappyFace.jpg",
16789
+ # metadata: {
16790
+ # "metadata1" => "value1",
16791
+ # "metadata2" => "value2",
16792
+ # },
16625
16793
  # })
16626
16794
  #
16627
16795
  # resp.to_h outputs the following:
16628
16796
  # {
16629
16797
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16630
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16798
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16631
16799
  # }
16632
16800
  #
16633
16801
  # @example Example: To upload an object and specify optional tags
@@ -16648,25 +16816,24 @@ module Aws::S3
16648
16816
  # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
16649
16817
  # }
16650
16818
  #
16651
- # @example Example: To upload object and specify user-defined metadata
16819
+ # @example Example: To upload an object (specify optional headers)
16652
16820
  #
16653
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
16654
- # # enabled, S3 returns version ID in response.
16821
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
16822
+ # # storage class and use server-side encryption.
16655
16823
  #
16656
16824
  # resp = client.put_object({
16657
- # body: "filetoupload",
16825
+ # body: "HappyFace.jpg",
16658
16826
  # bucket: "examplebucket",
16659
- # key: "exampleobject",
16660
- # metadata: {
16661
- # "metadata1" => "value1",
16662
- # "metadata2" => "value2",
16663
- # },
16827
+ # key: "HappyFace.jpg",
16828
+ # server_side_encryption: "AES256",
16829
+ # storage_class: "STANDARD_IA",
16664
16830
  # })
16665
16831
  #
16666
16832
  # resp.to_h outputs the following:
16667
16833
  # {
16668
16834
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16669
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16835
+ # server_side_encryption: "AES256",
16836
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16670
16837
  # }
16671
16838
  #
16672
16839
  # @example Example: To upload an object and specify canned ACL.
@@ -16687,24 +16854,41 @@ module Aws::S3
16687
16854
  # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
16688
16855
  # }
16689
16856
  #
16690
- # @example Example: To upload an object (specify optional headers)
16857
+ # @example Example: To upload an object
16691
16858
  #
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.
16859
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
16860
+ # # syntax. S3 returns VersionId of the newly created object.
16694
16861
  #
16695
16862
  # resp = client.put_object({
16696
16863
  # body: "HappyFace.jpg",
16697
16864
  # bucket: "examplebucket",
16698
16865
  # key: "HappyFace.jpg",
16866
+ # })
16867
+ #
16868
+ # resp.to_h outputs the following:
16869
+ # {
16870
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16871
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16872
+ # }
16873
+ #
16874
+ # @example Example: To upload an object and specify server-side encryption and object tags
16875
+ #
16876
+ # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
16877
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
16878
+ #
16879
+ # resp = client.put_object({
16880
+ # body: "filetoupload",
16881
+ # bucket: "examplebucket",
16882
+ # key: "exampleobject",
16699
16883
  # server_side_encryption: "AES256",
16700
- # storage_class: "STANDARD_IA",
16884
+ # tagging: "key1=value1&key2=value2",
16701
16885
  # })
16702
16886
  #
16703
16887
  # resp.to_h outputs the following:
16704
16888
  # {
16705
16889
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16706
16890
  # server_side_encryption: "AES256",
16707
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16891
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16708
16892
  # }
16709
16893
  #
16710
16894
  # @example Example: To create an object.
@@ -18684,9 +18868,13 @@ module Aws::S3
18684
18868
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
18685
18869
  # for this API operation to the Zonal endpoint. These endpoints support
18686
18870
  # 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*.
18871
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
18872
+ # `. Path-style requests are not supported. For more information about
18873
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
18874
+ # directory buckets in Availability Zones][5] in the *Amazon S3 User
18875
+ # Guide*. For more information about endpoints in Local Zones, see
18876
+ # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
18877
+ # Guide*.
18690
18878
  #
18691
18879
  # </note>
18692
18880
  #
@@ -18703,15 +18891,15 @@ module Aws::S3
18703
18891
  # These permissions are required because Amazon S3 must decrypt and
18704
18892
  # read data from the encrypted file parts before it completes the
18705
18893
  # multipart upload. For more information about KMS permissions, see
18706
- # [Protecting data using server-side encryption with KMS][6] in the
18894
+ # [Protecting data using server-side encryption with KMS][7] in the
18707
18895
  # *Amazon S3 User Guide*. For information about the permissions
18708
18896
  # required to use the multipart upload API, see [Multipart upload
18709
- # and permissions][7] and [Multipart upload API and permissions][8]
18897
+ # and permissions][8] and [Multipart upload API and permissions][9]
18710
18898
  # in the *Amazon S3 User Guide*.
18711
18899
  #
18712
18900
  # * **Directory bucket permissions** - To grant access to this API
18713
18901
  # operation on a directory bucket, we recommend that you use the [
18714
- # `CreateSession` ][9] API operation for session-based
18902
+ # `CreateSession` ][10] API operation for session-based
18715
18903
  # authorization. Specifically, you grant the
18716
18904
  # `s3express:CreateSession` permission to the directory bucket in a
18717
18905
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -18722,7 +18910,7 @@ module Aws::S3
18722
18910
  # token for use. Amazon Web Services CLI or SDKs create session and
18723
18911
  # refresh the session token automatically to avoid service
18724
18912
  # interruptions when a session expires. For more information about
18725
- # authorization, see [ `CreateSession` ][9].
18913
+ # authorization, see [ `CreateSession` ][10].
18726
18914
  #
18727
18915
  # If the object is encrypted with SSE-KMS, you must also have the
18728
18916
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -18738,7 +18926,7 @@ module Aws::S3
18738
18926
  # then Amazon Web Services S3 uses the `x-amz-content-sha256` header
18739
18927
  # as a checksum instead of `Content-MD5`. For more information see
18740
18928
  # [Authenticating Requests: Using the Authorization Header (Amazon Web
18741
- # Services Signature Version 4)][10].
18929
+ # Services Signature Version 4)][11].
18742
18930
  #
18743
18931
  # <note markdown="1"> **Directory buckets** - MD5 is not supported by directory buckets.
18744
18932
  # You can use checksum algorithms to check object integrity.
@@ -18778,7 +18966,7 @@ module Aws::S3
18778
18966
  # * x-amz-server-side-encryption-customer-key
18779
18967
  #
18780
18968
  # * x-amz-server-side-encryption-customer-key-MD5
18781
- # For more information, see [Using Server-Side Encryption][11] in
18969
+ # For more information, see [Using Server-Side Encryption][12] in
18782
18970
  # the *Amazon S3 User Guide*.
18783
18971
  #
18784
18972
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -18800,19 +18988,19 @@ module Aws::S3
18800
18988
  # HTTP Host header syntax
18801
18989
  #
18802
18990
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
18803
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
18991
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
18804
18992
  #
18805
18993
  # The following operations are related to `UploadPart`:
18806
18994
  #
18807
18995
  # * [CreateMultipartUpload][2]
18808
18996
  #
18809
- # * [CompleteMultipartUpload][12]
18997
+ # * [CompleteMultipartUpload][13]
18810
18998
  #
18811
- # * [AbortMultipartUpload][13]
18999
+ # * [AbortMultipartUpload][14]
18812
19000
  #
18813
- # * [ListParts][14]
19001
+ # * [ListParts][15]
18814
19002
  #
18815
- # * [ListMultipartUploads][15]
19003
+ # * [ListMultipartUploads][16]
18816
19004
  #
18817
19005
  #
18818
19006
  #
@@ -18821,16 +19009,17 @@ module Aws::S3
18821
19009
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
18822
19010
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
18823
19011
  # [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
19012
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
19013
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19014
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
19015
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
19016
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
19017
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
19018
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
19019
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
19020
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
19021
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
19022
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
18834
19023
  #
18835
19024
  # @option params [String, StringIO, File] :body
18836
19025
  # Object data.
@@ -18840,10 +19029,10 @@ module Aws::S3
18840
19029
  #
18841
19030
  # **Directory buckets** - When you use this operation with a directory
18842
19031
  # 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, `
19032
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
19033
+ # requests are not supported. Directory bucket names must be unique in
19034
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
19035
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
18847
19036
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18848
19037
  # naming restrictions, see [Directory bucket naming rules][1] in the
18849
19038
  # *Amazon S3 User Guide*.
@@ -19124,9 +19313,13 @@ module Aws::S3
19124
19313
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
19125
19314
  # for this API operation to the Zonal endpoint. These endpoints support
19126
19315
  # 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*.
19316
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
19317
+ # `. Path-style requests are not supported. For more information about
19318
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
19319
+ # directory buckets in Availability Zones][5] in the *Amazon S3 User
19320
+ # Guide*. For more information about endpoints in Local Zones, see
19321
+ # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
19322
+ # Guide*.
19130
19323
  #
19131
19324
  # </note>
19132
19325
  #
@@ -19136,7 +19329,7 @@ module Aws::S3
19136
19329
  # using IAM credentials (access key ID and secret access key for the
19137
19330
  # IAM identities). All headers with the `x-amz-` prefix, including
19138
19331
  # `x-amz-copy-source`, must be signed. For more information, see [REST
19139
- # Authentication][6].
19332
+ # Authentication][7].
19140
19333
  #
19141
19334
  # **Directory buckets** - You must use IAM credentials to authenticate
19142
19335
  # and authorize your access to the `UploadPartCopy` API operation,
@@ -19173,11 +19366,11 @@ module Aws::S3
19173
19366
  # permissions are required because Amazon S3 must decrypt and read
19174
19367
  # data from the encrypted file parts before it completes the
19175
19368
  # multipart upload. For more information about KMS permissions,
19176
- # see [Protecting data using server-side encryption with KMS][7]
19369
+ # see [Protecting data using server-side encryption with KMS][8]
19177
19370
  # in the *Amazon S3 User Guide*. For information about the
19178
19371
  # 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*.
19372
+ # [Multipart upload and permissions][9] and [Multipart upload API
19373
+ # and permissions][10] in the *Amazon S3 User Guide*.
19181
19374
  # * **Directory bucket permissions** - You must have permissions in a
19182
19375
  # bucket policy or an IAM identity-based policy based on the source
19183
19376
  # and destination bucket types in an `UploadPartCopy` operation.
@@ -19200,14 +19393,14 @@ module Aws::S3
19200
19393
  # identity-based policies and KMS key policies for the KMS key.
19201
19394
  #
19202
19395
  # For example policies, see [Example bucket policies for S3 Express
19203
- # One Zone][10] and [Amazon Web Services Identity and Access
19396
+ # One Zone][11] and [Amazon Web Services Identity and Access
19204
19397
  # Management (IAM) identity-based policies for S3 Express One
19205
- # Zone][11] in the *Amazon S3 User Guide*.
19398
+ # Zone][12] in the *Amazon S3 User Guide*.
19206
19399
  #
19207
19400
  # Encryption
19208
19401
  # : * <b>General purpose buckets </b> - For information about using
19209
19402
  # server-side encryption with customer-provided encryption keys with
19210
- # the `UploadPartCopy` operation, see [CopyObject][12] and
19403
+ # the `UploadPartCopy` operation, see [CopyObject][13] and
19211
19404
  # [UploadPart][2].
19212
19405
  #
19213
19406
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -19215,7 +19408,7 @@ module Aws::S3
19215
19408
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
19216
19409
  # server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
19217
19410
  # more information, see [Protecting data with server-side
19218
- # encryption][13] in the *Amazon S3 User Guide*.
19411
+ # encryption][14] in the *Amazon S3 User Guide*.
19219
19412
  #
19220
19413
  # <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
19221
19414
  # operation and an `UploadPartCopy` operation, the request headers
@@ -19227,7 +19420,7 @@ module Aws::S3
19227
19420
  # S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
19228
19421
  # objects from general purpose buckets to directory buckets, from
19229
19422
  # directory buckets to general purpose buckets, or between directory
19230
- # buckets, through [UploadPartCopy][14]. In this case, Amazon S3
19423
+ # buckets, through [UploadPartCopy][15]. In this case, Amazon S3
19231
19424
  # makes a call to KMS every time a copy request is made for a
19232
19425
  # KMS-encrypted object.
19233
19426
  #
@@ -19249,21 +19442,21 @@ module Aws::S3
19249
19442
  # HTTP Host header syntax
19250
19443
  #
19251
19444
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
19252
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
19445
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
19253
19446
  #
19254
19447
  # The following operations are related to `UploadPartCopy`:
19255
19448
  #
19256
- # * [CreateMultipartUpload][15]
19449
+ # * [CreateMultipartUpload][16]
19257
19450
  #
19258
19451
  # * [UploadPart][2]
19259
19452
  #
19260
- # * [CompleteMultipartUpload][16]
19453
+ # * [CompleteMultipartUpload][17]
19261
19454
  #
19262
- # * [AbortMultipartUpload][17]
19455
+ # * [AbortMultipartUpload][18]
19263
19456
  #
19264
- # * [ListParts][18]
19457
+ # * [ListParts][19]
19265
19458
  #
19266
- # * [ListMultipartUploads][19]
19459
+ # * [ListMultipartUploads][20]
19267
19460
  #
19268
19461
  #
19269
19462
  #
@@ -19272,34 +19465,43 @@ module Aws::S3
19272
19465
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
19273
19466
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
19274
19467
  # [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
19468
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
19469
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
19470
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19471
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
19472
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
19473
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
19474
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
19475
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
19476
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
19477
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
19478
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
19479
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
19480
+ # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
19481
+ # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
19482
+ # [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
19289
19483
  #
19290
19484
  # @option params [required, String] :bucket
19291
19485
  # The bucket name.
19292
19486
  #
19293
19487
  # **Directory buckets** - When you use this operation with a directory
19294
19488
  # 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, `
19489
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
19490
+ # requests are not supported. Directory bucket names must be unique in
19491
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
19492
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
19299
19493
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
19300
19494
  # naming restrictions, see [Directory bucket naming rules][1] in the
19301
19495
  # *Amazon S3 User Guide*.
19302
19496
  #
19497
+ # <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
19498
+ # supported when the source or destination bucket is in Amazon Web
19499
+ # Services Local Zones. The source and destination buckets must have the
19500
+ # same parent Amazon Web Services Region. Otherwise, you get an HTTP
19501
+ # `400 Bad Request` error with the error code `InvalidRequest`.
19502
+ #
19503
+ # </note>
19504
+ #
19303
19505
  # **Access points** - When you use this action with an access point, you
19304
19506
  # must provide the alias of the access point in place of the bucket name
19305
19507
  # or specify the access point ARN. When using the access point ARN, you
@@ -20071,7 +20273,7 @@ module Aws::S3
20071
20273
  tracer: tracer
20072
20274
  )
20073
20275
  context[:gem_name] = 'aws-sdk-s3'
20074
- context[:gem_version] = '1.174.0'
20276
+ context[:gem_version] = '1.175.0'
20075
20277
  Seahorse::Client::Request.new(handlers, context)
20076
20278
  end
20077
20279