aws-sdk-s3 1.72.0 → 1.77.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 (40) 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 +795 -507
  5. data/lib/aws-sdk-s3/customizations/object.rb +12 -1
  6. data/lib/aws-sdk-s3/encryption.rb +2 -0
  7. data/lib/aws-sdk-s3/encryption/client.rb +11 -0
  8. data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +64 -29
  9. data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +41 -5
  10. data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +5 -5
  11. data/lib/aws-sdk-s3/encryption/io_decrypter.rb +7 -6
  12. data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +32 -3
  13. data/lib/aws-sdk-s3/encryption/utils.rb +23 -0
  14. data/lib/aws-sdk-s3/encryptionV2/client.rb +201 -23
  15. data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +40 -12
  16. data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +77 -10
  17. data/lib/aws-sdk-s3/encryptionV2/default_key_provider.rb +2 -0
  18. data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +7 -4
  19. data/lib/aws-sdk-s3/encryptionV2/errors.rb +24 -0
  20. data/lib/aws-sdk-s3/encryptionV2/io_auth_decrypter.rb +2 -0
  21. data/lib/aws-sdk-s3/encryptionV2/io_decrypter.rb +2 -0
  22. data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +2 -0
  23. data/lib/aws-sdk-s3/encryptionV2/key_provider.rb +2 -0
  24. data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +90 -20
  25. data/lib/aws-sdk-s3/encryptionV2/materials.rb +2 -0
  26. data/lib/aws-sdk-s3/encryptionV2/utils.rb +2 -15
  27. data/lib/aws-sdk-s3/encryption_v2.rb +4 -1
  28. data/lib/aws-sdk-s3/file_uploader.rb +11 -0
  29. data/lib/aws-sdk-s3/multipart_file_uploader.rb +37 -2
  30. data/lib/aws-sdk-s3/multipart_upload_part.rb +5 -5
  31. data/lib/aws-sdk-s3/object.rb +10 -9
  32. data/lib/aws-sdk-s3/object_summary.rb +23 -7
  33. data/lib/aws-sdk-s3/object_version.rb +2 -2
  34. data/lib/aws-sdk-s3/plugins/accelerate.rb +27 -38
  35. data/lib/aws-sdk-s3/plugins/dualstack.rb +3 -1
  36. data/lib/aws-sdk-s3/plugins/sse_cpk.rb +1 -1
  37. data/lib/aws-sdk-s3/presigned_post.rb +61 -28
  38. data/lib/aws-sdk-s3/presigner.rb +2 -2
  39. data/lib/aws-sdk-s3/types.rb +63 -26
  40. metadata +4 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 67eaf9d666eee6c417f4f9aced38259b8d00f89c132cb4a74fe5301ce95d0b2c
4
- data.tar.gz: b8acde30dd530e8679d6ce5f285f37f60a93d3061e50f0bdb717cd71f8427e31
3
+ metadata.gz: 422b6a3ada8260b63191be267db716f2f368ea6beddf79715211383f1e43a694
4
+ data.tar.gz: 2fa30458ca058fc7594fdf92b26c46491cf44b9d5f724f279c72a8c3ee32557e
5
5
  SHA512:
6
- metadata.gz: 757f01efdd317aeb1ef9695a63ef55edf05e6e497fc0ca14e4d860b79affc3ca78ba7c989366a6ea595a18188a3019377e5feb0a79d7a1b62343bfc27f9199c7
7
- data.tar.gz: 64531554e412b4b136765c7acca78fff885ebc4fea865cee771e548319607e8f0c241e9dad46b4bcdc996a3178ca20ac83a662bbf90d771f69fd536a28a2d80b
6
+ metadata.gz: a3937af88ca256e605d8f83d34d34577c7c49c8357526fe27c8af61c6d58fe0fe54e630259b8a97848c9fc80bb8f72abf509c39c341ba137582bb3feac0b499d
7
+ data.tar.gz: 5b0dfeccd6803d948ec8db2282628e9647e4ce5efe08e09a4c32e7a40b9371103f3eef8b9e8c5210700a7e612bc5197bb23e291c9f4e7b117a20e22ff35260d6
@@ -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.72.0'
71
+ GEM_VERSION = '1.77.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
@@ -335,7 +335,7 @@ module Aws::S3
335
335
  # @option options [Boolean] :use_accelerate_endpoint (false)
336
336
  # When set to `true`, accelerated bucket endpoints will be used
337
337
  # for all object operations. You must first enable accelerate for
338
- # each bucket. [Go here for more information](http://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html).
338
+ # each bucket. [Go here for more information](http://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html).
339
339
  #
340
340
  # @option options [Boolean] :use_dualstack_endpoint (false)
341
341
  # When set to `true`, IPv6-compatible bucket endpoints will be used
@@ -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
@@ -4589,8 +4729,10 @@ module Aws::S3
4589
4729
  #
4590
4730
  # @example Streaming data to a block
4591
4731
  # # WARNING: yielding data to a block disables retries of networking errors
4732
+ # # However truncation of the body will be retried automatically using a range request
4592
4733
  # File.open('/path/to/file', 'wb') do |file|
4593
- # s3.get_object(bucket: 'bucket-name', key: 'object-key') do |chunk|
4734
+ # s3.get_object(bucket: 'bucket-name', key: 'object-key') do |chunk, headers|
4735
+ # # headers['content-length']
4594
4736
  # file.write(chunk)
4595
4737
  # end
4596
4738
  # end
@@ -4675,11 +4817,17 @@ module Aws::S3
4675
4817
  #
4676
4818
  # The following operations are related to `GetObjectAcl`\:
4677
4819
  #
4678
- # * GetObject
4820
+ # * [GetObject][1]
4821
+ #
4822
+ # * [DeleteObject][2]
4823
+ #
4824
+ # * [PutObject][3]
4679
4825
  #
4680
- # * DeleteObject
4681
4826
  #
4682
- # * 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
4683
4831
  #
4684
4832
  # @option params [required, String] :bucket
4685
4833
  # The bucket name that contains the object for which to get the ACL
@@ -4996,13 +5144,14 @@ module Aws::S3
4996
5144
  #
4997
5145
  # The following operation is related to `GetObjectTagging`\:
4998
5146
  #
4999
- # * PutObjectTagging
5147
+ # * [PutObjectTagging][2]
5000
5148
  #
5001
5149
  # ^
5002
5150
  #
5003
5151
  #
5004
5152
  #
5005
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
5006
5155
  #
5007
5156
  # @option params [required, String] :bucket
5008
5157
  # The bucket name containing the object for which to get the tagging
@@ -5115,13 +5264,14 @@ module Aws::S3
5115
5264
  #
5116
5265
  # The following operation is related to `GetObjectTorrent`\:
5117
5266
  #
5118
- # * GetObject
5267
+ # * [GetObject][2]
5119
5268
  #
5120
5269
  # ^
5121
5270
  #
5122
5271
  #
5123
5272
  #
5124
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
5125
5275
  #
5126
5276
  # @option params [String, IO] :response_target
5127
5277
  # Where to write response data, file path, or IO object.
@@ -5205,17 +5355,20 @@ module Aws::S3
5205
5355
  #
5206
5356
  # * [Using Amazon S3 Block Public Access][3]
5207
5357
  #
5208
- # * PutPublicAccessBlock
5358
+ # * [PutPublicAccessBlock][4]
5209
5359
  #
5210
- # * GetPublicAccessBlock
5360
+ # * [GetPublicAccessBlock][5]
5211
5361
  #
5212
- # * DeletePublicAccessBlock
5362
+ # * [DeletePublicAccessBlock][6]
5213
5363
  #
5214
5364
  #
5215
5365
  #
5216
5366
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
5217
5367
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
5218
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
5219
5372
  #
5220
5373
  # @option params [required, String] :bucket
5221
5374
  # The name of the Amazon S3 bucket whose `PublicAccessBlock`
@@ -5314,11 +5467,11 @@ module Aws::S3
5314
5467
  # Amazon S3, then when you retrieve the metadata from the object, you
5315
5468
  # must use the following headers:
5316
5469
  #
5317
- # * x-amz-server-side​-encryption​-customer-algorithm
5470
+ # * x-amz-server-side-encryption-customer-algorithm
5318
5471
  #
5319
- # * x-amz-server-side​-encryption​-customer-key
5472
+ # * x-amz-server-side-encryption-customer-key
5320
5473
  #
5321
- # * x-amz-server-side​-encryption​-customer-key-MD5
5474
+ # * x-amz-server-side-encryption-customer-key-MD5
5322
5475
  #
5323
5476
  # For more information about SSE-C, see [Server-Side Encryption (Using
5324
5477
  # Customer-Provided Encryption Keys)][1].
