aws-sdk-s3 1.174.0 → 1.175.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -577,20 +577,24 @@ module Aws::S3
577
577
  # * **Directory buckets** - For directory buckets, you must make
578
578
  # requests for this API operation to the Zonal endpoint. These
579
579
  # endpoints support virtual-hosted-style requests in the format
580
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
581
- # `. Path-style requests are not supported. For more information, see
582
- # [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
580
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
581
+ # `. Path-style requests are not supported. For more information about
582
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
583
+ # for directory buckets in Availability Zones][2] in the *Amazon S3
584
+ # User Guide*. For more information about endpoints in Local Zones,
585
+ # see [Available Local Zone for directory buckets][3] in the *Amazon
586
+ # S3 User Guide*.
583
587
  #
584
588
  # </note>
585
589
  #
586
590
  # Permissions
587
591
  # : * **General purpose bucket permissions** - For information about
588
592
  # permissions required to use the multipart upload, see [Multipart
589
- # Upload and Permissions][3] in the *Amazon S3 User Guide*.
593
+ # Upload and Permissions][4] in the *Amazon S3 User Guide*.
590
594
  #
591
595
  # * **Directory bucket permissions** - To grant access to this API
592
596
  # operation on a directory bucket, we recommend that you use the [
593
- # `CreateSession` ][4] API operation for session-based
597
+ # `CreateSession` ][5] API operation for session-based
594
598
  # authorization. Specifically, you grant the
595
599
  # `s3express:CreateSession` permission to the directory bucket in a
596
600
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -601,45 +605,46 @@ module Aws::S3
601
605
  # token for use. Amazon Web Services CLI or SDKs create session and
602
606
  # refresh the session token automatically to avoid service
603
607
  # interruptions when a session expires. For more information about
604
- # authorization, see [ `CreateSession` ][4].
608
+ # authorization, see [ `CreateSession` ][5].
605
609
  #
606
610
  # HTTP Host header syntax
607
611
  #
608
612
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
609
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
613
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
610
614
  #
611
615
  # The following operations are related to `AbortMultipartUpload`:
612
616
  #
613
- # * [CreateMultipartUpload][5]
617
+ # * [CreateMultipartUpload][6]
614
618
  #
615
- # * [UploadPart][6]
619
+ # * [UploadPart][7]
616
620
  #
617
- # * [CompleteMultipartUpload][7]
621
+ # * [CompleteMultipartUpload][8]
618
622
  #
619
623
  # * [ListParts][1]
620
624
  #
621
- # * [ListMultipartUploads][8]
625
+ # * [ListMultipartUploads][9]
622
626
  #
623
627
  #
624
628
  #
625
629
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
626
630
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
627
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
628
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
629
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
630
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
631
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
632
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
631
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
632
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
633
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
634
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
635
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
636
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
637
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
633
638
  #
634
639
  # @option params [required, String] :bucket
635
640
  # The bucket name to which the upload was taking place.
636
641
  #
637
642
  # **Directory buckets** - When you use this operation with a directory
638
643
  # bucket, you must use virtual-hosted-style requests in the format `
639
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
640
- # are not supported. Directory bucket names must be unique in the chosen
641
- # Availability Zone. Bucket names must follow the format `
642
- # bucket_base_name--az-id--x-s3` (for example, `
644
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
645
+ # requests are not supported. Directory bucket names must be unique in
646
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
647
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
643
648
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
644
649
  # naming restrictions, see [Directory bucket naming rules][1] in the
645
650
  # *Amazon S3 User Guide*.
@@ -805,19 +810,23 @@ module Aws::S3
805
810
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
806
811
  # for this API operation to the Zonal endpoint. These endpoints support
807
812
  # virtual-hosted-style requests in the format
808
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
809
- # Path-style requests are not supported. For more information, see
810
- # [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
813
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
814
+ # `. Path-style requests are not supported. For more information about
815
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints for
816
+ # directory buckets in Availability Zones][5] in the *Amazon S3 User
817
+ # Guide*. For more information about endpoints in Local Zones, see
818
+ # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
819
+ # Guide*.
811
820
  #
812
821
  # </note>
813
822
  #
814
823
  # Permissions
815
824
  # : * **General purpose bucket permissions** - For information about
816
825
  # permissions required to use the multipart upload API, see
817
- # [Multipart Upload and Permissions][6] in the *Amazon S3 User
826
+ # [Multipart Upload and Permissions][7] in the *Amazon S3 User
818
827
  # Guide*.
