aws-sdk-s3 1.169.0 → 1.175.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -571,26 +571,30 @@ module Aws::S3
571
571
  # in-progress multipart uploads are aborted or completed. To delete
572
572
  # these in-progress multipart uploads, use the `ListMultipartUploads`
573
573
  # operation to list the in-progress multipart uploads in the bucket
574
- # and use the `AbortMultupartUpload` operation to abort all the
574
+ # and use the `AbortMultipartUpload` operation to abort all the
575
575
  # in-progress multipart uploads.
576
576
  #
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*.
@@ -703,6 +708,18 @@ module Aws::S3
703
708
  # you provide does not match the actual owner of the bucket, the request
704
709
  # fails with the HTTP status code `403 Forbidden` (access denied).
705
710
  #
711
+ # @option params [Time,DateTime,Date,Integer,String] :if_match_initiated_time
712
+ # If present, this header aborts an in progress multipart upload only if
713
+ # it was initiated on the provided timestamp. If the initiated timestamp
714
+ # of the multipart upload does not match the provided value, the
715
+ # operation returns a `412 Precondition Failed` error. If the initiated
716
+ # timestamp matches or if the multipart upload doesn’t exist, the
717
+ # operation returns a `204 Success (No Content)` response.
718
+ #
719
+ # <note markdown="1"> This functionality is only supported for directory buckets.
720
+ #
721
+ # </note>
722
+ #
706
723
  # @return [Types::AbortMultipartUploadOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
707
724
  #
708
725
  # * {Types::AbortMultipartUploadOutput#request_charged #request_charged} => String
@@ -730,6 +747,7 @@ module Aws::S3
730
747
  # upload_id: "MultipartUploadId", # required
731
748
  # request_payer: "requester", # accepts requester
732
749
  # expected_bucket_owner: "AccountId",
750
+ # if_match_initiated_time: Time.now,
733
751
  # })
734
752
  #
735
753
  # @example Response structure
@@ -792,19 +810,23 @@ module Aws::S3
792
810
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
793
811
  # for this API operation to the Zonal endpoint. These endpoints support
794
812
  # virtual-hosted-style requests in the format
795
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
796
- # Path-style requests are not supported. For more information, see
797
- # [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*.
798
820
  #
799
821
  # </note>
800
822
  #
801
823
  # Permissions
802
824
  # : * **General purpose bucket permissions** - For information about
803
825
  # permissions required to use the multipart upload API, see
804
- # [Multipart Upload and Permissions][6] in the *Amazon S3 User
826
+ # [Multipart Upload and Permissions][7] in the *Amazon S3 User
805
827
  # Guide*.
806
828
  #
807
- # If you provide an [additional checksum value][7] in your
829
+ # If you provide an [additional checksum value][8] in your
808
830
  # `MultipartUpload` requests and the object is encrypted with Key
809
831
  # Management Service, you must have permission to use the
810
832
  # `kms:Decrypt` action for the `CompleteMultipartUpload` request to
@@ -812,7 +834,7 @@ module Aws::S3
812
834
  #
813
835
  # * **Directory bucket permissions** - To grant access to this API
814
836
  # operation on a directory bucket, we recommend that you use the [
815
- # `CreateSession` ][8] API operation for session-based
837
+ # `CreateSession` ][9] API operation for session-based
816
838
  # authorization. Specifically, you grant the
817
839
  # `s3express:CreateSession` permission to the directory bucket in a
818
840
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -823,7 +845,7 @@ module Aws::S3
823
845
  # token for use. Amazon Web Services CLI or SDKs create session and
824
846
  # refresh the session token automatically to avoid service
825
847
  # interruptions when a session expires. For more information about
826
- # authorization, see [ `CreateSession` ][8].
848
+ # authorization, see [ `CreateSession` ][9].
827
849
  #
828
850
  # If the object is encrypted with SSE-KMS, you must also have the
829
851
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -837,7 +859,6 @@ module Aws::S3
837
859
  # except the last part.
838
860
  #
839
861
  # * HTTP Status Code: 400 Bad Request
840
- #
841
862
  # * Error Code: `InvalidPart`
842
863
  #
843
864
  # * Description: One or more of the specified parts could not be
@@ -845,14 +866,12 @@ module Aws::S3
845
866
  # ETag might not have matched the uploaded part's ETag.
846
867
  #
847
868
  # * HTTP Status Code: 400 Bad Request
848
- #
849
869
  # * Error Code: `InvalidPartOrder`
850
870
  #
851
871
  # * Description: The list of parts was not in ascending order. The
852
872
  # parts list must be specified in order by part number.
853
873
  #
854
874
  # * HTTP Status Code: 400 Bad Request
855
- #
856
875
  # * Error Code: `NoSuchUpload`
857
876
  #
858
877
  # * Description: The specified multipart upload does not exist. The
@@ -864,19 +883,19 @@ module Aws::S3
864
883
  # HTTP Host header syntax
865
884
  #
866
885
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
867
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
886
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
868
887
  #
869
888
  # The following operations are related to `CompleteMultipartUpload`:
870
889
  #
871
- # * [CreateMultipartUpload][9]
890
+ # * [CreateMultipartUpload][10]
872
891
  #
873
892
  # * [UploadPart][1]
874
893
  #
875
- # * [AbortMultipartUpload][10]
894
+ # * [AbortMultipartUpload][11]
876
895
  #
877
- # * [ListParts][11]
896
+ # * [ListParts][12]
878
897
  #
879
- # * [ListMultipartUploads][12]
898
+ # * [ListMultipartUploads][13]
880
899
  #
881
900
  #
882
901
  #
@@ -885,23 +904,24 @@ module Aws::S3
885
904
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html
886
905
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
887
906
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
888
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
889
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
890
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
891
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
892
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
893
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
894
- # [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
895
915
  #
896
916
  # @option params [required, String] :bucket
897
917
  # Name of the bucket to which the multipart upload was initiated.
898
918
  #
899
919
  # **Directory buckets** - When you use this operation with a directory
900
920
  # bucket, you must use virtual-hosted-style requests in the format `
901
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
902
- # are not supported. Directory bucket names must be unique in the chosen
903
- # Availability Zone. Bucket names must follow the format `
904
- # 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, `
905
925
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
906
926
  # naming restrictions, see [Directory bucket naming rules][1] in the
907
927
  # *Amazon S3 User Guide*.
@@ -1012,6 +1032,27 @@ module Aws::S3
1012
1032
  # you provide does not match the actual owner of the bucket, the request
1013
1033
  # fails with the HTTP status code `403 Forbidden` (access denied).
1014
1034
  #
1035
+ # @option params [String] :if_match
1036
+ # Uploads the object only if the ETag (entity tag) value provided during
1037
+ # the WRITE operation matches the ETag of the object in S3. If the ETag
1038
+ # values do not match, the operation returns a `412 Precondition Failed`
1039
+ # error.
1040
+ #
1041
+ # If a conflicting operation occurs during the upload S3 returns a `409
1042
+ # ConditionalRequestConflict` response. On a 409 failure you should
1043
+ # fetch the object's ETag, re-initiate the multipart upload with
1044
+ # `CreateMultipartUpload`, and re-upload each part.
1045
+ #
1046
+ # Expects the ETag value as a string.
1047
+ #
1048
+ # For more information about conditional requests, see [RFC 7232][1], or
1049
+ # [Conditional requests][2] in the *Amazon S3 User Guide*.
1050
+ #
1051
+ #
1052
+ #
1053
+ # [1]: https://tools.ietf.org/html/rfc7232
1054
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
1055
+ #
1015
1056
  # @option params [String] :if_none_match
1016
1057
  # Uploads the object only if the object key name does not already exist
1017
1058
  # in the bucket specified. Otherwise, Amazon S3 returns a `412
@@ -1147,6 +1188,7 @@ module Aws::S3
1147
1188
  # checksum_sha256: "ChecksumSHA256",
1148
1189
  # request_payer: "requester", # accepts requester
1149
1190
  # expected_bucket_owner: "AccountId",
1191
+ # if_match: "IfMatch",
1150
1192
  # if_none_match: "IfNoneMatch",
1151
1193
  # sse_customer_algorithm: "SSECustomerAlgorithm",
1152
1194
  # sse_customer_key: "SSECustomerKey",
@@ -1200,9 +1242,13 @@ module Aws::S3
1200
1242
  # * <b>Directory buckets </b> - For directory buckets, you must make
1201
1243
  # requests for this API operation to the Zonal endpoint. These
1202
1244
  # endpoints support virtual-hosted-style requests in the format
1203
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
1204
- # `. Path-style requests are not supported. For more information, see
1205
- # [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*.
1206
1252
  #
1207
1253
  # * VPC endpoints don't support cross-Region requests (including
1208
1254
  # copies). If you're using VPC endpoints, your source and destination
@@ -1214,13 +1260,13 @@ module Aws::S3
1214
1260
  # Both the Region that you want to copy the object from and the Region
1215
1261
  # that you want to copy the object to must be enabled for your account.
1216
1262
  # For more information about how to enable a Region for your account,
1217
- # 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
1218
1264
  # *Amazon Web Services Account Management Guide*.
1219
1265
  #
1220
1266
  # Amazon S3 transfer acceleration does not support cross-Region copies.
1221
1267
  # If you request a cross-Region copy using a transfer acceleration
1222
1268
  # endpoint, you get a `400 Bad Request` error. For more information, see
1223
- # [Transfer Acceleration][4].
1269
+ # [Transfer Acceleration][5].
1224
1270
  #
1225
1271
  # Authentication and authorization
1226
1272
  #
@@ -1228,7 +1274,7 @@ module Aws::S3
1228
1274
  # IAM credentials (access key ID and secret access key for the IAM
1229
1275
  # identities). All headers with the `x-amz-` prefix, including
1230
1276
  # `x-amz-copy-source`, must be signed. For more information, see [REST
1231
- # Authentication][5].
1277
+ # Authentication][6].
1232
1278
  #
1233
1279
  # **Directory buckets** - You must use the IAM credentials to
1234
1280
  # authenticate and authorize your access to the `CopyObject` API
@@ -1254,7 +1300,6 @@ module Aws::S3
1254
1300
  # * If the destination bucket is a general purpose bucket, you must
1255
1301
  # have <b> <code>s3:PutObject</code> </b> permission to write the
1256
1302
  # object copy to the destination bucket.
1257
- #
1258
1303
  # * **Directory bucket permissions** - You must have permissions in a
1259
1304
  # bucket policy or an IAM identity-based policy based on the source
1260
1305
  # and destination bucket types in a `CopyObject` operation.
@@ -1272,15 +1317,14 @@ module Aws::S3
1272
1317
  # `Action` element of a policy to write the object to the
1273
1318
  # destination. The `s3express:SessionMode` condition key can't be
1274
1319
  # set to `ReadOnly` on the copy destination bucket.
1275
- #
1276
1320
  # If the object is encrypted with SSE-KMS, you must also have the
1277
1321
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
1278
1322
  # identity-based policies and KMS key policies for the KMS key.
1279
1323
  #
1280
1324
  # For example policies, see [Example bucket policies for S3 Express
1281
- # One Zone][6] and [Amazon Web Services Identity and Access
1325
+ # One Zone][7] and [Amazon Web Services Identity and Access
1282
1326
  # Management (IAM) identity-based policies for S3 Express One
1283
- # Zone][7] in the *Amazon S3 User Guide*.
1327
+ # Zone][8] in the *Amazon S3 User Guide*.
1284
1328
  #
1285
1329
  # Response and special errors
1286
1330
  #
@@ -1303,7 +1347,7 @@ module Aws::S3
1303
1347
  # response is embedded in the `200 OK` response. For example, in a
1304
1348
  # cross-region copy, you may encounter throttling and receive a
1305
1349
  # `200 OK` response. For more information, see [Resolve the Error
1306
- # 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`
1307
1351
  # status code means the copy was accepted, but it doesn't mean
1308
1352
  # the copy is complete. Another example is when you disconnect
1309
1353
  # from Amazon S3 before the copy is complete, Amazon S3 might
@@ -1327,32 +1371,33 @@ module Aws::S3
1327
1371
  # result in a data retrieval charge for the source if the source
1328
1372
  # storage class bills for data retrieval. If the copy source is in a
1329
1373
  # different region, the data transfer is billed to the copy source
1330
- # account. For pricing information, see [Amazon S3 pricing][9].
1374
+ # account. For pricing information, see [Amazon S3 pricing][10].
1331
1375
  #
1332
1376
  # HTTP Host header syntax
1333
1377
  #
1334
1378
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
1335
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
1379
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
1336
1380
  #
1337
1381
  # The following operations are related to `CopyObject`:
1338
1382
  #
1339
- # * [PutObject][10]
1383
+ # * [PutObject][11]
1340
1384
  #
1341
- # * [GetObject][11]
1385
+ # * [GetObject][12]
1342
1386
  #
1343
1387
  #
1344
1388
  #
1345
1389
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
1346
1390
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
1347
- # [3]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
1348
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
1349
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
1350
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
1351
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
1352
- # [8]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
1353
- # [9]: http://aws.amazon.com/s3/pricing/
1354
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
1355
- # [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
1356
1401
  #
1357
1402
  # @option params [String] :acl
1358
1403
  # The canned access control list (ACL) to apply to the object.
@@ -1392,14 +1437,22 @@ module Aws::S3
1392
1437
  #
1393
1438
  # **Directory buckets** - When you use this operation with a directory
1394
1439
  # bucket, you must use virtual-hosted-style requests in the format `
1395
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
1396
- # are not supported. Directory bucket names must be unique in the chosen
1397
- # Availability Zone. Bucket names must follow the format `
1398
- # 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, `
1399
1444
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1400
1445
  # naming restrictions, see [Directory bucket naming rules][1] in the
1401
1446
  # *Amazon S3 User Guide*.
1402
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
+ #
1403
1456
  # **Access points** - When you use this action with an access point, you
1404
1457
  # must provide the alias of the access point in place of the bucket name
1405
1458
  # or specify the access point ARN. When using the access point ARN, you
@@ -2252,10 +2305,13 @@ module Aws::S3
2252
2305
  # * <b>Directory buckets </b> - For directory buckets, you must make
2253
2306
  # requests for this API operation to the Regional endpoint. These
2254
2307
  # endpoints support path-style requests in the format
2255
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
2308
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2256
2309
  # Virtual-hosted-style requests aren't supported. For more
2257
- # information, see [Regional and Zonal endpoints][4] in the *Amazon S3
2258
- # 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*.
2259
2315
  #
2260
2316
  # </note>
2261
2317
  #
@@ -2297,19 +2353,18 @@ module Aws::S3
2297
2353
  # disabled. If you would like to share data with users outside of
2298
2354
  # your account, you can use bucket policies as needed. For more
2299
2355
  # information, see [Controlling ownership of objects and disabling
2300
- # ACLs for your bucket ][5] and [Blocking public access to your
2301
- # 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*.
2302
2358
  #
2303
2359
  # * **S3 Block Public Access** - If your specific use case requires
2304
2360
  # granting public access to your S3 resources, you can disable
2305
2361
  # Block Public Access. Specifically, you can create a new bucket
2306
2362
  # with Block Public Access enabled, then separately call the [
2307
- # `DeletePublicAccessBlock` ][7] API. To use this operation, you
2363
+ # `DeletePublicAccessBlock` ][8] API. To use this operation, you
2308
2364
  # must have the `s3:PutBucketPublicAccessBlock` permission. For
2309
2365
  # more information about S3 Block Public Access, see [Blocking
2310
- # 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
2311
2367
  # User Guide*.
2312
- #
2313
2368
  # * **Directory bucket permissions** - You must have the
2314
2369
  # `s3express:CreateBucket` permission in an IAM identity-based
2315
2370
  # policy instead of a bucket policy. Cross-account access to this
@@ -2317,7 +2372,7 @@ module Aws::S3
2317
2372
  # performed by the Amazon Web Services account that owns the
2318
2373
  # resource. For more information about directory bucket policies and
2319
2374
  # permissions, see [Amazon Web Services Identity and Access
2320
- # 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
2321
2376
  # User Guide*.
2322
2377
  #
2323
2378
  # The permissions for ACLs, Object Lock, S3 Object Ownership, and S3
@@ -2327,21 +2382,21 @@ module Aws::S3
2327
2382
  # enforced (ACLs disabled). These settings can't be modified.
2328
2383
  #
2329
2384
  # For more information about permissions for creating and working
2330
- # with directory buckets, see [Directory buckets][9] in the *Amazon
2385
+ # with directory buckets, see [Directory buckets][10] in the *Amazon
2331
2386
  # S3 User Guide*. For more information about supported S3 features
2332
- # for directory buckets, see [Features of S3 Express One Zone][10]
2387
+ # for directory buckets, see [Features of S3 Express One Zone][11]
2333
2388
  # in the *Amazon S3 User Guide*.
2334
2389
  #
2335
2390
  # HTTP Host header syntax
2336
2391
  #
2337
2392
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
2338
- # `s3express-control.region.amazonaws.com`.
2393
+ # `s3express-control.region-code.amazonaws.com`.
2339
2394
  #
2340
2395
  # The following operations are related to `CreateBucket`:
2341
2396
  #
2342
- # * [PutObject][11]
2397
+ # * [PutObject][12]
2343
2398
  #
2344
- # * [DeleteBucket][12]
2399
+ # * [DeleteBucket][13]
2345
2400
  #
2346
2401
  #
2347
2402
  #
@@ -2349,14 +2404,15 @@ module Aws::S3
2349
2404
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
2350
2405
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
2351
2406
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2352
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2353
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
2354
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
2355
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
2356
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
2357
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
2358
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
2359
- # [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
2360
2416
  #
2361
2417
  # @option params [String] :acl
2362
2418
  # The canned ACL to apply to the bucket.
@@ -2374,13 +2430,14 @@ module Aws::S3
2374
2430
  #
2375
2431
  # <b>Directory buckets </b> - When you use this operation with a
2376
2432
  # directory bucket, you must use path-style requests in the format
2377
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
2433
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2378
2434
  # Virtual-hosted-style requests aren't supported. Directory bucket
2379
- # names must be unique in the chosen Availability Zone. Bucket names
2380
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
2381
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
2382
- # bucket naming restrictions, see [Directory bucket naming rules][2] in
2383
- # 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*
2384
2441
  #
2385
2442
  #
2386
2443
  #
@@ -2514,11 +2571,11 @@ module Aws::S3
2514
2571
  # create_bucket_configuration: {
2515
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
2516
2573
  # location: {
2517
- # type: "AvailabilityZone", # accepts AvailabilityZone
2574
+ # type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
2518
2575
  # name: "LocationNameAsString",
2519
2576
  # },
2520
2577
  # bucket: {
2521
- # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone
2578
+ # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
2522
2579
  # type: "Directory", # accepts Directory
2523
2580
  # },
2524
2581
  # },
@@ -2575,9 +2632,13 @@ module Aws::S3
2575
2632
  # * <b>Directory buckets </b> - For directory buckets, you must make
2576
2633
  # requests for this API operation to the Zonal endpoint. These
2577
2634
  # endpoints support virtual-hosted-style requests in the format
2578
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
2579
- # `. Path-style requests are not supported. For more information, see
2580
- # [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*.
2581
2642
  #
2582
2643
  # </note>
2583
2644
  #
@@ -2589,7 +2650,7 @@ module Aws::S3
2589
2650
  # sign each request individually. There is nothing special about
2590
2651
  # signing multipart upload requests. For more information about
2591
2652
  # signing, see [Authenticating Requests (Amazon Web Services Signature
2592
- # Version 4)][5] in the *Amazon S3 User Guide*.
2653
+ # Version 4)][6] in the *Amazon S3 User Guide*.
2593
2654
  #
2594
2655
  # Permissions
2595
2656
  # : * **General purpose bucket permissions** - To perform a multipart
@@ -2602,13 +2663,13 @@ module Aws::S3
2602
2663
  # `UploadPartCopy` APIs. These permissions are required because
2603
2664
  # Amazon S3 must decrypt and read data from the encrypted file parts
2604
2665
  # before it completes the multipart upload. For more information,
2605
- # see [Multipart upload API and permissions][6] and [Protecting data
2606
- # 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
2607
2668
  # the *Amazon S3 User Guide*.
2608
2669
  #
2609
2670
  # * **Directory bucket permissions** - To grant access to this API
2610
2671
  # operation on a directory bucket, we recommend that you use the [
2611
- # `CreateSession` ][8] API operation for session-based
2672
+ # `CreateSession` ][9] API operation for session-based
2612
2673
  # authorization. Specifically, you grant the
2613
2674
  # `s3express:CreateSession` permission to the directory bucket in a
2614
2675
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -2619,7 +2680,7 @@ module Aws::S3
2619
2680
  # token for use. Amazon Web Services CLI or SDKs create session and
2620
2681
  # refresh the session token automatically to avoid service
2621
2682
  # interruptions when a session expires. For more information about
2622
- # authorization, see [ `CreateSession` ][8].
2683
+ # authorization, see [ `CreateSession` ][9].
2623
2684
  #
2624
2685
  # Encryption
2625
2686
  # : * **General purpose buckets** - Server-side encryption is for data
@@ -2646,7 +2707,7 @@ module Aws::S3
2646
2707
  # the destination bucket, the encryption setting in your request
2647
2708
  # takes precedence. If you choose to provide your own encryption