@@ -5372,7 +5525,7 @@ module Aws::S3
5372
5525
  #
5373
5526
  # The following operation is related to `HeadObject`\:
5374
5527
  #
5375
- # * GetObject
5528
+ # * [GetObject][5]
5376
5529
  #
5377
5530
  # ^
5378
5531
  #
@@ -5382,6 +5535,7 @@ module Aws::S3
5382
5535
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html
5383
5536
  # [3]: https://tools.ietf.org/html/rfc7232
5384
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
5385
5539
  #
5386
5540
  # @option params [required, String] :bucket
5387
5541
  # The name of the bucket containing the object.
@@ -5427,7 +5581,7 @@ module Aws::S3
5427
5581
  # encrypting data. This value is used to store the object and then it is
5428
5582
  # discarded; Amazon S3 does not store the encryption key. The key must
5429
5583
  # be appropriate for use with the algorithm specified in the
5430
- # `x-amz-server-side​-encryption​-customer-algorithm` header.
5584
+ # `x-amz-server-side-encryption-customer-algorithm` header.
5431
5585
  #
5432
5586
  # @option params [String] :sse_customer_key_md5
5433
5587
  # Specifies the 128-bit MD5 digest of the encryption key according to
@@ -5597,17 +5751,20 @@ module Aws::S3
5597
5751
  # The following operations are related to
5598
5752
  # `ListBucketAnalyticsConfigurations`\:
5599
5753
  #
5600
- # * GetBucketAnalyticsConfiguration
5754
+ # * [GetBucketAnalyticsConfiguration][4]
5601
5755
  #
5602
- # * DeleteBucketAnalyticsConfiguration
5756
+ # * [DeleteBucketAnalyticsConfiguration][5]
5603
5757
  #
5604
- # * PutBucketAnalyticsConfiguration
5758
+ # * [PutBucketAnalyticsConfiguration][6]
5605
5759
  #
5606
5760
  #
5607
5761
  #
5608
5762
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
5609
5763
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
5610
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
5611
5768
  #
5612
5769
  # @option params [required, String] :bucket
5613
5770
  # The name of the bucket from which analytics configurations are
@@ -5685,17 +5842,20 @@ module Aws::S3
5685
5842
  # The following operations are related to
5686
5843
  # `ListBucketInventoryConfigurations`\:
5687
5844
  #
5688
- # * GetBucketInventoryConfiguration
5845
+ # * [GetBucketInventoryConfiguration][4]
5689
5846
  #
5690
- # * DeleteBucketInventoryConfiguration
5847
+ # * [DeleteBucketInventoryConfiguration][5]
5691
5848
  #
5692
- # * PutBucketInventoryConfiguration
5849
+ # * [PutBucketInventoryConfiguration][6]
5693
5850
  #
5694
5851
  #
5695
5852
  #
5696
5853
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
5697
5854
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
5698
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
5699
5859
  #
5700
5860
  # @option params [required, String] :bucket
5701
5861
  # The name of the bucket containing the inventory configurations to
@@ -5776,17 +5936,20 @@ module Aws::S3
5776
5936
  # The following operations are related to
5777
5937
  # `ListBucketMetricsConfigurations`\:
5778
5938
  #
5779
- # * PutBucketMetricsConfiguration
5939
+ # * [PutBucketMetricsConfiguration][4]
5780
5940
  #
5781
- # * GetBucketMetricsConfiguration
5941
+ # * [GetBucketMetricsConfiguration][5]
5782
5942
  #
5783
- # * DeleteBucketMetricsConfiguration
5943
+ # * [DeleteBucketMetricsConfiguration][6]
5784
5944
  #
5785
5945
  #
5786
5946
  #
5787
5947
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
5788
5948
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
5789
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
5790
5953
  #
5791
5954
  # @option params [required, String] :bucket
5792
5955
  # The name of the bucket containing the metrics configurations to
@@ -5922,20 +6085,25 @@ module Aws::S3
5922
6085
  #
5923
6086
  # The following operations are related to `ListMultipartUploads`\:
5924
6087
  #
5925
- # * CreateMultipartUpload
6088
+ # * [CreateMultipartUpload][3]
5926
6089
  #
5927
- # * UploadPart
6090
+ # * [UploadPart][4]
5928
6091
  #
5929
- # * CompleteMultipartUpload
6092
+ # * [CompleteMultipartUpload][5]
5930
6093
  #
5931
- # * ListParts
6094
+ # * [ListParts][6]
5932
6095
  #
5933
- # * AbortMultipartUpload
6096
+ # * [AbortMultipartUpload][7]
5934
6097
  #
5935
6098
  #
5936
6099
  #
5937
6100
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
5938
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
5939
6107
  #
5940
6108
  # @option params [required, String] :bucket
5941
6109
  # Name of the bucket to which the multipart upload was initiated.
@@ -6020,97 +6188,97 @@ module Aws::S3
6020
6188
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
6021
6189
  #
6022
6190
  #
6023
- # @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
6024
6192
  #
6025
- # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
6026
- # # setup of multipart uploads.
6193
+ # # The following example lists in-progress multipart uploads on a specific bucket.
6027
6194
  #
6028
6195
  # resp = client.list_multipart_uploads({
6029
6196
  # bucket: "examplebucket",
6030
- # key_marker: "nextkeyfrompreviousresponse",
6031
- # max_uploads: 2,
6032
- # upload_id_marker: "valuefrompreviousresponse",
6033
6197
  # })
6034
6198
  #
6035
6199
  # resp.to_h outputs the following:
6036
6200
  # {
6037
- # bucket: "acl1",
6038
- # is_truncated: true,
6039
- # key_marker: "",
6040
- # max_uploads: 2,
6041
- # next_key_marker: "someobjectkey",
6042
- # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
6043
- # upload_id_marker: "",
6044
6201
  # uploads: [
6045
6202
  # {
6046
6203
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
6047
6204
  # initiator: {
6048
- # display_name: "ownder-display-name",
6205
+ # display_name: "display-name",
6049
6206
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6050
6207
  # },
6051
6208
  # key: "JavaFile",
6052
6209
  # owner: {
6053
- # display_name: "mohanataws",
6054
- # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6210
+ # display_name: "display-name",
6211
+ # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6055
6212
  # },
6056
6213
  # storage_class: "STANDARD",
6057
- # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
6214
+ # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
6058
6215
  # },
6059
6216
  # {
6060
6217
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
6061
6218
  # initiator: {
6062
- # display_name: "ownder-display-name",
6219
+ # display_name: "display-name",
6063
6220
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6064
6221
  # },
6065
6222
  # key: "JavaFile",
6066
6223
  # owner: {
6067
- # display_name: "ownder-display-name",
6224
+ # display_name: "display-name",
6068
6225
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6069
6226
  # },
6070
6227
  # storage_class: "STANDARD",
6071
- # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
6228
+ # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
6072
6229
  # },
6073
6230
  # ],
6074
6231
  # }
6075
6232
  #
6076
- # @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
6077
6234
  #
6078
- # # 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.
6079
6237
  #
6080
6238
  # resp = client.list_multipart_uploads({
6081
6239
  # bucket: "examplebucket",
6240
+ # key_marker: "nextkeyfrompreviousresponse",
6241
+ # max_uploads: 2,
6242
+ # upload_id_marker: "valuefrompreviousresponse",
6082
6243
  # })
6083
6244
  #
6084
6245
  # resp.to_h outputs the following:
6085
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: "",
6086
6254
  # uploads: [
6087
6255
  # {
6088
6256
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
6089
6257
  # initiator: {
6090
- # display_name: "display-name",
6258
+ # display_name: "ownder-display-name",
6091
6259
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6092
6260
  # },
6093
6261
  # key: "JavaFile",
6094
6262
  # owner: {
6095
- # display_name: "display-name",
6096
- # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6263
+ # display_name: "mohanataws",
6264
+ # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6097
6265
  # },
6098
6266
  # storage_class: "STANDARD",
6099
- # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
6267
+ # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
6100
6268
  # },
6101
6269
  # {
6102
6270
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
6103
6271
  # initiator: {
6104
- # display_name: "display-name",
6272
+ # display_name: "ownder-display-name",
6105
6273
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6106
6274
  # },
6107
6275
  # key: "JavaFile",
6108
6276
  # owner: {
6109
- # display_name: "display-name",
6277
+ # display_name: "ownder-display-name",
6110
6278
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
6111
6279
  # },
6112
6280
  # storage_class: "STANDARD",
6113
- # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
6281
+ # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
6114
6282
  # },
6115
6283
  # ],
6116
6284
  # }
@@ -6174,13 +6342,20 @@ module Aws::S3
6174
6342
  #