819
828
  #
820
- # If you provide an [additional checksum value][7] in your
829
+ # If you provide an [additional checksum value][8] in your
821
830
  # `MultipartUpload` requests and the object is encrypted with Key
822
831
  # Management Service, you must have permission to use the
823
832
  # `kms:Decrypt` action for the `CompleteMultipartUpload` request to
@@ -825,7 +834,7 @@ module Aws::S3
825
834
  #
826
835
  # * **Directory bucket permissions** - To grant access to this API
827
836
  # operation on a directory bucket, we recommend that you use the [
828
- # `CreateSession` ][8] API operation for session-based
837
+ # `CreateSession` ][9] API operation for session-based
829
838
  # authorization. Specifically, you grant the
830
839
  # `s3express:CreateSession` permission to the directory bucket in a
831
840
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -836,7 +845,7 @@ module Aws::S3
836
845
  # token for use. Amazon Web Services CLI or SDKs create session and
837
846
  # refresh the session token automatically to avoid service
838
847
  # interruptions when a session expires. For more information about
839
- # authorization, see [ `CreateSession` ][8].
848
+ # authorization, see [ `CreateSession` ][9].
840
849
  #
841
850
  # If the object is encrypted with SSE-KMS, you must also have the
842
851
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -874,19 +883,19 @@ module Aws::S3
874
883
  # HTTP Host header syntax
875
884
  #
876
885
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
877
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
886
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
878
887
  #
879
888
  # The following operations are related to `CompleteMultipartUpload`:
880
889
  #
881
- # * [CreateMultipartUpload][9]
890
+ # * [CreateMultipartUpload][10]
882
891
  #
883
892
  # * [UploadPart][1]
884
893
  #
885
- # * [AbortMultipartUpload][10]
894
+ # * [AbortMultipartUpload][11]
886
895
  #
887
- # * [ListParts][11]
896
+ # * [ListParts][12]
888
897
  #
889
- # * [ListMultipartUploads][12]
898
+ # * [ListMultipartUploads][13]
890
899
  #
891
900
  #
892
901
  #
@@ -895,23 +904,24 @@ module Aws::S3
895
904
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html
896
905
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
897
906
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
898
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
899
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
900
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
901
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
902
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
903
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
904
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
907
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
908
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
909
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
910
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
911
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
912
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
913
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
914
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
905
915
  #
906
916
  # @option params [required, String] :bucket
907
917
  # Name of the bucket to which the multipart upload was initiated.
908
918
  #
909
919
  # **Directory buckets** - When you use this operation with a directory
910
920
  # bucket, you must use virtual-hosted-style requests in the format `
911
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
912
- # are not supported. Directory bucket names must be unique in the chosen
913
- # Availability Zone. Bucket names must follow the format `
914
- # bucket_base_name--az-id--x-s3` (for example, `
921
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
922
+ # requests are not supported. Directory bucket names must be unique in
923
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
924
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
915
925
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
916
926
  # naming restrictions, see [Directory bucket naming rules][1] in the
917
927
  # *Amazon S3 User Guide*.
@@ -1232,9 +1242,13 @@ module Aws::S3
1232
1242
  # * <b>Directory buckets </b> - For directory buckets, you must make
1233
1243
  # requests for this API operation to the Zonal endpoint. These
1234
1244
  # endpoints support virtual-hosted-style requests in the format
1235
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
1236
- # `. Path-style requests are not supported. For more information, see
1237
- # [Regional and Zonal endpoints][2] in the *Amazon S3 User Guide*.
1245
+ # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
1246
+ # `. Path-style requests are not supported. For more information about
1247
+ # endpoints in Availability Zones, see [Regional and Zonal endpoints
1248
+ # for directory buckets in Availability Zones][2] in the *Amazon S3
1249
+ # User Guide*. For more information about endpoints in Local Zones,
1250
+ # see [Available Local Zone for directory buckets][3] in the *Amazon
1251
+ # S3 User Guide*.
1238
1252
  #
1239
1253
  # * VPC endpoints don't support cross-Region requests (including
1240
1254
  # copies). If you're using VPC endpoints, your source and destination
@@ -1246,13 +1260,13 @@ module Aws::S3
1246
1260
  # Both the Region that you want to copy the object from and the Region
1247
1261
  # that you want to copy the object to must be enabled for your account.
1248
1262
  # For more information about how to enable a Region for your account,