2648
2709
  # key, the request headers you provide in [UploadPart][1] and
2649
- # [UploadPartCopy][9] requests must match the headers you used in
2710
+ # [UploadPartCopy][10] requests must match the headers you used in
2650
2711
  # the `CreateMultipartUpload` request.
2651
2712
  #
2652
2713
  # * Use KMS keys (SSE-KMS) that include the Amazon Web Services
@@ -2660,7 +2721,6 @@ module Aws::S3
2660
2721
  # * `x-amz-server-side-encryption-aws-kms-key-id`
2661
2722
  #
2662
2723
  # * `x-amz-server-side-encryption-context`
2663
- #
2664
2724
  # <note markdown="1"> * If you specify `x-amz-server-side-encryption:aws:kms`, but
2665
2725
  # don't provide `x-amz-server-side-encryption-aws-kms-key-id`,
2666
2726
  # Amazon S3 uses the Amazon Web Services managed key (`aws/s3`
@@ -2672,9 +2732,9 @@ module Aws::S3
2672
2732
  # actions on the key. These permissions are required because
2673
2733
  # Amazon S3 must decrypt and read data from the encrypted file
2674
2734
  # parts before it completes the multipart upload. For more
2675
- # information, see [Multipart upload API and permissions][6] and
2735
+ # information, see [Multipart upload API and permissions][7] and
2676
2736
  # [Protecting data using server-side encryption with Amazon Web
2677
- # Services KMS][7] in the *Amazon S3 User Guide*.
2737
+ # Services KMS][8] in the *Amazon S3 User Guide*.
2678
2738
  #
2679
2739
  # * If your Identity and Access Management (IAM) user or role is
2680
2740
  # in the same Amazon Web Services account as the KMS key, then
@@ -2689,13 +2749,13 @@ module Aws::S3
2689
2749
  # For information about configuring any of the officially
2690
2750
  # supported Amazon Web Services SDKs and Amazon Web Services
2691
2751
  # CLI, see [Specifying the Signature Version in Request
2692
- # Authentication][10] in the *Amazon S3 User Guide*.
2752
+ # Authentication][11] in the *Amazon S3 User Guide*.
2693
2753
  #
2694
2754
  # </note>
2695
2755
  #
2696
2756
  # For more information about server-side encryption with KMS keys
2697
2757
  # (SSE-KMS), see [Protecting Data Using Server-Side Encryption
2698
- # with KMS keys][7] in the *Amazon S3 User Guide*.
2758
+ # with KMS keys][8] in the *Amazon S3 User Guide*.
2699
2759
  #
2700
2760
  # * Use customer-provided encryption keys (SSE-C) – If you want to
2701
2761
  # manage your own encryption keys, provide all the following
@@ -2706,12 +2766,10 @@ module Aws::S3
2706
2766
  # * `x-amz-server-side-encryption-customer-key`
2707
2767
  #
2708
2768
  # * `x-amz-server-side-encryption-customer-key-MD5`
2709
- #
2710
2769
  # For more information about server-side encryption with
2711
2770
  # customer-provided encryption keys (SSE-C), see [ Protecting data
2712
2771
  # using server-side encryption with customer-provided encryption
2713
- # keys (SSE-C)][11] in the *Amazon S3 User Guide*.
2714
- #
2772
+ # keys (SSE-C)][12] in the *Amazon S3 User Guide*.
2715
2773
  # * **Directory buckets** - For directory buckets, there are only two
2716
2774
  # supported options for server-side encryption: server-side
2717
2775
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
@@ -2721,13 +2779,13 @@ module Aws::S3
2721
2779
  # default encryption in your `CreateSession` requests or `PUT`
2722
2780
  # object requests. Then, new objects are automatically encrypted
2723
2781
  # with the desired encryption settings. For more information, see
2724
- # [Protecting data with server-side encryption][12] in the *Amazon
2782
+ # [Protecting data with server-side encryption][13] in the *Amazon
2725
2783
  # S3 User Guide*. For more information about the encryption
2726
2784
  # overriding behaviors in directory buckets, see [Specifying
2727
- # server-side encryption with KMS for new object uploads][13].
2785
+ # server-side encryption with KMS for new object uploads][14].
2728
2786
  #
2729
- # In the Zonal endpoint API calls (except [CopyObject][14] and
2730
- # [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
2731
2789
  # headers must match the encryption settings that are specified in
2732
2790
  # the `CreateSession` request. You can't override the values of the
2733
2791
  # encryption settings (`x-amz-server-side-encryption`,
@@ -2747,7 +2805,7 @@ module Aws::S3
2747
2805
  # configuration for the `CreateSession` request. It's not supported
2748
2806
  # to override the encryption settings values in the `CreateSession`
2749
2807
  # request. So in the Zonal endpoint API calls (except
2750
- # [CopyObject][14] and [UploadPartCopy][9]), the encryption request
2808
+ # [CopyObject][15] and [UploadPartCopy][10]), the encryption request
2751
2809
  # headers must match the default encryption configuration of the
2752
2810
  # directory bucket.
2753
2811
  #
@@ -2763,19 +2821,19 @@ module Aws::S3
2763
2821
  # HTTP Host header syntax
2764
2822
  #
2765
2823
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
2766
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
2824
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
2767
2825
  #
2768
2826
  # The following operations are related to `CreateMultipartUpload`:
2769
2827
  #
2770
2828
  # * [UploadPart][1]
2771
2829
  #
2772
- # * [CompleteMultipartUpload][15]
2830
+ # * [CompleteMultipartUpload][16]
2773
2831
  #
2774
- # * [AbortMultipartUpload][16]
2832
+ # * [AbortMultipartUpload][17]
2775
2833
  #
2776
- # * [ListParts][17]
2834
+ # * [ListParts][18]
2777
2835
  #
2778
- # * [ListMultipartUploads][18]
2836
+ # * [ListMultipartUploads][19]
2779
2837
  #
2780
2838
  #
2781
2839
  #
@@ -2783,20 +2841,21 @@ module Aws::S3
2783
2841
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
2784
2842
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
2785
2843
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2786
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
2787
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
2788
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
2789
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
2790
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
2791
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
2792
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
2793
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
2794
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
2795
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
2796
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
2797
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
2798
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
2799
- # [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
2800
2859
  #
2801
2860
  # @option params [String] :acl
2802
2861
  # The canned ACL to apply to the object. Amazon S3 supports a set of
@@ -2829,10 +2888,10 @@ module Aws::S3
2829
2888
  #
2830
2889
  # **Directory buckets** - When you use this operation with a directory
2831
2890
  # bucket, you must use virtual-hosted-style requests in the format `
2832
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
2833
- # are not supported. Directory bucket names must be unique in the chosen
2834
- # Availability Zone. Bucket names must follow the format `
2835
- # 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, `
2836
2895
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
2837
2896
  # naming restrictions, see [Directory bucket naming rules][1] in the
2838
2897
  # *Amazon S3 User Guide*.
@@ -3529,23 +3588,27 @@ module Aws::S3
3529
3588
  #
3530
3589
  # <note markdown="1"> * You must make requests for this API operation to the Zonal endpoint.
3531
3590
  # These endpoints support virtual-hosted-style requests in the format
3532
- # `https://bucket_name.s3express-az_id.region.amazonaws.com`.
3533
- # Path-style requests are not supported. For more information, see
3534
- # [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*.
3535
3598
  #
3536
3599
  # * <b> <code>CopyObject</code> API operation</b> - Unlike other Zonal
3537
3600
  # endpoint API operations, the `CopyObject` API operation doesn't use
3538
3601
  # the temporary security credentials returned from the `CreateSession`
3539
3602
  # API operation for authentication and authorization. For information
3540
3603
  # about authentication and authorization of the `CopyObject` API
3541
- # operation on directory buckets, see [CopyObject][4].
3604
+ # operation on directory buckets, see [CopyObject][5].
3542
3605
  #
3543
3606
  # * <b> <code>HeadBucket</code> API operation</b> - Unlike other Zonal
3544
3607
  # endpoint API operations, the `HeadBucket` API operation doesn't use
3545
3608
  # the temporary security credentials returned from the `CreateSession`
3546
3609
  # API operation for authentication and authorization. For information
3547
3610
  # about authentication and authorization of the `HeadBucket` API
3548
- # operation on directory buckets, see [HeadBucket][5].
3611
+ # operation on directory buckets, see [HeadBucket][6].
3549
3612
  #
3550
3613
  # </note>
3551
3614
  #
@@ -3557,10 +3620,10 @@ module Aws::S3
3557
3620
  # can have the `s3express:SessionMode` condition key to control who
3558
3621
  # can create a `ReadWrite` or `ReadOnly` session. For more information
3559
3622
  # about `ReadWrite` or `ReadOnly` sessions, see [
3560
- # `x-amz-create-session-mode` ][6]. For example policies, see [Example
3561
- # 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
3562
3625
  # Identity and Access Management (IAM) identity-based policies for S3
3563
- # Express One Zone][8] in the *Amazon S3 User Guide*.
3626
+ # Express One Zone][9] in the *Amazon S3 User Guide*.
3564
3627
  #
3565
3628
  # To grant cross-account access to Zonal endpoint API operations, the
3566
3629
  # bucket policy should also grant both accounts the
@@ -3581,32 +3644,32 @@ module Aws::S3
3581
3644
  # requests or `PUT` object requests. Then, new objects are
3582
3645
  # automatically encrypted with the desired encryption settings. For
3583
3646
  # more information, see [Protecting data with server-side
3584
- # encryption][9] in the *Amazon S3 User Guide*. For more information
3647
+ # encryption][10] in the *Amazon S3 User Guide*. For more information
3585
3648
  # about the encryption overriding behaviors in directory buckets, see
3586
3649
  # [Specifying server-side encryption with KMS for new object
3587
- # uploads][10].
3650
+ # uploads][11].
3588
3651
  #
3589
- # For [Zonal endpoint (object-level) API operations][11] except
3590
- # [CopyObject][4] and [UploadPartCopy][12], you authenticate and
3591
- # 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
3592
3655
  # encrypt new objects in a directory bucket with SSE-KMS, you must
3593
3656
  # specify SSE-KMS as the directory bucket's default encryption
3594
3657
  # configuration with a KMS key (specifically, a [customer managed
3595
- # 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
3596
3659
  # operations, new objects are automatically encrypted and decrypted
3597
3660
  # with SSE-KMS and S3 Bucket Keys during the session.
3598
3661
  #
3599
- # <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
3600
3663
  # for the lifetime of the bucket. The [Amazon Web Services managed
3601
- # 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
3602
3665
  # your bucket's default encryption configuration with a customer
3603
3666
  # managed key, you can't change the customer managed key for the
3604
3667
  # bucket's SSE-KMS configuration.
3605
3668
  #
3606
3669
  # </note>
3607
3670
  #
3608
- # In the Zonal endpoint API calls (except [CopyObject][4] and
3609
- # [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
3610
3673
  # values of the encryption settings (`x-amz-server-side-encryption`,
3611
3674
  # `x-amz-server-side-encryption-aws-kms-key-id`,
3612
3675
  # `x-amz-server-side-encryption-context`, and
@@ -3622,8 +3685,8 @@ module Aws::S3
3622
3685
  # Web Services SDKs use the bucket's default encryption configuration
3623
3686
  # for the `CreateSession` request. It's not supported to override the
3624
3687
  # encryption settings values in the `CreateSession` request. Also, in
3625
- # the Zonal endpoint API calls (except [CopyObject][4] and
3626
- # [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
3627
3690
  # the encryption settings from the `CreateSession` request.
3628
3691
  #
3629
3692
  # </note>
@@ -3631,25 +3694,26 @@ module Aws::S3
3631
3694
  # HTTP Host header syntax
3632
3695
  #
3633
3696
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
3634
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
3697
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
3635
3698
  #
3636
3699
  #
3637
3700
  #
3638
3701
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
3639
3702
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-optimizing-performance-guidelines-design-patterns.html#s3-express-optimizing-performance-session-authentication
3640
3703
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
3641
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
3642
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
3643
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
3644
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
3645
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
3646
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3647
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
3648
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
3649
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
3650
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
3651
- # [14]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
3652
- # [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
3653
3717
  #
3654
3718
  # @option params [String] :session_mode
3655
3719
  # Specifies the mode of the session that will be created, either
@@ -3791,10 +3855,13 @@ module Aws::S3
3791
3855
  # * <b>Directory buckets </b> - For directory buckets, you must make
3792
3856
  # requests for this API operation to the Regional endpoint. These
3793
3857
  # endpoints support path-style requests in the format
3794
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
3858
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
3795
3859
  # Virtual-hosted-style requests aren't supported. For more
3796
- # information, see [Regional and Zonal endpoints][1] in the *Amazon S3
3797
- # 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*.
3798
3865
  #
3799
3866
  # </note>
3800
3867
  #
@@ -3809,39 +3876,41 @@ module Aws::S3
3809
3876
  # performed by the Amazon Web Services account that owns the
3810
3877
  # resource. For more information about directory bucket policies and
3811
3878
  # permissions, see [Amazon Web Services Identity and Access
3812
- # 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
3813
3880
  # User Guide*.
3814
3881
  #
3815
3882
  # HTTP Host header syntax
3816
3883
  #
3817
3884
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
3818
- # `s3express-control.region.amazonaws.com`.
3885
+ # `s3express-control.region-code.amazonaws.com`.
3819
3886
  #
3820
3887
  # The following operations are related to `DeleteBucket`:
3821
3888
  #
3822
- # * [CreateBucket][3]
3889
+ # * [CreateBucket][4]
3823
3890
  #
3824
- # * [DeleteObject][4]
3891
+ # * [DeleteObject][5]
3825
3892
  #
3826
3893
  #
3827
3894
  #
3828
3895
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
3829
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
3830
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
3831
- # [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
3832
3900
  #
3833
3901
  # @option params [required, String] :bucket
3834
3902
  # Specifies the bucket being deleted.
3835
3903
  #
3836
3904
  # <b>Directory buckets </b> - When you use this operation with a
3837
3905
  # directory bucket, you must use path-style requests in the format
3838
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
3906
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
3839
3907
  # Virtual-hosted-style requests aren't supported. Directory bucket
3840
- # names must be unique in the chosen Availability Zone. Bucket names
3841
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
3842
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
3843
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
3844
- # 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*
3845
3914
  #
3846
3915
  #
3847
3916
  #
@@ -3885,7 +3954,7 @@ module Aws::S3
3885
3954
  req.send_request(options)
3886
3955
  end
3887
3956
 
3888
- # <note markdown="1"> This operation is not supported by directory buckets.
3957
+ # <note markdown="1"> This operation is not supported for directory buckets.
3889
3958
  #
3890
3959
  # </note>
3891
3960
  #
@@ -3951,7 +4020,7 @@ module Aws::S3
3951
4020
  req.send_request(options)
3952
4021
  end
3953
4022
 
3954
- # <note markdown="1"> This operation is not supported by directory buckets.
4023
+ # <note markdown="1"> This operation is not supported for directory buckets.
3955
4024
  #
3956
4025
  # </note>
3957
4026
  #
@@ -4050,7 +4119,7 @@ module Aws::S3
4050
4119
  # HTTP Host header syntax
4051
4120
  #
4052
4121
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
4053
- # `s3express-control.region.amazonaws.com`.
4122
+ # `s3express-control.region-code.amazonaws.com`.
4054
4123
  #
4055
4124
  # The following operations are related to `DeleteBucketEncryption`:
4056
4125
  #
@@ -4074,13 +4143,14 @@ module Aws::S3
4074
4143
  #
4075
4144
  # <b>Directory buckets </b> - When you use this operation with a
4076
4145
  # directory bucket, you must use path-style requests in the format
4077
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4146
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4078
4147
  # Virtual-hosted-style requests aren't supported. Directory bucket
4079
- # names must be unique in the chosen Availability Zone. Bucket names
4080
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
4081
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
4082
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
4083
- # 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*
4084
4154
  #
4085
4155
  #
4086
4156
  #
@@ -4115,7 +4185,7 @@ module Aws::S3
4115
4185
  req.send_request(options)
4116
4186
  end
4117
4187
 
4118
- # <note markdown="1"> This operation is not supported by directory buckets.
4188
+ # <note markdown="1"> This operation is not supported for directory buckets.
4119
4189
  #
4120
4190
  # </note>
4121
4191
  #
@@ -4182,7 +4252,7 @@ module Aws::S3
4182
4252
  req.send_request(options)
4183
4253
  end
4184
4254
 
4185
- # <note markdown="1"> This operation is not supported by directory buckets.
4255
+ # <note markdown="1"> This operation is not supported for directory buckets.
4186
4256
  #
4187
4257
  # </note>
4188
4258
  #
@@ -4247,38 +4317,75 @@ module Aws::S3
4247
4317
  req.send_request(options)
4248
4318
  end
4249
4319
 
4250
- # <note markdown="1"> This operation is not supported by directory buckets.
4251
- #
4252
- # </note>
4253
- #
4254
4320
  # Deletes the lifecycle configuration from the specified bucket. Amazon
4255
4321
  # S3 removes all the lifecycle configuration rules in the lifecycle
4256
4322
  # subresource associated with the bucket. Your objects never expire, and
4257
4323
  # Amazon S3 no longer automatically deletes any objects on the basis of
4258
4324
  # rules contained in the deleted lifecycle configuration.
4259
4325
  #
4260
- # To use this operation, you must have permission to perform the
4261
- # `s3:PutLifecycleConfiguration` action. By default, the bucket owner
4262
- # has this permission and the bucket owner can grant this permission to
4263
- # others.
4326
+ # Permissions
4327
+ # : * **General purpose bucket permissions** - By default, all Amazon S3
4328
+ # resources are private, including buckets, objects, and related
4329
+ # subresources (for example, lifecycle configuration and website
4330
+ # configuration). Only the resource owner (that is, the Amazon Web
4331
+ # Services account that created it) can access the resource. The
4332
+ # resource owner can optionally grant access permissions to others
4333
+ # by writing an access policy. For this operation, a user must have
4334
+ # the `s3:PutLifecycleConfiguration` permission.
4335
+ #
4336
+ # For more information about permissions, see [Managing Access
4337
+ # Permissions to Your Amazon S3 Resources][1].
4338
+ # ^
4264
4339
  #
4265
- # There is usually some time lag before lifecycle configuration deletion
4266
- # is fully propagated to all the Amazon S3 systems.
4340
+ # * **Directory bucket permissions** - You must have the
4341
+ # `s3express:PutLifecycleConfiguration` permission in an IAM
4342
+ # identity-based policy to use this operation. Cross-account access
4343
+ # to this API operation isn't supported. The resource owner can
4344
+ # optionally grant access permissions to others by creating a role
4345
+ # or user for them as long as they are within the same account as
4346
+ # the owner and resource.
4347
+ #
4348
+ # For more information about directory bucket policies and
4349
+ # permissions, see [Authorizing Regional endpoint APIs with IAM][2]
4350
+ # in the *Amazon S3 User Guide*.
4351
+ #
4352
+ # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
4353
+ # requests for this API operation to the Regional endpoint. These
4354
+ # endpoints support path-style requests in the format
4355
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
4356
+ # `. Virtual-hosted-style requests aren't supported. For more
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*.
4362
+ #
4363
+ # </note>
4364
+ # ^
4365
+ #
4366
+ # HTTP Host header syntax
4367
+ #
4368
+ # : <b>Directory buckets </b> - The HTTP Host header syntax is
4369
+ # `s3express-control.region.amazonaws.com`.
4267
4370
  #
4268
4371
  # For more information about the object expiration, see [Elements to
4269
- # Describe Lifecycle Actions][1].
4372
+ # Describe Lifecycle Actions][5].
4270
4373
  #
4271
4374
  # Related actions include:
4272
4375
  #
4273
- # * [PutBucketLifecycleConfiguration][2]
4376
+ # * [PutBucketLifecycleConfiguration][6]
4274
4377
  #
4275
- # * [GetBucketLifecycleConfiguration][3]
4378
+ # * [GetBucketLifecycleConfiguration][7]
4276
4379
  #
4277
4380
  #
4278
4381
  #
4279
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
4280
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
4281
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
4382
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
4383
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4384
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.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
4282
4389
  #
4283
4390
  # @option params [required, String] :bucket
4284
4391
  # The bucket name of the lifecycle to delete.
@@ -4288,6 +4395,11 @@ module Aws::S3
4288
4395
  # you provide does not match the actual owner of the bucket, the request
4289
4396
  # fails with the HTTP status code `403 Forbidden` (access denied).
4290
4397
  #
4398
+ # <note markdown="1"> This parameter applies to general purpose buckets only. It is not
4399
+ # supported for directory bucket lifecycle configurations.
4400
+ #
4401
+ # </note>
4402
+ #
4291
4403
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4292
4404
  #
4293
4405
  #
@@ -4315,7 +4427,7 @@ module Aws::S3
4315
4427
  req.send_request(options)
4316
4428
  end
4317
4429
 
4318
- # <note markdown="1"> This operation is not supported by directory buckets.
4430
+ # <note markdown="1"> This operation is not supported for directory buckets.
4319
4431
  #
4320
4432
  # </note>
4321
4433
  #
@@ -4385,7 +4497,7 @@ module Aws::S3
4385
4497
  req.send_request(options)
4386
4498
  end
