@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.
- package/dist-cjs/protocols/Aws_restXml.js +8 -0
- package/dist-es/protocols/Aws_restXml.js +8 -0
- package/dist-types/commands/CopyObjectCommand.d.ts +26 -23
- package/dist-types/commands/CreateBucketCommand.d.ts +45 -116
- package/dist-types/commands/DeleteBucketCorsCommand.d.ts +3 -1
- package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +11 -11
- package/dist-types/commands/DeleteObjectsCommand.d.ts +22 -22
- package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +2 -0
- package/dist-types/commands/GetBucketEncryptionCommand.d.ts +3 -3
- package/dist-types/commands/GetObjectCommand.d.ts +48 -47
- package/dist-types/commands/HeadObjectCommand.d.ts +19 -12
- package/dist-types/commands/ListMultipartUploadsCommand.d.ts +2 -0
- package/dist-types/commands/ListObjectVersionsCommand.d.ts +2 -0
- package/dist-types/commands/ListObjectsCommand.d.ts +1 -0
- package/dist-types/commands/ListObjectsV2Command.d.ts +1 -0
- package/dist-types/commands/PutBucketAclCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketEncryptionCommand.d.ts +11 -10
- package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +3 -3
- package/dist-types/commands/PutBucketLoggingCommand.d.ts +7 -6
- package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/PutObjectCommand.d.ts +51 -50
- package/dist-types/commands/RestoreObjectCommand.d.ts +5 -5
- package/dist-types/commands/SelectObjectContentCommand.d.ts +9 -4
- package/dist-types/commands/UploadPartCopyCommand.d.ts +13 -13
- package/dist-types/models/models_0.d.ts +107 -56
- package/dist-types/models/models_1.d.ts +9 -9
- package/dist-types/ts3.4/models/models_0.d.ts +8 -0
- 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
|
|
27
|
-
* uses server-side encryption with Amazon S3 managed
|
|
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
|
|
52
|
-
* (SSE-KMS)
|
|
53
|
-
*
|
|
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>
|
|
60
|
+
* <p>
|
|
61
|
+
* <code>x-amz-server-side-encryption-customer-algorithm</code>
|
|
62
|
+
* </p>
|
|
60
63
|
* </li>
|
|
61
64
|
* <li>
|
|
62
|
-
* <p>
|
|
65
|
+
* <p>
|
|
66
|
+
* <code>x-amz-server-side-encryption-customer-key</code>
|
|
67
|
+
* </p>
|
|
63
68
|
* </li>
|
|
64
69
|
* <li>
|
|
65
|
-
* <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
|
|
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
|
-
* <
|
|
82
|
-
*
|
|
83
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
170
|
-
*
|
|
171
|
-
*
|
|
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
|
-
*
|
|
174
|
-
*
|
|
175
|
-
*
|
|
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": "
|
|
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": "
|
|
294
|
-
* "
|
|
295
|
-
* "
|
|
296
|
-
* "
|
|
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
|
|
304
|
+
* // example id: to-retrieve-a-byte-range-of-an-object--1481832674603
|
|
303
305
|
* ```
|
|
304
306
|
*
|
|
305
|
-
* @example To retrieve
|
|
307
|
+
* @example To retrieve an object
|
|
306
308
|
* ```javascript
|
|
307
|
-
* // The following example retrieves an object for an S3 bucket.
|
|
309
|
+
* // The following example retrieves an object for an S3 bucket.
|
|
308
310
|
* const input = {
|
|
309
311
|
* "Bucket": "examplebucket",
|
|
310
|
-
* "Key": "
|
|
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": "
|
|
319
|
-
* "
|
|
320
|
-
* "
|
|
321
|
-
* "
|
|
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-
|
|
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
|
|
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>
|
|
40
|
+
* <p>
|
|
41
|
+
* <code>x-amz-server-side-encryption-customer-algorithm</code>
|
|
42
|
+
* </p>
|
|
41
43
|
* </li>
|
|
42
44
|
* <li>
|
|
43
|
-
* <p>
|
|
45
|
+
* <p>
|
|
46
|
+
* <code>x-amz-server-side-encryption-customer-key</code>
|
|
47
|
+
* </p>
|
|
44
48
|
* </li>
|
|
45
49
|
* <li>
|
|
46
|
-
* <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
|
|
56
|
-
* with KMS keys (SSE-KMS)
|
|
57
|
-
*
|
|
58
|
-
*
|
|
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
|
|
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
|
|
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
|
|
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
|
* ```
|
|
@@ -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
|
-
*
|
|
30
|
-
*
|
|
31
|
-
* encryption with
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
* <
|
|
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
|
|
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>
|
|
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>
|
|
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.
|
|
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>
|
|
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
|
|
63
|
-
*
|
|
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>
|
|
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
|