1249
- # see [Enable or disable a Region for standalone accounts][3] in the
1263
+ # see [Enable or disable a Region for standalone accounts][4] in the
1250
1264
  # *Amazon Web Services Account Management Guide*.
1251
1265
  #
1252
1266
  # Amazon S3 transfer acceleration does not support cross-Region copies.
1253
1267
  # If you request a cross-Region copy using a transfer acceleration
1254
1268
  # endpoint, you get a `400 Bad Request` error. For more information, see
1255
- # [Transfer Acceleration][4].
1269
+ # [Transfer Acceleration][5].
1256
1270
  #
1257
1271
  # Authentication and authorization
1258
1272
  #
@@ -1260,7 +1274,7 @@ module Aws::S3
1260
1274
  # IAM credentials (access key ID and secret access key for the IAM
1261
1275
  # identities). All headers with the `x-amz-` prefix, including
1262
1276
  # `x-amz-copy-source`, must be signed. For more information, see [REST
1263
- # Authentication][5].
1277
+ # Authentication][6].
1264
1278
  #
1265
1279
  # **Directory buckets** - You must use the IAM credentials to
1266
1280
  # authenticate and authorize your access to the `CopyObject` API
@@ -1308,9 +1322,9 @@ module Aws::S3
1308
1322
  # identity-based policies and KMS key policies for the KMS key.
1309
1323
  #
1310
1324
  # For example policies, see [Example bucket policies for S3 Express
1311
- # One Zone][6] and [Amazon Web Services Identity and Access
1325
+ # One Zone][7] and [Amazon Web Services Identity and Access
1312
1326
  # Management (IAM) identity-based policies for S3 Express One
1313
- # Zone][7] in the *Amazon S3 User Guide*.
1327
+ # Zone][8] in the *Amazon S3 User Guide*.
1314
1328
  #
1315
1329
  # Response and special errors
1316
1330
  #
@@ -1333,7 +1347,7 @@ module Aws::S3
1333
1347
  # response is embedded in the `200 OK` response. For example, in a
1334
1348
  # cross-region copy, you may encounter throttling and receive a
1335
1349
  # `200 OK` response. For more information, see [Resolve the Error
1336
- # 200 response when copying objects to Amazon S3][8]. The `200 OK`
1350
+ # 200 response when copying objects to Amazon S3][9]. The `200 OK`
1337
1351
  # status code means the copy was accepted, but it doesn't mean
1338
1352
  # the copy is complete. Another example is when you disconnect
1339
1353
  # from Amazon S3 before the copy is complete, Amazon S3 might
@@ -1357,32 +1371,33 @@ module Aws::S3
1357
1371
  # result in a data retrieval charge for the source if the source
1358
1372
  # storage class bills for data retrieval. If the copy source is in a
1359
1373
  # different region, the data transfer is billed to the copy source
1360
- # account. For pricing information, see [Amazon S3 pricing][9].
1374
+ # account. For pricing information, see [Amazon S3 pricing][10].
1361
1375
  #
1362
1376
  # HTTP Host header syntax
1363
1377
  #
1364
1378
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
1365
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
1379
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
1366
1380
  #
1367
1381
  # The following operations are related to `CopyObject`:
1368
1382
  #
1369
- # * [PutObject][10]
1383
+ # * [PutObject][11]
1370
1384
  #
1371
- # * [GetObject][11]
1385
+ # * [GetObject][12]
1372
1386
  #
1373
1387
  #
1374
1388
  #
1375
1389
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
1376
1390
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
1377
- # [3]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
1378
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
1379
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
1380
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
1381
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
1382
- # [8]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
1383
- # [9]: http://aws.amazon.com/s3/pricing/
1384
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
1385
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
1391
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
1392
+ # [4]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
1393
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
1394
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
1395
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
1396
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
1397
+ # [9]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
1398
+ # [10]: http://aws.amazon.com/s3/pricing/
1399
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
1400
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
1386
1401
  #
1387
1402
  # @option params [String] :acl
1388
1403
  # The canned access control list (ACL) to apply to the object.
@@ -1422,14 +1437,22 @@ module Aws::S3
1422
1437
  #
1423
1438
  # **Directory buckets** - When you use this operation with a directory
1424
1439
  # bucket, you must use virtual-hosted-style requests in the format `