6175
6343
  # The following operations are related to `ListObjectVersions`\:
6176
6344
  #
6177
- # * ListObjectsV2
6345
+ # * [ListObjectsV2][1]
6346
+ #
6347
+ # * [GetObject][2]
6348
+ #
6349
+ # * [PutObject][3]
6350
+ #
6351
+ # * [DeleteObject][4]
6178
6352
  #
6179
- # * GetObject
6180
6353
  #
6181
- # * PutObject
6182
6354
  #
6183
- # * 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
6184
6359
  #
6185
6360
  # @option params [required, String] :bucket
6186
6361
  # The bucket name that contains the objects.
@@ -6357,20 +6532,28 @@ module Aws::S3
6357
6532
  # of the response and handle it appropriately.
6358
6533
  #
6359
6534
  # This API has been revised. We recommend that you use the newer
6360
- # version, ListObjectsV2, when developing applications. For backward
6361
- # compatibility, Amazon S3 continues to support `ListObjects`.
6535
+ # version, [ListObjectsV2][1], when developing applications. For
6536
+ # backward compatibility, Amazon S3 continues to support `ListObjects`.
6362
6537
  #
6363
6538
  # The following operations are related to `ListObjects`\:
6364
6539
  #
6365
- # * ListObjectsV2
6540
+ # * [ListObjectsV2][1]
6366
6541
  #
6367
- # * GetObject
6542
+ # * [GetObject][2]
6368
6543
  #
6369
- # * PutObject
6544
+ # * [PutObject][3]
6370
6545
  #
6371
- # * CreateBucket
6546
+ # * [CreateBucket][4]
6372
6547
  #
6373
- # * 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
6374
6557
  #
6375
6558
  # @option params [required, String] :bucket
6376
6559
  # The name of the bucket containing the objects.
@@ -6516,22 +6699,27 @@ module Aws::S3
6516
6699
  # This section describes the latest revision of the API. We recommend
6517
6700
  # that you use this revised API for application development. For
6518
6701
  # backward compatibility, Amazon S3 continues to support the prior
6519
- # version of this API, ListObjects.
6702
+ # version of this API, [ListObjects][3].
6520
6703
  #
6521
- # To get a list of your buckets, see ListBuckets.
6704
+ # To get a list of your buckets, see [ListBuckets][4].
6522
6705
  #
6523
6706
  # The following operations are related to `ListObjectsV2`\:
6524
6707
  #
6525
- # * GetObject
6708
+ # * [GetObject][5]
6526
6709
  #
6527
- # * PutObject
6710
+ # * [PutObject][6]
6528
6711
  #
6529
- # * CreateBucket
6712
+ # * [CreateBucket][7]
6530
6713
  #
6531
6714
  #
6532
6715
  #
6533
6716
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6534
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
6535
6723
  #
6536
6724
  # @option params [required, String] :bucket
6537
6725
  # Bucket name to list.
@@ -6685,7 +6873,7 @@ module Aws::S3
6685
6873
  # Lists the parts that have been uploaded for a specific multipart
6686
6874
  # upload. This operation must include the upload ID, which you obtain by
6687
6875
  # sending the initiate multipart upload request (see
6688
- # CreateMultipartUpload). This request returns a maximum of 1,000
6876
+ # [CreateMultipartUpload][1]). This request returns a maximum of 1,000
6689
6877
  # uploaded parts. The default number of parts returned is 1,000 parts.
6690
6878
  # You can restrict the number of parts returned by specifying the
6691
6879
  # `max-parts` request parameter. If your multipart upload consists of
@@ -6696,27 +6884,32 @@ module Aws::S3
6696
6884
  # field value from the previous response.
6697
6885
  #
6698
6886
  # For more information on multipart uploads, see [Uploading Objects
6699
- # Using Multipart Upload][1].
6887
+ # Using Multipart Upload][2].
6700
6888
  #
6701
6889
  # For information on permissions required to use the multipart upload
6702
- # API, see [Multipart Upload API and Permissions][2].
6890
+ # API, see [Multipart Upload API and Permissions][3].
6703
6891
  #
6704
6892
  # The following operations are related to `ListParts`\:
6705
6893
  #
6706
- # * CreateMultipartUpload
6894
+ # * [CreateMultipartUpload][1]
6707
6895
  #
6708
- # * UploadPart
6896
+ # * [UploadPart][4]
6709
6897
  #
6710
- # * CompleteMultipartUpload
6898
+ # * [CompleteMultipartUpload][5]
6711
6899
  #
6712
- # * AbortMultipartUpload
6900
+ # * [AbortMultipartUpload][6]
6713
6901
  #
6714
- # * ListMultipartUploads
6902
+ # * [ListMultipartUploads][7]
6715
6903
  #
6716
6904
  #
6717
6905
  #
6718
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
6719
- # [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
6720
6913
  #
6721
6914
  # @option params [required, String] :bucket
6722
6915
  # Name of the bucket to which the parts are being uploaded.
@@ -6876,8 +7069,8 @@ module Aws::S3
6876
7069
  #
6877
7070
  # * Suspended – Disables accelerated data transfers to the bucket.
6878
7071
  #
6879
- # The GetBucketAccelerateConfiguration operation returns the transfer
6880
- # acceleration state of a bucket.
7072
+ # The [GetBucketAccelerateConfiguration][3] operation returns the
7073
+ # transfer acceleration state of a bucket.
6881
7074
  #
6882
7075
  # After setting the Transfer Acceleration state of a bucket to Enabled,
6883
7076
  # it might take up to thirty minutes before the data transfer rates to
@@ -6887,20 +7080,22 @@ module Aws::S3
6887
7080
  # DNS-compliant and must not contain periods (".").
6888
7081
  #
6889
7082
  # For more information about transfer acceleration, see [Transfer
6890
- # Acceleration][3].
7083
+ # Acceleration][4].
6891
7084
  #
6892
7085
  # The following operations are related to
6893
7086
  # `PutBucketAccelerateConfiguration`\:
6894
7087
  #
6895
- # * GetBucketAccelerateConfiguration
7088
+ # * [GetBucketAccelerateConfiguration][3]
6896
7089
  #
6897
- # * CreateBucket
7090
+ # * [CreateBucket][5]
6898
7091
  #
6899
7092
  #
6900
7093
  #
6901
7094
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6902
7095
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6903
- # [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
6904
7099
  #
6905
7100
  # @option params [required, String] :bucket
6906
7101
  # Name of the bucket for which the accelerate configuration is set.
@@ -7069,11 +7264,11 @@ module Aws::S3
7069
7264
  #
7070
7265
  # **Related Resources**
7071
7266
  #
7072
- # * CreateBucket
7267
+ # * [CreateBucket][5]
7073
7268
  #
7074
- # * DeleteBucket
7269
+ # * [DeleteBucket][6]
7075
7270
  #
7076
- # * GetObjectAcl
7271
+ # * [GetObjectAcl][7]
7077
7272
  #
7078
7273
  #
7079
7274
  #
@@ -7081,6 +7276,9 @@ module Aws::S3
7081
7276
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
7082
7277
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
7083
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
7084
7282
  #
7085
7283
  # @option params [String] :acl
7086
7284
  # The canned ACL to apply to the bucket.
@@ -7225,9 +7423,11 @@ module Aws::S3
7225
7423
  #
7226
7424
  # **Related Resources**
7227
7425
  #
7228
- # *
7229
- # *
7230
- # *
7426
+ # * [GetBucketAnalyticsConfiguration][5]
7427
+ #
7428
+ # * [DeleteBucketAnalyticsConfiguration][6]
7429
+ #
7430
+ # * [ListBucketAnalyticsConfigurations][7]
7231
7431
  #
7232
7432
  #
7233
7433
  #
@@ -7235,6 +7435,9 @@ module Aws::S3
7235
7435
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
7236
7436
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7237
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
7238
7441
  #
7239
7442
  # @option params [required, String] :bucket
7240
7443
  # The name of the bucket to which an analytics configuration is stored.
@@ -7335,15 +7538,18 @@ module Aws::S3
7335
7538
  #
7336
7539
  # **Related Resources**
7337
7540
  #
7338
- # * GetBucketCors
7541
+ # * [GetBucketCors][2]
7339
7542
  #
7340
- # * DeleteBucketCors
7543
+ # * [DeleteBucketCors][3]
7341
7544
  #
7342
- # * RESTOPTIONSobject
7545
+ # * [RESTOPTIONSobject][4]
7343
7546
  #
7344
7547
  #
7345
7548
  #
7346
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
7347
7553
  #
7348
7554
  # @option params [required, String] :bucket
7349
7555
  # Specifies the bucket impacted by the `cors`configuration.
