@aws-sdk/client-s3 3.315.0 → 3.316.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/S3.js +97 -1302
- package/dist-cjs/models/models_0.js +2 -0
- package/dist-es/S3.js +97 -1302
- package/dist-es/models/models_0.js +2 -0
- package/dist-types/S3.d.ts +100 -5179
- package/dist-types/commands/AbortMultipartUploadCommand.d.ts +2 -2
- package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +14 -22
- package/dist-types/commands/CopyObjectCommand.d.ts +31 -54
- package/dist-types/commands/CreateBucketCommand.d.ts +14 -22
- package/dist-types/commands/CreateMultipartUploadCommand.d.ts +49 -75
- package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +2 -2
- package/dist-types/commands/DeleteBucketCorsCommand.d.ts +2 -2
- package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +5 -7
- package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +2 -1
- package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +2 -2
- package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +2 -1
- package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +5 -5
- package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +2 -2
- package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +3 -4
- package/dist-types/commands/DeleteObjectCommand.d.ts +11 -11
- package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +4 -2
- package/dist-types/commands/DeleteObjectsCommand.d.ts +14 -13
- package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +2 -2
- package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +4 -5
- package/dist-types/commands/GetBucketAclCommand.d.ts +7 -9
- package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +4 -5
- package/dist-types/commands/GetBucketCorsCommand.d.ts +0 -1
- package/dist-types/commands/GetBucketEncryptionCommand.d.ts +7 -7
- package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +2 -1
- package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +2 -2
- package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +4 -4
- package/dist-types/commands/GetBucketLocationCommand.d.ts +0 -4
- package/dist-types/commands/GetBucketLoggingCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +6 -5
- package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +2 -3
- package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +3 -4
- package/dist-types/commands/GetBucketPolicyCommand.d.ts +0 -1
- package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +1 -2
- package/dist-types/commands/GetBucketWebsiteCommand.d.ts +2 -1
- package/dist-types/commands/GetObjectAclCommand.d.ts +4 -5
- package/dist-types/commands/GetObjectAttributesCommand.d.ts +28 -23
- package/dist-types/commands/GetObjectCommand.d.ts +18 -20
- package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +2 -1
- package/dist-types/commands/GetObjectRetentionCommand.d.ts +1 -2
- package/dist-types/commands/GetObjectTaggingCommand.d.ts +5 -5
- 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 +9 -15
- package/dist-types/commands/HeadObjectCommand.d.ts +19 -20
- package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +4 -4
- package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +2 -1
- package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +5 -5
- package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +7 -6
- package/dist-types/commands/ListBucketsCommand.d.ts +1 -3
- package/dist-types/commands/ListMultipartUploadsCommand.d.ts +2 -2
- package/dist-types/commands/ListObjectVersionsCommand.d.ts +6 -3
- package/dist-types/commands/ListObjectsV2Command.d.ts +12 -11
- package/dist-types/commands/ListPartsCommand.d.ts +4 -3
- package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +3 -4
- package/dist-types/commands/PutBucketAclCommand.d.ts +12 -15
- package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +4 -4
- package/dist-types/commands/PutBucketCorsCommand.d.ts +2 -2
- package/dist-types/commands/PutBucketEncryptionCommand.d.ts +14 -16
- package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +8 -7
- package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +8 -20
- package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +8 -8
- package/dist-types/commands/PutBucketLoggingCommand.d.ts +7 -11
- package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +4 -4
- package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +9 -9
- package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +2 -4
- package/dist-types/commands/PutBucketPolicyCommand.d.ts +1 -2
- package/dist-types/commands/PutBucketReplicationCommand.d.ts +12 -13
- package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +1 -1
- package/dist-types/commands/PutBucketTaggingCommand.d.ts +12 -12
- package/dist-types/commands/PutBucketVersioningCommand.d.ts +4 -4
- package/dist-types/commands/PutObjectAclCommand.d.ts +13 -17
- package/dist-types/commands/PutObjectCommand.d.ts +54 -45
- package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +8 -7
- package/dist-types/commands/PutObjectRetentionCommand.d.ts +4 -3
- package/dist-types/commands/PutObjectTaggingCommand.d.ts +3 -4
- package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -1
- package/dist-types/commands/RestoreObjectCommand.d.ts +69 -50
- package/dist-types/commands/SelectObjectContentCommand.d.ts +17 -13
- package/dist-types/commands/UploadPartCommand.d.ts +16 -23
- package/dist-types/commands/UploadPartCopyCommand.d.ts +5 -7
- package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +22 -33
- package/dist-types/models/models_0.d.ts +363 -426
- package/dist-types/models/models_1.d.ts +76 -81
- package/dist-types/ts3.4/S3.d.ts +2 -1
- package/dist-types/ts3.4/models/models_0.d.ts +2 -0
- package/package.json +6 -6
|
@@ -23,12 +23,15 @@ export interface GetObjectAttributesCommandOutput extends GetObjectAttributesOut
|
|
|
23
23
|
* action is useful if you're interested only in an object's metadata. To use
|
|
24
24
|
* <code>GetObjectAttributes</code>, you must have READ access to the object.</p>
|
|
25
25
|
* <p>
|
|
26
|
-
* <code>GetObjectAttributes</code> combines the functionality of
|
|
27
|
-
*
|
|
28
|
-
*
|
|
26
|
+
* <code>GetObjectAttributes</code> combines the functionality of
|
|
27
|
+
* <code>GetObjectAcl</code>, <code>GetObjectLegalHold</code>,
|
|
28
|
+
* <code>GetObjectLockConfiguration</code>, <code>GetObjectRetention</code>,
|
|
29
|
+
* <code>GetObjectTagging</code>, <code>HeadObject</code>, and <code>ListParts</code>. All
|
|
30
|
+
* of the data returned with each of those individual calls can be returned with a single call
|
|
31
|
+
* to <code>GetObjectAttributes</code>.</p>
|
|
29
32
|
* <p>If you encrypt an object by using server-side encryption with customer-provided
|
|
30
|
-
*
|
|
31
|
-
*
|
|
33
|
+
* encryption keys (SSE-C) when you store the object in Amazon S3, then when you retrieve the
|
|
34
|
+
* metadata from the object, you must use the following headers:</p>
|
|
32
35
|
* <ul>
|
|
33
36
|
* <li>
|
|
34
37
|
* <p>
|
|
@@ -52,24 +55,25 @@ export interface GetObjectAttributesCommandOutput extends GetObjectAttributesOut
|
|
|
52
55
|
* <note>
|
|
53
56
|
* <ul>
|
|
54
57
|
* <li>
|
|
55
|
-
* <p>Encryption request headers, such as
|
|
56
|
-
*
|
|
57
|
-
* with Amazon Web Services KMS keys stored in Amazon Web Services Key
|
|
58
|
-
* server-side encryption with Amazon S3 managed
|
|
59
|
-
* these types of keys, you'll get
|
|
58
|
+
* <p>Encryption request headers, such as
|
|
59
|
+
* <code>x-amz-server-side-encryption</code>, should not be sent for GET requests
|
|
60
|
+
* if your object uses server-side encryption with Amazon Web Services KMS keys stored in Amazon Web Services Key
|
|
61
|
+
* Management Service (SSE-KMS) or server-side encryption with Amazon S3 managed
|
|
62
|
+
* encryption keys (SSE-S3). If your object does use these types of keys, you'll get
|
|
63
|
+
* an HTTP <code>400 Bad Request</code> error.</p>
|
|
60
64
|
* </li>
|
|
61
65
|
* <li>
|
|
62
|
-
* <p>
|
|
63
|
-
*
|
|
66
|
+
* <p>
|
|
67
|
+
* The last modified property in this case is the creation date of the object.</p>
|
|
64
68
|
* </li>
|
|
65
69
|
* </ul>
|
|
66
70
|
* </note>
|
|
67
71
|
* <p>Consider the following when using request headers:</p>
|
|
68
72
|
* <ul>
|
|
69
73
|
* <li>
|
|
70
|
-
* <p> If both of the <code>If-Match</code> and <code>If-Unmodified-Since</code>
|
|
71
|
-
* are present in the request as follows, then Amazon S3 returns the HTTP
|
|
72
|
-
* <code>200 OK</code> and the data requested:</p>
|
|
74
|
+
* <p> If both of the <code>If-Match</code> and <code>If-Unmodified-Since</code>
|
|
75
|
+
* headers are present in the request as follows, then Amazon S3 returns the HTTP
|
|
76
|
+
* status code <code>200 OK</code> and the data requested:</p>
|
|
73
77
|
* <ul>
|
|
74
78
|
* <li>
|
|
75
79
|
* <p>
|
|
@@ -78,23 +82,24 @@ export interface GetObjectAttributesCommandOutput extends GetObjectAttributesOut
|
|
|
78
82
|
* <li>
|
|
79
83
|
* <p>
|
|
80
84
|
* <code>If-Unmodified-Since</code> condition evaluates to
|
|
81
|
-
*
|
|
85
|
+
* <code>false</code>.</p>
|
|
82
86
|
* </li>
|
|
83
87
|
* </ul>
|
|
84
88
|
* </li>
|
|
85
89
|
* <li>
|
|
86
90
|
* <p>If both of the <code>If-None-Match</code> and <code>If-Modified-Since</code>
|
|
87
91
|
* headers are present in the request as follows, then Amazon S3 returns the HTTP status code
|
|
88
|
-
*
|
|
92
|
+
* <code>304 Not Modified</code>:</p>
|
|
89
93
|
* <ul>
|
|
90
94
|
* <li>
|
|
91
95
|
* <p>
|
|
92
|
-
* <code>If-None-Match</code> condition evaluates to
|
|
96
|
+
* <code>If-None-Match</code> condition evaluates to
|
|
97
|
+
* <code>false</code>.</p>
|
|
93
98
|
* </li>
|
|
94
99
|
* <li>
|
|
95
100
|
* <p>
|
|
96
101
|
* <code>If-Modified-Since</code> condition evaluates to
|
|
97
|
-
*
|
|
102
|
+
* <code>true</code>.</p>
|
|
98
103
|
* </li>
|
|
99
104
|
* </ul>
|
|
100
105
|
* </li>
|
|
@@ -113,12 +118,12 @@ export interface GetObjectAttributesCommandOutput extends GetObjectAttributesOut
|
|
|
113
118
|
* have the <code>s3:ListBucket</code> permission.</p>
|
|
114
119
|
* <ul>
|
|
115
120
|
* <li>
|
|
116
|
-
* <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3
|
|
117
|
-
* an HTTP status code <code>404 Not Found</code> ("no such key") error.</p>
|
|
121
|
+
* <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3
|
|
122
|
+
* returns an HTTP status code <code>404 Not Found</code> ("no such key") error.</p>
|
|
118
123
|
* </li>
|
|
119
124
|
* <li>
|
|
120
|
-
* <p>If you don't have the <code>s3:ListBucket</code> permission, Amazon S3 returns an
|
|
121
|
-
* status code <code>403 Forbidden</code> ("access denied") error.</p>
|
|
125
|
+
* <p>If you don't have the <code>s3:ListBucket</code> permission, Amazon S3 returns an
|
|
126
|
+
* HTTP status code <code>403 Forbidden</code> ("access denied") error.</p>
|
|
122
127
|
* </li>
|
|
123
128
|
* </ul>
|
|
124
129
|
* <p>The following actions are related to <code>GetObjectAttributes</code>:</p>
|
|
@@ -33,19 +33,18 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
|
|
|
33
33
|
* have the object <code>photos/2006/February/sample.jpg</code> in the bucket named
|
|
34
34
|
* <code>examplebucket</code>, specify the resource as
|
|
35
35
|
* <code>/examplebucket/photos/2006/February/sample.jpg</code>. For more information about
|
|
36
|
-
* request types, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket">HTTP Host
|
|
37
|
-
* Header Bucket Specification</a>.</p>
|
|
36
|
+
* request types, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket">HTTP Host Header Bucket Specification</a>.</p>
|
|
38
37
|
* <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>
|
|
39
38
|
* <p>If the object you are retrieving is stored in the S3 Glacier or
|
|
40
39
|
* S3 Glacier Deep Archive storage class, or S3 Intelligent-Tiering Archive or
|
|
41
40
|
* S3 Intelligent-Tiering Deep Archive tiers, before you can retrieve the object you must first restore a
|
|
42
41
|
* copy using <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html">RestoreObject</a>. Otherwise, this action returns an
|
|
43
|
-
* <code>
|
|
44
|
-
* see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html">Restoring
|
|
45
|
-
*
|
|
42
|
+
* <code>InvalidObjectStateError</code> error. For information about restoring archived
|
|
43
|
+
* objects, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html">Restoring Archived
|
|
44
|
+
* Objects</a>.</p>
|
|
46
45
|
* <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>, should not
|
|
47
|
-
* be sent for GET requests if your object uses server-side encryption with KMS keys
|
|
48
|
-
*
|
|
46
|
+
* be sent for GET requests if your object uses server-side encryption with KMS keys (SSE-KMS)
|
|
47
|
+
* or server-side encryption with Amazon S3–managed encryption keys (SSE-S3). If your
|
|
49
48
|
* object does use these types of keys, you’ll get an HTTP 400 BadRequest error.</p>
|
|
50
49
|
* <p>If you encrypt an object by using server-side encryption with customer-provided
|
|
51
50
|
* encryption keys (SSE-C) when you store the object in Amazon S3, then when you GET the object,
|
|
@@ -61,19 +60,19 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
|
|
|
61
60
|
* <p>x-amz-server-side-encryption-customer-key-MD5</p>
|
|
62
61
|
* </li>
|
|
63
62
|
* </ul>
|
|
64
|
-
* <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption
|
|
65
|
-
*
|
|
66
|
-
* <p>Assuming you have the relevant permission to read object tags, the response also returns
|
|
67
|
-
*
|
|
63
|
+
* <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption (Using
|
|
64
|
+
* Customer-Provided Encryption Keys)</a>.</p>
|
|
65
|
+
* <p>Assuming you have the relevant permission to read object tags, the response also returns the
|
|
66
|
+
* <code>x-amz-tagging-count</code> header that provides the count of number of tags
|
|
68
67
|
* associated with the object. You can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html">GetObjectTagging</a> to retrieve
|
|
69
68
|
* the tag set associated with an object.</p>
|
|
70
69
|
* <p>
|
|
71
70
|
* <b>Permissions</b>
|
|
72
71
|
* </p>
|
|
73
72
|
* <p>You need the relevant read object (or version) permission for this operation. For more
|
|
74
|
-
* information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions
|
|
75
|
-
* Policy</a>. If the object you request does not exist, the error Amazon S3 returns
|
|
76
|
-
* on whether you also have the <code>s3:ListBucket</code> permission.</p>
|
|
73
|
+
* information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions
|
|
74
|
+
* in a Policy</a>. If the object you request does not exist, the error Amazon S3 returns
|
|
75
|
+
* depends on whether you also have the <code>s3:ListBucket</code> permission.</p>
|
|
77
76
|
* <ul>
|
|
78
77
|
* <li>
|
|
79
78
|
* <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3 will
|
|
@@ -92,12 +91,11 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
|
|
|
92
91
|
* <note>
|
|
93
92
|
* <ul>
|
|
94
93
|
* <li>
|
|
95
|
-
* <p>
|
|
96
|
-
*
|
|
97
|
-
*
|
|
98
|
-
*
|
|
99
|
-
*
|
|
100
|
-
* required. <code>s3:GetObjectVersion</code> permission won't be required.</p>
|
|
94
|
+
* <p>
|
|
95
|
+
* If you supply a <code>versionId</code>, you need the <code>s3:GetObjectVersion</code> permission to
|
|
96
|
+
* access a specific version of an object. If you request a specific version, you do not need to have
|
|
97
|
+
* the <code>s3:GetObject</code> permission.
|
|
98
|
+
* </p>
|
|
101
99
|
* </li>
|
|
102
100
|
* <li>
|
|
103
101
|
* <p>If the current version of the object is a delete marker, Amazon S3 behaves as if the
|
|
@@ -21,7 +21,8 @@ export interface GetObjectLockConfigurationCommandOutput extends GetObjectLockCo
|
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Gets the Object Lock configuration for a bucket. The rule specified in the Object Lock
|
|
23
23
|
* configuration will be applied by default to every new object placed in the specified
|
|
24
|
-
* bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
|
|
24
|
+
* bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
|
|
25
|
+
* Objects</a>.</p>
|
|
25
26
|
* <p>The following action is related to <code>GetObjectLockConfiguration</code>:</p>
|
|
26
27
|
* <ul>
|
|
27
28
|
* <li>
|
|
@@ -19,8 +19,7 @@ export interface GetObjectRetentionCommandOutput extends GetObjectRetentionOutpu
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
|
-
* <p>Retrieves an object's retention settings. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
|
|
23
|
-
* Objects</a>.</p>
|
|
22
|
+
* <p>Retrieves an object's retention settings. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>.</p>
|
|
24
23
|
* <p>This action is not supported by Amazon S3 on Outposts.</p>
|
|
25
24
|
* <p>The following action is related to <code>GetObjectRetention</code>:</p>
|
|
26
25
|
* <ul>
|
|
@@ -22,11 +22,11 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
|
|
|
22
22
|
* <p>Returns the tag-set of an object. You send the GET request against the tagging
|
|
23
23
|
* subresource associated with the object.</p>
|
|
24
24
|
* <p>To use this operation, you must have permission to perform the
|
|
25
|
-
* <code>s3:GetObjectTagging</code> action. By default, the GET action returns
|
|
26
|
-
* about current version of an object. For a versioned bucket, you can have
|
|
27
|
-
* of an object in your bucket. To retrieve tags of any other version, use
|
|
28
|
-
* parameter. You also need permission for the
|
|
29
|
-
*
|
|
25
|
+
* <code>s3:GetObjectTagging</code> action. By default, the GET action returns
|
|
26
|
+
* information about current version of an object. For a versioned bucket, you can have
|
|
27
|
+
* multiple versions of an object in your bucket. To retrieve tags of any other version, use
|
|
28
|
+
* the versionId query parameter. You also need permission for the
|
|
29
|
+
* <code>s3:GetObjectVersionTagging</code> action.</p>
|
|
30
30
|
* <p> By default, the bucket owner has this permission and can grant this permission to
|
|
31
31
|
* others.</p>
|
|
32
32
|
* <p> For information about the Amazon S3 object tagging feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html">Object Tagging</a>.</p>
|
|
@@ -20,7 +20,7 @@ export interface GetObjectTorrentCommandOutput extends __WithSdkStreamMixin<GetO
|
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Returns torrent files from a bucket. BitTorrent can save you bandwidth when you're
|
|
23
|
-
* distributing large files
|
|
23
|
+
* distributing large files. For more information about BitTorrent, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3Torrent.html">Using BitTorrent with Amazon S3</a>.</p>
|
|
24
24
|
* <note>
|
|
25
25
|
* <p>You can get torrent only for objects that are less than 5 GB in size, and that are
|
|
26
26
|
* not encrypted using server-side encryption with a customer-provided encryption
|
|
@@ -22,7 +22,7 @@ export interface GetPublicAccessBlockCommandOutput extends GetPublicAccessBlockO
|
|
|
22
22
|
* <p>Retrieves the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket. To use
|
|
23
23
|
* this operation, you must have the <code>s3:GetBucketPublicAccessBlock</code> permission.
|
|
24
24
|
* For more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
|
|
25
|
-
*
|
|
25
|
+
* Policy</a>.</p>
|
|
26
26
|
* <important>
|
|
27
27
|
* <p>When Amazon S3 evaluates the <code>PublicAccessBlock</code> configuration for a bucket or
|
|
28
28
|
* an object, it checks the <code>PublicAccessBlock</code> configuration for both the
|
|
@@ -19,23 +19,17 @@ export interface HeadBucketCommandOutput extends __MetadataBearer {
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
|
-
* <p>This action is useful to determine if a bucket exists and you have permission to
|
|
23
|
-
* it. The action returns a <code>200 OK</code> if the bucket exists and you have
|
|
24
|
-
* to access it.</p>
|
|
25
|
-
* <p>If the bucket does not exist or you do not have permission to access it, the
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
* you cannot determine the exception beyond these error codes.</p>
|
|
22
|
+
* <p>This action is useful to determine if a bucket exists and you have permission to
|
|
23
|
+
* access it. The action returns a <code>200 OK</code> if the bucket exists and you have
|
|
24
|
+
* permission to access it.</p>
|
|
25
|
+
* <p>If the bucket does not exist or you do not have permission to access it, the <code>HEAD</code> request
|
|
26
|
+
* returns a generic <code>404 Not Found</code> or <code>403 Forbidden</code> code. A message body is not
|
|
27
|
+
* included, so you cannot determine the exception beyond these error codes.</p>
|
|
29
28
|
* <p>To use this operation, you must have permissions to perform the
|
|
30
29
|
* <code>s3:ListBucket</code> action. The bucket owner has this permission by default and
|
|
31
|
-
* can grant this permission to others. For more information 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
|
|
32
|
-
*
|
|
33
|
-
* <p>To use this API against an access point, you must provide the alias of the access point in place of the
|
|
34
|
-
* bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to
|
|
35
|
-
* the access point hostname. The access point hostname takes the form
|
|
36
|
-
* AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using the Amazon Web Services SDKs,
|
|
37
|
-
* you provide the ARN in place of the bucket name. For more information see, <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using
|
|
38
|
-
* access points</a>.</p>
|
|
30
|
+
* can grant this permission to others. For more information 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 Access Permissions to Your Amazon S3
|
|
31
|
+
* Resources</a>.</p>
|
|
32
|
+
* <p>To use this API against an access point, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using the Amazon Web Services SDKs, you provide the ARN in place of the bucket name. For more information see, <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a>.</p>
|
|
39
33
|
* @example
|
|
40
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
41
35
|
* ```javascript
|
|
@@ -19,15 +19,14 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
|
-
* <p>The HEAD action retrieves metadata from an object without returning the object
|
|
23
|
-
* This action is useful if you're only interested in an object's metadata. To use
|
|
24
|
-
* must have READ access to the object.</p>
|
|
22
|
+
* <p>The HEAD action retrieves metadata from an object without returning the object
|
|
23
|
+
* itself. This action is useful if you're only interested in an object's metadata. To use
|
|
24
|
+
* HEAD, you must have READ access to the object.</p>
|
|
25
25
|
* <p>A <code>HEAD</code> request has the same options as a <code>GET</code> action on an
|
|
26
26
|
* object. The response is identical to the <code>GET</code> response except that there is no
|
|
27
27
|
* response body. Because of this, if the <code>HEAD</code> request generates an error, it
|
|
28
|
-
* returns a generic <code>
|
|
29
|
-
*
|
|
30
|
-
* codes.</p>
|
|
28
|
+
* returns a generic <code>404 Not Found</code> or <code>403 Forbidden</code> code. It is not
|
|
29
|
+
* possible to retrieve the exact exception beyond these error codes.</p>
|
|
31
30
|
* <p>If you encrypt an object by using server-side encryption with customer-provided
|
|
32
31
|
* encryption keys (SSE-C) when you store the object in Amazon S3, then when you retrieve the
|
|
33
32
|
* metadata from the object, you must use the following headers:</p>
|
|
@@ -42,25 +41,25 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
|
|
|
42
41
|
* <p>x-amz-server-side-encryption-customer-key-MD5</p>
|
|
43
42
|
* </li>
|
|
44
43
|
* </ul>
|
|
45
|
-
* <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption
|
|
46
|
-
*
|
|
44
|
+
* <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption (Using
|
|
45
|
+
* Customer-Provided Encryption Keys)</a>.</p>
|
|
47
46
|
* <note>
|
|
48
47
|
* <ul>
|
|
49
48
|
* <li>
|
|
50
|
-
* <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>,
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
49
|
+
* <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>, should
|
|
50
|
+
* not be sent for GET requests if your object uses server-side encryption with KMS keys (SSE-KMS)
|
|
51
|
+
* or server-side encryption with Amazon S3–managed encryption keys
|
|
52
|
+
* (SSE-S3). If your object does use these types of keys, you’ll get an HTTP 400 BadRequest
|
|
53
|
+
* error.</p>
|
|
55
54
|
* </li>
|
|
56
55
|
* <li>
|
|
57
|
-
* <p>
|
|
58
|
-
*
|
|
56
|
+
* <p>
|
|
57
|
+
* The last modified property in this case is the creation date of the object.</p>
|
|
59
58
|
* </li>
|
|
60
59
|
* </ul>
|
|
61
60
|
* </note>
|
|
62
|
-
* <p>Request headers are limited to 8 KB in size. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html">Common
|
|
63
|
-
*
|
|
61
|
+
* <p>Request headers are limited to 8 KB in size. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html">Common Request
|
|
62
|
+
* Headers</a>.</p>
|
|
64
63
|
* <p>Consider the following when using request headers:</p>
|
|
65
64
|
* <ul>
|
|
66
65
|
* <li>
|
|
@@ -104,9 +103,9 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
|
|
|
104
103
|
* <b>Permissions</b>
|
|
105
104
|
* </p>
|
|
106
105
|
* <p>You need the relevant read object (or version) permission for this operation. For more
|
|
107
|
-
* information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions
|
|
108
|
-
* Policy</a>. If the object you request does not exist, the error Amazon S3 returns
|
|
109
|
-
* on whether you also have the s3:ListBucket permission.</p>
|
|
106
|
+
* information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions
|
|
107
|
+
* in a Policy</a>. If the object you request does not exist, the error Amazon S3 returns
|
|
108
|
+
* depends on whether you also have the s3:ListBucket permission.</p>
|
|
110
109
|
* <ul>
|
|
111
110
|
* <li>
|
|
112
111
|
* <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3 returns
|
|
@@ -21,8 +21,8 @@ export interface ListBucketAnalyticsConfigurationsCommandOutput extends ListBuck
|
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Lists the analytics configurations for the bucket. You can have up to 1,000 analytics
|
|
23
23
|
* configurations per bucket.</p>
|
|
24
|
-
* <p>This action supports list pagination and does not return more than 100 configurations
|
|
25
|
-
* a time. You should always check the <code>IsTruncated</code> element in the response. If
|
|
24
|
+
* <p>This action supports list pagination and does not return more than 100 configurations
|
|
25
|
+
* at a time. You should always check the <code>IsTruncated</code> element in the response. If
|
|
26
26
|
* there are no more configurations to list, <code>IsTruncated</code> is set to false. If
|
|
27
27
|
* there are more configurations to list, <code>IsTruncated</code> is set to true, and there
|
|
28
28
|
* will be a value in <code>NextContinuationToken</code>. You use the
|
|
@@ -32,8 +32,8 @@ export interface ListBucketAnalyticsConfigurationsCommandOutput extends ListBuck
|
|
|
32
32
|
* <p>To use this operation, you must have permissions to perform the
|
|
33
33
|
* <code>s3:GetAnalyticsConfiguration</code> action. The bucket owner has this permission
|
|
34
34
|
* by default. The bucket owner can grant this permission to others. For more information
|
|
35
|
-
* 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
|
|
36
|
-
*
|
|
35
|
+
* 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 Access Permissions to Your Amazon S3
|
|
36
|
+
* Resources</a>.</p>
|
|
37
37
|
* <p>For information about Amazon S3 analytics feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html">Amazon S3 Analytics – Storage Class
|
|
38
38
|
* Analysis</a>. </p>
|
|
39
39
|
* <p>The following operations are related to
|
|
@@ -23,7 +23,8 @@ export interface ListBucketIntelligentTieringConfigurationsCommandOutput extends
|
|
|
23
23
|
* <p>The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without performance impact or operational overhead. S3 Intelligent-Tiering delivers automatic cost savings in three low latency and high throughput access tiers. To get the lowest storage cost on data that can be accessed in minutes to hours, you can choose to activate additional archiving capabilities.</p>
|
|
24
24
|
* <p>The S3 Intelligent-Tiering storage class is the ideal storage class for data with unknown, changing, or unpredictable access patterns, independent of object size or retention period. If the size of an object is less than 128 KB, it is not monitored and not eligible for auto-tiering. Smaller objects can be stored, but they are always charged at the Frequent Access tier rates in the S3 Intelligent-Tiering storage class.</p>
|
|
25
25
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access">Storage class for automatically optimizing frequently and infrequently accessed objects</a>.</p>
|
|
26
|
-
* <p>Operations related to
|
|
26
|
+
* <p>Operations related to
|
|
27
|
+
* <code>ListBucketIntelligentTieringConfigurations</code> include: </p>
|
|
27
28
|
* <ul>
|
|
28
29
|
* <li>
|
|
29
30
|
* <p>
|
|
@@ -21,9 +21,9 @@ export interface ListBucketInventoryConfigurationsCommandOutput extends ListBuck
|
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Returns a list of inventory configurations for the bucket. You can have up to 1,000
|
|
23
23
|
* analytics configurations per bucket.</p>
|
|
24
|
-
* <p>This action supports list pagination and does not return more than 100 configurations
|
|
25
|
-
* a time. Always check the <code>IsTruncated</code> element in the response. If there are
|
|
26
|
-
* more configurations to list, <code>IsTruncated</code> is set to false. If there are more
|
|
24
|
+
* <p>This action supports list pagination and does not return more than 100 configurations
|
|
25
|
+
* at a time. Always check the <code>IsTruncated</code> element in the response. If there are
|
|
26
|
+
* no more configurations to list, <code>IsTruncated</code> is set to false. If there are more
|
|
27
27
|
* configurations to list, <code>IsTruncated</code> is set to true, and there is a value in
|
|
28
28
|
* <code>NextContinuationToken</code>. You use the <code>NextContinuationToken</code> value
|
|
29
29
|
* to continue the pagination of the list by passing the value in continuation-token in the
|
|
@@ -31,8 +31,8 @@ export interface ListBucketInventoryConfigurationsCommandOutput extends ListBuck
|
|
|
31
31
|
* <p> To use this operation, you must have permissions to perform the
|
|
32
32
|
* <code>s3:GetInventoryConfiguration</code> action. The bucket owner has this permission
|
|
33
33
|
* by default. The bucket owner can grant this permission to others. For more information
|
|
34
|
-
* 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
|
|
35
|
-
*
|
|
34
|
+
* 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 Access Permissions to Your Amazon S3
|
|
35
|
+
* Resources</a>.</p>
|
|
36
36
|
* <p>For information about the Amazon S3 inventory feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html">Amazon S3 Inventory</a>
|
|
37
37
|
* </p>
|
|
38
38
|
* <p>The following operations are related to
|
|
@@ -22,9 +22,9 @@ export interface ListBucketMetricsConfigurationsCommandOutput extends ListBucket
|
|
|
22
22
|
* <p>Lists the metrics configurations for the bucket. The metrics configurations are only for
|
|
23
23
|
* the request metrics of the bucket and do not provide information on daily storage metrics.
|
|
24
24
|
* You can have up to 1,000 configurations per bucket.</p>
|
|
25
|
-
* <p>This action supports list pagination and does not return more than 100 configurations
|
|
26
|
-
* a time. Always check the <code>IsTruncated</code> element in the response. If there are
|
|
27
|
-
* more configurations to list, <code>IsTruncated</code> is set to false. If there are more
|
|
25
|
+
* <p>This action supports list pagination and does not return more than 100 configurations
|
|
26
|
+
* at a time. Always check the <code>IsTruncated</code> element in the response. If there are
|
|
27
|
+
* no more configurations to list, <code>IsTruncated</code> is set to false. If there are more
|
|
28
28
|
* configurations to list, <code>IsTruncated</code> is set to true, and there is a value in
|
|
29
29
|
* <code>NextContinuationToken</code>. You use the <code>NextContinuationToken</code> value
|
|
30
30
|
* to continue the pagination of the list by passing the value in
|
|
@@ -32,10 +32,11 @@ export interface ListBucketMetricsConfigurationsCommandOutput extends ListBucket
|
|
|
32
32
|
* <p>To use this operation, you must have permissions to perform the
|
|
33
33
|
* <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by
|
|
34
34
|
* default. The bucket owner can grant this permission to others. For more information about
|
|
35
|
-
* 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
|
|
36
|
-
*
|
|
35
|
+
* 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 Access Permissions to Your Amazon S3
|
|
36
|
+
* Resources</a>.</p>
|
|
37
37
|
* <p>For more information about metrics configurations and CloudWatch request metrics, see
|
|
38
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
|
|
38
|
+
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
|
|
39
|
+
* CloudWatch</a>.</p>
|
|
39
40
|
* <p>The following operations are related to
|
|
40
41
|
* <code>ListBucketMetricsConfigurations</code>:</p>
|
|
41
42
|
* <ul>
|
|
@@ -20,9 +20,7 @@ export interface ListBucketsCommandOutput extends ListBucketsOutput, __MetadataB
|
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Returns a list of all buckets owned by the authenticated sender of the request. To use
|
|
23
|
-
*
|
|
24
|
-
* <p>For information about Amazon S3 buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html">Creating, configuring, and
|
|
25
|
-
* working with Amazon S3 buckets</a>.</p>
|
|
23
|
+
* this operation, you must have the <code>s3:ListAllMyBuckets</code> permission.</p>
|
|
26
24
|
* @example
|
|
27
25
|
* Use a bare-bones client and the command you need to make an API call.
|
|
28
26
|
* ```javascript
|
|
@@ -35,8 +35,8 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
|
|
|
35
35
|
* upload initiation time.</p>
|
|
36
36
|
* <p>For more information on multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
|
|
37
37
|
* Upload</a>.</p>
|
|
38
|
-
* <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload
|
|
39
|
-
*
|
|
38
|
+
* <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and
|
|
39
|
+
* Permissions</a>.</p>
|
|
40
40
|
* <p>The following operations are related to <code>ListMultipartUploads</code>:</p>
|
|
41
41
|
* <ul>
|
|
42
42
|
* <li>
|
|
@@ -23,8 +23,10 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
|
|
|
23
23
|
* parameters as selection criteria to return metadata about a subset of all the object
|
|
24
24
|
* versions.</p>
|
|
25
25
|
* <important>
|
|
26
|
-
* <p>
|
|
27
|
-
*
|
|
26
|
+
* <p>
|
|
27
|
+
* To use this operation, you must have permissions to perform the
|
|
28
|
+
* <code>s3:ListBucketVersions</code> action. Be aware of the name difference.
|
|
29
|
+
* </p>
|
|
28
30
|
* </important>
|
|
29
31
|
* <note>
|
|
30
32
|
* <p> A 200 OK response can contain valid or invalid XML. Make sure to design your
|
|
@@ -32,7 +34,8 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
|
|
|
32
34
|
* </note>
|
|
33
35
|
* <p>To use this operation, you must have READ access to the bucket.</p>
|
|
34
36
|
* <p>This action is not supported by Amazon S3 on Outposts.</p>
|
|
35
|
-
* <p>The following operations are related to
|
|
37
|
+
* <p>The following operations are related to
|
|
38
|
+
* <code>ListObjectVersions</code>:</p>
|
|
36
39
|
* <ul>
|
|
37
40
|
* <li>
|
|
38
41
|
* <p>
|
|
@@ -19,23 +19,24 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
|
-
* <p>Returns some or all (up to 1,000) of the objects in a bucket with each request. You can
|
|
23
|
-
*
|
|
24
|
-
*
|
|
25
|
-
*
|
|
22
|
+
* <p>Returns some or all (up to 1,000) of the objects in a bucket with each request. You can use
|
|
23
|
+
* the request parameters as selection criteria to return a subset of the objects in a bucket. A
|
|
24
|
+
* <code>200 OK</code> response can contain valid or invalid XML. Make sure to design your
|
|
25
|
+
* application to parse the contents of the response and handle it appropriately.
|
|
26
26
|
* Objects are returned sorted in an ascending order of the respective key names in the list.
|
|
27
27
|
* For more information about listing objects, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html">Listing object keys
|
|
28
28
|
* programmatically</a>
|
|
29
29
|
* </p>
|
|
30
30
|
* <p>To use this operation, you must have READ access to the bucket.</p>
|
|
31
|
-
* <p>To use this action in an Identity and Access Management (IAM) policy, you must
|
|
32
|
-
* the <code>s3:ListBucket</code> action. The bucket owner has
|
|
33
|
-
* can grant this permission to others. For more information
|
|
34
|
-
*
|
|
31
|
+
* <p>To use this action in an Identity and Access Management (IAM) policy, you must
|
|
32
|
+
* have permissions to perform the <code>s3:ListBucket</code> action. The bucket owner has
|
|
33
|
+
* this permission by default and can grant this permission to others. For more information
|
|
34
|
+
* 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 Access Permissions to Your Amazon S3
|
|
35
|
+
* Resources</a>.</p>
|
|
35
36
|
* <important>
|
|
36
|
-
* <p>This section describes the latest revision of this action. We recommend that you use
|
|
37
|
-
*
|
|
38
|
-
*
|
|
37
|
+
* <p>This section describes the latest revision of this action. We recommend that you use this
|
|
38
|
+
* revised API for application development. For backward compatibility, Amazon S3 continues to
|
|
39
|
+
* support the prior version of this API, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html">ListObjects</a>.</p>
|
|
39
40
|
* </important>
|
|
40
41
|
* <p>To get a list of your buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html">ListBuckets</a>.</p>
|
|
41
42
|
* <p>The following operations are related to <code>ListObjectsV2</code>:</p>
|
|
@@ -30,11 +30,12 @@ export interface ListPartsCommandOutput extends ListPartsOutput, __MetadataBeare
|
|
|
30
30
|
* requests you can include the part-number-marker query string parameter and set its value to
|
|
31
31
|
* the <code>NextPartNumberMarker</code> field value from the previous response.</p>
|
|
32
32
|
* <p>If the upload was created using a checksum algorithm, you will need to have permission
|
|
33
|
-
*
|
|
33
|
+
* to the <code>kms:Decrypt</code> action for the request to succeed.
|
|
34
|
+
* </p>
|
|
34
35
|
* <p>For more information on multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
|
|
35
36
|
* Upload</a>.</p>
|
|
36
|
-
* <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload
|
|
37
|
-
*
|
|
37
|
+
* <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and
|
|
38
|
+
* Permissions</a>.</p>
|
|
38
39
|
* <p>The following operations are related to <code>ListParts</code>:</p>
|
|
39
40
|
* <ul>
|
|
40
41
|
* <li>
|
|
@@ -36,14 +36,13 @@ export interface PutBucketAccelerateConfigurationCommandOutput extends __Metadat
|
|
|
36
36
|
* <p> Suspended – Disables accelerated data transfers to the bucket.</p>
|
|
37
37
|
* </li>
|
|
38
38
|
* </ul>
|
|
39
|
-
* <p>The <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html">GetBucketAccelerateConfiguration</a> action returns the transfer acceleration
|
|
40
|
-
* of a bucket.</p>
|
|
39
|
+
* <p>The <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html">GetBucketAccelerateConfiguration</a> action returns the transfer acceleration
|
|
40
|
+
* state of a bucket.</p>
|
|
41
41
|
* <p>After setting the Transfer Acceleration state of a bucket to Enabled, it might take up
|
|
42
42
|
* to thirty minutes before the data transfer rates to the bucket increase.</p>
|
|
43
43
|
* <p> The name of the bucket used for Transfer Acceleration must be DNS-compliant and must
|
|
44
44
|
* not contain periods (".").</p>
|
|
45
|
-
* <p> For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer
|
|
46
|
-
* Acceleration</a>.</p>
|
|
45
|
+
* <p> For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer Acceleration</a>.</p>
|
|
47
46
|
* <p>The following operations are related to
|
|
48
47
|
* <code>PutBucketAccelerateConfiguration</code>:</p>
|
|
49
48
|
* <ul>
|