1425
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
1426
- # are not supported. Directory bucket names must be unique in the chosen
1427
- # Availability Zone. Bucket names must follow the format `
1428
- # bucket_base_name--az-id--x-s3` (for example, `
1440
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
1441
+ # requests are not supported. Directory bucket names must be unique in
1442
+ # the chosen Zone (Availability Zone or Local Zone). Bucket names must
1443
+ # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
1429
1444
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1430
1445
  # naming restrictions, see [Directory bucket naming rules][1] in the
1431
1446
  # *Amazon S3 User Guide*.
1432
1447
  #
1448
+ # <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
1449
+ # supported when the source or destination bucket is in Amazon Web
1450
+ # Services Local Zones. The source and destination buckets must have the
1451
+ # same parent Amazon Web Services Region. Otherwise, you get an HTTP
1452
+ # `400 Bad Request` error with the error code `InvalidRequest`.
1453
+ #
1454
+ # </note>
1455
+ #
1433
1456
  # **Access points** - When you use this action with an access point, you
1434
1457
  # must provide the alias of the access point in place of the bucket name
1435
1458
  # or specify the access point ARN. When using the access point ARN, you
@@ -2282,10 +2305,13 @@ module Aws::S3
2282
2305
  # * <b>Directory buckets </b> - For directory buckets, you must make
2283
2306
  # requests for this API operation to the Regional endpoint. These
2284
2307
  # endpoints support path-style requests in the format
2285
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
2308
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2286
2309
  # Virtual-hosted-style requests aren't supported. For more
2287
- # information, see [Regional and Zonal endpoints][4] in the *Amazon S3
2288
- # User Guide*.
2310
+ # information about endpoints in Availability Zones, see [Regional and
2311
+ # Zonal endpoints for directory buckets in Availability Zones][4] in
2312
+ # the *Amazon S3 User Guide*. For more information about endpoints in
2313
+ # Local Zones, see [Available Local Zone for directory buckets][5] in
2314
+ # the *Amazon S3 User Guide*.
2289
2315
  #
2290
2316
  # </note>
2291
2317
  #
@@ -2327,17 +2353,17 @@ module Aws::S3
2327
2353
  # disabled. If you would like to share data with users outside of
2328
2354
  # your account, you can use bucket policies as needed. For more
2329
2355
  # information, see [Controlling ownership of objects and disabling
2330
- # ACLs for your bucket ][5] and [Blocking public access to your
2331
- # Amazon S3 storage ][6] in the *Amazon S3 User Guide*.
2356
+ # ACLs for your bucket ][6] and [Blocking public access to your
2357
+ # Amazon S3 storage ][7] in the *Amazon S3 User Guide*.
2332
2358
  #
2333
2359
  # * **S3 Block Public Access** - If your specific use case requires
2334
2360
  # granting public access to your S3 resources, you can disable
2335
2361
  # Block Public Access. Specifically, you can create a new bucket
2336
2362
  # with Block Public Access enabled, then separately call the [
2337
- # `DeletePublicAccessBlock` ][7] API. To use this operation, you
2363
+ # `DeletePublicAccessBlock` ][8] API. To use this operation, you
2338
2364
  # must have the `s3:PutBucketPublicAccessBlock` permission. For
2339
2365
  # more information about S3 Block Public Access, see [Blocking
2340
- # public access to your Amazon S3 storage ][6] in the *Amazon S3
2366
+ # public access to your Amazon S3 storage ][7] in the *Amazon S3
2341
2367
  # User Guide*.
2342
2368
  # * **Directory bucket permissions** - You must have the
2343
2369
  # `s3express:CreateBucket` permission in an IAM identity-based
@@ -2346,7 +2372,7 @@ module Aws::S3
2346
2372
  # performed by the Amazon Web Services account that owns the
2347
2373
  # resource. For more information about directory bucket policies and
2348
2374
  # permissions, see [Amazon Web Services Identity and Access
2349
- # Management (IAM) for S3 Express One Zone][8] in the *Amazon S3
2375
+ # Management (IAM) for S3 Express One Zone][9] in the *Amazon S3
2350
2376
  # User Guide*.
2351
2377
  #
2352
2378
  # The permissions for ACLs, Object Lock, S3 Object Ownership, and S3
@@ -2356,21 +2382,21 @@ module Aws::S3
2356
2382
  # enforced (ACLs disabled). These settings can't be modified.
2357
2383
  #
2358
2384
  # For more information about permissions for creating and working
2359
- # with directory buckets, see [Directory buckets][9] in the *Amazon
2385
+ # with directory buckets, see [Directory buckets][10] in the *Amazon
2360
2386
  # S3 User Guide*. For more information about supported S3 features
