@aws-sdk/client-s3 3.352.0 → 3.354.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 (29) hide show
  1. package/dist-cjs/protocols/Aws_restXml.js +8 -0
  2. package/dist-es/protocols/Aws_restXml.js +8 -0
  3. package/dist-types/commands/CopyObjectCommand.d.ts +26 -23
  4. package/dist-types/commands/CreateBucketCommand.d.ts +45 -116
  5. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +3 -1
  6. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +11 -11
  7. package/dist-types/commands/DeleteObjectsCommand.d.ts +22 -22
  8. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +2 -0
  9. package/dist-types/commands/GetBucketEncryptionCommand.d.ts +3 -3
  10. package/dist-types/commands/GetObjectCommand.d.ts +48 -47
  11. package/dist-types/commands/HeadObjectCommand.d.ts +19 -12
  12. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +2 -0
  13. package/dist-types/commands/ListObjectVersionsCommand.d.ts +2 -0
  14. package/dist-types/commands/ListObjectsCommand.d.ts +1 -0
  15. package/dist-types/commands/ListObjectsV2Command.d.ts +1 -0
  16. package/dist-types/commands/PutBucketAclCommand.d.ts +1 -1
  17. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +11 -10
  18. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +3 -3
  19. package/dist-types/commands/PutBucketLoggingCommand.d.ts +7 -6
  20. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +1 -1
  21. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +1 -1
  22. package/dist-types/commands/PutObjectCommand.d.ts +51 -50
  23. package/dist-types/commands/RestoreObjectCommand.d.ts +5 -5
  24. package/dist-types/commands/SelectObjectContentCommand.d.ts +9 -4
  25. package/dist-types/commands/UploadPartCopyCommand.d.ts +13 -13
  26. package/dist-types/models/models_0.d.ts +107 -56
  27. package/dist-types/models/models_1.d.ts +9 -9
  28. package/dist-types/ts3.4/models/models_0.d.ts +8 -0
  29. package/package.json +15 -15
@@ -23,9 +23,9 @@ export interface GetBucketEncryptionCommandOutput extends GetBucketEncryptionOut
23
23
  }
