@aws-sdk/client-s3 3.258.0 → 3.261.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 (84) hide show
  1. package/dist-cjs/endpoint/ruleset.js +3 -3
  2. package/dist-cjs/protocols/Aws_restXml.js +1 -1
  3. package/dist-es/endpoint/ruleset.js +3 -3
  4. package/dist-es/protocols/Aws_restXml.js +1 -1
  5. package/dist-types/S3.d.ts +41 -356
  6. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +0 -3
  7. package/dist-types/commands/CopyObjectCommand.d.ts +0 -2
  8. package/dist-types/commands/CreateBucketCommand.d.ts +0 -1
  9. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +0 -12
  10. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +0 -2
  11. package/dist-types/commands/DeleteBucketCommand.d.ts +0 -1
  12. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +0 -1
  13. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +0 -1
  14. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +0 -2
  15. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +0 -2
  16. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +0 -3
  17. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +0 -2
  18. package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +0 -1
  19. package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +0 -3
  20. package/dist-types/commands/DeleteObjectCommand.d.ts +0 -5
  21. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +0 -3
  22. package/dist-types/commands/DeleteObjectsCommand.d.ts +0 -5
  23. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +0 -1
  24. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +0 -1
  25. package/dist-types/commands/GetBucketAclCommand.d.ts +0 -1
  26. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +0 -1
  27. package/dist-types/commands/GetBucketCorsCommand.d.ts +0 -3
  28. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +0 -3
  29. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +0 -2
  30. package/dist-types/commands/GetBucketLocationCommand.d.ts +0 -3
  31. package/dist-types/commands/GetBucketLoggingCommand.d.ts +0 -1
  32. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +0 -3
  33. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +0 -3
  34. package/dist-types/commands/GetBucketPolicyCommand.d.ts +0 -4
  35. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +0 -2
  36. package/dist-types/commands/GetBucketReplicationCommand.d.ts +0 -5
  37. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +0 -1
  38. package/dist-types/commands/GetBucketTaggingCommand.d.ts +0 -2
  39. package/dist-types/commands/GetBucketVersioningCommand.d.ts +0 -2
  40. package/dist-types/commands/GetObjectAclCommand.d.ts +1 -1
  41. package/dist-types/commands/GetObjectAttributesCommand.d.ts +40 -46
  42. package/dist-types/commands/GetObjectCommand.d.ts +0 -20
  43. package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +0 -1
  44. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +0 -1
  45. package/dist-types/commands/GetObjectRetentionCommand.d.ts +0 -1
  46. package/dist-types/commands/GetObjectTaggingCommand.d.ts +0 -4
  47. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +0 -3
  48. package/dist-types/commands/HeadBucketCommand.d.ts +0 -5
  49. package/dist-types/commands/HeadObjectCommand.d.ts +0 -7
  50. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +0 -4
  51. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +0 -4
  52. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +0 -4
  53. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +0 -5
  54. package/dist-types/commands/ListObjectsCommand.d.ts +0 -2
  55. package/dist-types/commands/ListObjectsV2Command.d.ts +0 -4
  56. package/dist-types/commands/ListPartsCommand.d.ts +0 -3
  57. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +0 -8
  58. package/dist-types/commands/PutBucketAclCommand.d.ts +0 -7
  59. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +0 -11
  60. package/dist-types/commands/PutBucketCorsCommand.d.ts +0 -1
  61. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +0 -1
  62. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +0 -1
  63. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +0 -2
  64. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +0 -15
  65. package/dist-types/commands/PutBucketLoggingCommand.d.ts +0 -9
  66. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +0 -4
  67. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +0 -8
  68. package/dist-types/commands/PutBucketPolicyCommand.d.ts +0 -3
  69. package/dist-types/commands/PutBucketReplicationCommand.d.ts +0 -8
  70. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +0 -1
  71. package/dist-types/commands/PutBucketTaggingCommand.d.ts +0 -4
  72. package/dist-types/commands/PutBucketVersioningCommand.d.ts +0 -6
  73. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +0 -4
  74. package/dist-types/commands/PutObjectAclCommand.d.ts +0 -3
  75. package/dist-types/commands/PutObjectCommand.d.ts +0 -8
  76. package/dist-types/commands/PutObjectTaggingCommand.d.ts +0 -12
  77. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +0 -6
  78. package/dist-types/commands/RestoreObjectCommand.d.ts +0 -1
  79. package/dist-types/commands/SelectObjectContentCommand.d.ts +0 -3
  80. package/dist-types/commands/UploadPartCommand.d.ts +0 -18
  81. package/dist-types/commands/UploadPartCopyCommand.d.ts +0 -10
  82. package/dist-types/models/models_0.d.ts +21 -50
  83. package/dist-types/models/models_1.d.ts +52 -53
  84. package/package.json +12 -12
