aws-sdk-s3 1.174.0 → 1.176.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 +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +2 -2
- data/lib/aws-sdk-s3/client.rb +1165 -765
- data/lib/aws-sdk-s3/client_api.rb +94 -0
- data/lib/aws-sdk-s3/endpoint_provider.rb +36 -0
- data/lib/aws-sdk-s3/endpoints.rb +42 -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 +532 -116
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +2 -2
- data/sig/client.rbs +36 -3
- data/sig/resource.rbs +2 -2
- data/sig/types.rbs +66 -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
|
# },
|
@@ -2573,6 +2601,90 @@ module Aws::S3
|
|
2573
2601
|
req.send_request(options)
|
2574
2602
|
end
|
2575
2603
|
|
2604
|
+
# Creates a metadata table configuration for a general purpose bucket.
|
2605
|
+
# For more information, see [Accelerating data discovery with S3
|
2606
|
+
# Metadata][1] in the *Amazon S3 User Guide*.
|
2607
|
+
#
|
2608
|
+
# Permissions
|
2609
|
+
#
|
2610
|
+
# : To use this operation, you must have the following permissions. For
|
2611
|
+
# more information, see [Setting up permissions for configuring
|
2612
|
+
# metadata tables][2] in the *Amazon S3 User Guide*.
|
2613
|
+
#
|
2614
|
+
# If you also want to integrate your table bucket with Amazon Web
|
2615
|
+
# Services analytics services so that you can query your metadata
|
2616
|
+
# table, you need additional permissions. For more information, see [
|
2617
|
+
# Integrating Amazon S3 Tables with Amazon Web Services analytics
|
2618
|
+
# services][3] in the *Amazon S3 User Guide*.
|
2619
|
+
#
|
2620
|
+
# * `s3:CreateBucketMetadataTableConfiguration`
|
2621
|
+
#
|
2622
|
+
# * `s3tables:CreateNamespace`
|
2623
|
+
#
|
2624
|
+
# * `s3tables:GetTable`
|
2625
|
+
#
|
2626
|
+
# * `s3tables:CreateTable`
|
2627
|
+
#
|
2628
|
+
# * `s3tables:PutTablePolicy`
|
2629
|
+
#
|
2630
|
+
# The following operations are related to
|
2631
|
+
# `CreateBucketMetadataTableConfiguration`:
|
2632
|
+
#
|
2633
|
+
# * [DeleteBucketMetadataTableConfiguration][4]
|
2634
|
+
#
|
2635
|
+
# * [GetBucketMetadataTableConfiguration][5]
|
2636
|
+
#
|
2637
|
+
#
|
2638
|
+
#
|
2639
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
2640
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
|
2641
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-aws.html
|
2642
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
|
2643
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
|
2644
|
+
#
|
2645
|
+
# @option params [required, String] :bucket
|
2646
|
+
# The general purpose bucket that you want to create the metadata table
|
2647
|
+
# configuration in.
|
2648
|
+
#
|
2649
|
+
# @option params [String] :content_md5
|
2650
|
+
# The `Content-MD5` header for the metadata table configuration.
|
2651
|
+
#
|
2652
|
+
# @option params [String] :checksum_algorithm
|
2653
|
+
# The checksum algorithm to use with your metadata table configuration.
|
2654
|
+
#
|
2655
|
+
# @option params [required, Types::MetadataTableConfiguration] :metadata_table_configuration
|
2656
|
+
# The contents of your metadata table configuration.
|
2657
|
+
#
|
2658
|
+
# @option params [String] :expected_bucket_owner
|
2659
|
+
# The expected owner of the general purpose bucket that contains your
|
2660
|
+
# metadata table configuration.
|
2661
|
+
#
|
2662
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
2663
|
+
#
|
2664
|
+
# @example Request syntax with placeholder values
|
2665
|
+
#
|
2666
|
+
# resp = client.create_bucket_metadata_table_configuration({
|
2667
|
+
# bucket: "BucketName", # required
|
2668
|
+
# content_md5: "ContentMD5",
|
2669
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
2670
|
+
# metadata_table_configuration: { # required
|
2671
|
+
# s3_tables_destination: { # required
|
2672
|
+
# table_bucket_arn: "S3TablesBucketArn", # required
|
2673
|
+
# table_name: "S3TablesName", # required
|
2674
|
+
# },
|
2675
|
+
# },
|
2676
|
+
# expected_bucket_owner: "AccountId",
|
2677
|
+
# })
|
2678
|
+
#
|
2679
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketMetadataTableConfiguration AWS API Documentation
|
2680
|
+
#
|
2681
|
+
# @overload create_bucket_metadata_table_configuration(params = {})
|
2682
|
+
# @param [Hash] params ({})
|
2683
|
+
def create_bucket_metadata_table_configuration(params = {}, options = {})
|
2684
|
+
req = build_request(:create_bucket_metadata_table_configuration, params)
|
2685
|
+
req.send_request(options)
|
2686
|
+
end
|
2687
|
+
|
2576
2688
|
# This action initiates a multipart upload and returns an upload ID.
|
2577
2689
|
# This upload ID is used to associate all of the parts in the specific
|
2578
2690
|
# multipart upload. You specify this upload ID in each of your
|
@@ -2604,9 +2716,13 @@ module Aws::S3
|
|
2604
2716
|
# * <b>Directory buckets </b> - For directory buckets, you must make
|
2605
2717
|
# requests for this API operation to the Zonal endpoint. These
|
2606
2718
|
# 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
|
2719
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
2720
|
+
# `. Path-style requests are not supported. For more information about
|
2721
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
2722
|
+
# for directory buckets in Availability Zones][4] in the *Amazon S3
|
2723
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
2724
|
+
# see [Available Local Zone for directory buckets][5] in the *Amazon
|
2725
|
+
# S3 User Guide*.
|
2610
2726
|
#
|
2611
2727
|
# </note>
|
2612
2728
|
#
|
@@ -2618,7 +2734,7 @@ module Aws::S3
|
|
2618
2734
|
# sign each request individually. There is nothing special about
|
2619
2735
|
# signing multipart upload requests. For more information about
|
2620
2736
|
# signing, see [Authenticating Requests (Amazon Web Services Signature
|
2621
|
-
# Version 4)][
|
2737
|
+
# Version 4)][6] in the *Amazon S3 User Guide*.
|
2622
2738
|
#
|
2623
2739
|
# Permissions
|
2624
2740
|
# : * **General purpose bucket permissions** - To perform a multipart
|
@@ -2631,13 +2747,13 @@ module Aws::S3
|
|
2631
2747
|
# `UploadPartCopy` APIs. These permissions are required because
|
2632
2748
|
# Amazon S3 must decrypt and read data from the encrypted file parts
|
2633
2749
|
# 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][
|
2750
|
+
# see [Multipart upload API and permissions][7] and [Protecting data
|
2751
|
+
# using server-side encryption with Amazon Web Services KMS][8] in
|
2636
2752
|
# the *Amazon S3 User Guide*.
|
2637
2753
|
#
|
2638
2754
|
# * **Directory bucket permissions** - To grant access to this API
|
2639
2755
|
# operation on a directory bucket, we recommend that you use the [
|
2640
|
-
# `CreateSession` ][
|
2756
|
+
# `CreateSession` ][9] API operation for session-based
|
2641
2757
|
# authorization. Specifically, you grant the
|
2642
2758
|
# `s3express:CreateSession` permission to the directory bucket in a
|
2643
2759
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -2648,7 +2764,7 @@ module Aws::S3
|
|
2648
2764
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
2649
2765
|
# refresh the session token automatically to avoid service
|
2650
2766
|
# interruptions when a session expires. For more information about
|
2651
|
-
# authorization, see [ `CreateSession` ][
|
2767
|
+
# authorization, see [ `CreateSession` ][9].
|
2652
2768
|
#
|
2653
2769
|
# Encryption
|
2654
2770
|
# : * **General purpose buckets** - Server-side encryption is for data
|
@@ -2675,7 +2791,7 @@ module Aws::S3
|
|
2675
2791
|
# the destination bucket, the encryption setting in your request
|
2676
2792
|
# takes precedence. If you choose to provide your own encryption
|
2677
2793
|
# key, the request headers you provide in [UploadPart][1] and
|
2678
|
-
# [UploadPartCopy][
|
2794
|
+
# [UploadPartCopy][10] requests must match the headers you used in
|
2679
2795
|
# the `CreateMultipartUpload` request.
|
2680
2796
|
#
|
2681
2797
|
# * Use KMS keys (SSE-KMS) that include the Amazon Web Services
|
@@ -2700,9 +2816,9 @@ module Aws::S3
|
|
2700
2816
|
# actions on the key. These permissions are required because
|
2701
2817
|
# Amazon S3 must decrypt and read data from the encrypted file
|
2702
2818
|
# parts before it completes the multipart upload. For more
|
2703
|
-
# information, see [Multipart upload API and permissions][
|
2819
|
+
# information, see [Multipart upload API and permissions][7] and
|
2704
2820
|
# [Protecting data using server-side encryption with Amazon Web
|
2705
|
-
# Services KMS][
|
2821
|
+
# Services KMS][8] in the *Amazon S3 User Guide*.
|
2706
2822
|
#
|
2707
2823
|
# * If your Identity and Access Management (IAM) user or role is
|
2708
2824
|
# in the same Amazon Web Services account as the KMS key, then
|
@@ -2717,13 +2833,13 @@ module Aws::S3
|
|
2717
2833
|
# For information about configuring any of the officially
|
2718
2834
|
# supported Amazon Web Services SDKs and Amazon Web Services
|
2719
2835
|
# CLI, see [Specifying the Signature Version in Request
|
2720
|
-
# Authentication][
|
2836
|
+
# Authentication][11] in the *Amazon S3 User Guide*.
|
2721
2837
|
#
|
2722
2838
|
# </note>
|
2723
2839
|
#
|
2724
2840
|
# For more information about server-side encryption with KMS keys
|
2725
2841
|
# (SSE-KMS), see [Protecting Data Using Server-Side Encryption
|
2726
|
-
# with KMS keys][
|
2842
|
+
# with KMS keys][8] in the *Amazon S3 User Guide*.
|
2727
2843
|
#
|
2728
2844
|
# * Use customer-provided encryption keys (SSE-C) – If you want to
|
2729
2845
|
# manage your own encryption keys, provide all the following
|
@@ -2737,7 +2853,7 @@ module Aws::S3
|
|
2737
2853
|
# For more information about server-side encryption with
|
2738
2854
|
# customer-provided encryption keys (SSE-C), see [ Protecting data
|
2739
2855
|
# using server-side encryption with customer-provided encryption
|
2740
|
-
# keys (SSE-C)][
|
2856
|
+
# keys (SSE-C)][12] in the *Amazon S3 User Guide*.
|
2741
2857
|
# * **Directory buckets** - For directory buckets, there are only two
|
2742
2858
|
# supported options for server-side encryption: server-side
|
2743
2859
|
# encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
|
@@ -2747,13 +2863,13 @@ module Aws::S3
|
|
2747
2863
|
# default encryption in your `CreateSession` requests or `PUT`
|
2748
2864
|
# object requests. Then, new objects are automatically encrypted
|
2749
2865
|
# with the desired encryption settings. For more information, see
|
2750
|
-
# [Protecting data with server-side encryption][
|
2866
|
+
# [Protecting data with server-side encryption][13] in the *Amazon
|
2751
2867
|
# S3 User Guide*. For more information about the encryption
|
2752
2868
|
# overriding behaviors in directory buckets, see [Specifying
|
2753
|
-
# server-side encryption with KMS for new object uploads][
|
2869
|
+
# server-side encryption with KMS for new object uploads][14].
|
2754
2870
|
#
|
2755
|
-
# In the Zonal endpoint API calls (except [CopyObject][
|
2756
|
-
# [UploadPartCopy][
|
2871
|
+
# In the Zonal endpoint API calls (except [CopyObject][15] and
|
2872
|
+
# [UploadPartCopy][10]) using the REST API, the encryption request
|
2757
2873
|
# headers must match the encryption settings that are specified in
|
2758
2874
|
# the `CreateSession` request. You can't override the values of the
|
2759
2875
|
# encryption settings (`x-amz-server-side-encryption`,
|
@@ -2773,7 +2889,7 @@ module Aws::S3
|
|
2773
2889
|
# configuration for the `CreateSession` request. It's not supported
|
2774
2890
|
# to override the encryption settings values in the `CreateSession`
|
2775
2891
|
# request. So in the Zonal endpoint API calls (except
|
2776
|
-
# [CopyObject][
|
2892
|
+
# [CopyObject][15] and [UploadPartCopy][10]), the encryption request
|
2777
2893
|
# headers must match the default encryption configuration of the
|
2778
2894
|
# directory bucket.
|
2779
2895
|
#
|
@@ -2789,19 +2905,19 @@ module Aws::S3
|
|
2789
2905
|
# HTTP Host header syntax
|
2790
2906
|
#
|
2791
2907
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
2792
|
-
#
|
2908
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
2793
2909
|
#
|
2794
2910
|
# The following operations are related to `CreateMultipartUpload`:
|
2795
2911
|
#
|
2796
2912
|
# * [UploadPart][1]
|
2797
2913
|
#
|
2798
|
-
# * [CompleteMultipartUpload][
|
2914
|
+
# * [CompleteMultipartUpload][16]
|
2799
2915
|
#
|
2800
|
-
# * [AbortMultipartUpload][
|
2916
|
+
# * [AbortMultipartUpload][17]
|
2801
2917
|
#
|
2802
|
-
# * [ListParts][
|
2918
|
+
# * [ListParts][18]
|
2803
2919
|
#
|
2804
|
-
# * [ListMultipartUploads][
|
2920
|
+
# * [ListMultipartUploads][19]
|
2805
2921
|
#
|
2806
2922
|
#
|
2807
2923
|
#
|
@@ -2809,20 +2925,21 @@ module Aws::S3
|
|
2809
2925
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
2810
2926
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
|
2811
2927
|
# [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/
|
2928
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
2929
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
2930
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
2931
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
|
2932
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
2933
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
2934
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
|
2935
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
|
2936
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
2937
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
2938
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
2939
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
2940
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
2941
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
2942
|
+
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
2826
2943
|
#
|
2827
2944
|
# @option params [String] :acl
|
2828
2945
|
# The canned ACL to apply to the object. Amazon S3 supports a set of
|
@@ -2855,10 +2972,10 @@ module Aws::S3
|
|
2855
2972
|
#
|
2856
2973
|
# **Directory buckets** - When you use this operation with a directory
|
2857
2974
|
# 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
|
-
#
|
2975
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
2976
|
+
# requests are not supported. Directory bucket names must be unique in
|
2977
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
2978
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
2862
2979
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
2863
2980
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
2864
2981
|
# *Amazon S3 User Guide*.
|
@@ -3555,23 +3672,27 @@ module Aws::S3
|
|
3555
3672
|
#
|
3556
3673
|
# <note markdown="1"> * You must make requests for this API operation to the Zonal endpoint.
|
3557
3674
|
# 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
|
3675
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
3676
|
+
# Path-style requests are not supported. For more information about
|
3677
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
3678
|
+
# for directory buckets in Availability Zones][3] in the *Amazon S3
|
3679
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
3680
|
+
# see [Available Local Zone for directory buckets][4] in the *Amazon
|
3681
|
+
# S3 User Guide*.
|
3561
3682
|
#
|
3562
3683
|
# * <b> <code>CopyObject</code> API operation</b> - Unlike other Zonal
|
3563
3684
|
# endpoint API operations, the `CopyObject` API operation doesn't use
|
3564
3685
|
# the temporary security credentials returned from the `CreateSession`
|
3565
3686
|
# API operation for authentication and authorization. For information
|
3566
3687
|
# about authentication and authorization of the `CopyObject` API
|
3567
|
-
# operation on directory buckets, see [CopyObject][
|
3688
|
+
# operation on directory buckets, see [CopyObject][5].
|
3568
3689
|
#
|
3569
3690
|
# * <b> <code>HeadBucket</code> API operation</b> - Unlike other Zonal
|
3570
3691
|
# endpoint API operations, the `HeadBucket` API operation doesn't use
|
3571
3692
|
# the temporary security credentials returned from the `CreateSession`
|
3572
3693
|
# API operation for authentication and authorization. For information
|
3573
3694
|
# about authentication and authorization of the `HeadBucket` API
|
3574
|
-
# operation on directory buckets, see [HeadBucket][
|
3695
|
+
# operation on directory buckets, see [HeadBucket][6].
|
3575
3696
|
#
|
3576
3697
|
# </note>
|
3577
3698
|
#
|
@@ -3583,10 +3704,10 @@ module Aws::S3
|
|
3583
3704
|
# can have the `s3express:SessionMode` condition key to control who
|
3584
3705
|
# can create a `ReadWrite` or `ReadOnly` session. For more information
|
3585
3706
|
# about `ReadWrite` or `ReadOnly` sessions, see [
|
3586
|
-
# `x-amz-create-session-mode` ][
|
3587
|
-
# bucket policies for S3 Express One Zone][
|
3707
|
+
# `x-amz-create-session-mode` ][7]. For example policies, see [Example
|
3708
|
+
# bucket policies for S3 Express One Zone][8] and [Amazon Web Services
|
3588
3709
|
# Identity and Access Management (IAM) identity-based policies for S3
|
3589
|
-
# Express One Zone][
|
3710
|
+
# Express One Zone][9] in the *Amazon S3 User Guide*.
|
3590
3711
|
#
|
3591
3712
|
# To grant cross-account access to Zonal endpoint API operations, the
|
3592
3713
|
# bucket policy should also grant both accounts the
|
@@ -3607,32 +3728,32 @@ module Aws::S3
|
|
3607
3728
|
# requests or `PUT` object requests. Then, new objects are
|
3608
3729
|
# automatically encrypted with the desired encryption settings. For
|
3609
3730
|
# more information, see [Protecting data with server-side
|
3610
|
-
# encryption][
|
3731
|
+
# encryption][10] in the *Amazon S3 User Guide*. For more information
|
3611
3732
|
# about the encryption overriding behaviors in directory buckets, see
|
3612
3733
|
# [Specifying server-side encryption with KMS for new object
|
3613
|
-
# uploads][
|
3734
|
+
# uploads][11].
|
3614
3735
|
#
|
3615
|
-
# For [Zonal endpoint (object-level) API operations][
|
3616
|
-
# [CopyObject][
|
3617
|
-
# authorize requests through [CreateSession][
|
3736
|
+
# For [Zonal endpoint (object-level) API operations][12] except
|
3737
|
+
# [CopyObject][5] and [UploadPartCopy][13], you authenticate and
|
3738
|
+
# authorize requests through [CreateSession][14] for low latency. To
|
3618
3739
|
# encrypt new objects in a directory bucket with SSE-KMS, you must
|
3619
3740
|
# specify SSE-KMS as the directory bucket's default encryption
|
3620
3741
|
# configuration with a KMS key (specifically, a [customer managed
|
3621
|
-
# key][
|
3742
|
+
# key][15]). Then, when a session is created for Zonal endpoint API
|
3622
3743
|
# operations, new objects are automatically encrypted and decrypted
|
3623
3744
|
# with SSE-KMS and S3 Bucket Keys during the session.
|
3624
3745
|
#
|
3625
|
-
# <note markdown="1"> Only 1 [customer managed key][
|
3746
|
+
# <note markdown="1"> Only 1 [customer managed key][15] is supported per directory bucket
|
3626
3747
|
# for the lifetime of the bucket. The [Amazon Web Services managed
|
3627
|
-
# key][
|
3748
|
+
# key][16] (`aws/s3`) isn't supported. After you specify SSE-KMS as
|
3628
3749
|
# your bucket's default encryption configuration with a customer
|
3629
3750
|
# managed key, you can't change the customer managed key for the
|
3630
3751
|
# bucket's SSE-KMS configuration.
|
3631
3752
|
#
|
3632
3753
|
# </note>
|
3633
3754
|
#
|
3634
|
-
# In the Zonal endpoint API calls (except [CopyObject][
|
3635
|
-
# [UploadPartCopy][
|
3755
|
+
# In the Zonal endpoint API calls (except [CopyObject][5] and
|
3756
|
+
# [UploadPartCopy][13]) using the REST API, you can't override the
|
3636
3757
|
# values of the encryption settings (`x-amz-server-side-encryption`,
|
3637
3758
|
# `x-amz-server-side-encryption-aws-kms-key-id`,
|
3638
3759
|
# `x-amz-server-side-encryption-context`, and
|
@@ -3648,8 +3769,8 @@ module Aws::S3
|
|
3648
3769
|
# Web Services SDKs use the bucket's default encryption configuration
|
3649
3770
|
# for the `CreateSession` request. It's not supported to override the
|
3650
3771
|
# encryption settings values in the `CreateSession` request. Also, in
|
3651
|
-
# the Zonal endpoint API calls (except [CopyObject][
|
3652
|
-
# [UploadPartCopy][
|
3772
|
+
# the Zonal endpoint API calls (except [CopyObject][5] and
|
3773
|
+
# [UploadPartCopy][13]), it's not supported to override the values of
|
3653
3774
|
# the encryption settings from the `CreateSession` request.
|
3654
3775
|
#
|
3655
3776
|
# </note>
|
@@ -3657,25 +3778,26 @@ module Aws::S3
|
|
3657
3778
|
# HTTP Host header syntax
|
3658
3779
|
#
|
3659
3780
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
3660
|
-
#
|
3781
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
3661
3782
|
#
|
3662
3783
|
#
|
3663
3784
|
#
|
3664
3785
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
|
3665
3786
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-optimizing-performance-guidelines-design-patterns.html#s3-express-optimizing-performance-session-authentication
|
3666
3787
|
# [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#
|
3788
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
3789
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
3790
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
|
3791
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
|
3792
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
3793
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
3794
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
3795
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
3796
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
|
3797
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
3798
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
3799
|
+
# [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
|
3800
|
+
# [16]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
|
3679
3801
|
#
|
3680
3802
|
# @option params [String] :session_mode
|
3681
3803
|
# Specifies the mode of the session that will be created, either
|
@@ -3817,10 +3939,13 @@ module Aws::S3
|
|
3817
3939
|
# * <b>Directory buckets </b> - For directory buckets, you must make
|
3818
3940
|
# requests for this API operation to the Regional endpoint. These
|
3819
3941
|
# endpoints support path-style requests in the format
|
3820
|
-
# `https://s3express-control.
|
3942
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
3821
3943
|
# Virtual-hosted-style requests aren't supported. For more
|
3822
|
-
# information, see [Regional and
|
3823
|
-
#
|
3944
|
+
# information about endpoints in Availability Zones, see [Regional and
|
3945
|
+
# Zonal endpoints for directory buckets in Availability Zones][1] in
|
3946
|
+
# the *Amazon S3 User Guide*. For more information about endpoints in
|
3947
|
+
# Local Zones, see [Available Local Zone for directory buckets][2] in
|
3948
|
+
# the *Amazon S3 User Guide*.
|
3824
3949
|
#
|
3825
3950
|
# </note>
|
3826
3951
|
#
|
@@ -3835,39 +3960,41 @@ module Aws::S3
|
|
3835
3960
|
# performed by the Amazon Web Services account that owns the
|
3836
3961
|
# resource. For more information about directory bucket policies and
|
3837
3962
|
# permissions, see [Amazon Web Services Identity and Access
|
3838
|
-
# Management (IAM) for S3 Express One Zone][
|
3963
|
+
# Management (IAM) for S3 Express One Zone][3] in the *Amazon S3
|
3839
3964
|
# User Guide*.
|
3840
3965
|
#
|
3841
3966
|
# HTTP Host header syntax
|
3842
3967
|
#
|
3843
3968
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
3844
|
-
# `s3express-control.region.amazonaws.com`.
|
3969
|
+
# `s3express-control.region-code.amazonaws.com`.
|
3845
3970
|
#
|
3846
3971
|
# The following operations are related to `DeleteBucket`:
|
3847
3972
|
#
|
3848
|
-
# * [CreateBucket][
|
3973
|
+
# * [CreateBucket][4]
|
3849
3974
|
#
|
3850
|
-
# * [DeleteObject][
|
3975
|
+
# * [DeleteObject][5]
|
3851
3976
|
#
|
3852
3977
|
#
|
3853
3978
|
#
|
3854
3979
|
# [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/
|
3980
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
3981
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
3982
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
3983
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
3858
3984
|
#
|
3859
3985
|
# @option params [required, String] :bucket
|
3860
3986
|
# Specifies the bucket being deleted.
|
3861
3987
|
#
|
3862
3988
|
# <b>Directory buckets </b> - When you use this operation with a
|
3863
3989
|
# directory bucket, you must use path-style requests in the format
|
3864
|
-
# `https://s3express-control.
|
3990
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
3865
3991
|
# 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
|
-
#
|
3992
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
3993
|
+
# Zone). Bucket names must also follow the format `
|
3994
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
3995
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
3996
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
3997
|
+
# *Amazon S3 User Guide*
|
3871
3998
|
#
|
3872
3999
|
#
|
3873
4000
|
#
|
@@ -4076,7 +4203,7 @@ module Aws::S3
|
|
4076
4203
|
# HTTP Host header syntax
|
4077
4204
|
#
|
4078
4205
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
4079
|
-
# `s3express-control.region.amazonaws.com`.
|
4206
|
+
# `s3express-control.region-code.amazonaws.com`.
|
4080
4207
|
#
|
4081
4208
|
# The following operations are related to `DeleteBucketEncryption`:
|
4082
4209
|
#
|
@@ -4100,13 +4227,14 @@ module Aws::S3
|
|
4100
4227
|
#
|
4101
4228
|
# <b>Directory buckets </b> - When you use this operation with a
|
4102
4229
|
# directory bucket, you must use path-style requests in the format
|
4103
|
-
# `https://s3express-control.
|
4230
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
4104
4231
|
# 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
|
-
#
|
4232
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
4233
|
+
# Zone). Bucket names must also follow the format `
|
4234
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
4235
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4236
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4237
|
+
# *Amazon S3 User Guide*
|
4110
4238
|
#
|
4111
4239
|
#
|
4112
4240
|
#
|
@@ -4308,10 +4436,13 @@ module Aws::S3
|
|
4308
4436
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
4309
4437
|
# requests for this API operation to the Regional endpoint. These
|
4310
4438
|
# endpoints support path-style requests in the format
|
4311
|
-
# `https://s3express-control.
|
4439
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name
|
4312
4440
|
# `. Virtual-hosted-style requests aren't supported. For more
|
4313
|
-
# information
|
4314
|
-
#
|
4441
|
+
# information about endpoints in Availability Zones, see [Regional
|
4442
|
+
# and Zonal endpoints for directory buckets in Availability
|
4443
|
+
# Zones][3] in the *Amazon S3 User Guide*. For more information
|
4444
|
+
# about endpoints in Local Zones, see [Available Local Zone for
|
4445
|
+
# directory buckets][4] in the *Amazon S3 User Guide*.
|
4315
4446
|
#
|
4316
4447
|
# </note>
|
4317
4448
|
# ^
|
@@ -4322,22 +4453,23 @@ module Aws::S3
|
|
4322
4453
|
# `s3express-control.region.amazonaws.com`.
|
4323
4454
|
#
|
4324
4455
|
# For more information about the object expiration, see [Elements to
|
4325
|
-
# Describe Lifecycle Actions][
|
4456
|
+
# Describe Lifecycle Actions][5].
|
4326
4457
|
#
|
4327
4458
|
# Related actions include:
|
4328
4459
|
#
|
4329
|
-
# * [PutBucketLifecycleConfiguration][
|
4460
|
+
# * [PutBucketLifecycleConfiguration][6]
|
4330
4461
|
#
|
4331
|
-
# * [GetBucketLifecycleConfiguration][
|
4462
|
+
# * [GetBucketLifecycleConfiguration][7]
|
4332
4463
|
#
|
4333
4464
|
#
|
4334
4465
|
#
|
4335
4466
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
4336
4467
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
4337
4468
|
# [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/
|
4469
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
4470
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
|
4471
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
4472
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
4341
4473
|
#
|
4342
4474
|
# @option params [required, String] :bucket
|
4343
4475
|
# The bucket name of the lifecycle to delete.
|
@@ -4379,6 +4511,57 @@ module Aws::S3
|
|
4379
4511
|
req.send_request(options)
|
4380
4512
|
end
|
4381
4513
|
|
4514
|
+
# Deletes a metadata table configuration from a general purpose bucket.
|
4515
|
+
# For more information, see [Accelerating data discovery with S3
|
4516
|
+
# Metadata][1] in the *Amazon S3 User Guide*.
|
4517
|
+
#
|
4518
|
+
# Permissions
|
4519
|
+
#
|
4520
|
+
# : To use this operation, you must have the
|
4521
|
+
# `s3:DeleteBucketMetadataTableConfiguration` permission. For more
|
4522
|
+
# information, see [Setting up permissions for configuring metadata
|
4523
|
+
# tables][2] in the *Amazon S3 User Guide*.
|
4524
|
+
#
|
4525
|
+
# The following operations are related to
|
4526
|
+
# `DeleteBucketMetadataTableConfiguration`:
|
4527
|
+
#
|
4528
|
+
# * [CreateBucketMetadataTableConfiguration][3]
|
4529
|
+
#
|
4530
|
+
# * [GetBucketMetadataTableConfiguration][4]
|
4531
|
+
#
|
4532
|
+
#
|
4533
|
+
#
|
4534
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
4535
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
|
4536
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataTableConfiguration.html
|
4537
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
|
4538
|
+
#
|
4539
|
+
# @option params [required, String] :bucket
|
4540
|
+
# The general purpose bucket that you want to remove the metadata table
|
4541
|
+
# configuration from.
|
4542
|
+
#
|
4543
|
+
# @option params [String] :expected_bucket_owner
|
4544
|
+
# The expected bucket owner of the general purpose bucket that you want
|
4545
|
+
# to remove the metadata table configuration from.
|
4546
|
+
#
|
4547
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
4548
|
+
#
|
4549
|
+
# @example Request syntax with placeholder values
|
4550
|
+
#
|
4551
|
+
# resp = client.delete_bucket_metadata_table_configuration({
|
4552
|
+
# bucket: "BucketName", # required
|
4553
|
+
# expected_bucket_owner: "AccountId",
|
4554
|
+
# })
|
4555
|
+
#
|
4556
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetadataTableConfiguration AWS API Documentation
|
4557
|
+
#
|
4558
|
+
# @overload delete_bucket_metadata_table_configuration(params = {})
|
4559
|
+
# @param [Hash] params ({})
|
4560
|
+
def delete_bucket_metadata_table_configuration(params = {}, options = {})
|
4561
|
+
req = build_request(:delete_bucket_metadata_table_configuration, params)
|
4562
|
+
req.send_request(options)
|
4563
|
+
end
|
4564
|
+
|
4382
4565
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
4383
4566
|
#
|
4384
4567
|
# </note>
|
@@ -4504,9 +4687,13 @@ module Aws::S3
|
|
4504
4687
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
4505
4688
|
# requests for this API operation to the Regional endpoint. These
|
4506
4689
|
# endpoints support path-style requests in the format
|
4507
|
-
# `https://s3express-control.
|
4508
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
4509
|
-
#
|
4690
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
4691
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
4692
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
4693
|
+
# endpoints for directory buckets in Availability Zones][1] in the
|
4694
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
4695
|
+
# Zones, see [Available Local Zone for directory buckets][2] in the
|
4696
|
+
# *Amazon S3 User Guide*.
|
4510
4697
|
#
|
4511
4698
|
# </note>
|
4512
4699
|
#
|
@@ -4536,7 +4723,7 @@ module Aws::S3
|
|
4536
4723
|
# * **General purpose bucket permissions** - The
|
4537
4724
|
# `s3:DeleteBucketPolicy` permission is required in a policy. For
|
4538
4725
|
# more information about general purpose buckets bucket policies,
|
4539
|
-
# see [Using Bucket Policies and User Policies][
|
4726
|
+
# see [Using Bucket Policies and User Policies][3] in the *Amazon S3
|
4540
4727
|
# User Guide*.
|
4541
4728
|
#
|
4542
4729
|
# * **Directory bucket permissions** - To grant access to this API
|
@@ -4547,39 +4734,41 @@ module Aws::S3
|
|
4547
4734
|
# Services account that owns the resource. For more information
|
4548
4735
|
# about directory bucket policies and permissions, see [Amazon Web
|
4549
4736
|
# Services Identity and Access Management (IAM) for S3 Express One
|
4550
|
-
# Zone][
|
4737
|
+
# Zone][4] in the *Amazon S3 User Guide*.
|
4551
4738
|
#
|
4552
4739
|
# HTTP Host header syntax
|
4553
4740
|
#
|
4554
4741
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
4555
|
-
# `s3express-control.region.amazonaws.com`.
|
4742
|
+
# `s3express-control.region-code.amazonaws.com`.
|
4556
4743
|
#
|
4557
4744
|
# The following operations are related to `DeleteBucketPolicy`
|
4558
4745
|
#
|
4559
|
-
# * [CreateBucket][
|
4746
|
+
# * [CreateBucket][5]
|
4560
4747
|
#
|
4561
|
-
# * [DeleteObject][
|
4748
|
+
# * [DeleteObject][6]
|
4562
4749
|
#
|
4563
4750
|
#
|
4564
4751
|
#
|
4565
4752
|
# [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/
|
4753
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
4754
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
4755
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
4756
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
4757
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
4570
4758
|
#
|
4571
4759
|
# @option params [required, String] :bucket
|
4572
4760
|
# The bucket name.
|
4573
4761
|
#
|
4574
4762
|
# <b>Directory buckets </b> - When you use this operation with a
|
4575
4763
|
# directory bucket, you must use path-style requests in the format
|
4576
|
-
# `https://s3express-control.
|
4764
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
4577
4765
|
# 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
|
-
#
|
4766
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
4767
|
+
# Zone). Bucket names must also follow the format `
|
4768
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
4769
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4770
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4771
|
+
# *Amazon S3 User Guide*
|
4583
4772
|
#
|
4584
4773
|
#
|
4585
4774
|
#
|
@@ -4818,33 +5007,71 @@ module Aws::S3
|
|
4818
5007
|
end
|
4819
5008
|
|
4820
5009
|
# Removes an object from a bucket. The behavior depends on the bucket's
|
4821
|
-
# versioning state
|
4822
|
-
#
|
5010
|
+
# versioning state:
|
5011
|
+
#
|
5012
|
+
# * If bucket versioning is not enabled, the operation permanently
|
5013
|
+
# deletes the object.
|
5014
|
+
#
|
5015
|
+
# * If bucket versioning is enabled, the operation inserts a delete
|
5016
|
+
# marker, which becomes the current version of the object. To
|
5017
|
+
# permanently delete an object in a versioned bucket, you must include
|
5018
|
+
# the object’s `versionId` in the request. For more information about
|
5019
|
+
# versioning-enabled buckets, see [Deleting object versions from a
|
5020
|
+
# versioning-enabled bucket][1].
|
5021
|
+
#
|
5022
|
+
# * If bucket versioning is suspended, the operation removes the object
|
5023
|
+
# that has a null `versionId`, if there is one, and inserts a delete
|
5024
|
+
# marker that becomes the current version of the object. If there
|
5025
|
+
# isn't an object with a null `versionId`, and all versions of the
|
5026
|
+
# object have a `versionId`, Amazon S3 does not remove the object and
|
5027
|
+
# only inserts a delete marker. To permanently delete an object that
|
5028
|
+
# has a `versionId`, you must include the object’s `versionId` in the
|
5029
|
+
# request. For more information about versioning-suspended buckets,
|
5030
|
+
# see [Deleting objects from versioning-suspended buckets][2].
|
5031
|
+
#
|
5032
|
+
# <note markdown="1"> * **Directory buckets** - S3 Versioning isn't enabled and supported
|
5033
|
+
# for directory buckets. For this API operation, only the `null` value
|
5034
|
+
# of the version ID is supported by directory buckets. You can only
|
5035
|
+
# specify `null` to the `versionId` query parameter in the request.
|
5036
|
+
#
|
5037
|
+
# * **Directory buckets** - For directory buckets, you must make
|
5038
|
+
# requests for this API operation to the Zonal endpoint. These
|
5039
|
+
# endpoints support virtual-hosted-style requests in the format
|
5040
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
5041
|
+
# `. Path-style requests are not supported. For more information about
|
5042
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
5043
|
+
# for directory buckets in Availability Zones][3] in the *Amazon S3
|
5044
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
5045
|
+
# see [Available Local Zone for directory buckets][4] in the *Amazon
|
5046
|
+
# S3 User Guide*.
|
5047
|
+
#
|
5048
|
+
# </note>
|
4823
5049
|
#
|
4824
5050
|
# To remove a specific version, you must use the `versionId` query
|
4825
5051
|
# parameter. Using this query parameter permanently deletes the version.
|
4826
5052
|
# 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*.
|
5053
|
+
# header `x-amz-delete-marker` to true.
|
4834
5054
|
#
|
4835
|
-
#
|
4836
|
-
#
|
4837
|
-
#
|
4838
|
-
#
|
5055
|
+
# If the object you want to delete is in a bucket where the bucket
|
5056
|
+
# versioning configuration is MFA Delete enabled, you must include the
|
5057
|
+
# `x-amz-mfa` request header in the DELETE `versionId` request. Requests
|
5058
|
+
# that include `x-amz-mfa` must use HTTPS. For more information about
|
5059
|
+
# MFA Delete, see [Using MFA Delete][5] in the *Amazon S3 User Guide*.
|
5060
|
+
# To see sample requests that use versioning, see [Sample Request][6].
|
4839
5061
|
#
|
4840
|
-
#
|
4841
|
-
#
|
4842
|
-
#
|
4843
|
-
#
|
4844
|
-
#
|
4845
|
-
#
|
5062
|
+
# <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
|
5063
|
+
# buckets.
|
5064
|
+
#
|
5065
|
+
# </note>
|
5066
|
+
#
|
5067
|
+
# You can delete objects by explicitly calling DELETE Object or calling
|
5068
|
+
# ([PutBucketLifecycle][7]) to enable Amazon S3 to remove them for you.
|
5069
|
+
# If you want to block users or accounts from removing or deleting
|
5070
|
+
# objects from your bucket, you must deny them the `s3:DeleteObject`,
|
5071
|
+
# `s3:DeleteObjectVersion`, and `s3:PutLifeCycleConfiguration` actions.
|
4846
5072
|
#
|
4847
|
-
#
|
5073
|
+
# <note markdown="1"> **Directory buckets** - S3 Lifecycle is not supported by directory
|
5074
|
+
# buckets.
|
4848
5075
|
#
|
4849
5076
|
# </note>
|
4850
5077
|
#
|
@@ -4856,51 +5083,56 @@ module Aws::S3
|
|
4856
5083
|
# * <b> <code>s3:DeleteObject</code> </b> - To delete an object from
|
4857
5084
|
# a bucket, you must always have the `s3:DeleteObject` permission.
|
4858
5085
|
#
|
4859
|
-
# <note markdown="1"> You can also use PutBucketLifecycle to delete objects in Amazon
|
4860
|
-
# S3.
|
4861
|
-
#
|
4862
|
-
# </note>
|
4863
|
-
#
|
4864
5086
|
# * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
|
4865
5087
|
# specific version of an object from a versioning-enabled bucket,
|
4866
5088
|
# you must have the `s3:DeleteObjectVersion` permission.
|
4867
|
-
#
|
4868
|
-
#
|
4869
|
-
#
|
4870
|
-
#
|
4871
|
-
#
|
4872
|
-
#
|
4873
|
-
#
|
4874
|
-
#
|
5089
|
+
# * **Directory bucket permissions** - To grant access to this API
|
5090
|
+
# operation on a directory bucket, we recommend that you use the [
|
5091
|
+
# `CreateSession` ][8] API operation for session-based
|
5092
|
+
# authorization. Specifically, you grant the
|
5093
|
+
# `s3express:CreateSession` permission to the directory bucket in a
|
5094
|
+
# bucket policy or an IAM identity-based policy. Then, you make the
|
5095
|
+
# `CreateSession` API call on the bucket to obtain a session token.
|
5096
|
+
# With the session token in your request header, you can make API
|
5097
|
+
# requests to this operation. After the session token expires, you
|
5098
|
+
# make another `CreateSession` API call to generate a new session
|
5099
|
+
# token for use. Amazon Web Services CLI or SDKs create session and
|
5100
|
+
# refresh the session token automatically to avoid service
|
5101
|
+
# interruptions when a session expires. For more information about
|
5102
|
+
# authorization, see [ `CreateSession` ][8].
|
4875
5103
|
#
|
4876
5104
|
# HTTP Host header syntax
|
4877
5105
|
#
|
4878
5106
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
4879
|
-
#
|
5107
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
4880
5108
|
#
|
4881
5109
|
# The following action is related to `DeleteObject`:
|
4882
5110
|
#
|
4883
|
-
# * [PutObject][
|
5111
|
+
# * [PutObject][9]
|
4884
5112
|
#
|
4885
5113
|
# ^
|
4886
5114
|
#
|
4887
5115
|
#
|
4888
5116
|
#
|
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/
|
5117
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
|
5118
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectsfromVersioningSuspendedBuckets.html
|
5119
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
5120
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
5121
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
|
5122
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
|
5123
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
5124
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
5125
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
4894
5126
|
#
|
4895
5127
|
# @option params [required, String] :bucket
|
4896
5128
|
# The bucket name of the bucket containing the object.
|
4897
5129
|
#
|
4898
5130
|
# **Directory buckets** - When you use this operation with a directory
|
4899
5131
|
# 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
|
-
#
|
5132
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
5133
|
+
# requests are not supported. Directory bucket names must be unique in
|
5134
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
5135
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
4904
5136
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4905
5137
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4906
5138
|
# *Amazon S3 User Guide*.
|
@@ -5038,15 +5270,6 @@ module Aws::S3
|
|
5038
5270
|
# * {Types::DeleteObjectOutput#request_charged #request_charged} => String
|
5039
5271
|
#
|
5040
5272
|
#
|
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
5273
|
# @example Example: To delete an object
|
5051
5274
|
#
|
5052
5275
|
# # The following example deletes an object from an S3 bucket.
|
@@ -5060,6 +5283,15 @@ module Aws::S3
|
|
5060
5283
|
# {
|
5061
5284
|
# }
|
5062
5285
|
#
|
5286
|
+
# @example Example: To delete an object (from a non-versioned bucket)
|
5287
|
+
#
|
5288
|
+
# # The following example deletes an object from a non-versioned bucket.
|
5289
|
+
#
|
5290
|
+
# resp = client.delete_object({
|
5291
|
+
# bucket: "ExampleBucket",
|
5292
|
+
# key: "HappyFace.jpg",
|
5293
|
+
# })
|
5294
|
+
#
|
5063
5295
|
# @example Request syntax with placeholder values
|
5064
5296
|
#
|
5065
5297
|
# resp = client.delete_object({
|
@@ -5233,9 +5465,13 @@ module Aws::S3
|
|
5233
5465
|
# * **Directory buckets** - For directory buckets, you must make
|
5234
5466
|
# requests for this API operation to the Zonal endpoint. These
|
5235
5467
|
# 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
|
5468
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
5469
|
+
# `. Path-style requests are not supported. For more information about
|
5470
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
5471
|
+
# for directory buckets in Availability Zones][1] in the *Amazon S3
|
5472
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
5473
|
+
# see [Available Local Zone for directory buckets][2] in the *Amazon
|
5474
|
+
# S3 User Guide*.
|
5239
5475
|
#
|
5240
5476
|
# </note>
|
5241
5477
|
#
|
@@ -5253,7 +5489,7 @@ module Aws::S3
|
|
5253
5489
|
# if there are non-versioned objects you are trying to delete. If you
|
5254
5490
|
# provide an invalid token, whether there are versioned keys in the
|
5255
5491
|
# request or not, the entire Multi-Object Delete request will fail. For
|
5256
|
-
# information about MFA Delete, see [MFA Delete][
|
5492
|
+
# information about MFA Delete, see [MFA Delete][3] in the *Amazon S3
|
5257
5493
|
# User Guide*.
|
5258
5494
|
#
|
5259
5495
|
# <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
|
@@ -5275,7 +5511,7 @@ module Aws::S3
|
|
5275
5511
|
# you must specify the `s3:DeleteObjectVersion` permission.
|
5276
5512
|
# * **Directory bucket permissions** - To grant access to this API
|
5277
5513
|
# operation on a directory bucket, we recommend that you use the [
|
5278
|
-
# `CreateSession` ][
|
5514
|
+
# `CreateSession` ][4] API operation for session-based
|
5279
5515
|
# authorization. Specifically, you grant the
|
5280
5516
|
# `s3express:CreateSession` permission to the directory bucket in a
|
5281
5517
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -5286,7 +5522,7 @@ module Aws::S3
|
|
5286
5522
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
5287
5523
|
# refresh the session token automatically to avoid service
|
5288
5524
|
# interruptions when a session expires. For more information about
|
5289
|
-
# authorization, see [ `CreateSession` ][
|
5525
|
+
# authorization, see [ `CreateSession` ][4].
|
5290
5526
|
#
|
5291
5527
|
# Content-MD5 request header
|
5292
5528
|
# : * **General purpose bucket** - The Content-MD5 request header is
|
@@ -5303,40 +5539,41 @@ module Aws::S3
|
|
5303
5539
|
# HTTP Host header syntax
|
5304
5540
|
#
|
5305
5541
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
5306
|
-
#
|
5542
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
5307
5543
|
#
|
5308
5544
|
# The following operations are related to `DeleteObjects`:
|
5309
5545
|
#
|
5310
|
-
# * [CreateMultipartUpload][
|
5546
|
+
# * [CreateMultipartUpload][5]
|
5311
5547
|
#
|
5312
|
-
# * [UploadPart][
|
5548
|
+
# * [UploadPart][6]
|
5313
5549
|
#
|
5314
|
-
# * [CompleteMultipartUpload][
|
5550
|
+
# * [CompleteMultipartUpload][7]
|
5315
5551
|
#
|
5316
|
-
# * [ListParts][
|
5552
|
+
# * [ListParts][8]
|
5317
5553
|
#
|
5318
|
-
# * [AbortMultipartUpload][
|
5554
|
+
# * [AbortMultipartUpload][9]
|
5319
5555
|
#
|
5320
5556
|
#
|
5321
5557
|
#
|
5322
5558
|
# [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/
|
5559
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
5560
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
|
5561
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
5562
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
5563
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
5564
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
5565
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
5566
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
5330
5567
|
#
|
5331
5568
|
# @option params [required, String] :bucket
|
5332
5569
|
# The bucket name containing the objects to delete.
|
5333
5570
|
#
|
5334
5571
|
# **Directory buckets** - When you use this operation with a directory
|
5335
5572
|
# 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
|
-
#
|
5573
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
5574
|
+
# requests are not supported. Directory bucket names must be unique in
|
5575
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
5576
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
5340
5577
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
5341
5578
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
5342
5579
|
# *Amazon S3 User Guide*.
|
@@ -5471,22 +5708,20 @@ module Aws::S3
|
|
5471
5708
|
# * {Types::DeleteObjectsOutput#errors #errors} => Array<Types::Error>
|
5472
5709
|
#
|
5473
5710
|
#
|
5474
|
-
# @example Example: To delete multiple
|
5711
|
+
# @example Example: To delete multiple objects from a versioned bucket
|
5475
5712
|
#
|
5476
|
-
# # The following example deletes objects from a bucket. The
|
5477
|
-
# #
|
5713
|
+
# # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
|
5714
|
+
# # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
|
5478
5715
|
#
|
5479
5716
|
# resp = client.delete_objects({
|
5480
5717
|
# bucket: "examplebucket",
|
5481
5718
|
# delete: {
|
5482
5719
|
# objects: [
|
5483
5720
|
# {
|
5484
|
-
# key: "
|
5485
|
-
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
5721
|
+
# key: "objectkey1",
|
5486
5722
|
# },
|
5487
5723
|
# {
|
5488
|
-
# key: "
|
5489
|
-
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
5724
|
+
# key: "objectkey2",
|
5490
5725
|
# },
|
5491
5726
|
# ],
|
5492
5727
|
# quiet: false,
|
@@ -5497,30 +5732,34 @@ module Aws::S3
|
|
5497
5732
|
# {
|
5498
5733
|
# deleted: [
|
5499
5734
|
# {
|
5500
|
-
#
|
5501
|
-
#
|
5735
|
+
# delete_marker: true,
|
5736
|
+
# delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
|
5737
|
+
# key: "objectkey1",
|
5502
5738
|
# },
|
5503
5739
|
# {
|
5504
|
-
#
|
5505
|
-
#
|
5740
|
+
# delete_marker: true,
|
5741
|
+
# delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
|
5742
|
+
# key: "objectkey2",
|
5506
5743
|
# },
|
5507
5744
|
# ],
|
5508
5745
|
# }
|
5509
5746
|
#
|
5510
|
-
# @example Example: To delete multiple
|
5747
|
+
# @example Example: To delete multiple object versions from a versioned bucket
|
5511
5748
|
#
|
5512
|
-
# # The following example deletes objects from a bucket. The
|
5513
|
-
# #
|
5749
|
+
# # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
|
5750
|
+
# # versions and returns the key and versions of deleted objects in the response.
|
5514
5751
|
#
|
5515
5752
|
# resp = client.delete_objects({
|
5516
5753
|
# bucket: "examplebucket",
|
5517
5754
|
# delete: {
|
5518
5755
|
# objects: [
|
5519
5756
|
# {
|
5520
|
-
# key: "
|
5757
|
+
# key: "HappyFace.jpg",
|
5758
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
5521
5759
|
# },
|
5522
5760
|
# {
|
5523
|
-
# key: "
|
5761
|
+
# key: "HappyFace.jpg",
|
5762
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
5524
5763
|
# },
|
5525
5764
|
# ],
|
5526
5765
|
# quiet: false,
|
@@ -5531,14 +5770,12 @@ module Aws::S3
|
|
5531
5770
|
# {
|
5532
5771
|
# deleted: [
|
5533
5772
|
# {
|
5534
|
-
#
|
5535
|
-
#
|
5536
|
-
# key: "objectkey1",
|
5773
|
+
# key: "HappyFace.jpg",
|
5774
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
5537
5775
|
# },
|
5538
5776
|
# {
|
5539
|
-
#
|
5540
|
-
#
|
5541
|
-
# key: "objectkey2",
|
5777
|
+
# key: "HappyFace.jpg",
|
5778
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
5542
5779
|
# },
|
5543
5780
|
# ],
|
5544
5781
|
# }
|
@@ -6083,7 +6320,7 @@ module Aws::S3
|
|
6083
6320
|
# HTTP Host header syntax
|
6084
6321
|
#
|
6085
6322
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
6086
|
-
# `s3express-control.region.amazonaws.com`.
|
6323
|
+
# `s3express-control.region-code.amazonaws.com`.
|
6087
6324
|
#
|
6088
6325
|
# The following operations are related to `GetBucketEncryption`:
|
6089
6326
|
#
|
@@ -6107,13 +6344,14 @@ module Aws::S3
|
|
6107
6344
|
#
|
6108
6345
|
# <b>Directory buckets </b> - When you use this operation with a
|
6109
6346
|
# directory bucket, you must use path-style requests in the format
|
6110
|
-
# `https://s3express-control.
|
6347
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
6111
6348
|
# 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
|
-
#
|
6349
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
6350
|
+
# Zone). Bucket names must also follow the format `
|
6351
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
6352
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
6353
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
6354
|
+
# *Amazon S3 User Guide*
|
6117
6355
|
#
|
6118
6356
|
#
|
6119
6357
|
#
|
@@ -6490,10 +6728,13 @@ module Aws::S3
|
|
6490
6728
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
6491
6729
|
# requests for this API operation to the Regional endpoint. These
|
6492
6730
|
# endpoints support path-style requests in the format
|
6493
|
-
# `https://s3express-control.
|
6731
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name
|
6494
6732
|
# `. Virtual-hosted-style requests aren't supported. For more
|
6495
|
-
# information
|
6496
|
-
#
|
6733
|
+
# information about endpoints in Availability Zones, see [Regional
|
6734
|
+
# and Zonal endpoints for directory buckets in Availability
|
6735
|
+
# Zones][5] in the *Amazon S3 User Guide*. For more information
|
6736
|
+
# about endpoints in Local Zones, see [Available Local Zone for
|
6737
|
+
# directory buckets][6] in the *Amazon S3 User Guide*.
|
6497
6738
|
#
|
6498
6739
|
# </note>
|
6499
6740
|
#
|
@@ -6517,9 +6758,9 @@ module Aws::S3
|
|
6517
6758
|
#
|
6518
6759
|
# * [GetBucketLifecycle][2]
|
6519
6760
|
#
|
6520
|
-
# * [PutBucketLifecycle][
|
6761
|
+
# * [PutBucketLifecycle][7]
|
6521
6762
|
#
|
6522
|
-
# * [DeleteBucketLifecycle][
|
6763
|
+
# * [DeleteBucketLifecycle][8]
|
6523
6764
|
#
|
6524
6765
|
#
|
6525
6766
|
#
|
@@ -6528,8 +6769,9 @@ module Aws::S3
|
|
6528
6769
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
6529
6770
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
6530
6771
|
# [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/
|
6772
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
6773
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
6774
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
6533
6775
|
#
|
6534
6776
|
# @option params [required, String] :bucket
|
6535
6777
|
# The name of the bucket for which to get the lifecycle information.
|
@@ -6780,6 +7022,69 @@ module Aws::S3
|
|
6780
7022
|
req.send_request(options)
|
6781
7023
|
end
|
6782
7024
|
|
7025
|
+
# Retrieves the metadata table configuration for a general purpose
|
7026
|
+
# bucket. For more information, see [Accelerating data discovery with S3
|
7027
|
+
# Metadata][1] in the *Amazon S3 User Guide*.
|
7028
|
+
#
|
7029
|
+
# Permissions
|
7030
|
+
#
|
7031
|
+
# : To use this operation, you must have the
|
7032
|
+
# `s3:GetBucketMetadataTableConfiguration` permission. For more
|
7033
|
+
# information, see [Setting up permissions for configuring metadata
|
7034
|
+
# tables][2] in the *Amazon S3 User Guide*.
|
7035
|
+
#
|
7036
|
+
# The following operations are related to
|
7037
|
+
# `GetBucketMetadataTableConfiguration`:
|
7038
|
+
#
|
7039
|
+
# * [CreateBucketMetadataTableConfiguration][3]
|
7040
|
+
#
|
7041
|
+
# * [DeleteBucketMetadataTableConfiguration][4]
|
7042
|
+
#
|
7043
|
+
#
|
7044
|
+
#
|
7045
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
7046
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
|
7047
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataTableConfiguration.html
|
7048
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
|
7049
|
+
#
|
7050
|
+
# @option params [required, String] :bucket
|
7051
|
+
# The general purpose bucket that contains the metadata table
|
7052
|
+
# configuration that you want to retrieve.
|
7053
|
+
#
|
7054
|
+
# @option params [String] :expected_bucket_owner
|
7055
|
+
# The expected owner of the general purpose bucket that you want to
|
7056
|
+
# retrieve the metadata table configuration from.
|
7057
|
+
#
|
7058
|
+
# @return [Types::GetBucketMetadataTableConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
7059
|
+
#
|
7060
|
+
# * {Types::GetBucketMetadataTableConfigurationOutput#get_bucket_metadata_table_configuration_result #get_bucket_metadata_table_configuration_result} => Types::GetBucketMetadataTableConfigurationResult
|
7061
|
+
#
|
7062
|
+
# @example Request syntax with placeholder values
|
7063
|
+
#
|
7064
|
+
# resp = client.get_bucket_metadata_table_configuration({
|
7065
|
+
# bucket: "BucketName", # required
|
7066
|
+
# expected_bucket_owner: "AccountId",
|
7067
|
+
# })
|
7068
|
+
#
|
7069
|
+
# @example Response structure
|
7070
|
+
#
|
7071
|
+
# resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_bucket_arn #=> String
|
7072
|
+
# resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_name #=> String
|
7073
|
+
# resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_arn #=> String
|
7074
|
+
# resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_namespace #=> String
|
7075
|
+
# resp.get_bucket_metadata_table_configuration_result.status #=> String
|
7076
|
+
# resp.get_bucket_metadata_table_configuration_result.error.error_code #=> String
|
7077
|
+
# resp.get_bucket_metadata_table_configuration_result.error.error_message #=> String
|
7078
|
+
#
|
7079
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataTableConfiguration AWS API Documentation
|
7080
|
+
#
|
7081
|
+
# @overload get_bucket_metadata_table_configuration(params = {})
|
7082
|
+
# @param [Hash] params ({})
|
7083
|
+
def get_bucket_metadata_table_configuration(params = {}, options = {})
|
7084
|
+
req = build_request(:get_bucket_metadata_table_configuration, params)
|
7085
|
+
req.send_request(options)
|
7086
|
+
end
|
7087
|
+
|
6783
7088
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
6784
7089
|
#
|
6785
7090
|
# </note>
|
@@ -7174,9 +7479,13 @@ module Aws::S3
|
|
7174
7479
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
7175
7480
|
# requests for this API operation to the Regional endpoint. These
|
7176
7481
|
# endpoints support path-style requests in the format
|
7177
|
-
# `https://s3express-control.
|
7178
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
7179
|
-
#
|
7482
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
7483
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
7484
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
7485
|
+
# endpoints for directory buckets in Availability Zones][1] in the
|
7486
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
7487
|
+
# Zones, see [Available Local Zone for directory buckets][2] in the
|
7488
|
+
# *Amazon S3 User Guide*.
|
7180
7489
|
#
|
7181
7490
|
# </note>
|
7182
7491
|
#
|
@@ -7206,7 +7515,7 @@ module Aws::S3
|
|
7206
7515
|
# * **General purpose bucket permissions** - The `s3:GetBucketPolicy`
|
7207
7516
|
# permission is required in a policy. For more information about
|
7208
7517
|
# general purpose buckets bucket policies, see [Using Bucket
|
7209
|
-
# Policies and User Policies][
|
7518
|
+
# Policies and User Policies][3] in the *Amazon S3 User Guide*.
|
7210
7519
|
#
|
7211
7520
|
# * **Directory bucket permissions** - To grant access to this API
|
7212
7521
|
# operation, you must have the `s3express:GetBucketPolicy`
|
@@ -7216,48 +7525,50 @@ module Aws::S3
|
|
7216
7525
|
# Services account that owns the resource. For more information
|
7217
7526
|
# about directory bucket policies and permissions, see [Amazon Web
|
7218
7527
|
# Services Identity and Access Management (IAM) for S3 Express One
|
7219
|
-
# Zone][
|
7528
|
+
# Zone][4] in the *Amazon S3 User Guide*.
|
7220
7529
|
#
|
7221
7530
|
# Example bucket policies
|
7222
7531
|
#
|
7223
7532
|
# : **General purpose buckets example bucket policies** - See [Bucket
|
7224
|
-
# policy examples][
|
7533
|
+
# policy examples][5] in the *Amazon S3 User Guide*.
|
7225
7534
|
#
|
7226
7535
|
# **Directory bucket example bucket policies** - See [Example bucket
|
7227
|
-
# policies for S3 Express One Zone][
|
7536
|
+
# policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
|
7228
7537
|
#
|
7229
7538
|
# HTTP Host header syntax
|
7230
7539
|
#
|
7231
7540
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
7232
|
-
# `s3express-control.region.amazonaws.com`.
|
7541
|
+
# `s3express-control.region-code.amazonaws.com`.
|
7233
7542
|
#
|
7234
7543
|
# The following action is related to `GetBucketPolicy`:
|
7235
7544
|
#
|
7236
|
-
# * [GetObject][
|
7545
|
+
# * [GetObject][7]
|
7237
7546
|
#
|
7238
7547
|
# ^
|
7239
7548
|
#
|
7240
7549
|
#
|
7241
7550
|
#
|
7242
7551
|
# [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/
|
7552
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
7553
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
7554
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
7555
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
|
7556
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
7557
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
7248
7558
|
#
|
7249
7559
|
# @option params [required, String] :bucket
|
7250
7560
|
# The bucket name to get the bucket policy for.
|
7251
7561
|
#
|
7252
7562
|
# <b>Directory buckets </b> - When you use this operation with a
|
7253
7563
|
# directory bucket, you must use path-style requests in the format
|
7254
|
-
# `https://s3express-control.
|
7564
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
7255
7565
|
# 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
|
-
#
|
7566
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
7567
|
+
# Zone). Bucket names must also follow the format `
|
7568
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
7569
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
7570
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
7571
|
+
# *Amazon S3 User Guide*
|
7261
7572
|
#
|
7262
7573
|
# **Access points** - When you use this API operation with an access
|
7263
7574
|
# point, provide the alias of the access point in place of the bucket
|
@@ -7860,9 +8171,13 @@ module Aws::S3
|
|
7860
8171
|
# `/photos/2006/February/sample.jpg`. Also, when you make requests to
|
7861
8172
|
# this API operation, your requests are sent to the Zonal endpoint.
|
7862
8173
|
# 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
|
8174
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
8175
|
+
# `. Path-style requests are not supported. For more information about
|
8176
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
8177
|
+
# directory buckets in Availability Zones][2] in the *Amazon S3 User
|
8178
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
8179
|
+
# [Available Local Zone for directory buckets][3] in the *Amazon S3 User
|
8180
|
+
# Guide*.
|
7866
8181
|
#
|
7867
8182
|
# Permissions
|
7868
8183
|
# : * **General purpose bucket permissions** - You must have the
|
@@ -7870,7 +8185,7 @@ module Aws::S3
|
|
7870
8185
|
# have the `READ` access to the object (or version). If you grant
|
7871
8186
|
# `READ` access to the anonymous user, the `GetObject` operation
|
7872
8187
|
# returns the object without using an authorization header. For more
|
7873
|
-
# information, see [Specifying permissions in a policy][
|
8188
|
+
# information, see [Specifying permissions in a policy][4] in the
|
7874
8189
|
# *Amazon S3 User Guide*.
|
7875
8190
|
#
|
7876
8191
|
# If you include a `versionId` in your request header, you must have
|
@@ -7894,7 +8209,7 @@ module Aws::S3
|
|
7894
8209
|
# returns an HTTP status code `403 Access Denied` error.
|
7895
8210
|
# * **Directory bucket permissions** - To grant access to this API
|
7896
8211
|
# operation on a directory bucket, we recommend that you use the [
|
7897
|
-
# `CreateSession` ][
|
8212
|
+
# `CreateSession` ][5] API operation for session-based
|
7898
8213
|
# authorization. Specifically, you grant the
|
7899
8214
|
# `s3express:CreateSession` permission to the directory bucket in a
|
7900
8215
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -7905,7 +8220,7 @@ module Aws::S3
|
|
7905
8220
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
7906
8221
|
# refresh the session token automatically to avoid service
|
7907
8222
|
# interruptions when a session expires. For more information about
|
7908
|
-
# authorization, see [ `CreateSession` ][
|
8223
|
+
# authorization, see [ `CreateSession` ][5].
|
7909
8224
|
#
|
7910
8225
|
# If the object is encrypted using SSE-KMS, you must also have the
|
7911
8226
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -7918,9 +8233,9 @@ module Aws::S3
|
|
7918
8233
|
# storage class, the S3 Intelligent-Tiering Archive Access tier, or
|
7919
8234
|
# the S3 Intelligent-Tiering Deep Archive Access tier, before you can
|
7920
8235
|
# retrieve the object you must first restore a copy using
|
7921
|
-
# [RestoreObject][
|
8236
|
+
# [RestoreObject][6]. Otherwise, this operation returns an
|
7922
8237
|
# `InvalidObjectState` error. For information about restoring archived
|
7923
|
-
# objects, see [Restoring Archived Objects][
|
8238
|
+
# objects, see [Restoring Archived Objects][7] in the *Amazon S3 User
|
7924
8239
|
# Guide*.
|
7925
8240
|
#
|
7926
8241
|
# <b>Directory buckets </b> - For directory buckets, only the S3
|
@@ -7942,7 +8257,7 @@ module Aws::S3
|
|
7942
8257
|
# **Directory buckets** - For directory buckets, there are only two
|
7943
8258
|
# supported options for server-side encryption: SSE-S3 and SSE-KMS.
|
7944
8259
|
# SSE-C isn't supported. For more information, see [Protecting data
|
7945
|
-
# with server-side encryption][
|
8260
|
+
# with server-side encryption][8] in the *Amazon S3 User Guide*.
|
7946
8261
|
#
|
7947
8262
|
# Overriding response header values through the request
|
7948
8263
|
#
|
@@ -7987,25 +8302,26 @@ module Aws::S3
|
|
7987
8302
|
# HTTP Host header syntax
|
7988
8303
|
#
|
7989
8304
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
7990
|
-
#
|
8305
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
7991
8306
|
#
|
7992
8307
|
# The following operations are related to `GetObject`:
|
7993
8308
|
#
|
7994
|
-
# * [ListBuckets][
|
8309
|
+
# * [ListBuckets][9]
|
7995
8310
|
#
|
7996
|
-
# * [GetObjectAcl][
|
8311
|
+
# * [GetObjectAcl][10]
|
7997
8312
|
#
|
7998
8313
|
#
|
7999
8314
|
#
|
8000
8315
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
|
8001
8316
|
# [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/
|
8317
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
8318
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
8319
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
8320
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
|
8321
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
|
8322
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
8323
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
|
8324
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
|
8009
8325
|
#
|
8010
8326
|
# @option params [String, IO] :response_target
|
8011
8327
|
# Where to write response data, file path, or IO object.
|
@@ -8015,10 +8331,10 @@ module Aws::S3
|
|
8015
8331
|
#
|
8016
8332
|
# **Directory buckets** - When you use this operation with a directory
|
8017
8333
|
# 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
|
-
#
|
8334
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
8335
|
+
# requests are not supported. Directory bucket names must be unique in
|
8336
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
8337
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
8022
8338
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
8023
8339
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
8024
8340
|
# *Amazon S3 User Guide*.
|
@@ -8352,49 +8668,49 @@ module Aws::S3
|
|
8352
8668
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
8353
8669
|
#
|
8354
8670
|
#
|
8355
|
-
# @example Example: To retrieve an object
|
8671
|
+
# @example Example: To retrieve a byte range of an object
|
8356
8672
|
#
|
8357
|
-
# # The following example retrieves an object for an S3 bucket.
|
8673
|
+
# # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
|
8674
|
+
# # specific byte range.
|
8358
8675
|
#
|
8359
8676
|
# resp = client.get_object({
|
8360
8677
|
# bucket: "examplebucket",
|
8361
|
-
# key: "
|
8678
|
+
# key: "SampleFile.txt",
|
8679
|
+
# range: "bytes=0-9",
|
8362
8680
|
# })
|
8363
8681
|
#
|
8364
8682
|
# resp.to_h outputs the following:
|
8365
8683
|
# {
|
8366
8684
|
# accept_ranges: "bytes",
|
8367
|
-
# content_length:
|
8368
|
-
#
|
8369
|
-
#
|
8370
|
-
#
|
8685
|
+
# content_length: 10,
|
8686
|
+
# content_range: "bytes 0-9/43",
|
8687
|
+
# content_type: "text/plain",
|
8688
|
+
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
8689
|
+
# last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
|
8371
8690
|
# metadata: {
|
8372
8691
|
# },
|
8373
|
-
# tag_count: 2,
|
8374
8692
|
# version_id: "null",
|
8375
8693
|
# }
|
8376
8694
|
#
|
8377
|
-
# @example Example: To retrieve
|
8695
|
+
# @example Example: To retrieve an object
|
8378
8696
|
#
|
8379
|
-
# # The following example retrieves an object for an S3 bucket.
|
8380
|
-
# # specific byte range.
|
8697
|
+
# # The following example retrieves an object for an S3 bucket.
|
8381
8698
|
#
|
8382
8699
|
# resp = client.get_object({
|
8383
8700
|
# bucket: "examplebucket",
|
8384
|
-
# key: "
|
8385
|
-
# range: "bytes=0-9",
|
8701
|
+
# key: "HappyFace.jpg",
|
8386
8702
|
# })
|
8387
8703
|
#
|
8388
8704
|
# resp.to_h outputs the following:
|
8389
8705
|
# {
|
8390
8706
|
# accept_ranges: "bytes",
|
8391
|
-
# content_length:
|
8392
|
-
#
|
8393
|
-
#
|
8394
|
-
#
|
8395
|
-
# last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
|
8707
|
+
# content_length: 3191,
|
8708
|
+
# content_type: "image/jpeg",
|
8709
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
8710
|
+
# last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
|
8396
8711
|
# metadata: {
|
8397
8712
|
# },
|
8713
|
+
# tag_count: 2,
|
8398
8714
|
# version_id: "null",
|
8399
8715
|
# }
|
8400
8716
|
#
|
@@ -8698,9 +9014,13 @@ module Aws::S3
|
|
8698
9014
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
8699
9015
|
# for this API operation to the Zonal endpoint. These endpoints support
|
8700
9016
|
# virtual-hosted-style requests in the format
|
8701
|
-
# `https://
|
8702
|
-
# Path-style requests are not supported. For more information
|
8703
|
-
# [Regional and Zonal endpoints
|
9017
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
9018
|
+
# `. Path-style requests are not supported. For more information about
|
9019
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
9020
|
+
# directory buckets in Availability Zones][1] in the *Amazon S3 User
|
9021
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
9022
|
+
# [Available Local Zone for directory buckets][2] in the *Amazon S3 User
|
9023
|
+
# Guide*.
|
8704
9024
|
#
|
8705
9025
|
# </note>
|
8706
9026
|
#
|
@@ -8713,7 +9033,7 @@ module Aws::S3
|
|
8713
9033
|
# `s3:GetObjectVersionAttributes` permissions for this operation. If
|
8714
9034
|
# the bucket is not versioned, you need the `s3:GetObject` and
|
8715
9035
|
# `s3:GetObjectAttributes` permissions. For more information, see
|
8716
|
-
# [Specifying Permissions in a Policy][
|
9036
|
+
# [Specifying Permissions in a Policy][3] in the *Amazon S3 User
|
8717
9037
|
# Guide*. If the object that you request does not exist, the error
|
8718
9038
|
# Amazon S3 returns depends on whether you also have the
|
8719
9039
|
# `s3:ListBucket` permission.
|
@@ -8727,7 +9047,7 @@ module Aws::S3
|
|
8727
9047
|
# error.
|
8728
9048
|
# * **Directory bucket permissions** - To grant access to this API
|
8729
9049
|
# operation on a directory bucket, we recommend that you use the [
|
8730
|
-
# `CreateSession` ][
|
9050
|
+
# `CreateSession` ][4] API operation for session-based
|
8731
9051
|
# authorization. Specifically, you grant the
|
8732
9052
|
# `s3express:CreateSession` permission to the directory bucket in a
|
8733
9053
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -8738,7 +9058,7 @@ module Aws::S3
|
|
8738
9058
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
8739
9059
|
# refresh the session token automatically to avoid service
|
8740
9060
|
# interruptions when a session expires. For more information about
|
8741
|
-
# authorization, see [ `CreateSession` ][
|
9061
|
+
# authorization, see [ `CreateSession` ][4].
|
8742
9062
|
#
|
8743
9063
|
# If the object is encrypted with SSE-KMS, you must also have the
|
8744
9064
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -8774,7 +9094,7 @@ module Aws::S3
|
|
8774
9094
|
# * `x-amz-server-side-encryption-customer-key-MD5`
|
8775
9095
|
#
|
8776
9096
|
# For more information about SSE-C, see [Server-Side Encryption (Using
|
8777
|
-
# Customer-Provided Encryption Keys)][
|
9097
|
+
# Customer-Provided Encryption Keys)][5] in the *Amazon S3 User
|
8778
9098
|
# Guide*.
|
8779
9099
|
#
|
8780
9100
|
# <note markdown="1"> **Directory bucket permissions** - For directory buckets, there are
|
@@ -8786,10 +9106,10 @@ module Aws::S3
|
|
8786
9106
|
# encryption in your `CreateSession` requests or `PUT` object
|
8787
9107
|
# requests. Then, new objects are automatically encrypted with the
|
8788
9108
|
# desired encryption settings. For more information, see [Protecting
|
8789
|
-
# data with server-side encryption][
|
9109
|
+
# data with server-side encryption][6] in the *Amazon S3 User Guide*.
|
8790
9110
|
# For more information about the encryption overriding behaviors in
|
8791
9111
|
# directory buckets, see [Specifying server-side encryption with KMS
|
8792
|
-
# for new object uploads][
|
9112
|
+
# for new object uploads][7].
|
8793
9113
|
#
|
8794
9114
|
# </note>
|
8795
9115
|
#
|
@@ -8812,7 +9132,7 @@ module Aws::S3
|
|
8812
9132
|
#
|
8813
9133
|
# * `If-Unmodified-Since` condition evaluates to `false`.
|
8814
9134
|
# For more information about conditional requests, see [RFC
|
8815
|
-
# 7232][
|
9135
|
+
# 7232][8].
|
8816
9136
|
#
|
8817
9137
|
# * If both of the `If-None-Match` and `If-Modified-Since` headers are
|
8818
9138
|
# present in the request as follows, then Amazon S3 returns the HTTP
|
@@ -8822,58 +9142,59 @@ module Aws::S3
|
|
8822
9142
|
#
|
8823
9143
|
# * `If-Modified-Since` condition evaluates to `true`.
|
8824
9144
|
# For more information about conditional requests, see [RFC
|
8825
|
-
# 7232][
|
9145
|
+
# 7232][8].
|
8826
9146
|
#
|
8827
9147
|
# HTTP Host header syntax
|
8828
9148
|
#
|
8829
9149
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
8830
|
-
#
|
9150
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
8831
9151
|
#
|
8832
9152
|
# The following actions are related to `GetObjectAttributes`:
|
8833
9153
|
#
|
8834
|
-
# * [GetObject][
|
9154
|
+
# * [GetObject][9]
|
8835
9155
|
#
|
8836
|
-
# * [GetObjectAcl][
|
9156
|
+
# * [GetObjectAcl][10]
|
8837
9157
|
#
|
8838
|
-
# * [GetObjectLegalHold][
|
9158
|
+
# * [GetObjectLegalHold][11]
|
8839
9159
|
#
|
8840
|
-
# * [GetObjectLockConfiguration][
|
9160
|
+
# * [GetObjectLockConfiguration][12]
|
8841
9161
|
#
|
8842
|
-
# * [GetObjectRetention][
|
9162
|
+
# * [GetObjectRetention][13]
|
8843
9163
|
#
|
8844
|
-
# * [GetObjectTagging][
|
9164
|
+
# * [GetObjectTagging][14]
|
8845
9165
|
#
|
8846
|
-
# * [HeadObject][
|
9166
|
+
# * [HeadObject][15]
|
8847
9167
|
#
|
8848
|
-
# * [ListParts][
|
9168
|
+
# * [ListParts][16]
|
8849
9169
|
#
|
8850
9170
|
#
|
8851
9171
|
#
|
8852
9172
|
# [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/
|
9173
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
9174
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
9175
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
9176
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
9177
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
9178
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
9179
|
+
# [8]: https://tools.ietf.org/html/rfc7232
|
9180
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
9181
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
|
9182
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
|
9183
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
|
9184
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
|
9185
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
|
9186
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
|
9187
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
8867
9188
|
#
|
8868
9189
|
# @option params [required, String] :bucket
|
8869
9190
|
# The name of the bucket that contains the object.
|
8870
9191
|
#
|
8871
9192
|
# **Directory buckets** - When you use this operation with a directory
|
8872
9193
|
# 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
|
-
#
|
9194
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
9195
|
+
# requests are not supported. Directory bucket names must be unique in
|
9196
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
9197
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
8877
9198
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
8878
9199
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
8879
9200
|
# *Amazon S3 User Guide*.
|
@@ -9407,49 +9728,49 @@ module Aws::S3
|
|
9407
9728
|
# * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
|
9408
9729
|
#
|
9409
9730
|
#
|
9410
|
-
# @example Example: To retrieve tag set of
|
9731
|
+
# @example Example: To retrieve tag set of an object
|
9411
9732
|
#
|
9412
|
-
# # The following example retrieves tag set of an object.
|
9733
|
+
# # The following example retrieves tag set of an object.
|
9413
9734
|
#
|
9414
9735
|
# resp = client.get_object_tagging({
|
9415
9736
|
# bucket: "examplebucket",
|
9416
|
-
# key: "
|
9417
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9737
|
+
# key: "HappyFace.jpg",
|
9418
9738
|
# })
|
9419
9739
|
#
|
9420
9740
|
# resp.to_h outputs the following:
|
9421
9741
|
# {
|
9422
9742
|
# tag_set: [
|
9423
9743
|
# {
|
9424
|
-
# key: "
|
9425
|
-
# value: "
|
9744
|
+
# key: "Key4",
|
9745
|
+
# value: "Value4",
|
9746
|
+
# },
|
9747
|
+
# {
|
9748
|
+
# key: "Key3",
|
9749
|
+
# value: "Value3",
|
9426
9750
|
# },
|
9427
9751
|
# ],
|
9428
|
-
# version_id: "
|
9752
|
+
# version_id: "null",
|
9429
9753
|
# }
|
9430
9754
|
#
|
9431
|
-
# @example Example: To retrieve tag set of
|
9755
|
+
# @example Example: To retrieve tag set of a specific object version
|
9432
9756
|
#
|
9433
|
-
# # The following example retrieves tag set of an object.
|
9757
|
+
# # The following example retrieves tag set of an object. The request specifies object version.
|
9434
9758
|
#
|
9435
9759
|
# resp = client.get_object_tagging({
|
9436
9760
|
# bucket: "examplebucket",
|
9437
|
-
# key: "
|
9761
|
+
# key: "exampleobject",
|
9762
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9438
9763
|
# })
|
9439
9764
|
#
|
9440
9765
|
# resp.to_h outputs the following:
|
9441
9766
|
# {
|
9442
9767
|
# tag_set: [
|
9443
9768
|
# {
|
9444
|
-
# key: "
|
9445
|
-
# value: "
|
9446
|
-
# },
|
9447
|
-
# {
|
9448
|
-
# key: "Key3",
|
9449
|
-
# value: "Value3",
|
9769
|
+
# key: "Key1",
|
9770
|
+
# value: "Value1",
|
9450
9771
|
# },
|
9451
9772
|
# ],
|
9452
|
-
# version_id: "
|
9773
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9453
9774
|
# }
|
9454
9775
|
#
|
9455
9776
|
# @example Request syntax with placeholder values
|
@@ -9710,13 +10031,17 @@ module Aws::S3
|
|
9710
10031
|
# HTTP Host header syntax
|
9711
10032
|
#
|
9712
10033
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
9713
|
-
#
|
10034
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
9714
10035
|
#
|
9715
10036
|
# <note markdown="1"> You must make requests for this API operation to the Zonal endpoint.
|
9716
10037
|
# 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
|
10038
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
10039
|
+
# Path-style requests are not supported. For more information about
|
10040
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
10041
|
+
# for directory buckets in Availability Zones][5] in the *Amazon S3
|
10042
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
10043
|
+
# see [Available Local Zone for directory buckets][6] in the *Amazon
|
10044
|
+
# S3 User Guide*.
|
9720
10045
|
#
|
9721
10046
|
# </note>
|
9722
10047
|
#
|
@@ -9727,16 +10052,17 @@ module Aws::S3
|
|
9727
10052
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
9728
10053
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
9729
10054
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
|
10055
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
9730
10056
|
#
|
9731
10057
|
# @option params [required, String] :bucket
|
9732
10058
|
# The bucket name.
|
9733
10059
|
#
|
9734
10060
|
# **Directory buckets** - When you use this operation with a directory
|
9735
10061
|
# 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
|
-
#
|
10062
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
10063
|
+
# requests are not supported. Directory bucket names must be unique in
|
10064
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
10065
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
9740
10066
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
9741
10067
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
9742
10068
|
# *Amazon S3 User Guide*.
|
@@ -9810,7 +10136,7 @@ module Aws::S3
|
|
9810
10136
|
#
|
9811
10137
|
# @example Response structure
|
9812
10138
|
#
|
9813
|
-
# resp.bucket_location_type #=> String, one of "AvailabilityZone"
|
10139
|
+
# resp.bucket_location_type #=> String, one of "AvailabilityZone", "LocalZone"
|
9814
10140
|
# resp.bucket_location_name #=> String
|
9815
10141
|
# resp.bucket_region #=> String
|
9816
10142
|
# resp.access_point_alias #=> Boolean
|
@@ -9955,22 +10281,26 @@ module Aws::S3
|
|
9955
10281
|
# HTTP Host header syntax
|
9956
10282
|
#
|
9957
10283
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
9958
|
-
#
|
10284
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
9959
10285
|
#
|
9960
10286
|
# <note markdown="1"> For directory buckets, you must make requests for this API operation
|
9961
10287
|
# to the Zonal endpoint. These endpoints support virtual-hosted-style
|
9962
10288
|
# requests in the format
|
9963
|
-
# `https://
|
9964
|
-
# `. Path-style requests are not supported. For more information
|
9965
|
-
# [Regional and Zonal endpoints
|
10289
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
10290
|
+
# `. Path-style requests are not supported. For more information about
|
10291
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
10292
|
+
# for directory buckets in Availability Zones][6] in the *Amazon S3
|
10293
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
10294
|
+
# see [Available Local Zone for directory buckets][7] in the *Amazon
|
10295
|
+
# S3 User Guide*.
|
9966
10296
|
#
|
9967
10297
|
# </note>
|
9968
10298
|
#
|
9969
10299
|
# The following actions are related to `HeadObject`:
|
9970
10300
|
#
|
9971
|
-
# * [GetObject][
|
10301
|
+
# * [GetObject][8]
|
9972
10302
|
#
|
9973
|
-
# * [GetObjectAttributes][
|
10303
|
+
# * [GetObjectAttributes][9]
|
9974
10304
|
#
|
9975
10305
|
#
|
9976
10306
|
#
|
@@ -9980,18 +10310,19 @@ module Aws::S3
|
|
9980
10310
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
9981
10311
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
9982
10312
|
# [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/
|
10313
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
10314
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
10315
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
|
9985
10316
|
#
|
9986
10317
|
# @option params [required, String] :bucket
|
9987
10318
|
# The name of the bucket that contains the object.
|
9988
10319
|
#
|
9989
10320
|
# **Directory buckets** - When you use this operation with a directory
|
9990
10321
|
# 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
|
-
#
|
10322
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
10323
|
+
# requests are not supported. Directory bucket names must be unique in
|
10324
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
10325
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
9995
10326
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
9996
10327
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
9997
10328
|
# *Amazon S3 User Guide*.
|
@@ -10895,9 +11226,13 @@ module Aws::S3
|
|
10895
11226
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
10896
11227
|
# requests for this API operation to the Regional endpoint. These
|
10897
11228
|
# endpoints support path-style requests in the format
|
10898
|
-
# `https://s3express-control.
|
10899
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
10900
|
-
#
|
11229
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
11230
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
11231
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
11232
|
+
# endpoints for directory buckets in Availability Zones][2] in the
|
11233
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
11234
|
+
# Zones, see [Available Local Zone for directory buckets][3] in the
|
11235
|
+
# *Amazon S3 User Guide*.
|
10901
11236
|
#
|
10902
11237
|
# </note>
|
10903
11238
|
#
|
@@ -10909,7 +11244,7 @@ module Aws::S3
|
|
10909
11244
|
# operation can only be performed by the Amazon Web Services account
|
10910
11245
|
# that owns the resource. For more information about directory bucket
|
10911
11246
|
# policies and permissions, see [Amazon Web Services Identity and
|
10912
|
-
# Access Management (IAM) for S3 Express One Zone][
|
11247
|
+
# Access Management (IAM) for S3 Express One Zone][4] in the *Amazon
|
10913
11248
|
# S3 User Guide*.
|
10914
11249
|
#
|
10915
11250
|
# HTTP Host header syntax
|
@@ -10926,7 +11261,8 @@ module Aws::S3
|
|
10926
11261
|
#
|
10927
11262
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
|
10928
11263
|
# [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-
|
11264
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
11265
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
10930
11266
|
#
|
10931
11267
|
# @option params [String] :continuation_token
|
10932
11268
|
# `ContinuationToken` indicates to Amazon S3 that the list is being
|
@@ -11014,21 +11350,25 @@ module Aws::S3
|
|
11014
11350
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
11015
11351
|
# for this API operation to the Zonal endpoint. These endpoints support
|
11016
11352
|
# virtual-hosted-style requests in the format
|
11017
|
-
# `https://
|
11018
|
-
# Path-style requests are not supported. For more information
|
11019
|
-
# [Regional and Zonal endpoints
|
11353
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
11354
|
+
# `. Path-style requests are not supported. For more information about
|
11355
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
11356
|
+
# directory buckets in Availability Zones][2] in the *Amazon S3 User
|
11357
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
11358
|
+
# [Available Local Zone for directory buckets][3] in the *Amazon S3 User
|
11359
|
+
# Guide*.
|
11020
11360
|
#
|
11021
11361
|
# </note>
|
11022
11362
|
#
|
11023
11363
|
# Permissions
|
11024
11364
|
# : * **General purpose bucket permissions** - For information about
|
11025
11365
|
# permissions required to use the multipart upload API, see
|
11026
|
-
# [Multipart Upload and Permissions][
|
11366
|
+
# [Multipart Upload and Permissions][4] in the *Amazon S3 User
|
11027
11367
|
# Guide*.
|
11028
11368
|
#
|
11029
11369
|
# * **Directory bucket permissions** - To grant access to this API
|
11030
11370
|
# operation on a directory bucket, we recommend that you use the [
|
11031
|
-
# `CreateSession` ][
|
11371
|
+
# `CreateSession` ][5] API operation for session-based
|
11032
11372
|
# authorization. Specifically, you grant the
|
11033
11373
|
# `s3express:CreateSession` permission to the directory bucket in a
|
11034
11374
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -11039,7 +11379,7 @@ module Aws::S3
|
|
11039
11379
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
11040
11380
|
# refresh the session token automatically to avoid service
|
11041
11381
|
# interruptions when a session expires. For more information about
|
11042
|
-
# authorization, see [ `CreateSession` ][
|
11382
|
+
# authorization, see [ `CreateSession` ][5].
|
11043
11383
|
#
|
11044
11384
|
# Sorting of multipart uploads in response
|
11045
11385
|
# : * **General purpose bucket** - In the `ListMultipartUploads`
|
@@ -11060,41 +11400,42 @@ module Aws::S3
|
|
11060
11400
|
# HTTP Host header syntax
|
11061
11401
|
#
|
11062
11402
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
11063
|
-
#
|
11403
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
11064
11404
|
#
|
11065
11405
|
# The following operations are related to `ListMultipartUploads`:
|
11066
11406
|
#
|
11067
|
-
# * [CreateMultipartUpload][
|
11407
|
+
# * [CreateMultipartUpload][6]
|
11068
11408
|
#
|
11069
|
-
# * [UploadPart][
|
11409
|
+
# * [UploadPart][7]
|
11070
11410
|
#
|
11071
|
-
# * [CompleteMultipartUpload][
|
11411
|
+
# * [CompleteMultipartUpload][8]
|
11072
11412
|
#
|
11073
|
-
# * [ListParts][
|
11413
|
+
# * [ListParts][9]
|
11074
11414
|
#
|
11075
|
-
# * [AbortMultipartUpload][
|
11415
|
+
# * [AbortMultipartUpload][10]
|
11076
11416
|
#
|
11077
11417
|
#
|
11078
11418
|
#
|
11079
11419
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
11080
11420
|
# [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/
|
11421
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
11422
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
11423
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
11424
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
11425
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
11426
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
11427
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
11428
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
11088
11429
|
#
|
11089
11430
|
# @option params [required, String] :bucket
|
11090
11431
|
# The name of the bucket to which the multipart upload was initiated.
|
11091
11432
|
#
|
11092
11433
|
# **Directory buckets** - When you use this operation with a directory
|
11093
11434
|
# 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
|
-
#
|
11435
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
11436
|
+
# requests are not supported. Directory bucket names must be unique in
|
11437
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
11438
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
11098
11439
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
11099
11440
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
11100
11441
|
# *Amazon S3 User Guide*.
|
@@ -11687,10 +12028,10 @@ module Aws::S3
|
|
11687
12028
|
#
|
11688
12029
|
# **Directory buckets** - When you use this operation with a directory
|
11689
12030
|
# 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
|
-
#
|
12031
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
12032
|
+
# requests are not supported. Directory bucket names must be unique in
|
12033
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
12034
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
11694
12035
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
11695
12036
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
11696
12037
|
# *Amazon S3 User Guide*.
|
@@ -11902,9 +12243,13 @@ module Aws::S3
|
|
11902
12243
|
# * **Directory buckets** - For directory buckets, you must make
|
11903
12244
|
# requests for this API operation to the Zonal endpoint. These
|
11904
12245
|
# 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
|
12246
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
12247
|
+
# `. Path-style requests are not supported. For more information about
|
12248
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
12249
|
+
# for directory buckets in Availability Zones][3] in the *Amazon S3
|
12250
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
12251
|
+
# see [Available Local Zone for directory buckets][4] in the *Amazon
|
12252
|
+
# S3 User Guide*.
|
11908
12253
|
#
|
11909
12254
|
# </note>
|
11910
12255
|
#
|
@@ -11914,12 +12259,12 @@ module Aws::S3
|
|
11914
12259
|
# to perform the `s3:ListBucket` action. The bucket owner has this
|
11915
12260
|
# permission by default and can grant this permission to others. For
|
11916
12261
|
# more information about permissions, see [Permissions Related to
|
11917
|
-
# Bucket Subresource Operations][
|
11918
|
-
# to Your Amazon S3 Resources][
|
12262
|
+
# Bucket Subresource Operations][5] and [Managing Access Permissions
|
12263
|
+
# to Your Amazon S3 Resources][6] in the *Amazon S3 User Guide*.
|
11919
12264
|
#
|
11920
12265
|
# * **Directory bucket permissions** - To grant access to this API
|
11921
12266
|
# operation on a directory bucket, we recommend that you use the [
|
11922
|
-
# `CreateSession` ][
|
12267
|
+
# `CreateSession` ][7] API operation for session-based
|
11923
12268
|
# authorization. Specifically, you grant the
|
11924
12269
|
# `s3express:CreateSession` permission to the directory bucket in a
|
11925
12270
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -11930,7 +12275,7 @@ module Aws::S3
|
|
11930
12275
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
11931
12276
|
# refresh the session token automatically to avoid service
|
11932
12277
|
# interruptions when a session expires. For more information about
|
11933
|
-
# authorization, see [ `CreateSession` ][
|
12278
|
+
# authorization, see [ `CreateSession` ][7].
|
11934
12279
|
#
|
11935
12280
|
# Sorting order of returned objects
|
11936
12281
|
# : * **General purpose bucket** - For general purpose buckets,
|
@@ -11943,41 +12288,42 @@ module Aws::S3
|
|
11943
12288
|
# HTTP Host header syntax
|
11944
12289
|
#
|
11945
12290
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
11946
|
-
#
|
12291
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
11947
12292
|
#
|
11948
12293
|
# This section describes the latest revision of this action. We
|
11949
12294
|
# recommend that you use this revised API operation for application
|
11950
12295
|
# development. For backward compatibility, Amazon S3 continues to
|
11951
|
-
# support the prior version of this API operation, [ListObjects][
|
12296
|
+
# support the prior version of this API operation, [ListObjects][8].
|
11952
12297
|
#
|
11953
12298
|
# The following operations are related to `ListObjectsV2`:
|
11954
12299
|
#
|
11955
|
-
# * [GetObject][
|
12300
|
+
# * [GetObject][9]
|
11956
12301
|
#
|
11957
|
-
# * [PutObject][
|
12302
|
+
# * [PutObject][10]
|
11958
12303
|
#
|
11959
|
-
# * [CreateBucket][
|
12304
|
+
# * [CreateBucket][11]
|
11960
12305
|
#
|
11961
12306
|
#
|
11962
12307
|
#
|
11963
12308
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
|
11964
12309
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
|
11965
12310
|
# [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/
|
12311
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
12312
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
12313
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
12314
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
12315
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
|
12316
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
12317
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
12318
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
11973
12319
|
#
|
11974
12320
|
# @option params [required, String] :bucket
|
11975
12321
|
# **Directory buckets** - When you use this operation with a directory
|
11976
12322
|
# 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
|
-
#
|
12323
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
12324
|
+
# requests are not supported. Directory bucket names must be unique in
|
12325
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
12326
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
11981
12327
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
11982
12328
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
11983
12329
|
# *Amazon S3 User Guide*.
|
@@ -12245,16 +12591,20 @@ module Aws::S3
|
|
12245
12591
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
12246
12592
|
# for this API operation to the Zonal endpoint. These endpoints support
|
12247
12593
|
# virtual-hosted-style requests in the format
|
12248
|
-
# `https://
|
12249
|
-
# Path-style requests are not supported. For more information
|
12250
|
-
# [Regional and Zonal endpoints
|
12594
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
12595
|
+
# `. Path-style requests are not supported. For more information about
|
12596
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
12597
|
+
# directory buckets in Availability Zones][3] in the *Amazon S3 User
|
12598
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
12599
|
+
# [Available Local Zone for directory buckets][4] in the *Amazon S3 User
|
12600
|
+
# Guide*.
|
12251
12601
|
#
|
12252
12602
|
# </note>
|
12253
12603
|
#
|
12254
12604
|
# Permissions
|
12255
12605
|
# : * **General purpose bucket permissions** - For information about
|
12256
12606
|
# permissions required to use the multipart upload API, see
|
12257
|
-
# [Multipart Upload and Permissions][
|
12607
|
+
# [Multipart Upload and Permissions][5] in the *Amazon S3 User
|
12258
12608
|
# Guide*.
|
12259
12609
|
#
|
12260
12610
|
# If the upload was created using server-side encryption with Key
|
@@ -12265,7 +12615,7 @@ module Aws::S3
|
|
12265
12615
|
#
|
12266
12616
|
# * **Directory bucket permissions** - To grant access to this API
|
12267
12617
|
# operation on a directory bucket, we recommend that you use the [
|
12268
|
-
# `CreateSession` ][
|
12618
|
+
# `CreateSession` ][6] API operation for session-based
|
12269
12619
|
# authorization. Specifically, you grant the
|
12270
12620
|
# `s3express:CreateSession` permission to the directory bucket in a
|
12271
12621
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -12276,49 +12626,50 @@ module Aws::S3
|
|
12276
12626
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
12277
12627
|
# refresh the session token automatically to avoid service
|
12278
12628
|
# interruptions when a session expires. For more information about
|
12279
|
-
# authorization, see [ `CreateSession` ][
|
12629
|
+
# authorization, see [ `CreateSession` ][6].
|
12280
12630
|
#
|
12281
12631
|
# HTTP Host header syntax
|
12282
12632
|
#
|
12283
12633
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
12284
|
-
#
|
12634
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
12285
12635
|
#
|
12286
12636
|
# The following operations are related to `ListParts`:
|
12287
12637
|
#
|
12288
12638
|
# * [CreateMultipartUpload][1]
|
12289
12639
|
#
|
12290
|
-
# * [UploadPart][
|
12640
|
+
# * [UploadPart][7]
|
12291
12641
|
#
|
12292
|
-
# * [CompleteMultipartUpload][
|
12642
|
+
# * [CompleteMultipartUpload][8]
|
12293
12643
|
#
|
12294
|
-
# * [AbortMultipartUpload][
|
12644
|
+
# * [AbortMultipartUpload][9]
|
12295
12645
|
#
|
12296
|
-
# * [GetObjectAttributes][
|
12646
|
+
# * [GetObjectAttributes][10]
|
12297
12647
|
#
|
12298
|
-
# * [ListMultipartUploads][
|
12648
|
+
# * [ListMultipartUploads][11]
|
12299
12649
|
#
|
12300
12650
|
#
|
12301
12651
|
#
|
12302
12652
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
12303
12653
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
12304
12654
|
# [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/
|
12655
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
12656
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
12657
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
12658
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
12659
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
12660
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
12661
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
|
12662
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
12312
12663
|
#
|
12313
12664
|
# @option params [required, String] :bucket
|
12314
12665
|
# The name of the bucket to which the parts are being uploaded.
|
12315
12666
|
#
|
12316
12667
|
# **Directory buckets** - When you use this operation with a directory
|
12317
12668
|
# 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
|
-
#
|
12669
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
12670
|
+
# requests are not supported. Directory bucket names must be unique in
|
12671
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
12672
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
12322
12673
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
12323
12674
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
12324
12675
|
# *Amazon S3 User Guide*.
|
@@ -13255,9 +13606,13 @@ module Aws::S3
|
|
13255
13606
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
13256
13607
|
# requests for this API operation to the Regional endpoint. These
|
13257
13608
|
# endpoints support path-style requests in the format
|
13258
|
-
# `https://s3express-control.
|
13259
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
13260
|
-
#
|
13609
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
13610
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
13611
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
13612
|
+
# endpoints for directory buckets in Availability Zones][1] in the
|
13613
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
13614
|
+
# Zones, see [Available Local Zone for directory buckets][2] in the
|
13615
|
+
# *Amazon S3 User Guide*.
|
13261
13616
|
#
|
13262
13617
|
# </note>
|
13263
13618
|
#
|
@@ -13271,12 +13626,12 @@ module Aws::S3
|
|
13271
13626
|
# keys (SSE-KMS) or dual-layer server-side encryption with Amazon
|
13272
13627
|
# Web Services KMS keys (DSSE-KMS). If you specify default
|
13273
13628
|
# encryption by using SSE-KMS, you can also configure [Amazon S3
|
13274
|
-
# Bucket Keys][
|
13275
|
-
# encryption feature, see [Amazon S3 Bucket Default Encryption][
|
13629
|
+
# Bucket Keys][3]. For information about the bucket default
|
13630
|
+
# encryption feature, see [Amazon S3 Bucket Default Encryption][4]
|
13276
13631
|
# in the *Amazon S3 User Guide*.
|
13277
13632
|
#
|
13278
13633
|
# * If you use PutBucketEncryption to set your [default bucket
|
13279
|
-
# encryption][
|
13634
|
+
# encryption][4] to SSE-KMS, you should verify that your KMS key ID
|
13280
13635
|
# is correct. Amazon S3 doesn't validate the KMS key ID provided in
|
13281
13636
|
# PutBucketEncryption requests.
|
13282
13637
|
# * <b>Directory buckets </b> - You can optionally configure default
|
@@ -13290,28 +13645,28 @@ module Aws::S3
|
|
13290
13645
|
# encrypted with the desired encryption settings. For more
|
13291
13646
|
# information about the encryption overriding behaviors in directory
|
13292
13647
|
# buckets, see [Specifying server-side encryption with KMS for new
|
13293
|
-
# object uploads][
|
13648
|
+
# object uploads][5].
|
13294
13649
|
#
|
13295
13650
|
# * Your SSE-KMS configuration can only support 1 [customer managed
|
13296
|
-
# key][
|
13297
|
-
# [Amazon Web Services managed key][
|
13651
|
+
# key][6] per directory bucket for the lifetime of the bucket. The
|
13652
|
+
# [Amazon Web Services managed key][7] (`aws/s3`) isn't supported.
|
13298
13653
|
#
|
13299
13654
|
# * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
|
13300
13655
|
# in a directory bucket and can’t be disabled. S3 Bucket Keys
|
13301
13656
|
# aren't supported, when you copy SSE-KMS encrypted objects from
|
13302
13657
|
# general purpose buckets to directory buckets, from directory
|
13303
13658
|
# buckets to general purpose buckets, or between directory buckets,
|
13304
|
-
# through [CopyObject][
|
13305
|
-
# in Batch Operations][
|
13659
|
+
# through [CopyObject][8], [UploadPartCopy][9], [the Copy operation
|
13660
|
+
# in Batch Operations][10], or [the import jobs][11]. In this case,
|
13306
13661
|
# Amazon S3 makes a call to KMS every time a copy request is made
|
13307
13662
|
# for a KMS-encrypted object.
|
13308
13663
|
#
|
13309
|
-
# * When you specify an [KMS customer managed key][
|
13664
|
+
# * When you specify an [KMS customer managed key][6] for encryption
|
13310
13665
|
# in your directory bucket, only use the key ID or key ARN. The key
|
13311
13666
|
# alias format of the KMS key isn't supported.
|
13312
13667
|
#
|
13313
13668
|
# * For directory buckets, if you use PutBucketEncryption to set your
|
13314
|
-
# [default bucket encryption][
|
13669
|
+
# [default bucket encryption][4] to SSE-KMS, Amazon S3 validates the
|
13315
13670
|
# KMS key ID provided in PutBucketEncryption requests.
|
13316
13671
|
#
|
13317
13672
|
# </note>
|
@@ -13324,7 +13679,7 @@ module Aws::S3
|
|
13324
13679
|
#
|
13325
13680
|
# Also, this action requires Amazon Web Services Signature Version 4.
|
13326
13681
|
# For more information, see [ Authenticating Requests (Amazon Web
|
13327
|
-
# Services Signature Version 4)][
|
13682
|
+
# Services Signature Version 4)][12].
|
13328
13683
|
#
|
13329
13684
|
# Permissions
|
13330
13685
|
# : * **General purpose bucket permissions** - The
|
@@ -13332,8 +13687,8 @@ module Aws::S3
|
|
13332
13687
|
# policy. The bucket owner has this permission by default. The
|
13333
13688
|
# bucket owner can grant this permission to others. For more
|
13334
13689
|
# information about permissions, see [Permissions Related to Bucket
|
13335
|
-
# Operations][
|
13336
|
-
# Resources][
|
13690
|
+
# Operations][13] and [Managing Access Permissions to Your Amazon S3
|
13691
|
+
# Resources][14] in the *Amazon S3 User Guide*.
|
13337
13692
|
#
|
13338
13693
|
# * **Directory bucket permissions** - To grant access to this API
|
13339
13694
|
# operation, you must have the
|
@@ -13343,7 +13698,7 @@ module Aws::S3
|
|
13343
13698
|
# only be performed by the Amazon Web Services account that owns the
|
13344
13699
|
# resource. For more information about directory bucket policies and
|
13345
13700
|
# permissions, see [Amazon Web Services Identity and Access
|
13346
|
-
# Management (IAM) for S3 Express One Zone][
|
13701
|
+
# Management (IAM) for S3 Express One Zone][15] in the *Amazon S3
|
13347
13702
|
# User Guide*.
|
13348
13703
|
#
|
13349
13704
|
# To set a directory bucket default encryption with SSE-KMS, you
|
@@ -13354,32 +13709,33 @@ module Aws::S3
|
|
13354
13709
|
# HTTP Host header syntax
|
13355
13710
|
#
|
13356
13711
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
13357
|
-
# `s3express-control.region.amazonaws.com`.
|
13712
|
+
# `s3express-control.region-code.amazonaws.com`.
|
13358
13713
|
#
|
13359
13714
|
# The following operations are related to `PutBucketEncryption`:
|
13360
13715
|
#
|
13361
|
-
# * [GetBucketEncryption][
|
13716
|
+
# * [GetBucketEncryption][16]
|
13362
13717
|
#
|
13363
|
-
# * [DeleteBucketEncryption][
|
13718
|
+
# * [DeleteBucketEncryption][17]
|
13364
13719
|
#
|
13365
13720
|
#
|
13366
13721
|
#
|
13367
13722
|
# [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/
|
13723
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
13724
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
|
13725
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
13726
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
13727
|
+
# [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
|
13728
|
+
# [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
|
13729
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
13730
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
13731
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
|
13732
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
|
13733
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
13734
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
13735
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
13736
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
13737
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
13738
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
13383
13739
|
#
|
13384
13740
|
# @option params [required, String] :bucket
|
13385
13741
|
# Specifies default encryption for a bucket using server-side encryption
|
@@ -13387,13 +13743,14 @@ module Aws::S3
|
|
13387
13743
|
#
|
13388
13744
|
# <b>Directory buckets </b> - When you use this operation with a
|
13389
13745
|
# directory bucket, you must use path-style requests in the format
|
13390
|
-
# `https://s3express-control.
|
13746
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
13391
13747
|
# 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
|
-
#
|
13748
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
13749
|
+
# Zone). Bucket names must also follow the format `
|
13750
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
13751
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
13752
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
13753
|
+
# *Amazon S3 User Guide*
|
13397
13754
|
#
|
13398
13755
|
#
|
13399
13756
|
#
|
@@ -13912,6 +14269,16 @@ module Aws::S3
|
|
13912
14269
|
# lifecycle configuration. For information about lifecycle
|
13913
14270
|
# configuration, see [Managing your storage lifecycle][1].
|
13914
14271
|
#
|
14272
|
+
# <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
|
14273
|
+
# rule using an object key name prefix, one or more object tags, object
|
14274
|
+
# size, or any combination of these. Accordingly, this section describes
|
14275
|
+
# the latest API. The previous version of the API supported filtering
|
14276
|
+
# based only on an object key name prefix, which is supported for
|
14277
|
+
# backward compatibility. For the related API description, see
|
14278
|
+
# [PutBucketLifecycle][2].
|
14279
|
+
#
|
14280
|
+
# </note>
|
14281
|
+
#
|
13915
14282
|
# Rules
|
13916
14283
|
# Permissions
|
13917
14284
|
# HTTP Host header syntax
|
@@ -13992,10 +14359,13 @@ module Aws::S3
|
|
13992
14359
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
13993
14360
|
# requests for this API operation to the Regional endpoint. These
|
13994
14361
|
# endpoints support path-style requests in the format
|
13995
|
-
# `https://s3express-control.
|
14362
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name
|
13996
14363
|
# `. Virtual-hosted-style requests aren't supported. For more
|
13997
|
-
# information
|
13998
|
-
#
|
14364
|
+
# information about endpoints in Availability Zones, see [Regional
|
14365
|
+
# and Zonal endpoints for directory buckets in Availability
|
14366
|
+
# Zones][7] in the *Amazon S3 User Guide*. For more information
|
14367
|
+
# about endpoints in Local Zones, see [Available Local Zone for
|
14368
|
+
# directory buckets][8] in the *Amazon S3 User Guide*.
|
13999
14369
|
#
|
14000
14370
|
# </note>
|
14001
14371
|
#
|
@@ -14005,9 +14375,9 @@ module Aws::S3
|
|
14005
14375
|
# The following operations are related to
|
14006
14376
|
# `PutBucketLifecycleConfiguration`:
|
14007
14377
|
#
|
14008
|
-
# * [GetBucketLifecycleConfiguration][
|
14378
|
+
# * [GetBucketLifecycleConfiguration][9]
|
14009
14379
|
#
|
14010
|
-
# * [DeleteBucketLifecycle][
|
14380
|
+
# * [DeleteBucketLifecycle][10]
|
14011
14381
|
#
|
14012
14382
|
#
|
14013
14383
|
#
|
@@ -14018,8 +14388,9 @@ module Aws::S3
|
|
14018
14388
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
14019
14389
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
14020
14390
|
# [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/
|
14391
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
14392
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
14393
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
14023
14394
|
#
|
14024
14395
|
# @option params [required, String] :bucket
|
14025
14396
|
# The name of the bucket for which to set the configuration.
|
@@ -14816,9 +15187,13 @@ module Aws::S3
|
|
14816
15187
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
14817
15188
|
# requests for this API operation to the Regional endpoint. These
|
14818
15189
|
# endpoints support path-style requests in the format
|
14819
|
-
# `https://s3express-control.
|
14820
|
-
# Virtual-hosted-style requests aren't supported. For more information
|
14821
|
-
#
|
15190
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
15191
|
+
# Virtual-hosted-style requests aren't supported. For more information
|
15192
|
+
# about endpoints in Availability Zones, see [Regional and Zonal
|
15193
|
+
# endpoints for directory buckets in Availability Zones][1] in the
|
15194
|
+
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
15195
|
+
# Zones, see [Available Local Zone for directory buckets][2] in the
|
15196
|
+
# *Amazon S3 User Guide*.
|
14822
15197
|
#
|
14823
15198
|
# </note>
|
14824
15199
|
#
|
@@ -14848,7 +15223,7 @@ module Aws::S3
|
|
14848
15223
|
# * **General purpose bucket permissions** - The `s3:PutBucketPolicy`
|
14849
15224
|
# permission is required in a policy. For more information about
|
14850
15225
|
# general purpose buckets bucket policies, see [Using Bucket
|
14851
|
-
# Policies and User Policies][
|
15226
|
+
# Policies and User Policies][3] in the *Amazon S3 User Guide*.
|
14852
15227
|
#
|
14853
15228
|
# * **Directory bucket permissions** - To grant access to this API
|
14854
15229
|
# operation, you must have the `s3express:PutBucketPolicy`
|
@@ -14858,49 +15233,51 @@ module Aws::S3
|
|
14858
15233
|
# Services account that owns the resource. For more information
|
14859
15234
|
# about directory bucket policies and permissions, see [Amazon Web
|
14860
15235
|
# Services Identity and Access Management (IAM) for S3 Express One
|
14861
|
-
# Zone][
|
15236
|
+
# Zone][4] in the *Amazon S3 User Guide*.
|
14862
15237
|
#
|
14863
15238
|
# Example bucket policies
|
14864
15239
|
#
|
14865
15240
|
# : **General purpose buckets example bucket policies** - See [Bucket
|
14866
|
-
# policy examples][
|
15241
|
+
# policy examples][5] in the *Amazon S3 User Guide*.
|
14867
15242
|
#
|
14868
15243
|
# **Directory bucket example bucket policies** - See [Example bucket
|
14869
|
-
# policies for S3 Express One Zone][
|
15244
|
+
# policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
|
14870
15245
|
#
|
14871
15246
|
# HTTP Host header syntax
|
14872
15247
|
#
|
14873
15248
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
14874
|
-
# `s3express-control.region.amazonaws.com`.
|
15249
|
+
# `s3express-control.region-code.amazonaws.com`.
|
14875
15250
|
#
|
14876
15251
|
# The following operations are related to `PutBucketPolicy`:
|
14877
15252
|
#
|
14878
|
-
# * [CreateBucket][
|
15253
|
+
# * [CreateBucket][7]
|
14879
15254
|
#
|
14880
|
-
# * [DeleteBucket][
|
15255
|
+
# * [DeleteBucket][8]
|
14881
15256
|
#
|
14882
15257
|
#
|
14883
15258
|
#
|
14884
15259
|
# [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/
|
15260
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
15261
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
15262
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
15263
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
|
15264
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
15265
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
15266
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
14891
15267
|
#
|
14892
15268
|
# @option params [required, String] :bucket
|
14893
15269
|
# The name of the bucket.
|
14894
15270
|
#
|
14895
15271
|
# <b>Directory buckets </b> - When you use this operation with a
|
14896
15272
|
# directory bucket, you must use path-style requests in the format
|
14897
|
-
# `https://s3express-control.
|
15273
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
14898
15274
|
# 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
|
-
#
|
15275
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
15276
|
+
# Zone). Bucket names must also follow the format `
|
15277
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
15278
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
15279
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
15280
|
+
# *Amazon S3 User Guide*
|
14904
15281
|
#
|
14905
15282
|
#
|
14906
15283
|
#
|
@@ -15838,9 +16215,13 @@ module Aws::S3
|
|
15838
16215
|
# * **Directory buckets** - For directory buckets, you must make
|
15839
16216
|
# requests for this API operation to the Zonal endpoint. These
|
15840
16217
|
# 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
|
16218
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
16219
|
+
# `. Path-style requests are not supported. For more information about
|
16220
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
16221
|
+
# for directory buckets in Availability Zones][1] in the *Amazon S3
|
16222
|
+
# User Guide*. For more information about endpoints in Local Zones,
|
16223
|
+
# see [Available Local Zone for directory buckets][2] in the *Amazon
|
16224
|
+
# S3 User Guide*.
|
15844
16225
|
#
|
15845
16226
|
# </note>
|
15846
16227
|
#
|
@@ -15850,7 +16231,7 @@ module Aws::S3
|
|
15850
16231
|
# modify this behavior:
|
15851
16232
|
#
|
15852
16233
|
# * **S3 Object Lock** - To prevent objects from being deleted or
|
15853
|
-
# overwritten, you can use [Amazon S3 Object Lock][
|
16234
|
+
# overwritten, you can use [Amazon S3 Object Lock][3] in the *Amazon
|
15854
16235
|
# S3 User Guide*.
|
15855
16236
|
#
|
15856
16237
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
@@ -15864,9 +16245,9 @@ module Aws::S3
|
|
15864
16245
|
# automatically generates a unique version ID of that object being
|
15865
16246
|
# stored in Amazon S3. You can retrieve, replace, or delete any
|
15866
16247
|
# version of the object. For more information about versioning, see
|
15867
|
-
# [Adding Objects to Versioning-Enabled Buckets][
|
16248
|
+
# [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
|
15868
16249
|
# User Guide*. For information about returning the versioning state of
|
15869
|
-
# a bucket, see [GetBucketVersioning][
|
16250
|
+
# a bucket, see [GetBucketVersioning][5].
|
15870
16251
|
#
|
15871
16252
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
15872
16253
|
#
|
@@ -15890,7 +16271,7 @@ module Aws::S3
|
|
15890
16271
|
# `s3:PutObjectTagging`.
|
15891
16272
|
# * **Directory bucket permissions** - To grant access to this API
|
15892
16273
|
# operation on a directory bucket, we recommend that you use the [
|
15893
|
-
# `CreateSession` ][
|
16274
|
+
# `CreateSession` ][6] API operation for session-based
|
15894
16275
|
# authorization. Specifically, you grant the
|
15895
16276
|
# `s3express:CreateSession` permission to the directory bucket in a
|
15896
16277
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -15901,7 +16282,7 @@ module Aws::S3
|
|
15901
16282
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
15902
16283
|
# refresh the session token automatically to avoid service
|
15903
16284
|
# interruptions when a session expires. For more information about
|
15904
|
-
# authorization, see [ `CreateSession` ][
|
16285
|
+
# authorization, see [ `CreateSession` ][6].
|
15905
16286
|
#
|
15906
16287
|
# If the object is encrypted with SSE-KMS, you must also have the
|
15907
16288
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -15922,23 +16303,24 @@ module Aws::S3
|
|
15922
16303
|
# HTTP Host header syntax
|
15923
16304
|
#
|
15924
16305
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
15925
|
-
#
|
16306
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
15926
16307
|
#
|
15927
16308
|
# For more information about related Amazon S3 APIs, see the following:
|
15928
16309
|
#
|
15929
|
-
# * [CopyObject][
|
16310
|
+
# * [CopyObject][7]
|
15930
16311
|
#
|
15931
|
-
# * [DeleteObject][
|
16312
|
+
# * [DeleteObject][8]
|
15932
16313
|
#
|
15933
16314
|
#
|
15934
16315
|
#
|
15935
16316
|
# [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/
|
16317
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
16318
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
|
16319
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
|
16320
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
16321
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
16322
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
16323
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
15942
16324
|
#
|
15943
16325
|
# @option params [String] :acl
|
15944
16326
|
# The canned ACL to apply to the object. For more information, see
|
@@ -15986,10 +16368,10 @@ module Aws::S3
|
|
15986
16368
|
#
|
15987
16369
|
# **Directory buckets** - When you use this operation with a directory
|
15988
16370
|
# 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
|
-
#
|
16371
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
16372
|
+
# requests are not supported. Directory bucket names must be unique in
|
16373
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
16374
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
15993
16375
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
15994
16376
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
15995
16377
|
# *Amazon S3 User Guide*.
|
@@ -16593,59 +16975,44 @@ module Aws::S3
|
|
16593
16975
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
16594
16976
|
#
|
16595
16977
|
#
|
16596
|
-
# @example Example: To upload an object
|
16597
|
-
#
|
16598
|
-
# # The following example uploads an object. The request specifies the optional server-side encryption option. The request
|
16599
|
-
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
16600
|
-
#
|
16601
|
-
# resp = client.put_object({
|
16602
|
-
# body: "filetoupload",
|
16603
|
-
# bucket: "examplebucket",
|
16604
|
-
# key: "exampleobject",
|
16605
|
-
# server_side_encryption: "AES256",
|
16606
|
-
# tagging: "key1=value1&key2=value2",
|
16607
|
-
# })
|
16608
|
-
#
|
16609
|
-
# resp.to_h outputs the following:
|
16610
|
-
# {
|
16611
|
-
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16612
|
-
# server_side_encryption: "AES256",
|
16613
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
16614
|
-
# }
|
16615
|
-
#
|
16616
|
-
# @example Example: To upload an object
|
16978
|
+
# @example Example: To upload an object (specify optional headers)
|
16617
16979
|
#
|
16618
|
-
# # The following example uploads an object
|
16619
|
-
# #
|
16980
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
16981
|
+
# # storage class and use server-side encryption.
|
16620
16982
|
#
|
16621
16983
|
# resp = client.put_object({
|
16622
16984
|
# body: "HappyFace.jpg",
|
16623
16985
|
# bucket: "examplebucket",
|
16624
16986
|
# key: "HappyFace.jpg",
|
16987
|
+
# server_side_encryption: "AES256",
|
16988
|
+
# storage_class: "STANDARD_IA",
|
16625
16989
|
# })
|
16626
16990
|
#
|
16627
16991
|
# resp.to_h outputs the following:
|
16628
16992
|
# {
|
16629
16993
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16630
|
-
#
|
16994
|
+
# server_side_encryption: "AES256",
|
16995
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
16631
16996
|
# }
|
16632
16997
|
#
|
16633
|
-
# @example Example: To upload an object and specify
|
16998
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
16634
16999
|
#
|
16635
|
-
# # The following example uploads an object. The request specifies optional
|
16636
|
-
# # S3 returns version ID
|
17000
|
+
# # The following example uploads an object. The request specifies the optional server-side encryption option. The request
|
17001
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
16637
17002
|
#
|
16638
17003
|
# resp = client.put_object({
|
16639
|
-
# body: "
|
17004
|
+
# body: "filetoupload",
|
16640
17005
|
# bucket: "examplebucket",
|
16641
|
-
# key: "
|
17006
|
+
# key: "exampleobject",
|
17007
|
+
# server_side_encryption: "AES256",
|
16642
17008
|
# tagging: "key1=value1&key2=value2",
|
16643
17009
|
# })
|
16644
17010
|
#
|
16645
17011
|
# resp.to_h outputs the following:
|
16646
17012
|
# {
|
16647
17013
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16648
|
-
#
|
17014
|
+
# server_side_encryption: "AES256",
|
17015
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
16649
17016
|
# }
|
16650
17017
|
#
|
16651
17018
|
# @example Example: To upload object and specify user-defined metadata
|
@@ -16687,24 +17054,39 @@ module Aws::S3
|
|
16687
17054
|
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
16688
17055
|
# }
|
16689
17056
|
#
|
16690
|
-
# @example Example: To upload an object
|
17057
|
+
# @example Example: To upload an object and specify optional tags
|
16691
17058
|
#
|
16692
|
-
# # The following example uploads an object. The request specifies optional
|
16693
|
-
# #
|
17059
|
+
# # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
|
17060
|
+
# # S3 returns version ID of the newly created object.
|
17061
|
+
#
|
17062
|
+
# resp = client.put_object({
|
17063
|
+
# body: "c:\\HappyFace.jpg",
|
17064
|
+
# bucket: "examplebucket",
|
17065
|
+
# key: "HappyFace.jpg",
|
17066
|
+
# tagging: "key1=value1&key2=value2",
|
17067
|
+
# })
|
17068
|
+
#
|
17069
|
+
# resp.to_h outputs the following:
|
17070
|
+
# {
|
17071
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17072
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
17073
|
+
# }
|
17074
|
+
#
|
17075
|
+
# @example Example: To upload an object
|
17076
|
+
#
|
17077
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
17078
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
16694
17079
|
#
|
16695
17080
|
# resp = client.put_object({
|
16696
17081
|
# body: "HappyFace.jpg",
|
16697
17082
|
# bucket: "examplebucket",
|
16698
17083
|
# key: "HappyFace.jpg",
|
16699
|
-
# server_side_encryption: "AES256",
|
16700
|
-
# storage_class: "STANDARD_IA",
|
16701
17084
|
# })
|
16702
17085
|
#
|
16703
17086
|
# resp.to_h outputs the following:
|
16704
17087
|
# {
|
16705
17088
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16706
|
-
#
|
16707
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
17089
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
16708
17090
|
# }
|
16709
17091
|
#
|
16710
17092
|
# @example Example: To create an object.
|
@@ -18684,9 +19066,13 @@ module Aws::S3
|
|
18684
19066
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
18685
19067
|
# for this API operation to the Zonal endpoint. These endpoints support
|
18686
19068
|
# virtual-hosted-style requests in the format
|
18687
|
-
# `https://
|
18688
|
-
# Path-style requests are not supported. For more information
|
18689
|
-
# [Regional and Zonal endpoints
|
19069
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
19070
|
+
# `. Path-style requests are not supported. For more information about
|
19071
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
19072
|
+
# directory buckets in Availability Zones][5] in the *Amazon S3 User
|
19073
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
19074
|
+
# [Available Local Zone for directory buckets][6] in the *Amazon S3 User
|
19075
|
+
# Guide*.
|
18690
19076
|
#
|
18691
19077
|
# </note>
|
18692
19078
|
#
|
@@ -18703,15 +19089,15 @@ module Aws::S3
|
|
18703
19089
|
# These permissions are required because Amazon S3 must decrypt and
|
18704
19090
|
# read data from the encrypted file parts before it completes the
|
18705
19091
|
# multipart upload. For more information about KMS permissions, see
|
18706
|
-
# [Protecting data using server-side encryption with KMS][
|
19092
|
+
# [Protecting data using server-side encryption with KMS][7] in the
|
18707
19093
|
# *Amazon S3 User Guide*. For information about the permissions
|
18708
19094
|
# required to use the multipart upload API, see [Multipart upload
|
18709
|
-
# and permissions][
|
19095
|
+
# and permissions][8] and [Multipart upload API and permissions][9]
|
18710
19096
|
# in the *Amazon S3 User Guide*.
|
18711
19097
|
#
|
18712
19098
|
# * **Directory bucket permissions** - To grant access to this API
|
18713
19099
|
# operation on a directory bucket, we recommend that you use the [
|
18714
|
-
# `CreateSession` ][
|
19100
|
+
# `CreateSession` ][10] API operation for session-based
|
18715
19101
|
# authorization. Specifically, you grant the
|
18716
19102
|
# `s3express:CreateSession` permission to the directory bucket in a
|
18717
19103
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -18722,7 +19108,7 @@ module Aws::S3
|
|
18722
19108
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
18723
19109
|
# refresh the session token automatically to avoid service
|
18724
19110
|
# interruptions when a session expires. For more information about
|
18725
|
-
# authorization, see [ `CreateSession` ][
|
19111
|
+
# authorization, see [ `CreateSession` ][10].
|
18726
19112
|
#
|
18727
19113
|
# If the object is encrypted with SSE-KMS, you must also have the
|
18728
19114
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -18738,7 +19124,7 @@ module Aws::S3
|
|
18738
19124
|
# then Amazon Web Services S3 uses the `x-amz-content-sha256` header
|
18739
19125
|
# as a checksum instead of `Content-MD5`. For more information see
|
18740
19126
|
# [Authenticating Requests: Using the Authorization Header (Amazon Web
|
18741
|
-
# Services Signature Version 4)][
|
19127
|
+
# Services Signature Version 4)][11].
|
18742
19128
|
#
|
18743
19129
|
# <note markdown="1"> **Directory buckets** - MD5 is not supported by directory buckets.
|
18744
19130
|
# You can use checksum algorithms to check object integrity.
|
@@ -18778,7 +19164,7 @@ module Aws::S3
|
|
18778
19164
|
# * x-amz-server-side-encryption-customer-key
|
18779
19165
|
#
|
18780
19166
|
# * x-amz-server-side-encryption-customer-key-MD5
|
18781
|
-
# For more information, see [Using Server-Side Encryption][
|
19167
|
+
# For more information, see [Using Server-Side Encryption][12] in
|
18782
19168
|
# the *Amazon S3 User Guide*.
|
18783
19169
|
#
|
18784
19170
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
@@ -18800,19 +19186,19 @@ module Aws::S3
|
|
18800
19186
|
# HTTP Host header syntax
|
18801
19187
|
#
|
18802
19188
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
18803
|
-
#
|
19189
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
18804
19190
|
#
|
18805
19191
|
# The following operations are related to `UploadPart`:
|
18806
19192
|
#
|
18807
19193
|
# * [CreateMultipartUpload][2]
|
18808
19194
|
#
|
18809
|
-
# * [CompleteMultipartUpload][
|
19195
|
+
# * [CompleteMultipartUpload][13]
|
18810
19196
|
#
|
18811
|
-
# * [AbortMultipartUpload][
|
19197
|
+
# * [AbortMultipartUpload][14]
|
18812
19198
|
#
|
18813
|
-
# * [ListParts][
|
19199
|
+
# * [ListParts][15]
|
18814
19200
|
#
|
18815
|
-
# * [ListMultipartUploads][
|
19201
|
+
# * [ListMultipartUploads][16]
|
18816
19202
|
#
|
18817
19203
|
#
|
18818
19204
|
#
|
@@ -18821,16 +19207,17 @@ module Aws::S3
|
|
18821
19207
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
|
18822
19208
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
18823
19209
|
# [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/
|
19210
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
19211
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
|
19212
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
19213
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
19214
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
19215
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
|
19216
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
19217
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
19218
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
19219
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
19220
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
18834
19221
|
#
|
18835
19222
|
# @option params [String, StringIO, File] :body
|
18836
19223
|
# Object data.
|
@@ -18840,10 +19227,10 @@ module Aws::S3
|
|
18840
19227
|
#
|
18841
19228
|
# **Directory buckets** - When you use this operation with a directory
|
18842
19229
|
# 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
|
-
#
|
19230
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
19231
|
+
# requests are not supported. Directory bucket names must be unique in
|
19232
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
19233
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
18847
19234
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
18848
19235
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
18849
19236
|
# *Amazon S3 User Guide*.
|
@@ -19124,9 +19511,13 @@ module Aws::S3
|
|
19124
19511
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
19125
19512
|
# for this API operation to the Zonal endpoint. These endpoints support
|
19126
19513
|
# virtual-hosted-style requests in the format
|
19127
|
-
# `https://
|
19128
|
-
# Path-style requests are not supported. For more information
|
19129
|
-
# [Regional and Zonal endpoints
|
19514
|
+
# `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
|
19515
|
+
# `. Path-style requests are not supported. For more information about
|
19516
|
+
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
19517
|
+
# directory buckets in Availability Zones][5] in the *Amazon S3 User
|
19518
|
+
# Guide*. For more information about endpoints in Local Zones, see
|
19519
|
+
# [Available Local Zone for directory buckets][6] in the *Amazon S3 User
|
19520
|
+
# Guide*.
|
19130
19521
|
#
|
19131
19522
|
# </note>
|
19132
19523
|
#
|
@@ -19136,7 +19527,7 @@ module Aws::S3
|
|
19136
19527
|
# using IAM credentials (access key ID and secret access key for the
|
19137
19528
|
# IAM identities). All headers with the `x-amz-` prefix, including
|
19138
19529
|
# `x-amz-copy-source`, must be signed. For more information, see [REST
|
19139
|
-
# Authentication][
|
19530
|
+
# Authentication][7].
|
19140
19531
|
#
|
19141
19532
|
# **Directory buckets** - You must use IAM credentials to authenticate
|
19142
19533
|
# and authorize your access to the `UploadPartCopy` API operation,
|
@@ -19173,11 +19564,11 @@ module Aws::S3
|
|
19173
19564
|
# permissions are required because Amazon S3 must decrypt and read
|
19174
19565
|
# data from the encrypted file parts before it completes the
|
19175
19566
|
# multipart upload. For more information about KMS permissions,
|
19176
|
-
# see [Protecting data using server-side encryption with KMS][
|
19567
|
+
# see [Protecting data using server-side encryption with KMS][8]
|
19177
19568
|
# in the *Amazon S3 User Guide*. For information about the
|
19178
19569
|
# permissions required to use the multipart upload API, see
|
19179
|
-
# [Multipart upload and permissions][
|
19180
|
-
# and permissions][
|
19570
|
+
# [Multipart upload and permissions][9] and [Multipart upload API
|
19571
|
+
# and permissions][10] in the *Amazon S3 User Guide*.
|
19181
19572
|
# * **Directory bucket permissions** - You must have permissions in a
|
19182
19573
|
# bucket policy or an IAM identity-based policy based on the source
|
19183
19574
|
# and destination bucket types in an `UploadPartCopy` operation.
|
@@ -19200,14 +19591,14 @@ module Aws::S3
|
|
19200
19591
|
# identity-based policies and KMS key policies for the KMS key.
|
19201
19592
|
#
|
19202
19593
|
# For example policies, see [Example bucket policies for S3 Express
|
19203
|
-
# One Zone][
|
19594
|
+
# One Zone][11] and [Amazon Web Services Identity and Access
|
19204
19595
|
# Management (IAM) identity-based policies for S3 Express One
|
19205
|
-
# Zone][
|
19596
|
+
# Zone][12] in the *Amazon S3 User Guide*.
|
19206
19597
|
#
|
19207
19598
|
# Encryption
|
19208
19599
|
# : * <b>General purpose buckets </b> - For information about using
|
19209
19600
|
# server-side encryption with customer-provided encryption keys with
|
19210
|
-
# the `UploadPartCopy` operation, see [CopyObject][
|
19601
|
+
# the `UploadPartCopy` operation, see [CopyObject][13] and
|
19211
19602
|
# [UploadPart][2].
|
19212
19603
|
#
|
19213
19604
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
@@ -19215,7 +19606,7 @@ module Aws::S3
|
|
19215
19606
|
# encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
|
19216
19607
|
# server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
|
19217
19608
|
# more information, see [Protecting data with server-side
|
19218
|
-
# encryption][
|
19609
|
+
# encryption][14] in the *Amazon S3 User Guide*.
|
19219
19610
|
#
|
19220
19611
|
# <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
|
19221
19612
|
# operation and an `UploadPartCopy` operation, the request headers
|
@@ -19227,7 +19618,7 @@ module Aws::S3
|
|
19227
19618
|
# S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
|
19228
19619
|
# objects from general purpose buckets to directory buckets, from
|
19229
19620
|
# directory buckets to general purpose buckets, or between directory
|
19230
|
-
# buckets, through [UploadPartCopy][
|
19621
|
+
# buckets, through [UploadPartCopy][15]. In this case, Amazon S3
|
19231
19622
|
# makes a call to KMS every time a copy request is made for a
|
19232
19623
|
# KMS-encrypted object.
|
19233
19624
|
#
|
@@ -19249,21 +19640,21 @@ module Aws::S3
|
|
19249
19640
|
# HTTP Host header syntax
|
19250
19641
|
#
|
19251
19642
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
19252
|
-
#
|
19643
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
19253
19644
|
#
|
19254
19645
|
# The following operations are related to `UploadPartCopy`:
|
19255
19646
|
#
|
19256
|
-
# * [CreateMultipartUpload][
|
19647
|
+
# * [CreateMultipartUpload][16]
|
19257
19648
|
#
|
19258
19649
|
# * [UploadPart][2]
|
19259
19650
|
#
|
19260
|
-
# * [CompleteMultipartUpload][
|
19651
|
+
# * [CompleteMultipartUpload][17]
|
19261
19652
|
#
|
19262
|
-
# * [AbortMultipartUpload][
|
19653
|
+
# * [AbortMultipartUpload][18]
|
19263
19654
|
#
|
19264
|
-
# * [ListParts][
|
19655
|
+
# * [ListParts][19]
|
19265
19656
|
#
|
19266
|
-
# * [ListMultipartUploads][
|
19657
|
+
# * [ListMultipartUploads][20]
|
19267
19658
|
#
|
19268
19659
|
#
|
19269
19660
|
#
|
@@ -19272,34 +19663,43 @@ module Aws::S3
|
|
19272
19663
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
19273
19664
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
|
19274
19665
|
# [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/
|
19666
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
19667
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
19668
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
|
19669
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
19670
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
19671
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
19672
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
19673
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
19674
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
19675
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
19676
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
19677
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
19678
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
19679
|
+
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
19680
|
+
# [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
19289
19681
|
#
|
19290
19682
|
# @option params [required, String] :bucket
|
19291
19683
|
# The bucket name.
|
19292
19684
|
#
|
19293
19685
|
# **Directory buckets** - When you use this operation with a directory
|
19294
19686
|
# 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
|
-
#
|
19687
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
19688
|
+
# requests are not supported. Directory bucket names must be unique in
|
19689
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
19690
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
19299
19691
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
19300
19692
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
19301
19693
|
# *Amazon S3 User Guide*.
|
19302
19694
|
#
|
19695
|
+
# <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
|
19696
|
+
# supported when the source or destination bucket is in Amazon Web
|
19697
|
+
# Services Local Zones. The source and destination buckets must have the
|
19698
|
+
# same parent Amazon Web Services Region. Otherwise, you get an HTTP
|
19699
|
+
# `400 Bad Request` error with the error code `InvalidRequest`.
|
19700
|
+
#
|
19701
|
+
# </note>
|
19702
|
+
#
|
19303
19703
|
# **Access points** - When you use this action with an access point, you
|
19304
19704
|
# must provide the alias of the access point in place of the bucket name
|
19305
19705
|
# or specify the access point ARN. When using the access point ARN, you
|
@@ -19571,45 +19971,45 @@ module Aws::S3
|
|
19571
19971
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
19572
19972
|
#
|
19573
19973
|
#
|
19574
|
-
# @example Example: To upload a part by copying
|
19974
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
19575
19975
|
#
|
19576
|
-
# # The following example uploads a part of a multipart upload by copying
|
19976
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
19977
|
+
# # data source.
|
19577
19978
|
#
|
19578
19979
|
# resp = client.upload_part_copy({
|
19579
19980
|
# bucket: "examplebucket",
|
19580
19981
|
# copy_source: "/bucketname/sourceobjectkey",
|
19982
|
+
# copy_source_range: "bytes=1-100000",
|
19581
19983
|
# key: "examplelargeobject",
|
19582
|
-
# part_number:
|
19984
|
+
# part_number: 2,
|
19583
19985
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
19584
19986
|
# })
|
19585
19987
|
#
|
19586
19988
|
# resp.to_h outputs the following:
|
19587
19989
|
# {
|
19588
19990
|
# copy_part_result: {
|
19589
|
-
# etag: "\"
|
19590
|
-
# last_modified: Time.parse("2016-12-29T21:
|
19991
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
19992
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
19591
19993
|
# },
|
19592
19994
|
# }
|
19593
19995
|
#
|
19594
|
-
# @example Example: To upload a part by copying
|
19996
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
19595
19997
|
#
|
19596
|
-
# # The following example uploads a part of a multipart upload by copying
|
19597
|
-
# # data source.
|
19998
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
19598
19999
|
#
|
19599
20000
|
# resp = client.upload_part_copy({
|
19600
20001
|
# bucket: "examplebucket",
|
19601
20002
|
# copy_source: "/bucketname/sourceobjectkey",
|
19602
|
-
# copy_source_range: "bytes=1-100000",
|
19603
20003
|
# key: "examplelargeobject",
|
19604
|
-
# part_number:
|
20004
|
+
# part_number: 1,
|
19605
20005
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
19606
20006
|
# })
|
19607
20007
|
#
|
19608
20008
|
# resp.to_h outputs the following:
|
19609
20009
|
# {
|
19610
20010
|
# copy_part_result: {
|
19611
|
-
# etag: "\"
|
19612
|
-
# last_modified: Time.parse("2016-12-29T21:
|
20011
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
20012
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
19613
20013
|
# },
|
19614
20014
|
# }
|
19615
20015
|
#
|
@@ -20071,7 +20471,7 @@ module Aws::S3
|
|
20071
20471
|
tracer: tracer
|
20072
20472
|
)
|
20073
20473
|
context[:gem_name] = 'aws-sdk-s3'
|
20074
|
-
context[:gem_version] = '1.
|
20474
|
+
context[:gem_version] = '1.176.0'
|
20075
20475
|
Seahorse::Client::Request.new(handlers, context)
|
20076
20476
|
end
|
20077
20477
|
|