4387
4499
 
4388
- # <note markdown="1"> This operation is not supported by directory buckets.
4500
+ # <note markdown="1"> This operation is not supported for directory buckets.
4389
4501
  #
4390
4502
  # </note>
4391
4503
  #
@@ -4440,9 +4552,13 @@ module Aws::S3
4440
4552
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
4441
4553
  # requests for this API operation to the Regional endpoint. These
4442
4554
  # endpoints support path-style requests in the format
4443
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4444
- # Virtual-hosted-style requests aren't supported. For more information,
4445
- # 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*.
4446
4562
  #
4447
4563
  # </note>
4448
4564
  #
@@ -4472,7 +4588,7 @@ module Aws::S3
4472
4588
  # * **General purpose bucket permissions** - The
4473
4589
  # `s3:DeleteBucketPolicy` permission is required in a policy. For
4474
4590
  # more information about general purpose buckets bucket policies,
4475
- # 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
4476
4592
  # User Guide*.
4477
4593
  #
4478
4594
  # * **Directory bucket permissions** - To grant access to this API
@@ -4483,39 +4599,41 @@ module Aws::S3
4483
4599
  # Services account that owns the resource. For more information
4484
4600
  # about directory bucket policies and permissions, see [Amazon Web
4485
4601
  # Services Identity and Access Management (IAM) for S3 Express One
4486
- # Zone][3] in the *Amazon S3 User Guide*.
4602
+ # Zone][4] in the *Amazon S3 User Guide*.
4487
4603
  #
4488
4604
  # HTTP Host header syntax
4489
4605
  #
4490
4606
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
4491
- # `s3express-control.region.amazonaws.com`.
4607
+ # `s3express-control.region-code.amazonaws.com`.
4492
4608
  #
4493
4609
  # The following operations are related to `DeleteBucketPolicy`
4494
4610
  #
4495
- # * [CreateBucket][4]
4611
+ # * [CreateBucket][5]
4496
4612
  #
4497
- # * [DeleteObject][5]
4613
+ # * [DeleteObject][6]
4498
4614
  #
4499
4615
  #
4500
4616
  #
4501
4617
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4502
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
4503
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4504
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
4505
- # [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
4506
4623
  #
4507
4624
  # @option params [required, String] :bucket
4508
4625
  # The bucket name.
4509
4626
  #
4510
4627
  # <b>Directory buckets </b> - When you use this operation with a
4511
4628
  # directory bucket, you must use path-style requests in the format
4512
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
4629
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
4513
4630
  # Virtual-hosted-style requests aren't supported. Directory bucket
4514
- # names must be unique in the chosen Availability Zone. Bucket names
4515
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
4516
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
4517
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
4518
- # 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*
4519
4637
  #
4520
4638
  #
4521
4639
  #
@@ -4559,7 +4677,7 @@ module Aws::S3
4559
4677
  req.send_request(options)
4560
4678
  end
4561
4679
 
4562
- # <note markdown="1"> This operation is not supported by directory buckets.
4680
+ # <note markdown="1"> This operation is not supported for directory buckets.
4563
4681
  #
4564
4682
  # </note>
4565
4683
  #
@@ -4629,7 +4747,7 @@ module Aws::S3
4629
4747
  req.send_request(options)
4630
4748
  end
4631
4749
 
4632
- # <note markdown="1"> This operation is not supported by directory buckets.
4750
+ # <note markdown="1"> This operation is not supported for directory buckets.
4633
4751
  #
4634
4752
  # </note>
4635
4753
  #
@@ -4685,7 +4803,7 @@ module Aws::S3
4685
4803
  req.send_request(options)
4686
4804
  end
4687
4805
 
4688
- # <note markdown="1"> This operation is not supported by directory buckets.
4806
+ # <note markdown="1"> This operation is not supported for directory buckets.
4689
4807
  #
4690
4808
  # </note>
4691
4809
  #
@@ -4754,33 +4872,71 @@ module Aws::S3
4754
4872
  end
4755
4873
 
4756
4874
  # Removes an object from a bucket. The behavior depends on the bucket's
4757
- # versioning state. For more information, see [Best practices to
4758
- # 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>
4759
4914
  #
4760
4915
  # To remove a specific version, you must use the `versionId` query
4761
4916
  # parameter. Using this query parameter permanently deletes the version.
4762
4917
  # If the object deleted is a delete marker, Amazon S3 sets the response
4763
- # header `x-amz-delete-marker` to true. If the object you want to delete
4764
- # is in a bucket where the bucket versioning configuration is MFA delete
4765
- # enabled, you must include the `x-amz-mfa` request header in the DELETE
4766
- # `versionId` request. Requests that include `x-amz-mfa` must use HTTPS.
4767
- # For more information about MFA delete and to see example requests, see
4768
- # [Using MFA delete][2] and [Sample request][3] in the *Amazon S3 User
4769
- # Guide*.
4918
+ # header `x-amz-delete-marker` to true.
4770
4919
  #
4771
- # <note markdown="1"> * S3 Versioning isn't enabled and supported for directory buckets.
4772
- # For this API operation, only the `null` value of the version ID is
4773
- # supported by directory buckets. You can only specify `null` to the
4774
- # `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].
4775
4926
  #
4776
- # * For directory buckets, you must make requests for this API operation
4777
- # to the Zonal endpoint. These endpoints support virtual-hosted-style
4778
- # requests in the format
4779
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
4780
- # `. Path-style requests are not supported. For more information, see
4781
- # [Regional and Zonal endpoints][4] in the *Amazon S3 User Guide*.
4927
+ # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
4928
+ # buckets.
4929
+ #
4930
+ # </note>
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.
4782
4937
  #
4783
- # * MFA delete is not supported by directory buckets.
4938
+ # <note markdown="1"> **Directory buckets** - S3 Lifecycle is not supported by directory
4939
+ # buckets.
4784
4940
  #
4785
4941
  # </note>
4786
4942
  #
@@ -4792,52 +4948,56 @@ module Aws::S3
4792
4948
  # * <b> <code>s3:DeleteObject</code> </b> - To delete an object from
4793
4949
  # a bucket, you must always have the `s3:DeleteObject` permission.
4794
4950
  #
4795
- # <note markdown="1"> You can also use PutBucketLifecycle to delete objects in Amazon
4796
- # S3.
4797
- #
4798
- # </note>
4799
- #
4800
4951
  # * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
4801
4952
  # specific version of an object from a versioning-enabled bucket,
4802
4953
  # you must have the `s3:DeleteObjectVersion` permission.
4803
- #
4804
- # * If you want to block users or accounts from removing or deleting
4805
- # objects from your bucket, you must deny them the
4806
- # `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
4807
- # `s3:PutLifeCycleConfiguration` permissions.
4808
- #
4809
- # * **Directory buckets permissions** - To grant access to this API
4810
- # operation on a directory bucket, we recommend that you use the
4811
- # 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].
4812
4968
  #
4813
4969
  # HTTP Host header syntax
4814
4970
  #
4815
4971
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
4816
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
4972
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
4817
4973
  #
4818
4974
  # The following action is related to `DeleteObject`:
4819
4975
  #
4820
- # * [PutObject][5]
4976
+ # * [PutObject][9]
4821
4977
  #
4822
4978
  # ^
4823
4979
  #
4824
4980
  #
4825
4981
  #
4826
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjects.html#DeletingObjects-best-practices
4827
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
4828
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
4829
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4830
- # [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
4831
4991
  #
4832
4992
  # @option params [required, String] :bucket
4833
4993
  # The bucket name of the bucket containing the object.
4834
4994
  #
4835
4995
  # **Directory buckets** - When you use this operation with a directory
4836
4996
  # bucket, you must use virtual-hosted-style requests in the format `
4837
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
4838
- # are not supported. Directory bucket names must be unique in the chosen
4839
- # Availability Zone. Bucket names must follow the format `
4840
- # 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, `
4841
5001
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4842
5002
  # naming restrictions, see [Directory bucket naming rules][1] in the
4843
5003
  # *Amazon S3 User Guide*.
@@ -4925,6 +5085,49 @@ module Aws::S3
4925
5085
  # you provide does not match the actual owner of the bucket, the request
4926
5086
  # fails with the HTTP status code `403 Forbidden` (access denied).
4927
5087
  #
5088
+ # @option params [String] :if_match
5089
+ # The `If-Match` header field makes the request method conditional on
5090
+ # ETags. If the ETag value does not match, the operation returns a `412
5091
+ # Precondition Failed` error. If the ETag matches or if the object
5092
+ # doesn't exist, the operation will return a `204 Success (No Content)
5093
+ # response`.
5094
+ #
5095
+ # For more information about conditional requests, see [RFC 7232][1].
5096
+ #
5097
+ # <note markdown="1"> This functionality is only supported for directory buckets.
5098
+ #
5099
+ # </note>
5100
+ #
5101
+ #
5102
+ #
5103
+ # [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
5104
+ #
5105
+ # @option params [Time,DateTime,Date,Integer,String] :if_match_last_modified_time
5106
+ # If present, the object is deleted only if its modification times
5107
+ # matches the provided `Timestamp`. If the `Timestamp` values do not
5108
+ # match, the operation returns a `412 Precondition Failed` error. If the
5109
+ # `Timestamp` matches or if the object doesn’t exist, the operation
5110
+ # returns a `204 Success (No Content)` response.
5111
+ #
5112
+ # <note markdown="1"> This functionality is only supported for directory buckets.
5113
+ #
5114
+ # </note>
5115
+ #
5116
+ # @option params [Integer] :if_match_size
5117
+ # If present, the object is deleted only if its size matches the
5118
+ # provided size in bytes. If the `Size` value does not match, the
5119
+ # operation returns a `412 Precondition Failed` error. If the `Size`
5120
+ # matches or if the object doesn’t exist, the operation returns a `204
5121
+ # Success (No Content)` response.
5122
+ #
5123
+ # <note markdown="1"> This functionality is only supported for directory buckets.
5124
+ #
5125
+ # </note>
5126
+ #
5127
+ # You can use the `If-Match`, `x-amz-if-match-last-modified-time` and
5128
+ # `x-amz-if-match-size` conditional headers in conjunction with
5129
+ # each-other or individually.
5130
+ #
4928
5131
  # @return [Types::DeleteObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4929
5132
  #
4930
5133
  # * {Types::DeleteObjectOutput#delete_marker #delete_marker} => Boolean
@@ -4932,15 +5135,6 @@ module Aws::S3
4932
5135
  # * {Types::DeleteObjectOutput#request_charged #request_charged} => String
4933
5136
  #
4934
5137
  #
4935
- # @example Example: To delete an object (from a non-versioned bucket)
4936
- #
4937
- # # The following example deletes an object from a non-versioned bucket.
4938
- #
4939
- # resp = client.delete_object({
4940
- # bucket: "ExampleBucket",
4941
- # key: "HappyFace.jpg",
4942
- # })
4943
- #
4944
5138
  # @example Example: To delete an object
4945
5139
  #
4946
5140
  # # The following example deletes an object from an S3 bucket.
@@ -4954,6 +5148,15 @@ module Aws::S3
4954
5148
  # {
4955
5149
  # }
4956
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
+ #
4957
5160
  # @example Request syntax with placeholder values
4958
5161
  #
4959
5162
  # resp = client.delete_object({
@@ -4964,6 +5167,9 @@ module Aws::S3
4964
5167
  # request_payer: "requester", # accepts requester
4965
5168
  # bypass_governance_retention: false,
4966
5169
  # expected_bucket_owner: "AccountId",
5170
+ # if_match: "IfMatch",
5171
+ # if_match_last_modified_time: Time.now,
5172
+ # if_match_size: 1,
4967
5173
  # })
4968
5174
  #
4969
5175
  # @example Response structure
@@ -4981,7 +5187,7 @@ module Aws::S3
4981
5187
  req.send_request(options)
4982
5188
  end
4983
5189
 
4984
- # <note markdown="1"> This operation is not supported by directory buckets.
5190
+ # <note markdown="1"> This operation is not supported for directory buckets.
4985
5191
  #
4986
5192
  # </note>
4987
5193
  #
@@ -5124,9 +5330,13 @@ module Aws::S3
5124
5330
  # * **Directory buckets** - For directory buckets, you must make
5125
5331
  # requests for this API operation to the Zonal endpoint. These
5126
5332
  # endpoints support virtual-hosted-style requests in the format
5127
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
5128
- # `. Path-style requests are not supported. For more information, see
5129
- # [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*.
5130
5340
  #
5131
5341
  # </note>
5132
5342
  #
@@ -5144,7 +5354,7 @@ module Aws::S3
5144
5354
  # if there are non-versioned objects you are trying to delete. If you
5145
5355
  # provide an invalid token, whether there are versioned keys in the
5146
5356
  # request or not, the entire Multi-Object Delete request will fail. For
5147
- # 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
5148
5358
  # User Guide*.
5149
5359
  #
5150
5360
  # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
@@ -5164,10 +5374,9 @@ module Aws::S3
5164
5374
  # * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
5165
5375
  # specific version of an object from a versioning-enabled bucket,
5166
5376
  # you must specify the `s3:DeleteObjectVersion` permission.
5167
- #
5168
5377
  # * **Directory bucket permissions** - To grant access to this API
5169
5378
  # operation on a directory bucket, we recommend that you use the [
5170
- # `CreateSession` ][3] API operation for session-based
5379
+ # `CreateSession` ][4] API operation for session-based
5171
5380
  # authorization. Specifically, you grant the
5172
5381
  # `s3express:CreateSession` permission to the directory bucket in a
5173
5382
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -5178,7 +5387,7 @@ module Aws::S3
5178
5387
  # token for use. Amazon Web Services CLI or SDKs create session and
5179
5388
  # refresh the session token automatically to avoid service
5180
5389
  # interruptions when a session expires. For more information about
5181
- # authorization, see [ `CreateSession` ][3].
5390
+ # authorization, see [ `CreateSession` ][4].
5182
5391
  #
5183
5392
  # Content-MD5 request header
5184
5393
  # : * **General purpose bucket** - The Content-MD5 request header is
@@ -5195,40 +5404,41 @@ module Aws::S3
5195
5404
  # HTTP Host header syntax
5196
5405
  #
5197
5406
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
5198
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
5407
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
5199
5408
  #
5200
5409
  # The following operations are related to `DeleteObjects`:
5201
5410
  #
5202
- # * [CreateMultipartUpload][4]
5411
+ # * [CreateMultipartUpload][5]
5203
5412
  #
5204
- # * [UploadPart][5]
5413
+ # * [UploadPart][6]
5205
5414
  #
5206
- # * [CompleteMultipartUpload][6]
5415
+ # * [CompleteMultipartUpload][7]
5207
5416
  #
5208
- # * [ListParts][7]
5417
+ # * [ListParts][8]
5209
5418
  #
5210
- # * [AbortMultipartUpload][8]
5419
+ # * [AbortMultipartUpload][9]
5211
5420
  #
5212
5421
  #
5213
5422
  #
5214
5423
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
5215
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
5216
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
5217
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
5218
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
5219
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
5220
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
5221
- # [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
5222
5432
  #
5223
5433
  # @option params [required, String] :bucket
5224
5434
  # The bucket name containing the objects to delete.
5225
5435
  #
5226
5436
  # **Directory buckets** - When you use this operation with a directory
5227
5437
  # bucket, you must use virtual-hosted-style requests in the format `
5228
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
5229
- # are not supported. Directory bucket names must be unique in the chosen
5230
- # Availability Zone. Bucket names must follow the format `
5231
- # 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, `
5232
5442
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
5233
5443
  # naming restrictions, see [Directory bucket naming rules][1] in the
5234
5444
  # *Amazon S3 User Guide*.
@@ -5444,6 +5654,9 @@ module Aws::S3
5444
5654
  # {
5445
5655
  # key: "ObjectKey", # required
5446
5656
  # version_id: "ObjectVersionId",
5657
+ # etag: "ETag",
5658
+ # last_modified_time: Time.now,
5659
+ # size: 1,
5447
5660
  # },
5448
5661
  # ],
5449
5662
  # quiet: false,
@@ -5478,7 +5691,7 @@ module Aws::S3
5478
5691
  req.send_request(options)
5479
5692
  end
5480
5693
 
5481
- # <note markdown="1"> This operation is not supported by directory buckets.
5694
+ # <note markdown="1"> This operation is not supported for directory buckets.
5482
5695
  #
5483
5696
  # </note>
5484
5697
  #
@@ -5535,7 +5748,7 @@ module Aws::S3
5535
5748
  req.send_request(options)
5536
5749
  end
5537
5750
 
5538
- # <note markdown="1"> This operation is not supported by directory buckets.
5751
+ # <note markdown="1"> This operation is not supported for directory buckets.
5539
5752
  #
5540
5753
  # </note>
5541
5754
  #
@@ -5631,7 +5844,7 @@ module Aws::S3
5631
5844
  req.send_request(options)
5632
5845
  end
5633
5846
 
5634
- # <note markdown="1"> This operation is not supported by directory buckets.
5847
+ # <note markdown="1"> This operation is not supported for directory buckets.
5635
5848
  #
5636
5849
  # </note>
5637
5850
  #
@@ -5727,7 +5940,7 @@ module Aws::S3
5727
5940
  req.send_request(options)
5728
5941
  end
5729
5942
 
5730
- # <note markdown="1"> This operation is not supported by directory buckets.
5943
+ # <note markdown="1"> This operation is not supported for directory buckets.
5731
5944
  #
5732
5945
  # </note>
5733
5946
  #
@@ -5813,7 +6026,7 @@ module Aws::S3
5813
6026
  req.send_request(options)
5814
6027
  end
5815
6028
 
5816
- # <note markdown="1"> This operation is not supported by directory buckets.
6029
+ # <note markdown="1"> This operation is not supported for directory buckets.
5817
6030
  #
5818
6031
  # </note>
5819
6032
  #
@@ -5972,7 +6185,7 @@ module Aws::S3
5972
6185
  # HTTP Host header syntax
5973
6186
  #
5974
6187
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
5975
- # `s3express-control.region.amazonaws.com`.
6188
+ # `s3express-control.region-code.amazonaws.com`.
5976
6189
  #
5977
6190
  # The following operations are related to `GetBucketEncryption`:
5978
6191
  #
@@ -5996,13 +6209,14 @@ module Aws::S3
5996
6209
  #
5997
6210
  # <b>Directory buckets </b> - When you use this operation with a
5998
6211
  # directory bucket, you must use path-style requests in the format
5999
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
6212
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
6000
6213
  # Virtual-hosted-style requests aren't supported. Directory bucket
6001
- # names must be unique in the chosen Availability Zone. Bucket names
6002
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
6003
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
6004
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
6005
- # 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*
6006
6220
  #
6007
6221
  #
6008
6222
  #
@@ -6046,7 +6260,7 @@ module Aws::S3
6046
6260
  req.send_request(options)
6047
6261
  end
6048
6262
 
6049
- # <note markdown="1"> This operation is not supported by directory buckets.
6263
+ # <note markdown="1"> This operation is not supported for directory buckets.
6050
6264
  #
6051
6265
  # </note>
6052
6266
  #
@@ -6130,7 +6344,7 @@ module Aws::S3
6130
6344
  req.send_request(options)
6131
6345
  end
6132
6346
 
6133
- # <note markdown="1"> This operation is not supported by directory buckets.
6347
+ # <note markdown="1"> This operation is not supported for directory buckets.
6134
6348
  #
6135
6349
  # </note>
6136
6350
  #
@@ -6219,7 +6433,7 @@ module Aws::S3
6219
6433
  # version of this topic. This topic is provided for backward
6220
6434
  # compatibility.
6221
6435
  #
6222
- # <note markdown="1"> This operation is not supported by directory buckets.
6436
+ # <note markdown="1"> This operation is not supported for directory buckets.
6223
6437
  #
6224
6438
  # </note>
6225
6439
  #
@@ -6331,34 +6545,68 @@ module Aws::S3
6331
6545
  req.send_request(options)
6332
6546
  end
6333
6547
 
6334
- # <note markdown="1"> This operation is not supported by directory buckets.
6335
- #
6336
- # </note>
6548
+ # Returns the lifecycle configuration information set on the bucket. For
6549
+ # information about lifecycle configuration, see [Object Lifecycle
6550
+ # Management][1].
6337
6551
  #
6338
- # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
6552
+ # Bucket lifecycle configuration now supports specifying a lifecycle
6339
6553
  # rule using an object key name prefix, one or more object tags, object
6340
6554
  # size, or any combination of these. Accordingly, this section describes
6341
- # the latest API. The previous version of the API supported filtering
6342
- # based only on an object key name prefix, which is supported for
6343
- # backward compatibility. For the related API description, see
6344
- # [GetBucketLifecycle][1]. Accordingly, this section describes the
6345
- # latest API. The response describes the new filter element that you can
6346
- # use to specify a filter to select a subset of objects to which the
6347
- # rule applies. If you are using a previous version of the lifecycle
6348
- # configuration, it still works. For the earlier action,
6555
+ # the latest API, which is compatible with the new functionality. The
6556
+ # previous version of the API supported filtering based only on an
6557
+ # object key name prefix, which is supported for general purpose buckets
6558
+ # for backward compatibility. For the related API description, see
6559
+ # [GetBucketLifecycle][2].
6560
+ #
6561
+ # <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
6562
+ # objects and cancelling multipart uploads. Expiring of versioned
6563
+ # objects, transitions and tag filters are not supported.
6349
6564
  #