24
24
  /**
25
25
  * @public
26
- * <p>Returns the default encryption configuration for an Amazon S3 bucket. By default, all buckets have a default encryption configuration that
27
- * uses server-side encryption with Amazon S3 managed keys (SSE-S3). For information
28
- * about the bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket
26
+ * <p>Returns the default encryption configuration for an Amazon S3 bucket. By default, all buckets
27
+ * have a default encryption configuration that uses server-side encryption with Amazon S3 managed
28
+ * keys (SSE-S3). For information about the bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket
29
29
  * Default Encryption</a> in the <i>Amazon S3 User Guide</i>.</p>
30
30
  * <p>To use this operation, you must have permission to perform the
31
31
  * <code>s3:GetEncryptionConfiguration</code> action. The bucket owner has this permission
@@ -40,7 +40,7 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
40
40
  * request types, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket">HTTP Host
41
41
  * Header Bucket Specification</a>.</p>
42
42
  * <p>For more information about returning the ACL of an object, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html">GetObjectAcl</a>.</p>
43
- * <p>If the object you are retrieving is stored in the S3 Glacier or
43
+ * <p>If the object you are retrieving is stored in the S3 Glacier Flexible Retrieval or
44
44
  * S3 Glacier Deep Archive storage class, or S3 Intelligent-Tiering Archive or
45
45
  * S3 Intelligent-Tiering Deep Archive tiers, before you can retrieve the object you must first restore a
46
46
  * copy using <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html">RestoreObject</a>. Otherwise, this action returns an
@@ -48,21 +48,28 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
48
48
  * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html">Restoring
49
49
  * Archived Objects</a>.</p>
50
50
  * <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>, should not
51
- * be sent for GET requests if your object uses server-side encryption with KMS keys
52
- * (SSE-KMS) or server-side encryption with Amazon S3–managed encryption keys (SSE-S3). If your
53
- * object does use these types of keys, you’ll get an HTTP 400 BadRequest error.</p>
51
+ * be sent for GET requests if your object uses server-side encryption with Key Management Service (KMS)
52
+ * keys (SSE-KMS), dual-layer server-side encryption with Amazon Web Services KMS keys (DSSE-KMS), or
53
+ * server-side encryption with Amazon S3 managed encryption keys (SSE-S3). If your object does use
54
+ * these types of keys, you’ll get an HTTP 400 Bad Request error.</p>
54
55
  * <p>If you encrypt an object by using server-side encryption with customer-provided
55
56
  * encryption keys (SSE-C) when you store the object in Amazon S3, then when you GET the object,
56
57
  * you must use the following headers:</p>
57
58
  * <ul>
58
59
  * <li>
59
- * <p>x-amz-server-side-encryption-customer-algorithm</p>
60
+ * <p>
61
+ * <code>x-amz-server-side-encryption-customer-algorithm</code>
62
+ * </p>
60
63
  * </li>
61
64
  * <li>
62
- * <p>x-amz-server-side-encryption-customer-key</p>
65
+ * <p>
66
+ * <code>x-amz-server-side-encryption-customer-key</code>
67
+ * </p>
63
68
  * </li>
64
69
  * <li>
65
- * <p>x-amz-server-side-encryption-customer-key-MD5</p>
70
+ * <p>
71
+ * <code>x-amz-server-side-encryption-customer-key-MD5</code>
72
+ * </p>
66
73
  * </li>
67
74
  * </ul>
68
75
  * <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption
@@ -76,22 +83,16 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
76
83
  * <dd>
77
84
  * <p>You need the relevant read object (or version) permission for this operation. For more
78
85
  * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
79
- * Policy</a>. If the object you request does not exist, the error Amazon S3 returns depends
86
+ * Policy</a>. If the object that you request doesn’t exist, the error that Amazon S3 returns depends
80
87
  * on whether you also have the <code>s3:ListBucket</code> permission.</p>
81
- * <ul>
82
- * <li>
83
- * <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3 will
84
- * return an HTTP status code 404 ("no such key") error.</p>
85
- * </li>
86
- * <li>
87
- * <p>If you don’t have the <code>s3:ListBucket</code> permission, Amazon S3 will return an
88
+ * <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3
89
+ * returns an HTTP status code 404 (Not Found) error.</p>
90
+ * <p>If you don’t have the <code>s3:ListBucket</code> permission, Amazon S3 returns an
88
91
  * HTTP status code 403 ("access denied") error.</p>
89
- * </li>
90
- * </ul>
91
92
  * </dd>
92
93
  * <dt>Versioning</dt>
93
94
  * <dd>
94
- * <p>By default, the GET action returns the current version of an object. To return a
95
+ * <p>By default, the <code>GET</code> action returns the current version of an object. To return a
95
96
  * different version, use the <code>versionId</code> subresource.</p>
96
97
  * <note>
97
98
  * <ul>
@@ -114,17 +115,17 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
114
115
  * </dd>
115
116
  * <dt>Overriding Response Header Values</dt>
116
117
  * <dd>
117
- * <p>There are times when you want to override certain response header values in a GET
118
+ * <p>There are times when you want to override certain response header values in a <code>GET</code>
118
119
  * response. For example, you might override the <code>Content-Disposition</code> response
119
- * header value in your GET request.</p>
120
+ * header value in your <code>GET</code> request.</p>
120
121
  * <p>You can override values for a set of response headers using the following query
121
122
  * parameters. These response header values are sent only on a successful request, that is,
122
123
  * when status code 200 OK is returned. The set of headers you can override using these
123
124
  * parameters is a subset of the headers that Amazon S3 accepts when you create an object. The
124
- * response headers that you can override for the GET response are <code>Content-Type</code>,
125
+ * response headers that you can override for the <code>GET</code> response are <code>Content-Type</code>,
125
126
  * <code>Content-Language</code>, <code>Expires</code>, <code>Cache-Control</code>,
126
127
  * <code>Content-Disposition</code>, and <code>Content-Encoding</code>. To override these
127
- * header values in the GET response, you use the following request parameters.</p>
128
+ * header values in the <code>GET</code> response, you use the following request parameters.</p>
128
129
  * <note>
129
130
  * <p>You must sign the request, either using an Authorization header or a presigned URL,
130
131
  * when using these parameters. They cannot be used with an unsigned (anonymous)
@@ -166,13 +167,13 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
166
167
  * <dt>Overriding Response Header Values</dt>
167
168
  * <dd>
168
169
  * <p>If both of the <code>If-Match</code> and <code>If-Unmodified-Since</code> headers are
169
- * present in the request as follows: <code>If-Match</code> condition evaluates to
170
- * <code>true</code>, and; <code>If-Unmodified-Since</code> condition evaluates to
171
- * <code>false</code>; then, S3 returns 200 OK and the data requested. </p>
170
+ * present in the request as follows: <code>If-Match</code> condition evaluates to
171
+ * <code>true</code>, and; <code>If-Unmodified-Since</code> condition evaluates to
172
+ * <code>false</code>; then, S3 returns 200 OK and the data requested. </p>
172
173
  * <p>If both of the <code>If-None-Match</code> and <code>If-Modified-Since</code> headers are
173
- * present in the request as follows:<code> If-None-Match</code> condition evaluates to
174
- * <code>false</code>, and; <code>If-Modified-Since</code> condition evaluates to
175
- * <code>true</code>; then, S3 returns 304 Not Modified response code.</p>
174
+ * present in the request as follows:<code> If-None-Match</code> condition evaluates to
175
+ * <code>false</code>, and; <code>If-Modified-Since</code> condition evaluates to
176
+ * <code>true</code>; then, S3 returns 304 Not Modified response code.</p>
176
177
  * <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>.</p>
177
178
  * </dd>
178
179
  * </dl>
@@ -278,53 +279,53 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
278
279
  * @throws {@link S3ServiceException}
279
280
  * <p>Base exception class for all service exceptions from S3 service.</p>
280
281
  *
281
- * @example To retrieve an object
282
+ * @example To retrieve a byte range of an object
282
283
  * ```javascript
283
- * // The following example retrieves an object for an S3 bucket.
284
+ * // The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range.
284
285
  * const input = {
285
286
  * "Bucket": "examplebucket",
286
- * "Key": "HappyFace.jpg"
287
+ * "Key": "SampleFile.txt",
288
+ * "Range": "bytes=0-9"
287
289
  * };
288
290
  * const command = new GetObjectCommand(input);
289
291
  * const response = await client.send(command);
290
292
  * /* response ==
291
293
  * {
292
294
  * "AcceptRanges": "bytes",
293
- * "ContentLength": "3191",
294
- * "ContentType": "image/jpeg",
295
- * "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
296
- * "LastModified": "Thu, 15 Dec 2016 01:19:41 GMT",
295
+ * "ContentLength": "10",
296
+ * "ContentRange": "bytes 0-9/43",
297
+ * "ContentType": "text/plain",
298
+ * "ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
299
+ * "LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
297
300
  * "Metadata": {},
298
- * "TagCount": 2,
299
301
  * "VersionId": "null"
300
302
  * }
301
303
  * *\/
302
- * // example id: to-retrieve-an-object-1481827837012
304
+ * // example id: to-retrieve-a-byte-range-of-an-object--1481832674603
303
305
  * ```
304
306
  *
305
- * @example To retrieve a byte range of an object
307
+ * @example To retrieve an object
306
308
  * ```javascript
307
- * // The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range.
309
+ * // The following example retrieves an object for an S3 bucket.
308
310
  * const input = {
309
311
  * "Bucket": "examplebucket",
310
- * "Key": "SampleFile.txt",
311
- * "Range": "bytes=0-9"
312
+ * "Key": "HappyFace.jpg"
312
313
  * };
313
314
  * const command = new GetObjectCommand(input);
314
315
  * const response = await client.send(command);
315
316
  * /* response ==
316
317
  * {
317
318
  * "AcceptRanges": "bytes",
318
- * "ContentLength": "10",
319
- * "ContentRange": "bytes 0-9/43",
320
- * "ContentType": "text/plain",
321
- * "ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
322
- * "LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
319
+ * "ContentLength": "3191",
320
+ * "ContentType": "image/jpeg",
321
+ * "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
322
+ * "LastModified": "Thu, 15 Dec 2016 01:19:41 GMT",
323
323
  * "Metadata": {},
324
+ * "TagCount": 2,
324
325
  * "VersionId": "null"
325
326
  * }
326
327
  * *\/
327
- * // example id: to-retrieve-a-byte-range-of-an-object--1481832674603
328
+ * // example id: to-retrieve-an-object-1481827837012
328
329
  * ```
329
330
  *
330
331
  */
