aws-sdk-s3 1.174.0 → 1.175.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|
|