2361
- # for directory buckets, see [Features of S3 Express One Zone][10]
2387
+ # for directory buckets, see [Features of S3 Express One Zone][11]
2362
2388
  # in the *Amazon S3 User Guide*.
2363
2389
  #
2364
2390
  # HTTP Host header syntax
2365
2391
  #
2366
2392
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
2367
- # `s3express-control.region.amazonaws.com`.
2393
+ # `s3express-control.region-code.amazonaws.com`.
2368
2394
  #
2369
2395
  # The following operations are related to `CreateBucket`:
2370
2396
  #
2371
- # * [PutObject][11]
2397
+ # * [PutObject][12]
2372
2398
  #
2373
- # * [DeleteBucket][12]
2399
+ # * [DeleteBucket][13]
2374
2400
  #
2375
2401
  #
2376
2402
  #
@@ -2378,14 +2404,15 @@ module Aws::S3
2378
2404
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
2379
2405
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
2380
2406
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2381
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2382
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
2383
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
2384
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
2385
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
2386
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
2387
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
2388
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
2407
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
2408
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2409
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
2410
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
2411
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
2412
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
2413
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
2414
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
2415
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
2389
2416
  #
2390
2417
  # @option params [String] :acl
2391
2418
  # The canned ACL to apply to the bucket.
@@ -2403,13 +2430,14 @@ module Aws::S3
2403
2430
  #
2404
2431
  # <b>Directory buckets </b> - When you use this operation with a
2405
2432
  # directory bucket, you must use path-style requests in the format
2406
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
2433
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2407
2434
  # Virtual-hosted-style requests aren't supported. Directory bucket
2408
- # names must be unique in the chosen Availability Zone. Bucket names
2409
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
2410
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
2411
- # bucket naming restrictions, see [Directory bucket naming rules][2] in
2412
- # the *Amazon S3 User Guide*
2435
+ # names must be unique in the chosen Zone (Availability Zone or Local
2436
+ # Zone). Bucket names must also follow the format `
2437
+ # bucket-base-name--zone-id--x-s3` (for example, `
2438
+ # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
2439
+ # naming restrictions, see [Directory bucket naming rules][2] in the
2440
+ # *Amazon S3 User Guide*
2413
2441
  #
2414
2442
  #
2415
2443
  #
@@ -2506,33 +2534,33 @@ module Aws::S3
2506
2534
  # * {Types::CreateBucketOutput#location #location} => String
2507
2535
  #
2508
2536
  #
2509
- # @example Example: To create a bucket
2537
+ # @example Example: To create a bucket in a specific region
2510
2538
  #
2511
- # # The following example creates a bucket.
2539
+ # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
2512
2540
  #
2513
2541
  # resp = client.create_bucket({
2514
2542
  # bucket: "examplebucket",
2543
+ # create_bucket_configuration: {
2544
+ # location_constraint: "eu-west-1",
2545
+ # },
2515
2546
  # })
2516
2547
  #
2517
2548
  # resp.to_h outputs the following:
2518
2549
  # {
2519
- # location: "/examplebucket",
2550
+ # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
2520
2551
  # }
2521
2552
  #
2522
- # @example Example: To create a bucket in a specific region
2553
+ # @example Example: To create a bucket
2523
2554
  #
2524
- # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
2555
+ # # The following example creates a bucket.
2525
2556
  #
2526
2557
  # resp = client.create_bucket({
2527
2558
  # bucket: "examplebucket",
2528
- # create_bucket_configuration: {
2529
- # location_constraint: "eu-west-1",
2530
- # },
2531
2559
  # })
2532
2560
  #
2533
2561
  # resp.to_h outputs the following:
2534
2562
  # {
2535
- # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
2563
+ # location: "/examplebucket",
2536
2564
  # }
2537
2565
  #
2538
2566
  # @example Request syntax with placeholder values
@@ -2543,11 +2571,11 @@ module Aws::S3
2543
2571
  # create_bucket_configuration: {
2544
2572
  # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
2545
2573
  # location: {
2546
- # type: "AvailabilityZone", # accepts AvailabilityZone
2574
+ # type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
2547
2575
  # name: "LocationNameAsString",
2548
2576
  # },
2549
2577
  # bucket: {
2550
- # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone
2578
+ # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
2551
2579
  # type: "Directory", # accepts Directory
2552
2580
  # },
2553
2581
  # },
@@ -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