aws-sdk-s3 1.77.0 → 1.78.0

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