6350
6565
  # </note>
6351
6566
  #
6352
- # Returns the lifecycle configuration information set on the bucket. For
6353
- # information about lifecycle configuration, see [Object Lifecycle
6354
- # Management][2].
6567
+ # Permissions
6568
+ # : * **General purpose bucket permissions** - By default, all Amazon S3
6569
+ # resources are private, including buckets, objects, and related
6570
+ # subresources (for example, lifecycle configuration and website
6571
+ # configuration). Only the resource owner (that is, the Amazon Web
6572
+ # Services account that created it) can access the resource. The
6573
+ # resource owner can optionally grant access permissions to others
6574
+ # by writing an access policy. For this operation, a user must have
6575
+ # the `s3:GetLifecycleConfiguration` permission.
6576
+ #
6577
+ # For more information about permissions, see [Managing Access
6578
+ # Permissions to Your Amazon S3 Resources][3].
6579
+ # ^
6355
6580
  #
6356
- # To use this operation, you must have permission to perform the
6357
- # `s3:GetLifecycleConfiguration` action. The bucket owner has this
6358
- # permission, by default. The bucket owner can grant this permission to
6359
- # others. For more information about permissions, see [Permissions
6360
- # Related to Bucket Subresource Operations][3] and [Managing Access
6361
- # Permissions to Your Amazon S3 Resources][4].
6581
+ # * **Directory bucket permissions** - You must have the
6582
+ # `s3express:GetLifecycleConfiguration` permission in an IAM
6583
+ # identity-based policy to use this operation. Cross-account access
6584
+ # to this API operation isn't supported. The resource owner can
6585
+ # optionally grant access permissions to others by creating a role
6586
+ # or user for them as long as they are within the same account as
6587
+ # the owner and resource.
6588
+ #
6589
+ # For more information about directory bucket policies and
6590
+ # permissions, see [Authorizing Regional endpoint APIs with IAM][4]
6591
+ # in the *Amazon S3 User Guide*.
6592
+ #
6593
+ # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
6594
+ # requests for this API operation to the Regional endpoint. These
6595
+ # endpoints support path-style requests in the format
6596
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
6597
+ # `. Virtual-hosted-style requests aren't supported. For more
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*.
6603
+ #
6604
+ # </note>
6605
+ #
6606
+ # HTTP Host header syntax
6607
+ #
6608
+ # : <b>Directory buckets </b> - The HTTP Host header syntax is
6609
+ # `s3express-control.region.amazonaws.com`.
6362
6610
  #
6363
6611
  # `GetBucketLifecycleConfiguration` has the following special error:
6364
6612
  #
@@ -6373,20 +6621,22 @@ module Aws::S3
6373
6621
  # The following operations are related to
6374
6622
  # `GetBucketLifecycleConfiguration`:
6375
6623
  #
6376
- # * [GetBucketLifecycle][1]
6624
+ # * [GetBucketLifecycle][2]
6377
6625
  #
6378
- # * [PutBucketLifecycle][5]
6626
+ # * [PutBucketLifecycle][7]
6379
6627
  #
6380
- # * [DeleteBucketLifecycle][6]
6628
+ # * [DeleteBucketLifecycle][8]
6381
6629
  #
6382
6630
  #
6383
6631
  #
6384
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
6385
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
6386
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6387
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6388
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
6389
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
6632
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
6633
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
6634
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6635
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
6636
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.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
6390
6640
  #
6391
6641
  # @option params [required, String] :bucket
6392
6642
  # The name of the bucket for which to get the lifecycle information.
@@ -6396,6 +6646,11 @@ module Aws::S3
6396
6646
  # you provide does not match the actual owner of the bucket, the request
6397
6647
  # fails with the HTTP status code `403 Forbidden` (access denied).
6398
6648
  #
6649
+ # <note markdown="1"> This parameter applies to general purpose buckets only. It is not
6650
+ # supported for directory bucket lifecycle configurations.
6651
+ #
6652
+ # </note>
6653
+ #
6399
6654
  # @return [Types::GetBucketLifecycleConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6400
6655
  #
6401
6656
  # * {Types::GetBucketLifecycleConfigurationOutput#rules #rules} => Array&lt;Types::LifecycleRule&gt;
@@ -6476,7 +6731,7 @@ module Aws::S3
6476
6731
  req.send_request(options)
6477
6732
  end
6478
6733
 
6479
- # <note markdown="1"> This operation is not supported by directory buckets.
6734
+ # <note markdown="1"> This operation is not supported for directory buckets.
6480
6735
  #
6481
6736
  # </note>
6482
6737
  #
@@ -6573,7 +6828,7 @@ module Aws::S3
6573
6828
  req.send_request(options)
6574
6829
  end
6575
6830
 
6576
- # <note markdown="1"> This operation is not supported by directory buckets.
6831
+ # <note markdown="1"> This operation is not supported for directory buckets.
6577
6832
  #
6578
6833
  # </note>
6579
6834
  #
@@ -6632,7 +6887,7 @@ module Aws::S3
6632
6887
  req.send_request(options)
6633
6888
  end
6634
6889
 
6635
- # <note markdown="1"> This operation is not supported by directory buckets.
6890
+ # <note markdown="1"> This operation is not supported for directory buckets.
6636
6891
  #
6637
6892
  # </note>
6638
6893
  #
@@ -6718,7 +6973,7 @@ module Aws::S3
6718
6973
  req.send_request(options)
6719
6974
  end
6720
6975
 
6721
- # <note markdown="1"> This operation is not supported by directory buckets.
6976
+ # <note markdown="1"> This operation is not supported for directory buckets.
6722
6977
  #
6723
6978
  # </note>
6724
6979
  #
@@ -6849,7 +7104,7 @@ module Aws::S3
6849
7104
  req.send_request(options)
6850
7105
  end
6851
7106
 
6852
- # <note markdown="1"> This operation is not supported by directory buckets.
7107
+ # <note markdown="1"> This operation is not supported for directory buckets.
6853
7108
  #
6854
7109
  # </note>
6855
7110
  #
@@ -6964,7 +7219,7 @@ module Aws::S3
6964
7219
  req.send_request(options)
6965
7220
  end
6966
7221
 
6967
- # <note markdown="1"> This operation is not supported by directory buckets.
7222
+ # <note markdown="1"> This operation is not supported for directory buckets.
6968
7223
  #
6969
7224
  # </note>
6970
7225
  #
@@ -7026,9 +7281,13 @@ module Aws::S3
7026
7281
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
7027
7282
  # requests for this API operation to the Regional endpoint. These
7028
7283
  # endpoints support path-style requests in the format
7029
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
7030
- # Virtual-hosted-style requests aren't supported. For more information,
7031
- # 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*.
7032
7291
  #
7033
7292
  # </note>
7034
7293
  #
@@ -7058,7 +7317,7 @@ module Aws::S3
7058
7317
  # * **General purpose bucket permissions** - The `s3:GetBucketPolicy`
7059
7318
  # permission is required in a policy. For more information about
7060
7319
  # general purpose buckets bucket policies, see [Using Bucket
7061
- # Policies and User Policies][2] in the *Amazon S3 User Guide*.
7320
+ # Policies and User Policies][3] in the *Amazon S3 User Guide*.
7062
7321
  #
7063
7322
  # * **Directory bucket permissions** - To grant access to this API
7064
7323
  # operation, you must have the `s3express:GetBucketPolicy`
@@ -7068,48 +7327,50 @@ module Aws::S3
7068
7327
  # Services account that owns the resource. For more information
7069
7328
  # about directory bucket policies and permissions, see [Amazon Web
7070
7329
  # Services Identity and Access Management (IAM) for S3 Express One
7071
- # Zone][3] in the *Amazon S3 User Guide*.
7330
+ # Zone][4] in the *Amazon S3 User Guide*.
7072
7331
  #
7073
7332
  # Example bucket policies
7074
7333
  #
7075
7334
  # : **General purpose buckets example bucket policies** - See [Bucket
7076
- # policy examples][4] in the *Amazon S3 User Guide*.
7335
+ # policy examples][5] in the *Amazon S3 User Guide*.
7077
7336
  #
7078
7337
  # **Directory bucket example bucket policies** - See [Example bucket
7079
- # 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*.
7080
7339
  #
7081
7340
  # HTTP Host header syntax
7082
7341
  #
7083
7342
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
7084
- # `s3express-control.region.amazonaws.com`.
7343
+ # `s3express-control.region-code.amazonaws.com`.
7085
7344
  #
7086
7345
  # The following action is related to `GetBucketPolicy`:
7087
7346
  #
7088
- # * [GetObject][6]
7347
+ # * [GetObject][7]
7089
7348
  #
7090
7349
  # ^
7091
7350
  #
7092
7351
  #
7093
7352
  #
7094
7353
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
7095
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
7096
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
7097
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
7098
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
7099
- # [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
7100
7360
  #
7101
7361
  # @option params [required, String] :bucket
7102
7362
  # The bucket name to get the bucket policy for.
7103
7363
  #
7104
7364
  # <b>Directory buckets </b> - When you use this operation with a
7105
7365
  # directory bucket, you must use path-style requests in the format
7106
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
7366
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
7107
7367
  # Virtual-hosted-style requests aren't supported. Directory bucket
7108
- # names must be unique in the chosen Availability Zone. Bucket names
7109
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
7110
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
7111
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
7112
- # 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*
7113
7374
  #
7114
7375
  # **Access points** - When you use this API operation with an access
7115
7376
  # point, provide the alias of the access point in place of the bucket
@@ -7181,7 +7442,7 @@ module Aws::S3
7181
7442
  req.send_request(options, &block)
7182
7443
  end
7183
7444
 
7184
- # <note markdown="1"> This operation is not supported by directory buckets.
7445
+ # <note markdown="1"> This operation is not supported for directory buckets.
7185
7446
  #
7186
7447
  # </note>
7187
7448
  #
@@ -7246,7 +7507,7 @@ module Aws::S3
7246
7507
  req.send_request(options)
7247
7508
  end
7248
7509
 
7249
- # <note markdown="1"> This operation is not supported by directory buckets.
7510
+ # <note markdown="1"> This operation is not supported for directory buckets.
7250
7511
  #
7251
7512
  # </note>
7252
7513
  #
@@ -7369,7 +7630,7 @@ module Aws::S3
7369
7630
  req.send_request(options)
7370
7631
  end
7371
7632
 
7372
- # <note markdown="1"> This operation is not supported by directory buckets.
7633
+ # <note markdown="1"> This operation is not supported for directory buckets.
7373
7634
  #
7374
7635
  # </note>
7375
7636
  #
@@ -7435,7 +7696,7 @@ module Aws::S3
7435
7696
  req.send_request(options)
7436
7697
  end
7437
7698
 
7438
- # <note markdown="1"> This operation is not supported by directory buckets.
7699
+ # <note markdown="1"> This operation is not supported for directory buckets.
7439
7700
  #
7440
7701
  # </note>
7441
7702
  #
@@ -7521,7 +7782,7 @@ module Aws::S3
7521
7782
  req.send_request(options)
7522
7783
  end
7523
7784
 
7524
- # <note markdown="1"> This operation is not supported by directory buckets.
7785
+ # <note markdown="1"> This operation is not supported for directory buckets.
7525
7786
  #
7526
7787
  # </note>
7527
7788
  #
@@ -7598,7 +7859,7 @@ module Aws::S3
7598
7859
  req.send_request(options)
7599
7860
  end
7600
7861
 
7601
- # <note markdown="1"> This operation is not supported by directory buckets.
7862
+ # <note markdown="1"> This operation is not supported for directory buckets.
7602
7863
  #
7603
7864
  # </note>
7604
7865
  #
@@ -7712,9 +7973,13 @@ module Aws::S3
7712
7973
  # `/photos/2006/February/sample.jpg`. Also, when you make requests to
7713
7974
  # this API operation, your requests are sent to the Zonal endpoint.
7714
7975
  # These endpoints support virtual-hosted-style requests in the format
7715
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
7716
- # Path-style requests are not supported. For more information, see
7717
- # [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*.
7718
7983
  #
7719
7984
  # Permissions
7720
7985
  # : * **General purpose bucket permissions** - You must have the
@@ -7722,7 +7987,7 @@ module Aws::S3
7722
7987
  # have the `READ` access to the object (or version). If you grant
7723
7988
  # `READ` access to the anonymous user, the `GetObject` operation
7724
7989
  # returns the object without using an authorization header. For more
7725
- # information, see [Specifying permissions in a policy][3] in the
7990
+ # information, see [Specifying permissions in a policy][4] in the
7726
7991
  # *Amazon S3 User Guide*.
7727
7992
  #
7728
7993
  # If you include a `versionId` in your request header, you must have
@@ -7744,10 +8009,9 @@ module Aws::S3
7744
8009
  #
7745
8010
  # * If you don’t have the `s3:ListBucket` permission, Amazon S3
7746
8011
  # returns an HTTP status code `403 Access Denied` error.
7747
- #
7748
8012
  # * **Directory bucket permissions** - To grant access to this API
7749
8013
  # operation on a directory bucket, we recommend that you use the [
7750
- # `CreateSession` ][4] API operation for session-based
8014
+ # `CreateSession` ][5] API operation for session-based
7751
8015
  # authorization. Specifically, you grant the
7752
8016
  # `s3express:CreateSession` permission to the directory bucket in a
7753
8017
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -7758,7 +8022,7 @@ module Aws::S3
7758
8022
  # token for use. Amazon Web Services CLI or SDKs create session and
7759
8023
  # refresh the session token automatically to avoid service
7760
8024
  # interruptions when a session expires. For more information about
7761
- # authorization, see [ `CreateSession` ][4].
8025
+ # authorization, see [ `CreateSession` ][5].
7762
8026
  #
7763
8027
  # If the object is encrypted using SSE-KMS, you must also have the
7764
8028
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -7771,9 +8035,9 @@ module Aws::S3
7771
8035
  # storage class, the S3 Intelligent-Tiering Archive Access tier, or
7772
8036
  # the S3 Intelligent-Tiering Deep Archive Access tier, before you can
7773
8037
  # retrieve the object you must first restore a copy using
7774
- # [RestoreObject][5]. Otherwise, this operation returns an
8038
+ # [RestoreObject][6]. Otherwise, this operation returns an
7775
8039
  # `InvalidObjectState` error. For information about restoring archived
7776
- # objects, see [Restoring Archived Objects][6] in the *Amazon S3 User
8040
+ # objects, see [Restoring Archived Objects][7] in the *Amazon S3 User
7777
8041
  # Guide*.
7778
8042
  #
7779
8043
  # <b>Directory buckets </b> - For directory buckets, only the S3
@@ -7795,7 +8059,7 @@ module Aws::S3
7795
8059
  # **Directory buckets** - For directory buckets, there are only two
7796
8060
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
7797
8061
  # SSE-C isn't supported. For more information, see [Protecting data
7798
- # with server-side encryption][7] in the *Amazon S3 User Guide*.
8062
+ # with server-side encryption][8] in the *Amazon S3 User Guide*.
7799
8063
  #
7800
8064
  # Overriding response header values through the request
7801
8065
  #
@@ -7840,25 +8104,26 @@ module Aws::S3
7840
8104
  # HTTP Host header syntax
7841
8105
  #
7842
8106
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
7843
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
8107
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
7844
8108
  #
7845
8109
  # The following operations are related to `GetObject`:
7846
8110
  #
7847
- # * [ListBuckets][8]
8111
+ # * [ListBuckets][9]
7848
8112
  #
7849
- # * [GetObjectAcl][9]
8113
+ # * [GetObjectAcl][10]
7850
8114
  #
7851
8115
  #
7852
8116
  #
7853
8117
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
7854
8118
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
7855
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
7856
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
7857
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
7858
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
7859
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
7860
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
7861
- # [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
7862
8127
  #
7863
8128
  # @option params [String, IO] :response_target
7864
8129
  # Where to write response data, file path, or IO object.
@@ -7868,10 +8133,10 @@ module Aws::S3
7868
8133
  #
7869
8134
  # **Directory buckets** - When you use this operation with a directory
7870
8135
  # bucket, you must use virtual-hosted-style requests in the format `
7871
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
7872
- # are not supported. Directory bucket names must be unique in the chosen
7873
- # Availability Zone. Bucket names must follow the format `
7874
- # 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, `
7875
8140
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7876
8141
  # naming restrictions, see [Directory bucket naming rules][1] in the
7877
8142
  # *Amazon S3 User Guide*.
@@ -8223,7 +8488,7 @@ module Aws::S3
8223
8488
  # content_range: "bytes 0-9/43",
8224
8489
  # content_type: "text/plain",
8225
8490
  # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
8226
- # last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
8491
+ # last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
8227
8492
  # metadata: {
8228
8493
  # },
8229
8494
  # version_id: "null",
@@ -8244,7 +8509,7 @@ module Aws::S3
8244
8509
  # content_length: 3191,
8245
8510
  # content_type: "image/jpeg",
8246
8511
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8247
- # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
8512
+ # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
8248
8513
  # metadata: {
8249
8514
  # },
8250
8515
  # tag_count: 2,
@@ -8356,7 +8621,7 @@ module Aws::S3
8356
8621
  req.send_request(options, &block)
8357
8622
  end
8358
8623
 
8359
- # <note markdown="1"> This operation is not supported by directory buckets.
8624
+ # <note markdown="1"> This operation is not supported for directory buckets.
8360
8625
  #
8361
8626
  # </note>
8362
8627
  #
@@ -8551,9 +8816,13 @@ module Aws::S3
8551
8816
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
8552
8817
  # for this API operation to the Zonal endpoint. These endpoints support
8553
8818
  # virtual-hosted-style requests in the format
8554
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
8555
- # Path-style requests are not supported. For more information, see
8556
- # [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*.
8557
8826
  #
8558
8827
  # </note>
8559
8828
  #
@@ -8566,7 +8835,7 @@ module Aws::S3
8566
8835
  # `s3:GetObjectVersionAttributes` permissions for this operation. If
8567
8836
  # the bucket is not versioned, you need the `s3:GetObject` and
8568
8837
  # `s3:GetObjectAttributes` permissions. For more information, see
8569
- # [Specifying Permissions in a Policy][2] in the *Amazon S3 User
8838
+ # [Specifying Permissions in a Policy][3] in the *Amazon S3 User
8570
8839
  # Guide*. If the object that you request does not exist, the error
8571
8840
  # Amazon S3 returns depends on whether you also have the
8572
8841
  # `s3:ListBucket` permission.
@@ -8578,10 +8847,9 @@ module Aws::S3
8578
8847
  # * If you don't have the `s3:ListBucket` permission, Amazon S3
8579
8848
  # returns an HTTP status code `403 Forbidden` ("access denied")
8580
8849
  # error.
8581
- #
8582
8850
  # * **Directory bucket permissions** - To grant access to this API
8583
8851
  # operation on a directory bucket, we recommend that you use the [
8584
- # `CreateSession` ][3] API operation for session-based
8852
+ # `CreateSession` ][4] API operation for session-based
8585
8853
  # authorization. Specifically, you grant the
8586
8854
  # `s3express:CreateSession` permission to the directory bucket in a
8587
8855
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -8592,7 +8860,7 @@ module Aws::S3
8592
8860
  # token for use. Amazon Web Services CLI or SDKs create session and
8593
8861
  # refresh the session token automatically to avoid service
8594
8862
  # interruptions when a session expires. For more information about
8595
- # authorization, see [ `CreateSession` ][3].
8863
+ # authorization, see [ `CreateSession` ][4].
8596
8864
  #
8597
8865
  # If the object is encrypted with SSE-KMS, you must also have the
8598
8866
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -8628,7 +8896,7 @@ module Aws::S3
8628
8896
  # * `x-amz-server-side-encryption-customer-key-MD5`
8629
8897
  #
8630
8898
  # For more information about SSE-C, see [Server-Side Encryption (Using
8631
- # Customer-Provided Encryption Keys)][4] in the *Amazon S3 User
8899
+ # Customer-Provided Encryption Keys)][5] in the *Amazon S3 User
8632
8900
  # Guide*.
8633
8901
  #
8634
8902
  # <note markdown="1"> **Directory bucket permissions** - For directory buckets, there are
@@ -8640,10 +8908,10 @@ module Aws::S3
8640
8908
  # encryption in your `CreateSession` requests or `PUT` object
8641
8909
  # requests. Then, new objects are automatically encrypted with the
8642
8910
  # desired encryption settings. For more information, see [Protecting
8643
- # 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*.
8644
8912
  # For more information about the encryption overriding behaviors in
8645
8913
  # directory buckets, see [Specifying server-side encryption with KMS
8646
- # for new object uploads][6].
8914
+ # for new object uploads][7].
8647
8915
  #
8648
8916
  # </note>
8649
8917
  #
@@ -8665,9 +8933,8 @@ module Aws::S3
8665
8933
  # * `If-Match` condition evaluates to `true`.
8666
8934
  #
8667
8935
  # * `If-Unmodified-Since` condition evaluates to `false`.
8668
- #
8669
8936
  # For more information about conditional requests, see [RFC
8670
- # 7232][7].
8937
+ # 7232][8].
8671
8938
  #
8672
8939
  # * If both of the `If-None-Match` and `If-Modified-Since` headers are