@@ -23,8 +23,8 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
23
23
  }
24
24
  /**
25
25
  * @public
26
- * <p>The HEAD action retrieves metadata from an object without returning the object itself.
27
- * This action is useful if you're only interested in an object's metadata. To use HEAD, you
26
+ * <p>The <code>HEAD</code> action retrieves metadata from an object without returning the object itself.
27
+ * This action is useful if you're only interested in an object's metadata. To use <code>HEAD</code>, you
28
28
  * must have READ access to the object.</p>
29
29
  * <p>A <code>HEAD</code> request has the same options as a <code>GET</code> action on an
30
30
  * object. The response is identical to the <code>GET</code> response except that there is no
@@ -37,13 +37,19 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
37
37
  * metadata from the object, you must use the following headers:</p>
38
38
  * <ul>
39
39
  * <li>
40
- * <p>x-amz-server-side-encryption-customer-algorithm</p>
40
+ * <p>
41
+ * <code>x-amz-server-side-encryption-customer-algorithm</code>
42
+ * </p>
41
43
  * </li>
42
44
  * <li>
43
- * <p>x-amz-server-side-encryption-customer-key</p>
45
+ * <p>
46
+ * <code>x-amz-server-side-encryption-customer-key</code>
47
+ * </p>
44
48
  * </li>
45
49
  * <li>
46
- * <p>x-amz-server-side-encryption-customer-key-MD5</p>
50
+ * <p>
51
+ * <code>x-amz-server-side-encryption-customer-key-MD5</code>
52
+ * </p>
47
53
  * </li>
48
54
  * </ul>
49
55
  * <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption
@@ -52,10 +58,11 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
52
58
  * <ul>
53
59
  * <li>
54
60
  * <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>,
55
- * should not be sent for GET requests if your object uses server-side encryption
56
- * with KMS keys (SSE-KMS) or server-side encryption with Amazon S3–managed encryption
57
- * keys (SSE-S3). If your object does use these types of keys, you’ll get an HTTP 400
58
- * BadRequest error.</p>
61
+ * should not be sent for <code>GET</code> requests if your object uses server-side
62
+ * encryption with Key Management Service (KMS) keys (SSE-KMS), dual-layer server-side
63
+ * encryption with Amazon Web Services KMS keys (DSSE-KMS), or server-side encryption with Amazon S3
64
+ * managed encryption keys (SSE-S3). If your object does use these types of keys,
65
+ * you’ll get an HTTP 400 Bad Request error.</p>
59
66
  * </li>
60
67
  * <li>
61
68
  * <p> The last modified property in this case is the creation date of the
@@ -109,16 +116,16 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
109
116
  * <dd>
110
117
  * <p>You need the relevant read object (or version) permission for this operation. For more
111
118
  * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html">Actions, resources, and condition keys for Amazon S3</a>.
112
- * If the object you request does not exist, the error Amazon S3 returns depends
119
+ * If the object you request doesn't exist, the error that Amazon S3 returns depends
113
120
  * on whether you also have the s3:ListBucket permission.</p>
114
121
  * <ul>
115
122
  * <li>
116
123
  * <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3 returns
117
- * an HTTP status code 404 ("no such key") error.</p>
124
+ * an HTTP status code 404 error.</p>
118
125
  * </li>
119
126
  * <li>
120
127
  * <p>If you don’t have the <code>s3:ListBucket</code> permission, Amazon S3 returns an HTTP
121
- * status code 403 ("access denied") error.</p>
128
+ * status code 403 error.</p>
122
129
  * </li>
123
130
  * </ul>
124
131
  * </dd>
@@ -84,6 +84,7 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
84
84
  * Prefix: "STRING_VALUE",
85
85
  * UploadIdMarker: "STRING_VALUE",
86
86
  * ExpectedBucketOwner: "STRING_VALUE",
87
+ * RequestPayer: "requester",
87
88
  * };
88
89
  * const command = new ListMultipartUploadsCommand(input);
89
90
  * const response = await client.send(command);
@@ -120,6 +121,7 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
120
121
  * // },
121
122
  * // ],
122
123
  * // EncodingType: "url",
124
+ * // RequestCharged: "requester",
123
125
  * // };
124
126
  *
125
127
  * ```
@@ -74,6 +74,7 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
74
74
  * Prefix: "STRING_VALUE",
75
75
  * VersionIdMarker: "STRING_VALUE",
76
76
  * ExpectedBucketOwner: "STRING_VALUE",
77
+ * RequestPayer: "requester",
77
78
  * };
78
79
  * const command = new ListObjectVersionsCommand(input);
79
80
  * const response = await client.send(command);
@@ -123,6 +124,7 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
123
124
  * // },
124
125
  * // ],
125
126
  * // EncodingType: "url",
127
+ * // RequestCharged: "requester",
126
128
  * // };
127
129
  *
128
130
  * ```
@@ -107,6 +107,7 @@ export interface ListObjectsCommandOutput extends ListObjectsOutput, __MetadataB
107
107
  * // },
108
108
  * // ],
109
109
  * // EncodingType: "url",
110
+ * // RequestCharged: "requester",
110
111
  * // };
111
112
  *
112
113
  * ```
@@ -112,6 +112,7 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
112
112
  * // ContinuationToken: "STRING_VALUE",
113
113
  * // NextContinuationToken: "STRING_VALUE",
114
114
  * // StartAfter: "STRING_VALUE",
115
+ * // RequestCharged: "requester",
115
116
  * // };
116
117
  *
117
118
  * ```
@@ -54,7 +54,7 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
54
54
  * <dl>
55
55
  * <dt>Permissions</dt>
56
56
  * <dd>
57
- * <p>You can set access permissions using one of the following methods:</p>
57
+ * <p>You can set access permissions by using one of the following methods:</p>
58
58
  * <ul>
59
59
  * <li>
60
60
  * <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3 supports
@@ -25,20 +25,21 @@ export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
25
25
  * @public
26
26
  * <p>This action uses the <code>encryption</code> subresource to configure default encryption
27
27
  * and Amazon S3 Bucket Keys for an existing bucket.</p>
28
- * <p>By default, all buckets have a default encryption configuration that
29
- * uses server-side encryption with Amazon S3 managed keys (SSE-S3).
30
- * You can optionally configure default encryption for a bucket by using server-side
31
- * encryption with an Amazon Web Services KMS key (SSE-KMS) or a customer-provided key (SSE-C). If you specify default encryption by using
32
- * SSE-KMS, you can also configure Amazon S3 Bucket Keys. For information about bucket default encryption,
33
- * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3
34
- * bucket default encryption</a> in the <i>Amazon S3 User Guide</i>. For more
35
- * information about S3 Bucket Keys, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket Keys</a> in the
36
- * <i>Amazon S3 User Guide</i>.</p>
28
+ * <p>By default, all buckets have a default encryption configuration that uses server-side
29
+ * encryption with Amazon S3 managed keys (SSE-S3). You can optionally configure default encryption
30
+ * for a bucket by using server-side encryption with Key Management Service (KMS) keys (SSE-KMS),
31
+ * dual-layer server-side encryption with Amazon Web Services KMS keys (DSSE-KMS), or server-side
32
+ * encryption with customer-provided keys (SSE-C). If you specify default encryption by using
33
+ * SSE-KMS, you can also configure Amazon S3 Bucket Keys. For information about bucket default
34
+ * encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 bucket default encryption</a>
35
+ * in the <i>Amazon S3 User Guide</i>. For more information about S3 Bucket Keys, see
36
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket
37
+ * Keys</a> in the <i>Amazon S3 User Guide</i>.</p>
37
38
  * <important>
38
39
  * <p>This action requires Amazon Web Services Signature Version 4. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html">
39
40
  * Authenticating Requests (Amazon Web Services Signature Version 4)</a>. </p>
40
41
  * </important>
41
- * <p>To use this operation, you must have permissions to perform the
42
+ * <p>To use this operation, you must have permission to perform the
42
43
  * <code>s3:PutEncryptionConfiguration</code> action. The bucket owner has this permission
43
44
  * by default. The bucket owner can grant this permission to others. For more information
44
45
  * 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
@@ -44,11 +44,11 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
44
44
  * of the following:</p>
45
45
  * <ul>
46
46
  * <li>
47
- * <p>Filter identifying a subset of objects to which the rule applies. The filter can
47
+ * <p>A filter identifying a subset of objects to which the rule applies. The filter can
48
48
  * be based on a key name prefix, object tags, or a combination of both.</p>
49
49
  * </li>
50
50
  * <li>
51
- * <p>Status whether the rule is in effect.</p>
51
+ * <p>A status indicating whether the rule is in effect.</p>
52
52
  * </li>
53
53
  * <li>
54
54
  * <p>One or more lifecycle transition and expiration actions that you want Amazon S3 to
@@ -70,7 +70,7 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
70
70
  * resource owner can optionally grant access permissions to others by writing an access
71
71
  * policy. For this operation, a user must get the <code>s3:PutLifecycleConfiguration</code>
72
72
  * permission.</p>
73
- * <p>You can also explicitly deny permissions. Explicit deny also supersedes any other
73
+ * <p>You can also explicitly deny permissions. An explicit deny also supersedes any other
74
74
  * permissions. If you want to block users or accounts from removing or deleting objects from
75
75
  * your bucket, you must deny them permissions for the following actions:</p>
76
76
  * <ul>
@@ -41,7 +41,7 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
41
41
  * <dl>
42
42
  * <dt>Grantee Values</dt>
43
43
  * <dd>
44
- * <p>You can specify the person (grantee) to whom you're assigning access rights (using
44
+ * <p>You can specify the person (grantee) to whom you're assigning access rights (by using
45
45
  * request elements) in the following ways:</p>
46
46
  * <ul>
47
47
  * <li>
@@ -51,7 +51,8 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
51
51
  * xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
52
52
  * </Grantee></code>
53
53
  * </p>
54
- * <p>DisplayName is optional and ignored in the request.</p>
54
+ * <p>
55
+ * <code>DisplayName</code> is optional and ignored in the request.</p>
55
56
  * </li>
56
57
  * <li>
57
58
  * <p>By Email address:</p>
@@ -59,8 +60,8 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
59
60
  * <code> <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
60
61
  * xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress></Grantee></code>
61
62
  * </p>
62
- * <p>The grantee is resolved to the CanonicalUser and, in a response to a GET Object
63
- * acl request, appears as the CanonicalUser.</p>
63
+ * <p>The grantee is resolved to the <code>CanonicalUser</code> and, in a response to a <code>GETObjectAcl</code>
64
+ * request, appears as the CanonicalUser.</p>
64
65
  * </li>
65
66
  * <li>
66
67
  * <p>By URI:</p>
@@ -72,8 +73,8 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
72
73
  * </ul>
73
74
  * </dd>
74
75
  * </dl>
75
- * <p>To enable logging, you use LoggingEnabled and its children request elements. To disable
76
- * logging, you use an empty BucketLoggingStatus request element:</p>
76
+ * <p>To enable logging, you use <code>LoggingEnabled</code> and its children request elements. To disable
77
+ * logging, you use an empty <code>BucketLoggingStatus</code> request element:</p>
77
78
  * <p>
78
79
  * <code><BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01"
79
80
  * /></code>
@@ -54,7 +54,7 @@ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBe
54
54
  * </li>
55
55
  * </ul>
56
56
  * <p>
57
- * <code>GetBucketLifecycle</code> has the following special error:</p>
57
+ * <code>PutBucketMetricsConfiguration</code> has the following special error:</p>
58
58
  * <ul>
59
59
  * <li>
60
60
  * <p>Error code: <code>TooManyConfigurations</code>
@@ -53,7 +53,7 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
53
53
  * General Reference</i>.</p>
54
54
  * <p>By default, only the bucket owner can configure notifications on a bucket. However,
55
55
  * bucket owners can use a bucket policy to grant permission to other users to set this
56
- * configuration with <code>s3:PutBucketNotification</code> permission.</p>
56
+ * configuration with the required <code>s3:PutBucketNotification</code> permission.</p>
57
57
  * <note>
58
58
  * <p>The PUT notification is an atomic operation. For example, suppose your notification
59
59
  * configuration includes SNS topic, SQS queue, and Lambda function configurations. When