@@ -33,8 +33,6 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
33
33
  * Upload</a>.</p>
34
34
  * <p>For information about permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and
35
35
  * Permissions</a>.</p>
36
- *
37
- *
38
36
  * <p>
39
37
  * <code>CompleteMultipartUpload</code> has the following special errors:</p>
40
38
  * <ul>
@@ -93,7 +91,6 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
93
91
  * </ul>
94
92
  * </li>
95
93
  * </ul>
96
- *
97
94
  * <p>The following operations are related to <code>CompleteMultipartUpload</code>:</p>
98
95
  * <ul>
99
96
  * <li>
@@ -98,7 +98,6 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
98
98
  * false</p>
99
99
  * </li>
100
100
  * </ul>
101
- *
102
101
  * <p>If both the <code>x-amz-copy-source-if-none-match</code> and
103
102
  * <code>x-amz-copy-source-if-modified-since</code> headers are present in the request and
104
103
  * evaluate as follows, Amazon S3 returns the <code>412 Precondition Failed</code> response
@@ -114,7 +113,6 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
114
113
  * true</p>
115
114
  * </li>
116
115
  * </ul>
117
- *
118
116
  * <note>
119
117
  * <p>All headers with the <code>x-amz-</code> prefix, including
120
118
  * <code>x-amz-copy-source</code>, must be signed.</p>
@@ -114,7 +114,6 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
114
114
  * <p>You can use either a canned ACL or specify access permissions explicitly. You cannot
115
115
  * do both.</p>
116
116
  * </note>
117
- *
118
117
  * <p>
119
118
  * <b>Permissions</b>
120
119
  * </p>
@@ -13,32 +13,26 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
13
13
  * upload ID in each of your subsequent upload part requests (see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>). You also include this
14
14
  * upload ID in the final request to either complete or abort the multipart upload
15
15
  * request.</p>
16
- *
17
16
  * <p>For more information about multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html">Multipart Upload Overview</a>.</p>
18
- *
19
17
  * <p>If you have configured a lifecycle rule to abort incomplete multipart uploads, the
20
18
  * upload must complete within the number of days specified in the bucket lifecycle
21
19
  * configuration. Otherwise, the incomplete multipart upload becomes eligible for an abort
22
20
  * action and Amazon S3 aborts the multipart upload. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config">Aborting
23
21
  * Incomplete Multipart Uploads Using a Bucket Lifecycle Policy</a>.</p>
24
- *
25
22
  * <p>For information about the permissions required to use the multipart upload API, see
26
23
  * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and
27
24
  * Permissions</a>.</p>
28
- *
29
25
  * <p>For request signing, multipart upload is just a series of regular requests. You initiate
30
26
  * a multipart upload, send one or more requests to upload parts, and then complete the
31
27
  * multipart upload process. You sign each request individually. There is nothing special
32
28
  * about signing multipart upload requests. For more information about signing, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html">Authenticating
33
29
  * Requests (Amazon Web Services Signature Version 4)</a>.</p>
34
- *
35
30
  * <note>
36
31
  * <p> After you initiate a multipart upload and upload one or more parts, to stop being
37
32
  * charged for storing the uploaded parts, you must either complete or abort the multipart
