aws-sdk-s3 1.77.0 → 1.78.0
Sign up to get free protection for your applications and to get access to all the features.
- 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
|
|