8673
8940
  # present in the request as follows, then Amazon S3 returns the HTTP
@@ -8676,60 +8943,60 @@ module Aws::S3
8676
8943
  # * `If-None-Match` condition evaluates to `false`.
8677
8944
  #
8678
8945
  # * `If-Modified-Since` condition evaluates to `true`.
8679
- #
8680
8946
  # For more information about conditional requests, see [RFC
8681
- # 7232][7].
8947
+ # 7232][8].
8682
8948
  #
8683
8949
  # HTTP Host header syntax
8684
8950
  #
8685
8951
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
8686
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
8952
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
8687
8953
  #
8688
8954
  # The following actions are related to `GetObjectAttributes`:
8689
8955
  #
8690
- # * [GetObject][8]
8956
+ # * [GetObject][9]
8691
8957
  #
8692
- # * [GetObjectAcl][9]
8958
+ # * [GetObjectAcl][10]
8693
8959
  #
8694
- # * [GetObjectLegalHold][10]
8960
+ # * [GetObjectLegalHold][11]
8695
8961
  #
8696
- # * [GetObjectLockConfiguration][11]
8962
+ # * [GetObjectLockConfiguration][12]
8697
8963
  #
8698
- # * [GetObjectRetention][12]
8964
+ # * [GetObjectRetention][13]
8699
8965
  #
8700
- # * [GetObjectTagging][13]
8966
+ # * [GetObjectTagging][14]
8701
8967
  #
8702
- # * [HeadObject][14]
8968
+ # * [HeadObject][15]
8703
8969
  #
8704
- # * [ListParts][15]
8970
+ # * [ListParts][16]
8705
8971
  #
8706
8972
  #
8707
8973
  #
8708
8974
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
8709
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8710
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
8711
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
8712
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
8713
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
8714
- # [7]: https://tools.ietf.org/html/rfc7232
8715
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
8716
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
8717
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
8718
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
8719
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
8720
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
8721
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
8722
- # [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
8723
8990
  #
8724
8991
  # @option params [required, String] :bucket
8725
8992
  # The name of the bucket that contains the object.
8726
8993
  #
8727
8994
  # **Directory buckets** - When you use this operation with a directory
8728
8995
  # bucket, you must use virtual-hosted-style requests in the format `
8729
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
8730
- # are not supported. Directory bucket names must be unique in the chosen
8731
- # Availability Zone. Bucket names must follow the format `
8732
- # 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, `
8733
9000
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8734
9001
  # naming restrictions, see [Directory bucket naming rules][1] in the
8735
9002
  # *Amazon S3 User Guide*.
@@ -8902,7 +9169,7 @@ module Aws::S3
8902
9169
  req.send_request(options)
8903
9170
  end
8904
9171
 
8905
- # <note markdown="1"> This operation is not supported by directory buckets.
9172
+ # <note markdown="1"> This operation is not supported for directory buckets.
8906
9173
  #
8907
9174
  # </note>
8908
9175
  #
@@ -8998,7 +9265,7 @@ module Aws::S3
8998
9265
  req.send_request(options)
8999
9266
  end
9000
9267
 
9001
- # <note markdown="1"> This operation is not supported by directory buckets.
9268
+ # <note markdown="1"> This operation is not supported for directory buckets.
9002
9269
  #
9003
9270
  # </note>
9004
9271
  #
@@ -9068,7 +9335,7 @@ module Aws::S3
9068
9335
  req.send_request(options)
9069
9336
  end
9070
9337
 
9071
- # <note markdown="1"> This operation is not supported by directory buckets.
9338
+ # <note markdown="1"> This operation is not supported for directory buckets.
9072
9339
  #
9073
9340
  # </note>
9074
9341
  #
@@ -9165,7 +9432,7 @@ module Aws::S3
9165
9432
  req.send_request(options)
9166
9433
  end
9167
9434
 
9168
- # <note markdown="1"> This operation is not supported by directory buckets.
9435
+ # <note markdown="1"> This operation is not supported for directory buckets.
9169
9436
  #
9170
9437
  # </note>
9171
9438
  #
@@ -9263,49 +9530,49 @@ module Aws::S3
9263
9530
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
9264
9531
  #
9265
9532
  #
9266
- # @example Example: To retrieve tag set of a specific object version
9533
+ # @example Example: To retrieve tag set of an object
9267
9534
  #
9268
- # # The following example retrieves tag set of an object. The request specifies object version.
9535
+ # # The following example retrieves tag set of an object.
9269
9536
  #
9270
9537
  # resp = client.get_object_tagging({
9271
9538
  # bucket: "examplebucket",
9272
- # key: "exampleobject",
9273
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9539
+ # key: "HappyFace.jpg",
9274
9540
  # })
9275
9541
  #
9276
9542
  # resp.to_h outputs the following:
9277
9543
  # {
9278
9544
  # tag_set: [
9279
9545
  # {
9280
- # key: "Key1",
9281
- # value: "Value1",
9546
+ # key: "Key4",
9547
+ # value: "Value4",
9548
+ # },
9549
+ # {
9550
+ # key: "Key3",
9551
+ # value: "Value3",
9282
9552
  # },
9283
9553
  # ],
9284
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9554
+ # version_id: "null",
9285
9555
  # }
9286
9556
  #
9287
- # @example Example: To retrieve tag set of an object
9557
+ # @example Example: To retrieve tag set of a specific object version
9288
9558
  #
9289
- # # The following example retrieves tag set of an object.
9559
+ # # The following example retrieves tag set of an object. The request specifies object version.
9290
9560
  #
9291
9561
  # resp = client.get_object_tagging({
9292
9562
  # bucket: "examplebucket",
9293
- # key: "HappyFace.jpg",
9563
+ # key: "exampleobject",
9564
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9294
9565
  # })
9295
9566
  #
9296
9567
  # resp.to_h outputs the following:
9297
9568
  # {
9298
9569
  # tag_set: [
9299
9570
  # {
9300
- # key: "Key4",
9301
- # value: "Value4",
9302
- # },
9303
- # {
9304
- # key: "Key3",
9305
- # value: "Value3",
9571
+ # key: "Key1",
9572
+ # value: "Value1",
9306
9573
  # },
9307
9574
  # ],
9308
- # version_id: "null",
9575
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9309
9576
  # }
9310
9577
  #
9311
9578
  # @example Request syntax with placeholder values
@@ -9334,7 +9601,7 @@ module Aws::S3
9334
9601
  req.send_request(options)
9335
9602
  end
9336
9603
 
9337
- # <note markdown="1"> This operation is not supported by directory buckets.
9604
+ # <note markdown="1"> This operation is not supported for directory buckets.
9338
9605
  #
9339
9606
  # </note>
9340
9607
  #
@@ -9435,7 +9702,7 @@ module Aws::S3
9435
9702
  req.send_request(options, &block)
9436
9703
  end
9437
9704
 
9438
- # <note markdown="1"> This operation is not supported by directory buckets.
9705
+ # <note markdown="1"> This operation is not supported for directory buckets.
9439
9706
  #
9440
9707
  # </note>
9441
9708
  #
@@ -9566,13 +9833,17 @@ module Aws::S3
9566
9833
  # HTTP Host header syntax
9567
9834
  #
9568
9835
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
9569
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
9836
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9570
9837
  #
9571
9838
  # <note markdown="1"> You must make requests for this API operation to the Zonal endpoint.
9572
9839
  # These endpoints support virtual-hosted-style requests in the format
9573
- # `https://bucket_name.s3express-az_id.region.amazonaws.com`.
9574
- # Path-style requests are not supported. For more information, see
9575
- # [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*.
9576
9847
  #
9577
9848
  # </note>
9578
9849
  #
@@ -9583,16 +9854,17 @@ module Aws::S3
9583
9854
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
9584
9855
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
9585
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
9586
9858
  #
9587
9859
  # @option params [required, String] :bucket
9588
9860
  # The bucket name.
9589
9861
  #
9590
9862
  # **Directory buckets** - When you use this operation with a directory
9591
9863
  # bucket, you must use virtual-hosted-style requests in the format `
9592
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
9593
- # are not supported. Directory bucket names must be unique in the chosen
9594
- # Availability Zone. Bucket names must follow the format `
9595
- # 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, `
9596
9868
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9597
9869
  # naming restrictions, see [Directory bucket naming rules][1] in the
9598
9870
  # *Amazon S3 User Guide*.
@@ -9666,7 +9938,7 @@ module Aws::S3
9666
9938
  #
9667
9939
  # @example Response structure
9668
9940
  #
9669
- # resp.bucket_location_type #=> String, one of "AvailabilityZone"
9941
+ # resp.bucket_location_type #=> String, one of "AvailabilityZone", "LocalZone"
9670
9942
  # resp.bucket_location_name #=> String
9671
9943
  # resp.bucket_region #=> String
9672
9944
  # resp.access_point_alias #=> Boolean
@@ -9726,7 +9998,6 @@ module Aws::S3
9726
9998
  #
9727
9999
  # * If you don’t have the `s3:ListBucket` permission, Amazon S3
9728
10000
  # returns an HTTP status code `403 Forbidden` error.
9729
- #
9730
10001
  # * **Directory bucket permissions** - To grant access to this API
9731
10002
  # operation on a directory bucket, we recommend that you use the [
9732
10003
  # `CreateSession` ][3] API operation for session-based
@@ -9798,7 +10069,7 @@ module Aws::S3
9798
10069
  # a `405 Method Not Allowed` error and the `Last-Modified:
9799
10070
  # timestamp` response header.
9800
10071
  #
9801
- # <note markdown="1"> * **Directory buckets** - Delete marker is not supported by
10072
+ # <note markdown="1"> * **Directory buckets** - Delete marker is not supported for
9802
10073
  # directory buckets.
9803
10074
  #
9804
10075
  # * **Directory buckets** - S3 Versioning isn't enabled and supported
@@ -9812,22 +10083,26 @@ module Aws::S3
9812
10083
  # HTTP Host header syntax
9813
10084
  #
9814
10085
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
9815
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
10086
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
9816
10087
  #
9817
10088
  # <note markdown="1"> For directory buckets, you must make requests for this API operation
9818
10089
  # to the Zonal endpoint. These endpoints support virtual-hosted-style
9819
10090
  # requests in the format
9820
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
9821
- # `. Path-style requests are not supported. For more information, see
9822
- # [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*.
9823
10098
  #
9824
10099
  # </note>
9825
10100
  #
9826
10101
  # The following actions are related to `HeadObject`:
9827
10102
  #
9828
- # * [GetObject][7]
10103
+ # * [GetObject][8]
9829
10104
  #
9830
- # * [GetObjectAttributes][8]
10105
+ # * [GetObjectAttributes][9]
9831
10106
  #
9832
10107
  #
9833
10108
  #
@@ -9837,18 +10112,19 @@ module Aws::S3
9837
10112
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
9838
10113
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
9839
10114
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
9840
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
9841
- # [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
9842
10118
  #
9843
10119
  # @option params [required, String] :bucket
9844
10120
  # The name of the bucket that contains the object.
9845
10121
  #
9846
10122
  # **Directory buckets** - When you use this operation with a directory
9847
10123
  # bucket, you must use virtual-hosted-style requests in the format `
9848
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
9849
- # are not supported. Directory bucket names must be unique in the chosen
9850
- # Availability Zone. Bucket names must follow the format `
9851
- # 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, `
9852
10128
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9853
10129
  # naming restrictions, see [Directory bucket naming rules][1] in the
9854
10130
  # *Amazon S3 User Guide*.
@@ -10123,7 +10399,7 @@ module Aws::S3
10123
10399
  # content_length: 3191,
10124
10400
  # content_type: "image/jpeg",
10125
10401
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
10126
- # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
10402
+ # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
10127
10403
  # metadata: {
10128
10404
  # },
10129
10405
  # version_id: "null",
@@ -10209,7 +10485,7 @@ module Aws::S3
10209
10485
  req.send_request(options)
10210
10486
  end
10211
10487
 
10212
- # <note markdown="1"> This operation is not supported by directory buckets.
10488
+ # <note markdown="1"> This operation is not supported for directory buckets.
10213
10489
  #
10214
10490
  # </note>
10215
10491
  #
@@ -10310,7 +10586,7 @@ module Aws::S3
10310
10586
  req.send_request(options)
10311
10587
  end
10312
10588
 
10313
- # <note markdown="1"> This operation is not supported by directory buckets.
10589
+ # <note markdown="1"> This operation is not supported for directory buckets.
10314
10590
  #
10315
10591
  # </note>
10316
10592
  #
@@ -10402,7 +10678,7 @@ module Aws::S3
10402
10678
  req.send_request(options)
10403
10679
  end
10404
10680
 
10405
- # <note markdown="1"> This operation is not supported by directory buckets.
10681
+ # <note markdown="1"> This operation is not supported for directory buckets.
10406
10682
  #
10407
10683
  # </note>
10408
10684
  #
@@ -10504,7 +10780,7 @@ module Aws::S3
10504
10780
  req.send_request(options)
10505
10781
  end
10506
10782
 
10507
- # <note markdown="1"> This operation is not supported by directory buckets.
10783
+ # <note markdown="1"> This operation is not supported for directory buckets.
10508
10784
  #
10509
10785
  # </note>
10510
10786
  #
@@ -10606,17 +10882,26 @@ module Aws::S3
10606
10882
  req.send_request(options)
10607
10883
  end
10608
10884
 
10609
- # <note markdown="1"> This operation is not supported by directory buckets.
10885
+ # <note markdown="1"> This operation is not supported for directory buckets.
10610
10886
  #
10611
10887
  # </note>
10612
10888
  #
10613
10889
  # Returns a list of all buckets owned by the authenticated sender of the
10614
- # request. To use this operation, you must have the
10615
- # `s3:ListAllMyBuckets` permission.
10890
+ # request. To grant IAM permission to use this operation, you must add
10891
+ # the `s3:ListAllMyBuckets` policy action.
10616
10892
  #
10617
10893
  # For information about Amazon S3 buckets, see [Creating, configuring,
10618
10894
  # and working with Amazon S3 buckets][1].
10619
10895
  #
10896
+ # We strongly recommend using only paginated `ListBuckets` requests.
10897
+ # Unpaginated `ListBuckets` requests are only supported for Amazon Web
10898
+ # Services accounts set to the default general purpose bucket quota of
10899
+ # 10,000. If you have an approved general purpose bucket quota above
10900
+ # 10,000, you must send paginated `ListBuckets` requests to list your
10901
+ # account’s buckets. All unpaginated `ListBuckets` requests will be
10902
+ # rejected for Amazon Web Services accounts with a general purpose
10903
+ # bucket quota greater than 10,000.
10904
+ #
10620
10905
  #
10621
10906
  #
10622
10907
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
@@ -10636,6 +10921,14 @@ module Aws::S3
10636
10921
  #
10637
10922
  # Required: No.
10638
10923
  #
10924
+ # <note markdown="1"> If you specify the `bucket-region`, `prefix`, or `continuation-token`
10925
+ # query parameters without using `max-buckets` to set the maximum number
10926
+ # of buckets returned in the response, Amazon S3 applies a default page
10927
+ # size of 10,000 and provides a continuation token if there are more
10928
+ # buckets.
10929
+ #
10930
+ # </note>
10931
+ #
10639
10932
  # @option params [String] :prefix
10640
10933
  # Limits the response to bucket names that begin with the specified
10641
10934
  # bucket name prefix.
@@ -10735,9 +11028,13 @@ module Aws::S3
10735
11028
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
10736
11029
  # requests for this API operation to the Regional endpoint. These
10737
11030
  # endpoints support path-style requests in the format
10738
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
10739
- # Virtual-hosted-style requests aren't supported. For more information,
10740
- # 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*.
10741
11038
  #
10742
11039
  # </note>
10743
11040
  #
@@ -10749,7 +11046,7 @@ module Aws::S3
10749
11046
  # operation can only be performed by the Amazon Web Services account
10750
11047
  # that owns the resource. For more information about directory bucket
10751
11048
  # policies and permissions, see [Amazon Web Services Identity and
10752
- # 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
10753
11050
  # S3 User Guide*.
10754
11051
  #
10755
11052
  # HTTP Host header syntax
@@ -10757,11 +11054,17 @@ module Aws::S3
10757
11054
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
10758
11055
  # `s3express-control.region.amazonaws.com`.
10759
11056
  #
11057
+ # <note markdown="1"> The `BucketRegion` response element is not part of the
11058
+ # `ListDirectoryBuckets` Response Syntax.
11059
+ #
11060
+ # </note>
11061
+ #
10760
11062
  #
10761
11063
  #
10762
11064
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
10763
11065
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
10764
- # [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
10765
11068
  #
10766
11069
  # @option params [String] :continuation_token
10767
11070
  # `ContinuationToken` indicates to Amazon S3 that the list is being
@@ -10815,7 +11118,7 @@ module Aws::S3
10815
11118
  # multipart uploads are aborted or completed. To delete these
10816
11119
  # in-progress multipart uploads, use the `ListMultipartUploads`
10817
11120
  # operation to list the in-progress multipart uploads in the bucket and
10818
- # use the `AbortMultupartUpload` operation to abort all the in-progress
11121
+ # use the `AbortMultipartUpload` operation to abort all the in-progress
10819
11122
  # multipart uploads.
10820
11123
  #
10821
11124
  # </note>
@@ -10849,21 +11152,25 @@ module Aws::S3
10849
11152
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
10850
11153
  # for this API operation to the Zonal endpoint. These endpoints support
10851
11154
  # virtual-hosted-style requests in the format
10852
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
10853
- # Path-style requests are not supported. For more information, see
10854
- # [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*.
10855
11162
  #
10856
11163
  # </note>
10857
11164
  #
10858
11165
  # Permissions
10859
11166
  # : * **General purpose bucket permissions** - For information about
10860
11167
  # permissions required to use the multipart upload API, see
10861
- # [Multipart Upload and Permissions][3] in the *Amazon S3 User
11168
+ # [Multipart Upload and Permissions][4] in the *Amazon S3 User
10862
11169
  # Guide*.
10863
11170
  #
10864
11171
  # * **Directory bucket permissions** - To grant access to this API
10865
11172
  # operation on a directory bucket, we recommend that you use the [
10866
- # `CreateSession` ][4] API operation for session-based
11173
+ # `CreateSession` ][5] API operation for session-based
10867
11174
  # authorization. Specifically, you grant the
10868
11175
  # `s3express:CreateSession` permission to the directory bucket in a
10869
11176
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -10874,7 +11181,7 @@ module Aws::S3
10874
11181
  # token for use. Amazon Web Services CLI or SDKs create session and
10875
11182
  # refresh the session token automatically to avoid service
10876
11183
  # interruptions when a session expires. For more information about
10877
- # authorization, see [ `CreateSession` ][4].
11184
+ # authorization, see [ `CreateSession` ][5].
10878
11185
  #
10879
11186
  # Sorting of multipart uploads in response
10880
11187
  # : * **General purpose bucket** - In the `ListMultipartUploads`
@@ -10888,7 +11195,6 @@ module Aws::S3
10888
11195
  # initiation time. Among uploads with the same key, the one that
10889
11196
  # was initiated first will appear before the ones that were
10890
11197
  # initiated later.
10891
- #
10892
11198
  # * **Directory bucket** - In the `ListMultipartUploads` response, the
10893
11199
  # multipart uploads aren't sorted lexicographically based on the
10894
11200
  # object keys.
@@ -10896,41 +11202,42 @@ module Aws::S3
10896
11202
  # HTTP Host header syntax
10897
11203
  #
10898
11204
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
10899
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
11205
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
10900
11206
  #
10901
11207
  # The following operations are related to `ListMultipartUploads`:
10902
11208
  #
10903
- # * [CreateMultipartUpload][5]
11209
+ # * [CreateMultipartUpload][6]
10904
11210
  #
10905
- # * [UploadPart][6]
11211
+ # * [UploadPart][7]
10906
11212
  #
10907
- # * [CompleteMultipartUpload][7]
11213
+ # * [CompleteMultipartUpload][8]
10908
11214
  #
10909
- # * [ListParts][8]
11215
+ # * [ListParts][9]
10910
11216
  #
10911
- # * [AbortMultipartUpload][9]
11217
+ # * [AbortMultipartUpload][10]
10912
11218
  #
10913
11219
  #
10914
11220
  #
10915
11221
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
10916
11222
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
10917
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
10918
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
10919
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
10920
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
10921
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
10922
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
10923
- # [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
10924
11231
  #
10925
11232
  # @option params [required, String] :bucket
10926
11233
  # The name of the bucket to which the multipart upload was initiated.
10927
11234
  #
10928
11235
  # **Directory buckets** - When you use this operation with a directory
10929
11236
  # bucket, you must use virtual-hosted-style requests in the format `
10930
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
10931
- # are not supported. Directory bucket names must be unique in the chosen
10932
- # Availability Zone. Bucket names must follow the format `
10933
- # 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, `
10934
11241
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
10935
11242
  # naming restrictions, see [Directory bucket naming rules][1] in the
10936
11243
  # *Amazon S3 User Guide*.
@@ -11245,7 +11552,7 @@ module Aws::S3
11245
11552
  req.send_request(options)
11246
11553
  end
11247
11554
 
11248
- # <note markdown="1"> This operation is not supported by directory buckets.
11555
+ # <note markdown="1"> This operation is not supported for directory buckets.
11249
11556
  #
