aws-sdk-s3 1.77.0 → 1.78.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 +555 -830
- data/lib/aws-sdk-s3/multipart_upload_part.rb +4 -4
- data/lib/aws-sdk-s3/object.rb +8 -9
- data/lib/aws-sdk-s3/object_summary.rb +4 -4
- data/lib/aws-sdk-s3/object_version.rb +2 -2
- data/lib/aws-sdk-s3/resource.rb +1 -1
- data/lib/aws-sdk-s3/types.rb +22 -42
- 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: 12869c75a61c6e62eb981846c9cac525962300fae8ca08cf87d5c6fde2824f5f
|
4
|
+
data.tar.gz: 6a29b43d4e3453c63ed50e7a18c06af16064e3db761dd2f784923bd20abba0c4
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: b331ecb2c04da30961f53906e6811ba52f6b2f5a74f1c32153a03d7c1900392a61c6a7af8b33daa296e1cc7632514a86b99ec6af6d4b1851b9379c9a3894221b
|
7
|
+
data.tar.gz: 61ef696b6a90673f1a89f3ac5d31ccc1e8f2350e8d492b67974a3861f9cfcfc1d509d81608d96d8ee68312e5462eb64f644b415fb5fd6f79d0587b272803b136
|
data/lib/aws-sdk-s3.rb
CHANGED
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -222,7 +222,7 @@ module Aws::S3
|
|
222
222
|
# bucket.create({
|
223
223
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
224
224
|
# create_bucket_configuration: {
|
225
|
-
# location_constraint: "
|
225
|
+
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
226
226
|
# },
|
227
227
|
# grant_full_control: "GrantFullControl",
|
228
228
|
# grant_read: "GrantRead",
|
@@ -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,32 +402,27 @@ 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
|
405
|
+
# for the part storage, you should call the ListParts 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][1].
|
410
410
|
#
|
411
411
|
# The following operations are related to `AbortMultipartUpload`\:
|
412
412
|
#
|
413
|
-
# *
|
413
|
+
# * CreateMultipartUpload
|
414
414
|
#
|
415
|
-
# *
|
415
|
+
# * UploadPart
|
416
416
|
#
|
417
|
-
# *
|
417
|
+
# * CompleteMultipartUpload
|
418
418
|
#
|
419
|
-
# *
|
419
|
+
# * ListParts
|
420
420
|
#
|
421
|
-
# *
|
421
|
+
# * ListMultipartUploads
|
422
422
|
#
|
423
423
|
#
|
424
424
|
#
|
425
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
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
|
425
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
431
426
|
#
|
432
427
|
# @option params [required, String] :bucket
|
433
428
|
# The bucket name to which the upload was taking place.
|
@@ -505,7 +500,7 @@ module Aws::S3
|
|
505
500
|
# Completes a multipart upload by assembling previously uploaded parts.
|
506
501
|
#
|
507
502
|
# You first initiate the multipart upload and then upload all parts
|
508
|
-
# using the
|
503
|
+
# using the UploadPart operation. After successfully uploading all
|
509
504
|
# relevant parts of an upload, you call this operation to complete the
|
510
505
|
# upload. Upon receiving this request, Amazon S3 concatenates all the
|
511
506
|
# parts in ascending order by part number to create a new object. In the
|
@@ -526,13 +521,13 @@ module Aws::S3
|
|
526
521
|
#
|
527
522
|
# Note that if `CompleteMultipartUpload` fails, applications should be
|
528
523
|
# prepared to retry the failed requests. For more information, see
|
529
|
-
# [Amazon S3 Error Best Practices][
|
524
|
+
# [Amazon S3 Error Best Practices][1].
|
530
525
|
#
|
531
526
|
# For more information about multipart uploads, see [Uploading Objects
|
532
|
-
# Using Multipart Upload][
|
527
|
+
# Using Multipart Upload][2].
|
533
528
|
#
|
534
529
|
# For information about permissions required to use the multipart upload
|
535
|
-
# API, see [Multipart Upload API and Permissions][
|
530
|
+
# API, see [Multipart Upload API and Permissions][3].
|
536
531
|
#
|
537
532
|
# `CompleteMultipartUpload` has the following special errors:
|
538
533
|
#
|
@@ -569,26 +564,21 @@ module Aws::S3
|
|
569
564
|
#
|
570
565
|
# The following operations are related to `CompleteMultipartUpload`\:
|
571
566
|
#
|
572
|
-
# *
|
567
|
+
# * CreateMultipartUpload
|
573
568
|
#
|
574
|
-
# *
|
569
|
+
# * UploadPart
|
575
570
|
#
|
576
|
-
# *
|
571
|
+
# * AbortMultipartUpload
|
577
572
|
#
|
578
|
-
# *
|
573
|
+
# * ListParts
|
579
574
|
#
|
580
|
-
# *
|
575
|
+
# * ListMultipartUploads
|
581
576
|
#
|
582
577
|
#
|
583
578
|
#
|
584
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
585
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
586
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
579
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html
|
580
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
581
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
592
582
|
#
|
593
583
|
# @option params [required, String] :bucket
|
594
584
|
# Name of the bucket to which the multipart upload was initiated.
|
@@ -845,15 +835,15 @@ module Aws::S3
|
|
845
835
|
#
|
846
836
|
# If the source object's storage class is GLACIER, you must restore a
|
847
837
|
# copy of this object before you can use it as a source object for the
|
848
|
-
# copy operation. For more information, see
|
838
|
+
# copy operation. For more information, see .
|
849
839
|
#
|
850
840
|
# The following operations are related to `CopyObject`\:
|
851
841
|
#
|
852
|
-
# *
|
842
|
+
# * PutObject
|
853
843
|
#
|
854
|
-
# *
|
844
|
+
# * GetObject
|
855
845
|
#
|
856
|
-
# For more information, see [Copying Objects][
|
846
|
+
# For more information, see [Copying Objects][12].
|
857
847
|
#
|
858
848
|
#
|
859
849
|
#
|
@@ -868,10 +858,7 @@ module Aws::S3
|
|
868
858
|
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
869
859
|
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html
|
870
860
|
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
871
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
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
|
861
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html
|
875
862
|
#
|
876
863
|
# @option params [String] :acl
|
877
864
|
# The canned ACL to apply to the object.
|
@@ -965,7 +952,7 @@ module Aws::S3
|
|
965
952
|
# encrypting data. This value is used to store the object and then it is
|
966
953
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
967
954
|
# be appropriate for use with the algorithm specified in the
|
968
|
-
# `x-amz-server-side
|
955
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
969
956
|
#
|
970
957
|
# @option params [String] :sse_customer_key_md5
|
971
958
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -1220,9 +1207,9 @@ module Aws::S3
|
|
1220
1207
|
#
|
1221
1208
|
# The following operations are related to `CreateBucket`\:
|
1222
1209
|
#
|
1223
|
-
# *
|
1210
|
+
# * PutObject
|
1224
1211
|
#
|
1225
|
-
# *
|
1212
|
+
# * DeleteBucket
|
1226
1213
|
#
|
1227
1214
|
#
|
1228
1215
|
#
|
@@ -1232,8 +1219,6 @@ module Aws::S3
|
|
1232
1219
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
1233
1220
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
1234
1221
|
# [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
|
1237
1222
|
#
|
1238
1223
|
# @option params [String] :acl
|
1239
1224
|
# The canned ACL to apply to the bucket.
|
@@ -1305,7 +1290,7 @@ module Aws::S3
|
|
1305
1290
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
1306
1291
|
# bucket: "BucketName", # required
|
1307
1292
|
# create_bucket_configuration: {
|
1308
|
-
# location_constraint: "
|
1293
|
+
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
1309
1294
|
# },
|
1310
1295
|
# grant_full_control: "GrantFullControl",
|
1311
1296
|
# grant_read: "GrantRead",
|
@@ -1331,29 +1316,29 @@ module Aws::S3
|
|
1331
1316
|
# This operation initiates a multipart upload and returns an upload ID.
|
1332
1317
|
# This upload ID is used to associate all of the parts in the specific
|
1333
1318
|
# multipart upload. You specify this upload ID in each of your
|
1334
|
-
# subsequent upload part requests (see
|
1335
|
-
#
|
1336
|
-
#
|
1319
|
+
# subsequent upload part requests (see UploadPart). You also include
|
1320
|
+
# this upload ID in the final request to either complete or abort the
|
1321
|
+
# multipart upload request.
|
1337
1322
|
#
|
1338
1323
|
# For more information about multipart uploads, see [Multipart Upload
|
1339
|
-
# Overview][
|
1324
|
+
# Overview][1].
|
1340
1325
|
#
|
1341
1326
|
# If you have configured a lifecycle rule to abort incomplete multipart
|
1342
1327
|
# uploads, the upload must complete within the number of days specified
|
1343
1328
|
# in the bucket lifecycle configuration. Otherwise, the incomplete
|
1344
1329
|
# multipart upload becomes eligible for an abort operation and Amazon S3
|
1345
1330
|
# aborts the multipart upload. For more information, see [Aborting
|
1346
|
-
# Incomplete Multipart Uploads Using a Bucket Lifecycle Policy][
|
1331
|
+
# Incomplete Multipart Uploads Using a Bucket Lifecycle Policy][2].
|
1347
1332
|
#
|
1348
1333
|
# For information about the permissions required to use the multipart
|
1349
|
-
# upload API, see [Multipart Upload API and Permissions][
|
1334
|
+
# upload API, see [Multipart Upload API and Permissions][3].
|
1350
1335
|
#
|
1351
1336
|
# For request signing, multipart upload is just a series of regular
|
1352
1337
|
# requests. You initiate a multipart upload, send one or more requests
|
1353
1338
|
# to upload parts, and then complete the multipart upload process. You
|
1354
1339
|
# sign each request individually. There is nothing special about signing
|
1355
1340
|
# multipart upload requests. For more information about signing, see
|
1356
|
-
# [Authenticating Requests (AWS Signature Version 4)][
|
1341
|
+
# [Authenticating Requests (AWS Signature Version 4)][4].
|
1357
1342
|
#
|
1358
1343
|
# <note markdown="1"> After you initiate a multipart upload and upload one or more parts, to
|
1359
1344
|
# stop being charged for storing the uploaded parts, you must either
|
@@ -1369,9 +1354,9 @@ module Aws::S3
|
|
1369
1354
|
# your own encryption key, or use AWS Key Management Service (AWS KMS)
|
1370
1355
|
# customer master keys (CMKs) or Amazon S3-managed encryption keys. If
|
1371
1356
|
# you choose to provide your own encryption key, the request headers you
|
1372
|
-
# provide in
|
1373
|
-
#
|
1374
|
-
#
|
1357
|
+
# provide in UploadPart) and UploadPartCopy) requests must match the
|
1358
|
+
# headers you used in the request to initiate the upload by using
|
1359
|
+
# `CreateMultipartUpload`.
|
1375
1360
|
#
|
1376
1361
|
# To perform a multipart upload with encryption using an AWS KMS CMK,
|
1377
1362
|
# the requester must have permission to the `kms:Encrypt`,
|
@@ -1387,7 +1372,7 @@ module Aws::S3
|
|
1387
1372
|
# both the key policy and your IAM user or role.
|
1388
1373
|
#
|
1389
1374
|
# For more information, see [Protecting Data Using Server-Side
|
1390
|
-
# Encryption][
|
1375
|
+
# Encryption][5].
|
1391
1376
|
#
|
1392
1377
|
# Access Permissions
|
1393
1378
|
#
|
@@ -1397,13 +1382,13 @@ module Aws::S3
|
|
1397
1382
|
# request headers:
|
1398
1383
|
#
|
1399
1384
|
# * Specify a canned ACL with the `x-amz-acl` request header. For more
|
1400
|
-
# information, see [Canned ACL][
|
1385
|
+
# information, see [Canned ACL][6].
|
1401
1386
|
#
|
1402
1387
|
# * Specify access permissions explicitly with the `x-amz-grant-read`,
|
1403
1388
|
# `x-amz-grant-read-acp`, `x-amz-grant-write-acp`, and
|
1404
1389
|
# `x-amz-grant-full-control` headers. These parameters map to the
|
1405
1390
|
# set of permissions that Amazon S3 supports in an ACL. For more
|
1406
|
-
# information, see [Access Control List (ACL) Overview][
|
1391
|
+
# information, see [Access Control List (ACL) Overview][7].
|
1407
1392
|
#
|
1408
1393
|
# You can use either a canned ACL or specify access permissions
|
1409
1394
|
# explicitly. You cannot do both.
|
@@ -1422,7 +1407,7 @@ module Aws::S3
|
|
1422
1407
|
# want AWS to manage the keys used to encrypt data, specify the
|
1423
1408
|
# following headers in the request.
|
1424
1409
|
#
|
1425
|
-
# * x-amz-server-side
|
1410
|
+
# * x-amz-server-side-encryption
|
1426
1411
|
#
|
1427
1412
|
# * x-amz-server-side-encryption-aws-kms-key-id
|
1428
1413
|
#
|
@@ -1439,21 +1424,21 @@ module Aws::S3
|
|
1439
1424
|
#
|
1440
1425
|
# For more information about server-side encryption with CMKs stored
|
1441
1426
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
1442
|
-
# Encryption with CMKs stored in AWS KMS][
|
1427
|
+
# Encryption with CMKs stored in AWS KMS][8].
|
1443
1428
|
#
|
1444
1429
|
# * Use customer-provided encryption keys – If you want to manage your
|
1445
1430
|
# own encryption keys, provide all the following headers in the
|
1446
1431
|
# request.
|
1447
1432
|
#
|
1448
|
-
# * x-amz-server-side
|
1433
|
+
# * x-amz-server-side-encryption-customer-algorithm
|
1449
1434
|
#
|
1450
|
-
# * x-amz-server-side
|
1435
|
+
# * x-amz-server-side-encryption-customer-key
|
1451
1436
|
#
|
1452
|
-
# * x-amz-server-side
|
1437
|
+
# * x-amz-server-side-encryption-customer-key-MD5
|
1453
1438
|
#
|
1454
1439
|
# For more information about server-side encryption with CMKs stored
|
1455
1440
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
1456
|
-
# Encryption with CMKs stored in AWS KMS][
|
1441
|
+
# Encryption with CMKs stored in AWS KMS][8].
|
1457
1442
|
#
|
1458
1443
|
# Access-Control-List (ACL)-Specific Request Headers
|
1459
1444
|
#
|
@@ -1463,19 +1448,19 @@ module Aws::S3
|
|
1463
1448
|
# permissions to individual AWS accounts or to predefined groups
|
1464
1449
|
# defined by Amazon S3. These permissions are then added to the access
|
1465
1450
|
# control list (ACL) on the object. For more information, see [Using
|
1466
|
-
# ACLs][
|
1451
|
+
# ACLs][9]. With this operation, you can grant access permissions
|
1467
1452
|
# using one of the following two methods:
|
1468
1453
|
#
|
1469
1454
|
# * Specify a canned ACL (`x-amz-acl`) — Amazon S3 supports a set of
|
1470
1455
|
# predefined ACLs, known as *canned ACLs*. Each canned ACL has a
|
1471
1456
|
# predefined set of grantees and permissions. For more information,
|
1472
|
-
# see [Canned ACL][
|
1457
|
+
# see [Canned ACL][6].
|
1473
1458
|
#
|
1474
1459
|
# * Specify access permissions explicitly — To explicitly grant access
|
1475
1460
|
# permissions to specific AWS accounts or groups, use the following
|
1476
1461
|
# headers. Each header maps to specific permissions that Amazon S3
|
1477
1462
|
# supports in an ACL. For more information, see [Access Control List
|
1478
|
-
# (ACL) Overview][
|
1463
|
+
# (ACL) Overview][7]. In the header, you specify a list of grantees
|
1479
1464
|
# who get the specific permission. To grant permissions explicitly,
|
1480
1465
|
# use:
|
1481
1466
|
#
|
@@ -1520,7 +1505,7 @@ module Aws::S3
|
|
1520
1505
|
# * South America (São Paulo)
|
1521
1506
|
#
|
1522
1507
|
# For a list of all the Amazon S3 supported Regions and endpoints,
|
1523
|
-
# see [Regions and Endpoints][
|
1508
|
+
# see [Regions and Endpoints][10] in the AWS General Reference.
|
1524
1509
|
#
|
1525
1510
|
# </note>
|
1526
1511
|
#
|
@@ -1532,34 +1517,28 @@ module Aws::S3
|
|
1532
1517
|
#
|
1533
1518
|
# The following operations are related to `CreateMultipartUpload`\:
|
1534
1519
|
#
|
1535
|
-
# *
|
1520
|
+
# * UploadPart
|
1536
1521
|
#
|
1537
|
-
# *
|
1522
|
+
# * CompleteMultipartUpload
|
1538
1523
|
#
|
1539
|
-
# *
|
1524
|
+
# * AbortMultipartUpload
|
1540
1525
|
#
|
1541
|
-
# *
|
1526
|
+
# * ListParts
|
1542
1527
|
#
|
1543
|
-
# *
|
1528
|
+
# * ListMultipartUploads
|
1544
1529
|
#
|
1545
1530
|
#
|
1546
1531
|
#
|
1547
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1548
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
1549
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1550
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1551
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1552
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1553
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1554
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1555
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
1556
|
-
# [10]: https://docs.aws.amazon.com/
|
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
|
1532
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
1533
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
|
1534
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
1535
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
1536
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
1537
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
1538
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
1539
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html
|
1540
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
1541
|
+
# [10]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
1563
1542
|
#
|
1564
1543
|
# @option params [String] :acl
|
1565
1544
|
# The canned ACL to apply to the object.
|
@@ -1627,7 +1606,7 @@ module Aws::S3
|
|
1627
1606
|
# encrypting data. This value is used to store the object and then it is
|
1628
1607
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
1629
1608
|
# be appropriate for use with the algorithm specified in the
|
1630
|
-
# `x-amz-server-side
|
1609
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
1631
1610
|
#
|
1632
1611
|
# @option params [String] :sse_customer_key_md5
|
1633
1612
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -1771,14 +1750,8 @@ module Aws::S3
|
|
1771
1750
|
#
|
1772
1751
|
# **Related Resources**
|
1773
1752
|
#
|
1774
|
-
# *
|
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
|
1753
|
+
# *
|
1754
|
+
# *
|
1782
1755
|
#
|
1783
1756
|
# @option params [required, String] :bucket
|
1784
1757
|
# Specifies the bucket being deleted.
|
@@ -1825,20 +1798,15 @@ module Aws::S3
|
|
1825
1798
|
# The following operations are related to
|
1826
1799
|
# `DeleteBucketAnalyticsConfiguration`\:
|
1827
1800
|
#
|
1828
|
-
# *
|
1829
|
-
#
|
1830
|
-
# *
|
1831
|
-
#
|
1832
|
-
# * [PutBucketAnalyticsConfiguration][6]
|
1801
|
+
# *
|
1802
|
+
# *
|
1803
|
+
# *
|
1833
1804
|
#
|
1834
1805
|
#
|
1835
1806
|
#
|
1836
1807
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
1837
1808
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
1838
1809
|
# [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
|
1842
1810
|
#
|
1843
1811
|
# @option params [required, String] :bucket
|
1844
1812
|
# The name of the bucket from which an analytics configuration is
|
@@ -1876,15 +1844,12 @@ module Aws::S3
|
|
1876
1844
|
#
|
1877
1845
|
# **Related Resources:**
|
1878
1846
|
#
|
1879
|
-
# *
|
1880
|
-
#
|
1881
|
-
# * [RESTOPTIONSobject][3]
|
1847
|
+
# *
|
1848
|
+
# * RESTOPTIONSobject
|
1882
1849
|
#
|
1883
1850
|
#
|
1884
1851
|
#
|
1885
1852
|
# [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
|
1888
1853
|
#
|
1889
1854
|
# @option params [required, String] :bucket
|
1890
1855
|
# Specifies the bucket whose `cors` configuration is being deleted.
|
@@ -1930,17 +1895,15 @@ module Aws::S3
|
|
1930
1895
|
#
|
1931
1896
|
# **Related Resources**
|
1932
1897
|
#
|
1933
|
-
# *
|
1898
|
+
# * PutBucketEncryption
|
1934
1899
|
#
|
1935
|
-
# *
|
1900
|
+
# * GetBucketEncryption
|
1936
1901
|
#
|
1937
1902
|
#
|
1938
1903
|
#
|
1939
1904
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
1940
1905
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
1941
1906
|
# [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
|
1944
1907
|
#
|
1945
1908
|
# @option params [required, String] :bucket
|
1946
1909
|
# The name of the bucket containing the server-side encryption
|
@@ -1978,20 +1941,17 @@ module Aws::S3
|
|
1978
1941
|
#
|
1979
1942
|
# Operations related to `DeleteBucketInventoryConfiguration` include:
|
1980
1943
|
#
|
1981
|
-
# *
|
1944
|
+
# * GetBucketInventoryConfiguration
|
1982
1945
|
#
|
1983
|
-
# *
|
1946
|
+
# * PutBucketInventoryConfiguration
|
1984
1947
|
#
|
1985
|
-
# *
|
1948
|
+
# * ListBucketInventoryConfigurations
|
1986
1949
|
#
|
1987
1950
|
#
|
1988
1951
|
#
|
1989
1952
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
1990
1953
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
1991
1954
|
# [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
|
1995
1955
|
#
|
1996
1956
|
# @option params [required, String] :bucket
|
1997
1957
|
# The name of the bucket containing the inventory configuration to
|
@@ -2037,15 +1997,13 @@ module Aws::S3
|
|
2037
1997
|
#
|
2038
1998
|
# Related actions include:
|
2039
1999
|
#
|
2040
|
-
# *
|
2000
|
+
# * PutBucketLifecycleConfiguration
|
2041
2001
|
#
|
2042
|
-
# *
|
2002
|
+
# * GetBucketLifecycleConfiguration
|
2043
2003
|
#
|
2044
2004
|
#
|
2045
2005
|
#
|
2046
2006
|
# [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
|
2049
2007
|
#
|
2050
2008
|
# @option params [required, String] :bucket
|
2051
2009
|
# The bucket name of the lifecycle to delete.
|
@@ -2093,11 +2051,11 @@ module Aws::S3
|
|
2093
2051
|
# The following operations are related to
|
2094
2052
|
# `DeleteBucketMetricsConfiguration`\:
|
2095
2053
|
#
|
2096
|
-
# *
|
2054
|
+
# * GetBucketMetricsConfiguration
|
2097
2055
|
#
|
2098
|
-
# *
|
2056
|
+
# * PutBucketMetricsConfiguration
|
2099
2057
|
#
|
2100
|
-
# *
|
2058
|
+
# * ListBucketMetricsConfigurations
|
2101
2059
|
#
|
2102
2060
|
# * [Monitoring Metrics with Amazon CloudWatch][3]
|
2103
2061
|
#
|
@@ -2106,9 +2064,6 @@ module Aws::S3
|
|
2106
2064
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2107
2065
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2108
2066
|
# [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
|
2112
2067
|
#
|
2113
2068
|
# @option params [required, String] :bucket
|
2114
2069
|
# The name of the bucket containing the metrics configuration to delete.
|
@@ -2156,14 +2111,9 @@ module Aws::S3
|
|
2156
2111
|
#
|
2157
2112
|
# The following operations are related to `DeleteBucketPolicy`
|
2158
2113
|
#
|
2159
|
-
# *
|
2160
|
-
#
|
2161
|
-
# * [DeleteObject][2]
|
2114
|
+
# * CreateBucket
|
2162
2115
|
#
|
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
|
2116
|
+
# * DeleteObject
|
2167
2117
|
#
|
2168
2118
|
# @option params [required, String] :bucket
|
2169
2119
|
# The bucket name.
|
@@ -2214,16 +2164,14 @@ module Aws::S3
|
|
2214
2164
|
#
|
2215
2165
|
# The following operations are related to `DeleteBucketReplication`\:
|
2216
2166
|
#
|
2217
|
-
# *
|
2167
|
+
# * PutBucketReplication
|
2218
2168
|
#
|
2219
|
-
# *
|
2169
|
+
# * GetBucketReplication
|
2220
2170
|
#
|
2221
2171
|
#
|
2222
2172
|
#
|
2223
2173
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2224
2174
|
# [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
|
2227
2175
|
#
|
2228
2176
|
# @option params [required, String] :bucket
|
2229
2177
|
# The bucket name.
|
@@ -2262,14 +2210,9 @@ module Aws::S3
|
|
2262
2210
|
#
|
2263
2211
|
# The following operations are related to `DeleteBucketTagging`\:
|
2264
2212
|
#
|
2265
|
-
# *
|
2266
|
-
#
|
2267
|
-
# * [PutBucketTagging][2]
|
2213
|
+
# * GetBucketTagging
|
2268
2214
|
#
|
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
|
2215
|
+
# * PutBucketTagging
|
2273
2216
|
#
|
2274
2217
|
# @option params [required, String] :bucket
|
2275
2218
|
# The bucket that has the tag set to be removed.
|
@@ -2318,15 +2261,13 @@ module Aws::S3
|
|
2318
2261
|
#
|
2319
2262
|
# The following operations are related to `DeleteBucketWebsite`\:
|
2320
2263
|
#
|
2321
|
-
# *
|
2264
|
+
# * GetBucketWebsite
|
2322
2265
|
#
|
2323
|
-
# *
|
2266
|
+
# * PutBucketWebsite
|
2324
2267
|
#
|
2325
2268
|
#
|
2326
2269
|
#
|
2327
2270
|
# [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
|
2330
2271
|
#
|
2331
2272
|
# @option params [required, String] :bucket
|
2332
2273
|
# The bucket name for which you want to remove the website
|
@@ -2377,15 +2318,15 @@ module Aws::S3
|
|
2377
2318
|
# see sample requests that use versioning, see [Sample Request][2].
|
2378
2319
|
#
|
2379
2320
|
# You can delete objects by explicitly calling the DELETE Object API or
|
2380
|
-
# configure its lifecycle (
|
2381
|
-
#
|
2321
|
+
# configure its lifecycle (PutBucketLifecycle) to enable Amazon S3 to
|
2322
|
+
# remove them for you. If you want to block users or accounts from
|
2382
2323
|
# removing or deleting objects from your bucket, you must deny them the
|
2383
2324
|
# `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
|
2384
2325
|
# `s3:PutLifeCycleConfiguration` actions.
|
2385
2326
|
#
|
2386
2327
|
# The following operation is related to `DeleteObject`\:
|
2387
2328
|
#
|
2388
|
-
# *
|
2329
|
+
# * PutObject
|
2389
2330
|
#
|
2390
2331
|
# ^
|
2391
2332
|
#
|
@@ -2393,8 +2334,6 @@ module Aws::S3
|
|
2393
2334
|
#
|
2394
2335
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
|
2395
2336
|
# [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
|
2398
2337
|
#
|
2399
2338
|
# @option params [required, String] :bucket
|
2400
2339
|
# The bucket name of the bucket containing the object.
|
@@ -2445,6 +2384,15 @@ module Aws::S3
|
|
2445
2384
|
# * {Types::DeleteObjectOutput#request_charged #request_charged} => String
|
2446
2385
|
#
|
2447
2386
|
#
|
2387
|
+
# @example Example: To delete an object (from a non-versioned bucket)
|
2388
|
+
#
|
2389
|
+
# # The following example deletes an object from a non-versioned bucket.
|
2390
|
+
#
|
2391
|
+
# resp = client.delete_object({
|
2392
|
+
# bucket: "ExampleBucket",
|
2393
|
+
# key: "HappyFace.jpg",
|
2394
|
+
# })
|
2395
|
+
#
|
2448
2396
|
# @example Example: To delete an object
|
2449
2397
|
#
|
2450
2398
|
# # The following example deletes an object from an S3 bucket.
|
@@ -2458,15 +2406,6 @@ module Aws::S3
|
|
2458
2406
|
# {
|
2459
2407
|
# }
|
2460
2408
|
#
|
2461
|
-
# @example Example: To delete an object (from a non-versioned bucket)
|
2462
|
-
#
|
2463
|
-
# # The following example deletes an object from a non-versioned bucket.
|
2464
|
-
#
|
2465
|
-
# resp = client.delete_object({
|
2466
|
-
# bucket: "ExampleBucket",
|
2467
|
-
# key: "HappyFace.jpg",
|
2468
|
-
# })
|
2469
|
-
#
|
2470
2409
|
# @example Request syntax with placeholder values
|
2471
2410
|
#
|
2472
2411
|
# resp = client.delete_object({
|
@@ -2506,15 +2445,13 @@ module Aws::S3
|
|
2506
2445
|
# The following operations are related to
|
2507
2446
|
# `DeleteBucketMetricsConfiguration`\:
|
2508
2447
|
#
|
2509
|
-
# *
|
2448
|
+
# * PutObjectTagging
|
2510
2449
|
#
|
2511
|
-
# *
|
2450
|
+
# * GetObjectTagging
|
2512
2451
|
#
|
2513
2452
|
#
|
2514
2453
|
#
|
2515
2454
|
# [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
|
2518
2455
|
#
|
2519
2456
|
# @option params [required, String] :bucket
|
2520
2457
|
# The bucket name containing the objects from which to remove the tags.
|
@@ -2628,24 +2565,19 @@ module Aws::S3
|
|
2628
2565
|
#
|
2629
2566
|
# The following operations are related to `DeleteObjects`\:
|
2630
2567
|
#
|
2631
|
-
# *
|
2568
|
+
# * CreateMultipartUpload
|
2632
2569
|
#
|
2633
|
-
# *
|
2570
|
+
# * UploadPart
|
2634
2571
|
#
|
2635
|
-
# *
|
2572
|
+
# * CompleteMultipartUpload
|
2636
2573
|
#
|
2637
|
-
# *
|
2574
|
+
# * ListParts
|
2638
2575
|
#
|
2639
|
-
# *
|
2576
|
+
# * AbortMultipartUpload
|
2640
2577
|
#
|
2641
2578
|
#
|
2642
2579
|
#
|
2643
2580
|
# [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
|
2649
2581
|
#
|
2650
2582
|
# @option params [required, String] :bucket
|
2651
2583
|
# The bucket name containing the objects to delete.
|
@@ -2694,22 +2626,20 @@ module Aws::S3
|
|
2694
2626
|
# * {Types::DeleteObjectsOutput#errors #errors} => Array<Types::Error>
|
2695
2627
|
#
|
2696
2628
|
#
|
2697
|
-
# @example Example: To delete multiple
|
2629
|
+
# @example Example: To delete multiple objects from a versioned bucket
|
2698
2630
|
#
|
2699
|
-
# # The following example deletes objects from a bucket. The
|
2700
|
-
# #
|
2631
|
+
# # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
|
2632
|
+
# # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
|
2701
2633
|
#
|
2702
2634
|
# resp = client.delete_objects({
|
2703
2635
|
# bucket: "examplebucket",
|
2704
2636
|
# delete: {
|
2705
2637
|
# objects: [
|
2706
2638
|
# {
|
2707
|
-
# key: "
|
2708
|
-
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
2639
|
+
# key: "objectkey1",
|
2709
2640
|
# },
|
2710
2641
|
# {
|
2711
|
-
# key: "
|
2712
|
-
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
2642
|
+
# key: "objectkey2",
|
2713
2643
|
# },
|
2714
2644
|
# ],
|
2715
2645
|
# quiet: false,
|
@@ -2720,30 +2650,34 @@ module Aws::S3
|
|
2720
2650
|
# {
|
2721
2651
|
# deleted: [
|
2722
2652
|
# {
|
2723
|
-
#
|
2724
|
-
#
|
2653
|
+
# delete_marker: true,
|
2654
|
+
# delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
|
2655
|
+
# key: "objectkey1",
|
2725
2656
|
# },
|
2726
2657
|
# {
|
2727
|
-
#
|
2728
|
-
#
|
2658
|
+
# delete_marker: true,
|
2659
|
+
# delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
|
2660
|
+
# key: "objectkey2",
|
2729
2661
|
# },
|
2730
2662
|
# ],
|
2731
2663
|
# }
|
2732
2664
|
#
|
2733
|
-
# @example Example: To delete multiple
|
2665
|
+
# @example Example: To delete multiple object versions from a versioned bucket
|
2734
2666
|
#
|
2735
|
-
# # The following example deletes objects from a bucket. The
|
2736
|
-
# #
|
2667
|
+
# # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
|
2668
|
+
# # versions and returns the key and versions of deleted objects in the response.
|
2737
2669
|
#
|
2738
2670
|
# resp = client.delete_objects({
|
2739
2671
|
# bucket: "examplebucket",
|
2740
2672
|
# delete: {
|
2741
2673
|
# objects: [
|
2742
2674
|
# {
|
2743
|
-
# key: "
|
2675
|
+
# key: "HappyFace.jpg",
|
2676
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
2744
2677
|
# },
|
2745
2678
|
# {
|
2746
|
-
# key: "
|
2679
|
+
# key: "HappyFace.jpg",
|
2680
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
2747
2681
|
# },
|
2748
2682
|
# ],
|
2749
2683
|
# quiet: false,
|
@@ -2754,14 +2688,12 @@ module Aws::S3
|
|
2754
2688
|
# {
|
2755
2689
|
# deleted: [
|
2756
2690
|
# {
|
2757
|
-
#
|
2758
|
-
#
|
2759
|
-
# key: "objectkey1",
|
2691
|
+
# key: "HappyFace.jpg",
|
2692
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
2760
2693
|
# },
|
2761
2694
|
# {
|
2762
|
-
#
|
2763
|
-
#
|
2764
|
-
# key: "objectkey2",
|
2695
|
+
# key: "HappyFace.jpg",
|
2696
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
2765
2697
|
# },
|
2766
2698
|
# ],
|
2767
2699
|
# }
|
@@ -2818,20 +2750,17 @@ module Aws::S3
|
|
2818
2750
|
#
|
2819
2751
|
# * [Using Amazon S3 Block Public Access][3]
|
2820
2752
|
#
|
2821
|
-
# *
|
2753
|
+
# * GetPublicAccessBlock
|
2822
2754
|
#
|
2823
|
-
# *
|
2755
|
+
# * PutPublicAccessBlock
|
2824
2756
|
#
|
2825
|
-
# *
|
2757
|
+
# * GetBucketPolicyStatus
|
2826
2758
|
#
|
2827
2759
|
#
|
2828
2760
|
#
|
2829
2761
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2830
2762
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2831
2763
|
# [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
|
2835
2764
|
#
|
2836
2765
|
# @option params [required, String] :bucket
|
2837
2766
|
# The Amazon S3 bucket whose `PublicAccessBlock` configuration you want
|
@@ -2869,19 +2798,19 @@ module Aws::S3
|
|
2869
2798
|
# Storage Service Developer Guide*.
|
2870
2799
|
#
|
2871
2800
|
# You set the Transfer Acceleration state of an existing bucket to
|
2872
|
-
# `Enabled` or `Suspended` by using the
|
2873
|
-
#
|
2801
|
+
# `Enabled` or `Suspended` by using the PutBucketAccelerateConfiguration
|
2802
|
+
# operation.
|
2874
2803
|
#
|
2875
2804
|
# A GET `accelerate` request does not return a state value for a bucket
|
2876
2805
|
# that has no transfer acceleration state. A bucket has no Transfer
|
2877
2806
|
# Acceleration state if a state has never been set on the bucket.
|
2878
2807
|
#
|
2879
2808
|
# For more information about transfer acceleration, see [Transfer
|
2880
|
-
# Acceleration][
|
2809
|
+
# Acceleration][3] in the Amazon Simple Storage Service Developer Guide.
|
2881
2810
|
#
|
2882
2811
|
# **Related Resources**
|
2883
2812
|
#
|
2884
|
-
# *
|
2813
|
+
# * PutBucketAccelerateConfiguration
|
2885
2814
|
#
|
2886
2815
|
# ^
|
2887
2816
|
#
|
@@ -2889,8 +2818,7 @@ module Aws::S3
|
|
2889
2818
|
#
|
2890
2819
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
2891
2820
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
2892
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
2893
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
|
2821
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
|
2894
2822
|
#
|
2895
2823
|
# @option params [required, String] :bucket
|
2896
2824
|
# Name of the bucket for which the accelerate configuration is
|
@@ -2928,14 +2856,9 @@ module Aws::S3
|
|
2928
2856
|
#
|
2929
2857
|
# **Related Resources**
|
2930
2858
|
#
|
2931
|
-
# *
|
2932
|
-
#
|
2859
|
+
# *
|
2933
2860
|
# ^
|
2934
2861
|
#
|
2935
|
-
#
|
2936
|
-
#
|
2937
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
|
2938
|
-
#
|
2939
2862
|
# @option params [required, String] :bucket
|
2940
2863
|
# Specifies the S3 bucket whose ACL is being requested.
|
2941
2864
|
#
|
@@ -2989,20 +2912,15 @@ module Aws::S3
|
|
2989
2912
|
#
|
2990
2913
|
# **Related Resources**
|
2991
2914
|
#
|
2992
|
-
# *
|
2993
|
-
#
|
2994
|
-
# *
|
2995
|
-
#
|
2996
|
-
# * [PutBucketAnalyticsConfiguration][6]
|
2915
|
+
# *
|
2916
|
+
# *
|
2917
|
+
# *
|
2997
2918
|
#
|
2998
2919
|
#
|
2999
2920
|
#
|
3000
2921
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3001
2922
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3002
2923
|
# [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
|
3006
2924
|
#
|
3007
2925
|
# @option params [required, String] :bucket
|
3008
2926
|
# The name of the bucket from which an analytics configuration is
|
@@ -3058,15 +2976,13 @@ module Aws::S3
|
|
3058
2976
|
#
|
3059
2977
|
# The following operations are related to `GetBucketCors`\:
|
3060
2978
|
#
|
3061
|
-
# *
|
2979
|
+
# * PutBucketCors
|
3062
2980
|
#
|
3063
|
-
# *
|
2981
|
+
# * DeleteBucketCors
|
3064
2982
|
#
|
3065
2983
|
#
|
3066
2984
|
#
|
3067
2985
|
# [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
|
3070
2986
|
#
|
3071
2987
|
# @option params [required, String] :bucket
|
3072
2988
|
# The bucket name for which to get the cors configuration.
|
@@ -3143,17 +3059,15 @@ module Aws::S3
|
|
3143
3059
|
#
|
3144
3060
|
# The following operations are related to `GetBucketEncryption`\:
|
3145
3061
|
#
|
3146
|
-
# *
|
3062
|
+
# * PutBucketEncryption
|
3147
3063
|
#
|
3148
|
-
# *
|
3064
|
+
# * DeleteBucketEncryption
|
3149
3065
|
#
|
3150
3066
|
#
|
3151
3067
|
#
|
3152
3068
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
3153
3069
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3154
3070
|
# [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
|
3157
3071
|
#
|
3158
3072
|
# @option params [required, String] :bucket
|
3159
3073
|
# The name of the bucket from which the server-side encryption
|
@@ -3200,20 +3114,17 @@ module Aws::S3
|
|
3200
3114
|
# The following operations are related to
|
3201
3115
|
# `GetBucketInventoryConfiguration`\:
|
3202
3116
|
#
|
3203
|
-
# *
|
3117
|
+
# * DeleteBucketInventoryConfiguration
|
3204
3118
|
#
|
3205
|
-
# *
|
3119
|
+
# * ListBucketInventoryConfigurations
|
3206
3120
|
#
|
3207
|
-
# *
|
3121
|
+
# * PutBucketInventoryConfiguration
|
3208
3122
|
#
|
3209
3123
|
#
|
3210
3124
|
#
|
3211
3125
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3212
3126
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3213
3127
|
# [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
|
3217
3128
|
#
|
3218
3129
|
# @option params [required, String] :bucket
|
3219
3130
|
# The name of the bucket containing the inventory configuration to
|
@@ -3258,21 +3169,20 @@ module Aws::S3
|
|
3258
3169
|
end
|
3259
3170
|
|
3260
3171
|
# For an updated version of this API, see
|
3261
|
-
#
|
3262
|
-
#
|
3263
|
-
#
|
3264
|
-
# compatibility.
|
3172
|
+
# GetBucketLifecycleConfiguration. If you configured a bucket lifecycle
|
3173
|
+
# using the `filter` element, you should see the updated version of this
|
3174
|
+
# topic. This topic is provided for backward compatibility.
|
3265
3175
|
#
|
3266
3176
|
# Returns the lifecycle configuration information set on the bucket. For
|
3267
3177
|
# information about lifecycle configuration, see [Object Lifecycle
|
3268
|
-
# Management][
|
3178
|
+
# Management][1].
|
3269
3179
|
#
|
3270
3180
|
# To use this operation, you must have permission to perform the
|
3271
3181
|
# `s3:GetLifecycleConfiguration` action. The bucket owner has this
|
3272
3182
|
# permission by default. The bucket owner can grant this permission to
|
3273
3183
|
# others. For more information about permissions, see [Permissions
|
3274
|
-
# Related to Bucket Subresource Operations][
|
3275
|
-
# Permissions to Your Amazon S3 Resources][
|
3184
|
+
# Related to Bucket Subresource Operations][2] and [Managing Access
|
3185
|
+
# Permissions to Your Amazon S3 Resources][3].
|
3276
3186
|
#
|
3277
3187
|
# `GetBucketLifecycle` has the following special error:
|
3278
3188
|
#
|
@@ -3286,20 +3196,17 @@ module Aws::S3
|
|
3286
3196
|
#
|
3287
3197
|
# The following operations are related to `GetBucketLifecycle`\:
|
3288
3198
|
#
|
3289
|
-
# *
|
3199
|
+
# * GetBucketLifecycleConfiguration
|
3290
3200
|
#
|
3291
|
-
# *
|
3201
|
+
# * PutBucketLifecycle
|
3292
3202
|
#
|
3293
|
-
# *
|
3203
|
+
# * DeleteBucketLifecycle
|
3294
3204
|
#
|
3295
3205
|
#
|
3296
3206
|
#
|
3297
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3298
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
3299
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
3207
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
3208
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3209
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3303
3210
|
#
|
3304
3211
|
# @option params [required, String] :bucket
|
3305
3212
|
# The name of the bucket for which to get the lifecycle information.
|
@@ -3370,20 +3277,20 @@ module Aws::S3
|
|
3370
3277
|
# specify a filter to select a subset of objects to which the rule
|
3371
3278
|
# applies. If you are still using previous version of the lifecycle
|
3372
3279
|
# configuration, it works. For the earlier API description, see
|
3373
|
-
#
|
3280
|
+
# GetBucketLifecycle.
|
3374
3281
|
#
|
3375
3282
|
# </note>
|
3376
3283
|
#
|
3377
3284
|
# Returns the lifecycle configuration information set on the bucket. For
|
3378
3285
|
# information about lifecycle configuration, see [Object Lifecycle
|
3379
|
-
# Management][
|
3286
|
+
# Management][1].
|
3380
3287
|
#
|
3381
3288
|
# To use this operation, you must have permission to perform the
|
3382
3289
|
# `s3:GetLifecycleConfiguration` action. The bucket owner has this
|
3383
3290
|
# permission, by default. The bucket owner can grant this permission to
|
3384
3291
|
# others. For more information about permissions, see [Permissions
|
3385
|
-
# Related to Bucket Subresource Operations][
|
3386
|
-
# Permissions to Your Amazon S3 Resources][
|
3292
|
+
# Related to Bucket Subresource Operations][2] and [Managing Access
|
3293
|
+
# Permissions to Your Amazon S3 Resources][3].
|
3387
3294
|
#
|
3388
3295
|
# `GetBucketLifecycleConfiguration` has the following special error:
|
3389
3296
|
#
|
@@ -3398,20 +3305,17 @@ module Aws::S3
|
|
3398
3305
|
# The following operations are related to
|
3399
3306
|
# `GetBucketLifecycleConfiguration`\:
|
3400
3307
|
#
|
3401
|
-
# *
|
3308
|
+
# * GetBucketLifecycle
|
3402
3309
|
#
|
3403
|
-
# *
|
3310
|
+
# * PutBucketLifecycle
|
3404
3311
|
#
|
3405
|
-
# *
|
3312
|
+
# * DeleteBucketLifecycle
|
3406
3313
|
#
|
3407
3314
|
#
|
3408
3315
|
#
|
3409
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3410
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
3411
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
3316
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
3317
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3318
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3415
3319
|
#
|
3416
3320
|
# @option params [required, String] :bucket
|
3417
3321
|
# The name of the bucket for which to get the lifecycle information.
|
@@ -3489,21 +3393,16 @@ module Aws::S3
|
|
3489
3393
|
|
3490
3394
|
# Returns the Region the bucket resides in. You set the bucket's Region
|
3491
3395
|
# using the `LocationConstraint` request parameter in a `CreateBucket`
|
3492
|
-
# request. For more information, see
|
3396
|
+
# request. For more information, see CreateBucket.
|
3493
3397
|
#
|
3494
3398
|
# To use this implementation of the operation, you must be the bucket
|
3495
3399
|
# owner.
|
3496
3400
|
#
|
3497
3401
|
# The following operations are related to `GetBucketLocation`\:
|
3498
3402
|
#
|
3499
|
-
# *
|
3500
|
-
#
|
3501
|
-
# * [CreateBucket][1]
|
3403
|
+
# * GetObject
|
3502
3404
|
#
|
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
|
3405
|
+
# * CreateBucket
|
3507
3406
|
#
|
3508
3407
|
# @option params [required, String] :bucket
|
3509
3408
|
# The name of the bucket for which to get the location.
|
@@ -3534,7 +3433,7 @@ module Aws::S3
|
|
3534
3433
|
#
|
3535
3434
|
# @example Response structure
|
3536
3435
|
#
|
3537
|
-
# resp.location_constraint #=> String, one of "
|
3436
|
+
# resp.location_constraint #=> String, one of "af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "ap-south-1", "ap-southeast-1", "ap-southeast-2", "ca-central-1", "cn-north-1", "cn-northwest-1", "EU", "eu-central-1", "eu-north-1", "eu-south-1", "eu-west-1", "eu-west-2", "eu-west-3", "me-south-1", "sa-east-1", "us-east-2", "us-gov-east-1", "us-gov-west-1", "us-west-1", "us-west-2"
|
3538
3437
|
#
|
3539
3438
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation AWS API Documentation
|
3540
3439
|
#
|
@@ -3551,14 +3450,9 @@ module Aws::S3
|
|
3551
3450
|
#
|
3552
3451
|
# The following operations are related to `GetBucketLogging`\:
|
3553
3452
|
#
|
3554
|
-
# *
|
3555
|
-
#
|
3556
|
-
# * [PutBucketLogging][2]
|
3453
|
+
# * CreateBucket
|
3557
3454
|
#
|
3558
|
-
#
|
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
|
3455
|
+
# * PutBucketLogging
|
3562
3456
|
#
|
3563
3457
|
# @option params [required, String] :bucket
|
3564
3458
|
# The bucket name for which to get the logging information.
|
@@ -3611,11 +3505,11 @@ module Aws::S3
|
|
3611
3505
|
# The following operations are related to
|
3612
3506
|
# `GetBucketMetricsConfiguration`\:
|
3613
3507
|
#
|
3614
|
-
# *
|
3508
|
+
# * PutBucketMetricsConfiguration
|
3615
3509
|
#
|
3616
|
-
# *
|
3510
|
+
# * DeleteBucketMetricsConfiguration
|
3617
3511
|
#
|
3618
|
-
# *
|
3512
|
+
# * ListBucketMetricsConfigurations
|
3619
3513
|
#
|
3620
3514
|
# * [Monitoring Metrics with Amazon CloudWatch][3]
|
3621
3515
|
#
|
@@ -3624,9 +3518,6 @@ module Aws::S3
|
|
3624
3518
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
3625
3519
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
3626
3520
|
# [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
|
3630
3521
|
#
|
3631
3522
|
# @option params [required, String] :bucket
|
3632
3523
|
# The name of the bucket containing the metrics configuration to
|
@@ -3666,11 +3557,7 @@ module Aws::S3
|
|
3666
3557
|
req.send_request(options)
|
3667
3558
|
end
|
3668
3559
|
|
3669
|
-
# No longer used, see
|
3670
|
-
#
|
3671
|
-
#
|
3672
|
-
#
|
3673
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html
|
3560
|
+
# No longer used, see GetBucketNotificationConfiguration.
|
3674
3561
|
#
|
3675
3562
|
# @option params [required, String] :bucket
|
3676
3563
|
# Name of the bucket for which to get the notification configuration.
|
@@ -3789,7 +3676,7 @@ module Aws::S3
|
|
3789
3676
|
#
|
3790
3677
|
# The following operation is related to `GetBucketNotification`\:
|
3791
3678
|
#
|
3792
|
-
# *
|
3679
|
+
# * PutBucketNotification
|
3793
3680
|
#
|
3794
3681
|
# ^
|
3795
3682
|
#
|
@@ -3797,7 +3684,6 @@ module Aws::S3
|
|
3797
3684
|
#
|
3798
3685
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
3799
3686
|
# [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
|
3801
3687
|
#
|
3802
3688
|
# @option params [required, String] :bucket
|
3803
3689
|
# Name of the bucket for which to get the notification configuration.
|
@@ -3870,14 +3756,13 @@ module Aws::S3
|
|
3870
3756
|
#
|
3871
3757
|
# The following operation is related to `GetBucketPolicy`\:
|
3872
3758
|
#
|
3873
|
-
# *
|
3759
|
+
# * GetObject
|
3874
3760
|
#
|
3875
3761
|
# ^
|
3876
3762
|
#
|
3877
3763
|
#
|
3878
3764
|
#
|
3879
3765
|
# [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
|
3881
3766
|
#
|
3882
3767
|
# @option params [required, String] :bucket
|
3883
3768
|
# The bucket name for which to get the bucket policy.
|
@@ -3932,20 +3817,17 @@ module Aws::S3
|
|
3932
3817
|
#
|
3933
3818
|
# * [Using Amazon S3 Block Public Access][3]
|
3934
3819
|
#
|
3935
|
-
# *
|
3820
|
+
# * GetPublicAccessBlock
|
3936
3821
|
#
|
3937
|
-
# *
|
3822
|
+
# * PutPublicAccessBlock
|
3938
3823
|
#
|
3939
|
-
# *
|
3824
|
+
# * DeletePublicAccessBlock
|
3940
3825
|
#
|
3941
3826
|
#
|
3942
3827
|
#
|
3943
3828
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
3944
3829
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
|
3945
3830
|
# [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
|
3949
3831
|
#
|
3950
3832
|
# @option params [required, String] :bucket
|
3951
3833
|
# The name of the Amazon S3 bucket whose policy status you want to
|
@@ -3993,22 +3875,19 @@ module Aws::S3
|
|
3993
3875
|
# you must also include the `DeleteMarkerReplication` and `Priority`
|
3994
3876
|
# elements. The response also returns those elements.
|
3995
3877
|
#
|
3996
|
-
# For information about `GetBucketReplication` errors, see
|
3997
|
-
#
|
3878
|
+
# For information about `GetBucketReplication` errors, see
|
3879
|
+
# ReplicationErrorCodeList
|
3998
3880
|
#
|
3999
3881
|
# The following operations are related to `GetBucketReplication`\:
|
4000
3882
|
#
|
4001
|
-
# *
|
3883
|
+
# * PutBucketReplication
|
4002
3884
|
#
|
4003
|
-
# *
|
3885
|
+
# * DeleteBucketReplication
|
4004
3886
|
#
|
4005
3887
|
#
|
4006
3888
|
#
|
4007
3889
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
|
4008
3890
|
# [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
|
4012
3891
|
#
|
4013
3892
|
# @option params [required, String] :bucket
|
4014
3893
|
# The bucket name for which to get the replication information.
|
@@ -4092,14 +3971,13 @@ module Aws::S3
|
|
4092
3971
|
#
|
4093
3972
|
# The following operations are related to `GetBucketRequestPayment`\:
|
4094
3973
|
#
|
4095
|
-
# *
|
3974
|
+
# * ListObjects
|
4096
3975
|
#
|
4097
3976
|
# ^
|
4098
3977
|
#
|
4099
3978
|
#
|
4100
3979
|
#
|
4101
3980
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
|
4102
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
|
4103
3981
|
#
|
4104
3982
|
# @option params [required, String] :bucket
|
4105
3983
|
# The name of the bucket for which to get the payment request
|
@@ -4158,14 +4036,9 @@ module Aws::S3
|
|
4158
4036
|
#
|
4159
4037
|
# The following operations are related to `GetBucketTagging`\:
|
4160
4038
|
#
|
4161
|
-
# *
|
4162
|
-
#
|
4163
|
-
# * [DeleteBucketTagging][2]
|
4039
|
+
# * PutBucketTagging
|
4164
4040
|
#
|
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
|
4041
|
+
# * DeleteBucketTagging
|
4169
4042
|
#
|
4170
4043
|
# @option params [required, String] :bucket
|
4171
4044
|
# The name of the bucket for which to get the tagging information.
|
@@ -4230,17 +4103,11 @@ module Aws::S3
|
|
4230
4103
|
#
|
4231
4104
|
# The following operations are related to `GetBucketVersioning`\:
|
4232
4105
|
#
|
4233
|
-
# *
|
4234
|
-
#
|
4235
|
-
# * [PutObject][2]
|
4106
|
+
# * GetObject
|
4236
4107
|
#
|
4237
|
-
# *
|
4108
|
+
# * PutObject
|
4238
4109
|
#
|
4239
|
-
#
|
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
|
4110
|
+
# * DeleteObject
|
4244
4111
|
#
|
4245
4112
|
# @option params [required, String] :bucket
|
4246
4113
|
# The name of the bucket for which to get the versioning information.
|
@@ -4298,15 +4165,13 @@ module Aws::S3
|
|
4298
4165
|
#
|
4299
4166
|
# The following operations are related to `DeleteBucketWebsite`\:
|
4300
4167
|
#
|
4301
|
-
# *
|
4168
|
+
# * DeleteBucketWebsite
|
4302
4169
|
#
|
4303
|
-
# *
|
4170
|
+
# * PutBucketWebsite
|
4304
4171
|
#
|
4305
4172
|
#
|
4306
4173
|
#
|
4307
4174
|
# [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
|
4310
4175
|
#
|
4311
4176
|
# @option params [required, String] :bucket
|
4312
4177
|
# The bucket name for which to get the website configuration.
|
@@ -4390,13 +4255,13 @@ module Aws::S3
|
|
4390
4255
|
# To distribute large files to many people, you can save bandwidth costs
|
4391
4256
|
# by using BitTorrent. For more information, see [Amazon S3 Torrent][2].
|
4392
4257
|
# For more information about returning the ACL of an object, see
|
4393
|
-
#
|
4258
|
+
# GetObjectAcl.
|
4394
4259
|
#
|
4395
4260
|
# If the object you are retrieving is stored in the GLACIER or
|
4396
4261
|
# DEEP\_ARCHIVE storage classes, before you can retrieve the object you
|
4397
|
-
# must first restore a copy using
|
4398
|
-
#
|
4399
|
-
#
|
4262
|
+
# must first restore a copy using . Otherwise, this operation returns an
|
4263
|
+
# `InvalidObjectStateError` error. For information about restoring
|
4264
|
+
# archived objects, see [Restoring Archived Objects][3].
|
4400
4265
|
#
|
4401
4266
|
# Encryption request headers, like `x-amz-server-side-encryption`,
|
4402
4267
|
# should not be sent for GET requests if your object uses server-side
|
@@ -4410,25 +4275,25 @@ module Aws::S3
|
|
4410
4275
|
# Amazon S3, then when you GET the object, you must use the following
|
4411
4276
|
# headers:
|
4412
4277
|
#
|
4413
|
-
# * x-amz-server-side
|
4278
|
+
# * x-amz-server-side-encryption-customer-algorithm
|
4414
4279
|
#
|
4415
|
-
# * x-amz-server-side
|
4280
|
+
# * x-amz-server-side-encryption-customer-key
|
4416
4281
|
#
|
4417
|
-
# * x-amz-server-side
|
4282
|
+
# * x-amz-server-side-encryption-customer-key-MD5
|
4418
4283
|
#
|
4419
4284
|
# For more information about SSE-C, see [Server-Side Encryption (Using
|
4420
|
-
# Customer-Provided Encryption Keys)][
|
4285
|
+
# Customer-Provided Encryption Keys)][4].
|
4421
4286
|
#
|
4422
4287
|
# Assuming you have permission to read object tags (permission for the
|
4423
4288
|
# `s3:GetObjectVersionTagging` action), the response also returns the
|
4424
4289
|
# `x-amz-tagging-count` header that provides the count of number of tags
|
4425
|
-
# associated with the object. You can use
|
4426
|
-
#
|
4290
|
+
# associated with the object. You can use GetObjectTagging to retrieve
|
4291
|
+
# the tag set associated with an object.
|
4427
4292
|
#
|
4428
4293
|
# **Permissions**
|
4429
4294
|
#
|
4430
4295
|
# You need the `s3:GetObject` permission for this operation. For more
|
4431
|
-
# information, see [Specifying Permissions in a Policy][
|
4296
|
+
# information, see [Specifying Permissions in a Policy][5]. If the
|
4432
4297
|
# object you request does not exist, the error Amazon S3 returns depends
|
4433
4298
|
# on whether you also have the `s3:ListBucket` permission.
|
4434
4299
|
#
|
@@ -4450,7 +4315,7 @@ module Aws::S3
|
|
4450
4315
|
#
|
4451
4316
|
# </note>
|
4452
4317
|
#
|
4453
|
-
# For more information about versioning, see
|
4318
|
+
# For more information about versioning, see PutBucketVersioning.
|
4454
4319
|
#
|
4455
4320
|
# **Overriding Response Header Values**
|
4456
4321
|
#
|
@@ -4499,27 +4364,22 @@ module Aws::S3
|
|
4499
4364
|
# to `false`, and; `If-Modified-Since` condition evaluates to `true`;
|
4500
4365
|
# then, S3 returns 304 Not Modified response code.
|
4501
4366
|
#
|
4502
|
-
# For more information about conditional requests, see [RFC 7232][
|
4367
|
+
# For more information about conditional requests, see [RFC 7232][6].
|
4503
4368
|
#
|
4504
4369
|
# The following operations are related to `GetObject`\:
|
4505
4370
|
#
|
4506
|
-
# *
|
4371
|
+
# * ListBuckets
|
4507
4372
|
#
|
4508
|
-
# *
|
4373
|
+
# * GetObjectAcl
|
4509
4374
|
#
|
4510
4375
|
#
|
4511
4376
|
#
|
4512
4377
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
|
4513
4378
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3Torrent.html
|
4514
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4515
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4516
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
4517
|
-
# [6]: https://
|
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
|
4379
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
|
4380
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
4381
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
4382
|
+
# [6]: https://tools.ietf.org/html/rfc7232
|
4523
4383
|
#
|
4524
4384
|
# @option params [String, IO] :response_target
|
4525
4385
|
# Where to write response data, file path, or IO object.
|
@@ -4602,7 +4462,7 @@ module Aws::S3
|
|
4602
4462
|
# encrypting data. This value is used to store the object and then it is
|
4603
4463
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
4604
4464
|
# be appropriate for use with the algorithm specified in the
|
4605
|
-
# `x-amz-server-side
|
4465
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
4606
4466
|
#
|
4607
4467
|
# @option params [String] :sse_customer_key_md5
|
4608
4468
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -4662,49 +4522,49 @@ module Aws::S3
|
|
4662
4522
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
4663
4523
|
#
|
4664
4524
|
#
|
4665
|
-
# @example Example: To retrieve
|
4525
|
+
# @example Example: To retrieve an object
|
4666
4526
|
#
|
4667
|
-
# # The following example retrieves an object for an S3 bucket.
|
4668
|
-
# # specific byte range.
|
4527
|
+
# # The following example retrieves an object for an S3 bucket.
|
4669
4528
|
#
|
4670
4529
|
# resp = client.get_object({
|
4671
4530
|
# bucket: "examplebucket",
|
4672
|
-
# key: "
|
4673
|
-
# range: "bytes=0-9",
|
4531
|
+
# key: "HappyFace.jpg",
|
4674
4532
|
# })
|
4675
4533
|
#
|
4676
4534
|
# resp.to_h outputs the following:
|
4677
4535
|
# {
|
4678
4536
|
# accept_ranges: "bytes",
|
4679
|
-
# content_length:
|
4680
|
-
#
|
4681
|
-
#
|
4682
|
-
#
|
4683
|
-
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
4537
|
+
# content_length: 3191,
|
4538
|
+
# content_type: "image/jpeg",
|
4539
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
4540
|
+
# last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
|
4684
4541
|
# metadata: {
|
4685
4542
|
# },
|
4543
|
+
# tag_count: 2,
|
4686
4544
|
# version_id: "null",
|
4687
4545
|
# }
|
4688
4546
|
#
|
4689
|
-
# @example Example: To retrieve an object
|
4547
|
+
# @example Example: To retrieve a byte range of an object
|
4690
4548
|
#
|
4691
|
-
# # The following example retrieves an object for an S3 bucket.
|
4549
|
+
# # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
|
4550
|
+
# # specific byte range.
|
4692
4551
|
#
|
4693
4552
|
# resp = client.get_object({
|
4694
4553
|
# bucket: "examplebucket",
|
4695
|
-
# key: "
|
4554
|
+
# key: "SampleFile.txt",
|
4555
|
+
# range: "bytes=0-9",
|
4696
4556
|
# })
|
4697
4557
|
#
|
4698
4558
|
# resp.to_h outputs the following:
|
4699
4559
|
# {
|
4700
4560
|
# accept_ranges: "bytes",
|
4701
|
-
# content_length:
|
4702
|
-
#
|
4703
|
-
#
|
4704
|
-
#
|
4561
|
+
# content_length: 10,
|
4562
|
+
# content_range: "bytes 0-9/43",
|
4563
|
+
# content_type: "text/plain",
|
4564
|
+
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
4565
|
+
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
4705
4566
|
# metadata: {
|
4706
4567
|
# },
|
4707
|
-
# tag_count: 2,
|
4708
4568
|
# version_id: "null",
|
4709
4569
|
# }
|
4710
4570
|
#
|
@@ -4817,17 +4677,11 @@ module Aws::S3
|
|
4817
4677
|
#
|
4818
4678
|
# The following operations are related to `GetObjectAcl`\:
|
4819
4679
|
#
|
4820
|
-
# *
|
4821
|
-
#
|
4822
|
-
# * [DeleteObject][2]
|
4823
|
-
#
|
4824
|
-
# * [PutObject][3]
|
4825
|
-
#
|
4680
|
+
# * GetObject
|
4826
4681
|
#
|
4682
|
+
# * DeleteObject
|
4827
4683
|
#
|
4828
|
-
#
|
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
|
4684
|
+
# * PutObject
|
4831
4685
|
#
|
4832
4686
|
# @option params [required, String] :bucket
|
4833
4687
|
# The bucket name that contains the object for which to get the ACL
|
@@ -5144,14 +4998,13 @@ module Aws::S3
|
|
5144
4998
|
#
|
5145
4999
|
# The following operation is related to `GetObjectTagging`\:
|
5146
5000
|
#
|
5147
|
-
# *
|
5001
|
+
# * PutObjectTagging
|
5148
5002
|
#
|
5149
5003
|
# ^
|
5150
5004
|
#
|
5151
5005
|
#
|
5152
5006
|
#
|
5153
5007
|
# [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
|
5155
5008
|
#
|
5156
5009
|
# @option params [required, String] :bucket
|
5157
5010
|
# The bucket name containing the object for which to get the tagging
|
@@ -5181,49 +5034,49 @@ module Aws::S3
|
|
5181
5034
|
# * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
|
5182
5035
|
#
|
5183
5036
|
#
|
5184
|
-
# @example Example: To retrieve tag set of
|
5037
|
+
# @example Example: To retrieve tag set of a specific object version
|
5185
5038
|
#
|
5186
|
-
# # The following example retrieves tag set of an object.
|
5039
|
+
# # The following example retrieves tag set of an object. The request specifies object version.
|
5187
5040
|
#
|
5188
5041
|
# resp = client.get_object_tagging({
|
5189
5042
|
# bucket: "examplebucket",
|
5190
|
-
# key: "
|
5043
|
+
# key: "exampleobject",
|
5044
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5191
5045
|
# })
|
5192
5046
|
#
|
5193
5047
|
# resp.to_h outputs the following:
|
5194
5048
|
# {
|
5195
5049
|
# tag_set: [
|
5196
5050
|
# {
|
5197
|
-
# key: "
|
5198
|
-
# value: "
|
5199
|
-
# },
|
5200
|
-
# {
|
5201
|
-
# key: "Key3",
|
5202
|
-
# value: "Value3",
|
5051
|
+
# key: "Key1",
|
5052
|
+
# value: "Value1",
|
5203
5053
|
# },
|
5204
5054
|
# ],
|
5205
|
-
# version_id: "
|
5055
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5206
5056
|
# }
|
5207
5057
|
#
|
5208
|
-
# @example Example: To retrieve tag set of
|
5058
|
+
# @example Example: To retrieve tag set of an object
|
5209
5059
|
#
|
5210
|
-
# # The following example retrieves tag set of an object.
|
5060
|
+
# # The following example retrieves tag set of an object.
|
5211
5061
|
#
|
5212
5062
|
# resp = client.get_object_tagging({
|
5213
5063
|
# bucket: "examplebucket",
|
5214
|
-
# key: "
|
5215
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5064
|
+
# key: "HappyFace.jpg",
|
5216
5065
|
# })
|
5217
5066
|
#
|
5218
5067
|
# resp.to_h outputs the following:
|
5219
5068
|
# {
|
5220
5069
|
# tag_set: [
|
5221
5070
|
# {
|
5222
|
-
# key: "
|
5223
|
-
# value: "
|
5071
|
+
# key: "Key4",
|
5072
|
+
# value: "Value4",
|
5073
|
+
# },
|
5074
|
+
# {
|
5075
|
+
# key: "Key3",
|
5076
|
+
# value: "Value3",
|
5224
5077
|
# },
|
5225
5078
|
# ],
|
5226
|
-
# version_id: "
|
5079
|
+
# version_id: "null",
|
5227
5080
|
# }
|
5228
5081
|
#
|
5229
5082
|
# @example Request syntax with placeholder values
|
@@ -5264,14 +5117,13 @@ module Aws::S3
|
|
5264
5117
|
#
|
5265
5118
|
# The following operation is related to `GetObjectTorrent`\:
|
5266
5119
|
#
|
5267
|
-
# *
|
5120
|
+
# * GetObject
|
5268
5121
|
#
|
5269
5122
|
# ^
|
5270
5123
|
#
|
5271
5124
|
#
|
5272
5125
|
#
|
5273
5126
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3Torrent.html
|
5274
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
5275
5127
|
#
|
5276
5128
|
# @option params [String, IO] :response_target
|
5277
5129
|
# Where to write response data, file path, or IO object.
|
@@ -5355,20 +5207,17 @@ module Aws::S3
|
|
5355
5207
|
#
|
5356
5208
|
# * [Using Amazon S3 Block Public Access][3]
|
5357
5209
|
#
|
5358
|
-
# *
|
5210
|
+
# * PutPublicAccessBlock
|
5359
5211
|
#
|
5360
|
-
# *
|
5212
|
+
# * GetPublicAccessBlock
|
5361
5213
|
#
|
5362
|
-
# *
|
5214
|
+
# * DeletePublicAccessBlock
|
5363
5215
|
#
|
5364
5216
|
#
|
5365
5217
|
#
|
5366
5218
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
5367
5219
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
|
5368
5220
|
# [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
|
5372
5221
|
#
|
5373
5222
|
# @option params [required, String] :bucket
|
5374
5223
|
# The name of the Amazon S3 bucket whose `PublicAccessBlock`
|
@@ -5467,11 +5316,11 @@ module Aws::S3
|
|
5467
5316
|
# Amazon S3, then when you retrieve the metadata from the object, you
|
5468
5317
|
# must use the following headers:
|
5469
5318
|
#
|
5470
|
-
# * x-amz-server-side
|
5319
|
+
# * x-amz-server-side-encryption-customer-algorithm
|
5471
5320
|
#
|
5472
|
-
# * x-amz-server-side
|
5321
|
+
# * x-amz-server-side-encryption-customer-key
|
5473
5322
|
#
|
5474
|
-
# * x-amz-server-side
|
5323
|
+
# * x-amz-server-side-encryption-customer-key-MD5
|
5475
5324
|
#
|
5476
5325
|
# For more information about SSE-C, see [Server-Side Encryption (Using
|
5477
5326
|
# Customer-Provided Encryption Keys)][1].
|
@@ -5525,7 +5374,7 @@ module Aws::S3
|
|
5525
5374
|
#
|
5526
5375
|
# The following operation is related to `HeadObject`\:
|
5527
5376
|
#
|
5528
|
-
# *
|
5377
|
+
# * GetObject
|
5529
5378
|
#
|
5530
5379
|
# ^
|
5531
5380
|
#
|
@@ -5535,7 +5384,6 @@ module Aws::S3
|
|
5535
5384
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html
|
5536
5385
|
# [3]: https://tools.ietf.org/html/rfc7232
|
5537
5386
|
# [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
|
5539
5387
|
#
|
5540
5388
|
# @option params [required, String] :bucket
|
5541
5389
|
# The name of the bucket containing the object.
|
@@ -5581,7 +5429,7 @@ module Aws::S3
|
|
5581
5429
|
# encrypting data. This value is used to store the object and then it is
|
5582
5430
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
5583
5431
|
# be appropriate for use with the algorithm specified in the
|
5584
|
-
# `x-amz-server-side
|
5432
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
5585
5433
|
#
|
5586
5434
|
# @option params [String] :sse_customer_key_md5
|
5587
5435
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -5751,20 +5599,17 @@ module Aws::S3
|
|
5751
5599
|
# The following operations are related to
|
5752
5600
|
# `ListBucketAnalyticsConfigurations`\:
|
5753
5601
|
#
|
5754
|
-
# *
|
5602
|
+
# * GetBucketAnalyticsConfiguration
|
5755
5603
|
#
|
5756
|
-
# *
|
5604
|
+
# * DeleteBucketAnalyticsConfiguration
|
5757
5605
|
#
|
5758
|
-
# *
|
5606
|
+
# * PutBucketAnalyticsConfiguration
|
5759
5607
|
#
|
5760
5608
|
#
|
5761
5609
|
#
|
5762
5610
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
5763
5611
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
5764
5612
|
# [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
|
5768
5613
|
#
|
5769
5614
|
# @option params [required, String] :bucket
|
5770
5615
|
# The name of the bucket from which analytics configurations are
|
@@ -5842,20 +5687,17 @@ module Aws::S3
|
|
5842
5687
|
# The following operations are related to
|
5843
5688
|
# `ListBucketInventoryConfigurations`\:
|
5844
5689
|
#
|
5845
|
-
# *
|
5690
|
+
# * GetBucketInventoryConfiguration
|
5846
5691
|
#
|
5847
|
-
# *
|
5692
|
+
# * DeleteBucketInventoryConfiguration
|
5848
5693
|
#
|
5849
|
-
# *
|
5694
|
+
# * PutBucketInventoryConfiguration
|
5850
5695
|
#
|
5851
5696
|
#
|
5852
5697
|
#
|
5853
5698
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
5854
5699
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
5855
5700
|
# [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
|
5859
5701
|
#
|
5860
5702
|
# @option params [required, String] :bucket
|
5861
5703
|
# The name of the bucket containing the inventory configurations to
|
@@ -5936,20 +5778,17 @@ module Aws::S3
|
|
5936
5778
|
# The following operations are related to
|
5937
5779
|
# `ListBucketMetricsConfigurations`\:
|
5938
5780
|
#
|
5939
|
-
# *
|
5781
|
+
# * PutBucketMetricsConfiguration
|
5940
5782
|
#
|
5941
|
-
# *
|
5783
|
+
# * GetBucketMetricsConfiguration
|
5942
5784
|
#
|
5943
|
-
# *
|
5785
|
+
# * DeleteBucketMetricsConfiguration
|
5944
5786
|
#
|
5945
5787
|
#
|
5946
5788
|
#
|
5947
5789
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
5948
5790
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
5949
5791
|
# [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
|
5953
5792
|
#
|
5954
5793
|
# @option params [required, String] :bucket
|
5955
5794
|
# The name of the bucket containing the metrics configurations to
|
@@ -6085,25 +5924,20 @@ module Aws::S3
|
|
6085
5924
|
#
|
6086
5925
|
# The following operations are related to `ListMultipartUploads`\:
|
6087
5926
|
#
|
6088
|
-
# *
|
5927
|
+
# * CreateMultipartUpload
|
6089
5928
|
#
|
6090
|
-
# *
|
5929
|
+
# * UploadPart
|
6091
5930
|
#
|
6092
|
-
# *
|
5931
|
+
# * CompleteMultipartUpload
|
6093
5932
|
#
|
6094
|
-
# *
|
5933
|
+
# * ListParts
|
6095
5934
|
#
|
6096
|
-
# *
|
5935
|
+
# * AbortMultipartUpload
|
6097
5936
|
#
|
6098
5937
|
#
|
6099
5938
|
#
|
6100
5939
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
6101
5940
|
# [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
|
6107
5941
|
#
|
6108
5942
|
# @option params [required, String] :bucket
|
6109
5943
|
# Name of the bucket to which the multipart upload was initiated.
|
@@ -6188,97 +6022,97 @@ module Aws::S3
|
|
6188
6022
|
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
6189
6023
|
#
|
6190
6024
|
#
|
6191
|
-
# @example Example:
|
6025
|
+
# @example Example: List next set of multipart uploads when previous result is truncated
|
6192
6026
|
#
|
6193
|
-
# # The following example
|
6027
|
+
# # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
|
6028
|
+
# # setup of multipart uploads.
|
6194
6029
|
#
|
6195
6030
|
# resp = client.list_multipart_uploads({
|
6196
6031
|
# bucket: "examplebucket",
|
6032
|
+
# key_marker: "nextkeyfrompreviousresponse",
|
6033
|
+
# max_uploads: 2,
|
6034
|
+
# upload_id_marker: "valuefrompreviousresponse",
|
6197
6035
|
# })
|
6198
6036
|
#
|
6199
6037
|
# resp.to_h outputs the following:
|
6200
6038
|
# {
|
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: "",
|
6201
6046
|
# uploads: [
|
6202
6047
|
# {
|
6203
6048
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
6204
6049
|
# initiator: {
|
6205
|
-
# display_name: "display-name",
|
6050
|
+
# display_name: "ownder-display-name",
|
6206
6051
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6207
6052
|
# },
|
6208
6053
|
# key: "JavaFile",
|
6209
6054
|
# owner: {
|
6210
|
-
# display_name: "
|
6211
|
-
# id: "
|
6055
|
+
# display_name: "mohanataws",
|
6056
|
+
# id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6212
6057
|
# },
|
6213
6058
|
# storage_class: "STANDARD",
|
6214
|
-
# upload_id: "
|
6059
|
+
# upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
6215
6060
|
# },
|
6216
6061
|
# {
|
6217
6062
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
6218
6063
|
# initiator: {
|
6219
|
-
# display_name: "display-name",
|
6064
|
+
# display_name: "ownder-display-name",
|
6220
6065
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6221
6066
|
# },
|
6222
6067
|
# key: "JavaFile",
|
6223
6068
|
# owner: {
|
6224
|
-
# display_name: "display-name",
|
6069
|
+
# display_name: "ownder-display-name",
|
6225
6070
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6226
6071
|
# },
|
6227
6072
|
# storage_class: "STANDARD",
|
6228
|
-
# upload_id: "
|
6073
|
+
# upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
6229
6074
|
# },
|
6230
6075
|
# ],
|
6231
6076
|
# }
|
6232
6077
|
#
|
6233
|
-
# @example Example:
|
6078
|
+
# @example Example: To list in-progress multipart uploads on a bucket
|
6234
6079
|
#
|
6235
|
-
# # The following example
|
6236
|
-
# # setup of multipart uploads.
|
6080
|
+
# # The following example lists in-progress multipart uploads on a specific bucket.
|
6237
6081
|
#
|
6238
6082
|
# resp = client.list_multipart_uploads({
|
6239
6083
|
# bucket: "examplebucket",
|
6240
|
-
# key_marker: "nextkeyfrompreviousresponse",
|
6241
|
-
# max_uploads: 2,
|
6242
|
-
# upload_id_marker: "valuefrompreviousresponse",
|
6243
6084
|
# })
|
6244
6085
|
#
|
6245
6086
|
# resp.to_h outputs the following:
|
6246
6087
|
# {
|
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: "",
|
6254
6088
|
# uploads: [
|
6255
6089
|
# {
|
6256
6090
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
6257
6091
|
# initiator: {
|
6258
|
-
# display_name: "
|
6092
|
+
# display_name: "display-name",
|
6259
6093
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6260
6094
|
# },
|
6261
6095
|
# key: "JavaFile",
|
6262
6096
|
# owner: {
|
6263
|
-
# display_name: "
|
6264
|
-
# id: "
|
6097
|
+
# display_name: "display-name",
|
6098
|
+
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6265
6099
|
# },
|
6266
6100
|
# storage_class: "STANDARD",
|
6267
|
-
# upload_id: "
|
6101
|
+
# upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
6268
6102
|
# },
|
6269
6103
|
# {
|
6270
6104
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
6271
6105
|
# initiator: {
|
6272
|
-
# display_name: "
|
6106
|
+
# display_name: "display-name",
|
6273
6107
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6274
6108
|
# },
|
6275
6109
|
# key: "JavaFile",
|
6276
6110
|
# owner: {
|
6277
|
-
# display_name: "
|
6111
|
+
# display_name: "display-name",
|
6278
6112
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
6279
6113
|
# },
|
6280
6114
|
# storage_class: "STANDARD",
|
6281
|
-
# upload_id: "
|
6115
|
+
# upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
6282
6116
|
# },
|
6283
6117
|
# ],
|
6284
6118
|
# }
|
@@ -6342,20 +6176,13 @@ module Aws::S3
|
|
6342
6176
|
#
|
6343
6177
|
# The following operations are related to `ListObjectVersions`\:
|
6344
6178
|
#
|
6345
|
-
# *
|
6346
|
-
#
|
6347
|
-
# * [GetObject][2]
|
6179
|
+
# * ListObjectsV2
|
6348
6180
|
#
|
6349
|
-
# *
|
6181
|
+
# * GetObject
|
6350
6182
|
#
|
6351
|
-
# *
|
6183
|
+
# * PutObject
|
6352
6184
|
#
|
6353
|
-
#
|
6354
|
-
#
|
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
|
6185
|
+
# * DeleteObject
|
6359
6186
|
#
|
6360
6187
|
# @option params [required, String] :bucket
|
6361
6188
|
# The bucket name that contains the objects.
|
@@ -6532,28 +6359,20 @@ module Aws::S3
|
|
6532
6359
|
# of the response and handle it appropriately.
|
6533
6360
|
#
|
6534
6361
|
# This API has been revised. We recommend that you use the newer
|
6535
|
-
# version,
|
6536
|
-
#
|
6362
|
+
# version, ListObjectsV2, when developing applications. For backward
|
6363
|
+
# compatibility, Amazon S3 continues to support `ListObjects`.
|
6537
6364
|
#
|
6538
6365
|
# The following operations are related to `ListObjects`\:
|
6539
6366
|
#
|
6540
|
-
# *
|
6541
|
-
#
|
6542
|
-
# * [GetObject][2]
|
6367
|
+
# * ListObjectsV2
|
6543
6368
|
#
|
6544
|
-
# *
|
6369
|
+
# * GetObject
|
6545
6370
|
#
|
6546
|
-
# *
|
6371
|
+
# * PutObject
|
6547
6372
|
#
|
6548
|
-
# *
|
6373
|
+
# * CreateBucket
|
6549
6374
|
#
|
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
|
6375
|
+
# * ListBuckets
|
6557
6376
|
#
|
6558
6377
|
# @option params [required, String] :bucket
|
6559
6378
|
# The name of the bucket containing the objects.
|
@@ -6699,27 +6518,22 @@ module Aws::S3
|
|
6699
6518
|
# This section describes the latest revision of the API. We recommend
|
6700
6519
|
# that you use this revised API for application development. For
|
6701
6520
|
# backward compatibility, Amazon S3 continues to support the prior
|
6702
|
-
# version of this API,
|
6521
|
+
# version of this API, ListObjects.
|
6703
6522
|
#
|
6704
|
-
# To get a list of your buckets, see
|
6523
|
+
# To get a list of your buckets, see ListBuckets.
|
6705
6524
|
#
|
6706
6525
|
# The following operations are related to `ListObjectsV2`\:
|
6707
6526
|
#
|
6708
|
-
# *
|
6527
|
+
# * GetObject
|
6709
6528
|
#
|
6710
|
-
# *
|
6529
|
+
# * PutObject
|
6711
6530
|
#
|
6712
|
-
# *
|
6531
|
+
# * CreateBucket
|
6713
6532
|
#
|
6714
6533
|
#
|
6715
6534
|
#
|
6716
6535
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
6717
6536
|
# [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
|
6723
6537
|
#
|
6724
6538
|
# @option params [required, String] :bucket
|
6725
6539
|
# Bucket name to list.
|
@@ -6873,7 +6687,7 @@ module Aws::S3
|
|
6873
6687
|
# Lists the parts that have been uploaded for a specific multipart
|
6874
6688
|
# upload. This operation must include the upload ID, which you obtain by
|
6875
6689
|
# sending the initiate multipart upload request (see
|
6876
|
-
#
|
6690
|
+
# CreateMultipartUpload). This request returns a maximum of 1,000
|
6877
6691
|
# uploaded parts. The default number of parts returned is 1,000 parts.
|
6878
6692
|
# You can restrict the number of parts returned by specifying the
|
6879
6693
|
# `max-parts` request parameter. If your multipart upload consists of
|
@@ -6884,32 +6698,27 @@ module Aws::S3
|
|
6884
6698
|
# field value from the previous response.
|
6885
6699
|
#
|
6886
6700
|
# For more information on multipart uploads, see [Uploading Objects
|
6887
|
-
# Using Multipart Upload][
|
6701
|
+
# Using Multipart Upload][1].
|
6888
6702
|
#
|
6889
6703
|
# For information on permissions required to use the multipart upload
|
6890
|
-
# API, see [Multipart Upload API and Permissions][
|
6704
|
+
# API, see [Multipart Upload API and Permissions][2].
|
6891
6705
|
#
|
6892
6706
|
# The following operations are related to `ListParts`\:
|
6893
6707
|
#
|
6894
|
-
# *
|
6708
|
+
# * CreateMultipartUpload
|
6895
6709
|
#
|
6896
|
-
# *
|
6710
|
+
# * UploadPart
|
6897
6711
|
#
|
6898
|
-
# *
|
6712
|
+
# * CompleteMultipartUpload
|
6899
6713
|
#
|
6900
|
-
# *
|
6714
|
+
# * AbortMultipartUpload
|
6901
6715
|
#
|
6902
|
-
# *
|
6716
|
+
# * ListMultipartUploads
|
6903
6717
|
#
|
6904
6718
|
#
|
6905
6719
|
#
|
6906
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
6907
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
6720
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
6721
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
6913
6722
|
#
|
6914
6723
|
# @option params [required, String] :bucket
|
6915
6724
|
# Name of the bucket to which the parts are being uploaded.
|
@@ -7069,8 +6878,8 @@ module Aws::S3
|
|
7069
6878
|
#
|
7070
6879
|
# * Suspended – Disables accelerated data transfers to the bucket.
|
7071
6880
|
#
|
7072
|
-
# The
|
7073
|
-
#
|
6881
|
+
# The GetBucketAccelerateConfiguration operation returns the transfer
|
6882
|
+
# acceleration state of a bucket.
|
7074
6883
|
#
|
7075
6884
|
# After setting the Transfer Acceleration state of a bucket to Enabled,
|
7076
6885
|
# it might take up to thirty minutes before the data transfer rates to
|
@@ -7080,22 +6889,20 @@ module Aws::S3
|
|
7080
6889
|
# DNS-compliant and must not contain periods (".").
|
7081
6890
|
#
|
7082
6891
|
# For more information about transfer acceleration, see [Transfer
|
7083
|
-
# Acceleration][
|
6892
|
+
# Acceleration][3].
|
7084
6893
|
#
|
7085
6894
|
# The following operations are related to
|
7086
6895
|
# `PutBucketAccelerateConfiguration`\:
|
7087
6896
|
#
|
7088
|
-
# *
|
6897
|
+
# * GetBucketAccelerateConfiguration
|
7089
6898
|
#
|
7090
|
-
# *
|
6899
|
+
# * CreateBucket
|
7091
6900
|
#
|
7092
6901
|
#
|
7093
6902
|
#
|
7094
6903
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
7095
6904
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
7096
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
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
|
6905
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
|
7099
6906
|
#
|
7100
6907
|
# @option params [required, String] :bucket
|
7101
6908
|
# Name of the bucket for which the accelerate configuration is set.
|
@@ -7264,11 +7071,11 @@ module Aws::S3
|
|
7264
7071
|
#
|
7265
7072
|
# **Related Resources**
|
7266
7073
|
#
|
7267
|
-
# *
|
7074
|
+
# * CreateBucket
|
7268
7075
|
#
|
7269
|
-
# *
|
7076
|
+
# * DeleteBucket
|
7270
7077
|
#
|
7271
|
-
# *
|
7078
|
+
# * GetObjectAcl
|
7272
7079
|
#
|
7273
7080
|
#
|
7274
7081
|
#
|
@@ -7276,9 +7083,6 @@ module Aws::S3
|
|
7276
7083
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
7277
7084
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
7278
7085
|
# [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
|
7282
7086
|
#
|
7283
7087
|
# @option params [String] :acl
|
7284
7088
|
# The canned ACL to apply to the bucket.
|
@@ -7423,11 +7227,9 @@ module Aws::S3
|
|
7423
7227
|
#
|
7424
7228
|
# **Related Resources**
|
7425
7229
|
#
|
7426
|
-
# *
|
7427
|
-
#
|
7428
|
-
# *
|
7429
|
-
#
|
7430
|
-
# * [ListBucketAnalyticsConfigurations][7]
|
7230
|
+
# *
|
7231
|
+
# *
|
7232
|
+
# *
|
7431
7233
|
#
|
7432
7234
|
#
|
7433
7235
|
#
|
@@ -7435,9 +7237,6 @@ module Aws::S3
|
|
7435
7237
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
|
7436
7238
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
7437
7239
|
# [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
|
7441
7240
|
#
|
7442
7241
|
# @option params [required, String] :bucket
|
7443
7242
|
# The name of the bucket to which an analytics configuration is stored.
|
@@ -7538,18 +7337,15 @@ module Aws::S3
|
|
7538
7337
|
#
|
7539
7338
|
# **Related Resources**
|
7540
7339
|
#
|
7541
|
-
# *
|
7340
|
+
# * GetBucketCors
|
7542
7341
|
#
|
7543
|
-
# *
|
7342
|
+
# * DeleteBucketCors
|
7544
7343
|
#
|
7545
|
-
# *
|
7344
|
+
# * RESTOPTIONSobject
|
7546
7345
|
#
|
7547
7346
|
#
|
7548
7347
|
#
|
7549
7348
|
# [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
|
7553
7349
|
#
|
7554
7350
|
# @option params [required, String] :bucket
|
7555
7351
|
# Specifies the bucket impacted by the `cors`configuration.
|
@@ -7669,17 +7465,15 @@ module Aws::S3
|
|
7669
7465
|
#
|
7670
7466
|
# **Related Resources**
|
7671
7467
|
#
|
7672
|
-
# *
|
7468
|
+
# * GetBucketEncryption
|
7673
7469
|
#
|
7674
|
-
# *
|
7470
|
+
# * DeleteBucketEncryption
|
7675
7471
|
#
|
7676
7472
|
#
|
7677
7473
|
#
|
7678
7474
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
7679
7475
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
7680
7476
|
# [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
|
7683
7477
|
#
|
7684
7478
|
# @option params [required, String] :bucket
|
7685
7479
|
# Specifies default encryption for a bucket using server-side encryption
|
@@ -7785,11 +7579,11 @@ module Aws::S3
|
|
7785
7579
|
#
|
7786
7580
|
# **Related Resources**
|
7787
7581
|
#
|
7788
|
-
# *
|
7582
|
+
# * GetBucketInventoryConfiguration
|
7789
7583
|
#
|
7790
|
-
# *
|
7584
|
+
# * DeleteBucketInventoryConfiguration
|
7791
7585
|
#
|
7792
|
-
# *
|
7586
|
+
# * ListBucketInventoryConfigurations
|
7793
7587
|
#
|
7794
7588
|
#
|
7795
7589
|
#
|
@@ -7797,9 +7591,6 @@ module Aws::S3
|
|
7797
7591
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
|
7798
7592
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
7799
7593
|
# [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
|
7803
7594
|
#
|
7804
7595
|
# @option params [required, String] :bucket
|
7805
7596
|
# The name of the bucket where the inventory configuration will be
|
@@ -7857,13 +7648,13 @@ module Aws::S3
|
|
7857
7648
|
end
|
7858
7649
|
|
7859
7650
|
# For an updated version of this API, see
|
7860
|
-
#
|
7861
|
-
#
|
7862
|
-
#
|
7651
|
+
# PutBucketLifecycleConfiguration. This version has been deprecated.
|
7652
|
+
# Existing lifecycle configurations will work. For new lifecycle
|
7653
|
+
# configurations, use the updated API.
|
7863
7654
|
#
|
7864
7655
|
# Creates a new lifecycle configuration for the bucket or replaces an
|
7865
7656
|
# existing lifecycle configuration. For information about lifecycle
|
7866
|
-
# configuration, see [Object Lifecycle Management][
|
7657
|
+
# configuration, see [Object Lifecycle Management][1] in the *Amazon
|
7867
7658
|
# Simple Storage Service Developer Guide*.
|
7868
7659
|
#
|
7869
7660
|
# By default, all Amazon S3 resources, including buckets, objects, and
|
@@ -7886,41 +7677,36 @@ module Aws::S3
|
|
7886
7677
|
# * `s3:PutLifecycleConfiguration`
|
7887
7678
|
#
|
7888
7679
|
# For more information about permissions, see [Managing Access
|
7889
|
-
# Permissions to your Amazon S3 Resources][
|
7680
|
+
# Permissions to your Amazon S3 Resources][2] in the *Amazon Simple
|
7890
7681
|
# Storage Service Developer Guide*.
|
7891
7682
|
#
|
7892
7683
|
# For more examples of transitioning objects to storage classes such as
|
7893
7684
|
# STANDARD\_IA or ONEZONE\_IA, see [Examples of Lifecycle
|
7894
|
-
# Configuration][
|
7685
|
+
# Configuration][3].
|
7895
7686
|
#
|
7896
7687
|
# **Related Resources**
|
7897
7688
|
#
|
7898
|
-
# *
|
7689
|
+
# * GetBucketLifecycle(Deprecated)
|
7899
7690
|
#
|
7900
|
-
# *
|
7901
|
-
#
|
7902
|
-
# * [RestoreObject][7]
|
7691
|
+
# * GetBucketLifecycleConfiguration
|
7903
7692
|
#
|
7693
|
+
# *
|
7904
7694
|
# * By default, a resource owner—in this case, a bucket owner, which is
|
7905
7695
|
# the AWS account that created the bucket—can perform any of the
|
7906
7696
|
# operations. A resource owner can also grant others permission to
|
7907
7697
|
# perform the operation. For more information, see the following
|
7908
7698
|
# topics in the Amazon Simple Storage Service Developer Guide:
|
7909
7699
|
#
|
7910
|
-
# * [Specifying Permissions in a Policy][
|
7700
|
+
# * [Specifying Permissions in a Policy][4]
|
7911
7701
|
#
|
7912
|
-
# * [Managing Access Permissions to your Amazon S3 Resources][
|
7702
|
+
# * [Managing Access Permissions to your Amazon S3 Resources][2]
|
7913
7703
|
#
|
7914
7704
|
#
|
7915
7705
|
#
|
7916
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
7917
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
7918
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
7919
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
7706
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
7707
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
7708
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#lifecycle-configuration-examples
|
7709
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
7924
7710
|
#
|
7925
7711
|
# @option params [required, String] :bucket
|
7926
7712
|
#
|
@@ -7986,7 +7772,7 @@ module Aws::S3
|
|
7986
7772
|
# API. The previous version of the API supported filtering based only on
|
7987
7773
|
# an object key name prefix, which is supported for backward
|
7988
7774
|
# compatibility. For the related API description, see
|
7989
|
-
#
|
7775
|
+
# PutBucketLifecycle.
|
7990
7776
|
#
|
7991
7777
|
# </note>
|
7992
7778
|
#
|
@@ -8010,8 +7796,8 @@ module Aws::S3
|
|
8010
7796
|
# S3 provides predefined actions that you can specify for current and
|
8011
7797
|
# noncurrent object versions.
|
8012
7798
|
#
|
8013
|
-
# For more information, see [Object Lifecycle Management][
|
8014
|
-
# [Lifecycle Configuration Elements][
|
7799
|
+
# For more information, see [Object Lifecycle Management][2] and
|
7800
|
+
# [Lifecycle Configuration Elements][3].
|
8015
7801
|
#
|
8016
7802
|
# **Permissions**
|
8017
7803
|
#
|
@@ -8039,21 +7825,18 @@ module Aws::S3
|
|
8039
7825
|
#
|
8040
7826
|
# The following are related to `PutBucketLifecycleConfiguration`\:
|
8041
7827
|
#
|
8042
|
-
# * [Examples of Lifecycle Configuration][
|
7828
|
+
# * [Examples of Lifecycle Configuration][4]
|
8043
7829
|
#
|
8044
|
-
# *
|
7830
|
+
# * GetBucketLifecycleConfiguration
|
8045
7831
|
#
|
8046
|
-
# *
|
7832
|
+
# * DeleteBucketLifecycle
|
8047
7833
|
#
|
8048
7834
|
#
|
8049
7835
|
#
|
8050
7836
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
8051
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
8052
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
8053
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
7837
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
7838
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
|
7839
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-configuration-examples.html
|
8057
7840
|
#
|
8058
7841
|
# @option params [required, String] :bucket
|
8059
7842
|
# The name of the bucket for which to set the configuration.
|
@@ -8202,27 +7985,23 @@ module Aws::S3
|
|
8202
7985
|
# For more information about server access logging, see [Server Access
|
8203
7986
|
# Logging][1].
|
8204
7987
|
#
|
8205
|
-
# For more information about creating a bucket, see
|
8206
|
-
#
|
8207
|
-
#
|
7988
|
+
# For more information about creating a bucket, see CreateBucket. For
|
7989
|
+
# more information about returning the logging status of a bucket, see
|
7990
|
+
# GetBucketLogging.
|
8208
7991
|
#
|
8209
7992
|
# The following operations are related to `PutBucketLogging`\:
|
8210
7993
|
#
|
8211
|
-
# *
|
7994
|
+
# * PutObject
|
8212
7995
|
#
|
8213
|
-
# *
|
7996
|
+
# * DeleteBucket
|
8214
7997
|
#
|
8215
|
-
# *
|
7998
|
+
# * CreateBucket
|
8216
7999
|
#
|
8217
|
-
# *
|
8000
|
+
# * GetBucketLogging
|
8218
8001
|
#
|
8219
8002
|
#
|
8220
8003
|
#
|
8221
8004
|
# [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
|
8226
8005
|
#
|
8227
8006
|
# @option params [required, String] :bucket
|
8228
8007
|
# The name of the bucket for which to set the logging parameters.
|
@@ -8314,11 +8093,11 @@ module Aws::S3
|
|
8314
8093
|
# The following operations are related to
|
8315
8094
|
# `PutBucketMetricsConfiguration`\:
|
8316
8095
|
#
|
8317
|
-
# *
|
8096
|
+
# * DeleteBucketMetricsConfiguration
|
8318
8097
|
#
|
8319
|
-
# *
|
8098
|
+
# * PutBucketMetricsConfiguration
|
8320
8099
|
#
|
8321
|
-
# *
|
8100
|
+
# * ListBucketMetricsConfigurations
|
8322
8101
|
#
|
8323
8102
|
# `GetBucketLifecycle` has the following special error:
|
8324
8103
|
#
|
@@ -8334,9 +8113,6 @@ module Aws::S3
|
|
8334
8113
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
8335
8114
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
8336
8115
|
# [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
|
8340
8116
|
#
|
8341
8117
|
# @option params [required, String] :bucket
|
8342
8118
|
# The name of the bucket for which the metrics configuration is set.
|
@@ -8384,12 +8160,7 @@ module Aws::S3
|
|
8384
8160
|
req.send_request(options)
|
8385
8161
|
end
|
8386
8162
|
|
8387
|
-
# No longer used, see the
|
8388
|
-
# operation.
|
8389
|
-
#
|
8390
|
-
#
|
8391
|
-
#
|
8392
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html
|
8163
|
+
# No longer used, see the PutBucketNotificationConfiguration operation.
|
8393
8164
|
#
|
8394
8165
|
# @option params [required, String] :bucket
|
8395
8166
|
# The name of the bucket.
|
@@ -8497,14 +8268,13 @@ module Aws::S3
|
|
8497
8268
|
# The following operation is related to
|
8498
8269
|
# `PutBucketNotificationConfiguration`\:
|
8499
8270
|
#
|
8500
|
-
# *
|
8271
|
+
# * GetBucketNotificationConfiguration
|
8501
8272
|
#
|
8502
8273
|
# ^
|
8503
8274
|
#
|
8504
8275
|
#
|
8505
8276
|
#
|
8506
8277
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
8507
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html
|
8508
8278
|
#
|
8509
8279
|
# @option params [required, String] :bucket
|
8510
8280
|
# The name of the bucket.
|
@@ -8623,15 +8393,13 @@ module Aws::S3
|
|
8623
8393
|
#
|
8624
8394
|
# The following operations are related to `PutBucketPolicy`\:
|
8625
8395
|
#
|
8626
|
-
# *
|
8396
|
+
# * CreateBucket
|
8627
8397
|
#
|
8628
|
-
# *
|
8398
|
+
# * DeleteBucket
|
8629
8399
|
#
|
8630
8400
|
#
|
8631
8401
|
#
|
8632
8402
|
# [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
|
8635
8403
|
#
|
8636
8404
|
# @option params [required, String] :bucket
|
8637
8405
|
# The name of the bucket.
|
@@ -8735,14 +8503,14 @@ module Aws::S3
|
|
8735
8503
|
# about replication configuration, see [Replicating Objects Created with
|
8736
8504
|
# SSE Using CMKs stored in AWS KMS][6].
|
8737
8505
|
#
|
8738
|
-
# For information on `PutBucketReplication` errors, see
|
8739
|
-
#
|
8506
|
+
# For information on `PutBucketReplication` errors, see
|
8507
|
+
# ReplicationErrorCodeList
|
8740
8508
|
#
|
8741
8509
|
# The following operations are related to `PutBucketReplication`\:
|
8742
8510
|
#
|
8743
|
-
# *
|
8511
|
+
# * GetBucketReplication
|
8744
8512
|
#
|
8745
|
-
# *
|
8513
|
+
# * DeleteBucketReplication
|
8746
8514
|
#
|
8747
8515
|
#
|
8748
8516
|
#
|
@@ -8752,9 +8520,6 @@ module Aws::S3
|
|
8752
8520
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
8753
8521
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
8754
8522
|
# [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
|
8758
8523
|
#
|
8759
8524
|
# @option params [required, String] :bucket
|
8760
8525
|
# The name of the bucket
|
@@ -8884,15 +8649,13 @@ module Aws::S3
|
|
8884
8649
|
#
|
8885
8650
|
# The following operations are related to `PutBucketRequestPayment`\:
|
8886
8651
|
#
|
8887
|
-
# *
|
8652
|
+
# * CreateBucket
|
8888
8653
|
#
|
8889
|
-
# *
|
8654
|
+
# * GetBucketRequestPayment
|
8890
8655
|
#
|
8891
8656
|
#
|
8892
8657
|
#
|
8893
8658
|
# [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
|
8896
8659
|
#
|
8897
8660
|
# @option params [required, String] :bucket
|
8898
8661
|
# The bucket name.
|
@@ -9000,9 +8763,9 @@ module Aws::S3
|
|
9000
8763
|
#
|
9001
8764
|
# The following operations are related to `PutBucketTagging`\:
|
9002
8765
|
#
|
9003
|
-
# *
|
8766
|
+
# * GetBucketTagging
|
9004
8767
|
#
|
9005
|
-
# *
|
8768
|
+
# * DeleteBucketTagging
|
9006
8769
|
#
|
9007
8770
|
#
|
9008
8771
|
#
|
@@ -9012,8 +8775,6 @@ module Aws::S3
|
|
9012
8775
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
9013
8776
|
# [5]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
|
9014
8777
|
# [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
|
9017
8778
|
#
|
9018
8779
|
# @option params [required, String] :bucket
|
9019
8780
|
# The bucket name.
|
@@ -9089,7 +8850,7 @@ module Aws::S3
|
|
9089
8850
|
# objects added to the bucket receive the version ID null.
|
9090
8851
|
#
|
9091
8852
|
# If the versioning state has never been set on a bucket, it has no
|
9092
|
-
# versioning state; a
|
8853
|
+
# versioning state; a GetBucketVersioning request does not return a
|
9093
8854
|
# versioning state value.
|
9094
8855
|
#
|
9095
8856
|
# If the bucket owner enables MFA Delete in the bucket versioning
|
@@ -9104,22 +8865,19 @@ module Aws::S3
|
|
9104
8865
|
# manage the deletes of the noncurrent object versions in the
|
9105
8866
|
# version-enabled bucket. (A version-enabled bucket maintains one
|
9106
8867
|
# current and zero or more noncurrent object versions.) For more
|
9107
|
-
# information, see [Lifecycle and Versioning][
|
8868
|
+
# information, see [Lifecycle and Versioning][1].
|
9108
8869
|
#
|
9109
8870
|
# **Related Resources**
|
9110
8871
|
#
|
9111
|
-
# *
|
8872
|
+
# * CreateBucket
|
9112
8873
|
#
|
9113
|
-
# *
|
8874
|
+
# * DeleteBucket
|
9114
8875
|
#
|
9115
|
-
# *
|
8876
|
+
# * GetBucketVersioning
|
9116
8877
|
#
|
9117
8878
|
#
|
9118
8879
|
#
|
9119
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
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
|
8880
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html#lifecycle-and-other-bucket-config
|
9123
8881
|
#
|
9124
8882
|
# @option params [required, String] :bucket
|
9125
8883
|
# The bucket name.
|
@@ -9392,13 +9150,13 @@ module Aws::S3
|
|
9392
9150
|
#
|
9393
9151
|
# For more information about versioning, see [Adding Objects to
|
9394
9152
|
# Versioning Enabled Buckets][6]. For information about returning the
|
9395
|
-
# versioning state of a bucket, see
|
9153
|
+
# versioning state of a bucket, see GetBucketVersioning.
|
9396
9154
|
#
|
9397
9155
|
# **Related Resources**
|
9398
9156
|
#
|
9399
|
-
# *
|
9157
|
+
# * CopyObject
|
9400
9158
|
#
|
9401
|
-
# *
|
9159
|
+
# * DeleteObject
|
9402
9160
|
#
|
9403
9161
|
#
|
9404
9162
|
#
|
@@ -9408,9 +9166,6 @@ module Aws::S3
|
|
9408
9166
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html
|
9409
9167
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
9410
9168
|
# [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
|
9414
9169
|
#
|
9415
9170
|
# @option params [String] :acl
|
9416
9171
|
# The canned ACL to apply to the object. For more information, see
|
@@ -9571,7 +9326,7 @@ module Aws::S3
|
|
9571
9326
|
# encrypting data. This value is used to store the object and then it is
|
9572
9327
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
9573
9328
|
# be appropriate for use with the algorithm specified in the
|
9574
|
-
# `x-amz-server-side
|
9329
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
9575
9330
|
#
|
9576
9331
|
# @option params [String] :sse_customer_key_md5
|
9577
9332
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
@@ -9638,43 +9393,39 @@ module Aws::S3
|
|
9638
9393
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
9639
9394
|
#
|
9640
9395
|
#
|
9641
|
-
# @example Example: To upload object and specify
|
9396
|
+
# @example Example: To upload an object and specify canned ACL.
|
9642
9397
|
#
|
9643
|
-
# # The following example
|
9644
|
-
# # enabled, S3 returns version ID in response.
|
9398
|
+
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
9399
|
+
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
9645
9400
|
#
|
9646
9401
|
# resp = client.put_object({
|
9402
|
+
# acl: "authenticated-read",
|
9647
9403
|
# body: "filetoupload",
|
9648
9404
|
# bucket: "examplebucket",
|
9649
9405
|
# key: "exampleobject",
|
9650
|
-
# metadata: {
|
9651
|
-
# "metadata1" => "value1",
|
9652
|
-
# "metadata2" => "value2",
|
9653
|
-
# },
|
9654
9406
|
# })
|
9655
9407
|
#
|
9656
9408
|
# resp.to_h outputs the following:
|
9657
9409
|
# {
|
9658
9410
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9659
|
-
# version_id: "
|
9411
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
9660
9412
|
# }
|
9661
9413
|
#
|
9662
|
-
# @example Example: To upload an object
|
9414
|
+
# @example Example: To upload an object
|
9663
9415
|
#
|
9664
|
-
# # The following example uploads
|
9665
|
-
# #
|
9416
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
9417
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
9666
9418
|
#
|
9667
9419
|
# resp = client.put_object({
|
9668
|
-
#
|
9669
|
-
# body: "filetoupload",
|
9420
|
+
# body: "HappyFace.jpg",
|
9670
9421
|
# bucket: "examplebucket",
|
9671
|
-
# key: "
|
9422
|
+
# key: "HappyFace.jpg",
|
9672
9423
|
# })
|
9673
9424
|
#
|
9674
9425
|
# resp.to_h outputs the following:
|
9675
9426
|
# {
|
9676
9427
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9677
|
-
# version_id: "
|
9428
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
9678
9429
|
# }
|
9679
9430
|
#
|
9680
9431
|
# @example Example: To create an object.
|
@@ -9693,79 +9444,83 @@ module Aws::S3
|
|
9693
9444
|
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
9694
9445
|
# }
|
9695
9446
|
#
|
9696
|
-
# @example Example: To upload an object
|
9447
|
+
# @example Example: To upload an object and specify optional tags
|
9697
9448
|
#
|
9698
|
-
# # The following example uploads an object
|
9699
|
-
# #
|
9449
|
+
# # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
|
9450
|
+
# # S3 returns version ID of the newly created object.
|
9700
9451
|
#
|
9701
9452
|
# resp = client.put_object({
|
9702
|
-
# body: "HappyFace.jpg",
|
9453
|
+
# body: "c:\\HappyFace.jpg",
|
9703
9454
|
# bucket: "examplebucket",
|
9704
9455
|
# key: "HappyFace.jpg",
|
9456
|
+
# tagging: "key1=value1&key2=value2",
|
9705
9457
|
# })
|
9706
9458
|
#
|
9707
9459
|
# resp.to_h outputs the following:
|
9708
9460
|
# {
|
9709
9461
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9710
|
-
# version_id: "
|
9462
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
9711
9463
|
# }
|
9712
9464
|
#
|
9713
|
-
# @example Example: To upload an object
|
9465
|
+
# @example Example: To upload an object (specify optional headers)
|
9714
9466
|
#
|
9715
|
-
# # The following example uploads an object. The request specifies optional
|
9716
|
-
# #
|
9467
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
9468
|
+
# # storage class and use server-side encryption.
|
9717
9469
|
#
|
9718
9470
|
# resp = client.put_object({
|
9719
|
-
# body: "
|
9471
|
+
# body: "HappyFace.jpg",
|
9720
9472
|
# bucket: "examplebucket",
|
9721
9473
|
# key: "HappyFace.jpg",
|
9722
|
-
#
|
9474
|
+
# server_side_encryption: "AES256",
|
9475
|
+
# storage_class: "STANDARD_IA",
|
9723
9476
|
# })
|
9724
9477
|
#
|
9725
9478
|
# resp.to_h outputs the following:
|
9726
9479
|
# {
|
9727
9480
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9728
|
-
#
|
9481
|
+
# server_side_encryption: "AES256",
|
9482
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
9729
9483
|
# }
|
9730
9484
|
#
|
9731
|
-
# @example Example: To upload
|
9485
|
+
# @example Example: To upload object and specify user-defined metadata
|
9732
9486
|
#
|
9733
|
-
# # The following example
|
9734
|
-
# #
|
9487
|
+
# # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
|
9488
|
+
# # enabled, S3 returns version ID in response.
|
9735
9489
|
#
|
9736
9490
|
# resp = client.put_object({
|
9737
9491
|
# body: "filetoupload",
|
9738
9492
|
# bucket: "examplebucket",
|
9739
9493
|
# key: "exampleobject",
|
9740
|
-
#
|
9741
|
-
#
|
9494
|
+
# metadata: {
|
9495
|
+
# "metadata1" => "value1",
|
9496
|
+
# "metadata2" => "value2",
|
9497
|
+
# },
|
9742
9498
|
# })
|
9743
9499
|
#
|
9744
9500
|
# resp.to_h outputs the following:
|
9745
9501
|
# {
|
9746
9502
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9747
|
-
#
|
9748
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
9503
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
9749
9504
|
# }
|
9750
9505
|
#
|
9751
|
-
# @example Example: To upload an object
|
9506
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
9752
9507
|
#
|
9753
|
-
# # The following example uploads
|
9754
|
-
# #
|
9508
|
+
# # The following example uploads and object. The request specifies the optional server-side encryption option. The request
|
9509
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
9755
9510
|
#
|
9756
9511
|
# resp = client.put_object({
|
9757
|
-
# body: "
|
9512
|
+
# body: "filetoupload",
|
9758
9513
|
# bucket: "examplebucket",
|
9759
|
-
# key: "
|
9514
|
+
# key: "exampleobject",
|
9760
9515
|
# server_side_encryption: "AES256",
|
9761
|
-
#
|
9516
|
+
# tagging: "key1=value1&key2=value2",
|
9762
9517
|
# })
|
9763
9518
|
#
|
9764
9519
|
# resp.to_h outputs the following:
|
9765
9520
|
# {
|
9766
9521
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
9767
9522
|
# server_side_encryption: "AES256",
|
9768
|
-
# version_id: "
|
9523
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
9769
9524
|
# }
|
9770
9525
|
#
|
9771
9526
|
# @example Streaming a file from disk
|
@@ -9967,17 +9722,15 @@ module Aws::S3
|
|
9967
9722
|
#
|
9968
9723
|
# **Related Resources**
|
9969
9724
|
#
|
9970
|
-
# *
|
9725
|
+
# * CopyObject
|
9971
9726
|
#
|
9972
|
-
# *
|
9727
|
+
# * GetObject
|
9973
9728
|
#
|
9974
9729
|
#
|
9975
9730
|
#
|
9976
9731
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
9977
9732
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
9978
9733
|
# [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
|
9981
9734
|
#
|
9982
9735
|
# @option params [String] :acl
|
9983
9736
|
# The canned ACL to apply to the object. For more information, see
|
@@ -10378,10 +10131,10 @@ module Aws::S3
|
|
10378
10131
|
# A tag is a key-value pair. You can associate tags with an object by
|
10379
10132
|
# sending a PUT request against the tagging subresource that is
|
10380
10133
|
# associated with the object. You can retrieve tags by sending a GET
|
10381
|
-
# request. For more information, see
|
10134
|
+
# request. For more information, see GetObjectTagging.
|
10382
10135
|
#
|
10383
10136
|
# For tagging-related restrictions related to characters and encodings,
|
10384
|
-
# see [Tag Restrictions][
|
10137
|
+
# see [Tag Restrictions][1]. Note that Amazon S3 limits the maximum
|
10385
10138
|
# number of tags to 10 tags per object.
|
10386
10139
|
#
|
10387
10140
|
# To use this operation, you must have permission to perform the
|
@@ -10392,7 +10145,7 @@ module Aws::S3
|
|
10392
10145
|
# You also need permission for the `s3:PutObjectVersionTagging` action.
|
10393
10146
|
#
|
10394
10147
|
# For information about the Amazon S3 object tagging feature, see
|
10395
|
-
# [Object Tagging][
|
10148
|
+
# [Object Tagging][2].
|
10396
10149
|
#
|
10397
10150
|
# **Special Errors**
|
10398
10151
|
#
|
@@ -10402,7 +10155,7 @@ module Aws::S3
|
|
10402
10155
|
#
|
10403
10156
|
# * *Cause: The tag provided was not a valid tag. This error can occur
|
10404
10157
|
# if the tag did not pass input validation. For more information,
|
10405
|
-
# see [Object Tagging][
|
10158
|
+
# see [Object Tagging][2].*
|
10406
10159
|
#
|
10407
10160
|
# * ****
|
10408
10161
|
#
|
@@ -10422,15 +10175,14 @@ module Aws::S3
|
|
10422
10175
|
#
|
10423
10176
|
# **Related Resources**
|
10424
10177
|
#
|
10425
|
-
# *
|
10178
|
+
# * GetObjectTagging
|
10426
10179
|
#
|
10427
10180
|
# ^
|
10428
10181
|
#
|
10429
10182
|
#
|
10430
10183
|
#
|
10431
|
-
# [1]: https://docs.aws.amazon.com/
|
10432
|
-
# [2]: https://docs.aws.amazon.com/
|
10433
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
10184
|
+
# [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
|
10185
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
10434
10186
|
#
|
10435
10187
|
# @option params [required, String] :bucket
|
10436
10188
|
# The bucket name containing the object.
|
@@ -10538,22 +10290,19 @@ module Aws::S3
|
|
10538
10290
|
#
|
10539
10291
|
# **Related Resources**
|
10540
10292
|
#
|
10541
|
-
# *
|
10293
|
+
# * GetPublicAccessBlock
|
10542
10294
|
#
|
10543
|
-
# *
|
10295
|
+
# * DeletePublicAccessBlock
|
10544
10296
|
#
|
10545
|
-
# *
|
10297
|
+
# * GetBucketPolicyStatus
|
10546
10298
|
#
|
10547
|
-
# * [Using Amazon S3 Block Public Access][
|
10299
|
+
# * [Using Amazon S3 Block Public Access][3]
|
10548
10300
|
#
|
10549
10301
|
#
|
10550
10302
|
#
|
10551
10303
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
10552
10304
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
|
10553
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
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
|
10305
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
|
10557
10306
|
#
|
10558
10307
|
# @option params [required, String] :bucket
|
10559
10308
|
# The name of the Amazon S3 bucket whose `PublicAccessBlock`
|
@@ -10636,12 +10385,12 @@ module Aws::S3
|
|
10636
10385
|
# For more information about the `S3` structure in the request body,
|
10637
10386
|
# see the following:
|
10638
10387
|
#
|
10639
|
-
# *
|
10388
|
+
# * PutObject
|
10640
10389
|
#
|
10641
|
-
# * [Managing Access with ACLs][
|
10390
|
+
# * [Managing Access with ACLs][4] in the *Amazon Simple Storage
|
10642
10391
|
# Service Developer Guide*
|
10643
10392
|
#
|
10644
|
-
# * [Protecting Data Using Server-Side Encryption][
|
10393
|
+
# * [Protecting Data Using Server-Side Encryption][5] in the *Amazon
|
10645
10394
|
# Simple Storage Service Developer Guide*
|
10646
10395
|
#
|
10647
10396
|
# * Define the SQL expression for the `SELECT` type of restoration for
|
@@ -10667,7 +10416,7 @@ module Aws::S3
|
|
10667
10416
|
# `SELECT s.Id, s.FirstName, s.SSN FROM S3Object s`
|
10668
10417
|
#
|
10669
10418
|
# For more information about using SQL with S3 Glacier Select restore,
|
10670
|
-
# see [SQL Reference for Amazon S3 Select and S3 Glacier Select][
|
10419
|
+
# see [SQL Reference for Amazon S3 Select and S3 Glacier Select][6] in
|
10671
10420
|
# the *Amazon Simple Storage Service Developer Guide*.
|
10672
10421
|
#
|
10673
10422
|
# When making a select request, you can also do the following:
|
@@ -10742,7 +10491,7 @@ module Aws::S3
|
|
10742
10491
|
#
|
10743
10492
|
# For more information about archive retrieval options and provisioned
|
10744
10493
|
# capacity for `Expedited` data access, see [Restoring Archived
|
10745
|
-
# Objects][
|
10494
|
+
# Objects][7] in the *Amazon Simple Storage Service Developer Guide*.
|
10746
10495
|
#
|
10747
10496
|
# You can use Amazon S3 restore speed upgrade to change the restore
|
10748
10497
|
# speed to a faster speed while it is in progress. You upgrade the speed
|
@@ -10752,14 +10501,14 @@ module Aws::S3
|
|
10752
10501
|
# faster than the tier that the in-progress restore is using. You must
|
10753
10502
|
# not change any other parameters, such as the `Days` request element.
|
10754
10503
|
# For more information, see [ Upgrading the Speed of an In-Progress
|
10755
|
-
# Restore][
|
10504
|
+
# Restore][8] in the *Amazon Simple Storage Service Developer Guide*.
|
10756
10505
|
#
|
10757
10506
|
# To get the status of object restoration, you can send a `HEAD`
|
10758
10507
|
# request. Operations return the `x-amz-restore` header, which provides
|
10759
10508
|
# information about the restoration status, in the response. You can use
|
10760
10509
|
# Amazon S3 event notifications to notify you when a restore is
|
10761
10510
|
# initiated or completed. For more information, see [Configuring Amazon
|
10762
|
-
# S3 Event Notifications][
|
10511
|
+
# S3 Event Notifications][9] in the *Amazon Simple Storage Service
|
10763
10512
|
# Developer Guide*.
|
10764
10513
|
#
|
10765
10514
|
# After restoring an archived object, you can update the restoration
|
@@ -10774,9 +10523,9 @@ module Aws::S3
|
|
10774
10523
|
# that you specify in a restore request. For example, if you restore an
|
10775
10524
|
# object copy for 10 days, but the object is scheduled to expire in 3
|
10776
10525
|
# days, Amazon S3 deletes the object in 3 days. For more information
|
10777
|
-
# about lifecycle configuration, see
|
10778
|
-
# [
|
10779
|
-
#
|
10526
|
+
# about lifecycle configuration, see PutBucketLifecycleConfiguration and
|
10527
|
+
# [Object Lifecycle Management][10] in *Amazon Simple Storage Service
|
10528
|
+
# Developer Guide*.
|
10780
10529
|
#
|
10781
10530
|
# **Responses**
|
10782
10531
|
#
|
@@ -10818,11 +10567,11 @@ module Aws::S3
|
|
10818
10567
|
#
|
10819
10568
|
# **Related Resources**
|
10820
10569
|
#
|
10821
|
-
# *
|
10570
|
+
# * PutBucketLifecycleConfiguration
|
10822
10571
|
#
|
10823
|
-
# *
|
10572
|
+
# * GetBucketNotificationConfiguration
|
10824
10573
|
#
|
10825
|
-
# * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][
|
10574
|
+
# * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][6] in
|
10826
10575
|
# the *Amazon Simple Storage Service Developer Guide*
|
10827
10576
|
#
|
10828
10577
|
#
|
@@ -10830,16 +10579,13 @@ module Aws::S3
|
|
10830
10579
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
10831
10580
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
|
10832
10581
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html
|
10833
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10834
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10835
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10836
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10837
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
|
10838
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10839
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
10582
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
10583
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
10584
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html
|
10585
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
|
10586
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html
|
10587
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
10588
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
10843
10589
|
#
|
10844
10590
|
# @option params [required, String] :bucket
|
10845
10591
|
# The bucket name or containing the object to restore.
|
@@ -11054,17 +10800,16 @@ module Aws::S3
|
|
11054
10800
|
#
|
11055
10801
|
# For objects that are encrypted with customer-provided encryption
|
11056
10802
|
# keys (SSE-C), you must use HTTPS, and you must use the headers that
|
11057
|
-
# are documented in the
|
11058
|
-
#
|
11059
|
-
#
|
11060
|
-
# Guide*.
|
10803
|
+
# are documented in the GetObject. For more information about SSE-C,
|
10804
|
+
# see [Server-Side Encryption (Using Customer-Provided Encryption
|
10805
|
+
# Keys)][4] in the *Amazon Simple Storage Service Developer Guide*.
|
11061
10806
|
#
|
11062
10807
|
# For objects that are encrypted with Amazon S3 managed encryption
|
11063
10808
|
# keys (SSE-S3) and customer master keys (CMKs) stored in AWS Key
|
11064
10809
|
# Management Service (SSE-KMS), server-side encryption is handled
|
11065
10810
|
# transparently, so you don't need to specify anything. For more
|
11066
10811
|
# information about server-side encryption, including SSE-S3 and
|
11067
|
-
# SSE-KMS, see [Protecting Data Using Server-Side Encryption][
|
10812
|
+
# SSE-KMS, see [Protecting Data Using Server-Side Encryption][5] in
|
11068
10813
|
# the *Amazon Simple Storage Service Developer Guide*.
|
11069
10814
|
#
|
11070
10815
|
# **Working with the Response Body**
|
@@ -11072,55 +10817,49 @@ module Aws::S3
|
|
11072
10817
|
# Given the response size is unknown, Amazon S3 Select streams the
|
11073
10818
|
# response as a series of messages and includes a `Transfer-Encoding`
|
11074
10819
|
# header with `chunked` as its value in the response. For more
|
11075
|
-
# information, see
|
10820
|
+
# information, see RESTSelectObjectAppendix .
|
11076
10821
|
#
|
11077
10822
|
#
|
11078
10823
|
#
|
11079
10824
|
# **GetObject Support**
|
11080
10825
|
#
|
11081
10826
|
# The `SelectObjectContent` operation does not support the following
|
11082
|
-
# `GetObject` functionality. For more information, see
|
10827
|
+
# `GetObject` functionality. For more information, see GetObject.
|
11083
10828
|
#
|
11084
10829
|
# * `Range`\: Although you can specify a scan range for an Amazon S3
|
11085
|
-
# Select request (see
|
11086
|
-
#
|
10830
|
+
# Select request (see SelectObjectContentRequest$ScanRange in the
|
10831
|
+
# request parameters), you cannot specify the range of bytes of an
|
11087
10832
|
# object to return.
|
11088
10833
|
#
|
11089
10834
|
# * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
|
11090
10835
|
# cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
|
11091
10836
|
# storage classes. For more information, about storage classes see
|
11092
|
-
# [Storage Classes][
|
10837
|
+
# [Storage Classes][6] in the *Amazon Simple Storage Service Developer
|
11093
10838
|
# Guide*.
|
11094
10839
|
#
|
11095
10840
|
#
|
11096
10841
|
#
|
11097
10842
|
# **Special Errors**
|
11098
10843
|
#
|
11099
|
-
# For a list of special errors for this operation, see
|
11100
|
-
#
|
10844
|
+
# For a list of special errors for this operation, see
|
10845
|
+
# SelectObjectContentErrorCodeList
|
11101
10846
|
#
|
11102
10847
|
# **Related Resources**
|
11103
10848
|
#
|
11104
|
-
# *
|
10849
|
+
# * GetObject
|
11105
10850
|
#
|
11106
|
-
# *
|
10851
|
+
# * GetBucketLifecycleConfiguration
|
11107
10852
|
#
|
11108
|
-
# *
|
10853
|
+
# * PutBucketLifecycleConfiguration
|
11109
10854
|
#
|
11110
10855
|
#
|
11111
10856
|
#
|
11112
10857
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
|
11113
10858
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html
|
11114
10859
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
11115
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11116
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
11117
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
10860
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
10861
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
10862
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#storage-class-intro
|
11124
10863
|
#
|
11125
10864
|
# @option params [required, String] :bucket
|
11126
10865
|
# The S3 bucket.
|
@@ -11416,11 +11155,11 @@ module Aws::S3
|
|
11416
11155
|
# <note markdown="1"> In this operation, you provide part data in your request. However, you
|
11417
11156
|
# have an option to specify your existing Amazon S3 object as a data
|
11418
11157
|
# source for the part you are uploading. To upload a part from an
|
11419
|
-
# existing object, you use the
|
11158
|
+
# existing object, you use the UploadPartCopy operation.
|
11420
11159
|
#
|
11421
11160
|
# </note>
|
11422
11161
|
#
|
11423
|
-
# You must initiate a multipart upload (see
|
11162
|
+
# You must initiate a multipart upload (see CreateMultipartUpload)
|
11424
11163
|
# before you can upload any part. In response to your initiate request,
|
11425
11164
|
# Amazon S3 returns an upload ID, a unique identifier, that you must
|
11426
11165
|
# include in your upload part request.
|
@@ -11445,11 +11184,11 @@ module Aws::S3
|
|
11445
11184
|
# parts storage and stops charging you for the parts storage.
|
11446
11185
|
#
|
11447
11186
|
# For more information on multipart uploads, go to [Multipart Upload
|
11448
|
-
# Overview][
|
11187
|
+
# Overview][1] in the <i>Amazon Simple Storage Service Developer Guide
|
11449
11188
|
# </i>.
|
11450
11189
|
#
|
11451
11190
|
# For information on the permissions required to use the multipart
|
11452
|
-
# upload API, go to [Multipart Upload API and Permissions][
|
11191
|
+
# upload API, go to [Multipart Upload API and Permissions][2] in the
|
11453
11192
|
# *Amazon Simple Storage Service Developer Guide*.
|
11454
11193
|
#
|
11455
11194
|
# You can optionally request server-side encryption where Amazon S3
|
@@ -11459,27 +11198,26 @@ module Aws::S3
|
|
11459
11198
|
# encryption keys. If you choose to provide your own encryption key, the
|
11460
11199
|
# request headers you provide in the request must match the headers you
|
11461
11200
|
# used in the request to initiate the upload by using
|
11462
|
-
#
|
11463
|
-
#
|
11464
|
-
# Developer Guide*.
|
11201
|
+
# CreateMultipartUpload. For more information, go to [Using Server-Side
|
11202
|
+
# Encryption][3] in the *Amazon Simple Storage Service Developer Guide*.
|
11465
11203
|
#
|
11466
11204
|
# Server-side encryption is supported by the S3 Multipart Upload
|
11467
11205
|
# actions. Unless you are using a customer-provided encryption key, you
|
11468
11206
|
# don't need to specify the encryption parameters in each UploadPart
|
11469
11207
|
# request. Instead, you only need to specify the server-side encryption
|
11470
11208
|
# parameters in the initial Initiate Multipart request. For more
|
11471
|
-
# information, see
|
11209
|
+
# information, see CreateMultipartUpload.
|
11472
11210
|
#
|
11473
11211
|
# If you requested server-side encryption using a customer-provided
|
11474
11212
|
# encryption key in your initiate multipart upload request, you must
|
11475
11213
|
# provide identical encryption information in each part upload using the
|
11476
11214
|
# following headers.
|
11477
11215
|
#
|
11478
|
-
# * x-amz-server-side
|
11216
|
+
# * x-amz-server-side-encryption-customer-algorithm
|
11479
11217
|
#
|
11480
|
-
# * x-amz-server-side
|
11218
|
+
# * x-amz-server-side-encryption-customer-key
|
11481
11219
|
#
|
11482
|
-
# * x-amz-server-side
|
11220
|
+
# * x-amz-server-side-encryption-customer-key-MD5
|
11483
11221
|
#
|
11484
11222
|
# **Special Errors**
|
11485
11223
|
#
|
@@ -11497,27 +11235,21 @@ module Aws::S3
|
|
11497
11235
|
#
|
11498
11236
|
# **Related Resources**
|
11499
11237
|
#
|
11500
|
-
# *
|
11238
|
+
# * CreateMultipartUpload
|
11501
11239
|
#
|
11502
|
-
# *
|
11240
|
+
# * CompleteMultipartUpload
|
11503
11241
|
#
|
11504
|
-
# *
|
11242
|
+
# * AbortMultipartUpload
|
11505
11243
|
#
|
11506
|
-
# *
|
11244
|
+
# * ListParts
|
11507
11245
|
#
|
11508
|
-
# *
|
11246
|
+
# * ListMultipartUploads
|
11509
11247
|
#
|
11510
11248
|
#
|
11511
11249
|
#
|
11512
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11513
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11514
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
11250
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
11251
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
11252
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
11521
11253
|
#
|
11522
11254
|
# @option params [String, StringIO, File] :body
|
11523
11255
|
# Object data.
|
@@ -11554,8 +11286,8 @@ module Aws::S3
|
|
11554
11286
|
# encrypting data. This value is used to store the object and then it is
|
11555
11287
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
11556
11288
|
# be appropriate for use with the algorithm specified in the
|
11557
|
-
# `x-amz-server-side
|
11558
|
-
# the same encryption key specified in the initiate multipart upload
|
11289
|
+
# `x-amz-server-side-encryption-customer-algorithm header`. This must
|
11290
|
+
# be the same encryption key specified in the initiate multipart upload
|
11559
11291
|
# request.
|
11560
11292
|
#
|
11561
11293
|
# @option params [String] :sse_customer_key_md5
|
@@ -11646,7 +11378,7 @@ module Aws::S3
|
|
11646
11378
|
# in the *Amazon Simple Storage Service Developer Guide*.
|
11647
11379
|
#
|
11648
11380
|
# <note markdown="1"> Instead of using an existing object as part data, you might use the
|
11649
|
-
#
|
11381
|
+
# UploadPart operation and provide data in your request.
|
11650
11382
|
#
|
11651
11383
|
# </note>
|
11652
11384
|
#
|
@@ -11659,20 +11391,20 @@ module Aws::S3
|
|
11659
11391
|
# the following:
|
11660
11392
|
#
|
11661
11393
|
# * For conceptual information about multipart uploads, see [Uploading
|
11662
|
-
# Objects Using Multipart Upload][
|
11394
|
+
# Objects Using Multipart Upload][2] in the *Amazon Simple Storage
|
11663
11395
|
# Service Developer Guide*.
|
11664
11396
|
#
|
11665
11397
|
# * For information about permissions required to use the multipart
|
11666
|
-
# upload API, see [Multipart Upload API and Permissions][
|
11398
|
+
# upload API, see [Multipart Upload API and Permissions][3] in the
|
11667
11399
|
# *Amazon Simple Storage Service Developer Guide*.
|
11668
11400
|
#
|
11669
11401
|
# * For information about copying objects using a single atomic
|
11670
|
-
# operation vs. the multipart upload, see [Operations on Objects][
|
11402
|
+
# operation vs. the multipart upload, see [Operations on Objects][4]
|
11671
11403
|
# in the *Amazon Simple Storage Service Developer Guide*.
|
11672
11404
|
#
|
11673
11405
|
# * For information about using server-side encryption with
|
11674
11406
|
# customer-provided encryption keys with the UploadPartCopy operation,
|
11675
|
-
# see
|
11407
|
+
# see CopyObject and UploadPart.
|
11676
11408
|
#
|
11677
11409
|
# Note the following additional considerations about the request headers
|
11678
11410
|
# `x-amz-copy-source-if-match`, `x-amz-copy-source-if-none-match`,
|
@@ -11745,31 +11477,24 @@ module Aws::S3
|
|
11745
11477
|
#
|
11746
11478
|
# **Related Resources**
|
11747
11479
|
#
|
11748
|
-
# *
|
11480
|
+
# * CreateMultipartUpload
|
11749
11481
|
#
|
11750
|
-
# *
|
11482
|
+
# * UploadPart
|
11751
11483
|
#
|
11752
|
-
# *
|
11484
|
+
# * CompleteMultipartUpload
|
11753
11485
|
#
|
11754
|
-
# *
|
11486
|
+
# * AbortMultipartUpload
|
11755
11487
|
#
|
11756
|
-
# *
|
11488
|
+
# * ListParts
|
11757
11489
|
#
|
11758
|
-
# *
|
11490
|
+
# * ListMultipartUploads
|
11759
11491
|
#
|
11760
11492
|
#
|
11761
11493
|
#
|
11762
11494
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/qfacts.html
|
11763
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11764
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
11765
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
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
|
11495
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
11496
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
11497
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
|
11773
11498
|
#
|
11774
11499
|
# @option params [required, String] :bucket
|
11775
11500
|
# The bucket name.
|
@@ -11818,8 +11543,8 @@ module Aws::S3
|
|
11818
11543
|
# encrypting data. This value is used to store the object and then it is
|
11819
11544
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
11820
11545
|
# be appropriate for use with the algorithm specified in the
|
11821
|
-
# `x-amz-server-side
|
11822
|
-
# the same encryption key specified in the initiate multipart upload
|
11546
|
+
# `x-amz-server-side-encryption-customer-algorithm` header. This must
|
11547
|
+
# be the same encryption key specified in the initiate multipart upload
|
11823
11548
|
# request.
|
11824
11549
|
#
|
11825
11550
|
# @option params [String] :sse_customer_key_md5
|
@@ -11863,45 +11588,45 @@ module Aws::S3
|
|
11863
11588
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
11864
11589
|
#
|
11865
11590
|
#
|
11866
|
-
# @example Example: To upload a part by copying
|
11591
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
11867
11592
|
#
|
11868
|
-
# # The following example uploads a part of a multipart upload by copying
|
11869
|
-
# # data source.
|
11593
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
11870
11594
|
#
|
11871
11595
|
# resp = client.upload_part_copy({
|
11872
11596
|
# bucket: "examplebucket",
|
11873
11597
|
# copy_source: "/bucketname/sourceobjectkey",
|
11874
|
-
# copy_source_range: "bytes=1-100000",
|
11875
11598
|
# key: "examplelargeobject",
|
11876
|
-
# part_number:
|
11599
|
+
# part_number: 1,
|
11877
11600
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
11878
11601
|
# })
|
11879
11602
|
#
|
11880
11603
|
# resp.to_h outputs the following:
|
11881
11604
|
# {
|
11882
11605
|
# copy_part_result: {
|
11883
|
-
# etag: "\"
|
11884
|
-
# last_modified: Time.parse("2016-12-29T21:
|
11606
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
11607
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
11885
11608
|
# },
|
11886
11609
|
# }
|
11887
11610
|
#
|
11888
|
-
# @example Example: To upload a part by copying
|
11611
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
11889
11612
|
#
|
11890
|
-
# # The following example uploads a part of a multipart upload by copying
|
11613
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
11614
|
+
# # data source.
|
11891
11615
|
#
|
11892
11616
|
# resp = client.upload_part_copy({
|
11893
11617
|
# bucket: "examplebucket",
|
11894
11618
|
# copy_source: "/bucketname/sourceobjectkey",
|
11619
|
+
# copy_source_range: "bytes=1-100000",
|
11895
11620
|
# key: "examplelargeobject",
|
11896
|
-
# part_number:
|
11621
|
+
# part_number: 2,
|
11897
11622
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
11898
11623
|
# })
|
11899
11624
|
#
|
11900
11625
|
# resp.to_h outputs the following:
|
11901
11626
|
# {
|
11902
11627
|
# copy_part_result: {
|
11903
|
-
# etag: "\"
|
11904
|
-
# last_modified: Time.parse("2016-12-29T21:
|
11628
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
11629
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
11905
11630
|
# },
|
11906
11631
|
# }
|
11907
11632
|
#
|
@@ -11960,7 +11685,7 @@ module Aws::S3
|
|
11960
11685
|
params: params,
|
11961
11686
|
config: config)
|
11962
11687
|
context[:gem_name] = 'aws-sdk-s3'
|
11963
|
-
context[:gem_version] = '1.
|
11688
|
+
context[:gem_version] = '1.78.0'
|
11964
11689
|
Seahorse::Client::Request.new(handlers, context)
|
11965
11690
|
end
|
11966
11691
|
|