@aws-sdk/client-s3 3.697.0 → 3.698.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/index.js +152 -5
- package/dist-es/models/models_1.js +48 -0
- package/dist-es/protocols/Aws_restXml.js +75 -4
- package/dist-types/commands/AbortMultipartUploadCommand.d.ts +16 -13
- package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +47 -42
- package/dist-types/commands/CopyObjectCommand.d.ts +77 -57
- package/dist-types/commands/CreateBucketCommand.d.ts +60 -45
- package/dist-types/commands/CreateMultipartUploadCommand.d.ts +92 -66
- package/dist-types/commands/CreateSessionCommand.d.ts +30 -16
- package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/DeleteBucketCommand.d.ts +10 -3
- package/dist-types/commands/DeleteBucketCorsCommand.d.ts +1 -1
- package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +18 -10
- package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +52 -9
- package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +1 -1
- package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +25 -21
- package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +1 -1
- package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +1 -1
- package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +1 -1
- package/dist-types/commands/DeleteObjectCommand.d.ts +3 -0
- package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +1 -1
- package/dist-types/commands/DeleteObjectsCommand.d.ts +41 -27
- package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketAclCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketCorsCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketEncryptionCommand.d.ts +18 -10
- package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +61 -17
- package/dist-types/commands/GetBucketLocationCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketLoggingCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketPolicyCommand.d.ts +30 -21
- package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketReplicationCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketTaggingCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketVersioningCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketWebsiteCommand.d.ts +1 -1
- package/dist-types/commands/GetObjectAclCommand.d.ts +1 -1
- package/dist-types/commands/GetObjectAttributesCommand.d.ts +62 -44
- package/dist-types/commands/GetObjectCommand.d.ts +79 -60
- package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +1 -1
- package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/GetObjectRetentionCommand.d.ts +1 -1
- package/dist-types/commands/GetObjectTaggingCommand.d.ts +1 -1
- package/dist-types/commands/GetObjectTorrentCommand.d.ts +1 -1
- package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +1 -1
- package/dist-types/commands/HeadBucketCommand.d.ts +32 -16
- package/dist-types/commands/HeadObjectCommand.d.ts +60 -38
- package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +1 -1
- package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +1 -1
- package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +1 -1
- package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +1 -1
- package/dist-types/commands/ListBucketsCommand.d.ts +6 -6
- package/dist-types/commands/ListDirectoryBucketsCommand.d.ts +10 -4
- package/dist-types/commands/ListMultipartUploadsCommand.d.ts +50 -33
- package/dist-types/commands/ListObjectVersionsCommand.d.ts +1 -1
- package/dist-types/commands/ListObjectsCommand.d.ts +1 -1
- package/dist-types/commands/ListObjectsV2Command.d.ts +23 -14
- package/dist-types/commands/ListPartsCommand.d.ts +22 -17
- package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketAclCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketCorsCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketEncryptionCommand.d.ts +47 -32
- package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +84 -45
- package/dist-types/commands/PutBucketLoggingCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketPolicyCommand.d.ts +30 -21
- package/dist-types/commands/PutBucketReplicationCommand.d.ts +3 -4
- package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketTaggingCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketVersioningCommand.d.ts +3 -6
- package/dist-types/commands/PutBucketWebsiteCommand.d.ts +1 -1
- package/dist-types/commands/PutObjectAclCommand.d.ts +1 -1
- package/dist-types/commands/PutObjectCommand.d.ts +83 -35
- package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +1 -1
- package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +3 -3
- package/dist-types/commands/PutObjectRetentionCommand.d.ts +2 -2
- package/dist-types/commands/PutObjectTaggingCommand.d.ts +1 -1
- package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -1
- package/dist-types/commands/RestoreObjectCommand.d.ts +1 -1
- package/dist-types/commands/SelectObjectContentCommand.d.ts +1 -1
- package/dist-types/commands/UploadPartCommand.d.ts +52 -41
- package/dist-types/commands/UploadPartCopyCommand.d.ts +53 -39
- package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +1 -1
- package/dist-types/models/models_0.d.ts +938 -632
- package/dist-types/models/models_1.d.ts +230 -135
- package/dist-types/ts3.4/models/models_0.d.ts +7 -0
- package/dist-types/ts3.4/models/models_1.d.ts +24 -0
- package/package.json +1 -1
|
@@ -28,16 +28,13 @@ declare const PutBucketVersioningCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <note>
|
|
34
34
|
* <p>When you enable versioning on a bucket for the first time, it might take a short
|
|
35
35
|
* amount of time for the change to be fully propagated. We recommend that you wait for 15
|
|
36
|
-
* minutes after enabling versioning before issuing write operations
|
|
37
|
-
*
|
|
38
|
-
* or
|
|
39
|
-
* <code>DELETE</code>)
|
|
40
|
-
* on objects in the bucket. </p>
|
|
36
|
+
* minutes after enabling versioning before issuing write operations (<code>PUT</code> or
|
|
37
|
+
* <code>DELETE</code>) on objects in the bucket. </p>
|
|
41
38
|
* </note>
|
|
42
39
|
* <p>Sets the versioning state of an existing bucket.</p>
|
|
43
40
|
* <p>You can set the versioning state with one of the following values:</p>
|
|
@@ -28,7 +28,7 @@ declare const PutBucketWebsiteCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>Sets the configuration of the website that is specified in the <code>website</code>
|
|
34
34
|
* subresource. To configure a bucket as a website, you can add this subresource on the bucket
|
|
@@ -28,7 +28,7 @@ declare const PutObjectAclCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>Uses the <code>acl</code> subresource to set the access control list (ACL) permissions
|
|
34
34
|
* for a new or existing object in an S3 bucket. You must have the <code>WRITE_ACP</code>
|
|
@@ -32,46 +32,49 @@ declare const PutObjectCommand_base: {
|
|
|
32
32
|
* <note>
|
|
33
33
|
* <ul>
|
|
34
34
|
* <li>
|
|
35
|
-
* <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
*
|
|
35
|
+
* <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added
|
|
36
|
+
* the entire object to the bucket. You cannot use <code>PutObject</code> to only
|
|
37
|
+
* update a single piece of metadata for an existing object. You must put the entire
|
|
38
|
+
* object with updated metadata if you want to update some values.</p>
|
|
39
39
|
* </li>
|
|
40
40
|
* <li>
|
|
41
|
-
* <p>If your bucket uses the bucket owner enforced setting for Object Ownership,
|
|
42
|
-
*
|
|
41
|
+
* <p>If your bucket uses the bucket owner enforced setting for Object Ownership,
|
|
42
|
+
* ACLs are disabled and no longer affect permissions. All objects written to the
|
|
43
|
+
* bucket by any account will be owned by the bucket owner.</p>
|
|
43
44
|
* </li>
|
|
44
45
|
* <li>
|
|
45
46
|
* <p>
|
|
46
|
-
* <b>Directory buckets</b> -
|
|
47
|
+
* <b>Directory buckets</b> -
|
|
48
|
+
* For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
|
|
47
49
|
* </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
|
|
48
50
|
* <i>Amazon S3 User Guide</i>.</p>
|
|
49
51
|
* </li>
|
|
50
52
|
* </ul>
|
|
51
53
|
* </note>
|
|
52
54
|
* <p>Amazon S3 is a distributed system. If it receives multiple write requests for the same object
|
|
53
|
-
* simultaneously, it overwrites all but the last object written. However, Amazon S3 provides
|
|
55
|
+
* simultaneously, it overwrites all but the last object written. However, Amazon S3 provides
|
|
56
|
+
* features that can modify this behavior:</p>
|
|
54
57
|
* <ul>
|
|
55
58
|
* <li>
|
|
56
59
|
* <p>
|
|
57
60
|
* <b>S3 Object Lock</b> - To prevent objects from
|
|
58
|
-
*
|
|
59
|
-
*
|
|
61
|
+
* being deleted or overwritten, you can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html">Amazon S3 Object
|
|
62
|
+
* Lock</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
60
63
|
* <note>
|
|
61
64
|
* <p>This functionality is not supported for directory buckets.</p>
|
|
62
65
|
* </note>
|
|
63
66
|
* </li>
|
|
64
67
|
* <li>
|
|
65
68
|
* <p>
|
|
66
|
-
* <b>S3 Versioning</b> - When you enable
|
|
67
|
-
*
|
|
68
|
-
*
|
|
69
|
-
*
|
|
70
|
-
*
|
|
71
|
-
*
|
|
72
|
-
*
|
|
73
|
-
*
|
|
74
|
-
*
|
|
69
|
+
* <b>S3 Versioning</b> - When you enable versioning
|
|
70
|
+
* for a bucket, if Amazon S3 receives multiple write requests for the same object
|
|
71
|
+
* simultaneously, it stores all versions of the objects. For each write request that is
|
|
72
|
+
* made to the same object, Amazon S3 automatically generates a unique version ID of that
|
|
73
|
+
* object being stored in Amazon S3. You can retrieve, replace, or delete any version of the
|
|
74
|
+
* object. For more information about versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html">Adding
|
|
75
|
+
* Objects to Versioning-Enabled Buckets</a> in the <i>Amazon S3 User
|
|
76
|
+
* Guide</i>. For information about returning the versioning state of a
|
|
77
|
+
* bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>. </p>
|
|
75
78
|
* <note>
|
|
76
79
|
* <p>This functionality is not supported for directory buckets.</p>
|
|
77
80
|
* </note>
|
|
@@ -83,28 +86,34 @@ declare const PutObjectCommand_base: {
|
|
|
83
86
|
* <ul>
|
|
84
87
|
* <li>
|
|
85
88
|
* <p>
|
|
86
|
-
* <b>General purpose bucket permissions</b> - The
|
|
87
|
-
*
|
|
89
|
+
* <b>General purpose bucket permissions</b> - The
|
|
90
|
+
* following permissions are required in your policies when your
|
|
91
|
+
* <code>PutObject</code> request includes specific headers.</p>
|
|
88
92
|
* <ul>
|
|
89
93
|
* <li>
|
|
90
94
|
* <p>
|
|
91
95
|
* <b>
|
|
92
96
|
* <code>s3:PutObject</code>
|
|
93
|
-
* </b> -
|
|
94
|
-
*
|
|
97
|
+
* </b> -
|
|
98
|
+
* To successfully complete the <code>PutObject</code> request, you must
|
|
99
|
+
* always have the <code>s3:PutObject</code> permission on a bucket to
|
|
100
|
+
* add an object to it.</p>
|
|
95
101
|
* </li>
|
|
96
102
|
* <li>
|
|
97
103
|
* <p>
|
|
98
104
|
* <b>
|
|
99
105
|
* <code>s3:PutObjectAcl</code>
|
|
100
|
-
* </b> - To successfully change the objects ACL of your
|
|
106
|
+
* </b> - To successfully change the objects ACL of your
|
|
107
|
+
* <code>PutObject</code> request, you must have the
|
|
108
|
+
* <code>s3:PutObjectAcl</code>.</p>
|
|
101
109
|
* </li>
|
|
102
110
|
* <li>
|
|
103
111
|
* <p>
|
|
104
112
|
* <b>
|
|
105
113
|
* <code>s3:PutObjectTagging</code>
|
|
106
|
-
* </b> - To successfully set the tag-set with your
|
|
107
|
-
*
|
|
114
|
+
* </b> - To successfully set the tag-set with your
|
|
115
|
+
* <code>PutObject</code> request, you must have the
|
|
116
|
+
* <code>s3:PutObjectTagging</code>.</p>
|
|
108
117
|
* </li>
|
|
109
118
|
* </ul>
|
|
110
119
|
* </li>
|
|
@@ -116,9 +125,10 @@ declare const PutObjectCommand_base: {
|
|
|
116
125
|
* Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
|
|
117
126
|
* <code>CreateSession</code>
|
|
118
127
|
* </a>.</p>
|
|
119
|
-
* <p>If the object is encrypted with
|
|
120
|
-
*
|
|
121
|
-
*
|
|
128
|
+
* <p>If the object is encrypted with SSE-KMS, you must also have the
|
|
129
|
+
* <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions
|
|
130
|
+
* in IAM identity-based policies and KMS key policies for the KMS
|
|
131
|
+
* key.</p>
|
|
122
132
|
* </li>
|
|
123
133
|
* </ul>
|
|
124
134
|
* </dd>
|
|
@@ -127,15 +137,18 @@ declare const PutObjectCommand_base: {
|
|
|
127
137
|
* <ul>
|
|
128
138
|
* <li>
|
|
129
139
|
* <p>
|
|
130
|
-
* <b>General purpose bucket</b> - To ensure that
|
|
131
|
-
*
|
|
132
|
-
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
140
|
+
* <b>General purpose bucket</b> - To ensure that
|
|
141
|
+
* data is not corrupted traversing the network, use the
|
|
142
|
+
* <code>Content-MD5</code> header. When you use this header, Amazon S3 checks
|
|
143
|
+
* the object against the provided MD5 value and, if they do not match, Amazon S3
|
|
144
|
+
* returns an error. Alternatively, when the object's ETag is its MD5 digest,
|
|
145
|
+
* you can calculate the MD5 while putting the object to Amazon S3 and compare the
|
|
146
|
+
* returned ETag to the calculated MD5 value.</p>
|
|
135
147
|
* </li>
|
|
136
148
|
* <li>
|
|
137
149
|
* <p>
|
|
138
|
-
* <b>Directory bucket</b> -
|
|
150
|
+
* <b>Directory bucket</b> -
|
|
151
|
+
* This functionality is not supported for directory buckets.</p>
|
|
139
152
|
* </li>
|
|
140
153
|
* </ul>
|
|
141
154
|
* </dd>
|
|
@@ -188,6 +201,7 @@ declare const PutObjectCommand_base: {
|
|
|
188
201
|
* GrantReadACP: "STRING_VALUE",
|
|
189
202
|
* GrantWriteACP: "STRING_VALUE",
|
|
190
203
|
* Key: "STRING_VALUE", // required
|
|
204
|
+
* WriteOffsetBytes: Number("long"),
|
|
191
205
|
* Metadata: { // Metadata
|
|
192
206
|
* "<keys>": "STRING_VALUE",
|
|
193
207
|
* },
|
|
@@ -223,6 +237,7 @@ declare const PutObjectCommand_base: {
|
|
|
223
237
|
* // SSEKMSKeyId: "STRING_VALUE",
|
|
224
238
|
* // SSEKMSEncryptionContext: "STRING_VALUE",
|
|
225
239
|
* // BucketKeyEnabled: true || false,
|
|
240
|
+
* // Size: Number("long"),
|
|
226
241
|
* // RequestCharged: "requester",
|
|
227
242
|
* // };
|
|
228
243
|
*
|
|
@@ -234,6 +249,39 @@ declare const PutObjectCommand_base: {
|
|
|
234
249
|
* @see {@link PutObjectCommandOutput} for command's `response` shape.
|
|
235
250
|
* @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
|
|
236
251
|
*
|
|
252
|
+
* @throws {@link EncryptionTypeMismatch} (client fault)
|
|
253
|
+
* <p>
|
|
254
|
+
* The existing object was created with a different encryption type.
|
|
255
|
+
* Subsequent write requests must include the appropriate encryption
|
|
256
|
+
* parameters in the request or while creating the session.
|
|
257
|
+
* </p>
|
|
258
|
+
*
|
|
259
|
+
* @throws {@link InvalidRequest} (client fault)
|
|
260
|
+
* <p>You may receive this error in multiple cases. Depending on the reason for the error, you may receive one of the messages below:</p>
|
|
261
|
+
* <ul>
|
|
262
|
+
* <li>
|
|
263
|
+
* <p>Cannot specify both a write offset value and user-defined object metadata for existing objects.</p>
|
|
264
|
+
* </li>
|
|
265
|
+
* <li>
|
|
266
|
+
* <p>Checksum Type mismatch occurred, expected checksum Type: sha1, actual checksum Type: crc32c.</p>
|
|
267
|
+
* </li>
|
|
268
|
+
* <li>
|
|
269
|
+
* <p>Request body cannot be empty when 'write offset' is specified.</p>
|
|
270
|
+
* </li>
|
|
271
|
+
* </ul>
|
|
272
|
+
*
|
|
273
|
+
* @throws {@link InvalidWriteOffset} (client fault)
|
|
274
|
+
* <p>
|
|
275
|
+
* The write offset value that you specified does not match the current object size.
|
|
276
|
+
* </p>
|
|
277
|
+
*
|
|
278
|
+
* @throws {@link TooManyParts} (client fault)
|
|
279
|
+
* <p>
|
|
280
|
+
* You have attempted to add more parts than the maximum of 10000
|
|
281
|
+
* that are allowed for this object. You can use the CopyObject operation
|
|
282
|
+
* to copy this object to another and then add more data to the newly copied object.
|
|
283
|
+
* </p>
|
|
284
|
+
*
|
|
237
285
|
* @throws {@link S3ServiceException}
|
|
238
286
|
* <p>Base exception class for all service exceptions from S3 service.</p>
|
|
239
287
|
*
|
|
@@ -28,7 +28,7 @@ declare const PutObjectLegalHoldCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>Applies a legal hold configuration to the specified object. For more information, see
|
|
34
34
|
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
|
|
@@ -28,7 +28,7 @@ declare const PutObjectLockConfigurationCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>Places an Object Lock configuration on the specified bucket. The rule specified in the
|
|
34
34
|
* Object Lock configuration will be applied by default to every new object placed in the
|
|
@@ -45,8 +45,8 @@ declare const PutObjectLockConfigurationCommand_base: {
|
|
|
45
45
|
* <code>Days</code> and <code>Years</code> at the same time.</p>
|
|
46
46
|
* </li>
|
|
47
47
|
* <li>
|
|
48
|
-
* <p>You can enable Object Lock for new or existing buckets. For more
|
|
49
|
-
*
|
|
48
|
+
* <p>You can enable Object Lock for new or existing buckets. For more information,
|
|
49
|
+
* see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-configure.html">Configuring Object
|
|
50
50
|
* Lock</a>.</p>
|
|
51
51
|
* </li>
|
|
52
52
|
* </ul>
|
|
@@ -24,11 +24,11 @@ export interface PutObjectRetentionCommandOutput extends PutObjectRetentionOutpu
|
|
|
24
24
|
declare const PutObjectRetentionCommand_base: {
|
|
25
25
|
new (input: PutObjectRetentionCommandInput): import("@smithy/smithy-client").CommandImpl<PutObjectRetentionCommandInput, PutObjectRetentionCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
|
|
26
26
|
new (__0_0: PutObjectRetentionCommandInput): import("@smithy/smithy-client").CommandImpl<PutObjectRetentionCommandInput, PutObjectRetentionCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
|
|
27
|
-
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
27
|
+
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; /** @internal type navigation helper, not in runtime. */
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>Places an Object Retention configuration on an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>.
|
|
34
34
|
* Users or accounts require the <code>s3:PutObjectRetention</code> permission in order to
|
|
@@ -28,7 +28,7 @@ declare const PutObjectTaggingCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>Sets the supplied tag-set to an object that already exists in a bucket. A tag is a
|
|
34
34
|
* key-value pair. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object Tagging</a>.</p>
|
|
@@ -28,7 +28,7 @@ declare const PutPublicAccessBlockCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>Creates or modifies the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket.
|
|
34
34
|
* To use this operation, you must have the <code>s3:PutBucketPublicAccessBlock</code>
|
|
@@ -28,7 +28,7 @@ declare const RestoreObjectCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>Restores an archived copy of an object back into Amazon S3</p>
|
|
34
34
|
* <p>This functionality is not supported for Amazon S3 on Outposts.</p>
|
|
@@ -28,7 +28,7 @@ declare const SelectObjectContentCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <note>
|
|
31
|
-
* <p>This operation is not supported
|
|
31
|
+
* <p>This operation is not supported for directory buckets.</p>
|
|
32
32
|
* </note>
|
|
33
33
|
* <p>This action filters the contents of an Amazon S3 object based on a simple structured query
|
|
34
34
|
* language (SQL) statement. In the request, along with the SQL expression, you must also
|
|
@@ -30,10 +30,9 @@ declare const UploadPartCommand_base: {
|
|
|
30
30
|
/**
|
|
31
31
|
* <p>Uploads a part in a multipart upload.</p>
|
|
32
32
|
* <note>
|
|
33
|
-
* <p>In this operation, you provide new data as a part of an object in your request.
|
|
34
|
-
* to specify your existing Amazon S3 object as a data source for
|
|
35
|
-
* upload a part from an existing object, you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a> operation.
|
|
36
|
-
* </p>
|
|
33
|
+
* <p>In this operation, you provide new data as a part of an object in your request.
|
|
34
|
+
* However, you have an option to specify your existing Amazon S3 object as a data source for
|
|
35
|
+
* the part you are uploading. To upload a part from an existing object, you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a> operation. </p>
|
|
37
36
|
* </note>
|
|
38
37
|
* <p>You must initiate a multipart upload (see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>)
|
|
39
38
|
* before you can upload any part. In response to your initiate request, Amazon S3 returns an
|
|
@@ -45,17 +44,17 @@ declare const UploadPartCommand_base: {
|
|
|
45
44
|
* <p>For information about maximum and minimum part sizes and other multipart upload
|
|
46
45
|
* specifications, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html">Multipart upload limits</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
47
46
|
* <note>
|
|
48
|
-
* <p>After you initiate multipart upload and upload
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
* storage.</p>
|
|
47
|
+
* <p>After you initiate multipart upload and upload one or more parts, you must either
|
|
48
|
+
* complete or abort multipart upload in order to stop getting charged for storage of the
|
|
49
|
+
* uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up
|
|
50
|
+
* the parts storage and stops charging you for the parts storage.</p>
|
|
53
51
|
* </note>
|
|
54
52
|
* <p>For more information on multipart uploads, go to <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html">Multipart Upload Overview</a> in the
|
|
55
|
-
*
|
|
53
|
+
* <i>Amazon S3 User Guide </i>.</p>
|
|
56
54
|
* <note>
|
|
57
55
|
* <p>
|
|
58
|
-
* <b>Directory buckets</b> -
|
|
56
|
+
* <b>Directory buckets</b> -
|
|
57
|
+
* For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
|
|
59
58
|
* </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
|
|
60
59
|
* <i>Amazon S3 User Guide</i>.</p>
|
|
61
60
|
* </note>
|
|
@@ -89,20 +88,24 @@ declare const UploadPartCommand_base: {
|
|
|
89
88
|
* Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
|
|
90
89
|
* <code>CreateSession</code>
|
|
91
90
|
* </a>.</p>
|
|
92
|
-
* <p>If the object is encrypted with
|
|
93
|
-
*
|
|
94
|
-
*
|
|
91
|
+
* <p>If the object is encrypted with SSE-KMS, you must also have the
|
|
92
|
+
* <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions
|
|
93
|
+
* in IAM identity-based policies and KMS key policies for the KMS
|
|
94
|
+
* key.</p>
|
|
95
95
|
* </li>
|
|
96
96
|
* </ul>
|
|
97
97
|
* </dd>
|
|
98
98
|
* <dt>Data integrity</dt>
|
|
99
99
|
* <dd>
|
|
100
100
|
* <p>
|
|
101
|
-
* <b>General purpose bucket</b> - To ensure that data
|
|
102
|
-
*
|
|
103
|
-
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
101
|
+
* <b>General purpose bucket</b> - To ensure that data
|
|
102
|
+
* is not corrupted traversing the network, specify the <code>Content-MD5</code>
|
|
103
|
+
* header in the upload part request. Amazon S3 checks the part data against the provided
|
|
104
|
+
* MD5 value. If they do not match, Amazon S3 returns an error. If the upload request is
|
|
105
|
+
* signed with Signature Version 4, then Amazon Web Services S3 uses the
|
|
106
|
+
* <code>x-amz-content-sha256</code> header as a checksum instead of
|
|
107
|
+
* <code>Content-MD5</code>. For more information see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html">Authenticating Requests: Using the Authorization Header (Amazon Web Services Signature
|
|
108
|
+
* Version 4)</a>. </p>
|
|
106
109
|
* <note>
|
|
107
110
|
* <p>
|
|
108
111
|
* <b>Directory buckets</b> - MD5 is not supported by directory buckets. You can use checksum algorithms to check object integrity.</p>
|
|
@@ -113,23 +116,28 @@ declare const UploadPartCommand_base: {
|
|
|
113
116
|
* <ul>
|
|
114
117
|
* <li>
|
|
115
118
|
* <p>
|
|
116
|
-
* <b>General purpose bucket</b> - Server-side
|
|
117
|
-
*
|
|
118
|
-
*
|
|
119
|
-
*
|
|
120
|
-
*
|
|
121
|
-
*
|
|
122
|
-
*
|
|
123
|
-
*
|
|
124
|
-
* (SSE-
|
|
125
|
-
*
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
129
|
-
*
|
|
130
|
-
*
|
|
131
|
-
*
|
|
132
|
-
*
|
|
119
|
+
* <b>General purpose bucket</b> - Server-side
|
|
120
|
+
* encryption is for data encryption at rest. Amazon S3 encrypts your data as it
|
|
121
|
+
* writes it to disks in its data centers and decrypts it when you access it.
|
|
122
|
+
* You have mutually exclusive options to protect data using server-side
|
|
123
|
+
* encryption in Amazon S3, depending on how you choose to manage the encryption
|
|
124
|
+
* keys. Specifically, the encryption key options are Amazon S3 managed keys
|
|
125
|
+
* (SSE-S3), Amazon Web Services KMS keys (SSE-KMS), and Customer-Provided Keys (SSE-C).
|
|
126
|
+
* Amazon S3 encrypts data with server-side encryption using Amazon S3 managed keys
|
|
127
|
+
* (SSE-S3) by default. You can optionally tell Amazon S3 to encrypt data at rest
|
|
128
|
+
* using server-side encryption with other key options. The option you use
|
|
129
|
+
* depends on whether you want to use KMS keys (SSE-KMS) or provide your own
|
|
130
|
+
* encryption key (SSE-C).</p>
|
|
131
|
+
* <p>Server-side encryption is supported by the S3 Multipart Upload
|
|
132
|
+
* operations. Unless you are using a customer-provided encryption key (SSE-C),
|
|
133
|
+
* you don't need to specify the encryption parameters in each UploadPart
|
|
134
|
+
* request. Instead, you only need to specify the server-side encryption
|
|
135
|
+
* parameters in the initial Initiate Multipart request. For more information,
|
|
136
|
+
* see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>.</p>
|
|
137
|
+
* <p>If you request server-side encryption using a customer-provided
|
|
138
|
+
* encryption key (SSE-C) in your initiate multipart upload request, you must
|
|
139
|
+
* provide identical encryption information in each part upload using the
|
|
140
|
+
* following request headers.</p>
|
|
133
141
|
* <ul>
|
|
134
142
|
* <li>
|
|
135
143
|
* <p>x-amz-server-side-encryption-customer-algorithm</p>
|
|
@@ -141,13 +149,14 @@ declare const UploadPartCommand_base: {
|
|
|
141
149
|
* <p>x-amz-server-side-encryption-customer-key-MD5</p>
|
|
142
150
|
* </li>
|
|
143
151
|
* </ul>
|
|
144
|
-
* <p>
|
|
145
|
-
*
|
|
146
|
-
*
|
|
152
|
+
* <p> For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html">Using
|
|
153
|
+
* Server-Side Encryption</a> in the
|
|
154
|
+
* <i>Amazon S3 User Guide</i>.</p>
|
|
147
155
|
* </li>
|
|
148
156
|
* <li>
|
|
149
157
|
* <p>
|
|
150
|
-
* <b>Directory buckets </b> -
|
|
158
|
+
* <b>Directory buckets </b> -
|
|
159
|
+
* For directory buckets, there are only two supported options for server-side encryption: server-side encryption with Amazon S3 managed keys (SSE-S3) (<code>AES256</code>) and server-side encryption with KMS keys (SSE-KMS) (<code>aws:kms</code>).</p>
|
|
151
160
|
* </li>
|
|
152
161
|
* </ul>
|
|
153
162
|
* </dd>
|
|
@@ -159,7 +168,9 @@ declare const UploadPartCommand_base: {
|
|
|
159
168
|
* </p>
|
|
160
169
|
* <ul>
|
|
161
170
|
* <li>
|
|
162
|
-
* <p>Description: The specified multipart upload does not exist. The
|
|
171
|
+
* <p>Description: The specified multipart upload does not exist. The
|
|
172
|
+
* upload ID might be invalid, or the multipart upload might have been
|
|
173
|
+
* aborted or completed.</p>
|
|
163
174
|
* </li>
|
|
164
175
|
* <li>
|
|
165
176
|
* <p>HTTP Status Code: 404 Not Found </p>
|