aws-sdk-s3 1.75.0 → 1.76.0

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