38
33
  * upload. Amazon S3 frees up the space used to store the parts and stop charging you for
39
34
  * storing them only after you either complete or abort a multipart upload. </p>
40
35
  * </note>
41
- *
42
36
  * <p>You can optionally request server-side encryption. For server-side encryption, Amazon S3
43
37
  * encrypts your data as it writes it to disks in its data centers and decrypts it when you
44
38
  * access it. You can provide your own encryption key, or use Amazon Web Services KMS keys or Amazon S3-managed encryption keys. If you choose to provide
@@ -50,16 +44,12 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
50
44
  * from the encrypted file parts before it completes the multipart upload. For more
51
45
  * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions">Multipart upload API
52
46
  * and permissions</a> in the <i>Amazon S3 User Guide</i>.</p>
53
- *
54
47
  * <p>If your Identity and Access Management (IAM) user or role is in the same Amazon Web Services account
55
48
  * as the KMS key, then you must have these permissions on the key policy. If your IAM
56
49
  * user or role belongs to a different account than the key, then you must have the
57
50
  * permissions on both the key policy and your IAM user or role.</p>
58
- *
59
- *
60
51
  * <p> For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Protecting
61
52
  * Data Using Server-Side Encryption</a>.</p>
62
- *
63
53
  * <dl>
64
54
  * <dt>Access Permissions</dt>
65
55
  * <dd>
@@ -256,10 +246,8 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
256
246
  * </p>
257
247
  * </li>
258
248
  * </ul>
259
- *
260
249
  * </dd>
261
250
  * </dl>
262
- *
263
251
  * <p>The following operations are related to <code>CreateMultipartUpload</code>:</p>
264
252
  * <ul>
265
253
  * <li>
@@ -15,10 +15,8 @@ export interface DeleteBucketAnalyticsConfigurationCommandOutput extends __Metad
15
15
  * by default. The bucket owner can grant this permission to others. For more information
16
16
  * 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
17
17
  * Resources</a>.</p>
18
- *
19
18
  * <p>For information about the Amazon S3 analytics feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html">Amazon S3 Analytics – Storage Class
20
19
  * Analysis</a>. </p>
21
- *
22
20
  * <p>The following operations are related to
23
21
  * <code>DeleteBucketAnalyticsConfiguration</code>:</p>
24
22
  * <ul>
