aws-sdk-s3 1.75.0 → 1.76.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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