@@ -7463,15 +7669,17 @@ module Aws::S3
7463
7669
  #
7464
7670
  # **Related Resources**
7465
7671
  #
7466
- # * GetBucketEncryption
7672
+ # * [GetBucketEncryption][4]
7467
7673
  #
7468
- # * DeleteBucketEncryption
7674
+ # * [DeleteBucketEncryption][5]
7469
7675
  #
7470
7676
  #
7471
7677
  #
7472
7678
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
7473
7679
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7474
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
7475
7683
  #
7476
7684
  # @option params [required, String] :bucket
7477
7685
  # Specifies default encryption for a bucket using server-side encryption
@@ -7577,11 +7785,11 @@ module Aws::S3
7577
7785
  #
7578
7786
  # **Related Resources**
7579
7787
  #
7580
- # * GetBucketInventoryConfiguration
7788
+ # * [GetBucketInventoryConfiguration][5]
7581
7789
  #
7582
- # * DeleteBucketInventoryConfiguration
7790
+ # * [DeleteBucketInventoryConfiguration][6]
7583
7791
  #
7584
- # * ListBucketInventoryConfigurations
7792
+ # * [ListBucketInventoryConfigurations][7]
7585
7793
  #
7586
7794
  #
7587
7795
  #
@@ -7589,6 +7797,9 @@ module Aws::S3
7589
7797
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
7590
7798
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7591
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
7592
7803
  #
7593
7804
  # @option params [required, String] :bucket
7594
7805
  # The name of the bucket where the inventory configuration will be
@@ -7646,13 +7857,13 @@ module Aws::S3
7646
7857
  end
7647
7858
 
7648
7859
  # For an updated version of this API, see
7649
- # PutBucketLifecycleConfiguration. This version has been deprecated.
7650
- # Existing lifecycle configurations will work. For new lifecycle
7651
- # 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.
7652
7863
  #
7653
7864
  # Creates a new lifecycle configuration for the bucket or replaces an
7654
7865
  # existing lifecycle configuration. For information about lifecycle
7655
- # configuration, see [Object Lifecycle Management][1] in the *Amazon
7866
+ # configuration, see [Object Lifecycle Management][2] in the *Amazon
7656
7867
  # Simple Storage Service Developer Guide*.
7657
7868
  #
7658
7869
  # By default, all Amazon S3 resources, including buckets, objects, and
@@ -7675,36 +7886,41 @@ module Aws::S3
7675
7886
  # * `s3:PutLifecycleConfiguration`
7676
7887
  #
7677
7888
  # For more information about permissions, see [Managing Access
7678
- # Permissions to your Amazon S3 Resources][2] in the *Amazon Simple
7889
+ # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
7679
7890
  # Storage Service Developer Guide*.
7680
7891
  #
7681
7892
  # For more examples of transitioning objects to storage classes such as
7682
7893
  # STANDARD\_IA or ONEZONE\_IA, see [Examples of Lifecycle
7683
- # Configuration][3].
7894
+ # Configuration][4].
7684
7895
  #
7685
7896
  # **Related Resources**
7686
7897
  #
7687
- # * GetBucketLifecycle(Deprecated)
7898
+ # * [GetBucketLifecycle][5](Deprecated)
7899
+ #
7900
+ # * [GetBucketLifecycleConfiguration][6]
7688
7901
  #
7689
- # * GetBucketLifecycleConfiguration
7902
+ # * [RestoreObject][7]
7690
7903
  #
7691
- # *
7692
7904
  # * By default, a resource owner—in this case, a bucket owner, which is
7693
7905
  # the AWS account that created the bucket—can perform any of the
7694
7906
  # operations. A resource owner can also grant others permission to
7695
7907
  # perform the operation. For more information, see the following
7696
7908
  # topics in the Amazon Simple Storage Service Developer Guide:
7697
7909
  #
7698
- # * [Specifying Permissions in a Policy][4]
7910
+ # * [Specifying Permissions in a Policy][8]
7699
7911
  #
7700
- # * [Managing Access Permissions to your Amazon S3 Resources][2]
7912
+ # * [Managing Access Permissions to your Amazon S3 Resources][3]
7701
7913
  #
7702
7914
  #
7703
7915
  #
7704
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
7705
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
7706
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#lifecycle-configuration-examples
7707
- # [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
7708
7924
  #
7709
7925
  # @option params [required, String] :bucket
7710
7926
  #
@@ -7770,7 +7986,7 @@ module Aws::S3
7770
7986
  # API. The previous version of the API supported filtering based only on
7771
7987
  # an object key name prefix, which is supported for backward
7772
7988
  # compatibility. For the related API description, see
7773
- # PutBucketLifecycle.
7989
+ # [PutBucketLifecycle][2].
7774
7990
  #
7775
7991
  # </note>
7776
7992
  #
@@ -7794,8 +8010,8 @@ module Aws::S3
7794
8010
  # S3 provides predefined actions that you can specify for current and
7795
8011
  # noncurrent object versions.
7796
8012
  #
7797
- # For more information, see [Object Lifecycle Management][2] and
7798
- # [Lifecycle Configuration Elements][3].
8013
+ # For more information, see [Object Lifecycle Management][3] and
8014
+ # [Lifecycle Configuration Elements][4].
7799
8015
  #
7800
8016
  # **Permissions**
7801
8017
  #
@@ -7823,18 +8039,21 @@ module Aws::S3
7823
8039
  #
7824
8040
  # The following are related to `PutBucketLifecycleConfiguration`\:
7825
8041
  #
7826
- # * [Examples of Lifecycle Configuration][4]
8042
+ # * [Examples of Lifecycle Configuration][5]
7827
8043
  #
7828
- # * GetBucketLifecycleConfiguration
8044
+ # * [GetBucketLifecycleConfiguration][6]
7829
8045
  #
7830
- # * DeleteBucketLifecycle
8046
+ # * [DeleteBucketLifecycle][7]
7831
8047
  #
7832
8048
  #
7833
8049
  #
7834
8050
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
7835
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
7836
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
7837
- # [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
7838
8057
  #
7839
8058
  # @option params [required, String] :bucket
7840
8059
  # The name of the bucket for which to set the configuration.
@@ -7983,23 +8202,27 @@ module Aws::S3
7983
8202
  # For more information about server access logging, see [Server Access
7984
8203
  # Logging][1].
7985
8204
  #
7986
- # For more information about creating a bucket, see CreateBucket. For
7987
- # more information about returning the logging status of a bucket, see
7988
- # 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].
7989
8208
  #
7990
8209
  # The following operations are related to `PutBucketLogging`\:
7991
8210
  #
7992
- # * PutObject
8211
+ # * [PutObject][4]
7993
8212
  #
7994
- # * DeleteBucket
8213
+ # * [DeleteBucket][5]
7995
8214
  #
7996
- # * CreateBucket
8215
+ # * [CreateBucket][2]
7997
8216
  #
7998
- # * GetBucketLogging
8217
+ # * [GetBucketLogging][3]
7999
8218
  #
8000
8219
  #
8001
8220
  #
8002
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
8003
8226
  #
8004
8227
  # @option params [required, String] :bucket
8005
8228
  # The name of the bucket for which to set the logging parameters.
@@ -8091,11 +8314,11 @@ module Aws::S3
8091
8314
  # The following operations are related to
8092
8315
  # `PutBucketMetricsConfiguration`\:
8093
8316
  #
8094
- # * DeleteBucketMetricsConfiguration
8317
+ # * [DeleteBucketMetricsConfiguration][4]
8095
8318
  #
8096
- # * PutBucketMetricsConfiguration
8319
+ # * [PutBucketMetricsConfiguration][5]
8097
8320
  #
8098
- # * ListBucketMetricsConfigurations
8321
+ # * [ListBucketMetricsConfigurations][6]
8099
8322
  #
8100
8323
  # `GetBucketLifecycle` has the following special error:
8101
8324
  #
@@ -8111,6 +8334,9 @@ module Aws::S3
8111
8334
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8112
8335
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8113
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
8114
8340
  #
8115
8341
  # @option params [required, String] :bucket
8116
8342
  # The name of the bucket for which the metrics configuration is set.
@@ -8158,7 +8384,12 @@ module Aws::S3
8158
8384
  req.send_request(options)
8159
8385
  end
8160
8386
 
8161
- # 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
8162
8393
  #
8163
8394
  # @option params [required, String] :bucket
8164
8395
  # The name of the bucket.
@@ -8266,13 +8497,14 @@ module Aws::S3
8266
8497
  # The following operation is related to
8267
8498
  # `PutBucketNotificationConfiguration`\:
8268
8499
  #
8269
- # * GetBucketNotificationConfiguration
8500
+ # * [GetBucketNotificationConfiguration][2]
8270
8501
  #
