aws-sdk-s3 1.75.0 → 1.76.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/aws-sdk-s3.rb +1 -1
- data/lib/aws-sdk-s3/bucket.rb +2 -2
- data/lib/aws-sdk-s3/client.rb +791 -505
- data/lib/aws-sdk-s3/encryption.rb +2 -0
- data/lib/aws-sdk-s3/encryption/client.rb +11 -0
- data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +52 -28
- data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +41 -5
- data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +5 -5
- data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +32 -3
- data/lib/aws-sdk-s3/encryption/utils.rb +23 -0
- data/lib/aws-sdk-s3/encryptionV2/client.rb +198 -22
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +40 -12
- data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +77 -10
- data/lib/aws-sdk-s3/encryptionV2/default_key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +7 -4
- data/lib/aws-sdk-s3/encryptionV2/errors.rb +24 -0
- data/lib/aws-sdk-s3/encryptionV2/io_auth_decrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/io_decrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +90 -20
- data/lib/aws-sdk-s3/encryptionV2/materials.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/utils.rb +2 -15
- data/lib/aws-sdk-s3/encryption_v2.rb +4 -1
- data/lib/aws-sdk-s3/multipart_upload_part.rb +5 -5
- data/lib/aws-sdk-s3/object.rb +10 -9
- data/lib/aws-sdk-s3/object_summary.rb +23 -7
- data/lib/aws-sdk-s3/object_version.rb +2 -2
- data/lib/aws-sdk-s3/presigner.rb +2 -2
- data/lib/aws-sdk-s3/types.rb +63 -26
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: ad990de2b05716f6116d73be9cdc33d6e1da94fe806c88f8d614242ac10718b5
|
4
|
+
data.tar.gz: 7a54769829c7c767a0f8dedd8955e62878fd1fcb8edcd013f8de3511ca11c62b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: ba2bac310409551c19f28d89b70a1f1aa830fac115051a15f565db4ff16eb261471f9fa6c4b27544d1faa1fb5b5604fe20b59c4e5c244faec5444ec4aae49c02
|
7
|
+
data.tar.gz: 6e13da20ed6caad1c3bcf2025e24ccc074185f18dc115d5f30a3276077fc42c7fc782c62b43e8c8ee7ce1edf8bee47dd2758ab4f3912ebf65b1444311df0d324
|
data/lib/aws-sdk-s3.rb
CHANGED
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -357,7 +357,7 @@ module Aws::S3
|
|
357
357
|
#
|
358
358
|
#
|
359
359
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
360
|
-
# @option options [String,
|
360
|
+
# @option options [String, StringIO, File] :body
|
361
361
|
# Object data.
|
362
362
|
# @option options [String] :cache_control
|
363
363
|
# Can be used to specify caching behavior along the request/reply chain.
|
@@ -474,7 +474,7 @@ module Aws::S3
|
|
474
474
|
# encrypting data. This value is used to store the object and then it is
|
475
475
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
476
476
|
# be appropriate for use with the algorithm specified in the
|
477
|
-
# `x-amz-server-side
|
477
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
478
478
|
# @option options [String] :sse_customer_key_md5
|
479
479
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
480
480
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -402,27 +402,32 @@ module Aws::S3
|
|
402
402
|
# completely free all storage consumed by all parts.
|
403
403
|
#
|
404
404
|
# To verify that all parts have been removed, so you don't get charged
|
405
|
-
# for the part storage, you should call the ListParts operation and
|
405
|
+
# for the part storage, you should call the [ListParts][1] operation and
|
406
406
|
# ensure that the parts list is empty.
|
407
407
|
#
|
408
408
|
# For information about permissions required to use the multipart upload
|
409
|
-
# API, see [Multipart Upload API and Permissions][
|
409
|
+
# API, see [Multipart Upload API and Permissions][2].
|
410
410
|
#
|
411
411
|
# The following operations are related to `AbortMultipartUpload`\:
|
412
412
|
#
|
413
|
-
# * CreateMultipartUpload
|
413
|
+
# * [CreateMultipartUpload][3]
|
414
414
|
#
|
415
|
-
# * UploadPart
|
415
|
+
# * [UploadPart][4]
|
416
416
|
#
|
417
|
-
# * CompleteMultipartUpload
|
417
|
+
# * [CompleteMultipartUpload][5]
|
418
418
|
#
|
419
|
-
# * ListParts
|
419
|
+
# * [ListParts][1]
|
420
420
|
#
|
421
|
-
# * ListMultipartUploads
|
421
|
+
# * [ListMultipartUploads][6]
|
422
422
|
#
|
423
423
|
#
|
424
424
|
#
|
425
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
425
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
426
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
427
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
428
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
429
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
430
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
426
431
|
#
|
427
432
|
# @option params [required, String] :bucket
|
428
433
|
# The bucket name to which the upload was taking place.
|
@@ -500,7 +505,7 @@ module Aws::S3
|
|
500
505
|
# Completes a multipart upload by assembling previously uploaded parts.
|
501
506
|
#
|
502
507
|
# You first initiate the multipart upload and then upload all parts
|
503
|
-
# using the UploadPart operation. After successfully uploading all
|
508
|
+
# using the [UploadPart][1] operation. After successfully uploading all
|
504
509
|
# relevant parts of an upload, you call this operation to complete the
|
505
510
|
# upload. Upon receiving this request, Amazon S3 concatenates all the
|
506
511
|
# parts in ascending order by part number to create a new object. In the
|
@@ -521,15 +526,15 @@ module Aws::S3
|
|
521
526
|
#
|
522
527
|
# Note that if `CompleteMultipartUpload` fails, applications should be
|
523
528
|
# prepared to retry the failed requests. For more information, see
|
524
|
-
# [Amazon S3 Error Best Practices][
|
529
|
+
# [Amazon S3 Error Best Practices][2].
|
525
530
|
#
|
526
531
|
# For more information about multipart uploads, see [Uploading Objects
|
527
|
-
# Using Multipart Upload][
|
532
|
+
# Using Multipart Upload][3].
|
528
533
|
#
|
529
534
|
# For information about permissions required to use the multipart upload
|
530
|
-
# API, see [Multipart Upload API and Permissions][
|
535
|
+
# API, see [Multipart Upload API and Permissions][4].
|
531
536
|
#
|
532
|
-
# `
|
537
|
+
# `CompleteMultipartUpload` has the following special errors:
|
533
538
|
#
|
534
539
|
# * Error code: `EntityTooSmall`
|
535
540
|
#
|
@@ -564,21 +569,26 @@ module Aws::S3
|
|
564
569
|
#
|
565
570
|
# The following operations are related to `CompleteMultipartUpload`\:
|
566
571
|
#
|
567
|
-
# * CreateMultipartUpload
|
572
|
+
# * [CreateMultipartUpload][5]
|
568
573
|
#
|
569
|
-
# * UploadPart
|
574
|
+
# * [UploadPart][1]
|
570
575
|
#
|
571
|
-
# * AbortMultipartUpload
|
576
|
+
# * [AbortMultipartUpload][6]
|
572
577
|
#
|
573
|
-
# * ListParts
|
578
|
+
# * [ListParts][7]
|
574
579
|
#
|
575
|
-
# * ListMultipartUploads
|
580
|
+
# * [ListMultipartUploads][8]
|
576
581
|
#
|
577
582
|
#
|
578
583
|
#
|
579
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
580
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
581
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
584
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
585
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html
|
586
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
587
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
588
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
589
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
590
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
591
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
582
592
|
#
|
583
593
|
# @option params [required, String] :bucket
|
584
594
|
# Name of the bucket to which the multipart upload was initiated.
|
@@ -835,15 +845,15 @@ module Aws::S3
|
|
835
845
|
#
|
836
846
|
# If the source object's storage class is GLACIER, you must restore a
|
837
847
|
# copy of this object before you can use it as a source object for the
|
838
|
-
# copy operation. For more information, see .
|
848
|
+
# copy operation. For more information, see [RestoreObject][12].
|
839
849
|
#
|
840
850
|
# The following operations are related to `CopyObject`\:
|
841
851
|
#
|
842
|
-
# * PutObject
|
852
|
+
# * [PutObject][13]
|
843
853
|
#
|
844
|
-
# * GetObject
|
854
|
+
# * [GetObject][14]
|
845
855
|
#
|
846
|
-
# For more information, see [Copying Objects][
|
856
|
+
# For more information, see [Copying Objects][15].
|
847
857
|
#
|
848
858
|
#
|
849
859
|
#
|
@@ -858,7 +868,10 @@ module Aws::S3
|
|
858
868
|
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
859
869
|
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html
|
860
870
|
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
861
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
871
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
|
872
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
873
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
874
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html
|
862
875
|
#
|
863
876
|
# @option params [String] :acl
|
864
877
|
# The canned ACL to apply to the object.
|
@@ -952,7 +965,7 @@ module Aws::S3
|
|
952
965
|
# encrypting data. This value is used to store the object and then it is
|
953
966
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
954
967
|
# be appropriate for use with the algorithm specified in the
|
955
|
-
# `x-amz-server-side
|
968
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
956
969
|
#
|
957
970
|
# @option params [String] :sse_customer_key_md5
|
958
971
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -1207,9 +1220,9 @@ module Aws::S3
|
|
1207
1220
|
#
|
1208
1221
|
# The following operations are related to `CreateBucket`\:
|
1209
1222
|
#
|
1210
|
-
# * PutObject
|
1223
|
+
# * [PutObject][7]
|
1211
1224
|
#
|
1212
|
-
# * DeleteBucket
|
1225
|
+
# * [DeleteBucket][8]
|
1213
1226
|
#
|
1214
1227
|
#
|
1215
1228
|
#
|
@@ -1219,6 +1232,8 @@ module Aws::S3
|
|
1219
1232
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
1220
1233
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
1221
1234
|
# [6]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
1235
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
1236
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
1222
1237
|
#
|
1223
1238
|
# @option params [String] :acl
|
1224
1239
|
# The canned ACL to apply to the bucket.
|
@@ -1316,29 +1331,29 @@ module Aws::S3
|
|
1316
1331
|
# This operation initiates a multipart upload and returns an upload ID.
|
1317
1332
|
# This upload ID is used to associate all of the parts in the specific
|
1318
1333
|
# multipart upload. You specify this upload ID in each of your
|
1319
|
-
# subsequent upload part requests (see UploadPart). You also
|
1320
|
-
# this upload ID in the final request to either complete or
|
1321
|
-
# multipart upload request.
|
1334
|
+
# subsequent upload part requests (see [UploadPart][1]). You also
|
1335
|
+
# include this upload ID in the final request to either complete or
|
1336
|
+
# abort the multipart upload request.
|
1322
1337
|
#
|
1323
1338
|
# For more information about multipart uploads, see [Multipart Upload
|
1324
|
-
# Overview][
|
1339
|
+
# Overview][2].
|
1325
1340
|
#
|
1326
1341
|
# If you have configured a lifecycle rule to abort incomplete multipart
|
1327
1342
|
# uploads, the upload must complete within the number of days specified
|
1328
1343
|
# in the bucket lifecycle configuration. Otherwise, the incomplete
|
1329
1344
|
# multipart upload becomes eligible for an abort operation and Amazon S3
|
1330
1345
|
# aborts the multipart upload. For more information, see [Aborting
|
1331
|
-
# Incomplete Multipart Uploads Using a Bucket Lifecycle Policy][
|
1346
|
+
# Incomplete Multipart Uploads Using a Bucket Lifecycle Policy][3].
|
1332
1347
|
#
|
1333
1348
|
# For information about the permissions required to use the multipart
|
1334
|
-
# upload API, see [Multipart Upload API and Permissions][
|
1349
|
+
# upload API, see [Multipart Upload API and Permissions][4].
|
1335
1350
|
#
|
1336
1351
|
# For request signing, multipart upload is just a series of regular
|
1337
1352
|
# requests. You initiate a multipart upload, send one or more requests
|
1338
1353
|
# to upload parts, and then complete the multipart upload process. You
|
1339
1354
|
# sign each request individually. There is nothing special about signing
|
1340
1355
|
# multipart upload requests. For more information about signing, see
|
1341
|
-
# [Authenticating Requests (AWS Signature Version 4)][
|
1356
|
+
# [Authenticating Requests (AWS Signature Version 4)][5].
|
1342
1357
|
#
|
1343
1358
|
# <note markdown="1"> After you initiate a multipart upload and upload one or more parts, to
|
1344
1359
|
# stop being charged for storing the uploaded parts, you must either
|
@@ -1354,9 +1369,9 @@ module Aws::S3
|
|
1354
1369
|
# your own encryption key, or use AWS Key Management Service (AWS KMS)
|
1355
1370
|
# customer master keys (CMKs) or Amazon S3-managed encryption keys. If
|
1356
1371
|
# you choose to provide your own encryption key, the request headers you
|
1357
|
-
# provide in UploadPart) and
|
1358
|
-
#
|
1359
|
-
# `CreateMultipartUpload`.
|
1372
|
+
# provide in [UploadPart](AmazonS3/latest/API/API_UploadPart.html) and
|
1373
|
+
# [UploadPartCopy][6] requests must match the headers you used in the
|
1374
|
+
# request to initiate the upload by using `CreateMultipartUpload`.
|
1360
1375
|
#
|
1361
1376
|
# To perform a multipart upload with encryption using an AWS KMS CMK,
|
1362
1377
|
# the requester must have permission to the `kms:Encrypt`,
|
@@ -1372,7 +1387,7 @@ module Aws::S3
|
|
1372
1387
|
# both the key policy and your IAM user or role.
|
1373
1388
|
#
|
1374
1389
|
# For more information, see [Protecting Data Using Server-Side
|
1375
|
-
# Encryption][
|
1390
|
+
# Encryption][7].
|
1376
1391
|
#
|
1377
1392
|
# Access Permissions
|
1378
1393
|
#
|
@@ -1382,13 +1397,13 @@ module Aws::S3
|
|
1382
1397
|
# request headers:
|
1383
1398
|
#
|
1384
1399
|
# * Specify a canned ACL with the `x-amz-acl` request header. For more
|
1385
|
-
# information, see [Canned ACL][
|
1400
|
+
# information, see [Canned ACL][8].
|
1386
1401
|
#
|
1387
1402
|
# * Specify access permissions explicitly with the `x-amz-grant-read`,
|
1388
1403
|
# `x-amz-grant-read-acp`, `x-amz-grant-write-acp`, and
|
1389
1404
|
# `x-amz-grant-full-control` headers. These parameters map to the
|
1390
1405
|
# set of permissions that Amazon S3 supports in an ACL. For more
|
1391
|
-
# information, see [Access Control List (ACL) Overview][
|
1406
|
+
# information, see [Access Control List (ACL) Overview][9].
|
1392
1407
|
#
|
1393
1408
|
# You can use either a canned ACL or specify access permissions
|
1394
1409
|
# explicitly. You cannot do both.
|
@@ -1407,7 +1422,7 @@ module Aws::S3
|
|
1407
1422
|
# want AWS to manage the keys used to encrypt data, specify the
|
1408
1423
|
# following headers in the request.
|
1409
1424
|
#
|
1410
|
-
# * x-amz-server-side
|
1425
|
+
# * x-amz-server-side-encryption
|
1411
1426
|
#
|
1412
1427
|
# * x-amz-server-side-encryption-aws-kms-key-id
|
1413
1428
|
#
|
@@ -1424,21 +1439,21 @@ module Aws::S3
|
|
1424
1439
|
#
|
1425
1440
|
# For more information about server-side encryption with CMKs stored
|
1426
1441
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
1427
|
-
# Encryption with CMKs stored in AWS KMS][
|
1442
|
+
# Encryption with CMKs stored in AWS KMS][10].
|
1428
1443
|
#
|
1429
1444
|
# * Use customer-provided encryption keys – If you want to manage your
|
1430
1445
|
# own encryption keys, provide all the following headers in the
|
1431
1446
|
# request.
|
1432
1447
|
#
|
1433
|
-
# * x-amz-server-side
|
1448
|
+
# * x-amz-server-side-encryption-customer-algorithm
|
1434
1449
|
#
|
1435
|
-
# * x-amz-server-side
|
1450
|
+
# * x-amz-server-side-encryption-customer-key
|
1436
1451
|
#
|
1437
|
-
# * x-amz-server-side
|
1452
|
+
# * x-amz-server-side-encryption-customer-key-MD5
|
1438
1453
|
#
|
1439
1454
|
# For more information about server-side encryption with CMKs stored
|
1440
1455
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
1441
|
-
# Encryption with CMKs stored in AWS KMS][
|
1456
|
+
# Encryption with CMKs stored in AWS KMS][10].
|
1442
1457
|
#
|
1443
1458
|
# Access-Control-List (ACL)-Specific Request Headers
|
1444
1459
|
#
|
@@ -1448,19 +1463,19 @@ module Aws::S3
|
|
1448
1463
|
# permissions to individual AWS accounts or to predefined groups
|
1449
1464
|
# defined by Amazon S3. These permissions are then added to the access
|
1450
1465
|
# control list (ACL) on the object. For more information, see [Using
|
1451
|
-
# ACLs][
|
1466
|
+
# ACLs][11]. With this operation, you can grant access permissions
|
1452
1467
|
# using one of the following two methods:
|
1453
1468
|
#
|
1454
1469
|
# * Specify a canned ACL (`x-amz-acl`) — Amazon S3 supports a set of
|
1455
1470
|
# predefined ACLs, known as *canned ACLs*. Each canned ACL has a
|
1456
1471
|
# predefined set of grantees and permissions. For more information,
|
1457
|
-
# see [Canned ACL][
|
1472
|
+
# see [Canned ACL][8].
|
1458
1473
|
#
|
1459
1474
|
# * Specify access permissions explicitly — To explicitly grant access
|
1460
1475
|
# permissions to specific AWS accounts or groups, use the following
|
1461
1476
|
# headers. Each header maps to specific permissions that Amazon S3
|
1462
1477
|
# supports in an ACL. For more information, see [Access Control List
|
1463
|
-
# (ACL) Overview][
|
1478
|
+
# (ACL) Overview][9]. In the header, you specify a list of grantees
|
1464
1479
|
# who get the specific permission. To grant permissions explicitly,
|
1465
1480
|
# use:
|
1466
1481
|
#
|
@@ -1505,7 +1520,7 @@ module Aws::S3
|
|
1505
1520
|
# * South America (São Paulo)
|
1506
1521
|
#
|
1507
1522
|
# For a list of all the Amazon S3 supported Regions and endpoints,
|
1508
|
-
# see [Regions and Endpoints][
|
1523
|
+
# see [Regions and Endpoints][12] in the AWS General Reference.
|
1509
1524
|
#
|
1510
1525
|
# </note>
|
1511
1526
|
#
|
@@ -1517,28 +1532,34 @@ module Aws::S3
|
|
1517
1532
|
#
|
1518
1533
|
# The following operations are related to `CreateMultipartUpload`\:
|
1519
1534
|
#
|
1520
|
-
# * UploadPart
|
1535
|
+
# * [UploadPart][1]
|
1521
1536
|
#
|
1522
|
-
# * CompleteMultipartUpload
|
1537
|
+
# * [CompleteMultipartUpload][13]
|
1523
1538
|
#
|
1524
|
-
# * AbortMultipartUpload
|
1539
|
+
# * [AbortMultipartUpload][14]
|
1525
1540
|
#
|
1526
|
-
# * ListParts
|
1541
|
+
# * [ListParts][15]
|
1527
1542
|
#
|
1528
|
-
# * ListMultipartUploads
|
1543
|
+
# * [ListMultipartUploads][16]
|
1529
1544
|
#
|
1530
1545
|
#
|
1531
1546
|
#
|
1532
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1533
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
1534
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1535
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1536
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1537
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1538
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1539
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1540
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1541
|
-
# [10]: https://docs.aws.amazon.com/
|
1547
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
1548
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
1549
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
|
1550
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
1551
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
1552
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
1553
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
1554
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
1555
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
1556
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html
|
1557
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
1558
|
+
# [12]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
1559
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
1560
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
1561
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
1562
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
1542
1563
|
#
|
1543
1564
|
# @option params [String] :acl
|
1544
1565
|
# The canned ACL to apply to the object.
|
@@ -1606,7 +1627,7 @@ module Aws::S3
|
|
1606
1627
|
# encrypting data. This value is used to store the object and then it is
|
1607
1628
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
1608
1629
|
# be appropriate for use with the algorithm specified in the
|
1609
|
-
# `x-amz-server-side
|
1630
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
1610
1631
|
#
|
1611
1632
|
# @option params [String] :sse_customer_key_md5
|
1612
1633
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -1750,8 +1771,14 @@ module Aws::S3
|
|
1750
1771
|
#
|
1751
1772
|
# **Related Resources**
|
1752
1773
|
#
|
1753
|
-
# *
|
1754
|
-
#
|
1774
|
+
# * [CreateBucket][1]
|
1775
|
+
#
|
1776
|
+
# * [DeleteObject][2]
|
1777
|
+
#
|
1778
|
+
#
|
1779
|
+
#
|
1780
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
1781
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
1755
1782
|
#
|
1756
1783
|
# @option params [required, String] :bucket
|
1757
1784
|
# Specifies the bucket being deleted.
|
@@ -1798,15 +1825,20 @@ module Aws::S3
|
|
1798
1825
|
# The following operations are related to
|
1799
1826
|
# `DeleteBucketAnalyticsConfiguration`\:
|
1800
1827
|
#
|
1801
|
-
# *
|
1802
|
-
#
|
1803
|
-
# *
|
1828
|
+
# * [GetBucketAnalyticsConfiguration][4]
|
1829
|
+
#
|
1830
|
+
# * [ListBucketAnalyticsConfigurations][5]
|
1831
|
+
#
|
1832
|
+
# * [PutBucketAnalyticsConfiguration][6]
|
1804
1833
|
#
|
1805
1834
|
#
|
1806
1835
|
#
|
1807
1836
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
1808
1837
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
1809
1838
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
|
1839
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
|
1840
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
|
1841
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAnalyticsConfiguration.html
|
1810
1842
|
#
|
1811
1843
|
# @option params [required, String] :bucket
|
1812
1844
|
# The name of the bucket from which an analytics configuration is
|
@@ -1844,12 +1876,15 @@ module Aws::S3
|
|
1844
1876
|
#
|
1845
1877
|
# **Related Resources:**
|
1846
1878
|
#
|
1847
|
-
# *
|
1848
|
-
#
|
1879
|
+
# * [PutBucketCors][2]
|
1880
|
+
#
|
1881
|
+
# * [RESTOPTIONSobject][3]
|
1849
1882
|
#
|
1850
1883
|
#
|
1851
1884
|
#
|
1852
1885
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
1886
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html
|
1887
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTOPTIONSobject.html
|
1853
1888
|
#
|
1854
1889
|
# @option params [required, String] :bucket
|
1855
1890
|
# Specifies the bucket whose `cors` configuration is being deleted.
|
@@ -1895,15 +1930,17 @@ module Aws::S3
|
|
1895
1930
|
#
|
1896
1931
|
# **Related Resources**
|
1897
1932
|
#
|
1898
|
-
# * PutBucketEncryption
|
1933
|
+
# * [PutBucketEncryption][4]
|
1899
1934
|
#
|
1900
|
-
# * GetBucketEncryption
|
1935
|
+
# * [GetBucketEncryption][5]
|
1901
1936
|
#
|
1902
1937
|
#
|
1903
1938
|
#
|
1904
1939
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
1905
1940
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
1906
1941
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
1942
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
|
1943
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
1907
1944
|
#
|
1908
1945
|
# @option params [required, String] :bucket
|
1909
1946
|
# The name of the bucket containing the server-side encryption
|
@@ -1941,17 +1978,20 @@ module Aws::S3
|
|
1941
1978
|
#
|
1942
1979
|
# Operations related to `DeleteBucketInventoryConfiguration` include:
|
1943
1980
|
#
|
1944
|
-
# * GetBucketInventoryConfiguration
|
1981
|
+
# * [GetBucketInventoryConfiguration][4]
|
1945
1982
|
#
|
1946
|
-
# * PutBucketInventoryConfiguration
|
1983
|
+
# * [PutBucketInventoryConfiguration][5]
|
1947
1984
|
#
|
1948
|
-
# * ListBucketInventoryConfigurations
|
1985
|
+
# * [ListBucketInventoryConfigurations][6]
|
1949
1986
|
#
|
1950
1987
|
#
|
1951
1988
|
#
|
1952
1989
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
1953
1990
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
1954
1991
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
|
1992
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
|
1993
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html
|
1994
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
|
1955
1995
|
#
|
1956
1996
|
# @option params [required, String] :bucket
|
1957
1997
|
# The name of the bucket containing the inventory configuration to
|
@@ -1997,13 +2037,15 @@ module Aws::S3
|
|
1997
2037
|
#
|
1998
2038
|
# Related actions include:
|
1999
2039
|
#
|
2000
|
-
# * PutBucketLifecycleConfiguration
|
2040
|
+
# * [PutBucketLifecycleConfiguration][2]
|
2001
2041
|
#
|
2002
|
-
# * GetBucketLifecycleConfiguration
|
2042
|
+
# * [GetBucketLifecycleConfiguration][3]
|
2003
2043
|
#
|
2004
2044
|
#
|
2005
2045
|
#
|
2006
2046
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
|
2047
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
2048
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
2007
2049
|
#
|
2008
2050
|
# @option params [required, String] :bucket
|
2009
2051
|
# The bucket name of the lifecycle to delete.
|
@@ -2051,11 +2093,11 @@ module Aws::S3
|
|
2051
2093
|
# The following operations are related to
|
2052
2094
|
# `DeleteBucketMetricsConfiguration`\:
|
2053
2095
|
#
|
2054
|
-
# * GetBucketMetricsConfiguration
|
2096
|
+
# * [GetBucketMetricsConfiguration][4]
|
2055
2097
|
#
|
2056
|
-
# * PutBucketMetricsConfiguration
|
2098
|
+
# * [PutBucketMetricsConfiguration][5]
|
2057
2099
|
#
|
2058
|
-
# * ListBucketMetricsConfigurations
|
2100
|
+
# * [ListBucketMetricsConfigurations][6]
|
2059
2101
|
#
|
2060
2102
|
# * [Monitoring Metrics with Amazon CloudWatch][3]
|
2061
2103
|
#
|
@@ -2064,6 +2106,9 @@ module Aws::S3
|
|
2064
2106
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2065
2107
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2066
2108
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
|
2109
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
|
2110
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
|
2111
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
|
2067
2112
|
#
|
2068
2113
|
# @option params [required, String] :bucket
|
2069
2114
|
# The name of the bucket containing the metrics configuration to delete.
|
@@ -2111,9 +2156,14 @@ module Aws::S3
|
|
2111
2156
|
#
|
2112
2157
|
# The following operations are related to `DeleteBucketPolicy`
|
2113
2158
|
#
|
2114
|
-
# * CreateBucket
|
2159
|
+
# * [CreateBucket][1]
|
2115
2160
|
#
|
2116
|
-
# * DeleteObject
|
2161
|
+
# * [DeleteObject][2]
|
2162
|
+
#
|
2163
|
+
#
|
2164
|
+
#
|
2165
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
2166
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
2117
2167
|
#
|
2118
2168
|
# @option params [required, String] :bucket
|
2119
2169
|
# The bucket name.
|
@@ -2164,14 +2214,16 @@ module Aws::S3
|
|
2164
2214
|
#
|
2165
2215
|
# The following operations are related to `DeleteBucketReplication`\:
|
2166
2216
|
#
|
2167
|
-
# * PutBucketReplication
|
2217
|
+
# * [PutBucketReplication][3]
|
2168
2218
|
#
|
2169
|
-
# * GetBucketReplication
|
2219
|
+
# * [GetBucketReplication][4]
|
2170
2220
|
#
|
2171
2221
|
#
|
2172
2222
|
#
|
2173
2223
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2174
2224
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2225
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
|
2226
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
|
2175
2227
|
#
|
2176
2228
|
# @option params [required, String] :bucket
|
2177
2229
|
# The bucket name.
|
@@ -2210,9 +2262,14 @@ module Aws::S3
|
|
2210
2262
|
#
|
2211
2263
|
# The following operations are related to `DeleteBucketTagging`\:
|
2212
2264
|
#
|
2213
|
-
# * GetBucketTagging
|
2265
|
+
# * [GetBucketTagging][1]
|
2266
|
+
#
|
2267
|
+
# * [PutBucketTagging][2]
|
2214
2268
|
#
|
2215
|
-
#
|
2269
|
+
#
|
2270
|
+
#
|
2271
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
|
2272
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
|
2216
2273
|
#
|
2217
2274
|
# @option params [required, String] :bucket
|
2218
2275
|
# The bucket that has the tag set to be removed.
|
@@ -2261,13 +2318,15 @@ module Aws::S3
|
|
2261
2318
|
#
|
2262
2319
|
# The following operations are related to `DeleteBucketWebsite`\:
|
2263
2320
|
#
|
2264
|
-
# * GetBucketWebsite
|
2321
|
+
# * [GetBucketWebsite][2]
|
2265
2322
|
#
|
2266
|
-
# * PutBucketWebsite
|
2323
|
+
# * [PutBucketWebsite][3]
|
2267
2324
|
#
|
2268
2325
|
#
|
2269
2326
|
#
|
2270
2327
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
2328
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketWebsite.html
|
2329
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketWebsite.html
|
2271
2330
|
#
|
2272
2331
|
# @option params [required, String] :bucket
|
2273
2332
|
# The bucket name for which you want to remove the website
|
@@ -2318,15 +2377,15 @@ module Aws::S3
|
|
2318
2377
|
# see sample requests that use versioning, see [Sample Request][2].
|
2319
2378
|
#
|
2320
2379
|
# You can delete objects by explicitly calling the DELETE Object API or
|
2321
|
-
# configure its lifecycle (PutBucketLifecycle) to enable Amazon S3
|
2322
|
-
# remove them for you. If you want to block users or accounts from
|
2380
|
+
# configure its lifecycle ([PutBucketLifecycle][3]) to enable Amazon S3
|
2381
|
+
# to remove them for you. If you want to block users or accounts from
|
2323
2382
|
# removing or deleting objects from your bucket, you must deny them the
|
2324
2383
|
# `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
|
2325
2384
|
# `s3:PutLifeCycleConfiguration` actions.
|
2326
2385
|
#
|
2327
2386
|
# The following operation is related to `DeleteObject`\:
|
2328
2387
|
#
|
2329
|
-
# * PutObject
|
2388
|
+
# * [PutObject][4]
|
2330
2389
|
#
|
2331
2390
|
# ^
|
2332
2391
|
#
|
@@ -2334,6 +2393,8 @@ module Aws::S3
|
|
2334
2393
|
#
|
2335
2394
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
|
2336
2395
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
|
2396
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
2397
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
2337
2398
|
#
|
2338
2399
|
# @option params [required, String] :bucket
|
2339
2400
|
# The bucket name of the bucket containing the object.
|
@@ -2445,13 +2506,15 @@ module Aws::S3
|
|
2445
2506
|
# The following operations are related to
|
2446
2507
|
# `DeleteBucketMetricsConfiguration`\:
|
2447
2508
|
#
|
2448
|
-
# * PutObjectTagging
|
2509
|
+
# * [PutObjectTagging][2]
|
2449
2510
|
#
|
2450
|
-
# * GetObjectTagging
|
2511
|
+
# * [GetObjectTagging][3]
|
2451
2512
|
#
|
2452
2513
|
#
|
2453
2514
|
#
|
2454
2515
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
2516
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html
|
2517
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
|
2455
2518
|
#
|
2456
2519
|
# @option params [required, String] :bucket
|
2457
2520
|
# The bucket name containing the objects from which to remove the tags.
|
@@ -2469,7 +2532,7 @@ module Aws::S3
|
|
2469
2532
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
2470
2533
|
#
|
2471
2534
|
# @option params [required, String] :key
|
2472
|
-
# Name of the
|
2535
|
+
# Name of the object key.
|
2473
2536
|
#
|
2474
2537
|
# @option params [String] :version_id
|
2475
2538
|
# The versionId of the object that the tag-set will be removed from.
|
@@ -2479,35 +2542,35 @@ module Aws::S3
|
|
2479
2542
|
# * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
|
2480
2543
|
#
|
2481
2544
|
#
|
2482
|
-
# @example Example: To remove tag set from an object
|
2545
|
+
# @example Example: To remove tag set from an object
|
2483
2546
|
#
|
2484
|
-
# # The following example removes tag set associated with the specified object
|
2485
|
-
# #
|
2547
|
+
# # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
|
2548
|
+
# # operation removes tag set from the latest object version.
|
2486
2549
|
#
|
2487
2550
|
# resp = client.delete_object_tagging({
|
2488
2551
|
# bucket: "examplebucket",
|
2489
2552
|
# key: "HappyFace.jpg",
|
2490
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
2491
2553
|
# })
|
2492
2554
|
#
|
2493
2555
|
# resp.to_h outputs the following:
|
2494
2556
|
# {
|
2495
|
-
# version_id: "
|
2557
|
+
# version_id: "null",
|
2496
2558
|
# }
|
2497
2559
|
#
|
2498
|
-
# @example Example: To remove tag set from an object
|
2560
|
+
# @example Example: To remove tag set from an object version
|
2499
2561
|
#
|
2500
|
-
# # The following example removes tag set associated with the specified object.
|
2501
|
-
# #
|
2562
|
+
# # The following example removes tag set associated with the specified object version. The request specifies both the
|
2563
|
+
# # object key and object version.
|
2502
2564
|
#
|
2503
2565
|
# resp = client.delete_object_tagging({
|
2504
2566
|
# bucket: "examplebucket",
|
2505
2567
|
# key: "HappyFace.jpg",
|
2568
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
2506
2569
|
# })
|
2507
2570
|
#
|
2508
2571
|
# resp.to_h outputs the following:
|
2509
2572
|
# {
|
2510
|
-
# version_id: "
|
2573
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
2511
2574
|
# }
|
2512
2575
|
#
|
2513
2576
|
# @example Request syntax with placeholder values
|
@@ -2565,19 +2628,24 @@ module Aws::S3
|
|
2565
2628
|
#
|
2566
2629
|
# The following operations are related to `DeleteObjects`\:
|
2567
2630
|
#
|
2568
|
-
# * CreateMultipartUpload
|
2631
|
+
# * [CreateMultipartUpload][2]
|
2569
2632
|
#
|
2570
|
-
# * UploadPart
|
2633
|
+
# * [UploadPart][3]
|
2571
2634
|
#
|
2572
|
-
# * CompleteMultipartUpload
|
2635
|
+
# * [CompleteMultipartUpload][4]
|
2573
2636
|
#
|
2574
|
-
# * ListParts
|
2637
|
+
# * [ListParts][5]
|
2575
2638
|
#
|
2576
|
-
# * AbortMultipartUpload
|
2639
|
+
# * [AbortMultipartUpload][6]
|
2577
2640
|
#
|
2578
2641
|
#
|
2579
2642
|
#
|
2580
2643
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
|
2644
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
2645
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
2646
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
2647
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
2648
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
2581
2649
|
#
|
2582
2650
|
# @option params [required, String] :bucket
|
2583
2651
|
# The bucket name containing the objects to delete.
|
@@ -2750,17 +2818,20 @@ module Aws::S3
|
|
2750
2818
|
#
|
2751
2819
|
# * [Using Amazon S3 Block Public Access][3]
|
2752
2820
|
#
|
2753
|
-
# * GetPublicAccessBlock
|
2821
|
+
# * [GetPublicAccessBlock][4]
|
2754
2822
|
#
|
2755
|
-
# * PutPublicAccessBlock
|
2823
|
+
# * [PutPublicAccessBlock][5]
|
2756
2824
|
#
|
2757
|
-
# * GetBucketPolicyStatus
|
2825
|
+
# * [GetBucketPolicyStatus][6]
|
2758
2826
|
#
|
2759
2827
|
#
|
2760
2828
|
#
|
2761
2829
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2762
2830
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2763
2831
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
|
2832
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html
|
2833
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html
|
2834
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicyStatus.html
|
2764
2835
|
#
|
2765
2836
|
# @option params [required, String] :bucket
|
2766
2837
|
# The Amazon S3 bucket whose `PublicAccessBlock` configuration you want
|
@@ -2798,19 +2869,19 @@ module Aws::S3
|
|
2798
2869
|
# Storage Service Developer Guide*.
|
2799
2870
|
#
|
2800
2871
|
# You set the Transfer Acceleration state of an existing bucket to
|
2801
|
-
# `Enabled` or `Suspended` by using the
|
2802
|
-
# operation.
|
2872
|
+
# `Enabled` or `Suspended` by using the
|
2873
|
+
# [PutBucketAccelerateConfiguration][3] operation.
|
2803
2874
|
#
|
2804
2875
|
# A GET `accelerate` request does not return a state value for a bucket
|
2805
2876
|
# that has no transfer acceleration state. A bucket has no Transfer
|
2806
2877
|
# Acceleration state if a state has never been set on the bucket.
|
2807
2878
|
#
|
2808
2879
|
# For more information about transfer acceleration, see [Transfer
|
2809
|
-
# Acceleration][
|
2880
|
+
# Acceleration][4] in the Amazon Simple Storage Service Developer Guide.
|
2810
2881
|
#
|
2811
2882
|
# **Related Resources**
|
2812
2883
|
#
|
2813
|
-
# * PutBucketAccelerateConfiguration
|
2884
|
+
# * [PutBucketAccelerateConfiguration][3]
|
2814
2885
|
#
|
2815
2886
|
# ^
|
2816
2887
|
#
|
@@ -2818,7 +2889,8 @@ module Aws::S3
|
|
2818
2889
|
#
|
2819
2890
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2820
2891
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2821
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2892
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAccelerateConfiguration.html
|
2893
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
|
2822
2894
|
#
|
2823
2895
|
# @option params [required, String] :bucket
|
2824
2896
|
# Name of the bucket for which the accelerate configuration is
|
@@ -2856,9 +2928,14 @@ module Aws::S3
|
|
2856
2928
|
#
|
2857
2929
|
# **Related Resources**
|
2858
2930
|
#
|
2859
|
-
# *
|
2931
|
+
# * [ListObjects][1]
|
2932
|
+
#
|
2860
2933
|
# ^
|
2861
2934
|
#
|
2935
|
+
#
|
2936
|
+
#
|
2937
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
|
2938
|
+
#
|
2862
2939
|
# @option params [required, String] :bucket
|
2863
2940
|
# Specifies the S3 bucket whose ACL is being requested.
|
2864
2941
|
#
|
@@ -2912,15 +2989,20 @@ module Aws::S3
|
|
2912
2989
|
#
|
2913
2990
|
# **Related Resources**
|
2914
2991
|
#
|
2915
|
-
# *
|
2916
|
-
#
|
2917
|
-
# *
|
2992
|
+
# * [DeleteBucketAnalyticsConfiguration][4]
|
2993
|
+
#
|
2994
|
+
# * [ListBucketAnalyticsConfigurations][5]
|
2995
|
+
#
|
2996
|
+
# * [PutBucketAnalyticsConfiguration][6]
|
2918
2997
|
#
|
2919
2998
|
#
|
2920
2999
|
#
|
2921
3000
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2922
3001
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2923
3002
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
|
3003
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
|
3004
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
|
3005
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAnalyticsConfiguration.html
|
2924
3006
|
#
|
2925
3007
|
# @option params [required, String] :bucket
|
2926
3008
|
# The name of the bucket from which an analytics configuration is
|
@@ -2976,13 +3058,15 @@ module Aws::S3
|
|
2976
3058
|
#
|
2977
3059
|
# The following operations are related to `GetBucketCors`\:
|
2978
3060
|
#
|
2979
|
-
# * PutBucketCors
|
3061
|
+
# * [PutBucketCors][2]
|
2980
3062
|
#
|
2981
|
-
# * DeleteBucketCors
|
3063
|
+
# * [DeleteBucketCors][3]
|
2982
3064
|
#
|
2983
3065
|
#
|
2984
3066
|
#
|
2985
3067
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
3068
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html
|
3069
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html
|
2986
3070
|
#
|
2987
3071
|
# @option params [required, String] :bucket
|
2988
3072
|
# The bucket name for which to get the cors configuration.
|
@@ -3059,15 +3143,17 @@ module Aws::S3
|
|
3059
3143
|
#
|
3060
3144
|
# The following operations are related to `GetBucketEncryption`\:
|
3061
3145
|
#
|
3062
|
-
# * PutBucketEncryption
|
3146
|
+
# * [PutBucketEncryption][4]
|
3063
3147
|
#
|
3064
|
-
# * DeleteBucketEncryption
|
3148
|
+
# * [DeleteBucketEncryption][5]
|
3065
3149
|
#
|
3066
3150
|
#
|
3067
3151
|
#
|
3068
3152
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
3069
3153
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3070
3154
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3155
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
|
3156
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
3071
3157
|
#
|
3072
3158
|
# @option params [required, String] :bucket
|
3073
3159
|
# The name of the bucket from which the server-side encryption
|
@@ -3114,17 +3200,20 @@ module Aws::S3
|
|
3114
3200
|
# The following operations are related to
|
3115
3201
|
# `GetBucketInventoryConfiguration`\:
|
3116
3202
|
#
|
3117
|
-
# * DeleteBucketInventoryConfiguration
|
3203
|
+
# * [DeleteBucketInventoryConfiguration][4]
|
3118
3204
|
#
|
3119
|
-
# * ListBucketInventoryConfigurations
|
3205
|
+
# * [ListBucketInventoryConfigurations][5]
|
3120
3206
|
#
|
3121
|
-
# * PutBucketInventoryConfiguration
|
3207
|
+
# * [PutBucketInventoryConfiguration][6]
|
3122
3208
|
#
|
3123
3209
|
#
|
3124
3210
|
#
|
3125
3211
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3126
3212
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3127
3213
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
|
3214
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
|
3215
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
|
3216
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html
|
3128
3217
|
#
|
3129
3218
|
# @option params [required, String] :bucket
|
3130
3219
|
# The name of the bucket containing the inventory configuration to
|
@@ -3169,20 +3258,21 @@ module Aws::S3
|
|
3169
3258
|
end
|
3170
3259
|
|
3171
3260
|
# For an updated version of this API, see
|
3172
|
-
# GetBucketLifecycleConfiguration. If you configured a bucket
|
3173
|
-
# using the `filter` element, you should see the updated
|
3174
|
-
# topic. This topic is provided for backward
|
3261
|
+
# [GetBucketLifecycleConfiguration][1]. If you configured a bucket
|
3262
|
+
# lifecycle using the `filter` element, you should see the updated
|
3263
|
+
# version of this topic. This topic is provided for backward
|
3264
|
+
# compatibility.
|
3175
3265
|
#
|
3176
3266
|
# Returns the lifecycle configuration information set on the bucket. For
|
3177
3267
|
# information about lifecycle configuration, see [Object Lifecycle
|
3178
|
-
# Management][
|
3268
|
+
# Management][2].
|
3179
3269
|
#
|
3180
3270
|
# To use this operation, you must have permission to perform the
|
3181
3271
|
# `s3:GetLifecycleConfiguration` action. The bucket owner has this
|
3182
3272
|
# permission by default. The bucket owner can grant this permission to
|
3183
3273
|
# others. For more information about permissions, see [Permissions
|
3184
|
-
# Related to Bucket Subresource Operations][
|
3185
|
-
# Permissions to Your Amazon S3 Resources][
|
3274
|
+
# Related to Bucket Subresource Operations][3] and [Managing Access
|
3275
|
+
# Permissions to Your Amazon S3 Resources][4].
|
3186
3276
|
#
|
3187
3277
|
# `GetBucketLifecycle` has the following special error:
|
3188
3278
|
#
|
@@ -3196,17 +3286,20 @@ module Aws::S3
|
|
3196
3286
|
#
|
3197
3287
|
# The following operations are related to `GetBucketLifecycle`\:
|
3198
3288
|
#
|
3199
|
-
# * GetBucketLifecycleConfiguration
|
3289
|
+
# * [GetBucketLifecycleConfiguration][1]
|
3200
3290
|
#
|
3201
|
-
# * PutBucketLifecycle
|
3291
|
+
# * [PutBucketLifecycle][5]
|
3202
3292
|
#
|
3203
|
-
# * DeleteBucketLifecycle
|
3293
|
+
# * [DeleteBucketLifecycle][6]
|
3204
3294
|
#
|
3205
3295
|
#
|
3206
3296
|
#
|
3207
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3208
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
3209
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-
|
3297
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
3298
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
3299
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3300
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3301
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
3302
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
3210
3303
|
#
|
3211
3304
|
# @option params [required, String] :bucket
|
3212
3305
|
# The name of the bucket for which to get the lifecycle information.
|
@@ -3277,20 +3370,20 @@ module Aws::S3
|
|
3277
3370
|
# specify a filter to select a subset of objects to which the rule
|
3278
3371
|
# applies. If you are still using previous version of the lifecycle
|
3279
3372
|
# configuration, it works. For the earlier API description, see
|
3280
|
-
# GetBucketLifecycle.
|
3373
|
+
# [GetBucketLifecycle][1].
|
3281
3374
|
#
|
3282
3375
|
# </note>
|
3283
3376
|
#
|
3284
3377
|
# Returns the lifecycle configuration information set on the bucket. For
|
3285
3378
|
# information about lifecycle configuration, see [Object Lifecycle
|
3286
|
-
# Management][
|
3379
|
+
# Management][2].
|
3287
3380
|
#
|
3288
3381
|
# To use this operation, you must have permission to perform the
|
3289
3382
|
# `s3:GetLifecycleConfiguration` action. The bucket owner has this
|
3290
3383
|
# permission, by default. The bucket owner can grant this permission to
|
3291
3384
|
# others. For more information about permissions, see [Permissions
|
3292
|
-
# Related to Bucket Subresource Operations][
|
3293
|
-
# Permissions to Your Amazon S3 Resources][
|
3385
|
+
# Related to Bucket Subresource Operations][3] and [Managing Access
|
3386
|
+
# Permissions to Your Amazon S3 Resources][4].
|
3294
3387
|
#
|
3295
3388
|
# `GetBucketLifecycleConfiguration` has the following special error:
|
3296
3389
|
#
|
@@ -3305,17 +3398,20 @@ module Aws::S3
|
|
3305
3398
|
# The following operations are related to
|
3306
3399
|
# `GetBucketLifecycleConfiguration`\:
|
3307
3400
|
#
|
3308
|
-
# * GetBucketLifecycle
|
3401
|
+
# * [GetBucketLifecycle][1]
|
3309
3402
|
#
|
3310
|
-
# * PutBucketLifecycle
|
3403
|
+
# * [PutBucketLifecycle][5]
|
3311
3404
|
#
|
3312
|
-
# * DeleteBucketLifecycle
|
3405
|
+
# * [DeleteBucketLifecycle][6]
|
3313
3406
|
#
|
3314
3407
|
#
|
3315
3408
|
#
|
3316
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3317
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
3318
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-
|
3409
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
|
3410
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
3411
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3412
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3413
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
3414
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
3319
3415
|
#
|
3320
3416
|
# @option params [required, String] :bucket
|
3321
3417
|
# The name of the bucket for which to get the lifecycle information.
|
@@ -3393,16 +3489,21 @@ module Aws::S3
|
|
3393
3489
|
|
3394
3490
|
# Returns the Region the bucket resides in. You set the bucket's Region
|
3395
3491
|
# using the `LocationConstraint` request parameter in a `CreateBucket`
|
3396
|
-
# request. For more information, see CreateBucket.
|
3492
|
+
# request. For more information, see [CreateBucket][1].
|
3397
3493
|
#
|
3398
3494
|
# To use this implementation of the operation, you must be the bucket
|
3399
3495
|
# owner.
|
3400
3496
|
#
|
3401
3497
|
# The following operations are related to `GetBucketLocation`\:
|
3402
3498
|
#
|
3403
|
-
# * GetObject
|
3499
|
+
# * [GetObject][2]
|
3404
3500
|
#
|
3405
|
-
# * CreateBucket
|
3501
|
+
# * [CreateBucket][1]
|
3502
|
+
#
|
3503
|
+
#
|
3504
|
+
#
|
3505
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
3506
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
3406
3507
|
#
|
3407
3508
|
# @option params [required, String] :bucket
|
3408
3509
|
# The name of the bucket for which to get the location.
|
@@ -3450,9 +3551,14 @@ module Aws::S3
|
|
3450
3551
|
#
|
3451
3552
|
# The following operations are related to `GetBucketLogging`\:
|
3452
3553
|
#
|
3453
|
-
# * CreateBucket
|
3554
|
+
# * [CreateBucket][1]
|
3555
|
+
#
|
3556
|
+
# * [PutBucketLogging][2]
|
3557
|
+
#
|
3454
3558
|
#
|
3455
|
-
#
|
3559
|
+
#
|
3560
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
3561
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLogging.html
|
3456
3562
|
#
|
3457
3563
|
# @option params [required, String] :bucket
|
3458
3564
|
# The bucket name for which to get the logging information.
|
@@ -3505,11 +3611,11 @@ module Aws::S3
|
|
3505
3611
|
# The following operations are related to
|
3506
3612
|
# `GetBucketMetricsConfiguration`\:
|
3507
3613
|
#
|
3508
|
-
# * PutBucketMetricsConfiguration
|
3614
|
+
# * [PutBucketMetricsConfiguration][4]
|
3509
3615
|
#
|
3510
|
-
# * DeleteBucketMetricsConfiguration
|
3616
|
+
# * [DeleteBucketMetricsConfiguration][5]
|
3511
3617
|
#
|
3512
|
-
# * ListBucketMetricsConfigurations
|
3618
|
+
# * [ListBucketMetricsConfigurations][6]
|
3513
3619
|
#
|
3514
3620
|
# * [Monitoring Metrics with Amazon CloudWatch][3]
|
3515
3621
|
#
|
@@ -3518,6 +3624,9 @@ module Aws::S3
|
|
3518
3624
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3519
3625
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3520
3626
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
|
3627
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
|
3628
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
|
3629
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
|
3521
3630
|
#
|
3522
3631
|
# @option params [required, String] :bucket
|
3523
3632
|
# The name of the bucket containing the metrics configuration to
|
@@ -3557,7 +3666,11 @@ module Aws::S3
|
|
3557
3666
|
req.send_request(options)
|
3558
3667
|
end
|
3559
3668
|
|
3560
|
-
# No longer used, see GetBucketNotificationConfiguration.
|
3669
|
+
# No longer used, see [GetBucketNotificationConfiguration][1].
|
3670
|
+
#
|
3671
|
+
#
|
3672
|
+
#
|
3673
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html
|
3561
3674
|
#
|
3562
3675
|
# @option params [required, String] :bucket
|
3563
3676
|
# Name of the bucket for which to get the notification configuration.
|
@@ -3676,7 +3789,7 @@ module Aws::S3
|
|
3676
3789
|
#
|
3677
3790
|
# The following operation is related to `GetBucketNotification`\:
|
3678
3791
|
#
|
3679
|
-
# * PutBucketNotification
|
3792
|
+
# * [PutBucketNotification][3]
|
3680
3793
|
#
|
3681
3794
|
# ^
|
3682
3795
|
#
|
@@ -3684,6 +3797,7 @@ module Aws::S3
|
|
3684
3797
|
#
|
3685
3798
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
3686
3799
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
3800
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotification.html
|
3687
3801
|
#
|
3688
3802
|
# @option params [required, String] :bucket
|
3689
3803
|
# Name of the bucket for which to get the notification configuration.
|
@@ -3756,13 +3870,14 @@ module Aws::S3
|
|
3756
3870
|
#
|
3757
3871
|
# The following operation is related to `GetBucketPolicy`\:
|
3758
3872
|
#
|
3759
|
-
# * GetObject
|
3873
|
+
# * [GetObject][2]
|
3760
3874
|
#
|
3761
3875
|
# ^
|
3762
3876
|
#
|
3763
3877
|
#
|
3764
3878
|
#
|
3765
3879
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
3880
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
3766
3881
|
#
|
3767
3882
|
# @option params [required, String] :bucket
|
3768
3883
|
# The bucket name for which to get the bucket policy.
|
@@ -3817,17 +3932,20 @@ module Aws::S3
|
|
3817
3932
|
#
|
3818
3933
|
# * [Using Amazon S3 Block Public Access][3]
|
3819
3934
|
#
|
3820
|
-
# * GetPublicAccessBlock
|
3935
|
+
# * [GetPublicAccessBlock][4]
|
3821
3936
|
#
|
3822
|
-
# * PutPublicAccessBlock
|
3937
|
+
# * [PutPublicAccessBlock][5]
|
3823
3938
|
#
|
3824
|
-
# * DeletePublicAccessBlock
|
3939
|
+
# * [DeletePublicAccessBlock][6]
|
3825
3940
|
#
|
3826
3941
|
#
|
3827
3942
|
#
|
3828
3943
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
3829
3944
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
|
3830
3945
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
|
3946
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html
|
3947
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html
|
3948
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
|
3831
3949
|
#
|
3832
3950
|
# @option params [required, String] :bucket
|
3833
3951
|
# The name of the Amazon S3 bucket whose policy status you want to
|
@@ -3875,19 +3993,22 @@ module Aws::S3
|
|
3875
3993
|
# you must also include the `DeleteMarkerReplication` and `Priority`
|
3876
3994
|
# elements. The response also returns those elements.
|
3877
3995
|
#
|
3878
|
-
# For information about `GetBucketReplication` errors, see
|
3879
|
-
#
|
3996
|
+
# For information about `GetBucketReplication` errors, see [List of
|
3997
|
+
# replication-related error codes][3]
|
3880
3998
|
#
|
3881
3999
|
# The following operations are related to `GetBucketReplication`\:
|
3882
4000
|
#
|
3883
|
-
# * PutBucketReplication
|
4001
|
+
# * [PutBucketReplication][4]
|
3884
4002
|
#
|
3885
|
-
# * DeleteBucketReplication
|
4003
|
+
# * [DeleteBucketReplication][5]
|
3886
4004
|
#
|
3887
4005
|
#
|
3888
4006
|
#
|
3889
4007
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
|
3890
4008
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
4009
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList
|
4010
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
|
4011
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html
|
3891
4012
|
#
|
3892
4013
|
# @option params [required, String] :bucket
|
3893
4014
|
# The bucket name for which to get the replication information.
|
@@ -3971,13 +4092,14 @@ module Aws::S3
|
|
3971
4092
|
#
|
3972
4093
|
# The following operations are related to `GetBucketRequestPayment`\:
|
3973
4094
|
#
|
3974
|
-
# * ListObjects
|
4095
|
+
# * [ListObjects][2]
|
3975
4096
|
#
|
3976
4097
|
# ^
|
3977
4098
|
#
|
3978
4099
|
#
|
3979
4100
|
#
|
3980
4101
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
|
4102
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
|
3981
4103
|
#
|
3982
4104
|
# @option params [required, String] :bucket
|
3983
4105
|
# The name of the bucket for which to get the payment request
|
@@ -4036,9 +4158,14 @@ module Aws::S3
|
|
4036
4158
|
#
|
4037
4159
|
# The following operations are related to `GetBucketTagging`\:
|
4038
4160
|
#
|
4039
|
-
# * PutBucketTagging
|
4161
|
+
# * [PutBucketTagging][1]
|
4040
4162
|
#
|
4041
|
-
# * DeleteBucketTagging
|
4163
|
+
# * [DeleteBucketTagging][2]
|
4164
|
+
#
|
4165
|
+
#
|
4166
|
+
#
|
4167
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
|
4168
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
4042
4169
|
#
|
4043
4170
|
# @option params [required, String] :bucket
|
4044
4171
|
# The name of the bucket for which to get the tagging information.
|
@@ -4103,11 +4230,17 @@ module Aws::S3
|
|
4103
4230
|
#
|
4104
4231
|
# The following operations are related to `GetBucketVersioning`\:
|
4105
4232
|
#
|
4106
|
-
# * GetObject
|
4233
|
+
# * [GetObject][1]
|
4234
|
+
#
|
4235
|
+
# * [PutObject][2]
|
4236
|
+
#
|
4237
|
+
# * [DeleteObject][3]
|
4107
4238
|
#
|
4108
|
-
# * PutObject
|
4109
4239
|
#
|
4110
|
-
#
|
4240
|
+
#
|
4241
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
4242
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
4243
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
4111
4244
|
#
|
4112
4245
|
# @option params [required, String] :bucket
|
4113
4246
|
# The name of the bucket for which to get the versioning information.
|
@@ -4165,13 +4298,15 @@ module Aws::S3
|
|
4165
4298
|
#
|
4166
4299
|
# The following operations are related to `DeleteBucketWebsite`\:
|
4167
4300
|
#
|
4168
|
-
# * DeleteBucketWebsite
|
4301
|
+
# * [DeleteBucketWebsite][2]
|
4169
4302
|
#
|
4170
|
-
# * PutBucketWebsite
|
4303
|
+
# * [PutBucketWebsite][3]
|
4171
4304
|
#
|
4172
4305
|
#
|
4173
4306
|
#
|
4174
4307
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
4308
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketWebsite.html
|
4309
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketWebsite.html
|
4175
4310
|
#
|
4176
4311
|
# @option params [required, String] :bucket
|
4177
4312
|
# The bucket name for which to get the website configuration.
|
@@ -4255,13 +4390,13 @@ module Aws::S3
|
|
4255
4390
|
# To distribute large files to many people, you can save bandwidth costs
|
4256
4391
|
# by using BitTorrent. For more information, see [Amazon S3 Torrent][2].
|
4257
4392
|
# For more information about returning the ACL of an object, see
|
4258
|
-
# GetObjectAcl.
|
4393
|
+
# [GetObjectAcl][3].
|
4259
4394
|
#
|
4260
4395
|
# If the object you are retrieving is stored in the GLACIER or
|
4261
4396
|
# DEEP\_ARCHIVE storage classes, before you can retrieve the object you
|
4262
|
-
# must first restore a copy using . Otherwise, this
|
4263
|
-
# `InvalidObjectStateError` error. For information
|
4264
|
-
# archived objects, see [Restoring Archived Objects][
|
4397
|
+
# must first restore a copy using [RestoreObject][4]. Otherwise, this
|
4398
|
+
# operation returns an `InvalidObjectStateError` error. For information
|
4399
|
+
# about restoring archived objects, see [Restoring Archived Objects][5].
|
4265
4400
|
#
|
4266
4401
|
# Encryption request headers, like `x-amz-server-side-encryption`,
|
4267
4402
|
# should not be sent for GET requests if your object uses server-side
|
@@ -4275,25 +4410,25 @@ module Aws::S3
|
|
4275
4410
|
# Amazon S3, then when you GET the object, you must use the following
|
4276
4411
|
# headers:
|
4277
4412
|
#
|
4278
|
-
# * x-amz-server-side
|
4413
|
+
# * x-amz-server-side-encryption-customer-algorithm
|
4279
4414
|
#
|
4280
|
-
# * x-amz-server-side
|
4415
|
+
# * x-amz-server-side-encryption-customer-key
|
4281
4416
|
#
|
4282
|
-
# * x-amz-server-side
|
4417
|
+
# * x-amz-server-side-encryption-customer-key-MD5
|
4283
4418
|
#
|
4284
4419
|
# For more information about SSE-C, see [Server-Side Encryption (Using
|
4285
|
-
# Customer-Provided Encryption Keys)][
|
4420
|
+
# Customer-Provided Encryption Keys)][6].
|
4286
4421
|
#
|
4287
4422
|
# Assuming you have permission to read object tags (permission for the
|
4288
4423
|
# `s3:GetObjectVersionTagging` action), the response also returns the
|
4289
4424
|
# `x-amz-tagging-count` header that provides the count of number of tags
|
4290
|
-
# associated with the object. You can use GetObjectTagging to
|
4291
|
-
# the tag set associated with an object.
|
4425
|
+
# associated with the object. You can use [GetObjectTagging][7] to
|
4426
|
+
# retrieve the tag set associated with an object.
|
4292
4427
|
#
|
4293
4428
|
# **Permissions**
|
4294
4429
|
#
|
4295
4430
|
# You need the `s3:GetObject` permission for this operation. For more
|
4296
|
-
# information, see [Specifying Permissions in a Policy][
|
4431
|
+
# information, see [Specifying Permissions in a Policy][8]. If the
|
4297
4432
|
# object you request does not exist, the error Amazon S3 returns depends
|
4298
4433
|
# on whether you also have the `s3:ListBucket` permission.
|
4299
4434
|
#
|
@@ -4315,7 +4450,7 @@ module Aws::S3
|
|
4315
4450
|
#
|
4316
4451
|
# </note>
|
4317
4452
|
#
|
4318
|
-
# For more information about versioning, see PutBucketVersioning.
|
4453
|
+
# For more information about versioning, see [PutBucketVersioning][9].
|
4319
4454
|
#
|
4320
4455
|
# **Overriding Response Header Values**
|
4321
4456
|
#
|
@@ -4364,22 +4499,27 @@ module Aws::S3
|
|
4364
4499
|
# to `false`, and; `If-Modified-Since` condition evaluates to `true`;
|
4365
4500
|
# then, S3 returns 304 Not Modified response code.
|
4366
4501
|
#
|
4367
|
-
# For more information about conditional requests, see [RFC 7232][
|
4502
|
+
# For more information about conditional requests, see [RFC 7232][10].
|
4368
4503
|
#
|
4369
4504
|
# The following operations are related to `GetObject`\:
|
4370
4505
|
#
|
4371
|
-
# * ListBuckets
|
4506
|
+
# * [ListBuckets][11]
|
4372
4507
|
#
|
4373
|
-
# * GetObjectAcl
|
4508
|
+
# * [GetObjectAcl][3]
|
4374
4509
|
#
|
4375
4510
|
#
|
4376
4511
|
#
|
4377
4512
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
|
4378
4513
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3Torrent.html
|
4379
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4380
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4381
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
4382
|
-
# [6]: https://
|
4514
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
|
4515
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
|
4516
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
|
4517
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
4518
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
|
4519
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
4520
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketVersioning.html
|
4521
|
+
# [10]: https://tools.ietf.org/html/rfc7232
|
4522
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
|
4383
4523
|
#
|
4384
4524
|
# @option params [String, IO] :response_target
|
4385
4525
|
# Where to write response data, file path, or IO object.
|
@@ -4462,7 +4602,7 @@ module Aws::S3
|
|
4462
4602
|
# encrypting data. This value is used to store the object and then it is
|
4463
4603
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
4464
4604
|
# be appropriate for use with the algorithm specified in the
|
4465
|
-
# `x-amz-server-side
|
4605
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
4466
4606
|
#
|
4467
4607
|
# @option params [String] :sse_customer_key_md5
|
4468
4608
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -4677,11 +4817,17 @@ module Aws::S3
|
|
4677
4817
|
#
|
4678
4818
|
# The following operations are related to `GetObjectAcl`\:
|
4679
4819
|
#
|
4680
|
-
# * GetObject
|
4820
|
+
# * [GetObject][1]
|
4821
|
+
#
|
4822
|
+
# * [DeleteObject][2]
|
4823
|
+
#
|
4824
|
+
# * [PutObject][3]
|
4681
4825
|
#
|
4682
|
-
# * DeleteObject
|
4683
4826
|
#
|
4684
|
-
#
|
4827
|
+
#
|
4828
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
4829
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
4830
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
4685
4831
|
#
|
4686
4832
|
# @option params [required, String] :bucket
|
4687
4833
|
# The bucket name that contains the object for which to get the ACL
|
@@ -4998,13 +5144,14 @@ module Aws::S3
|
|
4998
5144
|
#
|
4999
5145
|
# The following operation is related to `GetObjectTagging`\:
|
5000
5146
|
#
|
5001
|
-
# * PutObjectTagging
|
5147
|
+
# * [PutObjectTagging][2]
|
5002
5148
|
#
|
5003
5149
|
# ^
|
5004
5150
|
#
|
5005
5151
|
#
|
5006
5152
|
#
|
5007
5153
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
5154
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html
|
5008
5155
|
#
|
5009
5156
|
# @option params [required, String] :bucket
|
5010
5157
|
# The bucket name containing the object for which to get the tagging
|
@@ -5117,13 +5264,14 @@ module Aws::S3
|
|
5117
5264
|
#
|
5118
5265
|
# The following operation is related to `GetObjectTorrent`\:
|
5119
5266
|
#
|
5120
|
-
# * GetObject
|
5267
|
+
# * [GetObject][2]
|
5121
5268
|
#
|
5122
5269
|
# ^
|
5123
5270
|
#
|
5124
5271
|
#
|
5125
5272
|
#
|
5126
5273
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3Torrent.html
|
5274
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
5127
5275
|
#
|
5128
5276
|
# @option params [String, IO] :response_target
|
5129
5277
|
# Where to write response data, file path, or IO object.
|
@@ -5207,17 +5355,20 @@ module Aws::S3
|
|
5207
5355
|
#
|
5208
5356
|
# * [Using Amazon S3 Block Public Access][3]
|
5209
5357
|
#
|
5210
|
-
# * PutPublicAccessBlock
|
5358
|
+
# * [PutPublicAccessBlock][4]
|
5211
5359
|
#
|
5212
|
-
# * GetPublicAccessBlock
|
5360
|
+
# * [GetPublicAccessBlock][5]
|
5213
5361
|
#
|
5214
|
-
# * DeletePublicAccessBlock
|
5362
|
+
# * [DeletePublicAccessBlock][6]
|
5215
5363
|
#
|
5216
5364
|
#
|
5217
5365
|
#
|
5218
5366
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
5219
5367
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
|
5220
5368
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
|
5369
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html
|
5370
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html
|
5371
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
|
5221
5372
|
#
|
5222
5373
|
# @option params [required, String] :bucket
|
5223
5374
|
# The name of the Amazon S3 bucket whose `PublicAccessBlock`
|
@@ -5316,11 +5467,11 @@ module Aws::S3
|
|
5316
5467
|
# Amazon S3, then when you retrieve the metadata from the object, you
|
5317
5468
|
# must use the following headers:
|
5318
5469
|
#
|
5319
|
-
# * x-amz-server-side
|
5470
|
+
# * x-amz-server-side-encryption-customer-algorithm
|
5320
5471
|
#
|
5321
|
-
# * x-amz-server-side
|
5472
|
+
# * x-amz-server-side-encryption-customer-key
|
5322
5473
|
#
|
5323
|
-
# * x-amz-server-side
|
5474
|
+
# * x-amz-server-side-encryption-customer-key-MD5
|
5324
5475
|
#
|
5325
5476
|
# For more information about SSE-C, see [Server-Side Encryption (Using
|
5326
5477
|
# Customer-Provided Encryption Keys)][1].
|
@@ -5374,7 +5525,7 @@ module Aws::S3
|
|
5374
5525
|
#
|
5375
5526
|
# The following operation is related to `HeadObject`\:
|
5376
5527
|
#
|
5377
|
-
# * GetObject
|
5528
|
+
# * [GetObject][5]
|
5378
5529
|
#
|
5379
5530
|
# ^
|
5380
5531
|
#
|
@@ -5384,6 +5535,7 @@ module Aws::S3
|
|
5384
5535
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html
|
5385
5536
|
# [3]: https://tools.ietf.org/html/rfc7232
|
5386
5537
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
5538
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
5387
5539
|
#
|
5388
5540
|
# @option params [required, String] :bucket
|
5389
5541
|
# The name of the bucket containing the object.
|
@@ -5429,7 +5581,7 @@ module Aws::S3
|
|
5429
5581
|
# encrypting data. This value is used to store the object and then it is
|
5430
5582
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
5431
5583
|
# be appropriate for use with the algorithm specified in the
|
5432
|
-
# `x-amz-server-side
|
5584
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
5433
5585
|
#
|
5434
5586
|
# @option params [String] :sse_customer_key_md5
|
5435
5587
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -5599,17 +5751,20 @@ module Aws::S3
|
|
5599
5751
|
# The following operations are related to
|
5600
5752
|
# `ListBucketAnalyticsConfigurations`\:
|
5601
5753
|
#
|
5602
|
-
# * GetBucketAnalyticsConfiguration
|
5754
|
+
# * [GetBucketAnalyticsConfiguration][4]
|
5603
5755
|
#
|
5604
|
-
# * DeleteBucketAnalyticsConfiguration
|
5756
|
+
# * [DeleteBucketAnalyticsConfiguration][5]
|
5605
5757
|
#
|
5606
|
-
# * PutBucketAnalyticsConfiguration
|
5758
|
+
# * [PutBucketAnalyticsConfiguration][6]
|
5607
5759
|
#
|
5608
5760
|
#
|
5609
5761
|
#
|
5610
5762
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
5611
5763
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
5612
5764
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
|
5765
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
|
5766
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
|
5767
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAnalyticsConfiguration.html
|
5613
5768
|
#
|
5614
5769
|
# @option params [required, String] :bucket
|
5615
5770
|
# The name of the bucket from which analytics configurations are
|
@@ -5687,17 +5842,20 @@ module Aws::S3
|
|
5687
5842
|
# The following operations are related to
|
5688
5843
|
# `ListBucketInventoryConfigurations`\:
|
5689
5844
|
#
|
5690
|
-
# * GetBucketInventoryConfiguration
|
5845
|
+
# * [GetBucketInventoryConfiguration][4]
|
5691
5846
|
#
|
5692
|
-
# * DeleteBucketInventoryConfiguration
|
5847
|
+
# * [DeleteBucketInventoryConfiguration][5]
|
5693
5848
|
#
|
5694
|
-
# * PutBucketInventoryConfiguration
|
5849
|
+
# * [PutBucketInventoryConfiguration][6]
|
5695
5850
|
#
|
5696
5851
|
#
|
5697
5852
|
#
|
5698
5853
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
5699
5854
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
5700
5855
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
|
5856
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
|
5857
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
|
5858
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html
|
5701
5859
|
#
|
5702
5860
|
# @option params [required, String] :bucket
|
5703
5861
|
# The name of the bucket containing the inventory configurations to
|
@@ -5778,17 +5936,20 @@ module Aws::S3
|
|
5778
5936
|
# The following operations are related to
|
5779
5937
|
# `ListBucketMetricsConfigurations`\:
|
5780
5938
|
#
|
5781
|
-
# * PutBucketMetricsConfiguration
|
5939
|
+
# * [PutBucketMetricsConfiguration][4]
|
5782
5940
|
#
|
5783
|
-
# * GetBucketMetricsConfiguration
|
5941
|
+
# * [GetBucketMetricsConfiguration][5]
|
5784
5942
|
#
|
5785
|
-
# * DeleteBucketMetricsConfiguration
|
5943
|
+
# * [DeleteBucketMetricsConfiguration][6]
|
5786
5944
|
#
|
5787
5945
|
#
|
5788
5946
|
#
|
5789
5947
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
5790
5948
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
5791
5949
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
|
5950
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
|
5951
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
|
5952
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
|
5792
5953
|
#
|
5793
5954
|
# @option params [required, String] :bucket
|
5794
5955
|
# The name of the bucket containing the metrics configurations to
|
@@ -5924,20 +6085,25 @@ module Aws::S3
|
|
5924
6085
|
#
|
5925
6086
|
# The following operations are related to `ListMultipartUploads`\:
|
5926
6087
|
#
|
5927
|
-
# * CreateMultipartUpload
|
6088
|
+
# * [CreateMultipartUpload][3]
|
5928
6089
|
#
|
5929
|
-
# * UploadPart
|
6090
|
+
# * [UploadPart][4]
|
5930
6091
|
#
|
5931
|
-
# * CompleteMultipartUpload
|
6092
|
+
# * [CompleteMultipartUpload][5]
|
5932
6093
|
#
|
5933
|
-
# * ListParts
|
6094
|
+
# * [ListParts][6]
|
5934
6095
|
#
|
5935
|
-
# * AbortMultipartUpload
|
6096
|
+
# * [AbortMultipartUpload][7]
|
5936
6097
|
#
|
5937
6098
|
#
|
5938
6099
|
#
|
5939
6100
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
5940
6101
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
6102
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
6103
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
6104
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
6105
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
6106
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
5941
6107
|
#
|
5942
6108
|
# @option params [required, String] :bucket
|
5943
6109
|
# Name of the bucket to which the multipart upload was initiated.
|
@@ -6022,97 +6188,97 @@ module Aws::S3
|
|
6022
6188
|
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
6023
6189
|
#
|
6024
6190
|
#
|
6025
|
-
# @example Example:
|
6191
|
+
# @example Example: To list in-progress multipart uploads on a bucket
|
6026
6192
|
#
|
6027
|
-
# # The following example
|
6028
|
-
# # setup of multipart uploads.
|
6193
|
+
# # The following example lists in-progress multipart uploads on a specific bucket.
|
6029
6194
|
#
|
6030
6195
|
# resp = client.list_multipart_uploads({
|
6031
6196
|
# bucket: "examplebucket",
|
6032
|
-
# key_marker: "nextkeyfrompreviousresponse",
|
6033
|
-
# max_uploads: 2,
|
6034
|
-
# upload_id_marker: "valuefrompreviousresponse",
|
6035
6197
|
# })
|
6036
6198
|
#
|
6037
6199
|
# resp.to_h outputs the following:
|
6038
6200
|
# {
|
6039
|
-
# bucket: "acl1",
|
6040
|
-
# is_truncated: true,
|
6041
|
-
# key_marker: "",
|
6042
|
-
# max_uploads: 2,
|
6043
|
-
# next_key_marker: "someobjectkey",
|
6044
|
-
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
6045
|
-
# upload_id_marker: "",
|
6046
6201
|
# uploads: [
|
6047
6202
|
# {
|
6048
6203
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
6049
6204
|
# initiator: {
|
6050
|
-
# display_name: "
|
6205
|
+
# display_name: "display-name",
|
6051
6206
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6052
6207
|
# },
|
6053
6208
|
# key: "JavaFile",
|
6054
6209
|
# owner: {
|
6055
|
-
# display_name: "
|
6056
|
-
# id: "
|
6210
|
+
# display_name: "display-name",
|
6211
|
+
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6057
6212
|
# },
|
6058
6213
|
# storage_class: "STANDARD",
|
6059
|
-
# upload_id: "
|
6214
|
+
# upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
6060
6215
|
# },
|
6061
6216
|
# {
|
6062
6217
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
6063
6218
|
# initiator: {
|
6064
|
-
# display_name: "
|
6219
|
+
# display_name: "display-name",
|
6065
6220
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6066
6221
|
# },
|
6067
6222
|
# key: "JavaFile",
|
6068
6223
|
# owner: {
|
6069
|
-
# display_name: "
|
6224
|
+
# display_name: "display-name",
|
6070
6225
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6071
6226
|
# },
|
6072
6227
|
# storage_class: "STANDARD",
|
6073
|
-
# upload_id: "
|
6228
|
+
# upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
6074
6229
|
# },
|
6075
6230
|
# ],
|
6076
6231
|
# }
|
6077
6232
|
#
|
6078
|
-
# @example Example:
|
6233
|
+
# @example Example: List next set of multipart uploads when previous result is truncated
|
6079
6234
|
#
|
6080
|
-
# # The following example
|
6235
|
+
# # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
|
6236
|
+
# # setup of multipart uploads.
|
6081
6237
|
#
|
6082
6238
|
# resp = client.list_multipart_uploads({
|
6083
6239
|
# bucket: "examplebucket",
|
6240
|
+
# key_marker: "nextkeyfrompreviousresponse",
|
6241
|
+
# max_uploads: 2,
|
6242
|
+
# upload_id_marker: "valuefrompreviousresponse",
|
6084
6243
|
# })
|
6085
6244
|
#
|
6086
6245
|
# resp.to_h outputs the following:
|
6087
6246
|
# {
|
6247
|
+
# bucket: "acl1",
|
6248
|
+
# is_truncated: true,
|
6249
|
+
# key_marker: "",
|
6250
|
+
# max_uploads: 2,
|
6251
|
+
# next_key_marker: "someobjectkey",
|
6252
|
+
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
6253
|
+
# upload_id_marker: "",
|
6088
6254
|
# uploads: [
|
6089
6255
|
# {
|
6090
6256
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
6091
6257
|
# initiator: {
|
6092
|
-
# display_name: "display-name",
|
6258
|
+
# display_name: "ownder-display-name",
|
6093
6259
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6094
6260
|
# },
|
6095
6261
|
# key: "JavaFile",
|
6096
6262
|
# owner: {
|
6097
|
-
# display_name: "
|
6098
|
-
# id: "
|
6263
|
+
# display_name: "mohanataws",
|
6264
|
+
# id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6099
6265
|
# },
|
6100
6266
|
# storage_class: "STANDARD",
|
6101
|
-
# upload_id: "
|
6267
|
+
# upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
6102
6268
|
# },
|
6103
6269
|
# {
|
6104
6270
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
6105
6271
|
# initiator: {
|
6106
|
-
# display_name: "display-name",
|
6272
|
+
# display_name: "ownder-display-name",
|
6107
6273
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6108
6274
|
# },
|
6109
6275
|
# key: "JavaFile",
|
6110
6276
|
# owner: {
|
6111
|
-
# display_name: "display-name",
|
6277
|
+
# display_name: "ownder-display-name",
|
6112
6278
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6113
6279
|
# },
|
6114
6280
|
# storage_class: "STANDARD",
|
6115
|
-
# upload_id: "
|
6281
|
+
# upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
6116
6282
|
# },
|
6117
6283
|
# ],
|
6118
6284
|
# }
|
@@ -6176,13 +6342,20 @@ module Aws::S3
|
|
6176
6342
|
#
|
6177
6343
|
# The following operations are related to `ListObjectVersions`\:
|
6178
6344
|
#
|
6179
|
-
# * ListObjectsV2
|
6345
|
+
# * [ListObjectsV2][1]
|
6346
|
+
#
|
6347
|
+
# * [GetObject][2]
|
6348
|
+
#
|
6349
|
+
# * [PutObject][3]
|
6350
|
+
#
|
6351
|
+
# * [DeleteObject][4]
|
6180
6352
|
#
|
6181
|
-
# * GetObject
|
6182
6353
|
#
|
6183
|
-
# * PutObject
|
6184
6354
|
#
|
6185
|
-
#
|
6355
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html
|
6356
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
6357
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
6358
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
6186
6359
|
#
|
6187
6360
|
# @option params [required, String] :bucket
|
6188
6361
|
# The bucket name that contains the objects.
|
@@ -6359,20 +6532,28 @@ module Aws::S3
|
|
6359
6532
|
# of the response and handle it appropriately.
|
6360
6533
|
#
|
6361
6534
|
# This API has been revised. We recommend that you use the newer
|
6362
|
-
# version, ListObjectsV2, when developing applications. For
|
6363
|
-
# compatibility, Amazon S3 continues to support `ListObjects`.
|
6535
|
+
# version, [ListObjectsV2][1], when developing applications. For
|
6536
|
+
# backward compatibility, Amazon S3 continues to support `ListObjects`.
|
6364
6537
|
#
|
6365
6538
|
# The following operations are related to `ListObjects`\:
|
6366
6539
|
#
|
6367
|
-
# * ListObjectsV2
|
6540
|
+
# * [ListObjectsV2][1]
|
6368
6541
|
#
|
6369
|
-
# * GetObject
|
6542
|
+
# * [GetObject][2]
|
6370
6543
|
#
|
6371
|
-
# * PutObject
|
6544
|
+
# * [PutObject][3]
|
6372
6545
|
#
|
6373
|
-
# * CreateBucket
|
6546
|
+
# * [CreateBucket][4]
|
6374
6547
|
#
|
6375
|
-
# * ListBuckets
|
6548
|
+
# * [ListBuckets][5]
|
6549
|
+
#
|
6550
|
+
#
|
6551
|
+
#
|
6552
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html
|
6553
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
6554
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
6555
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
6556
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
|
6376
6557
|
#
|
6377
6558
|
# @option params [required, String] :bucket
|
6378
6559
|
# The name of the bucket containing the objects.
|
@@ -6518,22 +6699,27 @@ module Aws::S3
|
|
6518
6699
|
# This section describes the latest revision of the API. We recommend
|
6519
6700
|
# that you use this revised API for application development. For
|
6520
6701
|
# backward compatibility, Amazon S3 continues to support the prior
|
6521
|
-
# version of this API, ListObjects.
|
6702
|
+
# version of this API, [ListObjects][3].
|
6522
6703
|
#
|
6523
|
-
# To get a list of your buckets, see ListBuckets.
|
6704
|
+
# To get a list of your buckets, see [ListBuckets][4].
|
6524
6705
|
#
|
6525
6706
|
# The following operations are related to `ListObjectsV2`\:
|
6526
6707
|
#
|
6527
|
-
# * GetObject
|
6708
|
+
# * [GetObject][5]
|
6528
6709
|
#
|
6529
|
-
# * PutObject
|
6710
|
+
# * [PutObject][6]
|
6530
6711
|
#
|
6531
|
-
# * CreateBucket
|
6712
|
+
# * [CreateBucket][7]
|
6532
6713
|
#
|
6533
6714
|
#
|
6534
6715
|
#
|
6535
6716
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
6536
6717
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
6718
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
|
6719
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
|
6720
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
6721
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
6722
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
6537
6723
|
#
|
6538
6724
|
# @option params [required, String] :bucket
|
6539
6725
|
# Bucket name to list.
|
@@ -6687,7 +6873,7 @@ module Aws::S3
|
|
6687
6873
|
# Lists the parts that have been uploaded for a specific multipart
|
6688
6874
|
# upload. This operation must include the upload ID, which you obtain by
|
6689
6875
|
# sending the initiate multipart upload request (see
|
6690
|
-
# CreateMultipartUpload). This request returns a maximum of 1,000
|
6876
|
+
# [CreateMultipartUpload][1]). This request returns a maximum of 1,000
|
6691
6877
|
# uploaded parts. The default number of parts returned is 1,000 parts.
|
6692
6878
|
# You can restrict the number of parts returned by specifying the
|
6693
6879
|
# `max-parts` request parameter. If your multipart upload consists of
|
@@ -6698,27 +6884,32 @@ module Aws::S3
|
|
6698
6884
|
# field value from the previous response.
|
6699
6885
|
#
|
6700
6886
|
# For more information on multipart uploads, see [Uploading Objects
|
6701
|
-
# Using Multipart Upload][
|
6887
|
+
# Using Multipart Upload][2].
|
6702
6888
|
#
|
6703
6889
|
# For information on permissions required to use the multipart upload
|
6704
|
-
# API, see [Multipart Upload API and Permissions][
|
6890
|
+
# API, see [Multipart Upload API and Permissions][3].
|
6705
6891
|
#
|
6706
6892
|
# The following operations are related to `ListParts`\:
|
6707
6893
|
#
|
6708
|
-
# * CreateMultipartUpload
|
6894
|
+
# * [CreateMultipartUpload][1]
|
6709
6895
|
#
|
6710
|
-
# * UploadPart
|
6896
|
+
# * [UploadPart][4]
|
6711
6897
|
#
|
6712
|
-
# * CompleteMultipartUpload
|
6898
|
+
# * [CompleteMultipartUpload][5]
|
6713
6899
|
#
|
6714
|
-
# * AbortMultipartUpload
|
6900
|
+
# * [AbortMultipartUpload][6]
|
6715
6901
|
#
|
6716
|
-
# * ListMultipartUploads
|
6902
|
+
# * [ListMultipartUploads][7]
|
6717
6903
|
#
|
6718
6904
|
#
|
6719
6905
|
#
|
6720
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
6721
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
6906
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
6907
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
6908
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
6909
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
6910
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
6911
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
6912
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
6722
6913
|
#
|
6723
6914
|
# @option params [required, String] :bucket
|
6724
6915
|
# Name of the bucket to which the parts are being uploaded.
|
@@ -6878,8 +7069,8 @@ module Aws::S3
|
|
6878
7069
|
#
|
6879
7070
|
# * Suspended – Disables accelerated data transfers to the bucket.
|
6880
7071
|
#
|
6881
|
-
# The GetBucketAccelerateConfiguration operation returns the
|
6882
|
-
# acceleration state of a bucket.
|
7072
|
+
# The [GetBucketAccelerateConfiguration][3] operation returns the
|
7073
|
+
# transfer acceleration state of a bucket.
|
6883
7074
|
#
|
6884
7075
|
# After setting the Transfer Acceleration state of a bucket to Enabled,
|
6885
7076
|
# it might take up to thirty minutes before the data transfer rates to
|
@@ -6889,20 +7080,22 @@ module Aws::S3
|
|
6889
7080
|
# DNS-compliant and must not contain periods (".").
|
6890
7081
|
#
|
6891
7082
|
# For more information about transfer acceleration, see [Transfer
|
6892
|
-
# Acceleration][
|
7083
|
+
# Acceleration][4].
|
6893
7084
|
#
|
6894
7085
|
# The following operations are related to
|
6895
7086
|
# `PutBucketAccelerateConfiguration`\:
|
6896
7087
|
#
|
6897
|
-
# * GetBucketAccelerateConfiguration
|
7088
|
+
# * [GetBucketAccelerateConfiguration][3]
|
6898
7089
|
#
|
6899
|
-
# * CreateBucket
|
7090
|
+
# * [CreateBucket][5]
|
6900
7091
|
#
|
6901
7092
|
#
|
6902
7093
|
#
|
6903
7094
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
6904
7095
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
6905
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7096
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html
|
7097
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
|
7098
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
6906
7099
|
#
|
6907
7100
|
# @option params [required, String] :bucket
|
6908
7101
|
# Name of the bucket for which the accelerate configuration is set.
|
@@ -7071,11 +7264,11 @@ module Aws::S3
|
|
7071
7264
|
#
|
7072
7265
|
# **Related Resources**
|
7073
7266
|
#
|
7074
|
-
# * CreateBucket
|
7267
|
+
# * [CreateBucket][5]
|
7075
7268
|
#
|
7076
|
-
# * DeleteBucket
|
7269
|
+
# * [DeleteBucket][6]
|
7077
7270
|
#
|
7078
|
-
# * GetObjectAcl
|
7271
|
+
# * [GetObjectAcl][7]
|
7079
7272
|
#
|
7080
7273
|
#
|
7081
7274
|
#
|
@@ -7083,6 +7276,9 @@ module Aws::S3
|
|
7083
7276
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
7084
7277
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
7085
7278
|
# [4]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
7279
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
7280
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
7281
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
|
7086
7282
|
#
|
7087
7283
|
# @option params [String] :acl
|
7088
7284
|
# The canned ACL to apply to the bucket.
|
@@ -7227,9 +7423,11 @@ module Aws::S3
|
|
7227
7423
|
#
|
7228
7424
|
# **Related Resources**
|
7229
7425
|
#
|
7230
|
-
# *
|
7231
|
-
#
|
7232
|
-
# *
|
7426
|
+
# * [GetBucketAnalyticsConfiguration][5]
|
7427
|
+
#
|
7428
|
+
# * [DeleteBucketAnalyticsConfiguration][6]
|
7429
|
+
#
|
7430
|
+
# * [ListBucketAnalyticsConfigurations][7]
|
7233
7431
|
#
|
7234
7432
|
#
|
7235
7433
|
#
|
@@ -7237,6 +7435,9 @@ module Aws::S3
|
|
7237
7435
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
|
7238
7436
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
7239
7437
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
7438
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
|
7439
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
|
7440
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
|
7240
7441
|
#
|
7241
7442
|
# @option params [required, String] :bucket
|
7242
7443
|
# The name of the bucket to which an analytics configuration is stored.
|
@@ -7337,15 +7538,18 @@ module Aws::S3
|
|
7337
7538
|
#
|
7338
7539
|
# **Related Resources**
|
7339
7540
|
#
|
7340
|
-
# * GetBucketCors
|
7541
|
+
# * [GetBucketCors][2]
|
7341
7542
|
#
|
7342
|
-
# * DeleteBucketCors
|
7543
|
+
# * [DeleteBucketCors][3]
|
7343
7544
|
#
|
7344
|
-
# * RESTOPTIONSobject
|
7545
|
+
# * [RESTOPTIONSobject][4]
|
7345
7546
|
#
|
7346
7547
|
#
|
7347
7548
|
#
|
7348
7549
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
7550
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html
|
7551
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html
|
7552
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTOPTIONSobject.html
|
7349
7553
|
#
|
7350
7554
|
# @option params [required, String] :bucket
|
7351
7555
|
# Specifies the bucket impacted by the `cors`configuration.
|
@@ -7465,15 +7669,17 @@ module Aws::S3
|
|
7465
7669
|
#
|
7466
7670
|
# **Related Resources**
|
7467
7671
|
#
|
7468
|
-
# * GetBucketEncryption
|
7672
|
+
# * [GetBucketEncryption][4]
|
7469
7673
|
#
|
7470
|
-
# * DeleteBucketEncryption
|
7674
|
+
# * [DeleteBucketEncryption][5]
|
7471
7675
|
#
|
7472
7676
|
#
|
7473
7677
|
#
|
7474
7678
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
7475
7679
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
7476
7680
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
7681
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
7682
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
7477
7683
|
#
|
7478
7684
|
# @option params [required, String] :bucket
|
7479
7685
|
# Specifies default encryption for a bucket using server-side encryption
|
@@ -7579,11 +7785,11 @@ module Aws::S3
|
|
7579
7785
|
#
|
7580
7786
|
# **Related Resources**
|
7581
7787
|
#
|
7582
|
-
# * GetBucketInventoryConfiguration
|
7788
|
+
# * [GetBucketInventoryConfiguration][5]
|
7583
7789
|
#
|
7584
|
-
# * DeleteBucketInventoryConfiguration
|
7790
|
+
# * [DeleteBucketInventoryConfiguration][6]
|
7585
7791
|
#
|
7586
|
-
# * ListBucketInventoryConfigurations
|
7792
|
+
# * [ListBucketInventoryConfigurations][7]
|
7587
7793
|
#
|
7588
7794
|
#
|
7589
7795
|
#
|
@@ -7591,6 +7797,9 @@ module Aws::S3
|
|
7591
7797
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
|
7592
7798
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
7593
7799
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
7800
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
|
7801
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
|
7802
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
|
7594
7803
|
#
|
7595
7804
|
# @option params [required, String] :bucket
|
7596
7805
|
# The name of the bucket where the inventory configuration will be
|
@@ -7648,13 +7857,13 @@ module Aws::S3
|
|
7648
7857
|
end
|
7649
7858
|
|
7650
7859
|
# For an updated version of this API, see
|
7651
|
-
# PutBucketLifecycleConfiguration. This version has been
|
7652
|
-
# Existing lifecycle configurations will work. For new
|
7653
|
-
# configurations, use the updated API.
|
7860
|
+
# [PutBucketLifecycleConfiguration][1]. This version has been
|
7861
|
+
# deprecated. Existing lifecycle configurations will work. For new
|
7862
|
+
# lifecycle configurations, use the updated API.
|
7654
7863
|
#
|
7655
7864
|
# Creates a new lifecycle configuration for the bucket or replaces an
|
7656
7865
|
# existing lifecycle configuration. For information about lifecycle
|
7657
|
-
# configuration, see [Object Lifecycle Management][
|
7866
|
+
# configuration, see [Object Lifecycle Management][2] in the *Amazon
|
7658
7867
|
# Simple Storage Service Developer Guide*.
|
7659
7868
|
#
|
7660
7869
|
# By default, all Amazon S3 resources, including buckets, objects, and
|
@@ -7677,36 +7886,41 @@ module Aws::S3
|
|
7677
7886
|
# * `s3:PutLifecycleConfiguration`
|
7678
7887
|
#
|
7679
7888
|
# For more information about permissions, see [Managing Access
|
7680
|
-
# Permissions to your Amazon S3 Resources][
|
7889
|
+
# Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
|
7681
7890
|
# Storage Service Developer Guide*.
|
7682
7891
|
#
|
7683
7892
|
# For more examples of transitioning objects to storage classes such as
|
7684
7893
|
# STANDARD\_IA or ONEZONE\_IA, see [Examples of Lifecycle
|
7685
|
-
# Configuration][
|
7894
|
+
# Configuration][4].
|
7686
7895
|
#
|
7687
7896
|
# **Related Resources**
|
7688
7897
|
#
|
7689
|
-
# * GetBucketLifecycle(Deprecated)
|
7898
|
+
# * [GetBucketLifecycle][5](Deprecated)
|
7899
|
+
#
|
7900
|
+
# * [GetBucketLifecycleConfiguration][6]
|
7690
7901
|
#
|
7691
|
-
# *
|
7902
|
+
# * [RestoreObject][7]
|
7692
7903
|
#
|
7693
|
-
# *
|
7694
7904
|
# * By default, a resource owner—in this case, a bucket owner, which is
|
7695
7905
|
# the AWS account that created the bucket—can perform any of the
|
7696
7906
|
# operations. A resource owner can also grant others permission to
|
7697
7907
|
# perform the operation. For more information, see the following
|
7698
7908
|
# topics in the Amazon Simple Storage Service Developer Guide:
|
7699
7909
|
#
|
7700
|
-
# * [Specifying Permissions in a Policy][
|
7910
|
+
# * [Specifying Permissions in a Policy][8]
|
7701
7911
|
#
|
7702
|
-
# * [Managing Access Permissions to your Amazon S3 Resources][
|
7912
|
+
# * [Managing Access Permissions to your Amazon S3 Resources][3]
|
7703
7913
|
#
|
7704
7914
|
#
|
7705
7915
|
#
|
7706
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7707
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
7708
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
7709
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
7916
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
7917
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
7918
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
7919
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#lifecycle-configuration-examples
|
7920
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
|
7921
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
7922
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
|
7923
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
7710
7924
|
#
|
7711
7925
|
# @option params [required, String] :bucket
|
7712
7926
|
#
|
@@ -7772,7 +7986,7 @@ module Aws::S3
|
|
7772
7986
|
# API. The previous version of the API supported filtering based only on
|
7773
7987
|
# an object key name prefix, which is supported for backward
|
7774
7988
|
# compatibility. For the related API description, see
|
7775
|
-
# PutBucketLifecycle.
|
7989
|
+
# [PutBucketLifecycle][2].
|
7776
7990
|
#
|
7777
7991
|
# </note>
|
7778
7992
|
#
|
@@ -7796,8 +8010,8 @@ module Aws::S3
|
|
7796
8010
|
# S3 provides predefined actions that you can specify for current and
|
7797
8011
|
# noncurrent object versions.
|
7798
8012
|
#
|
7799
|
-
# For more information, see [Object Lifecycle Management][
|
7800
|
-
# [Lifecycle Configuration Elements][
|
8013
|
+
# For more information, see [Object Lifecycle Management][3] and
|
8014
|
+
# [Lifecycle Configuration Elements][4].
|
7801
8015
|
#
|
7802
8016
|
# **Permissions**
|
7803
8017
|
#
|
@@ -7825,18 +8039,21 @@ module Aws::S3
|
|
7825
8039
|
#
|
7826
8040
|
# The following are related to `PutBucketLifecycleConfiguration`\:
|
7827
8041
|
#
|
7828
|
-
# * [Examples of Lifecycle Configuration][
|
8042
|
+
# * [Examples of Lifecycle Configuration][5]
|
7829
8043
|
#
|
7830
|
-
# * GetBucketLifecycleConfiguration
|
8044
|
+
# * [GetBucketLifecycleConfiguration][6]
|
7831
8045
|
#
|
7832
|
-
# * DeleteBucketLifecycle
|
8046
|
+
# * [DeleteBucketLifecycle][7]
|
7833
8047
|
#
|
7834
8048
|
#
|
7835
8049
|
#
|
7836
8050
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
7837
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7838
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
7839
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-
|
8051
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
|
8052
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
8053
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
|
8054
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-configuration-examples.html
|
8055
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
8056
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
7840
8057
|
#
|
7841
8058
|
# @option params [required, String] :bucket
|
7842
8059
|
# The name of the bucket for which to set the configuration.
|
@@ -7985,23 +8202,27 @@ module Aws::S3
|
|
7985
8202
|
# For more information about server access logging, see [Server Access
|
7986
8203
|
# Logging][1].
|
7987
8204
|
#
|
7988
|
-
# For more information about creating a bucket, see CreateBucket.
|
7989
|
-
# more information about returning the logging status of a bucket,
|
7990
|
-
# GetBucketLogging.
|
8205
|
+
# For more information about creating a bucket, see [CreateBucket][2].
|
8206
|
+
# For more information about returning the logging status of a bucket,
|
8207
|
+
# see [GetBucketLogging][3].
|
7991
8208
|
#
|
7992
8209
|
# The following operations are related to `PutBucketLogging`\:
|
7993
8210
|
#
|
7994
|
-
# * PutObject
|
8211
|
+
# * [PutObject][4]
|
7995
8212
|
#
|
7996
|
-
# * DeleteBucket
|
8213
|
+
# * [DeleteBucket][5]
|
7997
8214
|
#
|
7998
|
-
# * CreateBucket
|
8215
|
+
# * [CreateBucket][2]
|
7999
8216
|
#
|
8000
|
-
# * GetBucketLogging
|
8217
|
+
# * [GetBucketLogging][3]
|
8001
8218
|
#
|
8002
8219
|
#
|
8003
8220
|
#
|
8004
8221
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerLogs.html
|
8222
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
8223
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html
|
8224
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
8225
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
8005
8226
|
#
|
8006
8227
|
# @option params [required, String] :bucket
|
8007
8228
|
# The name of the bucket for which to set the logging parameters.
|
@@ -8093,11 +8314,11 @@ module Aws::S3
|
|
8093
8314
|
# The following operations are related to
|
8094
8315
|
# `PutBucketMetricsConfiguration`\:
|
8095
8316
|
#
|
8096
|
-
# * DeleteBucketMetricsConfiguration
|
8317
|
+
# * [DeleteBucketMetricsConfiguration][4]
|
8097
8318
|
#
|
8098
|
-
# * PutBucketMetricsConfiguration
|
8319
|
+
# * [PutBucketMetricsConfiguration][5]
|
8099
8320
|
#
|
8100
|
-
# * ListBucketMetricsConfigurations
|
8321
|
+
# * [ListBucketMetricsConfigurations][6]
|
8101
8322
|
#
|
8102
8323
|
# `GetBucketLifecycle` has the following special error:
|
8103
8324
|
#
|
@@ -8113,6 +8334,9 @@ module Aws::S3
|
|
8113
8334
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
8114
8335
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
8115
8336
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
|
8337
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
|
8338
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
|
8339
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
|
8116
8340
|
#
|
8117
8341
|
# @option params [required, String] :bucket
|
8118
8342
|
# The name of the bucket for which the metrics configuration is set.
|
@@ -8160,7 +8384,12 @@ module Aws::S3
|
|
8160
8384
|
req.send_request(options)
|
8161
8385
|
end
|
8162
8386
|
|
8163
|
-
# No longer used, see the PutBucketNotificationConfiguration
|
8387
|
+
# No longer used, see the [PutBucketNotificationConfiguration][1]
|
8388
|
+
# operation.
|
8389
|
+
#
|
8390
|
+
#
|
8391
|
+
#
|
8392
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html
|
8164
8393
|
#
|
8165
8394
|
# @option params [required, String] :bucket
|
8166
8395
|
# The name of the bucket.
|
@@ -8268,13 +8497,14 @@ module Aws::S3
|
|
8268
8497
|
# The following operation is related to
|
8269
8498
|
# `PutBucketNotificationConfiguration`\:
|
8270
8499
|
#
|
8271
|
-
# * GetBucketNotificationConfiguration
|
8500
|
+
# * [GetBucketNotificationConfiguration][2]
|
8272
8501
|
#
|
8273
8502
|
# ^
|
8274
8503
|
#
|
8275
8504
|
#
|
8276
8505
|
#
|
8277
8506
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
8507
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html
|
8278
8508
|
#
|
8279
8509
|
# @option params [required, String] :bucket
|
8280
8510
|
# The name of the bucket.
|
@@ -8393,13 +8623,15 @@ module Aws::S3
|
|
8393
8623
|
#
|
8394
8624
|
# The following operations are related to `PutBucketPolicy`\:
|
8395
8625
|
#
|
8396
|
-
# * CreateBucket
|
8626
|
+
# * [CreateBucket][2]
|
8397
8627
|
#
|
8398
|
-
# * DeleteBucket
|
8628
|
+
# * [DeleteBucket][3]
|
8399
8629
|
#
|
8400
8630
|
#
|
8401
8631
|
#
|
8402
8632
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
8633
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
8634
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
8403
8635
|
#
|
8404
8636
|
# @option params [required, String] :bucket
|
8405
8637
|
# The name of the bucket.
|
@@ -8472,6 +8704,17 @@ module Aws::S3
|
|
8472
8704
|
# configuration, you must also add the following elements:
|
8473
8705
|
# `DeleteMarkerReplication`, `Status`, and `Priority`.
|
8474
8706
|
#
|
8707
|
+
# <note markdown="1"> The latest version of the replication configuration XML is V2. XML V2
|
8708
|
+
# replication configurations are those that contain the `Filter` element
|
8709
|
+
# for rules, and rules that specify S3 Replication Time Control (S3
|
8710
|
+
# RTC). In XML V2 replication configurations, Amazon S3 doesn't
|
8711
|
+
# replicate delete markers. Therefore, you must set the
|
8712
|
+
# `DeleteMarkerReplication` element to `Disabled`. For backward
|
8713
|
+
# compatibility, Amazon S3 continues to support the XML V1 replication
|
8714
|
+
# configuration.
|
8715
|
+
#
|
8716
|
+
# </note>
|
8717
|
+
#
|
8475
8718
|
# For information about enabling versioning on a bucket, see [Using
|
8476
8719
|
# Versioning][3].
|
8477
8720
|
#
|
@@ -8492,14 +8735,14 @@ module Aws::S3
|
|
8492
8735
|
# about replication configuration, see [Replicating Objects Created with
|
8493
8736
|
# SSE Using CMKs stored in AWS KMS][6].
|
8494
8737
|
#
|
8495
|
-
# For information on `PutBucketReplication` errors, see
|
8496
|
-
#
|
8738
|
+
# For information on `PutBucketReplication` errors, see [List of
|
8739
|
+
# replication-related error codes][7]
|
8497
8740
|
#
|
8498
8741
|
# The following operations are related to `PutBucketReplication`\:
|
8499
8742
|
#
|
8500
|
-
# * GetBucketReplication
|
8743
|
+
# * [GetBucketReplication][8]
|
8501
8744
|
#
|
8502
|
-
# * DeleteBucketReplication
|
8745
|
+
# * [DeleteBucketReplication][9]
|
8503
8746
|
#
|
8504
8747
|
#
|
8505
8748
|
#
|
@@ -8509,6 +8752,9 @@ module Aws::S3
|
|
8509
8752
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
8510
8753
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
8511
8754
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html
|
8755
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList
|
8756
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
|
8757
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html
|
8512
8758
|
#
|
8513
8759
|
# @option params [required, String] :bucket
|
8514
8760
|
# The name of the bucket
|
@@ -8638,13 +8884,15 @@ module Aws::S3
|
|
8638
8884
|
#
|
8639
8885
|
# The following operations are related to `PutBucketRequestPayment`\:
|
8640
8886
|
#
|
8641
|
-
# * CreateBucket
|
8887
|
+
# * [CreateBucket][2]
|
8642
8888
|
#
|
8643
|
-
# * GetBucketRequestPayment
|
8889
|
+
# * [GetBucketRequestPayment][3]
|
8644
8890
|
#
|
8645
8891
|
#
|
8646
8892
|
#
|
8647
8893
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
|
8894
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
8895
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketRequestPayment.html
|
8648
8896
|
#
|
8649
8897
|
# @option params [required, String] :bucket
|
8650
8898
|
# The bucket name.
|
@@ -8752,9 +9000,9 @@ module Aws::S3
|
|
8752
9000
|
#
|
8753
9001
|
# The following operations are related to `PutBucketTagging`\:
|
8754
9002
|
#
|
8755
|
-
# * GetBucketTagging
|
9003
|
+
# * [GetBucketTagging][7]
|
8756
9004
|
#
|
8757
|
-
# * DeleteBucketTagging
|
9005
|
+
# * [DeleteBucketTagging][8]
|
8758
9006
|
#
|
8759
9007
|
#
|
8760
9008
|
#
|
@@ -8764,6 +9012,8 @@ module Aws::S3
|
|
8764
9012
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
8765
9013
|
# [5]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
|
8766
9014
|
# [6]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tag-restrictions.html
|
9015
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
|
9016
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
8767
9017
|
#
|
8768
9018
|
# @option params [required, String] :bucket
|
8769
9019
|
# The bucket name.
|
@@ -8839,7 +9089,7 @@ module Aws::S3
|
|
8839
9089
|
# objects added to the bucket receive the version ID null.
|
8840
9090
|
#
|
8841
9091
|
# If the versioning state has never been set on a bucket, it has no
|
8842
|
-
# versioning state; a GetBucketVersioning request does not return a
|
9092
|
+
# versioning state; a [GetBucketVersioning][1] request does not return a
|
8843
9093
|
# versioning state value.
|
8844
9094
|
#
|
8845
9095
|
# If the bucket owner enables MFA Delete in the bucket versioning
|
@@ -8854,19 +9104,22 @@ module Aws::S3
|
|
8854
9104
|
# manage the deletes of the noncurrent object versions in the
|
8855
9105
|
# version-enabled bucket. (A version-enabled bucket maintains one
|
8856
9106
|
# current and zero or more noncurrent object versions.) For more
|
8857
|
-
# information, see [Lifecycle and Versioning][
|
9107
|
+
# information, see [Lifecycle and Versioning][2].
|
8858
9108
|
#
|
8859
9109
|
# **Related Resources**
|
8860
9110
|
#
|
8861
|
-
# * CreateBucket
|
9111
|
+
# * [CreateBucket][3]
|
8862
9112
|
#
|
8863
|
-
# * DeleteBucket
|
9113
|
+
# * [DeleteBucket][4]
|
8864
9114
|
#
|
8865
|
-
# * GetBucketVersioning
|
9115
|
+
# * [GetBucketVersioning][1]
|
8866
9116
|
#
|
8867
9117
|
#
|
8868
9118
|
#
|
8869
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
9119
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
9120
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html#lifecycle-and-other-bucket-config
|
9121
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
9122
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
8870
9123
|
#
|
8871
9124
|
# @option params [required, String] :bucket
|
8872
9125
|
# The bucket name.
|
@@ -9139,13 +9392,13 @@ module Aws::S3
|
|
9139
9392
|
#
|
9140
9393
|
# For more information about versioning, see [Adding Objects to
|
9141
9394
|
# Versioning Enabled Buckets][6]. For information about returning the
|
9142
|
-
# versioning state of a bucket, see GetBucketVersioning.
|
9395
|
+
# versioning state of a bucket, see [GetBucketVersioning][7].
|
9143
9396
|
#
|
9144
9397
|
# **Related Resources**
|
9145
9398
|
#
|
9146
|
-
# * CopyObject
|
9399
|
+
# * [CopyObject][8]
|
9147
9400
|
#
|
9148
|
-
# * DeleteObject
|
9401
|
+
# * [DeleteObject][9]
|
9149
9402
|
#
|
9150
9403
|
#
|
9151
9404
|
#
|
@@ -9155,6 +9408,9 @@ module Aws::S3
|
|
9155
9408
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html
|
9156
9409
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
9157
9410
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
|
9411
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
9412
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
9413
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
9158
9414
|
#
|
9159
9415
|
# @option params [String] :acl
|
9160
9416
|
# The canned ACL to apply to the object. For more information, see
|
@@ -9164,7 +9420,7 @@ module Aws::S3
|
|
9164
9420
|
#
|
9165
9421
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
9166
9422
|
#
|
9167
|
-
# @option params [String,
|
9423
|
+
# @option params [String, StringIO, File] :body
|
9168
9424
|
# Object data.
|
9169
9425
|
#
|
9170
9426
|
# @option params [required, String] :bucket
|
@@ -9315,7 +9571,7 @@ module Aws::S3
|
|
9315
9571
|
# encrypting data. This value is used to store the object and then it is
|
9316
9572
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
9317
9573
|
# be appropriate for use with the algorithm specified in the
|
9318
|
-
# `x-amz-server-side
|
9574
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
9319
9575
|
#
|
9320
9576
|
# @option params [String] :sse_customer_key_md5
|
9321
9577
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -9382,134 +9638,134 @@ module Aws::S3
|
|
9382
9638
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
9383
9639
|
#
|
9384
9640
|
#
|
9385
|
-
# @example Example: To upload
|
9641
|
+
# @example Example: To upload object and specify user-defined metadata
|
9386
9642
|
#
|
9387
|
-
# # The following example
|
9388
|
-
# #
|
9643
|
+
# # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
|
9644
|
+
# # enabled, S3 returns version ID in response.
|
9389
9645
|
#
|
9390
9646
|
# resp = client.put_object({
|
9391
9647
|
# body: "filetoupload",
|
9392
9648
|
# bucket: "examplebucket",
|
9393
9649
|
# key: "exampleobject",
|
9394
|
-
#
|
9395
|
-
#
|
9650
|
+
# metadata: {
|
9651
|
+
# "metadata1" => "value1",
|
9652
|
+
# "metadata2" => "value2",
|
9653
|
+
# },
|
9396
9654
|
# })
|
9397
9655
|
#
|
9398
9656
|
# resp.to_h outputs the following:
|
9399
9657
|
# {
|
9400
9658
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9401
|
-
#
|
9402
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
9659
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
9403
9660
|
# }
|
9404
9661
|
#
|
9405
|
-
# @example Example: To
|
9662
|
+
# @example Example: To upload an object and specify canned ACL.
|
9406
9663
|
#
|
9407
|
-
# # The following example
|
9664
|
+
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
9665
|
+
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
9408
9666
|
#
|
9409
9667
|
# resp = client.put_object({
|
9668
|
+
# acl: "authenticated-read",
|
9410
9669
|
# body: "filetoupload",
|
9411
9670
|
# bucket: "examplebucket",
|
9412
|
-
# key: "
|
9671
|
+
# key: "exampleobject",
|
9413
9672
|
# })
|
9414
9673
|
#
|
9415
9674
|
# resp.to_h outputs the following:
|
9416
9675
|
# {
|
9417
9676
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9418
|
-
# version_id: "
|
9677
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
9419
9678
|
# }
|
9420
9679
|
#
|
9421
|
-
# @example Example: To
|
9680
|
+
# @example Example: To create an object.
|
9422
9681
|
#
|
9423
|
-
# # The following example
|
9424
|
-
# # S3 returns version ID of the newly created object.
|
9682
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
9425
9683
|
#
|
9426
9684
|
# resp = client.put_object({
|
9427
|
-
# body: "
|
9685
|
+
# body: "filetoupload",
|
9428
9686
|
# bucket: "examplebucket",
|
9429
|
-
# key: "
|
9430
|
-
# tagging: "key1=value1&key2=value2",
|
9687
|
+
# key: "objectkey",
|
9431
9688
|
# })
|
9432
9689
|
#
|
9433
9690
|
# resp.to_h outputs the following:
|
9434
9691
|
# {
|
9435
9692
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9436
|
-
# version_id: "
|
9693
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
9437
9694
|
# }
|
9438
9695
|
#
|
9439
|
-
# @example Example: To upload an object
|
9696
|
+
# @example Example: To upload an object
|
9440
9697
|
#
|
9441
|
-
# # The following example uploads an object
|
9442
|
-
# #
|
9698
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
9699
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
9443
9700
|
#
|
9444
9701
|
# resp = client.put_object({
|
9445
9702
|
# body: "HappyFace.jpg",
|
9446
9703
|
# bucket: "examplebucket",
|
9447
9704
|
# key: "HappyFace.jpg",
|
9448
|
-
# server_side_encryption: "AES256",
|
9449
|
-
# storage_class: "STANDARD_IA",
|
9450
9705
|
# })
|
9451
9706
|
#
|
9452
9707
|
# resp.to_h outputs the following:
|
9453
9708
|
# {
|
9454
9709
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9455
|
-
#
|
9456
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
9710
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
9457
9711
|
# }
|
9458
9712
|
#
|
9459
|
-
# @example Example: To upload object and specify
|
9713
|
+
# @example Example: To upload an object and specify optional tags
|
9460
9714
|
#
|
9461
|
-
# # The following example
|
9462
|
-
# #
|
9715
|
+
# # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
|
9716
|
+
# # S3 returns version ID of the newly created object.
|
9463
9717
|
#
|
9464
9718
|
# resp = client.put_object({
|
9465
|
-
# body: "
|
9719
|
+
# body: "c:\\HappyFace.jpg",
|
9466
9720
|
# bucket: "examplebucket",
|
9467
|
-
# key: "
|
9468
|
-
#
|
9469
|
-
# "metadata1" => "value1",
|
9470
|
-
# "metadata2" => "value2",
|
9471
|
-
# },
|
9721
|
+
# key: "HappyFace.jpg",
|
9722
|
+
# tagging: "key1=value1&key2=value2",
|
9472
9723
|
# })
|
9473
9724
|
#
|
9474
9725
|
# resp.to_h outputs the following:
|
9475
9726
|
# {
|
9476
9727
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9477
|
-
# version_id: "
|
9728
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
9478
9729
|
# }
|
9479
9730
|
#
|
9480
|
-
# @example Example: To upload an object and specify
|
9731
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
9481
9732
|
#
|
9482
|
-
# # The following example uploads and object. The request specifies optional
|
9483
|
-
# #
|
9733
|
+
# # The following example uploads and object. The request specifies the optional server-side encryption option. The request
|
9734
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
9484
9735
|
#
|
9485
9736
|
# resp = client.put_object({
|
9486
|
-
# acl: "authenticated-read",
|
9487
9737
|
# body: "filetoupload",
|
9488
9738
|
# bucket: "examplebucket",
|
9489
9739
|
# key: "exampleobject",
|
9740
|
+
# server_side_encryption: "AES256",
|
9741
|
+
# tagging: "key1=value1&key2=value2",
|
9490
9742
|
# })
|
9491
9743
|
#
|
9492
9744
|
# resp.to_h outputs the following:
|
9493
9745
|
# {
|
9494
9746
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9495
|
-
#
|
9747
|
+
# server_side_encryption: "AES256",
|
9748
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
9496
9749
|
# }
|
9497
9750
|
#
|
9498
|
-
# @example Example: To upload an object
|
9751
|
+
# @example Example: To upload an object (specify optional headers)
|
9499
9752
|
#
|
9500
|
-
# # The following example uploads an object
|
9501
|
-
# #
|
9753
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
9754
|
+
# # storage class and use server-side encryption.
|
9502
9755
|
#
|
9503
9756
|
# resp = client.put_object({
|
9504
9757
|
# body: "HappyFace.jpg",
|
9505
9758
|
# bucket: "examplebucket",
|
9506
9759
|
# key: "HappyFace.jpg",
|
9760
|
+
# server_side_encryption: "AES256",
|
9761
|
+
# storage_class: "STANDARD_IA",
|
9507
9762
|
# })
|
9508
9763
|
#
|
9509
9764
|
# resp.to_h outputs the following:
|
9510
9765
|
# {
|
9511
9766
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9512
|
-
#
|
9767
|
+
# server_side_encryption: "AES256",
|
9768
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
9513
9769
|
# }
|
9514
9770
|
#
|
9515
9771
|
# @example Streaming a file from disk
|
@@ -9711,15 +9967,17 @@ module Aws::S3
|
|
9711
9967
|
#
|
9712
9968
|
# **Related Resources**
|
9713
9969
|
#
|
9714
|
-
# * CopyObject
|
9970
|
+
# * [CopyObject][4]
|
9715
9971
|
#
|
9716
|
-
# * GetObject
|
9972
|
+
# * [GetObject][5]
|
9717
9973
|
#
|
9718
9974
|
#
|
9719
9975
|
#
|
9720
9976
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
9721
9977
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
9722
9978
|
# [3]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
9979
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
9980
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
9723
9981
|
#
|
9724
9982
|
# @option params [String] :acl
|
9725
9983
|
# The canned ACL to apply to the object. For more information, see
|
@@ -10120,10 +10378,10 @@ module Aws::S3
|
|
10120
10378
|
# A tag is a key-value pair. You can associate tags with an object by
|
10121
10379
|
# sending a PUT request against the tagging subresource that is
|
10122
10380
|
# associated with the object. You can retrieve tags by sending a GET
|
10123
|
-
# request. For more information, see GetObjectTagging.
|
10381
|
+
# request. For more information, see [GetObjectTagging][1].
|
10124
10382
|
#
|
10125
10383
|
# For tagging-related restrictions related to characters and encodings,
|
10126
|
-
# see [Tag Restrictions][
|
10384
|
+
# see [Tag Restrictions][2]. Note that Amazon S3 limits the maximum
|
10127
10385
|
# number of tags to 10 tags per object.
|
10128
10386
|
#
|
10129
10387
|
# To use this operation, you must have permission to perform the
|
@@ -10134,7 +10392,7 @@ module Aws::S3
|
|
10134
10392
|
# You also need permission for the `s3:PutObjectVersionTagging` action.
|
10135
10393
|
#
|
10136
10394
|
# For information about the Amazon S3 object tagging feature, see
|
10137
|
-
# [Object Tagging][
|
10395
|
+
# [Object Tagging][3].
|
10138
10396
|
#
|
10139
10397
|
# **Special Errors**
|
10140
10398
|
#
|
@@ -10144,7 +10402,7 @@ module Aws::S3
|
|
10144
10402
|
#
|
10145
10403
|
# * *Cause: The tag provided was not a valid tag. This error can occur
|
10146
10404
|
# if the tag did not pass input validation. For more information,
|
10147
|
-
# see [Object Tagging][
|
10405
|
+
# see [Object Tagging][3].*
|
10148
10406
|
#
|
10149
10407
|
# * ****
|
10150
10408
|
#
|
@@ -10164,14 +10422,15 @@ module Aws::S3
|
|
10164
10422
|
#
|
10165
10423
|
# **Related Resources**
|
10166
10424
|
#
|
10167
|
-
# * GetObjectTagging
|
10425
|
+
# * [GetObjectTagging][1]
|
10168
10426
|
#
|
10169
10427
|
# ^
|
10170
10428
|
#
|
10171
10429
|
#
|
10172
10430
|
#
|
10173
|
-
# [1]: https://docs.aws.amazon.com/
|
10174
|
-
# [2]: https://docs.aws.amazon.com/
|
10431
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
|
10432
|
+
# [2]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
|
10433
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
10175
10434
|
#
|
10176
10435
|
# @option params [required, String] :bucket
|
10177
10436
|
# The bucket name containing the object.
|
@@ -10189,7 +10448,7 @@ module Aws::S3
|
|
10189
10448
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
10190
10449
|
#
|
10191
10450
|
# @option params [required, String] :key
|
10192
|
-
# Name of the
|
10451
|
+
# Name of the object key.
|
10193
10452
|
#
|
10194
10453
|
# @option params [String] :version_id
|
10195
10454
|
# The versionId of the object that the tag-set will be added to.
|
@@ -10279,19 +10538,22 @@ module Aws::S3
|
|
10279
10538
|
#
|
10280
10539
|
# **Related Resources**
|
10281
10540
|
#
|
10282
|
-
# * GetPublicAccessBlock
|
10541
|
+
# * [GetPublicAccessBlock][3]
|
10283
10542
|
#
|
10284
|
-
# * DeletePublicAccessBlock
|
10543
|
+
# * [DeletePublicAccessBlock][4]
|
10285
10544
|
#
|
10286
|
-
# * GetBucketPolicyStatus
|
10545
|
+
# * [GetBucketPolicyStatus][5]
|
10287
10546
|
#
|
10288
|
-
# * [Using Amazon S3 Block Public Access][
|
10547
|
+
# * [Using Amazon S3 Block Public Access][6]
|
10289
10548
|
#
|
10290
10549
|
#
|
10291
10550
|
#
|
10292
10551
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
10293
10552
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
|
10294
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10553
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html
|
10554
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
|
10555
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicyStatus.html
|
10556
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
|
10295
10557
|
#
|
10296
10558
|
# @option params [required, String] :bucket
|
10297
10559
|
# The name of the Amazon S3 bucket whose `PublicAccessBlock`
|
@@ -10374,12 +10636,12 @@ module Aws::S3
|
|
10374
10636
|
# For more information about the `S3` structure in the request body,
|
10375
10637
|
# see the following:
|
10376
10638
|
#
|
10377
|
-
# * PutObject
|
10639
|
+
# * [PutObject][4]
|
10378
10640
|
#
|
10379
|
-
# * [Managing Access with ACLs][
|
10641
|
+
# * [Managing Access with ACLs][5] in the *Amazon Simple Storage
|
10380
10642
|
# Service Developer Guide*
|
10381
10643
|
#
|
10382
|
-
# * [Protecting Data Using Server-Side Encryption][
|
10644
|
+
# * [Protecting Data Using Server-Side Encryption][6] in the *Amazon
|
10383
10645
|
# Simple Storage Service Developer Guide*
|
10384
10646
|
#
|
10385
10647
|
# * Define the SQL expression for the `SELECT` type of restoration for
|
@@ -10405,7 +10667,7 @@ module Aws::S3
|
|
10405
10667
|
# `SELECT s.Id, s.FirstName, s.SSN FROM S3Object s`
|
10406
10668
|
#
|
10407
10669
|
# For more information about using SQL with S3 Glacier Select restore,
|
10408
|
-
# see [SQL Reference for Amazon S3 Select and S3 Glacier Select][
|
10670
|
+
# see [SQL Reference for Amazon S3 Select and S3 Glacier Select][7] in
|
10409
10671
|
# the *Amazon Simple Storage Service Developer Guide*.
|
10410
10672
|
#
|
10411
10673
|
# When making a select request, you can also do the following:
|
@@ -10480,7 +10742,7 @@ module Aws::S3
|
|
10480
10742
|
#
|
10481
10743
|
# For more information about archive retrieval options and provisioned
|
10482
10744
|
# capacity for `Expedited` data access, see [Restoring Archived
|
10483
|
-
# Objects][
|
10745
|
+
# Objects][8] in the *Amazon Simple Storage Service Developer Guide*.
|
10484
10746
|
#
|
10485
10747
|
# You can use Amazon S3 restore speed upgrade to change the restore
|
10486
10748
|
# speed to a faster speed while it is in progress. You upgrade the speed
|
@@ -10490,14 +10752,14 @@ module Aws::S3
|
|
10490
10752
|
# faster than the tier that the in-progress restore is using. You must
|
10491
10753
|
# not change any other parameters, such as the `Days` request element.
|
10492
10754
|
# For more information, see [ Upgrading the Speed of an In-Progress
|
10493
|
-
# Restore][
|
10755
|
+
# Restore][9] in the *Amazon Simple Storage Service Developer Guide*.
|
10494
10756
|
#
|
10495
10757
|
# To get the status of object restoration, you can send a `HEAD`
|
10496
10758
|
# request. Operations return the `x-amz-restore` header, which provides
|
10497
10759
|
# information about the restoration status, in the response. You can use
|
10498
10760
|
# Amazon S3 event notifications to notify you when a restore is
|
10499
10761
|
# initiated or completed. For more information, see [Configuring Amazon
|
10500
|
-
# S3 Event Notifications][
|
10762
|
+
# S3 Event Notifications][10] in the *Amazon Simple Storage Service
|
10501
10763
|
# Developer Guide*.
|
10502
10764
|
#
|
10503
10765
|
# After restoring an archived object, you can update the restoration
|
@@ -10512,9 +10774,9 @@ module Aws::S3
|
|
10512
10774
|
# that you specify in a restore request. For example, if you restore an
|
10513
10775
|
# object copy for 10 days, but the object is scheduled to expire in 3
|
10514
10776
|
# days, Amazon S3 deletes the object in 3 days. For more information
|
10515
|
-
# about lifecycle configuration, see
|
10516
|
-
# [
|
10517
|
-
# Developer Guide*.
|
10777
|
+
# about lifecycle configuration, see
|
10778
|
+
# [PutBucketLifecycleConfiguration][11] and [Object Lifecycle
|
10779
|
+
# Management][12] in *Amazon Simple Storage Service Developer Guide*.
|
10518
10780
|
#
|
10519
10781
|
# **Responses**
|
10520
10782
|
#
|
@@ -10556,11 +10818,11 @@ module Aws::S3
|
|
10556
10818
|
#
|
10557
10819
|
# **Related Resources**
|
10558
10820
|
#
|
10559
|
-
# * PutBucketLifecycleConfiguration
|
10821
|
+
# * [PutBucketLifecycleConfiguration][11]
|
10560
10822
|
#
|
10561
|
-
# * GetBucketNotificationConfiguration
|
10823
|
+
# * [GetBucketNotificationConfiguration][13]
|
10562
10824
|
#
|
10563
|
-
# * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][
|
10825
|
+
# * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][7] in
|
10564
10826
|
# the *Amazon Simple Storage Service Developer Guide*
|
10565
10827
|
#
|
10566
10828
|
#
|
@@ -10568,13 +10830,16 @@ module Aws::S3
|
|
10568
10830
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
10569
10831
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
10570
10832
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html
|
10571
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10572
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10573
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10574
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10575
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
|
10576
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10577
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10833
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
10834
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
10835
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
10836
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html
|
10837
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
|
10838
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html
|
10839
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
10840
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
10841
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
10842
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html
|
10578
10843
|
#
|
10579
10844
|
# @option params [required, String] :bucket
|
10580
10845
|
# The bucket name or containing the object to restore.
|
@@ -10789,16 +11054,17 @@ module Aws::S3
|
|
10789
11054
|
#
|
10790
11055
|
# For objects that are encrypted with customer-provided encryption
|
10791
11056
|
# keys (SSE-C), you must use HTTPS, and you must use the headers that
|
10792
|
-
# are documented in the GetObject. For more information about
|
10793
|
-
# see [Server-Side Encryption (Using Customer-Provided
|
10794
|
-
# Keys)][
|
11057
|
+
# are documented in the [GetObject][4]. For more information about
|
11058
|
+
# SSE-C, see [Server-Side Encryption (Using Customer-Provided
|
11059
|
+
# Encryption Keys)][5] in the *Amazon Simple Storage Service Developer
|
11060
|
+
# Guide*.
|
10795
11061
|
#
|
10796
11062
|
# For objects that are encrypted with Amazon S3 managed encryption
|
10797
11063
|
# keys (SSE-S3) and customer master keys (CMKs) stored in AWS Key
|
10798
11064
|
# Management Service (SSE-KMS), server-side encryption is handled
|
10799
11065
|
# transparently, so you don't need to specify anything. For more
|
10800
11066
|
# information about server-side encryption, including SSE-S3 and
|
10801
|
-
# SSE-KMS, see [Protecting Data Using Server-Side Encryption][
|
11067
|
+
# SSE-KMS, see [Protecting Data Using Server-Side Encryption][6] in
|
10802
11068
|
# the *Amazon Simple Storage Service Developer Guide*.
|
10803
11069
|
#
|
10804
11070
|
# **Working with the Response Body**
|
@@ -10806,49 +11072,55 @@ module Aws::S3
|
|
10806
11072
|
# Given the response size is unknown, Amazon S3 Select streams the
|
10807
11073
|
# response as a series of messages and includes a `Transfer-Encoding`
|
10808
11074
|
# header with `chunked` as its value in the response. For more
|
10809
|
-
# information, see
|
11075
|
+
# information, see [Appendix: SelectObjectContent Response][7] .
|
10810
11076
|
#
|
10811
11077
|
#
|
10812
11078
|
#
|
10813
11079
|
# **GetObject Support**
|
10814
11080
|
#
|
10815
11081
|
# The `SelectObjectContent` operation does not support the following
|
10816
|
-
# `GetObject` functionality. For more information, see GetObject.
|
11082
|
+
# `GetObject` functionality. For more information, see [GetObject][4].
|
10817
11083
|
#
|
10818
11084
|
# * `Range`\: Although you can specify a scan range for an Amazon S3
|
10819
|
-
# Select request (see SelectObjectContentRequest
|
10820
|
-
# request parameters), you cannot specify the range of bytes of an
|
11085
|
+
# Select request (see [SelectObjectContentRequest - ScanRange][8] in
|
11086
|
+
# the request parameters), you cannot specify the range of bytes of an
|
10821
11087
|
# object to return.
|
10822
11088
|
#
|
10823
11089
|
# * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
|
10824
11090
|
# cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
|
10825
11091
|
# storage classes. For more information, about storage classes see
|
10826
|
-
# [Storage Classes][
|
11092
|
+
# [Storage Classes][9] in the *Amazon Simple Storage Service Developer
|
10827
11093
|
# Guide*.
|
10828
11094
|
#
|
10829
11095
|
#
|
10830
11096
|
#
|
10831
11097
|
# **Special Errors**
|
10832
11098
|
#
|
10833
|
-
# For a list of special errors for this operation, see
|
10834
|
-
#
|
11099
|
+
# For a list of special errors for this operation, see [List of SELECT
|
11100
|
+
# Object Content Error Codes][10]
|
10835
11101
|
#
|
10836
11102
|
# **Related Resources**
|
10837
11103
|
#
|
10838
|
-
# * GetObject
|
11104
|
+
# * [GetObject][4]
|
10839
11105
|
#
|
10840
|
-
# * GetBucketLifecycleConfiguration
|
11106
|
+
# * [GetBucketLifecycleConfiguration][11]
|
10841
11107
|
#
|
10842
|
-
# * PutBucketLifecycleConfiguration
|
11108
|
+
# * [PutBucketLifecycleConfiguration][12]
|
10843
11109
|
#
|
10844
11110
|
#
|
10845
11111
|
#
|
10846
11112
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
|
10847
11113
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html
|
10848
11114
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
10849
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10850
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10851
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
11115
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
11116
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
11117
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
11118
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTSelectObjectAppendix.html
|
11119
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html#AmazonS3-SelectObjectContent-request-ScanRange
|
11120
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#storage-class-intro
|
11121
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#SelectObjectContentErrorCodeList
|
11122
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
11123
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
10852
11124
|
#
|
10853
11125
|
# @option params [required, String] :bucket
|
10854
11126
|
# The S3 bucket.
|
@@ -11144,11 +11416,11 @@ module Aws::S3
|
|
11144
11416
|
# <note markdown="1"> In this operation, you provide part data in your request. However, you
|
11145
11417
|
# have an option to specify your existing Amazon S3 object as a data
|
11146
11418
|
# source for the part you are uploading. To upload a part from an
|
11147
|
-
# existing object, you use the UploadPartCopy operation.
|
11419
|
+
# existing object, you use the [UploadPartCopy][1] operation.
|
11148
11420
|
#
|
11149
11421
|
# </note>
|
11150
11422
|
#
|
11151
|
-
# You must initiate a multipart upload (see CreateMultipartUpload)
|
11423
|
+
# You must initiate a multipart upload (see [CreateMultipartUpload][2])
|
11152
11424
|
# before you can upload any part. In response to your initiate request,
|
11153
11425
|
# Amazon S3 returns an upload ID, a unique identifier, that you must
|
11154
11426
|
# include in your upload part request.
|
@@ -11173,11 +11445,11 @@ module Aws::S3
|
|
11173
11445
|
# parts storage and stops charging you for the parts storage.
|
11174
11446
|
#
|
11175
11447
|
# For more information on multipart uploads, go to [Multipart Upload
|
11176
|
-
# Overview][
|
11448
|
+
# Overview][3] in the <i>Amazon Simple Storage Service Developer Guide
|
11177
11449
|
# </i>.
|
11178
11450
|
#
|
11179
11451
|
# For information on the permissions required to use the multipart
|
11180
|
-
# upload API, go to [Multipart Upload API and Permissions][
|
11452
|
+
# upload API, go to [Multipart Upload API and Permissions][4] in the
|
11181
11453
|
# *Amazon Simple Storage Service Developer Guide*.
|
11182
11454
|
#
|
11183
11455
|
# You can optionally request server-side encryption where Amazon S3
|
@@ -11187,26 +11459,27 @@ module Aws::S3
|
|
11187
11459
|
# encryption keys. If you choose to provide your own encryption key, the
|
11188
11460
|
# request headers you provide in the request must match the headers you
|
11189
11461
|
# used in the request to initiate the upload by using
|
11190
|
-
# CreateMultipartUpload. For more information, go to [Using
|
11191
|
-
# Encryption][
|
11462
|
+
# [CreateMultipartUpload][2]. For more information, go to [Using
|
11463
|
+
# Server-Side Encryption][5] in the *Amazon Simple Storage Service
|
11464
|
+
# Developer Guide*.
|
11192
11465
|
#
|
11193
11466
|
# Server-side encryption is supported by the S3 Multipart Upload
|
11194
11467
|
# actions. Unless you are using a customer-provided encryption key, you
|
11195
11468
|
# don't need to specify the encryption parameters in each UploadPart
|
11196
11469
|
# request. Instead, you only need to specify the server-side encryption
|
11197
11470
|
# parameters in the initial Initiate Multipart request. For more
|
11198
|
-
# information, see CreateMultipartUpload.
|
11471
|
+
# information, see [CreateMultipartUpload][2].
|
11199
11472
|
#
|
11200
11473
|
# If you requested server-side encryption using a customer-provided
|
11201
11474
|
# encryption key in your initiate multipart upload request, you must
|
11202
11475
|
# provide identical encryption information in each part upload using the
|
11203
11476
|
# following headers.
|
11204
11477
|
#
|
11205
|
-
# * x-amz-server-side
|
11478
|
+
# * x-amz-server-side-encryption-customer-algorithm
|
11206
11479
|
#
|
11207
|
-
# * x-amz-server-side
|
11480
|
+
# * x-amz-server-side-encryption-customer-key
|
11208
11481
|
#
|
11209
|
-
# * x-amz-server-side
|
11482
|
+
# * x-amz-server-side-encryption-customer-key-MD5
|
11210
11483
|
#
|
11211
11484
|
# **Special Errors**
|
11212
11485
|
#
|
@@ -11224,23 +11497,29 @@ module Aws::S3
|
|
11224
11497
|
#
|
11225
11498
|
# **Related Resources**
|
11226
11499
|
#
|
11227
|
-
# * CreateMultipartUpload
|
11500
|
+
# * [CreateMultipartUpload][2]
|
11228
11501
|
#
|
11229
|
-
# * CompleteMultipartUpload
|
11502
|
+
# * [CompleteMultipartUpload][6]
|
11230
11503
|
#
|
11231
|
-
# * AbortMultipartUpload
|
11504
|
+
# * [AbortMultipartUpload][7]
|
11232
11505
|
#
|
11233
|
-
# * ListParts
|
11506
|
+
# * [ListParts][8]
|
11234
11507
|
#
|
11235
|
-
# * ListMultipartUploads
|
11508
|
+
# * [ListMultipartUploads][9]
|
11236
11509
|
#
|
11237
11510
|
#
|
11238
11511
|
#
|
11239
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11240
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11241
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
11512
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
11513
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
11514
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
11515
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
11516
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
11517
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
11518
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
11519
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
11520
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
11242
11521
|
#
|
11243
|
-
# @option params [String,
|
11522
|
+
# @option params [String, StringIO, File] :body
|
11244
11523
|
# Object data.
|
11245
11524
|
#
|
11246
11525
|
# @option params [required, String] :bucket
|
@@ -11275,8 +11554,8 @@ module Aws::S3
|
|
11275
11554
|
# encrypting data. This value is used to store the object and then it is
|
11276
11555
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
11277
11556
|
# be appropriate for use with the algorithm specified in the
|
11278
|
-
# `x-amz-server-side
|
11279
|
-
#
|
11557
|
+
# `x-amz-server-side-encryption-customer-algorithm header`. This must be
|
11558
|
+
# the same encryption key specified in the initiate multipart upload
|
11280
11559
|
# request.
|
11281
11560
|
#
|
11282
11561
|
# @option params [String] :sse_customer_key_md5
|
@@ -11367,7 +11646,7 @@ module Aws::S3
|
|
11367
11646
|
# in the *Amazon Simple Storage Service Developer Guide*.
|
11368
11647
|
#
|
11369
11648
|
# <note markdown="1"> Instead of using an existing object as part data, you might use the
|
11370
|
-
# UploadPart operation and provide data in your request.
|
11649
|
+
# [UploadPart][2] operation and provide data in your request.
|
11371
11650
|
#
|
11372
11651
|
# </note>
|
11373
11652
|
#
|
@@ -11380,20 +11659,20 @@ module Aws::S3
|
|
11380
11659
|
# the following:
|
11381
11660
|
#
|
11382
11661
|
# * For conceptual information about multipart uploads, see [Uploading
|
11383
|
-
# Objects Using Multipart Upload][
|
11662
|
+
# Objects Using Multipart Upload][3] in the *Amazon Simple Storage
|
11384
11663
|
# Service Developer Guide*.
|
11385
11664
|
#
|
11386
11665
|
# * For information about permissions required to use the multipart
|
11387
|
-
# upload API, see [Multipart Upload API and Permissions][
|
11666
|
+
# upload API, see [Multipart Upload API and Permissions][4] in the
|
11388
11667
|
# *Amazon Simple Storage Service Developer Guide*.
|
11389
11668
|
#
|
11390
11669
|
# * For information about copying objects using a single atomic
|
11391
|
-
# operation vs. the multipart upload, see [Operations on Objects][
|
11670
|
+
# operation vs. the multipart upload, see [Operations on Objects][5]
|
11392
11671
|
# in the *Amazon Simple Storage Service Developer Guide*.
|
11393
11672
|
#
|
11394
11673
|
# * For information about using server-side encryption with
|
11395
11674
|
# customer-provided encryption keys with the UploadPartCopy operation,
|
11396
|
-
# see CopyObject and UploadPart.
|
11675
|
+
# see [CopyObject][6] and [UploadPart][2].
|
11397
11676
|
#
|
11398
11677
|
# Note the following additional considerations about the request headers
|
11399
11678
|
# `x-amz-copy-source-if-match`, `x-amz-copy-source-if-none-match`,
|
@@ -11466,24 +11745,31 @@ module Aws::S3
|
|
11466
11745
|
#
|
11467
11746
|
# **Related Resources**
|
11468
11747
|
#
|
11469
|
-
# * CreateMultipartUpload
|
11748
|
+
# * [CreateMultipartUpload][7]
|
11470
11749
|
#
|
11471
|
-
# * UploadPart
|
11750
|
+
# * [UploadPart][2]
|
11472
11751
|
#
|
11473
|
-
# * CompleteMultipartUpload
|
11752
|
+
# * [CompleteMultipartUpload][8]
|
11474
11753
|
#
|
11475
|
-
# * AbortMultipartUpload
|
11754
|
+
# * [AbortMultipartUpload][9]
|
11476
11755
|
#
|
11477
|
-
# * ListParts
|
11756
|
+
# * [ListParts][10]
|
11478
11757
|
#
|
11479
|
-
# * ListMultipartUploads
|
11758
|
+
# * [ListMultipartUploads][11]
|
11480
11759
|
#
|
11481
11760
|
#
|
11482
11761
|
#
|
11483
11762
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/qfacts.html
|
11484
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11485
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
11486
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
11763
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
11764
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
11765
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
11766
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
|
11767
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
11768
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
11769
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
11770
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
11771
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
11772
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
11487
11773
|
#
|
11488
11774
|
# @option params [required, String] :bucket
|
11489
11775
|
# The bucket name.
|
@@ -11532,8 +11818,8 @@ module Aws::S3
|
|
11532
11818
|
# encrypting data. This value is used to store the object and then it is
|
11533
11819
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
11534
11820
|
# be appropriate for use with the algorithm specified in the
|
11535
|
-
# `x-amz-server-side
|
11536
|
-
#
|
11821
|
+
# `x-amz-server-side-encryption-customer-algorithm` header. This must be
|
11822
|
+
# the same encryption key specified in the initiate multipart upload
|
11537
11823
|
# request.
|
11538
11824
|
#
|
11539
11825
|
# @option params [String] :sse_customer_key_md5
|
@@ -11577,45 +11863,45 @@ module Aws::S3
|
|
11577
11863
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
11578
11864
|
#
|
11579
11865
|
#
|
11580
|
-
# @example Example: To upload a part by copying
|
11866
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
11581
11867
|
#
|
11582
|
-
# # The following example uploads a part of a multipart upload by copying
|
11868
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
11869
|
+
# # data source.
|
11583
11870
|
#
|
11584
11871
|
# resp = client.upload_part_copy({
|
11585
11872
|
# bucket: "examplebucket",
|
11586
11873
|
# copy_source: "/bucketname/sourceobjectkey",
|
11874
|
+
# copy_source_range: "bytes=1-100000",
|
11587
11875
|
# key: "examplelargeobject",
|
11588
|
-
# part_number:
|
11876
|
+
# part_number: 2,
|
11589
11877
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
11590
11878
|
# })
|
11591
11879
|
#
|
11592
11880
|
# resp.to_h outputs the following:
|
11593
11881
|
# {
|
11594
11882
|
# copy_part_result: {
|
11595
|
-
# etag: "\"
|
11596
|
-
# last_modified: Time.parse("2016-12-29T21:
|
11883
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
11884
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
11597
11885
|
# },
|
11598
11886
|
# }
|
11599
11887
|
#
|
11600
|
-
# @example Example: To upload a part by copying
|
11888
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
11601
11889
|
#
|
11602
|
-
# # The following example uploads a part of a multipart upload by copying
|
11603
|
-
# # data source.
|
11890
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
11604
11891
|
#
|
11605
11892
|
# resp = client.upload_part_copy({
|
11606
11893
|
# bucket: "examplebucket",
|
11607
11894
|
# copy_source: "/bucketname/sourceobjectkey",
|
11608
|
-
# copy_source_range: "bytes=1-100000",
|
11609
11895
|
# key: "examplelargeobject",
|
11610
|
-
# part_number:
|
11896
|
+
# part_number: 1,
|
11611
11897
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
11612
11898
|
# })
|
11613
11899
|
#
|
11614
11900
|
# resp.to_h outputs the following:
|
11615
11901
|
# {
|
11616
11902
|
# copy_part_result: {
|
11617
|
-
# etag: "\"
|
11618
|
-
# last_modified: Time.parse("2016-12-29T21:
|
11903
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
11904
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
11619
11905
|
# },
|
11620
11906
|
# }
|
11621
11907
|
#
|
@@ -11674,7 +11960,7 @@ module Aws::S3
|
|
11674
11960
|
params: params,
|
11675
11961
|
config: config)
|
11676
11962
|
context[:gem_name] = 'aws-sdk-s3'
|
11677
|
-
context[:gem_version] = '1.
|
11963
|
+
context[:gem_version] = '1.76.0'
|
11678
11964
|
Seahorse::Client::Request.new(handlers, context)
|
11679
11965
|
end
|
11680
11966
|
|