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