aws-sdk-s3 1.77.0 → 1.78.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml 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