@aws-sdk/client-s3 3.697.0 → 3.699.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.
Files changed (103) hide show
  1. package/dist-cjs/index.js +152 -5
  2. package/dist-es/models/models_1.js +48 -0
  3. package/dist-es/protocols/Aws_restXml.js +75 -4
  4. package/dist-types/commands/AbortMultipartUploadCommand.d.ts +16 -13
  5. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +47 -42
  6. package/dist-types/commands/CopyObjectCommand.d.ts +77 -57
  7. package/dist-types/commands/CreateBucketCommand.d.ts +60 -45
  8. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +92 -66
  9. package/dist-types/commands/CreateSessionCommand.d.ts +30 -16
  10. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +1 -1
  11. package/dist-types/commands/DeleteBucketCommand.d.ts +10 -3
  12. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +1 -1
  13. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +18 -10
  14. package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  15. package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +1 -1
  16. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +52 -9
  17. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +1 -1
  18. package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +1 -1
  19. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +25 -21
  20. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +1 -1
  21. package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +1 -1
  22. package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +1 -1
  23. package/dist-types/commands/DeleteObjectCommand.d.ts +3 -0
  24. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +1 -1
  25. package/dist-types/commands/DeleteObjectsCommand.d.ts +41 -27
  26. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +1 -1
  27. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +1 -1
  28. package/dist-types/commands/GetBucketAclCommand.d.ts +1 -1
  29. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +1 -1
  30. package/dist-types/commands/GetBucketCorsCommand.d.ts +1 -1
  31. package/dist-types/commands/GetBucketEncryptionCommand.d.ts +18 -10
  32. package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  33. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +1 -1
  34. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +61 -17
  35. package/dist-types/commands/GetBucketLocationCommand.d.ts +1 -1
  36. package/dist-types/commands/GetBucketLoggingCommand.d.ts +1 -1
  37. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +1 -1
  38. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +1 -1
  39. package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +1 -1
  40. package/dist-types/commands/GetBucketPolicyCommand.d.ts +30 -21
  41. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +1 -1
  42. package/dist-types/commands/GetBucketReplicationCommand.d.ts +1 -1
  43. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +1 -1
  44. package/dist-types/commands/GetBucketTaggingCommand.d.ts +1 -1
  45. package/dist-types/commands/GetBucketVersioningCommand.d.ts +1 -1
  46. package/dist-types/commands/GetBucketWebsiteCommand.d.ts +1 -1
  47. package/dist-types/commands/GetObjectAclCommand.d.ts +1 -1
  48. package/dist-types/commands/GetObjectAttributesCommand.d.ts +62 -44
  49. package/dist-types/commands/GetObjectCommand.d.ts +79 -60
  50. package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +1 -1
  51. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +1 -1
  52. package/dist-types/commands/GetObjectRetentionCommand.d.ts +1 -1
  53. package/dist-types/commands/GetObjectTaggingCommand.d.ts +1 -1
  54. package/dist-types/commands/GetObjectTorrentCommand.d.ts +1 -1
  55. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +1 -1
  56. package/dist-types/commands/HeadBucketCommand.d.ts +32 -16
  57. package/dist-types/commands/HeadObjectCommand.d.ts +60 -38
  58. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +1 -1
  59. package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +1 -1
  60. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +1 -1
  61. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +1 -1
  62. package/dist-types/commands/ListBucketsCommand.d.ts +6 -6
  63. package/dist-types/commands/ListDirectoryBucketsCommand.d.ts +10 -4
  64. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +50 -33
  65. package/dist-types/commands/ListObjectVersionsCommand.d.ts +1 -1
  66. package/dist-types/commands/ListObjectsCommand.d.ts +1 -1
  67. package/dist-types/commands/ListObjectsV2Command.d.ts +23 -14
  68. package/dist-types/commands/ListPartsCommand.d.ts +22 -17
  69. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +1 -1
  70. package/dist-types/commands/PutBucketAclCommand.d.ts +1 -1
  71. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +1 -1
  72. package/dist-types/commands/PutBucketCorsCommand.d.ts +1 -1
  73. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +47 -32
  74. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  75. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +1 -1
  76. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +84 -45
  77. package/dist-types/commands/PutBucketLoggingCommand.d.ts +1 -1
  78. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +1 -1
  79. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +1 -1
  80. package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +1 -1
  81. package/dist-types/commands/PutBucketPolicyCommand.d.ts +30 -21
  82. package/dist-types/commands/PutBucketReplicationCommand.d.ts +3 -4
  83. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +1 -1
  84. package/dist-types/commands/PutBucketTaggingCommand.d.ts +1 -1
  85. package/dist-types/commands/PutBucketVersioningCommand.d.ts +3 -6
  86. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +1 -1
  87. package/dist-types/commands/PutObjectAclCommand.d.ts +1 -1
  88. package/dist-types/commands/PutObjectCommand.d.ts +83 -35
  89. package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +1 -1
  90. package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +3 -3
  91. package/dist-types/commands/PutObjectRetentionCommand.d.ts +2 -2
  92. package/dist-types/commands/PutObjectTaggingCommand.d.ts +1 -1
  93. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -1
  94. package/dist-types/commands/RestoreObjectCommand.d.ts +1 -1
  95. package/dist-types/commands/SelectObjectContentCommand.d.ts +1 -1
  96. package/dist-types/commands/UploadPartCommand.d.ts +52 -41
  97. package/dist-types/commands/UploadPartCopyCommand.d.ts +53 -39
  98. package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +1 -1
  99. package/dist-types/models/models_0.d.ts +938 -632
  100. package/dist-types/models/models_1.d.ts +230 -135
  101. package/dist-types/ts3.4/models/models_0.d.ts +7 -0
  102. package/dist-types/ts3.4/models/models_1.d.ts +24 -0
  103. package/package.json +4 -4