8271
8502
  # ^
8272
8503
  #
8273
8504
  #
8274
8505
  #
8275
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
8276
8508
  #
8277
8509
  # @option params [required, String] :bucket
8278
8510
  # The name of the bucket.
@@ -8391,13 +8623,15 @@ module Aws::S3
8391
8623
  #
8392
8624
  # The following operations are related to `PutBucketPolicy`\:
8393
8625
  #
8394
- # * CreateBucket
8626
+ # * [CreateBucket][2]
8395
8627
  #
8396
- # * DeleteBucket
8628
+ # * [DeleteBucket][3]
8397
8629
  #
8398
8630
  #
8399
8631
  #
8400
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
8401
8635
  #
8402
8636
  # @option params [required, String] :bucket
8403
8637
  # The name of the bucket.
@@ -8470,6 +8704,17 @@ module Aws::S3
8470
8704
  # configuration, you must also add the following elements:
8471
8705
  # `DeleteMarkerReplication`, `Status`, and `Priority`.
8472
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
+ #
8473
8718
  # For information about enabling versioning on a bucket, see [Using
8474
8719
  # Versioning][3].
8475
8720
  #
@@ -8490,14 +8735,14 @@ module Aws::S3
8490
8735
  # about replication configuration, see [Replicating Objects Created with
8491
8736
  # SSE Using CMKs stored in AWS KMS][6].
8492
8737
  #
8493
- # For information on `PutBucketReplication` errors, see
8494
- # ReplicationErrorCodeList
8738
+ # For information on `PutBucketReplication` errors, see [List of
8739
+ # replication-related error codes][7]
8495
8740
  #
8496
8741
  # The following operations are related to `PutBucketReplication`\:
8497
8742
  #
8498
- # * GetBucketReplication
8743
+ # * [GetBucketReplication][8]
8499
8744
  #
8500
- # * DeleteBucketReplication
8745
+ # * [DeleteBucketReplication][9]
8501
8746
  #
8502
8747
  #
8503
8748
  #
@@ -8507,6 +8752,9 @@ module Aws::S3
8507
8752
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8508
8753
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8509
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
8510
8758
  #
8511
8759
  # @option params [required, String] :bucket
8512
8760
  # The name of the bucket
@@ -8636,13 +8884,15 @@ module Aws::S3
8636
8884
  #
8637
8885
  # The following operations are related to `PutBucketRequestPayment`\:
8638
8886
  #
8639
- # * CreateBucket
8887
+ # * [CreateBucket][2]
8640
8888
  #
8641
- # * GetBucketRequestPayment
8889
+ # * [GetBucketRequestPayment][3]
8642
8890
  #
8643
8891
  #
8644
8892
  #
8645
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
8646
8896
  #
8647
8897
  # @option params [required, String] :bucket
8648
8898
  # The bucket name.
@@ -8750,9 +9000,9 @@ module Aws::S3
8750
9000
  #
8751
9001
  # The following operations are related to `PutBucketTagging`\:
8752
9002
  #
8753
- # * GetBucketTagging
9003
+ # * [GetBucketTagging][7]
8754
9004
  #
8755
- # * DeleteBucketTagging
9005
+ # * [DeleteBucketTagging][8]
8756
9006
  #
8757
9007
  #
8758
9008
  #
@@ -8762,6 +9012,8 @@ module Aws::S3
8762
9012
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8763
9013
  # [5]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
8764
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
8765
9017
  #
8766
9018
  # @option params [required, String] :bucket
8767
9019
  # The bucket name.
@@ -8837,7 +9089,7 @@ module Aws::S3
8837
9089
  # objects added to the bucket receive the version ID null.
8838
9090
  #
8839
9091
  # If the versioning state has never been set on a bucket, it has no
8840
- # versioning state; a GetBucketVersioning request does not return a
9092
+ # versioning state; a [GetBucketVersioning][1] request does not return a
8841
9093
  # versioning state value.
8842
9094
  #
8843
9095
  # If the bucket owner enables MFA Delete in the bucket versioning
@@ -8852,19 +9104,22 @@ module Aws::S3
8852
9104
  # manage the deletes of the noncurrent object versions in the
8853
9105
  # version-enabled bucket. (A version-enabled bucket maintains one
8854
9106
  # current and zero or more noncurrent object versions.) For more
8855
- # information, see [Lifecycle and Versioning][1].
9107
+ # information, see [Lifecycle and Versioning][2].
8856
9108
  #
8857
9109
  # **Related Resources**
8858
9110
  #
8859
- # * CreateBucket
9111
+ # * [CreateBucket][3]
8860
9112
  #
8861
- # * DeleteBucket
9113
+ # * [DeleteBucket][4]
8862
9114
  #
8863
- # * GetBucketVersioning
9115
+ # * [GetBucketVersioning][1]
8864
9116
  #
8865
9117
  #
8866
9118
  #
8867
- # [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
8868
9123
  #
8869
9124
  # @option params [required, String] :bucket
8870
9125
  # The bucket name.
@@ -9137,13 +9392,13 @@ module Aws::S3
9137
9392
  #
9138
9393
  # For more information about versioning, see [Adding Objects to
9139
9394
  # Versioning Enabled Buckets][6]. For information about returning the
9140
- # versioning state of a bucket, see GetBucketVersioning.
9395
+ # versioning state of a bucket, see [GetBucketVersioning][7].
9141
9396
  #
9142
9397
  # **Related Resources**
9143
9398
  #
9144
- # * CopyObject
9399
+ # * [CopyObject][8]
9145
9400
  #
9146
- # * DeleteObject
9401
+ # * [DeleteObject][9]
9147
9402
  #
9148
9403
  #
9149
9404
  #
@@ -9153,6 +9408,9 @@ module Aws::S3
9153
9408
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html
9154
9409
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
9155
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
9156
9414
  #
9157
9415
  # @option params [String] :acl
9158
9416
  # The canned ACL to apply to the object. For more information, see
@@ -9162,7 +9420,7 @@ module Aws::S3
9162
9420
  #
9163
9421
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
9164
9422
  #
9165
- # @option params [String, IO] :body
9423
+ # @option params [String, StringIO, File] :body
9166
9424
  # Object data.
9167
9425
  #
9168
9426
  # @option params [required, String] :bucket
@@ -9313,7 +9571,7 @@ module Aws::S3
9313
9571
  # encrypting data. This value is used to store the object and then it is
9314
9572
  # discarded; Amazon S3 does not store the encryption key. The key must
9315
9573
  # be appropriate for use with the algorithm specified in the
9316
- # `x-amz-server-side​-encryption​-customer-algorithm` header.
9574
+ # `x-amz-server-side-encryption-customer-algorithm` header.
9317
9575
  #
9318
9576
  # @option params [String] :sse_customer_key_md5
9319
9577
  # Specifies the 128-bit MD5 digest of the encryption key according to
@@ -9380,134 +9638,134 @@ module Aws::S3
9380
9638
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
9381
9639
  #
9382
9640
  #
9383
- # @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
9384
9642
  #
9385
- # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
9386
- # # 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.
9387
9645
  #
9388
9646
  # resp = client.put_object({
9389
9647
  # body: "filetoupload",
9390
9648
  # bucket: "examplebucket",
9391
9649
  # key: "exampleobject",
9392
- # server_side_encryption: "AES256",
9393
- # tagging: "key1=value1&key2=value2",
9650
+ # metadata: {
9651
+ # "metadata1" => "value1",
9652
+ # "metadata2" => "value2",
9653
+ # },
9394
9654
  # })
9395
9655
  #
9396
9656
  # resp.to_h outputs the following:
9397
9657
  # {
9398
9658
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9399
- # server_side_encryption: "AES256",
9400
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
9659
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
9401
9660
  # }
9402
9661
  #
9403
- # @example Example: To create an object.
9662
+ # @example Example: To upload an object and specify canned ACL.
9404
9663
  #
9405
- # # 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.
9406
9666
  #
9407
9667
  # resp = client.put_object({
9668
+ # acl: "authenticated-read",
9408
9669
  # body: "filetoupload",
9409
9670
  # bucket: "examplebucket",
9410
- # key: "objectkey",
9671
+ # key: "exampleobject",
9411
9672
  # })
9412
9673
  #
9413
9674
  # resp.to_h outputs the following:
9414
9675
  # {
9415
9676
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9416
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
9677
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
9417
9678
  # }
9418
9679
  #
9419
- # @example Example: To upload an object and specify optional tags
9680
+ # @example Example: To create an object.
9420
9681
  #
9421
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
9422
- # # 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.
9423
9683
  #
9424
9684
  # resp = client.put_object({