11250
11557
  # </note>
11251
11558
  #
@@ -11484,7 +11791,7 @@ module Aws::S3
11484
11791
  req.send_request(options)
11485
11792
  end
11486
11793
 
11487
- # <note markdown="1"> This operation is not supported by directory buckets.
11794
+ # <note markdown="1"> This operation is not supported for directory buckets.
11488
11795
  #
11489
11796
  # </note>
11490
11797
  #
@@ -11523,10 +11830,10 @@ module Aws::S3
11523
11830
  #
11524
11831
  # **Directory buckets** - When you use this operation with a directory
11525
11832
  # bucket, you must use virtual-hosted-style requests in the format `
11526
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11527
- # are not supported. Directory bucket names must be unique in the chosen
11528
- # Availability Zone. Bucket names must follow the format `
11529
- # 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, `
11530
11837
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11531
11838
  # naming restrictions, see [Directory bucket naming rules][1] in the
11532
11839
  # *Amazon S3 User Guide*.
@@ -11738,9 +12045,13 @@ module Aws::S3
11738
12045
  # * **Directory buckets** - For directory buckets, you must make
11739
12046
  # requests for this API operation to the Zonal endpoint. These
11740
12047
  # endpoints support virtual-hosted-style requests in the format
11741
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
11742
- # `. Path-style requests are not supported. For more information, see
11743
- # [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*.
11744
12055
  #
11745
12056
  # </note>
11746
12057
  #
@@ -11750,12 +12061,12 @@ module Aws::S3
11750
12061
  # to perform the `s3:ListBucket` action. The bucket owner has this
11751
12062
  # permission by default and can grant this permission to others. For
11752
12063
  # more information about permissions, see [Permissions Related to
11753
- # Bucket Subresource Operations][4] and [Managing Access Permissions
11754
- # 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*.
11755
12066
  #
11756
12067
  # * **Directory bucket permissions** - To grant access to this API
11757
12068
  # operation on a directory bucket, we recommend that you use the [
11758
- # `CreateSession` ][6] API operation for session-based
12069
+ # `CreateSession` ][7] API operation for session-based
11759
12070
  # authorization. Specifically, you grant the
11760
12071
  # `s3express:CreateSession` permission to the directory bucket in a
11761
12072
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -11766,7 +12077,7 @@ module Aws::S3
11766
12077
  # token for use. Amazon Web Services CLI or SDKs create session and
11767
12078
  # refresh the session token automatically to avoid service
11768
12079
  # interruptions when a session expires. For more information about
11769
- # authorization, see [ `CreateSession` ][6].
12080
+ # authorization, see [ `CreateSession` ][7].
11770
12081
  #
11771
12082
  # Sorting order of returned objects
11772
12083
  # : * **General purpose bucket** - For general purpose buckets,
@@ -11779,41 +12090,42 @@ module Aws::S3
11779
12090
  # HTTP Host header syntax
11780
12091
  #
11781
12092
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
11782
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
12093
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
11783
12094
  #
11784
12095
  # This section describes the latest revision of this action. We
11785
12096
  # recommend that you use this revised API operation for application
11786
12097
  # development. For backward compatibility, Amazon S3 continues to
11787
- # support the prior version of this API operation, [ListObjects][7].
12098
+ # support the prior version of this API operation, [ListObjects][8].
11788
12099
  #
11789
12100
  # The following operations are related to `ListObjectsV2`:
11790
12101
  #
11791
- # * [GetObject][8]
12102
+ # * [GetObject][9]
11792
12103
  #
11793
- # * [PutObject][9]
12104
+ # * [PutObject][10]
11794
12105
  #
11795
- # * [CreateBucket][10]
12106
+ # * [CreateBucket][11]
11796
12107
  #
11797
12108
  #
11798
12109
  #
11799
12110
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
11800
12111
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
11801
12112
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
11802
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
11803
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
11804
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
11805
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
11806
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
11807
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
11808
- # [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
11809
12121
  #
11810
12122
  # @option params [required, String] :bucket
11811
12123
  # **Directory buckets** - When you use this operation with a directory
11812
12124
  # bucket, you must use virtual-hosted-style requests in the format `
11813
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
11814
- # are not supported. Directory bucket names must be unique in the chosen
11815
- # Availability Zone. Bucket names must follow the format `
11816
- # 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, `
11817
12129
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11818
12130
  # naming restrictions, see [Directory bucket naming rules][1] in the
11819
12131
  # *Amazon S3 User Guide*.
@@ -12081,16 +12393,20 @@ module Aws::S3
12081
12393
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
12082
12394
  # for this API operation to the Zonal endpoint. These endpoints support
12083
12395
  # virtual-hosted-style requests in the format
12084
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
12085
- # Path-style requests are not supported. For more information, see
12086
- # [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*.
12087
12403
  #
12088
12404
  # </note>
12089
12405
  #
12090
12406
  # Permissions
12091
12407
  # : * **General purpose bucket permissions** - For information about
12092
12408
  # permissions required to use the multipart upload API, see
12093
- # [Multipart Upload and Permissions][4] in the *Amazon S3 User
12409
+ # [Multipart Upload and Permissions][5] in the *Amazon S3 User
12094
12410
  # Guide*.
12095
12411
  #
12096
12412
  # If the upload was created using server-side encryption with Key
@@ -12101,7 +12417,7 @@ module Aws::S3
12101
12417
  #
12102
12418
  # * **Directory bucket permissions** - To grant access to this API
12103
12419
  # operation on a directory bucket, we recommend that you use the [
12104
- # `CreateSession` ][5] API operation for session-based
12420
+ # `CreateSession` ][6] API operation for session-based
12105
12421
  # authorization. Specifically, you grant the
12106
12422
  # `s3express:CreateSession` permission to the directory bucket in a
12107
12423
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -12112,49 +12428,50 @@ module Aws::S3
12112
12428
  # token for use. Amazon Web Services CLI or SDKs create session and
12113
12429
  # refresh the session token automatically to avoid service
12114
12430
  # interruptions when a session expires. For more information about
12115
- # authorization, see [ `CreateSession` ][5].
12431
+ # authorization, see [ `CreateSession` ][6].
12116
12432
  #
12117
12433
  # HTTP Host header syntax
12118
12434
  #
12119
12435
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
12120
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
12436
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
12121
12437
  #
12122
12438
  # The following operations are related to `ListParts`:
12123
12439
  #
12124
12440
  # * [CreateMultipartUpload][1]
12125
12441
  #
12126
- # * [UploadPart][6]
12442
+ # * [UploadPart][7]
12127
12443
  #
12128
- # * [CompleteMultipartUpload][7]
12444
+ # * [CompleteMultipartUpload][8]
12129
12445
  #
12130
- # * [AbortMultipartUpload][8]
12446
+ # * [AbortMultipartUpload][9]
12131
12447
  #
12132
- # * [GetObjectAttributes][9]
12448
+ # * [GetObjectAttributes][10]
12133
12449
  #
12134
- # * [ListMultipartUploads][10]
12450
+ # * [ListMultipartUploads][11]
12135
12451
  #
12136
12452
  #
12137
12453
  #
12138
12454
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
12139
12455
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
12140
12456
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
12141
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
12142
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
12143
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
12144
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
12145
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
12146
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
12147
- # [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
12148
12465
  #
12149
12466
  # @option params [required, String] :bucket
12150
12467
  # The name of the bucket to which the parts are being uploaded.
12151
12468
  #
12152
12469
  # **Directory buckets** - When you use this operation with a directory
12153
12470
  # bucket, you must use virtual-hosted-style requests in the format `
12154
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
12155
- # are not supported. Directory bucket names must be unique in the chosen
12156
- # Availability Zone. Bucket names must follow the format `
12157
- # 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, `
12158
12475
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12159
12476
  # naming restrictions, see [Directory bucket naming rules][1] in the
12160
12477
  # *Amazon S3 User Guide*.
@@ -12378,7 +12695,7 @@ module Aws::S3
12378
12695
  req.send_request(options)
12379
12696
  end
12380
12697
 
12381
- # <note markdown="1"> This operation is not supported by directory buckets.
12698
+ # <note markdown="1"> This operation is not supported for directory buckets.
12382
12699
  #
12383
12700
  # </note>
12384
12701
  #
@@ -12477,7 +12794,7 @@ module Aws::S3
12477
12794
  req.send_request(options)
12478
12795
  end
12479
12796
 
12480
- # <note markdown="1"> This operation is not supported by directory buckets.
12797
+ # <note markdown="1"> This operation is not supported for directory buckets.
12481
12798
  #
12482
12799
  # </note>
12483
12800
  #
@@ -12568,7 +12885,6 @@ module Aws::S3
12568
12885
  # General Reference.
12569
12886
  #
12570
12887
  # </note>
12571
- #
12572
12888
  # For example, the following `x-amz-grant-write` header grants
12573
12889
  # create, overwrite, and delete objects permission to LogDelivery
12574
12890
  # group predefined by Amazon S3 and two Amazon Web Services accounts
@@ -12771,7 +13087,7 @@ module Aws::S3
12771
13087
  req.send_request(options)
12772
13088
  end
12773
13089
 
12774
- # <note markdown="1"> This operation is not supported by directory buckets.
13090
+ # <note markdown="1"> This operation is not supported for directory buckets.
12775
13091
  #
12776
13092
  # </note>
12777
13093
  #
@@ -12809,14 +13125,12 @@ module Aws::S3
12809
13125
  # * *Code: InvalidArgument*
12810
13126
  #
12811
13127
  # * *Cause: Invalid argument.*
12812
- #
12813
13128
  # * * *HTTP Error: HTTP 400 Bad Request*
12814
13129
  #
12815
13130
  # * *Code: TooManyConfigurations*
12816
13131
  #
12817
13132
  # * *Cause: You are attempting to create a new configuration but have
12818
13133
  # already reached the 1,000-configuration limit.*
12819
- #
12820
13134
  # * * *HTTP Error: HTTP 403 Forbidden*
12821
13135
  #
12822
13136
  # * *Code: AccessDenied*
@@ -12909,7 +13223,7 @@ module Aws::S3
12909
13223
  req.send_request(options)
12910
13224
  end
12911
13225
 
12912
- # <note markdown="1"> This operation is not supported by directory buckets.
13226
+ # <note markdown="1"> This operation is not supported for directory buckets.
12913
13227
  #
12914
13228
  # </note>
12915
13229
  #
@@ -13094,9 +13408,13 @@ module Aws::S3
13094
13408
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
13095
13409
  # requests for this API operation to the Regional endpoint. These
13096
13410
  # endpoints support path-style requests in the format
13097
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
13098
- # Virtual-hosted-style requests aren't supported. For more information,
13099
- # 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*.
13100
13418
  #
13101
13419
  # </note>
13102
13420
  #
@@ -13110,15 +13428,14 @@ module Aws::S3
13110
13428
  # keys (SSE-KMS) or dual-layer server-side encryption with Amazon
13111
13429
  # Web Services KMS keys (DSSE-KMS). If you specify default
13112
13430
  # encryption by using SSE-KMS, you can also configure [Amazon S3
13113
- # Bucket Keys][2]. For information about the bucket default
13114
- # 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]
13115
13433
  # in the *Amazon S3 User Guide*.
13116
13434
  #
13117
13435
  # * If you use PutBucketEncryption to set your [default bucket
13118
- # 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
13119
13437
  # is correct. Amazon S3 doesn't validate the KMS key ID provided in
13120
13438
  # PutBucketEncryption requests.
13121
- #
13122
13439
  # * <b>Directory buckets </b> - You can optionally configure default
13123
13440
  # encryption for a bucket by using server-side encryption with Key
13124
13441
  # Management Service (KMS) keys (SSE-KMS).
@@ -13130,28 +13447,28 @@ module Aws::S3
13130
13447
  # encrypted with the desired encryption settings. For more
13131
13448
  # information about the encryption overriding behaviors in directory
13132
13449
  # buckets, see [Specifying server-side encryption with KMS for new
13133
- # object uploads][4].
13450
+ # object uploads][5].
13134
13451
  #
13135
13452
  # * Your SSE-KMS configuration can only support 1 [customer managed
13136
- # key][5] per directory bucket for the lifetime of the bucket. The
13137
- # [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.
13138
13455
  #
13139
13456
  # * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
13140
13457
  # in a directory bucket and can’t be disabled. S3 Bucket Keys
13141
13458
  # aren't supported, when you copy SSE-KMS encrypted objects from
13142
13459
  # general purpose buckets to directory buckets, from directory
13143
13460
  # buckets to general purpose buckets, or between directory buckets,
13144
- # through [CopyObject][7], [UploadPartCopy][8], [the Copy operation
13145
- # 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,
13146
13463
  # Amazon S3 makes a call to KMS every time a copy request is made
13147
13464
  # for a KMS-encrypted object.
13148
13465
  #
13149
- # * When you specify an [KMS customer managed key][5] for encryption
13466
+ # * When you specify an [KMS customer managed key][6] for encryption
13150
13467
  # in your directory bucket, only use the key ID or key ARN. The key
13151
13468
  # alias format of the KMS key isn't supported.
13152
13469
  #
13153
13470
  # * For directory buckets, if you use PutBucketEncryption to set your
13154
- # [default bucket encryption][3] to SSE-KMS, Amazon S3 validates the
13471
+ # [default bucket encryption][4] to SSE-KMS, Amazon S3 validates the
13155
13472
  # KMS key ID provided in PutBucketEncryption requests.
13156
13473
  #
13157
13474
  # </note>
@@ -13164,7 +13481,7 @@ module Aws::S3
13164
13481
  #
13165
13482
  # Also, this action requires Amazon Web Services Signature Version 4.
13166
13483
  # For more information, see [ Authenticating Requests (Amazon Web
13167
- # Services Signature Version 4)][11].
13484
+ # Services Signature Version 4)][12].
13168
13485
  #
13169
13486
  # Permissions
13170
13487
  # : * **General purpose bucket permissions** - The
@@ -13172,8 +13489,8 @@ module Aws::S3
13172
13489
  # policy. The bucket owner has this permission by default. The
13173
13490
  # bucket owner can grant this permission to others. For more
13174
13491
  # information about permissions, see [Permissions Related to Bucket
13175
- # Operations][12] and [Managing Access Permissions to Your Amazon S3
13176
- # 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*.
13177
13494
  #
13178
13495
  # * **Directory bucket permissions** - To grant access to this API
13179
13496
  # operation, you must have the
@@ -13183,7 +13500,7 @@ module Aws::S3
13183
13500
  # only be performed by the Amazon Web Services account that owns the
13184
13501
  # resource. For more information about directory bucket policies and
13185
13502
  # permissions, see [Amazon Web Services Identity and Access
13186
- # 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
13187
13504
  # User Guide*.
13188
13505
  #
13189
13506
  # To set a directory bucket default encryption with SSE-KMS, you
@@ -13194,32 +13511,33 @@ module Aws::S3
13194
13511
  # HTTP Host header syntax
13195
13512
  #
13196
13513
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
13197
- # `s3express-control.region.amazonaws.com`.
13514
+ # `s3express-control.region-code.amazonaws.com`.
13198
13515
  #
13199
13516
  # The following operations are related to `PutBucketEncryption`:
13200
13517
  #
13201
- # * [GetBucketEncryption][15]
13518
+ # * [GetBucketEncryption][16]
13202
13519
  #
13203
- # * [DeleteBucketEncryption][16]
13520
+ # * [DeleteBucketEncryption][17]
13204
13521
  #
13205
13522
  #
13206
13523
  #
13207
13524
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
13208
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
13209
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
13210
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
13211
- # [5]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
13212
- # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
13213
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
13214
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
13215
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
13216
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
13217
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
13218
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
13219
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
13220
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
13221
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
13222
- # [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
13223
13541
  #
13224
13542
  # @option params [required, String] :bucket
13225
13543
  # Specifies default encryption for a bucket using server-side encryption
@@ -13227,13 +13545,14 @@ module Aws::S3
13227
13545
  #
13228
13546
  # <b>Directory buckets </b> - When you use this operation with a
13229
13547
  # directory bucket, you must use path-style requests in the format
13230
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
13548
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
13231
13549
  # Virtual-hosted-style requests aren't supported. Directory bucket
13232
- # names must be unique in the chosen Availability Zone. Bucket names
13233
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
13234
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
13235
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
13236
- # 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*
13237
13556
  #
13238
13557
  #
13239
13558
  #
@@ -13317,7 +13636,7 @@ module Aws::S3
13317
13636
  req.send_request(options)
13318
13637
  end
13319
13638
 
13320
- # <note markdown="1"> This operation is not supported by directory buckets.
13639
+ # <note markdown="1"> This operation is not supported for directory buckets.
13321
13640
  #
13322
13641
  # </note>
13323
13642
  #
@@ -13442,7 +13761,7 @@ module Aws::S3
13442
13761
  req.send_request(options)
13443
13762
  end
13444
13763
 
13445
- # <note markdown="1"> This operation is not supported by directory buckets.
13764
+ # <note markdown="1"> This operation is not supported for directory buckets.
13446
13765
  #
13447
13766
  # </note>
13448
13767
  #
@@ -13594,15 +13913,15 @@ module Aws::S3
13594
13913
  req.send_request(options)
13595
13914
  end
13596
13915
 
13597
- # <note markdown="1"> This operation is not supported by directory buckets.
13598
- #
13599
- # </note>
13600
- #
13601
13916
  # For an updated version of this API, see
13602
13917
  # [PutBucketLifecycleConfiguration][1]. This version has been
13603
13918
  # deprecated. Existing lifecycle configurations will work. For new
13604
13919
  # lifecycle configurations, use the updated API.
13605
13920
  #
13921
+ # <note markdown="1"> This operation is not supported for directory buckets.
13922
+ #
13923
+ # </note>
13924
+ #
13606
13925
  # Creates a new lifecycle configuration for the bucket or replaces an
13607
13926
  # existing lifecycle configuration. For information about lifecycle
13608
13927
  # configuration, see [Object Lifecycle Management][2] in the *Amazon S3
@@ -13745,10 +14064,6 @@ module Aws::S3
13745
14064
  req.send_request(options)
13746
14065
  end
13747
14066
 
13748
- # <note markdown="1"> This operation is not supported by directory buckets.
13749
- #
13750
- # </note>
13751
- #
13752
14067
  # Creates a new lifecycle configuration for the bucket or replaces an
13753
14068
  # existing lifecycle configuration. Keep in mind that this will
13754
14069
  # overwrite an existing lifecycle configuration, so if you want to
@@ -13756,7 +14071,19 @@ module Aws::S3
13756
14071
  # lifecycle configuration. For information about lifecycle
13757
14072
  # configuration, see [Managing your storage lifecycle][1].
13758
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
+ #
13759
14084
  # Rules
14085
+ # Permissions
14086
+ # HTTP Host header syntax
13760
14087
  #
13761
14088
  # : You specify the lifecycle configuration in your request body. The
13762
14089
  # lifecycle configuration is specified as XML consisting of one or
@@ -13768,8 +14095,14 @@ module Aws::S3
13768
14095
  # size, or any combination of these. Accordingly, this section
13769
14096
  # describes the latest API. The previous version of the API supported
13770
14097
  # filtering based only on an object key name prefix, which is
13771
- # supported for backward compatibility. For the related API
13772
- # description, see [PutBucketLifecycle][2].
14098
+ # supported for backward compatibility for general purpose buckets.
14099
+ # For the related API description, see [PutBucketLifecycle][2].
14100
+ #
14101
+ # <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
14102
+ # objects and cancelling multipart uploads. Expiring of versioned
14103
+ # objects,transitions and tag filters are not supported.
14104
+ #
14105
+ # </note>
13773
14106
  #
13774
14107
  # A lifecycle rule consists of the following:
13775
14108
  #
@@ -13789,40 +14122,64 @@ module Aws::S3
13789
14122
  #
13790
14123
  # For more information, see [Object Lifecycle Management][3] and
13791
14124
  # [Lifecycle Configuration Elements][4].
14125
+ # : * **General purpose bucket permissions** - By default, all Amazon S3
14126
+ # resources are private, including buckets, objects, and related
14127
+ # subresources (for example, lifecycle configuration and website
14128
+ # configuration). Only the resource owner (that is, the Amazon Web
14129
+ # Services account that created it) can access the resource. The
14130
+ # resource owner can optionally grant access permissions to others
14131
+ # by writing an access policy. For this operation, a user must have
14132
+ # the `s3:PutLifecycleConfiguration` permission.
13792
14133
  #
13793
- # Permissions
14134
+ # You can also explicitly deny permissions. An explicit deny also
14135
+ # supersedes any other permissions. If you want to block users or
14136
+ # accounts from removing or deleting objects from your bucket, you
14137
+ # must deny them permissions for the following actions:
13794
14138
  #
13795
- # : By default, all Amazon S3 resources are private, including buckets,
13796
- # objects, and related subresources (for example, lifecycle
13797
- # configuration and website configuration). Only the resource owner
13798
- # (that is, the Amazon Web Services account that created it) can
13799
- # access the resource. The resource owner can optionally grant access
13800
- # permissions to others by writing an access policy. For this
13801
- # operation, a user must get the `s3:PutLifecycleConfiguration`
13802
- # permission.
14139
+ # * `s3:DeleteObject`
13803
14140
  #
