@aws-sdk/client-s3 3.326.0 → 3.328.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-types/commands/AbortMultipartUploadCommand.d.ts +2 -2
- package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +22 -14
- package/dist-types/commands/CopyObjectCommand.d.ts +171 -144
- package/dist-types/commands/CreateBucketCommand.d.ts +128 -118
- package/dist-types/commands/CreateMultipartUploadCommand.d.ts +73 -48
- package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +2 -2
- package/dist-types/commands/DeleteBucketCommand.d.ts +1 -3
- package/dist-types/commands/DeleteBucketCorsCommand.d.ts +3 -5
- package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +8 -8
- package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +1 -2
- package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +2 -2
- package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +1 -2
- package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +5 -5
- package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +2 -2
- package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +6 -3
- package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +4 -3
- package/dist-types/commands/DeleteObjectCommand.d.ts +21 -21
- package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +13 -15
- package/dist-types/commands/DeleteObjectsCommand.d.ts +35 -36
- package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +2 -2
- package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +6 -7
- package/dist-types/commands/GetBucketAclCommand.d.ts +14 -10
- package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +6 -7
- package/dist-types/commands/GetBucketCorsCommand.d.ts +5 -0
- package/dist-types/commands/GetBucketEncryptionCommand.d.ts +7 -7
- package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +1 -2
- 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 +10 -2
- package/dist-types/commands/GetBucketLoggingCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +5 -6
- package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +7 -2
- package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +4 -3
- package/dist-types/commands/GetBucketPolicyCommand.d.ts +11 -3
- package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +1 -1
- package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +2 -1
- package/dist-types/commands/GetBucketWebsiteCommand.d.ts +2 -3
- package/dist-types/commands/GetObjectAclCommand.d.ts +5 -7
- package/dist-types/commands/GetObjectAttributesCommand.d.ts +42 -45
- package/dist-types/commands/GetObjectCommand.d.ts +116 -112
- package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +1 -2
- package/dist-types/commands/GetObjectRetentionCommand.d.ts +2 -1
- 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 +19 -9
- package/dist-types/commands/HeadObjectCommand.d.ts +36 -33
- package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +4 -4
- package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +1 -2
- package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +5 -5
- package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +6 -7
- package/dist-types/commands/ListBucketsCommand.d.ts +9 -7
- package/dist-types/commands/ListMultipartUploadsCommand.d.ts +2 -2
- package/dist-types/commands/ListObjectVersionsCommand.d.ts +3 -6
- package/dist-types/commands/ListObjectsV2Command.d.ts +13 -14
- package/dist-types/commands/ListPartsCommand.d.ts +3 -4
- package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +4 -3
- package/dist-types/commands/PutBucketAclCommand.d.ts +114 -111
- package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +7 -10
- package/dist-types/commands/PutBucketCorsCommand.d.ts +3 -5
- package/dist-types/commands/PutBucketEncryptionCommand.d.ts +17 -17
- package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +31 -59
- package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +50 -65
- package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +64 -62
- package/dist-types/commands/PutBucketLoggingCommand.d.ts +45 -39
- package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +4 -4
- package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +9 -12
- package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +4 -2
- package/dist-types/commands/PutBucketPolicyCommand.d.ts +8 -4
- package/dist-types/commands/PutBucketReplicationCommand.d.ts +31 -28
- 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 +7 -9
- package/dist-types/commands/PutObjectAclCommand.d.ts +123 -119
- package/dist-types/commands/PutObjectCommand.d.ts +81 -90
- package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +7 -8
- package/dist-types/commands/PutObjectRetentionCommand.d.ts +3 -4
- package/dist-types/commands/PutObjectTaggingCommand.d.ts +7 -9
- package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +2 -4
- package/dist-types/commands/RestoreObjectCommand.d.ts +175 -199
- package/dist-types/commands/SelectObjectContentCommand.d.ts +83 -90
- package/dist-types/commands/UploadPartCommand.d.ts +26 -22
- package/dist-types/commands/UploadPartCopyCommand.d.ts +78 -76
- package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +32 -21
- package/dist-types/models/models_0.d.ts +468 -382
- package/dist-types/models/models_1.d.ts +82 -80
- package/package.json +9 -9
|
@@ -24,8 +24,8 @@ export interface DeleteBucketInventoryConfigurationCommandOutput extends __Metad
|
|
|
24
24
|
* <p>To use this operation, you must have permissions to perform the
|
|
25
25
|
* <code>s3:PutInventoryConfiguration</code> action. The bucket owner has this permission
|
|
26
26
|
* by default. The bucket owner can grant this permission to others. For more information
|
|
27
|
-
* 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
|
|
28
|
-
* Resources</a>.</p>
|
|
27
|
+
* 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
|
|
28
|
+
* Access Permissions to Your Amazon S3 Resources</a>.</p>
|
|
29
29
|
* <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>.</p>
|
|
30
30
|
* <p>Operations related to <code>DeleteBucketInventoryConfiguration</code> include: </p>
|
|
31
31
|
* <ul>
|
|
@@ -28,8 +28,7 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
|
|
|
28
28
|
* permission and the bucket owner can grant this permission to others.</p>
|
|
29
29
|
* <p>There is usually some time lag before lifecycle configuration deletion is fully
|
|
30
30
|
* propagated to all the Amazon S3 systems.</p>
|
|
31
|
-
* <p>For more information about the object expiration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions">Elements to
|
|
32
|
-
* Describe Lifecycle Actions</a>.</p>
|
|
31
|
+
* <p>For more information about the object expiration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions">Elements to Describe Lifecycle Actions</a>.</p>
|
|
33
32
|
* <p>Related actions include:</p>
|
|
34
33
|
* <ul>
|
|
35
34
|
* <li>
|
|
@@ -25,9 +25,10 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
|
|
|
25
25
|
* <p> To use this operation, you must have permissions to perform the
|
|
26
26
|
* <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by
|
|
27
27
|
* default. The bucket owner can grant this permission to others. For more information about
|
|
28
|
-
* 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
|
|
29
|
-
* Resources</a>.</p>
|
|
30
|
-
* <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with
|
|
28
|
+
* 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
|
|
29
|
+
* Access Permissions to Your Amazon S3 Resources</a>.</p>
|
|
30
|
+
* <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with
|
|
31
|
+
* Amazon CloudWatch</a>. </p>
|
|
31
32
|
* <p>The following operations are related to
|
|
32
33
|
* <code>DeleteBucketMetricsConfiguration</code>:</p>
|
|
33
34
|
* <ul>
|
|
@@ -48,8 +49,7 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
|
|
|
48
49
|
* </li>
|
|
49
50
|
* <li>
|
|
50
51
|
* <p>
|
|
51
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
|
|
52
|
-
* CloudWatch</a>
|
|
52
|
+
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>
|
|
53
53
|
* </p>
|
|
54
54
|
* </li>
|
|
55
55
|
* </ul>
|
|
@@ -21,8 +21,8 @@ export interface DeleteBucketOwnershipControlsCommandOutput extends __MetadataBe
|
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Removes <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you
|
|
23
23
|
* must have the <code>s3:PutBucketOwnershipControls</code> permission. For more information
|
|
24
|
-
* about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying
|
|
25
|
-
*
|
|
24
|
+
* 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
|
+
* Policy</a>.</p>
|
|
26
26
|
* <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/about-object-ownership.html">Using Object Ownership</a>. </p>
|
|
27
27
|
* <p>The following operations are related to
|
|
28
28
|
* <code>DeleteBucketOwnershipControls</code>:</p>
|
|
@@ -29,9 +29,12 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
|
|
|
29
29
|
* identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
|
|
30
30
|
* Allowed</code> error. </p>
|
|
31
31
|
* <important>
|
|
32
|
-
* <p>
|
|
33
|
-
*
|
|
34
|
-
*
|
|
32
|
+
* <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
|
|
33
|
+
* buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
|
|
34
|
+
* <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
|
|
35
|
+
* <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
|
|
36
|
+
* denies the root principal's access. Bucket owner root principals can only be blocked from performing
|
|
37
|
+
* these API actions by VPC endpoint policies and Amazon Web Services Organizations policies.</p>
|
|
35
38
|
* </important>
|
|
36
39
|
* <p>For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and
|
|
37
40
|
* UserPolicies</a>. </p>
|
|
@@ -23,13 +23,14 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
|
|
|
23
23
|
* <p>To use this operation, you must have permissions to perform the
|
|
24
24
|
* <code>s3:PutReplicationConfiguration</code> action. The bucket owner has these
|
|
25
25
|
* permissions by default and can grant it to others. For more information about permissions,
|
|
26
|
-
* 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
|
|
27
|
-
* Resources</a>. </p>
|
|
26
|
+
* 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
|
|
27
|
+
* Access Permissions to Your Amazon S3 Resources</a>. </p>
|
|
28
28
|
* <note>
|
|
29
29
|
* <p>It can take a while for the deletion of a replication configuration to fully
|
|
30
30
|
* propagate.</p>
|
|
31
31
|
* </note>
|
|
32
|
-
* <p> For information about replication configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the
|
|
32
|
+
* <p> For information about replication configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the
|
|
33
|
+
* <i>Amazon S3 User Guide</i>.</p>
|
|
33
34
|
* <p>The following operations are related to <code>DeleteBucketReplication</code>:</p>
|
|
34
35
|
* <ul>
|
|
35
36
|
* <li>
|
|
@@ -22,21 +22,21 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
|
|
|
22
22
|
* <p>Removes the null version (if there is one) of an object and inserts a delete marker,
|
|
23
23
|
* which becomes the latest version of the object. If there isn't a null version, Amazon S3 does
|
|
24
24
|
* not remove any objects but will still respond that the command was successful.</p>
|
|
25
|
-
* <p>To remove a specific version, you must
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
* <code>x-amz-delete-marker</code>, to true. </p>
|
|
25
|
+
* <p>To remove a specific version, you must use the version Id subresource. Using this
|
|
26
|
+
* subresource permanently deletes the version. If the object deleted is a delete marker, Amazon S3
|
|
27
|
+
* sets the response header, <code>x-amz-delete-marker</code>, to true. </p>
|
|
29
28
|
* <p>If the object you want to delete is in a bucket where the bucket versioning
|
|
30
29
|
* configuration is MFA Delete enabled, you must include the <code>x-amz-mfa</code> request
|
|
31
30
|
* header in the DELETE <code>versionId</code> request. Requests that include
|
|
32
31
|
* <code>x-amz-mfa</code> must use HTTPS. </p>
|
|
33
|
-
* <p> For more information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html">Using MFA Delete</a>. To see sample
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
32
|
+
* <p> For more information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html">Using MFA Delete</a>. To see sample
|
|
33
|
+
* requests that use versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete">Sample
|
|
34
|
+
* Request</a>. </p>
|
|
35
|
+
* <p>You can delete objects by explicitly calling DELETE Object or configure its lifecycle
|
|
36
|
+
* (<a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>) to enable Amazon S3 to remove them for you. If you want to block
|
|
37
|
+
* users or accounts from removing or deleting objects from your bucket, you must deny them
|
|
38
|
+
* the <code>s3:DeleteObject</code>, <code>s3:DeleteObjectVersion</code>, and
|
|
39
|
+
* <code>s3:PutLifeCycleConfiguration</code> actions. </p>
|
|
40
40
|
* <p>The following action is related to <code>DeleteObject</code>:</p>
|
|
41
41
|
* <ul>
|
|
42
42
|
* <li>
|
|
@@ -79,28 +79,28 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
|
|
|
79
79
|
* @throws {@link S3ServiceException}
|
|
80
80
|
* <p>Base exception class for all service exceptions from S3 service.</p>
|
|
81
81
|
*
|
|
82
|
-
* @example To delete an object
|
|
82
|
+
* @example To delete an object (from a non-versioned bucket)
|
|
83
83
|
* ```javascript
|
|
84
|
-
* // The following example deletes an object from
|
|
84
|
+
* // The following example deletes an object from a non-versioned bucket.
|
|
85
85
|
* const input = {
|
|
86
|
-
* "Bucket": "
|
|
87
|
-
* "Key": "
|
|
86
|
+
* "Bucket": "ExampleBucket",
|
|
87
|
+
* "Key": "HappyFace.jpg"
|
|
88
88
|
* };
|
|
89
89
|
* const command = new DeleteObjectCommand(input);
|
|
90
90
|
* await client.send(command);
|
|
91
|
-
* // example id: to-delete-an-object-
|
|
91
|
+
* // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
|
|
92
92
|
* ```
|
|
93
93
|
*
|
|
94
|
-
* @example To delete an object
|
|
94
|
+
* @example To delete an object
|
|
95
95
|
* ```javascript
|
|
96
|
-
* // The following example deletes an object from
|
|
96
|
+
* // The following example deletes an object from an S3 bucket.
|
|
97
97
|
* const input = {
|
|
98
|
-
* "Bucket": "
|
|
99
|
-
* "Key": "
|
|
98
|
+
* "Bucket": "examplebucket",
|
|
99
|
+
* "Key": "objectkey.jpg"
|
|
100
100
|
* };
|
|
101
101
|
* const command = new DeleteObjectCommand(input);
|
|
102
102
|
* await client.send(command);
|
|
103
|
-
* // example id: to-delete-an-object-
|
|
103
|
+
* // example id: to-delete-an-object-1472850136595
|
|
104
104
|
* ```
|
|
105
105
|
*
|
|
106
106
|
*/
|
|
@@ -20,15 +20,13 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
|
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Removes the entire tag set from the specified object. For more information about
|
|
23
|
-
* managing object tags, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html"> Object
|
|
24
|
-
* Tagging</a>.</p>
|
|
23
|
+
* managing object tags, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html"> Object Tagging</a>.</p>
|
|
25
24
|
* <p>To use this operation, you must have permission to perform the
|
|
26
25
|
* <code>s3:DeleteObjectTagging</code> action.</p>
|
|
27
26
|
* <p>To delete tags of a specific object version, add the <code>versionId</code> query
|
|
28
27
|
* parameter in the request. You will need permission for the
|
|
29
28
|
* <code>s3:DeleteObjectVersionTagging</code> action.</p>
|
|
30
|
-
* <p>The following operations are related to
|
|
31
|
-
* <code>DeleteBucketMetricsConfiguration</code>:</p>
|
|
29
|
+
* <p>The following operations are related to <code>DeleteObjectTagging</code>:</p>
|
|
32
30
|
* <ul>
|
|
33
31
|
* <li>
|
|
34
32
|
* <p>
|
|
@@ -70,39 +68,39 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
|
|
|
70
68
|
* @throws {@link S3ServiceException}
|
|
71
69
|
* <p>Base exception class for all service exceptions from S3 service.</p>
|
|
72
70
|
*
|
|
73
|
-
* @example To remove tag set from an object
|
|
71
|
+
* @example To remove tag set from an object version
|
|
74
72
|
* ```javascript
|
|
75
|
-
* // The following example removes tag set associated with the specified object.
|
|
73
|
+
* // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
|
|
76
74
|
* const input = {
|
|
77
75
|
* "Bucket": "examplebucket",
|
|
78
|
-
* "Key": "HappyFace.jpg"
|
|
76
|
+
* "Key": "HappyFace.jpg",
|
|
77
|
+
* "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
|
|
79
78
|
* };
|
|
80
79
|
* const command = new DeleteObjectTaggingCommand(input);
|
|
81
80
|
* const response = await client.send(command);
|
|
82
81
|
* /* response ==
|
|
83
82
|
* {
|
|
84
|
-
* "VersionId": "
|
|
83
|
+
* "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
|
|
85
84
|
* }
|
|
86
85
|
* *\/
|
|
87
|
-
* // example id: to-remove-tag-set-from-an-object-
|
|
86
|
+
* // example id: to-remove-tag-set-from-an-object-version-1483145285913
|
|
88
87
|
* ```
|
|
89
88
|
*
|
|
90
|
-
* @example To remove tag set from an object
|
|
89
|
+
* @example To remove tag set from an object
|
|
91
90
|
* ```javascript
|
|
92
|
-
* // The following example removes tag set associated with the specified object
|
|
91
|
+
* // The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.
|
|
93
92
|
* const input = {
|
|
94
93
|
* "Bucket": "examplebucket",
|
|
95
|
-
* "Key": "HappyFace.jpg"
|
|
96
|
-
* "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
|
|
94
|
+
* "Key": "HappyFace.jpg"
|
|
97
95
|
* };
|
|
98
96
|
* const command = new DeleteObjectTaggingCommand(input);
|
|
99
97
|
* const response = await client.send(command);
|
|
100
98
|
* /* response ==
|
|
101
99
|
* {
|
|
102
|
-
* "VersionId": "
|
|
100
|
+
* "VersionId": "null"
|
|
103
101
|
* }
|
|
104
102
|
* *\/
|
|
105
|
-
* // example id: to-remove-tag-set-from-an-object-
|
|
103
|
+
* // example id: to-remove-tag-set-from-an-object-1483145342862
|
|
106
104
|
* ```
|
|
107
105
|
*
|
|
108
106
|
*/
|
|
@@ -20,28 +20,27 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
|
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
22
|
* <p>This action enables you to delete multiple objects from a bucket using a single HTTP
|
|
23
|
-
* request. If you know the object keys that you want to delete, then this action provides
|
|
24
|
-
*
|
|
23
|
+
* request. If you know the object keys that you want to delete, then this action provides a
|
|
24
|
+
* suitable alternative to sending individual delete requests, reducing per-request
|
|
25
25
|
* overhead.</p>
|
|
26
26
|
* <p>The request contains a list of up to 1000 keys that you want to delete. In the XML, you
|
|
27
27
|
* provide the object key names, and optionally, version IDs if you want to delete a specific
|
|
28
28
|
* version of the object from a versioning-enabled bucket. For each key, Amazon S3 performs a
|
|
29
|
-
* delete action and returns the result of that delete, success, or failure, in the
|
|
30
|
-
*
|
|
31
|
-
*
|
|
29
|
+
* delete action and returns the result of that delete, success, or failure, in the response.
|
|
30
|
+
* Note that if the object specified in the request is not found, Amazon S3 returns the result as
|
|
31
|
+
* deleted.</p>
|
|
32
32
|
* <p> The action supports two modes for the response: verbose and quiet. By default, the
|
|
33
|
-
* action uses verbose mode in which the response includes the result of deletion of each
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
* <p>When performing this action on an MFA Delete enabled bucket, that attempts to delete
|
|
38
|
-
*
|
|
33
|
+
* action uses verbose mode in which the response includes the result of deletion of each key
|
|
34
|
+
* in your request. In quiet mode the response includes only keys where the delete action
|
|
35
|
+
* encountered an error. For a successful deletion, the action does not return any information
|
|
36
|
+
* about the delete in the response body.</p>
|
|
37
|
+
* <p>When performing this action on an MFA Delete enabled bucket, that attempts to delete any
|
|
38
|
+
* versioned objects, you must include an MFA token. If you do not provide one, the entire
|
|
39
39
|
* request will fail, even if there are non-versioned objects you are trying to delete. If you
|
|
40
40
|
* provide an invalid token, whether there are versioned keys in the request or not, the
|
|
41
41
|
* entire Multi-Object Delete request will fail. For information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete"> MFA
|
|
42
|
-
*
|
|
43
|
-
* <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon
|
|
44
|
-
* S3 uses the header value to ensure that your request body has not been altered in
|
|
42
|
+
* Delete</a>.</p>
|
|
43
|
+
* <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon S3 uses the header value to ensure that your request body has not been altered in
|
|
45
44
|
* transit.</p>
|
|
46
45
|
* <p>The following operations are related to <code>DeleteObjects</code>:</p>
|
|
47
46
|
* <ul>
|
|
@@ -127,18 +126,20 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
|
|
|
127
126
|
* @throws {@link S3ServiceException}
|
|
128
127
|
* <p>Base exception class for all service exceptions from S3 service.</p>
|
|
129
128
|
*
|
|
130
|
-
* @example To delete multiple
|
|
129
|
+
* @example To delete multiple object versions from a versioned bucket
|
|
131
130
|
* ```javascript
|
|
132
|
-
* // The following example deletes objects from a bucket. The
|
|
131
|
+
* // The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object versions and returns the key and versions of deleted objects in the response.
|
|
133
132
|
* const input = {
|
|
134
133
|
* "Bucket": "examplebucket",
|
|
135
134
|
* "Delete": {
|
|
136
135
|
* "Objects": [
|
|
137
136
|
* {
|
|
138
|
-
* "Key": "
|
|
137
|
+
* "Key": "HappyFace.jpg",
|
|
138
|
+
* "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
|
|
139
139
|
* },
|
|
140
140
|
* {
|
|
141
|
-
* "Key": "
|
|
141
|
+
* "Key": "HappyFace.jpg",
|
|
142
|
+
* "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
|
|
142
143
|
* }
|
|
143
144
|
* ],
|
|
144
145
|
* "Quiet": false
|
|
@@ -150,35 +151,31 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
|
|
|
150
151
|
* {
|
|
151
152
|
* "Deleted": [
|
|
152
153
|
* {
|
|
153
|
-
* "
|
|
154
|
-
* "
|
|
155
|
-
* "Key": "objectkey1"
|
|
154
|
+
* "Key": "HappyFace.jpg",
|
|
155
|
+
* "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
|
|
156
156
|
* },
|
|
157
157
|
* {
|
|
158
|
-
* "
|
|
159
|
-
* "
|
|
160
|
-
* "Key": "objectkey2"
|
|
158
|
+
* "Key": "HappyFace.jpg",
|
|
159
|
+
* "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
|
|
161
160
|
* }
|
|
162
161
|
* ]
|
|
163
162
|
* }
|
|
164
163
|
* *\/
|
|
165
|
-
* // example id: to-delete-multiple-
|
|
164
|
+
* // example id: to-delete-multiple-object-versions-from-a-versioned-bucket-1483147087737
|
|
166
165
|
* ```
|
|
167
166
|
*
|
|
168
|
-
* @example To delete multiple
|
|
167
|
+
* @example To delete multiple objects from a versioned bucket
|
|
169
168
|
* ```javascript
|
|
170
|
-
* // The following example deletes objects from a bucket. The request
|
|
169
|
+
* // The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
|
|
171
170
|
* const input = {
|
|
172
171
|
* "Bucket": "examplebucket",
|
|
173
172
|
* "Delete": {
|
|
174
173
|
* "Objects": [
|
|
175
174
|
* {
|
|
176
|
-
* "Key": "
|
|
177
|
-
* "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
|
|
175
|
+
* "Key": "objectkey1"
|
|
178
176
|
* },
|
|
179
177
|
* {
|
|
180
|
-
* "Key": "
|
|
181
|
-
* "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
|
|
178
|
+
* "Key": "objectkey2"
|
|
182
179
|
* }
|
|
183
180
|
* ],
|
|
184
181
|
* "Quiet": false
|
|
@@ -190,17 +187,19 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
|
|
|
190
187
|
* {
|
|
191
188
|
* "Deleted": [
|
|
192
189
|
* {
|
|
193
|
-
* "
|
|
194
|
-
* "
|
|
190
|
+
* "DeleteMarker": "true",
|
|
191
|
+
* "DeleteMarkerVersionId": "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
|
|
192
|
+
* "Key": "objectkey1"
|
|
195
193
|
* },
|
|
196
194
|
* {
|
|
197
|
-
* "
|
|
198
|
-
* "
|
|
195
|
+
* "DeleteMarker": "true",
|
|
196
|
+
* "DeleteMarkerVersionId": "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
|
|
197
|
+
* "Key": "objectkey2"
|
|
199
198
|
* }
|
|
200
199
|
* ]
|
|
201
200
|
* }
|
|
202
201
|
* *\/
|
|
203
|
-
* // example id: to-delete-multiple-
|
|
202
|
+
* // example id: to-delete-multiple-objects-from-a-versioned-bucket-1483146248805
|
|
204
203
|
* ```
|
|
205
204
|
*
|
|
206
205
|
*/
|
|
@@ -21,8 +21,8 @@ export interface DeletePublicAccessBlockCommandOutput extends __MetadataBearer {
|
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Removes the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket. To use this
|
|
23
23
|
* operation, you must have the <code>s3:PutBucketPublicAccessBlock</code> permission. For
|
|
24
|
-
* 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
|
|
25
|
-
* Resources</a>.</p>
|
|
24
|
+
* 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
|
|
25
|
+
* Access Permissions to Your Amazon S3 Resources</a>.</p>
|
|
26
26
|
* <p>The following operations are related to <code>DeletePublicAccessBlock</code>:</p>
|
|
27
27
|
* <ul>
|
|
28
28
|
* <li>
|
|
@@ -26,18 +26,17 @@ export interface GetBucketAccelerateConfigurationCommandOutput extends GetBucket
|
|
|
26
26
|
* <p>To use this operation, you must have permission to perform the
|
|
27
27
|
* <code>s3:GetAccelerateConfiguration</code> action. The bucket owner has this permission
|
|
28
28
|
* by default. The bucket owner can grant this permission to others. For more information
|
|
29
|
-
* 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
|
|
30
|
-
*
|
|
29
|
+
* 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
|
|
30
|
+
* Access Permissions to your Amazon S3 Resources</a> in the
|
|
31
|
+
* <i>Amazon S3 User Guide</i>.</p>
|
|
31
32
|
* <p>You set the Transfer Acceleration state of an existing bucket to <code>Enabled</code> or
|
|
32
33
|
* <code>Suspended</code> by using the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAccelerateConfiguration.html">PutBucketAccelerateConfiguration</a> operation. </p>
|
|
33
34
|
* <p>A GET <code>accelerate</code> request does not return a state value for a bucket that
|
|
34
35
|
* has no transfer acceleration state. A bucket has no Transfer Acceleration state if a state
|
|
35
36
|
* has never been set on the bucket. </p>
|
|
36
|
-
* <p>For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer Acceleration</a> in
|
|
37
|
-
* Amazon S3 User Guide.</p>
|
|
38
|
-
* <p
|
|
39
|
-
* <b>Related Resources</b>
|
|
40
|
-
* </p>
|
|
37
|
+
* <p>For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer Acceleration</a> in
|
|
38
|
+
* the Amazon S3 User Guide.</p>
|
|
39
|
+
* <p>The following operations are related to <code>GetBucketAccelerateConfiguration</code>:</p>
|
|
41
40
|
* <ul>
|
|
42
41
|
* <li>
|
|
43
42
|
* <p>
|
|
@@ -19,21 +19,25 @@ export interface GetBucketAclCommandOutput extends GetBucketAclOutput, __Metadat
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
|
-
* <p>This implementation of the <code>GET</code> action uses the <code>acl</code>
|
|
23
|
-
*
|
|
24
|
-
*
|
|
22
|
+
* <p>This implementation of the <code>GET</code> action uses the <code>acl</code> subresource
|
|
23
|
+
* to return the access control list (ACL) of a bucket. To use <code>GET</code> to return the
|
|
24
|
+
* ACL of the bucket, you must have <code>READ_ACP</code> access to the bucket. If
|
|
25
25
|
* <code>READ_ACP</code> permission is granted to the anonymous user, you can return the
|
|
26
26
|
* ACL of the bucket without using an authorization header.</p>
|
|
27
|
+
* <p>To use this API operation against an access point, provide the alias of the access point in place of the bucket name.</p>
|
|
28
|
+
* <p>To use this API operation against an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name.
|
|
29
|
+
* If the Object Lambda access point alias in a request is not valid, the error code <code>InvalidAccessPointAliasError</code> is returned.
|
|
30
|
+
* For more information about <code>InvalidAccessPointAliasError</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">List of
|
|
31
|
+
* Error Codes</a>.</p>
|
|
27
32
|
* <note>
|
|
28
33
|
* <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership,
|
|
29
|
-
* requests to read ACLs are still supported and return the
|
|
30
|
-
*
|
|
31
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">
|
|
32
|
-
*
|
|
34
|
+
* requests to read ACLs are still supported and return the
|
|
35
|
+
* <code>bucket-owner-full-control</code> ACL with the owner being the account that
|
|
36
|
+
* created the bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling object
|
|
37
|
+
* ownership and disabling ACLs</a> in the
|
|
38
|
+
* <i>Amazon S3 User Guide</i>.</p>
|
|
33
39
|
* </note>
|
|
34
|
-
* <p
|
|
35
|
-
* <b>Related Resources</b>
|
|
36
|
-
* </p>
|
|
40
|
+
* <p>The following operations are related to <code>GetBucketAcl</code>:</p>
|
|
37
41
|
* <ul>
|
|
38
42
|
* <li>
|
|
39
43
|
* <p>
|
|
@@ -19,18 +19,17 @@ export interface GetBucketAnalyticsConfigurationCommandOutput extends GetBucketA
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
|
-
* <p>This implementation of the GET action returns an analytics configuration (identified
|
|
23
|
-
*
|
|
22
|
+
* <p>This implementation of the GET action returns an analytics configuration (identified by
|
|
23
|
+
* the analytics configuration ID) from the bucket.</p>
|
|
24
24
|
* <p>To use this operation, you must have permissions to perform the
|
|
25
25
|
* <code>s3:GetAnalyticsConfiguration</code> action. The bucket owner has this permission
|
|
26
26
|
* by default. The bucket owner can grant this permission to others. For more information
|
|
27
|
-
* 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
|
|
28
|
-
*
|
|
27
|
+
* 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
|
|
28
|
+
* Access Permissions to Your Amazon S3 Resources</a> in the
|
|
29
|
+
* <i>Amazon S3 User Guide</i>. </p>
|
|
29
30
|
* <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
|
|
30
31
|
* Analysis</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
31
|
-
* <p
|
|
32
|
-
* <b>Related Resources</b>
|
|
33
|
-
* </p>
|
|
32
|
+
* <p>The following operations are related to <code>GetBucketAnalyticsConfiguration</code>:</p>
|
|
34
33
|
* <ul>
|
|
35
34
|
* <li>
|
|
36
35
|
* <p>
|
|
@@ -24,6 +24,11 @@ export interface GetBucketCorsCommandOutput extends GetBucketCorsOutput, __Metad
|
|
|
24
24
|
* <p> To use this operation, you must have permission to perform the
|
|
25
25
|
* <code>s3:GetBucketCORS</code> action. By default, the bucket owner has this permission
|
|
26
26
|
* and can grant it to others.</p>
|
|
27
|
+
* <p>To use this API operation against an access point, provide the alias of the access point in place of the bucket name.</p>
|
|
28
|
+
* <p>To use this API operation against an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name.
|
|
29
|
+
* If the Object Lambda access point alias in a request is not valid, the error code <code>InvalidAccessPointAliasError</code> is returned.
|
|
30
|
+
* For more information about <code>InvalidAccessPointAliasError</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">List of
|
|
31
|
+
* Error Codes</a>.</p>
|
|
27
32
|
* <p> For more information about CORS, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html"> Enabling Cross-Origin Resource
|
|
28
33
|
* Sharing</a>.</p>
|
|
29
34
|
* <p>The following operations are related to <code>GetBucketCors</code>:</p>
|
|
@@ -19,15 +19,15 @@ export interface GetBucketEncryptionCommandOutput extends GetBucketEncryptionOut
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
|
-
* <p>Returns the default encryption configuration for an Amazon S3 bucket.
|
|
23
|
-
*
|
|
24
|
-
* <
|
|
25
|
-
*
|
|
26
|
-
* <p>
|
|
22
|
+
* <p>Returns the default encryption configuration for an Amazon S3 bucket. By default, all buckets have a default encryption configuration that
|
|
23
|
+
* uses server-side encryption with Amazon S3 managed keys (SSE-S3). For information
|
|
24
|
+
* about the bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket
|
|
25
|
+
* Default Encryption</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
26
|
+
* <p>To use this operation, you must have permission to perform the
|
|
27
27
|
* <code>s3:GetEncryptionConfiguration</code> action. The bucket owner has this permission
|
|
28
28
|
* by default. The bucket owner can grant this permission to others. For more information
|
|
29
|
-
* 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
|
|
30
|
-
* Resources</a>.</p>
|
|
29
|
+
* 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
|
|
30
|
+
* Access Permissions to Your Amazon S3 Resources</a>.</p>
|
|
31
31
|
* <p>The following operations are related to <code>GetBucketEncryption</code>:</p>
|
|
32
32
|
* <ul>
|
|
33
33
|
* <li>
|
|
@@ -23,8 +23,7 @@ export interface GetBucketIntelligentTieringConfigurationCommandOutput extends G
|
|
|
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
|
|
27
|
-
* <code>GetBucketIntelligentTieringConfiguration</code> include: </p>
|
|
26
|
+
* <p>Operations related to <code>GetBucketIntelligentTieringConfiguration</code> include: </p>
|
|
28
27
|
* <ul>
|
|
29
28
|
* <li>
|
|
30
29
|
* <p>
|
|
@@ -24,8 +24,8 @@ export interface GetBucketInventoryConfigurationCommandOutput extends GetBucketI
|
|
|
24
24
|
* <p>To use this operation, you must have permissions to perform the
|
|
25
25
|
* <code>s3:GetInventoryConfiguration</code> action. The bucket owner has this permission
|
|
26
26
|
* by default and can grant this permission to others. For more information about permissions,
|
|
27
|
-
* 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
|
|
28
|
-
* Resources</a>.</p>
|
|
27
|
+
* 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
|
|
28
|
+
* Access Permissions to Your Amazon S3 Resources</a>.</p>
|
|
29
29
|
* <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>.</p>
|
|
30
30
|
* <p>The following operations are related to
|
|
31
31
|
* <code>GetBucketInventoryConfiguration</code>:</p>
|
|
@@ -28,13 +28,13 @@ export interface GetBucketLifecycleConfigurationCommandOutput extends GetBucketL
|
|
|
28
28
|
* works. For the earlier action, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html">GetBucketLifecycle</a>.</p>
|
|
29
29
|
* </note>
|
|
30
30
|
* <p>Returns the lifecycle configuration information set on the bucket. For information about
|
|
31
|
-
* lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object
|
|
32
|
-
*
|
|
31
|
+
* lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle
|
|
32
|
+
* Management</a>.</p>
|
|
33
33
|
* <p>To use this operation, you must have permission to perform the
|
|
34
34
|
* <code>s3:GetLifecycleConfiguration</code> action. The bucket owner has this permission,
|
|
35
35
|
* by default. The bucket owner can grant this permission to others. For more information
|
|
36
|
-
* 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
|
|
37
|
-
* Resources</a>.</p>
|
|
36
|
+
* 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
|
|
37
|
+
* Access Permissions to Your Amazon S3 Resources</a>.</p>
|
|
38
38
|
* <p>
|
|
39
39
|
* <code>GetBucketLifecycleConfiguration</code> has the following special error:</p>
|
|
40
40
|
* <ul>
|