9425
- # body: "c:\\HappyFace.jpg",
9685
+ # body: "filetoupload",
9426
9686
  # bucket: "examplebucket",
9427
- # key: "HappyFace.jpg",
9428
- # tagging: "key1=value1&key2=value2",
9687
+ # key: "objectkey",
9429
9688
  # })
9430
9689
  #
9431
9690
  # resp.to_h outputs the following:
9432
9691
  # {
9433
9692
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9434
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
9693
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
9435
9694
  # }
9436
9695
  #
9437
- # @example Example: To upload an object (specify optional headers)
9696
+ # @example Example: To upload an object
9438
9697
  #
9439
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
9440
- # # 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.
9441
9700
  #
9442
9701
  # resp = client.put_object({
9443
9702
  # body: "HappyFace.jpg",
9444
9703
  # bucket: "examplebucket",
9445
9704
  # key: "HappyFace.jpg",
9446
- # server_side_encryption: "AES256",
9447
- # storage_class: "STANDARD_IA",
9448
9705
  # })
9449
9706
  #
9450
9707
  # resp.to_h outputs the following:
9451
9708
  # {
9452
9709
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9453
- # server_side_encryption: "AES256",
9454
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
9710
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
9455
9711
  # }
9456
9712
  #
9457
- # @example Example: To upload object and specify user-defined metadata
9713
+ # @example Example: To upload an object and specify optional tags
9458
9714
  #
9459
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
9460
- # # 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.
9461
9717
  #
9462
9718
  # resp = client.put_object({
9463
- # body: "filetoupload",
9719
+ # body: "c:\\HappyFace.jpg",
9464
9720
  # bucket: "examplebucket",
9465
- # key: "exampleobject",
9466
- # metadata: {
9467
- # "metadata1" => "value1",
9468
- # "metadata2" => "value2",
9469
- # },
9721
+ # key: "HappyFace.jpg",
9722
+ # tagging: "key1=value1&key2=value2",
9470
9723
  # })
9471
9724
  #
9472
9725
  # resp.to_h outputs the following:
9473
9726
  # {
9474
9727
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9475
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
9728
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
9476
9729
  # }
9477
9730
  #
9478
- # @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
9479
9732
  #
9480
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
9481
- # # 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.
9482
9735
  #
9483
9736
  # resp = client.put_object({
9484
- # acl: "authenticated-read",
9485
9737
  # body: "filetoupload",
9486
9738
  # bucket: "examplebucket",
9487
9739
  # key: "exampleobject",
9740
+ # server_side_encryption: "AES256",
9741
+ # tagging: "key1=value1&key2=value2",
9488
9742
  # })
9489
9743
  #
9490
9744
  # resp.to_h outputs the following:
9491
9745
  # {
9492
9746
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9493
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
9747
+ # server_side_encryption: "AES256",
9748
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
9494
9749
  # }
9495
9750
  #
9496
- # @example Example: To upload an object
9751
+ # @example Example: To upload an object (specify optional headers)
9497
9752
  #
9498
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
9499
- # # 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.
9500
9755
  #
9501
9756
  # resp = client.put_object({
9502
9757
  # body: "HappyFace.jpg",
9503
9758
  # bucket: "examplebucket",
9504
9759
  # key: "HappyFace.jpg",
9760
+ # server_side_encryption: "AES256",
9761
+ # storage_class: "STANDARD_IA",
9505
9762
  # })
9506
9763
  #
9507
9764
  # resp.to_h outputs the following:
9508
9765
  # {
9509
9766
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9510
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
9767
+ # server_side_encryption: "AES256",
9768
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
9511
9769
  # }
9512
9770
  #
9513
9771
  # @example Streaming a file from disk
@@ -9709,15 +9967,17 @@ module Aws::S3
9709
9967
  #
9710
9968
  # **Related Resources**
9711
9969
  #
9712
- # * CopyObject
9970
+ # * [CopyObject][4]
9713
9971
  #
9714
- # * GetObject
9972
+ # * [GetObject][5]
9715
9973
  #
9716
9974
  #
9717
9975
  #
9718
9976
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
9719
9977
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
9720
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
9721
9981
  #
9722
9982
  # @option params [String] :acl
9723
9983
  # The canned ACL to apply to the object. For more information, see
@@ -10118,10 +10378,10 @@ module Aws::S3
10118
10378
  # A tag is a key-value pair. You can associate tags with an object by
10119
10379
  # sending a PUT request against the tagging subresource that is
10120
10380
  # associated with the object. You can retrieve tags by sending a GET
10121
- # request. For more information, see GetObjectTagging.
10381
+ # request. For more information, see [GetObjectTagging][1].
10122
10382
  #
10123
10383
  # For tagging-related restrictions related to characters and encodings,
10124
- # see [Tag Restrictions][1]. Note that Amazon S3 limits the maximum
10384
+ # see [Tag Restrictions][2]. Note that Amazon S3 limits the maximum
10125
10385
  # number of tags to 10 tags per object.
10126
10386
  #
10127
10387
  # To use this operation, you must have permission to perform the
@@ -10132,7 +10392,7 @@ module Aws::S3
10132
10392
  # You also need permission for the `s3:PutObjectVersionTagging` action.
10133
10393
  #
10134
10394
  # For information about the Amazon S3 object tagging feature, see
10135
- # [Object Tagging][2].
10395
+ # [Object Tagging][3].
10136
10396
  #
10137
10397
  # **Special Errors**
10138
10398
  #
@@ -10142,7 +10402,7 @@ module Aws::S3
10142
10402
  #
10143
10403
  # * *Cause: The tag provided was not a valid tag. This error can occur
10144
10404
  # if the tag did not pass input validation. For more information,
10145
- # see [Object Tagging][2].*
10405
+ # see [Object Tagging][3].*
10146
10406
  #
10147
10407
  # * ****
10148
10408
  #
@@ -10162,14 +10422,15 @@ module Aws::S3
10162
10422
  #
10163
10423
  # **Related Resources**
10164
10424
  #
10165
- # * GetObjectTagging
10425
+ # * [GetObjectTagging][1]
10166
10426
  #
10167
10427
  # ^
10168
10428
  #
10169
10429
  #
10170
10430
  #
10171
- # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
10172
- # [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
10173
10434
  #
10174
10435
  # @option params [required, String] :bucket
10175
10436
  # The bucket name containing the object.
@@ -10187,7 +10448,7 @@ module Aws::S3
10187
10448
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
10188
10449
  #
10189
10450
  # @option params [required, String] :key
10190
- # Name of the tag.
10451
+ # Name of the object key.
10191
10452
  #
10192
10453
  # @option params [String] :version_id
10193
10454
  # The versionId of the object that the tag-set will be added to.
@@ -10277,19 +10538,22 @@ module Aws::S3
10277
10538
  #
10278
10539
  # **Related Resources**
10279
10540
  #
10280
- # * GetPublicAccessBlock
10541
+ # * [GetPublicAccessBlock][3]
10281
10542
  #
10282
- # * DeletePublicAccessBlock
10543
+ # * [DeletePublicAccessBlock][4]
10283
10544
  #
10284
- # * GetBucketPolicyStatus
10545
+ # * [GetBucketPolicyStatus][5]
10285
10546
  #
10286
- # * [Using Amazon S3 Block Public Access][3]
10547
+ # * [Using Amazon S3 Block Public Access][6]
10287
10548
  #
10288
10549
  #
10289
10550
  #
10290
10551
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
10291
10552
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
10292
- # [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
10293
10557
  #
10294
10558
  # @option params [required, String] :bucket
10295
10559
  # The name of the Amazon S3 bucket whose `PublicAccessBlock`
@@ -10372,12 +10636,12 @@ module Aws::S3
10372
10636
  # For more information about the `S3` structure in the request body,
10373
10637
  # see the following:
10374
10638
  #
10375
- # * PutObject
10639
+ # * [PutObject][4]
10376
10640
  #
10377
- # * [Managing Access with ACLs][4] in the *Amazon Simple Storage
10641
+ # * [Managing Access with ACLs][5] in the *Amazon Simple Storage
10378
10642
  # Service Developer Guide*
10379
10643
  #
10380
- # * [Protecting Data Using Server-Side Encryption][5] in the *Amazon
10644
+ # * [Protecting Data Using Server-Side Encryption][6] in the *Amazon
10381
10645
  # Simple Storage Service Developer Guide*
10382
10646
  #
10383
10647
  # * Define the SQL expression for the `SELECT` type of restoration for
@@ -10403,7 +10667,7 @@ module Aws::S3
10403
10667
  # `SELECT s.Id, s.FirstName, s.SSN FROM S3Object s`
10404
10668
  #
10405
10669
  # For more information about using SQL with S3 Glacier Select restore,
