@aws-sdk/client-s3 3.303.0 → 3.304.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/dist-cjs/endpoint/ruleset.js +3 -3
  2. package/dist-cjs/models/models_0.js +31 -2
  3. package/dist-es/endpoint/ruleset.js +3 -3
  4. package/dist-es/models/models_0.js +29 -0
  5. package/dist-types/S3.d.ts +751 -662
  6. package/dist-types/commands/AbortMultipartUploadCommand.d.ts +2 -2
  7. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +22 -14
  8. package/dist-types/commands/CopyObjectCommand.d.ts +53 -30
  9. package/dist-types/commands/CreateBucketCommand.d.ts +22 -14
  10. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +74 -48
  11. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +2 -2
  12. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +2 -2
  13. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +7 -5
  14. package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +1 -2
  15. package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +2 -2
  16. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +1 -2
  17. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +5 -5
  18. package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +2 -2
  19. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +4 -3
  20. package/dist-types/commands/DeleteObjectCommand.d.ts +11 -11
  21. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +2 -4
  22. package/dist-types/commands/DeleteObjectsCommand.d.ts +13 -14
  23. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +2 -2
  24. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +5 -4
  25. package/dist-types/commands/GetBucketAclCommand.d.ts +9 -7
  26. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +5 -4
  27. package/dist-types/commands/GetBucketCorsCommand.d.ts +1 -0
  28. package/dist-types/commands/GetBucketEncryptionCommand.d.ts +7 -7
  29. package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +1 -2
  30. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +2 -2
  31. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +4 -4
  32. package/dist-types/commands/GetBucketLocationCommand.d.ts +4 -0
  33. package/dist-types/commands/GetBucketLoggingCommand.d.ts +1 -1
  34. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +5 -6
  35. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +3 -2
  36. package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +4 -3
  37. package/dist-types/commands/GetBucketPolicyCommand.d.ts +1 -0
  38. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +1 -1
  39. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +2 -1
  40. package/dist-types/commands/GetBucketWebsiteCommand.d.ts +1 -2
  41. package/dist-types/commands/GetObjectAclCommand.d.ts +5 -4
  42. package/dist-types/commands/GetObjectAttributesCommand.d.ts +23 -28
  43. package/dist-types/commands/GetObjectCommand.d.ts +20 -18
  44. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +1 -2
  45. package/dist-types/commands/GetObjectRetentionCommand.d.ts +2 -1
  46. package/dist-types/commands/GetObjectTaggingCommand.d.ts +5 -5
  47. package/dist-types/commands/GetObjectTorrentCommand.d.ts +1 -1
  48. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +1 -1
  49. package/dist-types/commands/HeadBucketCommand.d.ts +15 -9
  50. package/dist-types/commands/HeadObjectCommand.d.ts +20 -19
  51. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +4 -4
  52. package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +1 -2
  53. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +5 -5
  54. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +6 -7
  55. package/dist-types/commands/ListBucketsCommand.d.ts +3 -1
  56. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +2 -2
  57. package/dist-types/commands/ListObjectVersionsCommand.d.ts +3 -6
  58. package/dist-types/commands/ListObjectsV2Command.d.ts +11 -12
  59. package/dist-types/commands/ListPartsCommand.d.ts +3 -4
  60. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +4 -3
  61. package/dist-types/commands/PutBucketAclCommand.d.ts +15 -12
  62. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +4 -4
  63. package/dist-types/commands/PutBucketCorsCommand.d.ts +2 -2
  64. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +16 -14
  65. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +7 -8
  66. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +20 -8
  67. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +8 -8
  68. package/dist-types/commands/PutBucketLoggingCommand.d.ts +11 -7
  69. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +4 -4
  70. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +12 -12
  71. package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +4 -2
  72. package/dist-types/commands/PutBucketPolicyCommand.d.ts +2 -1
  73. package/dist-types/commands/PutBucketReplicationCommand.d.ts +12 -11
  74. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +1 -1
  75. package/dist-types/commands/PutBucketTaggingCommand.d.ts +12 -12
  76. package/dist-types/commands/PutBucketVersioningCommand.d.ts +4 -4
  77. package/dist-types/commands/PutObjectAclCommand.d.ts +17 -13
  78. package/dist-types/commands/PutObjectCommand.d.ts +44 -53
  79. package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +7 -8
  80. package/dist-types/commands/PutObjectRetentionCommand.d.ts +3 -4
  81. package/dist-types/commands/PutObjectTaggingCommand.d.ts +4 -3
  82. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -1
  83. package/dist-types/commands/RestoreObjectCommand.d.ts +49 -68
  84. package/dist-types/commands/SelectObjectContentCommand.d.ts +13 -17
  85. package/dist-types/commands/UploadPartCommand.d.ts +23 -16
  86. package/dist-types/commands/UploadPartCopyCommand.d.ts +7 -5
  87. package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +32 -21
  88. package/dist-types/models/models_0.d.ts +460 -362
  89. package/dist-types/models/models_1.d.ts +81 -76
  90. package/dist-types/ts3.4/models/models_0.d.ts +30 -28
  91. package/package.json +1 -1
