@aws-sdk/client-s3 3.842.0 → 3.845.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/README.md +40 -0
- package/dist-cjs/index.js +594 -121
- package/dist-es/S3.js +10 -0
- package/dist-es/commands/CreateBucketMetadataConfigurationCommand.js +31 -0
- package/dist-es/commands/DeleteBucketMetadataConfigurationCommand.js +26 -0
- package/dist-es/commands/GetBucketMetadataConfigurationCommand.js +28 -0
- package/dist-es/commands/ListPartsCommand.js +1 -1
- package/dist-es/commands/UpdateBucketMetadataInventoryTableConfigurationCommand.js +31 -0
- package/dist-es/commands/UpdateBucketMetadataJournalTableConfigurationCommand.js +31 -0
- package/dist-es/commands/index.js +5 -0
- package/dist-es/models/models_0.js +16 -24
- package/dist-es/models/models_1.js +24 -0
- package/dist-es/protocols/Aws_restXml.js +325 -3
- package/dist-types/S3.d.ts +35 -0
- package/dist-types/S3Client.d.ts +7 -2
- package/dist-types/commands/AbortMultipartUploadCommand.d.ts +17 -22
- package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +46 -57
- package/dist-types/commands/CopyObjectCommand.d.ts +95 -106
- package/dist-types/commands/CreateBucketCommand.d.ts +70 -82
- package/dist-types/commands/CreateBucketMetadataConfigurationCommand.d.ts +182 -0
- package/dist-types/commands/CreateBucketMetadataTableConfigurationCommand.d.ts +25 -12
- package/dist-types/commands/CreateMultipartUploadCommand.d.ts +88 -113
- package/dist-types/commands/CreateSessionCommand.d.ts +45 -50
- package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +7 -9
- package/dist-types/commands/DeleteBucketCommand.d.ts +10 -12
- package/dist-types/commands/DeleteBucketCorsCommand.d.ts +4 -5
- package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +16 -18
- package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +4 -6
- package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +23 -28
- package/dist-types/commands/DeleteBucketMetadataConfigurationCommand.d.ts +114 -0
- package/dist-types/commands/DeleteBucketMetadataTableConfigurationCommand.d.ts +26 -8
- package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +9 -12
- package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +5 -6
- package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +20 -23
- package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +5 -7
- package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +2 -3
- package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +9 -10
- package/dist-types/commands/DeleteObjectCommand.d.ts +37 -23
- package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +7 -7
- package/dist-types/commands/DeleteObjectsCommand.d.ts +37 -44
- package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +6 -6
- package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +14 -17
- package/dist-types/commands/GetBucketAclCommand.d.ts +9 -11
- package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +8 -11
- package/dist-types/commands/GetBucketCorsCommand.d.ts +4 -6
- package/dist-types/commands/GetBucketEncryptionCommand.d.ts +16 -19
- package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +6 -8
- package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +28 -37
- package/dist-types/commands/GetBucketLocationCommand.d.ts +4 -5
- package/dist-types/commands/GetBucketLoggingCommand.d.ts +2 -2
- package/dist-types/commands/GetBucketMetadataConfigurationCommand.d.ts +146 -0
- package/dist-types/commands/GetBucketMetadataTableConfigurationCommand.d.ts +25 -8
- package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +10 -11
- package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +7 -8
- package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +9 -8
- package/dist-types/commands/GetBucketPolicyCommand.d.ts +24 -29
- package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +5 -6
- package/dist-types/commands/GetBucketReplicationCommand.d.ts +11 -12
- package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +2 -3
- package/dist-types/commands/GetBucketTaggingCommand.d.ts +2 -3
- package/dist-types/commands/GetBucketVersioningCommand.d.ts +3 -3
- package/dist-types/commands/GetBucketWebsiteCommand.d.ts +6 -7
- package/dist-types/commands/GetObjectAclCommand.d.ts +9 -11
- package/dist-types/commands/GetObjectAttributesCommand.d.ts +55 -70
- package/dist-types/commands/GetObjectCommand.d.ts +66 -81
- package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +1 -2
- package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +3 -3
- package/dist-types/commands/GetObjectRetentionCommand.d.ts +1 -2
- package/dist-types/commands/GetObjectTaggingCommand.d.ts +8 -10
- package/dist-types/commands/GetObjectTorrentCommand.d.ts +4 -5
- package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +10 -12
- package/dist-types/commands/HeadBucketCommand.d.ts +33 -35
- package/dist-types/commands/HeadObjectCommand.d.ts +50 -62
- package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +14 -17
- package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +12 -15
- package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +15 -18
- package/dist-types/commands/ListBucketsCommand.d.ts +10 -9
- package/dist-types/commands/ListDirectoryBucketsCommand.d.ts +9 -9
- package/dist-types/commands/ListMultipartUploadsCommand.d.ts +41 -49
- package/dist-types/commands/ListObjectVersionsCommand.d.ts +7 -9
- package/dist-types/commands/ListObjectsCommand.d.ts +8 -7
- package/dist-types/commands/ListObjectsV2Command.d.ts +28 -31
- package/dist-types/commands/ListPartsCommand.d.ts +21 -24
- package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +14 -18
- package/dist-types/commands/PutBucketAclCommand.d.ts +51 -62
- package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +23 -25
- package/dist-types/commands/PutBucketCorsCommand.d.ts +23 -27
- package/dist-types/commands/PutBucketEncryptionCommand.d.ts +40 -48
- package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +11 -12
- package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +33 -37
- package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +51 -60
- package/dist-types/commands/PutBucketLoggingCommand.d.ts +26 -33
- package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +12 -14
- package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +29 -35
- package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +4 -6
- package/dist-types/commands/PutBucketPolicyCommand.d.ts +24 -29
- package/dist-types/commands/PutBucketReplicationCommand.d.ts +31 -38
- package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +4 -5
- package/dist-types/commands/PutBucketTaggingCommand.d.ts +21 -27
- package/dist-types/commands/PutBucketVersioningCommand.d.ts +20 -23
- package/dist-types/commands/PutBucketWebsiteCommand.d.ts +19 -18
- package/dist-types/commands/PutObjectAclCommand.d.ts +53 -61
- package/dist-types/commands/PutObjectCommand.d.ts +56 -66
- package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +1 -3
- package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +10 -11
- package/dist-types/commands/PutObjectRetentionCommand.d.ts +4 -4
- package/dist-types/commands/PutObjectTaggingCommand.d.ts +18 -24
- package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +10 -12
- package/dist-types/commands/RenameObjectCommand.d.ts +34 -40
- package/dist-types/commands/RestoreObjectCommand.d.ts +76 -85
- package/dist-types/commands/SelectObjectContentCommand.d.ts +50 -59
- package/dist-types/commands/UpdateBucketMetadataInventoryTableConfigurationCommand.d.ts +161 -0
- package/dist-types/commands/UpdateBucketMetadataJournalTableConfigurationCommand.d.ts +113 -0
- package/dist-types/commands/UploadPartCommand.d.ts +64 -74
- package/dist-types/commands/UploadPartCopyCommand.d.ts +80 -96
- package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +29 -33
- package/dist-types/commands/index.d.ts +5 -0
- package/dist-types/models/models_0.d.ts +2688 -3603
- package/dist-types/models/models_1.d.ts +2120 -743
- package/dist-types/protocols/Aws_restXml.d.ts +45 -0
- package/dist-types/ts3.4/S3.d.ts +109 -0
- package/dist-types/ts3.4/S3Client.d.ts +30 -0
- package/dist-types/ts3.4/commands/CreateBucketMetadataConfigurationCommand.d.ts +47 -0
- package/dist-types/ts3.4/commands/DeleteBucketMetadataConfigurationCommand.d.ts +47 -0
- package/dist-types/ts3.4/commands/GetBucketMetadataConfigurationCommand.d.ts +51 -0
- package/dist-types/ts3.4/commands/ListObjectVersionsCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/ListObjectsCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/ListObjectsV2Command.d.ts +1 -1
- package/dist-types/ts3.4/commands/ListPartsCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/PutBucketAccelerateConfigurationCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/PutBucketAclCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/PutBucketAnalyticsConfigurationCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateBucketMetadataInventoryTableConfigurationCommand.d.ts +47 -0
- package/dist-types/ts3.4/commands/UpdateBucketMetadataJournalTableConfigurationCommand.d.ts +47 -0
- package/dist-types/ts3.4/commands/index.d.ts +5 -0
- package/dist-types/ts3.4/models/models_0.d.ts +93 -206
- package/dist-types/ts3.4/models/models_1.d.ts +238 -0
- package/dist-types/ts3.4/protocols/Aws_restXml.d.ts +60 -0
- package/package.json +19 -19
|
@@ -27,28 +27,26 @@ declare const UploadPartCopyCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Uploads a part by copying data from an existing object as data source. To specify the
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
30
|
+
* <p>Uploads a part by copying data from an existing object as data source. To specify the data source,
|
|
31
|
+
* you add the request header <code>x-amz-copy-source</code> in your request. To specify a byte range, you
|
|
32
|
+
* add the request header <code>x-amz-copy-source-range</code> in your request. </p>
|
|
33
|
+
* <p>For information about maximum and minimum part sizes and other multipart upload specifications, see
|
|
34
|
+
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html">Multipart upload
|
|
35
|
+
* limits</a> in the <i>Amazon S3 User Guide</i>. </p>
|
|
36
36
|
* <note>
|
|
37
|
-
* <p>Instead of copying data from an existing object as part data, you might use the
|
|
38
|
-
*
|
|
39
|
-
* request.</p>
|
|
37
|
+
* <p>Instead of copying data from an existing object as part data, you might use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a> action to
|
|
38
|
+
* upload new data as a part of an object in your request.</p>
|
|
40
39
|
* </note>
|
|
41
|
-
* <p>You must initiate a multipart upload before you can upload any part. In response to your
|
|
42
|
-
*
|
|
43
|
-
*
|
|
44
|
-
* <p>For conceptual information about multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
*
|
|
40
|
+
* <p>You must initiate a multipart upload before you can upload any part. In response to your initiate
|
|
41
|
+
* request, Amazon S3 returns the upload ID, a unique identifier that you must include in your upload part
|
|
42
|
+
* request.</p>
|
|
43
|
+
* <p>For conceptual information about multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart Upload</a> in
|
|
44
|
+
* the <i>Amazon S3 User Guide</i>. For information about copying objects using a single atomic
|
|
45
|
+
* action vs. a multipart upload, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html">Operations on Objects</a> in the
|
|
46
|
+
* <i>Amazon S3 User Guide</i>.</p>
|
|
48
47
|
* <note>
|
|
49
48
|
* <p>
|
|
50
|
-
* <b>Directory buckets</b> -
|
|
51
|
-
* 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>amzn-s3-demo-bucket</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
|
|
49
|
+
* <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>amzn-s3-demo-bucket</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
|
|
52
50
|
* </code>. Path-style requests are not supported. For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
|
|
53
51
|
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Concepts for directory buckets in Local Zones</a> in the
|
|
54
52
|
* <i>Amazon S3 User Guide</i>.</p>
|
|
@@ -56,100 +54,89 @@ declare const UploadPartCopyCommand_base: {
|
|
|
56
54
|
* <dl>
|
|
57
55
|
* <dt>Authentication and authorization</dt>
|
|
58
56
|
* <dd>
|
|
59
|
-
* <p>All <code>UploadPartCopy</code> requests must be authenticated and signed by
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>.</p>
|
|
57
|
+
* <p>All <code>UploadPartCopy</code> requests must be authenticated and signed by using IAM
|
|
58
|
+
* credentials (access key ID and secret access key for the IAM identities). All headers with the
|
|
59
|
+
* <code>x-amz-</code> prefix, including <code>x-amz-copy-source</code>, must be signed. For more
|
|
60
|
+
* information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>.</p>
|
|
64
61
|
* <p>
|
|
65
|
-
* <b>Directory buckets</b> - You must use IAM
|
|
66
|
-
*
|
|
67
|
-
*
|
|
68
|
-
*
|
|
69
|
-
* <p>Amazon Web Services CLI or SDKs handles authentication and authorization on your
|
|
70
|
-
* behalf.</p>
|
|
62
|
+
* <b>Directory buckets</b> - You must use IAM credentials to
|
|
63
|
+
* authenticate and authorize your access to the <code>UploadPartCopy</code> API operation, instead
|
|
64
|
+
* of using the temporary security credentials through the <code>CreateSession</code> API
|
|
65
|
+
* operation.</p>
|
|
66
|
+
* <p>Amazon Web Services CLI or SDKs handles authentication and authorization on your behalf.</p>
|
|
71
67
|
* </dd>
|
|
72
68
|
* <dt>Permissions</dt>
|
|
73
69
|
* <dd>
|
|
74
|
-
* <p>You must have <code>READ</code> access to the source object and
|
|
75
|
-
*
|
|
70
|
+
* <p>You must have <code>READ</code> access to the source object and <code>WRITE</code> access to
|
|
71
|
+
* the destination bucket.</p>
|
|
76
72
|
* <ul>
|
|
77
73
|
* <li>
|
|
78
74
|
* <p>
|
|
79
|
-
* <b>General purpose bucket permissions</b> - You
|
|
80
|
-
*
|
|
81
|
-
*
|
|
82
|
-
* operation.</p>
|
|
75
|
+
* <b>General purpose bucket permissions</b> - You must have the
|
|
76
|
+
* permissions in a policy based on the bucket types of your source bucket and destination bucket
|
|
77
|
+
* in an <code>UploadPartCopy</code> operation.</p>
|
|
83
78
|
* <ul>
|
|
84
79
|
* <li>
|
|
85
|
-
* <p>If the source object is in a general purpose bucket, you must have the
|
|
86
|
-
* <b>
|
|
80
|
+
* <p>If the source object is in a general purpose bucket, you must have the <b>
|
|
87
81
|
* <code>s3:GetObject</code>
|
|
88
|
-
* </b>
|
|
89
|
-
*
|
|
82
|
+
* </b> permission to read the source object that is
|
|
83
|
+
* being copied. </p>
|
|
90
84
|
* </li>
|
|
91
85
|
* <li>
|
|
92
|
-
* <p>If the destination bucket is a general purpose bucket, you must have the
|
|
93
|
-
* <b>
|
|
86
|
+
* <p>If the destination bucket is a general purpose bucket, you must have the <b>
|
|
94
87
|
* <code>s3:PutObject</code>
|
|
95
|
-
* </b>
|
|
96
|
-
*
|
|
88
|
+
* </b> permission to write the object copy to
|
|
89
|
+
* the destination bucket. </p>
|
|
97
90
|
* </li>
|
|
98
91
|
* <li>
|
|
99
|
-
* <p>To perform a multipart upload with encryption using an Key Management Service
|
|
100
|
-
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
103
|
-
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
*
|
|
107
|
-
*
|
|
108
|
-
*
|
|
109
|
-
*
|
|
110
|
-
*
|
|
111
|
-
*
|
|
112
|
-
* permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart upload
|
|
113
|
-
* and permissions</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions">Multipart upload API and permissions</a> in the
|
|
114
|
-
* <i>Amazon S3 User Guide</i>.</p>
|
|
92
|
+
* <p>To perform a multipart upload with encryption using an Key Management Service key, the requester
|
|
93
|
+
* must have permission to the <code>kms:Decrypt</code> and <code>kms:GenerateDataKey</code>
|
|
94
|
+
* actions on the key. The requester must also have permissions for the
|
|
95
|
+
* <code>kms:GenerateDataKey</code> action for the <code>CreateMultipartUpload</code> API.
|
|
96
|
+
* Then, the requester needs permissions for the <code>kms:Decrypt</code> action on the
|
|
97
|
+
* <code>UploadPart</code> and <code>UploadPartCopy</code> APIs. These permissions are
|
|
98
|
+
* required because Amazon S3 must decrypt and read data from the encrypted file parts before it
|
|
99
|
+
* completes the multipart upload. For more information about KMS permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html">Protecting
|
|
100
|
+
* data using server-side encryption with KMS</a> in the
|
|
101
|
+
* <i>Amazon S3 User Guide</i>. For information about the permissions required to
|
|
102
|
+
* use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart upload and
|
|
103
|
+
* permissions</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions">Multipart upload API
|
|
104
|
+
* and permissions</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
115
105
|
* </li>
|
|
116
106
|
* </ul>
|
|
117
107
|
* </li>
|
|
118
108
|
* <li>
|
|
119
109
|
* <p>
|
|
120
|
-
* <b>Directory bucket permissions</b> -
|
|
121
|
-
*
|
|
122
|
-
*
|
|
123
|
-
* operation.</p>
|
|
110
|
+
* <b>Directory bucket permissions</b> - You must have
|
|
111
|
+
* permissions in a bucket policy or an IAM identity-based policy based on the source and destination bucket types
|
|
112
|
+
* in an <code>UploadPartCopy</code> operation.</p>
|
|
124
113
|
* <ul>
|
|
125
114
|
* <li>
|
|
126
|
-
* <p>If the source object that you want to copy is in a
|
|
127
|
-
*
|
|
115
|
+
* <p>If the source object that you want to copy is in a directory bucket, you must have
|
|
116
|
+
* the <b>
|
|
128
117
|
* <code>s3express:CreateSession</code>
|
|
129
118
|
* </b> permission in
|
|
130
|
-
*
|
|
131
|
-
*
|
|
132
|
-
*
|
|
133
|
-
*
|
|
134
|
-
* <code>ReadOnly</code> on the copy source bucket.</p>
|
|
119
|
+
* the <code>Action</code> element of a policy to read the object. By default, the session is
|
|
120
|
+
* in the <code>ReadWrite</code> mode. If you want to restrict the access, you can explicitly
|
|
121
|
+
* set the <code>s3express:SessionMode</code> condition key to <code>ReadOnly</code> on the
|
|
122
|
+
* copy source bucket.</p>
|
|
135
123
|
* </li>
|
|
136
124
|
* <li>
|
|
137
|
-
* <p>If the copy destination is a directory bucket, you must have the
|
|
138
|
-
* <b>
|
|
125
|
+
* <p>If the copy destination is a directory bucket, you must have the <b>
|
|
139
126
|
* <code>s3express:CreateSession</code>
|
|
140
127
|
* </b> permission in the
|
|
141
|
-
*
|
|
142
|
-
*
|
|
143
|
-
*
|
|
144
|
-
* </p>
|
|
128
|
+
* <code>Action</code> element of a policy to write the object to the destination. The
|
|
129
|
+
* <code>s3express:SessionMode</code> condition key cannot be set to <code>ReadOnly</code>
|
|
130
|
+
* on the copy destination. </p>
|
|
145
131
|
* </li>
|
|
146
132
|
* </ul>
|
|
147
133
|
* <p>If the object is encrypted with SSE-KMS, you must also have the
|
|
148
|
-
*
|
|
149
|
-
*
|
|
150
|
-
*
|
|
151
|
-
*
|
|
152
|
-
*
|
|
134
|
+
* <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions in IAM
|
|
135
|
+
* identity-based policies and KMS key policies for the KMS key.</p>
|
|
136
|
+
* <p>For example policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html">Example
|
|
137
|
+
* bucket policies for S3 Express One Zone</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html">Amazon Web Services
|
|
138
|
+
* Identity and Access Management (IAM) identity-based policies for S3 Express One Zone</a> in the
|
|
139
|
+
* <i>Amazon S3 User Guide</i>.</p>
|
|
153
140
|
* </li>
|
|
154
141
|
* </ul>
|
|
155
142
|
* </dd>
|
|
@@ -159,22 +146,20 @@ declare const UploadPartCopyCommand_base: {
|
|
|
159
146
|
* <li>
|
|
160
147
|
* <p>
|
|
161
148
|
* <b>General purpose buckets </b> -
|
|
162
|
-
*
|
|
163
|
-
*
|
|
164
|
-
*
|
|
165
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>. </p>
|
|
149
|
+
* For information about using server-side encryption with
|
|
150
|
+
* customer-provided encryption keys with the <code>UploadPartCopy</code> operation, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html">CopyObject</a> and
|
|
151
|
+
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>. </p>
|
|
166
152
|
* </li>
|
|
167
153
|
* <li>
|
|
168
154
|
* <p>
|
|
169
155
|
* <b>Directory buckets </b> -
|
|
170
|
-
*
|
|
156
|
+
* 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>). For more
|
|
171
157
|
* information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html">Protecting data with server-side encryption</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
172
158
|
* <note>
|
|
173
|
-
* <p>For directory buckets, when you perform a
|
|
174
|
-
*
|
|
175
|
-
*
|
|
176
|
-
*
|
|
177
|
-
* encryption configuration of the destination bucket. </p>
|
|
159
|
+
* <p>For directory buckets, when you perform a <code>CreateMultipartUpload</code> operation
|
|
160
|
+
* and an <code>UploadPartCopy</code> operation, the request headers you provide in the
|
|
161
|
+
* <code>CreateMultipartUpload</code> request must match the default encryption configuration
|
|
162
|
+
* of the destination bucket. </p>
|
|
178
163
|
* </note>
|
|
179
164
|
* <p>S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted objects from general purpose buckets
|
|
180
165
|
* to directory buckets, from directory buckets to general purpose buckets, or between directory buckets, through <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a>. In this case, Amazon S3 makes a call to KMS every time a copy request is made for a KMS-encrypted object.</p>
|
|
@@ -189,9 +174,8 @@ declare const UploadPartCopyCommand_base: {
|
|
|
189
174
|
* </p>
|
|
190
175
|
* <ul>
|
|
191
176
|
* <li>
|
|
192
|
-
* <p>Description: The specified multipart upload does not exist. The
|
|
193
|
-
*
|
|
194
|
-
* aborted or completed.</p>
|
|
177
|
+
* <p>Description: The specified multipart upload does not exist. The upload ID might be
|
|
178
|
+
* invalid, or the multipart upload might have been aborted or completed.</p>
|
|
195
179
|
* </li>
|
|
196
180
|
* <li>
|
|
197
181
|
* <p>HTTP Status Code: 404 Not Found</p>
|
|
@@ -203,8 +187,8 @@ declare const UploadPartCopyCommand_base: {
|
|
|
203
187
|
* </p>
|
|
204
188
|
* <ul>
|
|
205
189
|
* <li>
|
|
206
|
-
* <p>Description: The specified copy source is not supported as a
|
|
207
|
-
*
|
|
190
|
+
* <p>Description: The specified copy source is not supported as a byte-range copy
|
|
191
|
+
* source.</p>
|
|
208
192
|
* </li>
|
|
209
193
|
* <li>
|
|
210
194
|
* <p>HTTP Status Code: 400 Bad Request</p>
|
|
@@ -31,40 +31,36 @@ declare const WriteGetObjectResponseCommand_base: {
|
|
|
31
31
|
* <note>
|
|
32
32
|
* <p>This operation is not supported for directory buckets.</p>
|
|
33
33
|
* </note>
|
|
34
|
-
* <p>Passes transformed objects to a <code>GetObject</code> operation when using Object Lambda access points. For
|
|
35
|
-
*
|
|
36
|
-
* Object Lambda access points</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
34
|
+
* <p>Passes transformed objects to a <code>GetObject</code> operation when using Object Lambda access points. For information
|
|
35
|
+
* about Object Lambda access points, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html">Transforming objects with Object Lambda access points</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
37
36
|
* <p>This operation supports metadata that can be returned by <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html">GetObject</a>, in addition to
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
*
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
*
|
|
48
|
-
*
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
55
|
-
*
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
-
*
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
* <p>
|
|
64
|
-
*
|
|
65
|
-
* bzip2, gzip, snappy, zlib, zstandard and ZIP. </p>
|
|
66
|
-
* <p>For information on how to view and use these functions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/olap-examples.html">Using Amazon Web Services built Lambda
|
|
67
|
-
* functions</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
37
|
+
* <code>RequestRoute</code>, <code>RequestToken</code>, <code>StatusCode</code>, <code>ErrorCode</code>,
|
|
38
|
+
* and <code>ErrorMessage</code>. The <code>GetObject</code> response metadata is supported so that the
|
|
39
|
+
* <code>WriteGetObjectResponse</code> caller, typically an Lambda function, can provide the same
|
|
40
|
+
* metadata when it internally invokes <code>GetObject</code>. When <code>WriteGetObjectResponse</code> is
|
|
41
|
+
* called by a customer-owned Lambda function, the metadata returned to the end user <code>GetObject</code>
|
|
42
|
+
* call might differ from what Amazon S3 would normally return.</p>
|
|
43
|
+
* <p>You can include any number of metadata headers. When including a metadata header, it should be
|
|
44
|
+
* prefaced with <code>x-amz-meta</code>. For example, <code>x-amz-meta-my-custom-header:
|
|
45
|
+
* MyCustomValue</code>. The primary use case for this is to forward <code>GetObject</code>
|
|
46
|
+
* metadata.</p>
|
|
47
|
+
* <p>Amazon Web Services provides some prebuilt Lambda functions that you can use with S3 Object Lambda to detect and
|
|
48
|
+
* redact personally identifiable information (PII) and decompress S3 objects. These Lambda functions are
|
|
49
|
+
* available in the Amazon Web Services Serverless Application Repository, and can be selected through the Amazon Web Services
|
|
50
|
+
* Management Console when you create your Object Lambda access point.</p>
|
|
51
|
+
* <p>Example 1: PII Access Control - This Lambda function uses Amazon Comprehend, a natural
|
|
52
|
+
* language processing (NLP) service using machine learning to find insights and relationships in text. It
|
|
53
|
+
* automatically detects personally identifiable information (PII) such as names, addresses, dates, credit
|
|
54
|
+
* card numbers, and social security numbers from documents in your Amazon S3 bucket. </p>
|
|
55
|
+
* <p>Example 2: PII Redaction - This Lambda function uses Amazon Comprehend, a natural language
|
|
56
|
+
* processing (NLP) service using machine learning to find insights and relationships in text. It
|
|
57
|
+
* automatically redacts personally identifiable information (PII) such as names, addresses, dates, credit
|
|
58
|
+
* card numbers, and social security numbers from documents in your Amazon S3 bucket. </p>
|
|
59
|
+
* <p>Example 3: Decompression - The Lambda function S3ObjectLambdaDecompression, is equipped to
|
|
60
|
+
* decompress objects stored in S3 in one of six compressed file formats including bzip2, gzip, snappy,
|
|
61
|
+
* zlib, zstandard and ZIP. </p>
|
|
62
|
+
* <p>For information on how to view and use these functions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/olap-examples.html">Using Amazon Web Services built Lambda functions</a> in the
|
|
63
|
+
* <i>Amazon S3 User Guide</i>.</p>
|
|
68
64
|
* @example
|
|
69
65
|
* Use a bare-bones client and the command you need to make an API call.
|
|
70
66
|
* ```javascript
|
|
@@ -2,6 +2,7 @@ export * from "./AbortMultipartUploadCommand";
|
|
|
2
2
|
export * from "./CompleteMultipartUploadCommand";
|
|
3
3
|
export * from "./CopyObjectCommand";
|
|
4
4
|
export * from "./CreateBucketCommand";
|
|
5
|
+
export * from "./CreateBucketMetadataConfigurationCommand";
|
|
5
6
|
export * from "./CreateBucketMetadataTableConfigurationCommand";
|
|
6
7
|
export * from "./CreateMultipartUploadCommand";
|
|
7
8
|
export * from "./CreateSessionCommand";
|
|
@@ -12,6 +13,7 @@ export * from "./DeleteBucketEncryptionCommand";
|
|
|
12
13
|
export * from "./DeleteBucketIntelligentTieringConfigurationCommand";
|
|
13
14
|
export * from "./DeleteBucketInventoryConfigurationCommand";
|
|
14
15
|
export * from "./DeleteBucketLifecycleCommand";
|
|
16
|
+
export * from "./DeleteBucketMetadataConfigurationCommand";
|
|
15
17
|
export * from "./DeleteBucketMetadataTableConfigurationCommand";
|
|
16
18
|
export * from "./DeleteBucketMetricsConfigurationCommand";
|
|
17
19
|
export * from "./DeleteBucketOwnershipControlsCommand";
|
|
@@ -33,6 +35,7 @@ export * from "./GetBucketInventoryConfigurationCommand";
|
|
|
33
35
|
export * from "./GetBucketLifecycleConfigurationCommand";
|
|
34
36
|
export * from "./GetBucketLocationCommand";
|
|
35
37
|
export * from "./GetBucketLoggingCommand";
|
|
38
|
+
export * from "./GetBucketMetadataConfigurationCommand";
|
|
36
39
|
export * from "./GetBucketMetadataTableConfigurationCommand";
|
|
37
40
|
export * from "./GetBucketMetricsConfigurationCommand";
|
|
38
41
|
export * from "./GetBucketNotificationConfigurationCommand";
|
|
@@ -94,6 +97,8 @@ export * from "./PutPublicAccessBlockCommand";
|
|
|
94
97
|
export * from "./RenameObjectCommand";
|
|
95
98
|
export * from "./RestoreObjectCommand";
|
|
96
99
|
export * from "./SelectObjectContentCommand";
|
|
100
|
+
export * from "./UpdateBucketMetadataInventoryTableConfigurationCommand";
|
|
101
|
+
export * from "./UpdateBucketMetadataJournalTableConfigurationCommand";
|
|
97
102
|
export * from "./UploadPartCommand";
|
|
98
103
|
export * from "./UploadPartCopyCommand";
|
|
99
104
|
export * from "./WriteGetObjectResponseCommand";
|