10406
- # 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
10407
10671
  # the *Amazon Simple Storage Service Developer Guide*.
10408
10672
  #
10409
10673
  # When making a select request, you can also do the following:
@@ -10478,7 +10742,7 @@ module Aws::S3
10478
10742
  #
10479
10743
  # For more information about archive retrieval options and provisioned
10480
10744
  # capacity for `Expedited` data access, see [Restoring Archived
10481
- # Objects][7] in the *Amazon Simple Storage Service Developer Guide*.
10745
+ # Objects][8] in the *Amazon Simple Storage Service Developer Guide*.
10482
10746
  #
10483
10747
  # You can use Amazon S3 restore speed upgrade to change the restore
10484
10748
  # speed to a faster speed while it is in progress. You upgrade the speed
@@ -10488,14 +10752,14 @@ module Aws::S3
10488
10752
  # faster than the tier that the in-progress restore is using. You must
10489
10753
  # not change any other parameters, such as the `Days` request element.
10490
10754
  # For more information, see [ Upgrading the Speed of an In-Progress
10491
- # Restore][8] in the *Amazon Simple Storage Service Developer Guide*.
10755
+ # Restore][9] in the *Amazon Simple Storage Service Developer Guide*.
10492
10756
  #
10493
10757
  # To get the status of object restoration, you can send a `HEAD`
10494
10758
  # request. Operations return the `x-amz-restore` header, which provides
10495
10759
  # information about the restoration status, in the response. You can use
10496
10760
  # Amazon S3 event notifications to notify you when a restore is
10497
10761
  # initiated or completed. For more information, see [Configuring Amazon
10498
- # S3 Event Notifications][9] in the *Amazon Simple Storage Service
10762
+ # S3 Event Notifications][10] in the *Amazon Simple Storage Service
10499
10763
  # Developer Guide*.
10500
10764
  #
10501
10765
  # After restoring an archived object, you can update the restoration
@@ -10510,9 +10774,9 @@ module Aws::S3
10510
10774
  # that you specify in a restore request. For example, if you restore an
10511
10775
  # object copy for 10 days, but the object is scheduled to expire in 3
10512
10776
  # days, Amazon S3 deletes the object in 3 days. For more information
10513
- # about lifecycle configuration, see PutBucketLifecycleConfiguration and
10514
- # [Object Lifecycle Management][10] in *Amazon Simple Storage Service
10515
- # Developer Guide*.
10777
+ # about lifecycle configuration, see
10778
+ # [PutBucketLifecycleConfiguration][11] and [Object Lifecycle
10779
+ # Management][12] in *Amazon Simple Storage Service Developer Guide*.
10516
10780
  #
10517
10781
  # **Responses**
10518
10782
  #
@@ -10554,11 +10818,11 @@ module Aws::S3
10554
10818
  #
10555
10819
  # **Related Resources**
10556
10820
  #
10557
- # * PutBucketLifecycleConfiguration
10821
+ # * [PutBucketLifecycleConfiguration][11]
10558
10822
  #
10559
- # * GetBucketNotificationConfiguration
10823
+ # * [GetBucketNotificationConfiguration][13]
10560
10824
  #
10561
- # * [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
10562
10826
  # the *Amazon Simple Storage Service Developer Guide*
10563
10827
  #
10564
10828
  #
@@ -10566,13 +10830,16 @@ module Aws::S3
10566
10830
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
10567
10831
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
10568
10832
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html
10569
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
10570
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
10571
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html
10572
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
10573
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html
10574
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
10575
- # [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
10576
10843
  #
10577
10844
  # @option params [required, String] :bucket
10578
10845
  # The bucket name or containing the object to restore.
@@ -10787,16 +11054,17 @@ module Aws::S3
10787
11054
  #
10788
11055
  # For objects that are encrypted with customer-provided encryption
10789
11056
  # keys (SSE-C), you must use HTTPS, and you must use the headers that
10790
- # are documented in the GetObject. For more information about SSE-C,
10791
- # see [Server-Side Encryption (Using Customer-Provided Encryption
10792
- # 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*.
10793
11061
  #
10794
11062
  # For objects that are encrypted with Amazon S3 managed encryption
10795
11063
  # keys (SSE-S3) and customer master keys (CMKs) stored in AWS Key
10796
11064
  # Management Service (SSE-KMS), server-side encryption is handled
10797
11065
  # transparently, so you don't need to specify anything. For more
10798
11066
  # information about server-side encryption, including SSE-S3 and
10799
- # SSE-KMS, see [Protecting Data Using Server-Side Encryption][5] in
11067
+ # SSE-KMS, see [Protecting Data Using Server-Side Encryption][6] in
10800
11068
  # the *Amazon Simple Storage Service Developer Guide*.
10801
11069
  #
10802
11070
  # **Working with the Response Body**
@@ -10804,49 +11072,55 @@ module Aws::S3
10804
11072
  # Given the response size is unknown, Amazon S3 Select streams the
10805
11073
  # response as a series of messages and includes a `Transfer-Encoding`
10806
11074
  # header with `chunked` as its value in the response. For more
10807
- # information, see RESTSelectObjectAppendix .
11075
+ # information, see [Appendix: SelectObjectContent Response][7] .
10808
11076
  #
10809
11077
  #
10810
11078
  #
10811
11079
  # **GetObject Support**
10812
11080
  #
10813
11081
  # The `SelectObjectContent` operation does not support the following
10814
- # `GetObject` functionality. For more information, see GetObject.
11082
+ # `GetObject` functionality. For more information, see [GetObject][4].
10815
11083
  #
10816
11084
  # * `Range`\: Although you can specify a scan range for an Amazon S3
10817
- # Select request (see SelectObjectContentRequest$ScanRange in the
10818
- # 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
10819
11087
  # object to return.
10820
11088
  #
10821
11089
  # * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
10822
11090
  # cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
10823
11091
  # storage classes. For more information, about storage classes see
10824
- # [Storage Classes][6] in the *Amazon Simple Storage Service Developer
11092
+ # [Storage Classes][9] in the *Amazon Simple Storage Service Developer
10825
11093
  # Guide*.
10826
11094
  #
10827
11095
  #
10828
11096
  #
10829
11097
  # **Special Errors**
10830
11098
  #
10831
- # For a list of special errors for this operation, see
10832
- # SelectObjectContentErrorCodeList
11099
+ # For a list of special errors for this operation, see [List of SELECT
11100
+ # Object Content Error Codes][10]
10833
11101
  #
10834
11102
  # **Related Resources**
10835
11103
  #
10836
- # * GetObject
11104
+ # * [GetObject][4]
10837
11105
  #
10838
- # * GetBucketLifecycleConfiguration
11106
+ # * [GetBucketLifecycleConfiguration][11]
10839
11107
  #
10840
- # * PutBucketLifecycleConfiguration
11108
+ # * [PutBucketLifecycleConfiguration][12]
10841
11109
  #
10842
11110
  #
10843
11111
  #
10844
11112
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
10845
11113
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html
10846
11114
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
10847
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
10848
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
10849
- # [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
10850
11124
  #
10851
11125
  # @option params [required, String] :bucket
10852
11126
  # The S3 bucket.
@@ -11142,11 +11416,11 @@ module Aws::S3
11142
11416
  # <note markdown="1"> In this operation, you provide part data in your request. However, you
11143
11417
  # have an option to specify your existing Amazon S3 object as a data
11144
11418
  # source for the part you are uploading. To upload a part from an
11145
- # existing object, you use the UploadPartCopy operation.
11419
+ # existing object, you use the [UploadPartCopy][1] operation.
11146
11420
  #
11147
11421
  # </note>
11148
11422
  #
11149
- # You must initiate a multipart upload (see CreateMultipartUpload)
11423
+ # You must initiate a multipart upload (see [CreateMultipartUpload][2])
11150
11424
  # before you can upload any part. In response to your initiate request,
11151
11425
  # Amazon S3 returns an upload ID, a unique identifier, that you must
11152
11426
  # include in your upload part request.
@@ -11171,11 +11445,11 @@ module Aws::S3
11171
11445
  # parts storage and stops charging you for the parts storage.
11172
11446
  #
11173
11447
  # For more information on multipart uploads, go to [Multipart Upload
11174
- # Overview][1] in the <i>Amazon Simple Storage Service Developer Guide
11448
+ # Overview][3] in the <i>Amazon Simple Storage Service Developer Guide
11175
11449
  # </i>.
11176
11450
  #
11177
11451
  # For information on the permissions required to use the multipart
11178
- # 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
11179
11453
  # *Amazon Simple Storage Service Developer Guide*.
11180
11454
  #
11181
11455
  # You can optionally request server-side encryption where Amazon S3