@@ -28,8 +28,7 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
28
28
  * permission and the bucket owner can grant this permission to others.</p>
29
29
  * <p>There is usually some time lag before lifecycle configuration deletion is fully
30
30
  * propagated to all the Amazon S3 systems.</p>
31
- * <p>For more information about the object expiration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions">Elements to
32
- * Describe Lifecycle Actions</a>.</p>
31
+ * <p>For more information about the object expiration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions">Elements to Describe Lifecycle Actions</a>.</p>
33
32
  * <p>Related actions include:</p>
34
33
  * <ul>
35
34
  * <li>
@@ -25,9 +25,10 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
25
25
  * <p> To use this operation, you must have permissions to perform the
26
26
  * <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by
27
27
  * default. The bucket owner can grant this permission to others. For more information about
28
- * permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
29
- * Resources</a>.</p>
30
- * <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>. </p>
28
+ * permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
29
+ * Access Permissions to Your Amazon S3 Resources</a>.</p>
30
+ * <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with
31
+ * Amazon CloudWatch</a>. </p>
31
32
  * <p>The following operations are related to
32
33
  * <code>DeleteBucketMetricsConfiguration</code>:</p>
33
34
  * <ul>
@@ -48,8 +49,7 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
48
49
  * </li>
49
50
  * <li>
50
51
  * <p>
51
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
52
- * CloudWatch</a>
52
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>
53
53
  * </p>
54
54
  * </li>
55
55
  * </ul>
@@ -21,8 +21,8 @@ export interface DeleteBucketOwnershipControlsCommandOutput extends __MetadataBe
21
21
  * @public
22
22
  * <p>Removes <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you
23
23
  * must have the <code>s3:PutBucketOwnershipControls</code> permission. For more information
24
- * about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying
25
- * Permissions in a Policy</a>.</p>
24
+ * about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
25
+ * Policy</a>.</p>
26
26
  * <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/about-object-ownership.html">Using Object Ownership</a>. </p>
27
27
  * <p>The following operations are related to
28
28
  * <code>DeleteBucketOwnershipControls</code>:</p>
@@ -23,13 +23,14 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
23
23
  * <p>To use this operation, you must have permissions to perform the
24
24
  * <code>s3:PutReplicationConfiguration</code> action. The bucket owner has these
25
25
  * permissions by default and can grant it to others. For more information about permissions,
26
- * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
27
- * Resources</a>. </p>
26
+ * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
27
+ * Access Permissions to Your Amazon S3 Resources</a>. </p>
28
28
  * <note>
29
29
  * <p>It can take a while for the deletion of a replication configuration to fully
30
30
  * propagate.</p>
31
31
  * </note>