@@ -27,8 +27,7 @@ declare const DeleteBucketPolicyCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Deletes the
31
- * policy of a specified bucket.</p>
30
+ * <p>Deletes the policy of a specified bucket.</p>
32
31
  * <note>
33
32
  * <p>
34
33
  * <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region_code</i>.amazonaws.com/<i>bucket-name</i>
@@ -39,33 +38,38 @@ declare const DeleteBucketPolicyCommand_base: {
39
38
  * <dl>
40
39
  * <dt>Permissions</dt>
41
40
  * <dd>
42
- * <p>If you are using an identity other than the
43
- * root user of the Amazon Web Services account that owns the bucket, the calling identity must both have the
44
- * <code>DeleteBucketPolicy</code> permissions on the specified bucket and belong to the
45
- * bucket owner's account in order to use this operation.</p>
46
- * <p>If you don't have <code>DeleteBucketPolicy</code> permissions, Amazon S3 returns a <code>403
47
- * Access Denied</code> error. If you have the correct permissions, but you're not using an
48
- * identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
49
- * Allowed</code> error.</p>
41
+ * <p>If you are using an identity other than the root user of the Amazon Web Services account that
42
+ * owns the bucket, the calling identity must both have the
43
+ * <code>DeleteBucketPolicy</code> permissions on the specified bucket and belong
44
+ * to the bucket owner's account in order to use this operation.</p>
45
+ * <p>If you don't have <code>DeleteBucketPolicy</code> permissions, Amazon S3 returns a
46
+ * <code>403 Access Denied</code> error. If you have the correct permissions, but
47
+ * you're not using an identity that belongs to the bucket owner's account, Amazon S3
48
+ * returns a <code>405 Method Not Allowed</code> error.</p>
50
49
  * <important>
51
- * <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
52
- * buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
53
- * <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
54
- * <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
55
- * denies the root principal's access. Bucket owner root principals can only be blocked
56
- * from performing these API actions by VPC endpoint policies and Amazon Web Services Organizations
57
- * policies.</p>
50
+ * <p>To ensure that bucket owners don't inadvertently lock themselves out of
51
+ * their own buckets, the root principal in a bucket owner's Amazon Web Services account can
52
+ * perform the <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
53
+ * <code>DeleteBucketPolicy</code> API actions, even if their bucket policy
54
+ * explicitly denies the root principal's access. Bucket owner root principals can
55
+ * only be blocked from performing these API actions by VPC endpoint policies and
56
+ * Amazon Web Services Organizations policies.</p>
58
57
  * </important>
59
58
  * <ul>
60
59
  * <li>
61
60
  * <p>
62
- * <b>General purpose bucket permissions</b> - The <code>s3:DeleteBucketPolicy</code> permission is required in a policy.
63
- * For more information about general purpose buckets bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
64
- * Policies</a> in the <i>Amazon S3 User Guide</i>.</p>
61
+ * <b>General purpose bucket permissions</b> - The
62
+ * <code>s3:DeleteBucketPolicy</code> permission is required in a policy.
63
+ * For more information about general purpose buckets bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User Policies</a> in the
64
+ * <i>Amazon S3 User Guide</i>.</p>
65
65
  * </li>
66
66
  * <li>
67
67
  * <p>
68
- * <b>Directory bucket permissions</b> - To grant access to this API operation, you must have the <code>s3express:DeleteBucketPolicy</code> permission in an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource. For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
68
+ * <b>Directory bucket permissions</b> -
69
+ * To grant access to this API operation, you must have the
70
+ * <code>s3express:DeleteBucketPolicy</code> permission in
71
+ * an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
72
+ * For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
69
73
  * </li>
70
74
  * </ul>
71
75
  * </dd>
@@ -28,7 +28,7 @@ declare const DeleteBucketReplicationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p> Deletes the replication configuration from the bucket.</p>
34
34
  * <p>To use this operation, you must have permissions to perform the
@@ -28,7 +28,7 @@ declare const DeleteBucketTaggingCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Deletes the tags from the bucket.</p>
34
34
  * <p>To use this operation, you must have permission to perform the
@@ -28,7 +28,7 @@ declare const DeleteBucketWebsiteCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>This action removes the website configuration for a bucket. Amazon S3 returns a <code>200
34
34
  * OK</code> response upon successfully deleting a website configuration on the specified
@@ -131,6 +131,9 @@ declare const DeleteObjectCommand_base: {
131
131
  * RequestPayer: "requester",
132
132
  * BypassGovernanceRetention: true || false,
133
133
  * ExpectedBucketOwner: "STRING_VALUE",
134
+ * IfMatch: "STRING_VALUE",
135
+ * IfMatchLastModifiedTime: new Date("TIMESTAMP"),
136
+ * IfMatchSize: Number("long"),
134
137
  * };
135
138
  * const command = new DeleteObjectCommand(input);
136
139
  * const response = await client.send(command);
@@ -28,7 +28,7 @@ declare const DeleteObjectTaggingCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Removes the entire tag set from the specified object. For more information about
34
34
  * managing object tags, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html"> Object Tagging</a>.</p>
@@ -28,44 +28,46 @@ declare const DeleteObjectsCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <p>This operation enables you to delete multiple objects from a bucket using a single HTTP
31
- * request. If you know the object keys that you want to delete, then this operation provides a
32
- * suitable alternative to sending individual delete requests, reducing per-request
31
+ * request. If you know the object keys that you want to delete, then this operation provides
32
+ * a suitable alternative to sending individual delete requests, reducing per-request
33
33
  * overhead.</p>
34
- * <p>The request can contain a list of up to 1000 keys that you want to delete. In the XML, you
35
- * provide the object key names, and optionally, version IDs if you want to delete a specific
36
- * version of the object from a versioning-enabled bucket. For each key, Amazon S3 performs a
37
- * delete operation and returns the result of that delete, success or failure, in the response.
38
- * Note that if the object specified in the request is not found, Amazon S3 returns the result as
39
- * deleted.</p>
34
+ * <p>The request can contain a list of up to 1000 keys that you want to delete. In the XML,
35
+ * you provide the object key names, and optionally, version IDs if you want to delete a
36
+ * specific version of the object from a versioning-enabled bucket. For each key, Amazon S3
37
+ * performs a delete operation and returns the result of that delete, success or failure, in
38
+ * the response. Note that if the object specified in the request is not found, Amazon S3 returns
39
+ * the result as deleted.</p>
40
40
  * <note>
41
41
  * <ul>
42
42
  * <li>
43
43
  * <p>
44
- * <b>Directory buckets</b> - S3 Versioning isn't enabled and supported for directory buckets.</p>
44
+ * <b>Directory buckets</b> -
45
+ * S3 Versioning isn't enabled and supported for directory buckets.</p>
45
46
  * </li>
46
47
  * <li>
47
48
  * <p>
48
- * <b>Directory buckets</b> - For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
49
+ * <b>Directory buckets</b> -
50
+ * For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
49
51
  * </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
50
52
  * <i>Amazon S3 User Guide</i>.</p>
51
53
  * </li>
52
54
  * </ul>
53
55
  * </note>
54
56
  * <p>The operation supports two modes for the response: verbose and quiet. By default, the
55
- * operation uses verbose mode in which the response includes the result of deletion of each key
56
- * in your request. In quiet mode the response includes only keys where the delete operation
57
- * encountered an error. For a successful deletion in a quiet mode, the operation does not return any information
58
- * about the delete in the response body.</p>
57
+ * operation uses verbose mode in which the response includes the result of deletion of each
58
+ * key in your request. In quiet mode the response includes only keys where the delete
59
+ * operation encountered an error. For a successful deletion in a quiet mode, the operation
60
+ * does not return any information about the delete in the response body.</p>
59
61
  * <p>When performing this action on an MFA Delete enabled bucket, that attempts to delete any
60
62
  * versioned objects, you must include an MFA token. If you do not provide one, the entire
61
63
  * request will fail, even if there are non-versioned objects you are trying to delete. If you
62
64
  * provide an invalid token, whether there are versioned keys in the request or not, the
63
65
  * 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
64
- * Delete</a> in the <i>Amazon S3
65
- * User Guide</i>.</p>
66
+ * Delete</a> in the <i>Amazon S3 User Guide</i>.</p>
66
67
  * <note>
67
68
  * <p>
68
- * <b>Directory buckets</b> - MFA delete is not supported by directory buckets.</p>
69
+ * <b>Directory buckets</b> -
70
+ * MFA delete is not supported by directory buckets.</p>
69
71
  * </note>
70
72
  * <dl>
71
73
  * <dt>Permissions</dt>
@@ -73,20 +75,25 @@ declare const DeleteObjectsCommand_base: {
73
75
  * <ul>
74
76
  * <li>
75
77
  * <p>
76
- * <b>General purpose bucket permissions</b> - The following permissions are required in your policies when your
77
- * <code>DeleteObjects</code> request includes specific headers.</p>
78
+ * <b>General purpose bucket permissions</b> - The
79
+ * following permissions are required in your policies when your
80
+ * <code>DeleteObjects</code> request includes specific headers.</p>
78
81
  * <ul>
79
82
  * <li>
80
83
  * <p>
81
84
  * <b>
82
85
  * <code>s3:DeleteObject</code>
83
- * </b> - To delete an object from a bucket, you must always specify the <code>s3:DeleteObject</code> permission.</p>
86
+ * </b>
87
+ * - To delete an object from a bucket, you must always specify
88
+ * the <code>s3:DeleteObject</code> permission.</p>
84
89
  * </li>
85
90
  * <li>
86
91
  * <p>
87
92
  * <b>
88
93
  * <code>s3:DeleteObjectVersion</code>
89
- * </b> - To delete a specific version of an object from a versioning-enabled bucket, you must specify the <code>s3:DeleteObjectVersion</code> permission.</p>
94
+ * </b> - To delete a specific version of an object from a
95
+ * versioning-enabled bucket, you must specify the
96
+ * <code>s3:DeleteObjectVersion</code> permission.</p>
90
97
  * </li>
91
98
  * </ul>
92
99
  * </li>
@@ -106,15 +113,19 @@ declare const DeleteObjectsCommand_base: {
106
113
  * <ul>
107
114
  * <li>
108
115
  * <p>
109
- * <b>General purpose bucket</b> - The Content-MD5 request header is required for all Multi-Object Delete requests. Amazon S3
110
- * uses the header value to ensure that your request body has not been altered in
111
- * transit.</p>
116
+ * <b>General purpose bucket</b> - The Content-MD5
117
+ * request header is required for all Multi-Object Delete requests. Amazon S3 uses
118
+ * the header value to ensure that your request body has not been altered in
119
+ * transit.</p>
112
120
  * </li>
113
121
  * <li>
114
122
  * <p>
115
- * <b>Directory bucket</b> - The Content-MD5 request header or a additional checksum request header
116
- * (including <code>x-amz-checksum-crc32</code>, <code>x-amz-checksum-crc32c</code>, <code>x-amz-checksum-sha1</code>, or
117
- * <code>x-amz-checksum-sha256</code>) is required for all Multi-Object Delete requests.</p>
123
+ * <b>Directory bucket</b> - The
124
+ * Content-MD5 request header or a additional checksum request header
125
+ * (including <code>x-amz-checksum-crc32</code>,
126
+ * <code>x-amz-checksum-crc32c</code>, <code>x-amz-checksum-sha1</code>, or
127
+ * <code>x-amz-checksum-sha256</code>) is required for all Multi-Object
128
+ * Delete requests.</p>
118
129
  * </li>
119
130
  * </ul>
120
131
  * </dd>
@@ -166,6 +177,9 @@ declare const DeleteObjectsCommand_base: {
166
177
  * { // ObjectIdentifier
167
178
  * Key: "STRING_VALUE", // required
168
179
  * VersionId: "STRING_VALUE",
180
+ * ETag: "STRING_VALUE",
181
+ * LastModifiedTime: new Date("TIMESTAMP"),
182
+ * Size: Number("long"),
169
183
  * },
170
184
  * ],
171
185
  * Quiet: true || false,
@@ -28,7 +28,7 @@ declare const DeletePublicAccessBlockCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Removes the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket. To use this
34
34
  * operation, you must have the <code>s3:PutBucketPublicAccessBlock</code> permission. For
@@ -28,7 +28,7 @@ declare const GetBucketAccelerateConfigurationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>This implementation of the GET action uses the <code>accelerate</code> subresource to
34
34
  * return the Transfer Acceleration state of a bucket, which is either <code>Enabled</code> or
@@ -28,7 +28,7 @@ declare const GetBucketAclCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>This implementation of the <code>GET</code> action uses the <code>acl</code> subresource
34
34
  * to return the access control list (ACL) of a bucket. To use <code>GET</code> to return the
@@ -28,7 +28,7 @@ declare const GetBucketAnalyticsConfigurationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>This implementation of the GET action returns an analytics configuration (identified by
34
34
  * the analytics configuration ID) from the bucket.</p>
@@ -28,7 +28,7 @@ declare const GetBucketCorsCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Returns the Cross-Origin Resource Sharing (CORS) configuration information set for the
34
34
  * bucket.</p>
@@ -34,13 +34,16 @@ declare const GetBucketEncryptionCommand_base: {
34
34
  * <ul>
35
35
  * <li>
36
36
  * <p>
37
- * <b>General purpose buckets</b> - For information about the bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket
38
- * Default Encryption</a> in the <i>Amazon S3 User Guide</i>.</p>
37
+ * <b>General purpose buckets</b> - For information
38
+ * about the bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket Default
39
+ * Encryption</a> in the <i>Amazon S3 User Guide</i>.</p>
39
40
  * </li>
40
41
  * <li>
41
42
  * <p>
42
- * <b>Directory buckets</b> - For directory buckets, there are only two supported options for server-side encryption: SSE-S3 and SSE-KMS. For information about the default encryption configuration in directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-bucket-encryption.html">Setting default server-side encryption behavior
43
- * for directory buckets</a>.</p>
43
+ * <b>Directory buckets</b> -
44
+ * For directory buckets, there are only two supported options for server-side encryption: SSE-S3 and SSE-KMS. For information about the default encryption
45
+ * configuration in directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-bucket-encryption.html">Setting
46
+ * default server-side encryption behavior for directory buckets</a>.</p>
44
47
  * </li>
45
48
  * </ul>
46
49
  * </note>
@@ -50,15 +53,20 @@ declare const GetBucketEncryptionCommand_base: {
50
53
  * <ul>
51
54
  * <li>
52
55
  * <p>
53
- * <b>General purpose bucket permissions</b> - The <code>s3:GetEncryptionConfiguration</code> permission is required in a policy.
54
- * The bucket owner has this permission
55
- * by default. The bucket owner can grant this permission to others. For more information
56
- * 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 Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
57
- * Access Permissions to Your Amazon S3 Resources</a>.</p>
56
+ * <b>General purpose bucket permissions</b> - The
57
+ * <code>s3:GetEncryptionConfiguration</code> permission is required in a
58
+ * policy. The bucket owner has this permission by default. The bucket owner
59
+ * can grant this permission to others. For more information about permissions,
60
+ * 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 Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access
61
+ * Permissions to Your Amazon S3 Resources</a>.</p>
58
62
  * </li>
59
63
  * <li>
60
64
  * <p>
61
- * <b>Directory bucket permissions</b> - To grant access to this API operation, you must have the <code>s3express:GetEncryptionConfiguration</code> permission in an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource. For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
65
+ * <b>Directory bucket permissions</b> -
66
+ * To grant access to this API operation, you must have the
67
+ * <code>s3express:GetEncryptionConfiguration</code> permission in
68
+ * an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
69
+ * For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
62
70
  * </li>
63
71
  * </ul>
64
72
  * </dd>
@@ -28,7 +28,7 @@ declare const GetBucketIntelligentTieringConfigurationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Gets the S3 Intelligent-Tiering configuration from the specified bucket.</p>
34
34
  * <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>
@@ -28,7 +28,7 @@ declare const GetBucketInventoryConfigurationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Returns an inventory configuration (identified by the inventory configuration ID) from
34
34
  * the bucket.</p>
@@ -27,25 +27,69 @@ declare const GetBucketLifecycleConfigurationCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
32
- * </note>
33
- * <note>
34
- * <p>Bucket lifecycle configuration now supports specifying a lifecycle rule using an object key name prefix, one or more object tags, object size, or any combination of these. Accordingly, this section describes the latest API. The previous version of the API supported filtering based only on an object key name prefix, which is supported for backward compatibility.
35
- * For the related API description, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html">GetBucketLifecycle</a>. Accordingly,
36
- * this section describes the latest API. The response describes the new filter element
37
- * that you can use to specify a filter to select a subset of objects to which the rule
38
- * applies. If you are using a previous version of the lifecycle configuration, it still
39
- * works. For the earlier action, </p>
40
- * </note>
41
- * <p>Returns the lifecycle configuration information set on the bucket. For information about
30
+ * <p>Returns the lifecycle configuration information set on the bucket. For information about
42
31
  * lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle
43
32
  * Management</a>.</p>
44
- * <p>To use this operation, you must have permission to perform the
45
- * <code>s3:GetLifecycleConfiguration</code> action. The bucket owner has this permission,
46
- * by default. The bucket owner can grant this permission to others. For more information
47
- * 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
48
- * Access Permissions to Your Amazon S3 Resources</a>.</p>
33
+ * <p>Bucket lifecycle configuration now supports specifying a lifecycle rule using an object
34
+ * key name prefix, one or more object tags, object size, or any combination of these.
35
+ * Accordingly, this section describes the latest API, which is compatible with the new
36
+ * functionality. The previous version of the API supported filtering based only on an object
37
+ * key name prefix, which is supported for general purpose buckets for backward compatibility.
38
+ * For the related API description, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html">GetBucketLifecycle</a>.</p>
39
+ * <note>
40
+ * <p>Lifecyle configurations for directory buckets only support expiring objects and
41
+ * cancelling multipart uploads. Expiring of versioned objects, transitions and tag filters
42
+ * are not supported.</p>
43
+ * </note>
44
+ * <dl>
45
+ * <dt>Permissions</dt>
46
+ * <dd>
47
+ * <ul>
48
+ * <li>
49
+ * <p>
50
+ * <b>General purpose bucket permissions</b> - By
51
+ * default, all Amazon S3 resources are private, including buckets, objects, and
52
+ * related subresources (for example, lifecycle configuration and website
53
+ * configuration). Only the resource owner (that is, the Amazon Web Services account that
54
+ * created it) can access the resource. The resource owner can optionally grant
55
+ * access permissions to others by writing an access policy. For this
56
+ * operation, a user must have the <code>s3:GetLifecycleConfiguration</code>
57
+ * permission.</p>
58
+ * <p>For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access
59
+ * Permissions to Your Amazon S3 Resources</a>.</p>
60
+ * </li>
61
+ * </ul>
62
+ * <ul>
63
+ * <li>
64
+ * <p>
65
+ * <b>Directory bucket permissions</b> -
66
+ * You must have the <code>s3express:GetLifecycleConfiguration</code>
67
+ * permission in an IAM identity-based policy to use this operation.
68
+ * Cross-account access to this API operation isn't supported. The resource
69
+ * owner can optionally grant access permissions to others by creating a role
70
+ * or user for them as long as they are within the same account as the owner
71
+ * and resource.</p>
72
+ * <p>For more information about directory bucket policies and permissions, see
73
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Authorizing Regional endpoint APIs with IAM</a> in the
74
+ * <i>Amazon S3 User Guide</i>.</p>
75
+ * <note>
76
+ * <p>
77
+ * <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region_code</i>.amazonaws.com/<i>bucket-name</i>
78
+ * </code>. Virtual-hosted-style requests aren't supported.
79
+ * For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
80
+ * <i>Amazon S3 User Guide</i>.</p>
81
+ * </note>
82
+ * </li>
83
+ * </ul>
84
+ * </dd>
85
+ * <dt>HTTP Host header syntax</dt>
86
+ * <dd>
87
+ * <p>
88
+ * <b>Directory buckets </b> - The HTTP Host
89
+ * header syntax is
90
+ * <code>s3express-control.<i>region</i>.amazonaws.com</code>.</p>
91
+ * </dd>
92
+ * </dl>
49
93
  * <p>
50
94
  * <code>GetBucketLifecycleConfiguration</code> has the following special error:</p>
51
95
  * <ul>
@@ -28,7 +28,7 @@ declare const GetBucketLocationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Returns the Region the bucket resides in. You set the bucket's Region using the
34
34
  * <code>LocationConstraint</code> request parameter in a <code>CreateBucket</code>
@@ -28,7 +28,7 @@ declare const GetBucketLoggingCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Returns the logging status of a bucket and the permissions users have to view and modify
34
34
  * that status.</p>
@@ -28,7 +28,7 @@ declare const GetBucketMetricsConfigurationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Gets a metrics configuration (specified by the metrics configuration ID) from the
34
34
  * bucket. Note that this doesn't include the daily storage metrics.</p>
@@ -28,7 +28,7 @@ declare const GetBucketNotificationConfigurationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Returns the notification configuration of a bucket.</p>
34
34
  * <p>If notifications are not enabled on the bucket, the action returns an empty
@@ -28,7 +28,7 @@ declare const GetBucketOwnershipControlsCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Retrieves <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you
34
34
  * must have the <code>s3:GetBucketOwnershipControls</code> permission. For more information
@@ -38,42 +38,51 @@ declare const GetBucketPolicyCommand_base: {
38
38
  * <dl>
39
39
  * <dt>Permissions</dt>
40
40
  * <dd>
41
- * <p>If you are using an identity other than the
42
- * root user of the Amazon Web Services account that owns the bucket, the calling identity must both have the
43
- * <code>GetBucketPolicy</code> permissions on the specified bucket and belong to the
44
- * bucket owner's account in order to use this operation.</p>
45
- * <p>If you don't have <code>GetBucketPolicy</code> permissions, Amazon S3 returns a <code>403
46
- * Access Denied</code> error. If you have the correct permissions, but you're not using an
47
- * identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
48
- * Allowed</code> error.</p>
41
+ * <p>If you are using an identity other than the root user of the Amazon Web Services account that
42
+ * owns the bucket, the calling identity must both have the
43
+ * <code>GetBucketPolicy</code> permissions on the specified bucket and belong to
44
+ * the bucket owner's account in order to use this operation.</p>
45
+ * <p>If you don't have <code>GetBucketPolicy</code> permissions, Amazon S3 returns a
46
+ * <code>403 Access Denied</code> error. If you have the correct permissions, but
47
+ * you're not using an identity that belongs to the bucket owner's account, Amazon S3
48
+ * returns a <code>405 Method Not Allowed</code> error.</p>
49
49
  * <important>
50
- * <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
51
- * buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
52
- * <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
53
- * <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
54
- * denies the root principal's access. Bucket owner root principals can only be blocked
55
- * from performing these API actions by VPC endpoint policies and Amazon Web Services Organizations
56
- * policies.</p>
50
+ * <p>To ensure that bucket owners don't inadvertently lock themselves out of
51
+ * their own buckets, the root principal in a bucket owner's Amazon Web Services account can
52
+ * perform the <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
53
+ * <code>DeleteBucketPolicy</code> API actions, even if their bucket policy
54
+ * explicitly denies the root principal's access. Bucket owner root principals can
55
+ * only be blocked from performing these API actions by VPC endpoint policies and
56
+ * Amazon Web Services Organizations policies.</p>
57
57
  * </important>
58
58
  * <ul>
59
59
  * <li>
60
60
  * <p>
61
- * <b>General purpose bucket permissions</b> - The <code>s3:GetBucketPolicy</code> permission is required in a policy.
62
- * For more information about general purpose buckets bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
63
- * Policies</a> in the <i>Amazon S3 User Guide</i>.</p>
61
+ * <b>General purpose bucket permissions</b> - The
62
+ * <code>s3:GetBucketPolicy</code> permission is required in a policy. For
63
+ * more information about general purpose buckets bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User Policies</a> in the
64
+ * <i>Amazon S3 User Guide</i>.</p>
64
65
  * </li>
65
66
  * <li>
66
67
  * <p>
67
- * <b>Directory bucket permissions</b> - To grant access to this API operation, you must have the <code>s3express:GetBucketPolicy</code> permission in an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource. For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
68
+ * <b>Directory bucket permissions</b> -
69
+ * To grant access to this API operation, you must have the
70
+ * <code>s3express:GetBucketPolicy</code> permission in
71
+ * an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
72
+ * For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
68
73
  * </li>
69
74
  * </ul>
70
75
  * </dd>
71
76
  * <dt>Example bucket policies</dt>
72
77
  * <dd>
73
78
  * <p>
74
- * <b>General purpose buckets example bucket policies</b> - See <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html">Bucket policy examples</a> in the <i>Amazon S3 User Guide</i>.</p>
79
+ * <b>General purpose buckets example bucket policies</b>
80
+ * - See <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html">Bucket policy
81
+ * examples</a> in the <i>Amazon S3 User Guide</i>.</p>
75
82
  * <p>
76
- * <b>Directory bucket example bucket policies</b> - See <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html">Example bucket policies for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
83
+ * <b>Directory bucket example bucket policies</b>
84
+ * - See <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html">Example bucket policies for S3 Express One Zone</a> in the
85
+ * <i>Amazon S3 User Guide</i>.</p>
77
86
  * </dd>
78
87
  * <dt>HTTP Host header syntax</dt>
79
88
  * <dd>