@@ -11185,26 +11459,27 @@ module Aws::S3
11185
11459
  # encryption keys. If you choose to provide your own encryption key, the
11186
11460
  # request headers you provide in the request must match the headers you
11187
11461
  # used in the request to initiate the upload by using
11188
- # CreateMultipartUpload. For more information, go to [Using Server-Side
11189
- # 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*.
11190
11465
  #
11191
11466
  # Server-side encryption is supported by the S3 Multipart Upload
11192
11467
  # actions. Unless you are using a customer-provided encryption key, you
11193
11468
  # don't need to specify the encryption parameters in each UploadPart
11194
11469
  # request. Instead, you only need to specify the server-side encryption
11195
11470
  # parameters in the initial Initiate Multipart request. For more
11196
- # information, see CreateMultipartUpload.
11471
+ # information, see [CreateMultipartUpload][2].
11197
11472
  #
11198
11473
  # If you requested server-side encryption using a customer-provided
11199
11474
  # encryption key in your initiate multipart upload request, you must
11200
11475
  # provide identical encryption information in each part upload using the
11201
11476
  # following headers.
11202
11477
  #
11203
- # * x-amz-server-side​-encryption​-customer-algorithm
11478
+ # * x-amz-server-side-encryption-customer-algorithm
11204
11479
  #
11205
- # * x-amz-server-side​-encryption​-customer-key
11480
+ # * x-amz-server-side-encryption-customer-key
11206
11481
  #
11207
- # * x-amz-server-side​-encryption​-customer-key-MD5
11482
+ # * x-amz-server-side-encryption-customer-key-MD5
11208
11483
  #
11209
11484
  # **Special Errors**
11210
11485
  #
@@ -11222,23 +11497,29 @@ module Aws::S3
11222
11497
  #
11223
11498
  # **Related Resources**
11224
11499
  #
11225
- # * CreateMultipartUpload
11500
+ # * [CreateMultipartUpload][2]
11226
11501
  #
11227
- # * CompleteMultipartUpload
11502
+ # * [CompleteMultipartUpload][6]
11228
11503
  #
11229
- # * AbortMultipartUpload
11504
+ # * [AbortMultipartUpload][7]
11230
11505
  #
11231
- # * ListParts
11506
+ # * [ListParts][8]
11232
11507
  #
11233
- # * ListMultipartUploads
11508
+ # * [ListMultipartUploads][9]
11234
11509
  #
11235
11510
  #
11236
11511
  #
11237
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
11238
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11239
- # [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
11240
11521
  #
11241
- # @option params [String, IO] :body
11522
+ # @option params [String, StringIO, File] :body
11242
11523
  # Object data.
11243
11524
  #
11244
11525
  # @option params [required, String] :bucket
@@ -11273,8 +11554,8 @@ module Aws::S3
11273
11554
  # encrypting data. This value is used to store the object and then it is
11274
11555
  # discarded; Amazon S3 does not store the encryption key. The key must
11275
11556
  # be appropriate for use with the algorithm specified in the
11276
- # `x-amz-server-side​-encryption​-customer-algorithm header`. This must
11277
- # 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
11278
11559
  # request.
11279
11560
  #
11280
11561
  # @option params [String] :sse_customer_key_md5
@@ -11365,7 +11646,7 @@ module Aws::S3
11365
11646
  # in the *Amazon Simple Storage Service Developer Guide*.
11366
11647
  #
11367
11648
  # <note markdown="1"> Instead of using an existing object as part data, you might use the
11368
- # UploadPart operation and provide data in your request.
11649
+ # [UploadPart][2] operation and provide data in your request.
11369
11650
  #
11370
11651
  # </note>
11371
11652
  #
@@ -11378,20 +11659,20 @@ module Aws::S3
11378
11659
  # the following:
11379
11660
  #
11380
11661
  # * For conceptual information about multipart uploads, see [Uploading
11381
- # Objects Using Multipart Upload][2] in the *Amazon Simple Storage
11662
+ # Objects Using Multipart Upload][3] in the *Amazon Simple Storage
11382
11663
  # Service Developer Guide*.
11383
11664
  #
11384
11665
  # * For information about permissions required to use the multipart
11385
- # upload API, see [Multipart Upload API and Permissions][3] in the
11666
+ # upload API, see [Multipart Upload API and Permissions][4] in the
11386
11667
  # *Amazon Simple Storage Service Developer Guide*.
11387
11668
  #
11388
11669
  # * For information about copying objects using a single atomic
11389
- # operation vs. the multipart upload, see [Operations on Objects][4]
11670
+ # operation vs. the multipart upload, see [Operations on Objects][5]
11390
11671
  # in the *Amazon Simple Storage Service Developer Guide*.
11391
11672
  #
11392
11673
  # * For information about using server-side encryption with
11393
11674
  # customer-provided encryption keys with the UploadPartCopy operation,
11394
- # see CopyObject and UploadPart.
11675
+ # see [CopyObject][6] and [UploadPart][2].
11395
11676
  #
11396
11677
  # Note the following additional considerations about the request headers
11397
11678
  # `x-amz-copy-source-if-match`, `x-amz-copy-source-if-none-match`,
@@ -11464,24 +11745,31 @@ module Aws::S3
11464
11745
  #
11465
11746
  # **Related Resources**
11466
11747
  #
11467
- # * CreateMultipartUpload
11748
+ # * [CreateMultipartUpload][7]
11468
11749
  #
11469
- # * UploadPart
11750
+ # * [UploadPart][2]
11470
11751
  #
11471
- # * CompleteMultipartUpload
11752
+ # * [CompleteMultipartUpload][8]
11472
11753
  #
11473
- # * AbortMultipartUpload
11754
+ # * [AbortMultipartUpload][9]
11474
11755
  #
11475
- # * ListParts
11756
+ # * [ListParts][10]
11476
11757
  #
11477
- # * ListMultipartUploads
11758
+ # * [ListMultipartUploads][11]
11478
11759
  #
11479
11760
  #
11480
11761
  #
11481
11762
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/qfacts.html
11482
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
11483
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11484
- # [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
11485
11773
  #
11486
11774
  # @option params [required, String] :bucket
11487
11775
  # The bucket name.
@@ -11530,8 +11818,8 @@ module Aws::S3
11530
11818
  # encrypting data. This value is used to store the object and then it is
11531
11819
  # discarded; Amazon S3 does not store the encryption key. The key must
11532
11820
  # be appropriate for use with the algorithm specified in the
11533
- # `x-amz-server-side​-encryption​-customer-algorithm` header. This must
11534
- # 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
11535
11823
  # request.
11536
11824
  #
11537
11825
  # @option params [String] :sse_customer_key_md5
@@ -11575,45 +11863,45 @@ module Aws::S3
11575
11863
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
11576
11864
  #
11577
11865
  #
11578
- # @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
11579
11867
  #
11580
- # # 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.
11581
11870
  #
11582
11871
  # resp = client.upload_part_copy({
11583
11872
  # bucket: "examplebucket",
11584
11873
  # copy_source: "/bucketname/sourceobjectkey",
11874
+ # copy_source_range: "bytes=1-100000",
11585
11875
  # key: "examplelargeobject",
11586
- # part_number: 1,
11876
+ # part_number: 2,
11587
11877
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
11588
11878
  # })
11589
11879
  #
11590
11880
  # resp.to_h outputs the following:
11591
11881
  # {
11592
11882
  # copy_part_result: {
11593
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
11594
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
11883
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
11884
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
11595
11885
  # },
11596
11886
  # }
11597
11887
  #
11598
- # @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
11599
11889
  #
11600
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
11601
- # # data source.
11890
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
11602
11891
  #
11603
11892
  # resp = client.upload_part_copy({
11604
11893
  # bucket: "examplebucket",
11605
11894
  # copy_source: "/bucketname/sourceobjectkey",
11606
- # copy_source_range: "bytes=1-100000",
11607
11895
  # key: "examplelargeobject",
11608
- # part_number: 2,
11896
+ # part_number: 1,
11609
11897
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
11610
11898
  # })
11611
11899
  #
11612
11900
  # resp.to_h outputs the following:
11613
11901
  # {
11614
11902
  # copy_part_result: {
11615
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
11616
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
11903
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
11904
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
11617
11905
  # },
11618
11906
  # }
11619
11907
  #
@@ -11672,7 +11960,7 @@ module Aws::S3
11672
11960
  params: params,
11673
11961
  config: config)
11674
11962
  context[:gem_name] = 'aws-sdk-s3'
11675
- context[:gem_version] = '1.72.0'
11963
+ context[:gem_version] = '1.77.0'
11676
11964
  Seahorse::Client::Request.new(handlers, context)
11677
11965
  end
11678
11966