13804
- # You can also explicitly deny permissions. An explicit deny also
13805
- # supersedes any other permissions. If you want to block users or
13806
- # accounts from removing or deleting objects from your bucket, you
13807
- # must deny them permissions for the following actions:
14141
+ # * `s3:DeleteObjectVersion`
13808
14142
  #
13809
- # * `s3:DeleteObject`
14143
+ # * `s3:PutLifecycleConfiguration`
14144
+ #
14145
+ # For more information about permissions, see [Managing Access
14146
+ # Permissions to Your Amazon S3 Resources][5].
14147
+ # ^
13810
14148
  #
13811
- # * `s3:DeleteObjectVersion`
14149
+ # * **Directory bucket permissions** - You must have the
14150
+ # `s3express:PutLifecycleConfiguration` permission in an IAM
14151
+ # identity-based policy to use this operation. Cross-account access
14152
+ # to this API operation isn't supported. The resource owner can
14153
+ # optionally grant access permissions to others by creating a role
14154
+ # or user for them as long as they are within the same account as
14155
+ # the owner and resource.
14156
+ #
14157
+ # For more information about directory bucket policies and
14158
+ # permissions, see [Authorizing Regional endpoint APIs with IAM][6]
14159
+ # in the *Amazon S3 User Guide*.
13812
14160
  #
13813
- # * `s3:PutLifecycleConfiguration`
14161
+ # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
14162
+ # requests for this API operation to the Regional endpoint. These
14163
+ # endpoints support path-style requests in the format
14164
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name
14165
+ # `. Virtual-hosted-style requests aren't supported. For more
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*.
13814
14171
  #
13815
- # For more information about permissions, see [Managing Access
13816
- # Permissions to Your Amazon S3 Resources][5].
14172
+ # </note>
13817
14173
  #
13818
- # The following operations are related to
13819
- # `PutBucketLifecycleConfiguration`:
14174
+ # : <b>Directory buckets </b> - The HTTP Host header syntax is
14175
+ # `s3express-control.region.amazonaws.com`.
13820
14176
  #
13821
- # * [Examples of Lifecycle Configuration][6]
14177
+ # The following operations are related to
14178
+ # `PutBucketLifecycleConfiguration`:
13822
14179
  #
13823
- # * [GetBucketLifecycleConfiguration][7]
14180
+ # * [GetBucketLifecycleConfiguration][9]
13824
14181
  #
13825
- # * [DeleteBucketLifecycle][8]
14182
+ # * [DeleteBucketLifecycle][10]
13826
14183
  #
13827
14184
  #
13828
14185
  #
@@ -13831,9 +14188,11 @@ module Aws::S3
13831
14188
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
13832
14189
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
13833
14190
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
13834
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-configuration-examples.html
13835
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
13836
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
14191
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14192
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.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
13837
14196
  #
13838
14197
  # @option params [required, String] :bucket
13839
14198
  # The name of the bucket for which to set the configuration.
@@ -13862,10 +14221,20 @@ module Aws::S3
13862
14221
  # you provide does not match the actual owner of the bucket, the request
13863
14222
  # fails with the HTTP status code `403 Forbidden` (access denied).
13864
14223
  #
14224
+ # <note markdown="1"> This parameter applies to general purpose buckets only. It is not
14225
+ # supported for directory bucket lifecycle configurations.
14226
+ #
14227
+ # </note>
14228
+ #
13865
14229
  # @option params [String] :transition_default_minimum_object_size
13866
14230
  # Indicates which default minimum object size behavior is applied to the
13867
14231
  # lifecycle configuration.
13868
14232
  #
14233
+ # <note markdown="1"> This parameter applies to general purpose buckets only. It is not
14234
+ # supported for directory bucket lifecycle configurations.
14235
+ #
14236
+ # </note>
14237
+ #
13869
14238
  # * `all_storage_classes_128K` - Objects smaller than 128 KB will not
13870
14239
  # transition to any storage class by default.
13871
14240
  #
@@ -13989,7 +14358,7 @@ module Aws::S3
13989
14358
  req.send_request(options)
13990
14359
  end
13991
14360
 
13992
- # <note markdown="1"> This operation is not supported by directory buckets.
14361
+ # <note markdown="1"> This operation is not supported for directory buckets.
13993
14362
  #
13994
14363
  # </note>
13995
14364
  #
@@ -14172,7 +14541,7 @@ module Aws::S3
14172
14541
  req.send_request(options)
14173
14542
  end
14174
14543
 
14175
- # <note markdown="1"> This operation is not supported by directory buckets.
14544
+ # <note markdown="1"> This operation is not supported for directory buckets.
14176
14545
  #
14177
14546
  # </note>
14178
14547
  #
@@ -14276,7 +14645,7 @@ module Aws::S3
14276
14645
  req.send_request(options)
14277
14646
  end
14278
14647
 
14279
- # <note markdown="1"> This operation is not supported by directory buckets.
14648
+ # <note markdown="1"> This operation is not supported for directory buckets.
14280
14649
  #
14281
14650
  # </note>
14282
14651
  #
@@ -14362,7 +14731,7 @@ module Aws::S3
14362
14731
  req.send_request(options)
14363
14732
  end
14364
14733
 
14365
- # <note markdown="1"> This operation is not supported by directory buckets.
14734
+ # <note markdown="1"> This operation is not supported for directory buckets.
14366
14735
  #
14367
14736
  # </note>
14368
14737
  #
@@ -14546,7 +14915,7 @@ module Aws::S3
14546
14915
  req.send_request(options)
14547
14916
  end
14548
14917
 
14549
- # <note markdown="1"> This operation is not supported by directory buckets.
14918
+ # <note markdown="1"> This operation is not supported for directory buckets.
14550
14919
  #
14551
14920
  # </note>
14552
14921
  #
@@ -14620,9 +14989,13 @@ module Aws::S3
14620
14989
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
14621
14990
  # requests for this API operation to the Regional endpoint. These
14622
14991
  # endpoints support path-style requests in the format
14623
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
14624
- # Virtual-hosted-style requests aren't supported. For more information,
14625
- # 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*.
14626
14999
  #
14627
15000
  # </note>
14628
15001
  #
@@ -14652,7 +15025,7 @@ module Aws::S3
14652
15025
  # * **General purpose bucket permissions** - The `s3:PutBucketPolicy`
14653
15026
  # permission is required in a policy. For more information about
14654
15027
  # general purpose buckets bucket policies, see [Using Bucket
14655
- # Policies and User Policies][2] in the *Amazon S3 User Guide*.
15028
+ # Policies and User Policies][3] in the *Amazon S3 User Guide*.
14656
15029
  #
14657
15030
  # * **Directory bucket permissions** - To grant access to this API
14658
15031
  # operation, you must have the `s3express:PutBucketPolicy`
@@ -14662,49 +15035,51 @@ module Aws::S3
14662
15035
  # Services account that owns the resource. For more information
14663
15036
  # about directory bucket policies and permissions, see [Amazon Web
14664
15037
  # Services Identity and Access Management (IAM) for S3 Express One
14665
- # Zone][3] in the *Amazon S3 User Guide*.
15038
+ # Zone][4] in the *Amazon S3 User Guide*.
14666
15039
  #
14667
15040
  # Example bucket policies
14668
15041
  #
14669
15042
  # : **General purpose buckets example bucket policies** - See [Bucket
14670
- # policy examples][4] in the *Amazon S3 User Guide*.
15043
+ # policy examples][5] in the *Amazon S3 User Guide*.
14671
15044
  #
14672
15045
  # **Directory bucket example bucket policies** - See [Example bucket
14673
- # 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*.
14674
15047
  #
14675
15048
  # HTTP Host header syntax
14676
15049
  #
14677
15050
  # : <b>Directory buckets </b> - The HTTP Host header syntax is
14678
- # `s3express-control.region.amazonaws.com`.
15051
+ # `s3express-control.region-code.amazonaws.com`.
14679
15052
  #
14680
15053
  # The following operations are related to `PutBucketPolicy`:
14681
15054
  #
14682
- # * [CreateBucket][6]
15055
+ # * [CreateBucket][7]
14683
15056
  #
14684
- # * [DeleteBucket][7]
15057
+ # * [DeleteBucket][8]
14685
15058
  #
14686
15059
  #
14687
15060
  #
14688
15061
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
14689
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
14690
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14691
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
14692
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
14693
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
14694
- # [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
14695
15069
  #
14696
15070
  # @option params [required, String] :bucket
14697
15071
  # The name of the bucket.
14698
15072
  #
14699
15073
  # <b>Directory buckets </b> - When you use this operation with a
14700
15074
  # directory bucket, you must use path-style requests in the format
14701
- # `https://s3express-control.region_code.amazonaws.com/bucket-name `.
15075
+ # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
14702
15076
  # Virtual-hosted-style requests aren't supported. Directory bucket
14703
- # names must be unique in the chosen Availability Zone. Bucket names
14704
- # must also follow the format ` bucket_base_name--az_id--x-s3` (for
14705
- # example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
14706
- # bucket naming restrictions, see [Directory bucket naming rules][1] in
14707
- # 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*
14708
15083
  #
14709
15084
  #
14710
15085
  #
@@ -14815,7 +15190,7 @@ module Aws::S3
14815
15190
  req.send_request(options)
14816
15191
  end
14817
15192
 
14818
- # <note markdown="1"> This operation is not supported by directory buckets.
15193
+ # <note markdown="1"> This operation is not supported for directory buckets.
14819
15194
  #
14820
15195
  # </note>
14821
15196
  #
@@ -15053,7 +15428,7 @@ module Aws::S3
15053
15428
  req.send_request(options)
15054
15429
  end
15055
15430
 
15056
- # <note markdown="1"> This operation is not supported by directory buckets.
15431
+ # <note markdown="1"> This operation is not supported for directory buckets.
15057
15432
  #
15058
15433
  # </note>
15059
15434
  #
@@ -15150,7 +15525,7 @@ module Aws::S3
15150
15525
  req.send_request(options)
15151
15526
  end
15152
15527
 
15153
- # <note markdown="1"> This operation is not supported by directory buckets.
15528
+ # <note markdown="1"> This operation is not supported for directory buckets.
15154
15529
  #
15155
15530
  # </note>
15156
15531
  #
@@ -15301,15 +15676,17 @@ module Aws::S3
15301
15676
  req.send_request(options)
15302
15677
  end
15303
15678
 
15304
- # <note markdown="1"> This operation is not supported by directory buckets.
15679
+ # <note markdown="1"> This operation is not supported for directory buckets.
15305
15680
  #
15306
15681
  # </note>
15307
15682
  #
15308
15683
  # <note markdown="1"> When you enable versioning on a bucket for the first time, it might
15309
- # take a short amount of time for the change to be fully propagated. We
15310
- # recommend that you wait for 15 minutes after enabling versioning
15311
- # before issuing write operations (`PUT` or `DELETE`) on objects in the
15312
- # bucket.
15684
+ # take a short amount of time for the change to be fully propagated.
15685
+ # While this change is propagating, you may encounter intermittent `HTTP
15686
+ # 404 NoSuchKey` errors for requests to objects created or updated after
15687
+ # enabling versioning. We recommend that you wait for 15 minutes after
15688
+ # enabling versioning before issuing write operations (`PUT` or
15689
+ # `DELETE`) on objects in the bucket.
15313
15690
  #
15314
15691
  # </note>
15315
15692
  #
@@ -15440,7 +15817,7 @@ module Aws::S3
15440
15817
  req.send_request(options)
15441
15818
  end
15442
15819
 
15443
- # <note markdown="1"> This operation is not supported by directory buckets.
15820
+ # <note markdown="1"> This operation is not supported for directory buckets.
15444
15821
  #
15445
15822
  # </note>
15446
15823
  #
@@ -15640,9 +16017,13 @@ module Aws::S3
15640
16017
  # * **Directory buckets** - For directory buckets, you must make
15641
16018
  # requests for this API operation to the Zonal endpoint. These
15642
16019
  # endpoints support virtual-hosted-style requests in the format
15643
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
15644
- # `. Path-style requests are not supported. For more information, see
15645
- # [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*.
15646
16027
  #
15647
16028
  # </note>
15648
16029
  #
@@ -15652,7 +16033,7 @@ module Aws::S3
15652
16033
  # modify this behavior:
15653
16034
  #
15654
16035
  # * **S3 Object Lock** - To prevent objects from being deleted or
15655
- # 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
15656
16037
  # S3 User Guide*.
15657
16038
  #
15658
16039
  # <note markdown="1"> This functionality is not supported for directory buckets.
@@ -15666,9 +16047,9 @@ module Aws::S3
15666
16047
  # automatically generates a unique version ID of that object being
15667
16048
  # stored in Amazon S3. You can retrieve, replace, or delete any
15668
16049
  # version of the object. For more information about versioning, see
15669
- # [Adding Objects to Versioning-Enabled Buckets][3] in the *Amazon S3
16050
+ # [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
15670
16051
  # User Guide*. For information about returning the versioning state of
15671
- # a bucket, see [GetBucketVersioning][4].
16052
+ # a bucket, see [GetBucketVersioning][5].
15672
16053
  #
15673
16054
  # <note markdown="1"> This functionality is not supported for directory buckets.
15674
16055
  #
@@ -15690,10 +16071,9 @@ module Aws::S3
15690
16071
  # * <b> <code>s3:PutObjectTagging</code> </b> - To successfully set
15691
16072
  # the tag-set with your `PutObject` request, you must have the
15692
16073
  # `s3:PutObjectTagging`.
15693
- #
15694
16074
  # * **Directory bucket permissions** - To grant access to this API
15695
16075
  # operation on a directory bucket, we recommend that you use the [
15696
- # `CreateSession` ][5] API operation for session-based
16076
+ # `CreateSession` ][6] API operation for session-based
15697
16077
  # authorization. Specifically, you grant the
15698
16078
  # `s3express:CreateSession` permission to the directory bucket in a
15699
16079
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -15704,7 +16084,7 @@ module Aws::S3
15704
16084
  # token for use. Amazon Web Services CLI or SDKs create session and
15705
16085
  # refresh the session token automatically to avoid service
15706
16086
  # interruptions when a session expires. For more information about
15707
- # authorization, see [ `CreateSession` ][5].
16087
+ # authorization, see [ `CreateSession` ][6].
15708
16088
  #
15709
16089
  # If the object is encrypted with SSE-KMS, you must also have the
15710
16090
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -15725,23 +16105,24 @@ module Aws::S3
15725
16105
  # HTTP Host header syntax
15726
16106
  #
15727
16107
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
15728
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
16108
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
15729
16109
  #
15730
16110
  # For more information about related Amazon S3 APIs, see the following:
15731
16111
  #
15732
- # * [CopyObject][6]
16112
+ # * [CopyObject][7]
15733
16113
  #
15734
- # * [DeleteObject][7]
16114
+ # * [DeleteObject][8]
15735
16115
  #
15736
16116
  #
15737
16117
  #
15738
16118
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
15739
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
15740
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
15741
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
15742
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
15743
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
15744
- # [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
15745
16126
  #
15746
16127
  # @option params [String] :acl
15747
16128
  # The canned ACL to apply to the object. For more information, see
@@ -15789,10 +16170,10 @@ module Aws::S3
15789
16170
  #
15790
16171
  # **Directory buckets** - When you use this operation with a directory
15791
16172
  # bucket, you must use virtual-hosted-style requests in the format `
15792
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
15793
- # are not supported. Directory bucket names must be unique in the chosen
15794
- # Availability Zone. Bucket names must follow the format `
15795
- # 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, `
15796
16177
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15797
16178
  # naming restrictions, see [Directory bucket naming rules][1] in the
15798
16179
  # *Amazon S3 User Guide*.
@@ -16000,6 +16381,26 @@ module Aws::S3
16000
16381
  #
16001
16382
  # [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
16002
16383
  #
16384
+ # @option params [String] :if_match
16385
+ # Uploads the object only if the ETag (entity tag) value provided during
16386
+ # the WRITE operation matches the ETag of the object in S3. If the ETag
16387
+ # values do not match, the operation returns a `412 Precondition Failed`
16388
+ # error.
16389
+ #
16390
+ # If a conflicting operation occurs during the upload S3 returns a `409
16391
+ # ConditionalRequestConflict` response. On a 409 failure you should
16392
+ # fetch the object's ETag and retry the upload.
16393
+ #
16394
+ # Expects the ETag value as a string.
16395
+ #
16396
+ # For more information about conditional requests, see [RFC 7232][1], or
16397
+ # [Conditional requests][2] in the *Amazon S3 User Guide*.
16398
+ #
16399
+ #
16400
+ #
16401
+ # [1]: https://tools.ietf.org/html/rfc7232
16402
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
16403
+ #
16003
16404
  # @option params [String] :if_none_match
16004
16405
  # Uploads the object only if the object key name does not already exist
16005
16406
  # in the bucket specified. Otherwise, Amazon S3 returns a `412
@@ -16059,6 +16460,17 @@ module Aws::S3
16059
16460
  # @option params [required, String] :key
16060
16461
  # Object key for which the PUT action was initiated.
16061
16462
  #
16463
+ # @option params [Integer] :write_offset_bytes
16464
+ # Specifies the offset for appending data to existing objects in bytes.
16465
+ # The offset must be equal to the size of the existing object being
16466
+ # appended to. If no object exists, setting this header to 0 will create
16467
+ # a new object.
16468
+ #
16469
+ # <note markdown="1"> This functionality is only supported for objects in the Amazon S3
16470
+ # Express One Zone storage class in directory buckets.
16471
+ #
16472
+ # </note>
16473
+ #
16062
16474
  # @option params [Hash<String,String>] :metadata
16063
16475
  # A map of metadata to store with the object in S3.
16064
16476
  #
@@ -16361,61 +16773,67 @@ module Aws::S3
16361
16773
  # * {Types::PutObjectOutput#ssekms_key_id #ssekms_key_id} => String
16362
16774
  # * {Types::PutObjectOutput#ssekms_encryption_context #ssekms_encryption_context} => String
16363
16775
  # * {Types::PutObjectOutput#bucket_key_enabled #bucket_key_enabled} => Boolean
16776
+ # * {Types::PutObjectOutput#size #size} => Integer
16364
16777
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
16365
16778
  #
16366
16779
  #
16367
- # @example Example: To create an object.
16780
+ # @example Example: To upload object and specify user-defined metadata
16368
16781
  #
16369
- # # The following example creates an object. 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.
16370
16784
  #
16371
16785
  # resp = client.put_object({
16372
16786
  # body: "filetoupload",
16373
16787
  # bucket: "examplebucket",
16374
- # key: "objectkey",
16788
+ # key: "exampleobject",
16789
+ # metadata: {
16790
+ # "metadata1" => "value1",
16791
+ # "metadata2" => "value2",
16792
+ # },
16375
16793
  # })
16376
16794
  #
16377
16795
  # resp.to_h outputs the following:
16378
16796
  # {
16379
16797
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16380
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
16798
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16381
16799
  # }
16382
16800
  #
16383
- # @example Example: To upload object and specify user-defined metadata
16801
+ # @example Example: To upload an object and specify optional tags
16384
16802
  #
16385
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
16386
- # # enabled, S3 returns version ID in response.
16803
+ # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
16804
+ # # S3 returns version ID of the newly created object.
16387
16805
  #
16388
16806
  # resp = client.put_object({
16389
- # body: "filetoupload",
16807
+ # body: "c:\\HappyFace.jpg",
16390
16808
  # bucket: "examplebucket",
16391
- # key: "exampleobject",
16392
- # metadata: {
16393
- # "metadata1" => "value1",
16394
- # "metadata2" => "value2",
16395
- # },
16809
+ # key: "HappyFace.jpg",
16810
+ # tagging: "key1=value1&key2=value2",
16396
16811
  # })
16397
16812
  #
16398
16813
  # resp.to_h outputs the following:
16399
16814
  # {
16400
16815
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16401
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
16816
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
16402
16817
  # }
16403
16818
  #
16404
- # @example Example: To upload an object
16819
+ # @example Example: To upload an object (specify optional headers)
16405
16820
  #
16406
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
16407
- # # syntax. S3 returns VersionId of the newly created object.
16821
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
16822
+ # # storage class and use server-side encryption.
16408
16823
  #
16409
16824
  # resp = client.put_object({
16410
16825
  # body: "HappyFace.jpg",
16411
16826
  # bucket: "examplebucket",
16412
16827
  # key: "HappyFace.jpg",
16828
+ # server_side_encryption: "AES256",
16829
+ # storage_class: "STANDARD_IA",
16413
16830
  # })
16414
16831
  #
16415
16832
  # resp.to_h outputs the following:
16416
16833
  # {
16417
16834
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16418
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16835
+ # server_side_encryption: "AES256",
16836
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16419
16837
  # }
16420
16838
  #
16421
16839
  # @example Example: To upload an object and specify canned ACL.
@@ -16436,62 +16854,57 @@ module Aws::S3
16436
16854
  # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
16437
16855
  # }
16438
16856
  #
16439
- # @example Example: To upload an object (specify optional headers)
16857
+ # @example Example: To upload an object
16440
16858
  #
16441
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
16442
- # # 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.
16443
16861
  #
16444
16862
  # resp = client.put_object({
16445
16863
  # body: "HappyFace.jpg",
16446
16864
  # bucket: "examplebucket",
