You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
feat(client-s3): Add support for conditional deletes for the S3 DeleteObject and DeleteObjects APIs. Add support for write offset bytes option used to append to objects with the S3 PutObject API.
* to abort a given multipart upload multiple times in order to completely free all storage
37
37
* consumed by all parts. </p>
38
38
* <p>To verify that all parts have been removed and prevent getting charged for the part
39
-
* storage, you should call the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html">ListParts</a> API operation and ensure that
40
-
* the parts list is empty.</p>
39
+
* storage, you should call the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html">ListParts</a> API operation and ensure
40
+
* that the parts list is empty.</p>
41
41
* <note>
42
42
* <ul>
43
43
* <li>
44
44
* <p>
45
-
* <b>Directory buckets</b> -
46
-
* If multipart uploads in a directory bucket are in progress, you can't delete the bucket until all the in-progress multipart uploads are aborted or completed.
47
-
* To delete these in-progress multipart uploads, use the
48
-
* <code>ListMultipartUploads</code> operation to list the in-progress multipart
49
-
* uploads in the bucket and use the <code>AbortMultipartUpload</code> operation to
50
-
* abort all the in-progress multipart uploads.
51
-
* </p>
45
+
* <b>Directory buckets</b> - If multipart
46
+
* uploads in a directory bucket are in progress, you can't delete the bucket until
47
+
* all the in-progress multipart uploads are aborted or completed. To delete these
48
+
* in-progress multipart uploads, use the <code>ListMultipartUploads</code> operation
49
+
* to list the in-progress multipart uploads in the bucket and use the
50
+
* <code>AbortMultipartUpload</code> operation to abort all the in-progress
51
+
* multipart uploads. </p>
52
52
* </li>
53
53
* <li>
54
54
* <p>
55
-
* <b>Directory buckets</b> - 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>
55
+
* <b>Directory buckets</b> -
56
+
* 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>
56
57
* </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
* <b>General purpose bucket permissions</b> - For information about permissions required to use the multipart upload, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload
68
-
* and Permissions</a> in the <i>Amazon S3
69
-
* User Guide</i>.</p>
68
+
* <b>General purpose bucket permissions</b> - For
69
+
* information about permissions required to use the multipart upload, see
70
+
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and
71
+
* Permissions</a> in the <i>Amazon S3 User Guide</i>.</p>
* <p>Completes a multipart upload by assembling previously uploaded parts.</p>
39
39
* <p>You first initiate the multipart upload and then upload all parts using the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>
40
-
* operation or the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a>
41
-
* operation. After successfully uploading all relevant parts of an upload, you call this
42
-
* <code>CompleteMultipartUpload</code> operation to complete the upload. Upon receiving this request, Amazon S3 concatenates all the parts
43
-
* in ascending order by part number to create a new object. In the CompleteMultipartUpload
44
-
* request, you must provide the parts list and ensure that the parts list is complete.
45
-
* The CompleteMultipartUpload API operation concatenates the parts that you provide in the list. For each part in the list,
46
-
* you must provide the <code>PartNumber</code> value and the <code>ETag</code> value that are returned after that part
47
-
* was uploaded.</p>
40
+
* operation or the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a> operation.
41
+
* After successfully uploading all relevant parts of an upload, you call this
42
+
* <code>CompleteMultipartUpload</code> operation to complete the upload. Upon receiving
43
+
* this request, Amazon S3 concatenates all the parts in ascending order by part number to create a
44
+
* new object. In the CompleteMultipartUpload request, you must provide the parts list and
45
+
* ensure that the parts list is complete. The CompleteMultipartUpload API operation
46
+
* concatenates the parts that you provide in the list. For each part in the list, you must
47
+
* provide the <code>PartNumber</code> value and the <code>ETag</code> value that are returned
48
+
* after that part was uploaded.</p>
48
49
* <p>The processing of a CompleteMultipartUpload request could take several minutes to
49
50
* finalize. After Amazon S3 begins processing the request, it sends an HTTP response header that
50
-
* specifies a <code>200 OK</code> response. While processing is in progress, Amazon S3 periodically sends white
51
-
* space characters to keep the connection from timing out. A request could fail after the
52
-
* initial <code>200 OK</code> response has been sent. This means that a <code>200 OK</code> response can
53
-
* contain either a success or an error. The error response might be embedded in the <code>200 OK</code> response.
54
-
* If you call this API operation directly, make sure to design
55
-
* your application to parse the contents of the response and handle it appropriately. If you
56
-
* use Amazon Web Services SDKs, SDKs handle this condition. The SDKs detect the embedded error and apply
57
-
* error handling per your configuration settings (including automatically retrying the
58
-
* request as appropriate). If the condition persists, the SDKs throw an exception (or, for
59
-
* the SDKs that don't use exceptions, they return an error). </p>
51
+
* specifies a <code>200 OK</code> response. While processing is in progress, Amazon S3
52
+
* periodically sends white space characters to keep the connection from timing out. A request
53
+
* could fail after the initial <code>200 OK</code> response has been sent. This means that a
54
+
* <code>200 OK</code> response can contain either a success or an error. The error
55
+
* response might be embedded in the <code>200 OK</code> response. If you call this API
56
+
* operation directly, make sure to design your application to parse the contents of the
57
+
* response and handle it appropriately. If you use Amazon Web Services SDKs, SDKs handle this condition.
58
+
* The SDKs detect the embedded error and apply error handling per your configuration settings
59
+
* (including automatically retrying the request as appropriate). If the condition persists,
60
+
* the SDKs throw an exception (or, for the SDKs that don't use exceptions, they return an
61
+
* error). </p>
60
62
* <p>Note that if <code>CompleteMultipartUpload</code> fails, applications should be prepared
61
-
* to retry any failed requests (including 500 error responses). For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html">Amazon S3 Error Best
62
-
* Practices</a>.</p>
63
+
* to retry any failed requests (including 500 error responses). For more information, see
* <p>You can't use <code>Content-Type: application/x-www-form-urlencoded</code> for the
65
-
* CompleteMultipartUpload requests. Also, if you don't provide a
66
-
* <code>Content-Type</code> header, <code>CompleteMultipartUpload</code> can still return a <code>200
67
-
* OK</code> response.</p>
68
+
* CompleteMultipartUpload requests. Also, if you don't provide a <code>Content-Type</code>
69
+
* header, <code>CompleteMultipartUpload</code> can still return a <code>200 OK</code>
70
+
* response.</p>
68
71
* </important>
69
72
* <p>For more information about multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
70
-
* Upload</a> in the <i>Amazon S3
71
-
* User Guide</i>.</p>
73
+
* Upload</a> in the <i>Amazon S3 User Guide</i>.</p>
72
74
* <note>
73
75
* <p>
74
-
* <b>Directory buckets</b> - 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>
76
+
* <b>Directory buckets</b> -
77
+
* 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>
75
78
* </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
* 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">
100
103
* <code>CreateSession</code>
101
104
* </a>.</p>
102
-
* <p>If the object is encrypted with
103
-
* SSE-KMS, you must also have the
104
-
* <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions in IAM identity-based policies and KMS key policies for the KMS key.</p>
105
+
* <p>If the object is encrypted with SSE-KMS, you must also have the
106
+
* <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions
107
+
* in IAM identity-based policies and KMS key policies for the KMS
0 commit comments