32
- * <p> For information about replication configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the <i>Amazon S3 User Guide</i>.</p>
32
+ * <p> For information about replication configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the
33
+ * <i>Amazon S3 User Guide</i>.</p>
33
34
  * <p>The following operations are related to <code>DeleteBucketReplication</code>:</p>
34
35
  * <ul>
35
36
  * <li>
@@ -22,21 +22,21 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
22
22
  * <p>Removes the null version (if there is one) of an object and inserts a delete marker,
23
23
  * which becomes the latest version of the object. If there isn't a null version, Amazon S3 does
24
24
  * not remove any objects but will still respond that the command was successful.</p>
25
- * <p>To remove a specific version, you must be the bucket owner and you must use the version
26
- * Id subresource. Using this subresource permanently deletes the version. If the object
27
- * deleted is a delete marker, Amazon S3 sets the response header,
28
- * <code>x-amz-delete-marker</code>, to true. </p>
25
+ * <p>To remove a specific version, you must use the version Id subresource. Using this
26
+ * subresource permanently deletes the version. If the object deleted is a delete marker, Amazon S3
27
+ * sets the response header, <code>x-amz-delete-marker</code>, to true. </p>
29
28
  * <p>If the object you want to delete is in a bucket where the bucket versioning
30
29
  * configuration is MFA Delete enabled, you must include the <code>x-amz-mfa</code> request
31
30
  * header in the DELETE <code>versionId</code> request. Requests that include
32
31
  * <code>x-amz-mfa</code> must use HTTPS. </p>
33
- * <p> For more information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html">Using MFA Delete</a>. To see sample requests that use versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete">Sample Request</a>. </p>
34
- * <p>You can delete objects by explicitly calling DELETE Object or configure its
35
- * lifecycle (<a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>) to
36
- * enable Amazon S3 to remove them for you. If you want to block users or accounts from removing or
37
- * deleting objects from your bucket, you must deny them the <code>s3:DeleteObject</code>,
38
- * <code>s3:DeleteObjectVersion</code>, and <code>s3:PutLifeCycleConfiguration</code>
39
- * actions. </p>
32
+ * <p> For more information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html">Using MFA Delete</a>. To see sample
33
+ * requests that use versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete">Sample
34
+ * Request</a>. </p>
35
+ * <p>You can delete objects by explicitly calling DELETE Object or configure its lifecycle
36
+ * (<a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>) to enable Amazon S3 to remove them for you. If you want to block
37
+ * users or accounts from removing or deleting objects from your bucket, you must deny them
38
+ * the <code>s3:DeleteObject</code>, <code>s3:DeleteObjectVersion</code>, and
39
+ * <code>s3:PutLifeCycleConfiguration</code> actions. </p>
40
40
  * <p>The following action is related to <code>DeleteObject</code>:</p>
41
41
  * <ul>
42
42
  * <li>