16447
16865
  # key: "HappyFace.jpg",
16448
- # server_side_encryption: "AES256",
16449
- # storage_class: "STANDARD_IA",
16450
16866
  # })
16451
16867
  #
16452
16868
  # resp.to_h outputs the following:
16453
16869
  # {
16454
16870
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16455
- # server_side_encryption: "AES256",
16456
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16871
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16457
16872
  # }
16458
16873
  #
16459
- # @example Example: To upload an object and specify optional tags
16874
+ # @example Example: To upload an object and specify server-side encryption and object tags
16460
16875
  #
16461
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
16462
- # # S3 returns version ID of the newly created object.
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.
16463
16878
  #
16464
16879
  # resp = client.put_object({
16465
- # body: "c:\\HappyFace.jpg",
16880
+ # body: "filetoupload",
16466
16881
  # bucket: "examplebucket",
16467
- # key: "HappyFace.jpg",
16882
+ # key: "exampleobject",
16883
+ # server_side_encryption: "AES256",
16468
16884
  # tagging: "key1=value1&key2=value2",
16469
16885
  # })
16470
16886
  #
16471
16887
  # resp.to_h outputs the following:
16472
16888
  # {
16473
16889
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16474
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
16890
+ # server_side_encryption: "AES256",
16891
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16475
16892
  # }
16476
16893
  #
16477
- # @example Example: To upload an object and specify server-side encryption and object tags
16894
+ # @example Example: To create an object.
16478
16895
  #
16479
- # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
16480
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
16896
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
16481
16897
  #
16482
16898
  # resp = client.put_object({
16483
16899
  # body: "filetoupload",
16484
16900
  # bucket: "examplebucket",
16485
- # key: "exampleobject",
16486
- # server_side_encryption: "AES256",
16487
- # tagging: "key1=value1&key2=value2",
16901
+ # key: "objectkey",
16488
16902
  # })
16489
16903
  #
16490
16904
  # resp.to_h outputs the following:
16491
16905
  # {
16492
16906
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16493
- # server_side_encryption: "AES256",
16494
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
16907
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
16495
16908
  # }
16496
16909
  #
16497
16910
  # @example Streaming a file from disk
@@ -16519,12 +16932,14 @@ module Aws::S3
16519
16932
  # checksum_sha1: "ChecksumSHA1",
16520
16933
  # checksum_sha256: "ChecksumSHA256",
16521
16934
  # expires: Time.now,
16935
+ # if_match: "IfMatch",
16522
16936
  # if_none_match: "IfNoneMatch",
16523
16937
  # grant_full_control: "GrantFullControl",
16524
16938
  # grant_read: "GrantRead",
16525
16939
  # grant_read_acp: "GrantReadACP",
16526
16940
  # grant_write_acp: "GrantWriteACP",
16527
16941
  # key: "ObjectKey", # required
16942
+ # write_offset_bytes: 1,
16528
16943
  # metadata: {
16529
16944
  # "MetadataKey" => "MetadataValue",
16530
16945
  # },
@@ -16560,6 +16975,7 @@ module Aws::S3
16560
16975
  # resp.ssekms_key_id #=> String
16561
16976
  # resp.ssekms_encryption_context #=> String
16562
16977
  # resp.bucket_key_enabled #=> Boolean
16978
+ # resp.size #=> Integer
16563
16979
  # resp.request_charged #=> String, one of "requester"
16564
16980
  #
16565
16981
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject AWS API Documentation
@@ -16571,7 +16987,7 @@ module Aws::S3
16571
16987
  req.send_request(options)
16572
16988
  end
16573
16989
 
16574
- # <note markdown="1"> This operation is not supported by directory buckets.
16990
+ # <note markdown="1"> This operation is not supported for directory buckets.
16575
16991
  #
16576
16992
  # </note>
16577
16993
  #
@@ -16655,7 +17071,6 @@ module Aws::S3
16655
17071
  # General Reference.
16656
17072
  #
16657
17073
  # </note>
16658
- #
16659
17074
  # For example, the following `x-amz-grant-read` header grants list
16660
17075
  # objects permission to the two Amazon Web Services accounts
16661
17076
  # identified by their email addresses.
@@ -16941,7 +17356,7 @@ module Aws::S3
16941
17356
  req.send_request(options)
16942
17357
  end
16943
17358
 
16944
- # <note markdown="1"> This operation is not supported by directory buckets.
17359
+ # <note markdown="1"> This operation is not supported for directory buckets.
16945
17360
  #
16946
17361
  # </note>
16947
17362
  #
@@ -17060,7 +17475,7 @@ module Aws::S3
17060
17475
  req.send_request(options)
17061
17476
  end
17062
17477
 
17063
- # <note markdown="1"> This operation is not supported by directory buckets.
17478
+ # <note markdown="1"> This operation is not supported for directory buckets.
17064
17479
  #
17065
17480
  # </note>
17066
17481
  #
@@ -17179,7 +17594,7 @@ module Aws::S3
17179
17594
  req.send_request(options)
17180
17595
  end
17181
17596
 
17182
- # <note markdown="1"> This operation is not supported by directory buckets.
17597
+ # <note markdown="1"> This operation is not supported for directory buckets.
17183
17598
  #
17184
17599
  # </note>
17185
17600
  #
@@ -17308,7 +17723,7 @@ module Aws::S3
17308
17723
  req.send_request(options)
17309
17724
  end
17310
17725
 
17311
- # <note markdown="1"> This operation is not supported by directory buckets.
17726
+ # <note markdown="1"> This operation is not supported for directory buckets.
17312
17727
  #
17313
17728
  # </note>
17314
17729
  #
@@ -17507,7 +17922,7 @@ module Aws::S3
17507
17922
  req.send_request(options)
17508
17923
  end
17509
17924
 
17510
- # <note markdown="1"> This operation is not supported by directory buckets.
17925
+ # <note markdown="1"> This operation is not supported for directory buckets.
17511
17926
  #
17512
17927
  # </note>
17513
17928
  #
@@ -17615,7 +18030,7 @@ module Aws::S3
17615
18030
  req.send_request(options)
17616
18031
  end
17617
18032
 
17618
- # <note markdown="1"> This operation is not supported by directory buckets.
18033
+ # <note markdown="1"> This operation is not supported for directory buckets.
17619
18034
  #
17620
18035
  # </note>
17621
18036
  #
@@ -17761,7 +18176,6 @@ module Aws::S3
17761
18176
  # * *HTTP Status Code: 409 Conflict*
17762
18177
  #
17763
18178
  # * *SOAP Fault Code Prefix: Client*
17764
- #
17765
18179
  # * * *Code: GlacierExpeditedRetrievalNotAvailable*
17766
18180
  #
17767
18181
  # * *Cause: expedited retrievals are currently not available. Try
@@ -18000,7 +18414,7 @@ module Aws::S3
18000
18414
  req.send_request(options)
18001
18415
  end
18002
18416
 
18003
- # <note markdown="1"> This operation is not supported by directory buckets.
18417
+ # <note markdown="1"> This operation is not supported for directory buckets.
18004
18418
  #
18005
18419
  # </note>
18006
18420
  #
@@ -18454,9 +18868,13 @@ module Aws::S3
18454
18868
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
18455
18869
  # for this API operation to the Zonal endpoint. These endpoints support
18456
18870
  # virtual-hosted-style requests in the format
18457
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
18458
- # Path-style requests are not supported. For more information, see
18459
- # [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*.
18460
18878
  #
18461
18879
  # </note>
18462
18880
  #
@@ -18473,15 +18891,15 @@ module Aws::S3
18473
18891
  # These permissions are required because Amazon S3 must decrypt and
18474
18892
  # read data from the encrypted file parts before it completes the
18475
18893
  # multipart upload. For more information about KMS permissions, see
18476
- # [Protecting data using server-side encryption with KMS][6] in the
18894
+ # [Protecting data using server-side encryption with KMS][7] in the
18477
18895
  # *Amazon S3 User Guide*. For information about the permissions
18478
18896
  # required to use the multipart upload API, see [Multipart upload
18479
- # and permissions][7] and [Multipart upload API and permissions][8]
18897
+ # and permissions][8] and [Multipart upload API and permissions][9]
18480
18898
  # in the *Amazon S3 User Guide*.
18481
18899
  #
18482
18900
  # * **Directory bucket permissions** - To grant access to this API
18483
18901
  # operation on a directory bucket, we recommend that you use the [
18484
- # `CreateSession` ][9] API operation for session-based
18902
+ # `CreateSession` ][10] API operation for session-based
18485
18903
  # authorization. Specifically, you grant the
18486
18904
  # `s3express:CreateSession` permission to the directory bucket in a
18487
18905
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -18492,7 +18910,7 @@ module Aws::S3
18492
18910
  # token for use. Amazon Web Services CLI or SDKs create session and
18493
18911
  # refresh the session token automatically to avoid service
18494
18912
  # interruptions when a session expires. For more information about
18495
- # authorization, see [ `CreateSession` ][9].
18913
+ # authorization, see [ `CreateSession` ][10].
18496
18914
  #
18497
18915
  # If the object is encrypted with SSE-KMS, you must also have the
18498
18916
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -18508,7 +18926,7 @@ module Aws::S3
18508
18926
  # then Amazon Web Services S3 uses the `x-amz-content-sha256` header
18509
18927
  # as a checksum instead of `Content-MD5`. For more information see
18510
18928
  # [Authenticating Requests: Using the Authorization Header (Amazon Web
18511
- # Services Signature Version 4)][10].
18929
+ # Services Signature Version 4)][11].
18512
18930
  #
18513
18931
  # <note markdown="1"> **Directory buckets** - MD5 is not supported by directory buckets.
18514
18932
  # You can use checksum algorithms to check object integrity.
@@ -18548,8 +18966,7 @@ module Aws::S3
18548
18966
  # * x-amz-server-side-encryption-customer-key
18549
18967
  #
18550
18968
  # * x-amz-server-side-encryption-customer-key-MD5
18551
- #
18552
- # For more information, see [Using Server-Side Encryption][11] in
18969
+ # For more information, see [Using Server-Side Encryption][12] in
18553
18970
  # the *Amazon S3 User Guide*.
18554
18971
  #
18555
18972
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -18571,19 +18988,19 @@ module Aws::S3
18571
18988
  # HTTP Host header syntax
18572
18989
  #
18573
18990
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
18574
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
18991
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
18575
18992
  #
18576
18993
  # The following operations are related to `UploadPart`:
18577
18994
  #
18578
18995
  # * [CreateMultipartUpload][2]
18579
18996
  #
18580
- # * [CompleteMultipartUpload][12]
18997
+ # * [CompleteMultipartUpload][13]
18581
18998
  #
18582
- # * [AbortMultipartUpload][13]
18999
+ # * [AbortMultipartUpload][14]
18583
19000
  #
18584
- # * [ListParts][14]
19001
+ # * [ListParts][15]
18585
19002
  #
18586
- # * [ListMultipartUploads][15]
19003
+ # * [ListMultipartUploads][16]
18587
19004
  #
18588
19005
  #
18589
19006
  #
@@ -18592,16 +19009,17 @@ module Aws::S3
18592
19009
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
18593
19010
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
18594
19011
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
18595
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
18596
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
18597
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
18598
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
18599
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
18600
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
18601
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
18602
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
18603
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
18604
- # [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
18605
19023
  #
18606
19024
  # @option params [String, StringIO, File] :body
18607
19025
  # Object data.
@@ -18611,10 +19029,10 @@ module Aws::S3
18611
19029
  #
18612
19030
  # **Directory buckets** - When you use this operation with a directory
18613
19031
  # bucket, you must use virtual-hosted-style requests in the format `
18614
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
18615
- # are not supported. Directory bucket names must be unique in the chosen
18616
- # Availability Zone. Bucket names must follow the format `
18617
- # 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, `
18618
19036
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18619
19037
  # naming restrictions, see [Directory bucket naming rules][1] in the
18620
19038
  # *Amazon S3 User Guide*.
@@ -18895,9 +19313,13 @@ module Aws::S3
18895
19313
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
18896
19314
  # for this API operation to the Zonal endpoint. These endpoints support
18897
19315
  # virtual-hosted-style requests in the format
18898
- # `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name `.
18899
- # Path-style requests are not supported. For more information, see
18900
- # [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*.
18901
19323
  #
18902
19324
  # </note>
18903
19325
  #
@@ -18907,7 +19329,7 @@ module Aws::S3
18907
19329
  # using IAM credentials (access key ID and secret access key for the
18908
19330
  # IAM identities). All headers with the `x-amz-` prefix, including
18909
19331
  # `x-amz-copy-source`, must be signed. For more information, see [REST
18910
- # Authentication][6].
19332
+ # Authentication][7].
18911
19333
  #
18912
19334
  # **Directory buckets** - You must use IAM credentials to authenticate
18913
19335
  # and authorize your access to the `UploadPartCopy` API operation,
@@ -18944,12 +19366,11 @@ module Aws::S3
18944
19366
  # permissions are required because Amazon S3 must decrypt and read
18945
19367
  # data from the encrypted file parts before it completes the
18946
19368
  # multipart upload. For more information about KMS permissions,
18947
- # see [Protecting data using server-side encryption with KMS][7]
19369
+ # see [Protecting data using server-side encryption with KMS][8]
18948
19370
  # in the *Amazon S3 User Guide*. For information about the
18949
19371
  # permissions required to use the multipart upload API, see
18950
- # [Multipart upload and permissions][8] and [Multipart upload API
18951
- # and permissions][9] in the *Amazon S3 User Guide*.
18952
- #
19372
+ # [Multipart upload and permissions][9] and [Multipart upload API
19373
+ # and permissions][10] in the *Amazon S3 User Guide*.
18953
19374
  # * **Directory bucket permissions** - You must have permissions in a
18954
19375
  # bucket policy or an IAM identity-based policy based on the source
18955
19376
  # and destination bucket types in an `UploadPartCopy` operation.
@@ -18967,20 +19388,19 @@ module Aws::S3
18967
19388
  # `Action` element of a policy to write the object to the
18968
19389
  # destination. The `s3express:SessionMode` condition key cannot be
18969
19390
  # set to `ReadOnly` on the copy destination.
18970
- #
18971
19391
  # If the object is encrypted with SSE-KMS, you must also have the
18972
19392
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
18973
19393
  # identity-based policies and KMS key policies for the KMS key.
18974
19394
  #
18975
19395
  # For example policies, see [Example bucket policies for S3 Express
18976
- # One Zone][10] and [Amazon Web Services Identity and Access
19396
+ # One Zone][11] and [Amazon Web Services Identity and Access
18977
19397
  # Management (IAM) identity-based policies for S3 Express One
18978
- # Zone][11] in the *Amazon S3 User Guide*.
19398
+ # Zone][12] in the *Amazon S3 User Guide*.
18979
19399
  #
18980
19400
  # Encryption
18981
19401
  # : * <b>General purpose buckets </b> - For information about using
18982
19402
  # server-side encryption with customer-provided encryption keys with
18983
- # the `UploadPartCopy` operation, see [CopyObject][12] and
19403
+ # the `UploadPartCopy` operation, see [CopyObject][13] and
18984
19404
  # [UploadPart][2].
18985
19405
  #
18986
19406
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -18988,7 +19408,7 @@ module Aws::S3
18988
19408
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
18989
19409
  # server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
18990
19410
  # more information, see [Protecting data with server-side
18991
- # encryption][13] in the *Amazon S3 User Guide*.
19411
+ # encryption][14] in the *Amazon S3 User Guide*.
18992
19412
  #
18993
19413
  # <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
18994
19414
  # operation and an `UploadPartCopy` operation, the request headers
@@ -19000,7 +19420,7 @@ module Aws::S3
19000
19420
  # S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
19001
19421
  # objects from general purpose buckets to directory buckets, from
19002
19422
  # directory buckets to general purpose buckets, or between directory
19003
- # buckets, through [UploadPartCopy][14]. In this case, Amazon S3
19423
+ # buckets, through [UploadPartCopy][15]. In this case, Amazon S3
19004
19424
  # makes a call to KMS every time a copy request is made for a
19005
19425
  # KMS-encrypted object.
19006
19426
  #
@@ -19012,7 +19432,6 @@ module Aws::S3
19012
19432
  # been aborted or completed.
19013
19433
  #
19014
19434
  # * HTTP Status Code: 404 Not Found
19015
- #
19016
19435
  # * Error Code: `InvalidRequest`
19017
19436
  #
19018
19437
  # * Description: The specified copy source is not supported as a
@@ -19023,21 +19442,21 @@ module Aws::S3
19023
19442
  # HTTP Host header syntax
19024
19443
  #
19025
19444
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
19026
- # Bucket_name.s3express-az_id.region.amazonaws.com`.
19445
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
19027
19446
  #
19028
19447
  # The following operations are related to `UploadPartCopy`:
19029
19448
  #
19030
- # * [CreateMultipartUpload][15]
19449
+ # * [CreateMultipartUpload][16]
19031
19450
  #
19032
19451
  # * [UploadPart][2]
19033
19452
  #
19034
- # * [CompleteMultipartUpload][16]
19453
+ # * [CompleteMultipartUpload][17]
19035
19454
  #
19036
- # * [AbortMultipartUpload][17]
19455
+ # * [AbortMultipartUpload][18]
19037
19456
  #
19038
- # * [ListParts][18]
19457
+ # * [ListParts][19]
19039
19458
  #
19040
- # * [ListMultipartUploads][19]
19459
+ # * [ListMultipartUploads][20]
19041
19460
  #
19042
19461
  #
19043
19462
  #
@@ -19046,34 +19465,43 @@ module Aws::S3
19046
19465
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
19047
19466
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
19048
19467
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
19049
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
19050
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19051
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
19052
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
19053
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
19054
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
19055
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
19056
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
19057
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
19058
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
19059
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
19060
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
19061
- # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
19062
- # [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
19063
19483
  #
19064
19484
  # @option params [required, String] :bucket
19065
19485
  # The bucket name.
19066
19486
  #
19067
19487
  # **Directory buckets** - When you use this operation with a directory
19068
19488
  # bucket, you must use virtual-hosted-style requests in the format `
19069
- # Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
19070
- # are not supported. Directory bucket names must be unique in the chosen
19071
- # Availability Zone. Bucket names must follow the format `
19072
- # 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, `
19073
19493
  # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
19074
19494
  # naming restrictions, see [Directory bucket naming rules][1] in the
19075
19495
  # *Amazon S3 User Guide*.
19076
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
+ #
19077
19505
  # **Access points** - When you use this action with an access point, you
19078
19506
  # must provide the alias of the access point in place of the bucket name
19079
19507
  # or specify the access point ARN. When using the access point ARN, you
@@ -19345,45 +19773,45 @@ module Aws::S3
19345
19773
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
19346
19774
  #
19347
19775
  #
19348
- # @example Example: To upload a part by copying byte range from an existing object as data source
19776
+ # @example Example: To upload a part by copying data from an existing object as data source
19349
19777
  #
19350
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
19351
- # # data source.
19778
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
19352
19779
  #
19353
19780
  # resp = client.upload_part_copy({
19354
19781
  # bucket: "examplebucket",
19355
19782
  # copy_source: "/bucketname/sourceobjectkey",
19356
- # copy_source_range: "bytes=1-100000",
19357
19783
  # key: "examplelargeobject",
19358
- # part_number: 2,
19784
+ # part_number: 1,
19359
19785
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
19360
19786
  # })
19361
19787
  #
19362
19788
  # resp.to_h outputs the following:
19363
19789
  # {
19364
19790
  # copy_part_result: {
19365
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
19366
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
19791
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
19792
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
19367
19793
  # },
19368
19794
  # }
19369
19795
  #
19370
- # @example Example: To upload a part by copying data from an existing object as data source
19796
+ # @example Example: To upload a part by copying byte range from an existing object as data source
19371
19797
  #
19372
- # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
19798
+ # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
19799
+ # # data source.
19373
19800
  #
19374
19801
  # resp = client.upload_part_copy({
19375
19802
  # bucket: "examplebucket",
19376
19803
  # copy_source: "/bucketname/sourceobjectkey",
19804
+ # copy_source_range: "bytes=1-100000",
19377
19805
  # key: "examplelargeobject",
19378
- # part_number: 1,
19806
+ # part_number: 2,
19379
19807
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
19380
19808
  # })
19381
19809
  #
19382
19810
  # resp.to_h outputs the following:
19383
19811
  # {
19384
19812
  # copy_part_result: {
19385
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
19386
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
19813
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
19814
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
19387
19815
  # },
19388
19816
  # }
19389
19817
  #
@@ -19436,7 +19864,7 @@ module Aws::S3
19436
19864
  req.send_request(options)
19437
19865
  end
19438
19866
 
19439
- # <note markdown="1"> This operation is not supported by directory buckets.
19867
+ # <note markdown="1"> This operation is not supported for directory buckets.
19440
19868
  #
19441
19869
  # </note>
19442
19870
  #
@@ -19845,7 +20273,7 @@ module Aws::S3
19845
20273
  tracer: tracer
19846
20274
  )
19847
20275
  context[:gem_name] = 'aws-sdk-s3'
19848
- context[:gem_version] = '1.169.0'
20276
+ context[:gem_version] = '1.175.0'
19849
20277
  Seahorse::Client::Request.new(handlers, context)
19850
20278
  end
19851
20279