aws-sdk-s3 1.174.0 → 1.176.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +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
|
|