@@ -10,7 +10,6 @@ export interface DeleteBucketCommandOutput extends __MetadataBearer {
10
10
  /**
11
11
  * <p>Deletes the S3 bucket. All objects (including all object versions and delete markers) in
12
12
  * the bucket must be deleted before the bucket itself can be deleted.</p>
13
- *
14
13
  * <p class="title">
15
14
  * <b>Related Resources</b>
16
15
  * </p>
@@ -14,7 +14,6 @@ export interface DeleteBucketCorsCommandOutput extends __MetadataBearer {
14
14
  * and can grant this permission to others. </p>
15
15
  * <p>For information about <code>cors</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html">Enabling
16
16
  * Cross-Origin Resource Sharing</a> in the <i>Amazon S3 User Guide</i>.</p>
17
- *
18
17
  * <p class="title">
19
18
  * <b>Related Resources:</b>
20
19
  * </p>
@@ -16,7 +16,6 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {
16
16
  * by default. The bucket owner can grant this permission to others. For more information
17
17
  * 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
18
18
  * Resources</a> in the <i>Amazon S3 User Guide</i>.</p>
19
- *
20
19
  * <p class="title">
21
20
  * <b>Related Resources</b>
22
21
  * </p>
@@ -15,10 +15,8 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
15
15
  * <p>To use this operation, you must have permission to perform the
16
16
  * <code>s3:PutLifecycleConfiguration</code> action. By default, the bucket owner has this
17
17
  * permission and the bucket owner can grant this permission to others.</p>
18
- *
19
18
  * <p>There is usually some time lag before lifecycle configuration deletion is fully
20
19
  * propagated to all the Amazon S3 systems.</p>
21
- *
22
20
  * <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
23
21
  * Describe Lifecycle Actions</a>.</p>
24
22
  * <p>Related actions include:</p>
@@ -11,13 +11,11 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
11
11
  * <p>Deletes a metrics configuration for the Amazon CloudWatch request metrics (specified by the
12
12
  * metrics configuration ID) from the bucket. Note that this doesn't include the daily storage
13
13
  * metrics.</p>
14
- *
15
14
  * <p> To use this operation, you must have permissions to perform the
16
15
  * <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by
17
16
  * default. The bucket owner can grant this permission to others. For more information about
18
17
  * 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
19
18
  * Resources</a>.</p>
20
- *
21
19
  * <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>
22
20
  * <p>The following operations are related to
23
21
  * <code>DeleteBucketMetricsConfiguration</code>:</p>
@@ -13,18 +13,15 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
13
13
  * Amazon Web Services account that owns the bucket, the calling identity must have the
14
14
  * <code>DeleteBucketPolicy</code> permissions on the specified bucket and belong to the
15
15
  * bucket owner's account to use this operation. </p>
16
- *
17
16
  * <p>If you don't have <code>DeleteBucketPolicy</code> permissions, Amazon S3 returns a <code>403
18
17
  * Access Denied</code> error. If you have the correct permissions, but you're not using an
19
18
  * identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
20
19
  * Allowed</code> error. </p>
21
- *
22
20
  * <important>
23
21
  * <p>As a security precaution, the root user of the Amazon Web Services account that owns a bucket can
24
22
  * always use this operation, even if the policy explicitly denies the root user the
25
23
  * ability to perform this action.</p>
26
24
  * </important>
27
- *
28
25
  * <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
29
26
  * UserPolicies</a>. </p>
30
27
  * <p>The following operations are related to <code>DeleteBucketPolicy</code>
@@ -18,9 +18,7 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
18
18
  * <p>It can take a while for the deletion of a replication configuration to fully
19
19
  * propagate.</p>
20
20
  * </note>
21
- *
22
21
  * <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>
23
- *
24
22
  * <p>The following operations are related to <code>DeleteBucketReplication</code>:</p>
25
23
  * <ul>
26
24
  * <li>
@@ -9,7 +9,6 @@ export interface DeleteBucketTaggingCommandOutput extends __MetadataBearer {
9
9
  }
10
10
  /**
11
11
  * <p>Deletes the tags from the bucket.</p>
12
- *
13
12
  * <p>To use this operation, you must have permission to perform the
14
13
  * <code>s3:PutBucketTagging</code> action. By default, the bucket owner has this
15
14
  * permission and can grant this permission to others. </p>
@@ -13,15 +13,12 @@ export interface DeleteBucketWebsiteCommandOutput extends __MetadataBearer {
13
13
  * bucket. You will get a <code>200 OK</code> response if the website configuration you are
14
14
  * trying to delete does not exist on the bucket. Amazon S3 returns a <code>404</code> response if
15
15
  * the bucket specified in the request does not exist.</p>
16
- *
17
16
  * <p>This DELETE action requires the <code>S3:DeleteBucketWebsite</code> permission. By
18
17
  * default, only the bucket owner can delete the website configuration attached to a bucket.
19
18
  * However, bucket owners can grant other users permission to delete the website configuration
20
19
  * by writing a bucket policy granting them the <code>S3:DeleteBucketWebsite</code>
21
20
  * permission. </p>
22
- *
23
21
  * <p>For more information about hosting websites, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">Hosting Websites on Amazon S3</a>. </p>
24
- *
25
22
  * <p>The following operations are related to <code>DeleteBucketWebsite</code>:</p>
26
23
  * <ul>
27
24
  * <li>
@@ -11,26 +11,21 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
11
11
  * <p>Removes the null version (if there is one) of an object and inserts a delete marker,
12
12
  * which becomes the latest version of the object. If there isn't a null version, Amazon S3 does
13
13
  * not remove any objects but will still respond that the command was successful.</p>
14
- *
15
14
  * <p>To remove a specific version, you must be the bucket owner and you must use the version
16
15
  * Id subresource. Using this subresource permanently deletes the version. If the object
17
16
  * deleted is a delete marker, Amazon S3 sets the response header,
18
17
  * <code>x-amz-delete-marker</code>, to true. </p>
19
- *
20
18
  * <p>If the object you want to delete is in a bucket where the bucket versioning
21
19
  * configuration is MFA Delete enabled, you must include the <code>x-amz-mfa</code> request
22
20
  * header in the DELETE <code>versionId</code> request. Requests that include
23
21
  * <code>x-amz-mfa</code> must use HTTPS. </p>
24
- *
25
22
  * <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>
26
- *
27
23
  * <p>You can delete objects by explicitly calling DELETE Object or configure its
28
24
  * lifecycle (<a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>) to
29
25
  * enable Amazon S3 to remove them for you. If you want to block users or accounts from removing or
30
26
  * deleting objects from your bucket, you must deny them the <code>s3:DeleteObject</code>,
31
27
  * <code>s3:DeleteObjectVersion</code>, and <code>s3:PutLifeCycleConfiguration</code>
32
28
  * actions. </p>
33
- *
34
29
  * <p>The following action is related to <code>DeleteObject</code>:</p>
35
30
  * <ul>
36
31
  * <li>
@@ -11,14 +11,11 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
11
11
  * <p>Removes the entire tag set from the specified object. For more information about
12
12
  * managing object tags, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html"> Object
13
13
  * Tagging</a>.</p>
14
- *
15
14
  * <p>To use this operation, you must have permission to perform the
16
15
  * <code>s3:DeleteObjectTagging</code> action.</p>
17
- *
18
16
  * <p>To delete tags of a specific object version, add the <code>versionId</code> query
19
17
  * parameter in the request. You will need permission for the
20
18
  * <code>s3:DeleteObjectVersionTagging</code> action.</p>
21
- *
22
19
  * <p>The following operations are related to
23
20
  * <code>DeleteBucketMetricsConfiguration</code>:</p>
24
21
  * <ul>
@@ -12,31 +12,26 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
12
12
  * request. If you know the object keys that you want to delete, then this action provides
13
13
  * a suitable alternative to sending individual delete requests, reducing per-request
14
14
  * overhead.</p>
15
- *
16
15
  * <p>The request contains a list of up to 1000 keys that you want to delete. In the XML, you
17
16
  * provide the object key names, and optionally, version IDs if you want to delete a specific
18
17
  * version of the object from a versioning-enabled bucket. For each key, Amazon S3 performs a
19
18
  * delete action and returns the result of that delete, success, or failure, in the
20
19
  * response. Note that if the object specified in the request is not found, Amazon S3 returns the
21
20
  * result as deleted.</p>
22
- *
23
21
  * <p> The action supports two modes for the response: verbose and quiet. By default, the
24
22
  * action uses verbose mode in which the response includes the result of deletion of each
25
23
  * key in your request. In quiet mode the response includes only keys where the delete
26
24
  * action encountered an error. For a successful deletion, the action does not return
27
25
  * any information about the delete in the response body.</p>
28
- *
29
26
  * <p>When performing this action on an MFA Delete enabled bucket, that attempts to delete
30
27
  * any versioned objects, you must include an MFA token. If you do not provide one, the entire
31
28
  * request will fail, even if there are non-versioned objects you are trying to delete. If you
32
29
  * provide an invalid token, whether there are versioned keys in the request or not, the
33
30
  * 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
34
31
  * Delete</a>.</p>
35
- *
36
32
  * <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon
37
33
  * S3 uses the header value to ensure that your request body has not been altered in
38
34
  * transit.</p>
39
- *
40
35
  * <p>The following operations are related to <code>DeleteObjects</code>:</p>
41
36
  * <ul>
42
37
  * <li>
@@ -12,7 +12,6 @@ export interface DeletePublicAccessBlockCommandOutput extends __MetadataBearer {
12
12
  * operation, you must have the <code>s3:PutBucketPublicAccessBlock</code> permission. For
13
13
  * 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
14
14
  * Resources</a>.</p>
15
- *
16
15
  * <p>The following operations are related to <code>DeletePublicAccessBlock</code>:</p>
17
16
  * <ul>
18
17
  * <li>
@@ -22,7 +22,6 @@ export interface GetBucketAccelerateConfigurationCommandOutput extends GetBucket
22
22
  * <p>A GET <code>accelerate</code> request does not return a state value for a bucket that
23
23
  * has no transfer acceleration state. A bucket has no Transfer Acceleration state if a state
24
24
  * has never been set on the bucket. </p>
25
- *
26
25
  * <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
27
26
  * Amazon S3 User Guide.</p>
28
27
  * <p class="title">
@@ -20,7 +20,6 @@ export interface GetBucketAclCommandOutput extends GetBucketAclOutput, __Metadat
20
20
  * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">
21
21
  * Controlling object ownership and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
22
22
  * </note>
23
- *
24
23
  * <p class="title">
25
24
  * <b>Related Resources</b>
26
25
  * </p>
@@ -17,7 +17,6 @@ export interface GetBucketAnalyticsConfigurationCommandOutput extends GetBucketA
17
17
  * Resources</a> in the <i>Amazon S3 User Guide</i>. </p>
18
18
  * <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
19
19
  * Analysis</a> in the <i>Amazon S3 User Guide</i>.</p>
20
- *
21
20
  * <p class="title">
22
21
  * <b>Related Resources</b>
23
22
  * </p>
@@ -10,14 +10,11 @@ export interface GetBucketCorsCommandOutput extends GetBucketCorsOutput, __Metad
10
10
  /**
11
11
  * <p>Returns the Cross-Origin Resource Sharing (CORS) configuration information set for the
12
12
  * bucket.</p>
13
- *
14
13
  * <p> To use this operation, you must have permission to perform the
15
14
  * <code>s3:GetBucketCORS</code> action. By default, the bucket owner has this permission
16
15
  * and can grant it to others.</p>
17
- *
18
16
  * <p> For more information about CORS, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html"> Enabling Cross-Origin Resource
19
17
  * Sharing</a>.</p>
20
- *
21
18
  * <p>The following operations are related to <code>GetBucketCors</code>:</p>
22
19
  * <ul>
23
20
  * <li>
@@ -10,15 +10,12 @@ export interface GetBucketInventoryConfigurationCommandOutput extends GetBucketI
10
10
  /**
11
11
  * <p>Returns an inventory configuration (identified by the inventory configuration ID) from
12
12
  * the bucket.</p>
13
- *
14
13
  * <p>To use this operation, you must have permissions to perform the
15
14
  * <code>s3:GetInventoryConfiguration</code> action. The bucket owner has this permission
16
15
  * by default and can grant this permission to others. For more information about permissions,
17
16
  * 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
18
17
  * Resources</a>.</p>
19
- *
20
18
  * <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>
21
- *
22
19
  * <p>The following operations are related to
23
20
  * <code>GetBucketInventoryConfiguration</code>:</p>
24
21
  * <ul>
@@ -19,13 +19,11 @@ export interface GetBucketLifecycleConfigurationCommandOutput extends GetBucketL
19
19
  * <p>Returns the lifecycle configuration information set on the bucket. For information about
20
20
  * lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object
21
21
  * Lifecycle Management</a>.</p>
22
- *
23
22
  * <p>To use this operation, you must have permission to perform the
24
23
  * <code>s3:GetLifecycleConfiguration</code> action. The bucket owner has this permission,
25
24
  * by default. The bucket owner can grant this permission to others. For more information
26
25
  * 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
27
26
  * Resources</a>.</p>
28
- *
29
27
  * <p>
30
28
  * <code>GetBucketLifecycleConfiguration</code> has the following special error:</p>
31
29
  * <ul>
@@ -11,11 +11,8 @@ export interface GetBucketLocationCommandOutput extends GetBucketLocationOutput,
11
11
  * <p>Returns the Region the bucket resides in. You set the bucket's Region using the
12
12
  * <code>LocationConstraint</code> request parameter in a <code>CreateBucket</code>
13
13
  * request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>.</p>
14
- *
15
14
  * <p>To use this implementation of the operation, you must be the bucket owner.</p>
16
- *
17
15
  * <p>To use this API against an access point, provide the alias of the access point in place of the bucket name.</p>
18
- *
19
16
  * <p>The following operations are related to <code>GetBucketLocation</code>:</p>
20
17
  * <ul>
21
18
  * <li>
@@ -10,7 +10,6 @@ export interface GetBucketLoggingCommandOutput extends GetBucketLoggingOutput, _
10
10
  /**
11
11
  * <p>Returns the logging status of a bucket and the permissions users have to view and modify
12
12
  * that status. To use GET, you must be the bucket owner.</p>
13
- *
14
13
  * <p>The following operations are related to <code>GetBucketLogging</code>:</p>
15
14
  * <ul>
16
15
  * <li>
@@ -10,16 +10,13 @@ export interface GetBucketMetricsConfigurationCommandOutput extends GetBucketMet
10
10
  /**
11
11
  * <p>Gets a metrics configuration (specified by the metrics configuration ID) from the
12
12
  * bucket. Note that this doesn't include the daily storage metrics.</p>
13
- *
14
13
  * <p> To use this operation, you must have permissions to perform the
15
14
  * <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by
16
15
  * default. The bucket owner can grant this permission to others. For more information about
17
16
  * 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
18
17
  * Resources</a>.</p>
19
- *
20
18
  * <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
21
19
  * CloudWatch</a>.</p>
22
- *
23
20
  * <p>The following operations are related to
24
21
  * <code>GetBucketMetricsConfiguration</code>:</p>
25
22
  * <ul>
@@ -11,16 +11,13 @@ export interface GetBucketNotificationConfigurationCommandOutput extends Notific
11
11
  * <p>Returns the notification configuration of a bucket.</p>
12
12
  * <p>If notifications are not enabled on the bucket, the action returns an empty
13
13
  * <code>NotificationConfiguration</code> element.</p>
14
- *
15
14
  * <p>By default, you must be the bucket owner to read the notification configuration of a
16
15
  * bucket. However, the bucket owner can use a bucket policy to grant permission to other
17
16
  * users to read this configuration with the <code>s3:GetBucketNotification</code>
18
17
  * permission.</p>
19
- *
20
18
  * <p>For more information about setting and reading the notification configuration on a
21
19
  * bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Setting Up Notification of
22
20
  * 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>
23
- *
24
21
  * <p>The following action is related to <code>GetBucketNotification</code>:</p>
25
22
  * <ul>
26
23
  * <li>
@@ -12,21 +12,17 @@ export interface GetBucketPolicyCommandOutput extends GetBucketPolicyOutput, __M
12
12
  * root user of the Amazon Web Services account that owns the bucket, the calling identity must have the
13
13
  * <code>GetBucketPolicy</code> permissions on the specified bucket and belong to the
14
14
  * bucket owner's account in order to use this operation.</p>
15
- *
16
15
  * <p>If you don't have <code>GetBucketPolicy</code> permissions, Amazon S3 returns a <code>403
17
16
  * Access Denied</code> error. If you have the correct permissions, but you're not using an
18
17
  * identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
19
18
  * Allowed</code> error.</p>
20
- *
21
19
  * <important>
22
20
  * <p>As a security precaution, the root user of the Amazon Web Services account that owns a bucket can
23
21
  * always use this operation, even if the policy explicitly denies the root user the
24
22
  * ability to perform this action.</p>
25
23
  * </important>
26
- *
27
24
  * <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
28
25
  * Policies</a>.</p>
29
- *
30
26
  * <p>The following action is related to <code>GetBucketPolicy</code>:</p>
31
27
  * <ul>
32
28
  * <li>
@@ -12,9 +12,7 @@ export interface GetBucketPolicyStatusCommandOutput extends GetBucketPolicyStatu
12
12
  * In order to use this operation, you must have the <code>s3:GetBucketPolicyStatus</code>
13
13
  * 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
14
14
  * Policy</a>.</p>
15
- *
16
15
  * <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>
17
- *
18
16
  * <p>The following operations are related to <code>GetBucketPolicyStatus</code>:</p>
19
17
  * <ul>
20
18
  * <li>
@@ -16,20 +16,15 @@ export interface GetBucketReplicationCommandOutput extends GetBucketReplicationO
16
16
  * </note>
17
17
  * <p> For information about replication configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the
18
18
  * <i>Amazon S3 User Guide</i>.</p>
19
- *
20
19
  * <p>This action requires permissions for the <code>s3:GetReplicationConfiguration</code>
21
20
  * action. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
22
21
  * Policies</a>.</p>
23
- *
24
22
  * <p>If you include the <code>Filter</code> element in a replication configuration, you must
25
23
  * also include the <code>DeleteMarkerReplication</code> and <code>Priority</code> elements.
26
24
  * The response also returns those elements.</p>
27
- *
28
25
  * <p>For information about <code>GetBucketReplication</code> errors, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList">List of
29
26
  * replication-related error codes</a>
30
27
  * </p>
31
- *
32
- *
33
28
  * <p>The following operations are related to <code>GetBucketReplication</code>:</p>
34
29
  * <ul>
35
30
  * <li>
@@ -10,7 +10,6 @@ export interface GetBucketRequestPaymentCommandOutput extends GetBucketRequestPa
10
10
  /**
11
11
  * <p>Returns the request payment configuration of a bucket. To use this version of the
12
12
  * 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>
13
- *
14
13
  * <p>The following operations are related to <code>GetBucketRequestPayment</code>:</p>
15
14
  * <ul>
16
15
  * <li>
@@ -12,7 +12,6 @@ export interface GetBucketTaggingCommandOutput extends GetBucketTaggingOutput, _
12
12
  * <p>To use this operation, you must have permission to perform the
13
13
  * <code>s3:GetBucketTagging</code> action. By default, the bucket owner has this
14
14
  * permission and can grant this permission to others.</p>
15
- *
16
15
  * <p>
17
16
  * <code>GetBucketTagging</code> has the following special error:</p>
18
17
  * <ul>
@@ -26,7 +25,6 @@ export interface GetBucketTaggingCommandOutput extends GetBucketTaggingOutput, _
26
25
  * </ul>
27
26
  * </li>
28
27
  * </ul>
29
- *
30
28
  * <p>The following operations are related to <code>GetBucketTagging</code>:</p>
31
29
  * <ul>
32
30
  * <li>
@@ -10,11 +10,9 @@ export interface GetBucketVersioningCommandOutput extends GetBucketVersioningOut
10
10
  /**
11
11
  * <p>Returns the versioning state of a bucket.</p>
12
12
  * <p>To retrieve the versioning state of a bucket, you must be the bucket owner.</p>
13
- *
14
13
  * <p>This implementation also returns the MFA Delete status of the versioning state. If the
15
14
  * MFA Delete status is <code>enabled</code>, the bucket owner must use an authentication
16
15
  * device to change the versioning state of the bucket.</p>
17
- *
18
16
  * <p>The following operations are related to <code>GetBucketVersioning</code>:</p>
19
17
  * <ul>
20
18
  * <li>
@@ -14,7 +14,7 @@ export interface GetObjectAclCommandOutput extends GetObjectAclOutput, __Metadat
14
14
  * User Guide</i>
15
15
  * </p>
16
16
  * <p>This action is not supported by Amazon S3 on Outposts.</p>
17
- * <p>
17
+ * <p>
18
18
  * <b>Versioning</b>
19
19
  * </p>
20
20
  * <p>By default, GET returns ACL information about the current version of an object. To