@@ -20,15 +20,13 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
20
20
  /**
21
21
  * @public
22
22
  * <p>Removes the entire tag set from the specified object. For more information about
23
- * managing object tags, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html"> Object
24
- * Tagging</a>.</p>
23
+ * managing object tags, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html"> Object Tagging</a>.</p>
25
24
  * <p>To use this operation, you must have permission to perform the
26
25
  * <code>s3:DeleteObjectTagging</code> action.</p>
27
26
  * <p>To delete tags of a specific object version, add the <code>versionId</code> query
28
27
  * parameter in the request. You will need permission for the
29
28
  * <code>s3:DeleteObjectVersionTagging</code> action.</p>
30
- * <p>The following operations are related to
31
- * <code>DeleteBucketMetricsConfiguration</code>:</p>
29
+ * <p>The following operations are related to <code>DeleteObjectTagging</code>:</p>
32
30
  * <ul>
33
31
  * <li>
34
32
  * <p>
@@ -20,28 +20,27 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
20
20
  /**
21
21
  * @public
22
22
  * <p>This action enables you to delete multiple objects from a bucket using a single HTTP
23
- * request. If you know the object keys that you want to delete, then this action provides
24
- * a suitable alternative to sending individual delete requests, reducing per-request
23
+ * request. If you know the object keys that you want to delete, then this action provides a
24
+ * suitable alternative to sending individual delete requests, reducing per-request
25
25
  * overhead.</p>
26
26
  * <p>The request contains a list of up to 1000 keys that you want to delete. In the XML, you
27
27
  * provide the object key names, and optionally, version IDs if you want to delete a specific
28
28
  * version of the object from a versioning-enabled bucket. For each key, Amazon S3 performs a
29
- * delete action and returns the result of that delete, success, or failure, in the
30
- * response. Note that if the object specified in the request is not found, Amazon S3 returns the
31
- * result as deleted.</p>
29
+ * delete action and returns the result of that delete, success, or failure, in the response.
30
+ * Note that if the object specified in the request is not found, Amazon S3 returns the result as
31
+ * deleted.</p>
32
32
  * <p> The action supports two modes for the response: verbose and quiet. By default, the
33
- * action uses verbose mode in which the response includes the result of deletion of each
34
- * key in your request. In quiet mode the response includes only keys where the delete
35
- * action encountered an error. For a successful deletion, the action does not return
36
- * any information about the delete in the response body.</p>
37
- * <p>When performing this action on an MFA Delete enabled bucket, that attempts to delete
38
- * any versioned objects, you must include an MFA token. If you do not provide one, the entire
33
+ * action uses verbose mode in which the response includes the result of deletion of each key
34
+ * in your request. In quiet mode the response includes only keys where the delete action
35
+ * encountered an error. For a successful deletion, the action does not return any information
36
+ * about the delete in the response body.</p>
37
+ * <p>When performing this action on an MFA Delete enabled bucket, that attempts to delete any
38
+ * versioned objects, you must include an MFA token. If you do not provide one, the entire
39
39
  * request will fail, even if there are non-versioned objects you are trying to delete. If you
40
40
  * provide an invalid token, whether there are versioned keys in the request or not, the
41
41
  * entire Multi-Object Delete request will fail. For information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete"> MFA
42
- * Delete</a>.</p>
43
- * <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon
44
- * S3 uses the header value to ensure that your request body has not been altered in
42
+ * Delete</a>.</p>
43
+ * <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon S3 uses the header value to ensure that your request body has not been altered in
45
44
  * transit.</p>
46
45
  * <p>The following operations are related to <code>DeleteObjects</code>:</p>
47
46
  * <ul>
@@ -21,8 +21,8 @@ export interface DeletePublicAccessBlockCommandOutput extends __MetadataBearer {
21
21
  * @public
22
22
  * <p>Removes the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket. To use this
23
23
  * operation, you must have the <code>s3:PutBucketPublicAccessBlock</code> permission. For
24
- * more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
25
- * Resources</a>.</p>
24
+ * more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
25
+ * Access Permissions to Your Amazon S3 Resources</a>.</p>
26
26
  * <p>The following operations are related to <code>DeletePublicAccessBlock</code>:</p>
27
27
  * <ul>
28
28
  * <li>
@@ -26,15 +26,16 @@ export interface GetBucketAccelerateConfigurationCommandOutput extends GetBucket
26
26
  * <p>To use this operation, you must have permission to perform the
27
27
  * <code>s3:GetAccelerateConfiguration</code> action. The bucket owner has this permission
28
28
  * by default. The bucket owner can grant this permission to others. For more information
29
- * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to your Amazon S3
30
- * Resources</a> in the <i>Amazon S3 User Guide</i>.</p>
29
+ * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
30
+ * Access Permissions to your Amazon S3 Resources</a> in the
31
+ * <i>Amazon S3 User Guide</i>.</p>
31
32
  * <p>You set the Transfer Acceleration state of an existing bucket to <code>Enabled</code> or
32
33
  * <code>Suspended</code> by using the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAccelerateConfiguration.html">PutBucketAccelerateConfiguration</a> operation. </p>
33
34
  * <p>A GET <code>accelerate</code> request does not return a state value for a bucket that
34
35
  * has no transfer acceleration state. A bucket has no Transfer Acceleration state if a state
35
36
  * has never been set on the bucket. </p>
36
- * <p>For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer Acceleration</a> in the
37
- * Amazon S3 User Guide.</p>
37
+ * <p>For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer Acceleration</a> in
38
+ * the Amazon S3 User Guide.</p>
38
39
  * <p class="title">
39
40
  * <b>Related Resources</b>
40
41
  * </p>
@@ -19,17 +19,19 @@ export interface GetBucketAclCommandOutput extends GetBucketAclOutput, __Metadat
19
19
  }
20
20
  /**
21
21
  * @public
22
- * <p>This implementation of the <code>GET</code> action uses the <code>acl</code>
23
- * subresource to return the access control list (ACL) of a bucket. To use <code>GET</code> to
24
- * return the ACL of the bucket, you must have <code>READ_ACP</code> access to the bucket. If
22
+ * <p>This implementation of the <code>GET</code> action uses the <code>acl</code> subresource
23
+ * to return the access control list (ACL) of a bucket. To use <code>GET</code> to return the
24
+ * ACL of the bucket, you must have <code>READ_ACP</code> access to the bucket. If
25
25
  * <code>READ_ACP</code> permission is granted to the anonymous user, you can return the
26
26
  * ACL of the bucket without using an authorization header.</p>
27
+ * <p>To use this API against an access point, provide the alias of the access point in place of the bucket name.</p>
27
28
  * <note>
28
29
  * <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership,
29
- * requests to read ACLs are still supported and return the <code>bucket-owner-full-control</code>
30
- * ACL with the owner being the account that created the bucket. For more information, see
31
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">
32
- * Controlling object ownership and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
30
+ * requests to read ACLs are still supported and return the
31
+ * <code>bucket-owner-full-control</code> ACL with the owner being the account that
32
+ * created the bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling object
33
+ * ownership and disabling ACLs</a> in the
34
+ * <i>Amazon S3 User Guide</i>.</p>
33
35
  * </note>
34
36
  * <p class="title">
35
37
  * <b>Related Resources</b>
@@ -19,13 +19,14 @@ export interface GetBucketAnalyticsConfigurationCommandOutput extends GetBucketA
19
19
  }
20
20
  /**
21
21
  * @public
22
- * <p>This implementation of the GET action returns an analytics configuration (identified
23
- * by the analytics configuration ID) from the bucket.</p>
22
+ * <p>This implementation of the GET action returns an analytics configuration (identified by
23
+ * the analytics configuration ID) from the bucket.</p>
24
24
  * <p>To use this operation, you must have permissions to perform the
25
25
  * <code>s3:GetAnalyticsConfiguration</code> action. The bucket owner has this permission
26
26
  * by default. The bucket owner can grant this permission to others. For more information
27
- * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources"> Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
28
- * Resources</a> in the <i>Amazon S3 User Guide</i>. </p>
27
+ * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources"> Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
28
+ * Access Permissions to Your Amazon S3 Resources</a> in the
29
+ * <i>Amazon S3 User Guide</i>. </p>
29
30
  * <p>For information about Amazon S3 analytics feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html">Amazon S3 Analytics – Storage Class
30
31
  * Analysis</a> in the <i>Amazon S3 User Guide</i>.</p>
31
32
  * <p class="title">
@@ -24,6 +24,7 @@ export interface GetBucketCorsCommandOutput extends GetBucketCorsOutput, __Metad
24
24
  * <p> To use this operation, you must have permission to perform the
25
25
  * <code>s3:GetBucketCORS</code> action. By default, the bucket owner has this permission
26
26
  * and can grant it to others.</p>
27
+ * <p>To use this API against an access point, provide the alias of the access point in place of the bucket name.</p>
27
28
  * <p> For more information about CORS, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html"> Enabling Cross-Origin Resource
28
29
  * Sharing</a>.</p>
29
30
  * <p>The following operations are related to <code>GetBucketCors</code>:</p>
@@ -19,15 +19,15 @@ export interface GetBucketEncryptionCommandOutput extends GetBucketEncryptionOut
19
19
  }
20
20
  /**
21
21
  * @public
22
- * <p>Returns the default encryption configuration for an Amazon S3 bucket. If the bucket does not
23
- * have a default encryption configuration, GetBucketEncryption returns
24
- * <code>ServerSideEncryptionConfigurationNotFoundError</code>. </p>
25
- * <p>For information about the Amazon S3 default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Default Bucket Encryption</a>.</p>
26
- * <p> To use this operation, you must have permission to perform the
22
+ * <p>Returns the default encryption configuration for an Amazon S3 bucket. By default, all buckets have a default encryption configuration that
23
+ * uses server-side encryption with Amazon S3 managed keys (SSE-S3). For information
24
+ * about the bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket
25
+ * Default Encryption</a> in the <i>Amazon S3 User Guide</i>.</p>
26
+ * <p>To use this operation, you must have permission to perform the
27
27
  * <code>s3:GetEncryptionConfiguration</code> action. The bucket owner has this permission
28
28
  * by default. The bucket owner can grant this permission to others. For more information
29
- * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
30
- * Resources</a>.</p>
29
+ * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
30
+ * Access Permissions to Your Amazon S3 Resources</a>.</p>
31
31
  * <p>The following operations are related to <code>GetBucketEncryption</code>:</p>
32
32
  * <ul>
33
33
  * <li>
@@ -23,8 +23,7 @@ export interface GetBucketIntelligentTieringConfigurationCommandOutput extends G
23
23
  * <p>The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without performance impact or operational overhead. S3 Intelligent-Tiering delivers automatic cost savings in three low latency and high throughput access tiers. To get the lowest storage cost on data that can be accessed in minutes to hours, you can choose to activate additional archiving capabilities.</p>
24
24
  * <p>The S3 Intelligent-Tiering storage class is the ideal storage class for data with unknown, changing, or unpredictable access patterns, independent of object size or retention period. If the size of an object is less than 128 KB, it is not monitored and not eligible for auto-tiering. Smaller objects can be stored, but they are always charged at the Frequent Access tier rates in the S3 Intelligent-Tiering storage class.</p>
25
25
  * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access">Storage class for automatically optimizing frequently and infrequently accessed objects</a>.</p>
26
- * <p>Operations related to
27
- * <code>GetBucketIntelligentTieringConfiguration</code> include: </p>
26
+ * <p>Operations related to <code>GetBucketIntelligentTieringConfiguration</code> include: </p>
28
27
  * <ul>
29
28
  * <li>
30
29
  * <p>
@@ -24,8 +24,8 @@ export interface GetBucketInventoryConfigurationCommandOutput extends GetBucketI
24
24
  * <p>To use this operation, you must have permissions to perform the
25
25
  * <code>s3:GetInventoryConfiguration</code> action. The bucket owner has this permission
26
26
  * by default and can grant this permission to others. For more information about permissions,
27
- * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
28
- * Resources</a>.</p>
27
+ * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
28
+ * Access Permissions to Your Amazon S3 Resources</a>.</p>
29
29
  * <p>For information about the Amazon S3 inventory feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html">Amazon S3 Inventory</a>.</p>
30
30
  * <p>The following operations are related to
31
31
  * <code>GetBucketInventoryConfiguration</code>:</p>
@@ -28,13 +28,13 @@ export interface GetBucketLifecycleConfigurationCommandOutput extends GetBucketL
28
28
  * works. For the earlier action, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html">GetBucketLifecycle</a>.</p>
29
29
  * </note>
30
30
  * <p>Returns the lifecycle configuration information set on the bucket. For information about
31
- * lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object
32
- * Lifecycle Management</a>.</p>
31
+ * lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle
32
+ * Management</a>.</p>
33
33
  * <p>To use this operation, you must have permission to perform the
34
34
  * <code>s3:GetLifecycleConfiguration</code> action. The bucket owner has this permission,
35
35
  * by default. The bucket owner can grant this permission to others. For more information
36
- * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
37
- * Resources</a>.</p>
36
+ * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
37
+ * Access Permissions to Your Amazon S3 Resources</a>.</p>
38
38
  * <p>
39
39
  * <code>GetBucketLifecycleConfiguration</code> has the following special error:</p>
40
40
  * <ul>
@@ -24,6 +24,10 @@ export interface GetBucketLocationCommandOutput extends GetBucketLocationOutput,
24
24
  * request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>.</p>
25
25
  * <p>To use this implementation of the operation, you must be the bucket owner.</p>
26
26
  * <p>To use this API against an access point, provide the alias of the access point in place of the bucket name.</p>
27
+ * <note>
28
+ * <p>For requests made using Amazon Web Services Signature Version 4 (SigV4), we recommend that you use
29
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html">HeadBucket</a> to return the bucket Region instead of GetBucketLocation.</p>
30
+ * </note>
27
31
  * <p>The following operations are related to <code>GetBucketLocation</code>:</p>
28
32
  * <ul>
29
33
  * <li>
@@ -20,7 +20,7 @@ export interface GetBucketLoggingCommandOutput extends GetBucketLoggingOutput, _
20
20
  /**
21
21
  * @public
22
22
  * <p>Returns the logging status of a bucket and the permissions users have to view and modify
23
- * that status. To use GET, you must be the bucket owner.</p>
23
+ * that status.</p>
24
24
  * <p>The following operations are related to <code>GetBucketLogging</code>:</p>
25
25
  * <ul>
26
26
  * <li>
@@ -24,10 +24,10 @@ export interface GetBucketMetricsConfigurationCommandOutput extends GetBucketMet
24
24
  * <p> To use this operation, you must have permissions to perform the
25
25
  * <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by
26
26
  * default. The bucket owner can grant this permission to others. For more information about
27
- * permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
28
- * Resources</a>.</p>
29
- * <p> For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
30
- * CloudWatch</a>.</p>
27
+ * permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
28
+ * Access Permissions to Your Amazon S3 Resources</a>.</p>
29
+ * <p> For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring
30
+ * Metrics with Amazon CloudWatch</a>.</p>
31
31
  * <p>The following operations are related to
32
32
  * <code>GetBucketMetricsConfiguration</code>:</p>
33
33
  * <ul>
@@ -48,8 +48,7 @@ export interface GetBucketMetricsConfigurationCommandOutput extends GetBucketMet
48
48
  * </li>
49
49
  * <li>
50
50
  * <p>
51
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
52
- * CloudWatch</a>
51
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>
53
52
  * </p>
54
53
  * </li>
55
54
  * </ul>
@@ -26,9 +26,10 @@ export interface GetBucketNotificationConfigurationCommandOutput extends Notific
26
26
  * bucket. However, the bucket owner can use a bucket policy to grant permission to other
27
27
  * users to read this configuration with the <code>s3:GetBucketNotification</code>
28
28
  * permission.</p>
29
+ * <p>To use this API against an access point, provide the alias of the access point in place of the bucket name.</p>
29
30
  * <p>For more information about setting and reading the notification configuration on a
30
- * bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Setting Up Notification of
31
- * Bucket Events</a>. For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies</a>.</p>
31
+ * bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Setting Up Notification of Bucket Events</a>. For more information about bucket
32
+ * policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies</a>.</p>
32
33
  * <p>The following action is related to <code>GetBucketNotification</code>:</p>
33
34
  * <ul>
34
35
  * <li>
@@ -21,9 +21,10 @@ export interface GetBucketOwnershipControlsCommandOutput extends GetBucketOwners
21
21
  * @public
22
22
  * <p>Retrieves <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you
23
23
  * must have the <code>s3:GetBucketOwnershipControls</code> permission. For more information
24
- * about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html">Specifying
25
- * permissions in a policy</a>. </p>
26
- * <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Using Object Ownership</a>. </p>
24
+ * about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html">Specifying permissions in a
25
+ * policy</a>. </p>
26
+ * <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Using Object
27
+ * Ownership</a>. </p>
27
28
  * <p>The following operations are related to <code>GetBucketOwnershipControls</code>:</p>
28
29
  * <ul>
29
30
  * <li>
@@ -32,6 +32,7 @@ export interface GetBucketPolicyCommandOutput extends GetBucketPolicyOutput, __M
32
32
  * always use this operation, even if the policy explicitly denies the root user the
33
33
  * ability to perform this action.</p>
34
34
  * </important>
35
+ * <p>To use this API against an access point, provide the alias of the access point in place of the bucket name.</p>
35
36
  * <p>For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
36
37
  * Policies</a>.</p>
37
38
  * <p>The following action is related to <code>GetBucketPolicy</code>:</p>
@@ -22,7 +22,7 @@ export interface GetBucketPolicyStatusCommandOutput extends GetBucketPolicyStatu
22
22
  * <p>Retrieves the policy status for an Amazon S3 bucket, indicating whether the bucket is public.
23
23
  * In order to use this operation, you must have the <code>s3:GetBucketPolicyStatus</code>
24
24
  * permission. For more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
25
- * Policy</a>.</p>
25
+ * Policy</a>.</p>
26
26
  * <p> For more information about when Amazon S3 considers a bucket public, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status">The Meaning of "Public"</a>. </p>
27
27
  * <p>The following operations are related to <code>GetBucketPolicyStatus</code>:</p>
28
28
  * <ul>
@@ -20,7 +20,8 @@ export interface GetBucketRequestPaymentCommandOutput extends GetBucketRequestPa
20
20
  /**
21
21
  * @public
22
22
  * <p>Returns the request payment configuration of a bucket. To use this version of the
23
- * operation, you must be the bucket owner. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester Pays Buckets</a>.</p>
23
+ * operation, you must be the bucket owner. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester Pays
24
+ * Buckets</a>.</p>
24
25
  * <p>The following operations are related to <code>GetBucketRequestPayment</code>:</p>
25
26
  * <ul>
26
27
  * <li>
@@ -21,8 +21,7 @@ export interface GetBucketWebsiteCommandOutput extends GetBucketWebsiteOutput, _
21
21
  * @public
22
22
  * <p>Returns the website configuration for a bucket. To host website on Amazon S3, you can
23
23
  * configure a bucket as website by adding a website configuration. For more information about
24
- * hosting websites, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">Hosting Websites on
25
- * Amazon S3</a>. </p>
24
+ * hosting websites, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">Hosting Websites on Amazon S3</a>. </p>
26
25
  * <p>This GET action requires the <code>S3:GetBucketWebsite</code> permission. By default,
27
26
  * only the bucket owner can read the bucket website configuration. However, bucket owners can
28
27
  * allow other users to read the website configuration by writing a bucket policy granting
@@ -32,10 +32,11 @@ export interface GetObjectAclCommandOutput extends GetObjectAclOutput, __Metadat
32
32
  * return ACL information about a different version, use the versionId subresource.</p>
33
33
  * <note>
34
34
  * <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership,
35
- * requests to read ACLs are still supported and return the <code>bucket-owner-full-control</code>
36
- * ACL with the owner being the account that created the bucket. For more information, see
37
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">
38
- * Controlling object ownership and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
35
+ * requests to read ACLs are still supported and return the
36
+ * <code>bucket-owner-full-control</code> ACL with the owner being the account that
37
+ * created the bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling object
38
+ * ownership and disabling ACLs</a> in the
39
+ * <i>Amazon S3 User Guide</i>.</p>
39
40
  * </note>
40
41
  * <p>The following operations are related to <code>GetObjectAcl</code>:</p>
41
42
  * <ul>