@aws-sdk/client-s3 3.696.0 → 3.698.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 (127) hide show
  1. package/dist-cjs/index.js +152 -29
  2. package/dist-es/commands/DeleteObjectsCommand.js +0 -1
  3. package/dist-es/commands/GetObjectCommand.js +0 -1
  4. package/dist-es/commands/PutBucketAccelerateConfigurationCommand.js +0 -1
  5. package/dist-es/commands/PutBucketAclCommand.js +0 -1
  6. package/dist-es/commands/PutBucketCorsCommand.js +0 -1
  7. package/dist-es/commands/PutBucketEncryptionCommand.js +0 -1
  8. package/dist-es/commands/PutBucketLifecycleConfigurationCommand.js +0 -1
  9. package/dist-es/commands/PutBucketLoggingCommand.js +0 -1
  10. package/dist-es/commands/PutBucketOwnershipControlsCommand.js +0 -1
  11. package/dist-es/commands/PutBucketPolicyCommand.js +0 -1
  12. package/dist-es/commands/PutBucketReplicationCommand.js +0 -1
  13. package/dist-es/commands/PutBucketRequestPaymentCommand.js +0 -1
  14. package/dist-es/commands/PutBucketTaggingCommand.js +0 -1
  15. package/dist-es/commands/PutBucketVersioningCommand.js +0 -1
  16. package/dist-es/commands/PutBucketWebsiteCommand.js +0 -1
  17. package/dist-es/commands/PutObjectAclCommand.js +0 -1
  18. package/dist-es/commands/PutObjectCommand.js +0 -1
  19. package/dist-es/commands/PutObjectLegalHoldCommand.js +0 -1
  20. package/dist-es/commands/PutObjectLockConfigurationCommand.js +0 -1
  21. package/dist-es/commands/PutObjectRetentionCommand.js +0 -1
  22. package/dist-es/commands/PutObjectTaggingCommand.js +0 -1
  23. package/dist-es/commands/PutPublicAccessBlockCommand.js +0 -1
  24. package/dist-es/commands/RestoreObjectCommand.js +0 -1
  25. package/dist-es/commands/UploadPartCommand.js +0 -1
  26. package/dist-es/models/models_1.js +48 -0
  27. package/dist-es/protocols/Aws_restXml.js +75 -4
  28. package/dist-types/commands/AbortMultipartUploadCommand.d.ts +16 -13
  29. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +47 -42
  30. package/dist-types/commands/CopyObjectCommand.d.ts +77 -57
  31. package/dist-types/commands/CreateBucketCommand.d.ts +60 -45
  32. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +92 -66
  33. package/dist-types/commands/CreateSessionCommand.d.ts +30 -16
  34. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +1 -1
  35. package/dist-types/commands/DeleteBucketCommand.d.ts +10 -3
  36. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +1 -1
  37. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +18 -10
  38. package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  39. package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +1 -1
  40. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +52 -9
  41. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +1 -1
  42. package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +1 -1
  43. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +25 -21
  44. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +1 -1
  45. package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +1 -1
  46. package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +1 -1
  47. package/dist-types/commands/DeleteObjectCommand.d.ts +3 -0
  48. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +1 -1
  49. package/dist-types/commands/DeleteObjectsCommand.d.ts +41 -27
  50. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +1 -1
  51. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +1 -1
  52. package/dist-types/commands/GetBucketAclCommand.d.ts +1 -1
  53. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +1 -1
  54. package/dist-types/commands/GetBucketCorsCommand.d.ts +1 -1
  55. package/dist-types/commands/GetBucketEncryptionCommand.d.ts +18 -10
  56. package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  57. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +1 -1
  58. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +61 -17
  59. package/dist-types/commands/GetBucketLocationCommand.d.ts +1 -1
  60. package/dist-types/commands/GetBucketLoggingCommand.d.ts +1 -1
  61. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +1 -1
  62. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +1 -1
  63. package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +1 -1
  64. package/dist-types/commands/GetBucketPolicyCommand.d.ts +30 -21
  65. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +1 -1
  66. package/dist-types/commands/GetBucketReplicationCommand.d.ts +1 -1
  67. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +1 -1
  68. package/dist-types/commands/GetBucketTaggingCommand.d.ts +1 -1
  69. package/dist-types/commands/GetBucketVersioningCommand.d.ts +1 -1
  70. package/dist-types/commands/GetBucketWebsiteCommand.d.ts +1 -1
  71. package/dist-types/commands/GetObjectAclCommand.d.ts +1 -1
  72. package/dist-types/commands/GetObjectAttributesCommand.d.ts +62 -44
  73. package/dist-types/commands/GetObjectCommand.d.ts +79 -60
  74. package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +1 -1
  75. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +1 -1
  76. package/dist-types/commands/GetObjectRetentionCommand.d.ts +1 -1
  77. package/dist-types/commands/GetObjectTaggingCommand.d.ts +1 -1
  78. package/dist-types/commands/GetObjectTorrentCommand.d.ts +1 -1
  79. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +1 -1
  80. package/dist-types/commands/HeadBucketCommand.d.ts +32 -16
  81. package/dist-types/commands/HeadObjectCommand.d.ts +60 -38
  82. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +1 -1
  83. package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +1 -1
  84. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +1 -1
  85. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +1 -1
  86. package/dist-types/commands/ListBucketsCommand.d.ts +6 -6
  87. package/dist-types/commands/ListDirectoryBucketsCommand.d.ts +10 -4
  88. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +50 -33
  89. package/dist-types/commands/ListObjectVersionsCommand.d.ts +1 -1
  90. package/dist-types/commands/ListObjectsCommand.d.ts +1 -1
  91. package/dist-types/commands/ListObjectsV2Command.d.ts +23 -14
  92. package/dist-types/commands/ListPartsCommand.d.ts +22 -17
  93. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +1 -1
  94. package/dist-types/commands/PutBucketAclCommand.d.ts +1 -1
  95. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +1 -1
  96. package/dist-types/commands/PutBucketCorsCommand.d.ts +1 -1
  97. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +47 -32
  98. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  99. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +1 -1
  100. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +84 -45
  101. package/dist-types/commands/PutBucketLoggingCommand.d.ts +1 -1
  102. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +1 -1
  103. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +1 -1
  104. package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +1 -1
  105. package/dist-types/commands/PutBucketPolicyCommand.d.ts +30 -21
  106. package/dist-types/commands/PutBucketReplicationCommand.d.ts +3 -4
  107. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +1 -1
  108. package/dist-types/commands/PutBucketTaggingCommand.d.ts +1 -1
  109. package/dist-types/commands/PutBucketVersioningCommand.d.ts +3 -6
  110. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +1 -1
  111. package/dist-types/commands/PutObjectAclCommand.d.ts +1 -1
  112. package/dist-types/commands/PutObjectCommand.d.ts +83 -35
  113. package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +1 -1
  114. package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +3 -3
  115. package/dist-types/commands/PutObjectRetentionCommand.d.ts +2 -2
  116. package/dist-types/commands/PutObjectTaggingCommand.d.ts +1 -1
  117. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -1
  118. package/dist-types/commands/RestoreObjectCommand.d.ts +1 -1
  119. package/dist-types/commands/SelectObjectContentCommand.d.ts +1 -1
  120. package/dist-types/commands/UploadPartCommand.d.ts +52 -41
  121. package/dist-types/commands/UploadPartCopyCommand.d.ts +53 -39
  122. package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +1 -1
  123. package/dist-types/models/models_0.d.ts +938 -632
  124. package/dist-types/models/models_1.d.ts +230 -135
  125. package/dist-types/ts3.4/models/models_0.d.ts +7 -0
  126. package/dist-types/ts3.4/models/models_1.d.ts +24 -0
  127. package/package.json +2 -2
@@ -35,55 +35,63 @@ declare const CopyObjectCommand_base: {
35
35
  * (UploadPartCopy) API. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html">Copy Object Using the
36
36
  * REST Multipart Upload API</a>.</p>
37
37
  * </note>
38
- * <p>You can copy individual objects between general purpose buckets, between directory buckets, and
39
- * between general purpose buckets and directory buckets.</p>
38
+ * <p>You can copy individual objects between general purpose buckets, between directory buckets,
39
+ * and between general purpose buckets and directory buckets.</p>
40
40
  * <note>
41
41
  * <ul>
42
42
  * <li>
43
- * <p>Amazon S3 supports copy operations using Multi-Region Access Points only as a destination when using the Multi-Region Access Point ARN. </p>
43
+ * <p>Amazon S3 supports copy operations using Multi-Region Access Points only as a
44
+ * destination when using the Multi-Region Access Point ARN. </p>
44
45
  * </li>
45
46
  * <li>
46
47
  * <p>
47
- * <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>
48
+ * <b>Directory buckets </b> -
49
+ * 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>
48
50
  * </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
49
51
  * <i>Amazon S3 User Guide</i>.</p>
50
52
  * </li>
51
53
  * <li>
52
- * <p>VPC endpoints don't support cross-Region requests (including copies). If you're using VPC endpoints, your source and destination buckets should be in the same Amazon Web Services Region as your VPC endpoint.</p>
54
+ * <p>VPC endpoints don't support cross-Region requests (including copies). If you're
55
+ * using VPC endpoints, your source and destination buckets should be in the same
56
+ * Amazon Web Services Region as your VPC endpoint.</p>
53
57
  * </li>
54
58
  * </ul>
55
59
  * </note>
56
- * <p>Both the
57
- * Region that you want to copy the object from and the Region that you want to copy the
58
- * object to must be enabled for your account. For more information about how to enable a Region for your account, see <a href="https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone">Enable
59
- * or disable a Region for standalone accounts</a> in the
60
- * <i>Amazon Web Services Account Management Guide</i>.</p>
60
+ * <p>Both the Region that you want to copy the object from and the Region that you want to
61
+ * copy the object to must be enabled for your account. For more information about how to
62
+ * enable a Region for your account, see <a href="https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone">Enable or disable a Region for standalone accounts</a> in the <i>Amazon Web Services
63
+ * Account Management Guide</i>.</p>
61
64
  * <important>
62
65
  * <p>Amazon S3 transfer acceleration does not support cross-Region copies. If you request a
63
66
  * cross-Region copy using a transfer acceleration endpoint, you get a <code>400 Bad
64
67
  * Request</code> error. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer
65
- * Acceleration</a>.</p>
68
+ * Acceleration</a>.</p>
66
69
  * </important>
67
70
  * <dl>
68
71
  * <dt>Authentication and authorization</dt>
69
72
  * <dd>
70
- * <p>All <code>CopyObject</code> requests must be authenticated and signed by using IAM credentials (access key ID and secret access key for the IAM identities). All headers with the <code>x-amz-</code> prefix, including
71
- * <code>x-amz-copy-source</code>, must be signed. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>.</p>
73
+ * <p>All <code>CopyObject</code> requests must be authenticated and signed by using
74
+ * IAM credentials (access key ID and secret access key for the IAM identities).
75
+ * All headers with the <code>x-amz-</code> prefix, including
76
+ * <code>x-amz-copy-source</code>, must be signed. For more information, see
77
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>.</p>
72
78
  * <p>
73
- * <b>Directory buckets</b> - You must use the IAM credentials to authenticate and authorize your access to the <code>CopyObject</code> API operation, instead of using the
74
- * temporary security credentials through the <code>CreateSession</code> API operation.</p>
75
- * <p>Amazon Web Services CLI or SDKs handles authentication and authorization on your behalf.</p>
79
+ * <b>Directory buckets</b> - You must use the
80
+ * IAM credentials to authenticate and authorize your access to the
81
+ * <code>CopyObject</code> API operation, instead of using the temporary security
82
+ * credentials through the <code>CreateSession</code> API operation.</p>
83
+ * <p>Amazon Web Services CLI or SDKs handles authentication and authorization on your
84
+ * behalf.</p>
76
85
  * </dd>
77
86
  * <dt>Permissions</dt>
78
87
  * <dd>
79
- * <p>You must have
80
- * <i>read</i> access to the source object and <i>write</i>
81
- * access to the destination bucket.</p>
88
+ * <p>You must have <i>read</i> access to the source object and
89
+ * <i>write</i> access to the destination bucket.</p>
82
90
  * <ul>
83
91
  * <li>
84
92
  * <p>
85
- * <b>General purpose bucket permissions</b> -
86
- * You must have permissions in an IAM policy based on the source and destination
93
+ * <b>General purpose bucket permissions</b> - You
94
+ * must have permissions in an IAM policy based on the source and destination
87
95
  * bucket types in a <code>CopyObject</code> operation.</p>
88
96
  * <ul>
89
97
  * <li>
@@ -105,30 +113,38 @@ declare const CopyObjectCommand_base: {
105
113
  * <li>
106
114
  * <p>
107
115
  * <b>Directory bucket permissions</b> -
108
- * You must have permissions in a bucket policy or an IAM identity-based policy based on the source and destination
109
- * bucket types in a <code>CopyObject</code> operation.</p>
116
+ * You must have permissions in a bucket policy or an IAM identity-based policy based on the
117
+ * source and destination bucket types in a <code>CopyObject</code>
118
+ * operation.</p>
110
119
  * <ul>
111
120
  * <li>
112
121
  * <p>If the source object that you want to copy is in a
113
122
  * directory bucket, you must have the <b>
114
123
  * <code>s3express:CreateSession</code>
115
124
  * </b> permission in
116
- * the <code>Action</code> element of a policy to read the object. By default, the session is in the <code>ReadWrite</code> mode. If you want to restrict the access, you can explicitly set the <code>s3express:SessionMode</code> condition key to <code>ReadOnly</code> on the copy source bucket.</p>
125
+ * the <code>Action</code> element of a policy to read the object. By
126
+ * default, the session is in the <code>ReadWrite</code> mode. If you
127
+ * want to restrict the access, you can explicitly set the
128
+ * <code>s3express:SessionMode</code> condition key to
129
+ * <code>ReadOnly</code> on the copy source bucket.</p>
117
130
  * </li>
118
131
  * <li>
119
- * <p>If the copy destination is a directory bucket, you must have the <b>
132
+ * <p>If the copy destination is a directory bucket, you must have the
133
+ * <b>
120
134
  * <code>s3express:CreateSession</code>
121
135
  * </b> permission in the
122
- * <code>Action</code> element of a policy to write the object
123
- * to the destination. The <code>s3express:SessionMode</code> condition
124
- * key can't be set to <code>ReadOnly</code> on the copy destination bucket. </p>
136
+ * <code>Action</code> element of a policy to write the object to the
137
+ * destination. The <code>s3express:SessionMode</code> condition key
138
+ * can't be set to <code>ReadOnly</code> on the copy destination bucket.
139
+ * </p>
125
140
  * </li>
126
141
  * </ul>
127
- * <p>If the object is encrypted with
128
- * SSE-KMS, you must also have the
129
- * <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions in IAM identity-based policies and KMS key policies for the KMS key.</p>
130
- * <p>For example policies, 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> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html">Amazon Web Services Identity and Access Management (IAM) identity-based policies for S3 Express One Zone</a> in the
131
- * <i>Amazon S3 User Guide</i>.</p>
142
+ * <p>If the object is encrypted with SSE-KMS, you must also have the
143
+ * <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions
144
+ * in IAM identity-based policies and KMS key policies for the KMS
145
+ * key.</p>
146
+ * <p>For example policies, 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> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html">Amazon Web Services Identity and Access Management (IAM) identity-based policies for
147
+ * S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
132
148
  * </li>
133
149
  * </ul>
134
150
  * </dd>
@@ -140,33 +156,36 @@ declare const CopyObjectCommand_base: {
140
156
  * to check if the copy succeeds. </p>
141
157
  * <ul>
142
158
  * <li>
143
- * <p>If the copy is successful, you receive a response with information about the copied
144
- * object.</p>
159
+ * <p>If the copy is successful, you receive a response with information about
160
+ * the copied object.</p>
145
161
  * </li>
146
162
  * <li>
147
- * <p>A copy request might return an error when Amazon S3 receives the copy request or while Amazon S3
148
- * is copying the files. A <code>200 OK</code> response can contain either a success or an error.</p>
163
+ * <p>A copy request might return an error when Amazon S3 receives the copy request
164
+ * or while Amazon S3 is copying the files. A <code>200 OK</code> response can
165
+ * contain either a success or an error.</p>
149
166
  * <ul>
150
167
  * <li>
151
168
  * <p>If the error occurs before the copy action starts, you receive a
152
- * standard Amazon S3 error.</p>
169
+ * standard Amazon S3 error.</p>
153
170
  * </li>
154
171
  * <li>
155
- * <p>If the error occurs during the copy operation, the error response is
156
- * embedded in the <code>200 OK</code> response. For example, in a cross-region copy, you
157
- * may encounter throttling and receive a <code>200 OK</code> response.
158
- * For more information, see <a href="https://repost.aws/knowledge-center/s3-resolve-200-internalerror">Resolve
159
- * the Error 200 response when copying objects to Amazon S3</a>.
160
- * The <code>200 OK</code> status code means the copy was accepted, but
161
- * it doesn't mean the copy is complete. Another example is
162
- * when you disconnect from Amazon S3 before the copy is complete, Amazon S3 might cancel the copy and you may receive a <code>200 OK</code> response.
163
- * You must stay connected to Amazon S3 until the entire response is successfully received and processed.</p>
164
- * <p>If you call this API operation directly, make
165
- * sure to design your application to parse the content of the response and handle it
166
- * appropriately. If you use Amazon Web Services SDKs, SDKs handle this condition. The SDKs detect the
167
- * embedded error and apply error handling per your configuration settings (including
168
- * automatically retrying the request as appropriate). If the condition persists, the SDKs
169
- * throw an exception (or, for the SDKs that don't use exceptions, they return an
172
+ * <p>If the error occurs during the copy operation, the error response
173
+ * is embedded in the <code>200 OK</code> response. For example, in a
174
+ * cross-region copy, you may encounter throttling and receive a
175
+ * <code>200 OK</code> response. For more information, see <a href="https://repost.aws/knowledge-center/s3-resolve-200-internalerror">Resolve the Error 200 response when copying objects to
176
+ * Amazon S3</a>. The <code>200 OK</code> status code means the copy
177
+ * was accepted, but it doesn't mean the copy is complete. Another
178
+ * example is when you disconnect from Amazon S3 before the copy is complete,
179
+ * Amazon S3 might cancel the copy and you may receive a <code>200 OK</code>
180
+ * response. You must stay connected to Amazon S3 until the entire response is
181
+ * successfully received and processed.</p>
182
+ * <p>If you call this API operation directly, make sure to design your
183
+ * application to parse the content of the response and handle it
184
+ * appropriately. If you use Amazon Web Services SDKs, SDKs handle this condition. The
185
+ * SDKs detect the embedded error and apply error handling per your
186
+ * configuration settings (including automatically retrying the request
187
+ * as appropriate). If the condition persists, the SDKs throw an
188
+ * exception (or, for the SDKs that don't use exceptions, they return an
170
189
  * error).</p>
171
190
  * </li>
172
191
  * </ul>
@@ -175,10 +194,11 @@ declare const CopyObjectCommand_base: {
175
194
  * </dd>
176
195
  * <dt>Charge</dt>
177
196
  * <dd>
178
- * <p>The copy request charge is based on the storage class and Region that you specify for
179
- * the destination object. The request can also result in a data retrieval charge for the
180
- * source if the source storage class bills for data retrieval. If the copy source is in a different region, the data transfer is billed to the copy source account. For pricing information, see
181
- * <a href="http://aws.amazon.com/s3/pricing/">Amazon S3 pricing</a>.</p>
197
+ * <p>The copy request charge is based on the storage class and Region that you
198
+ * specify for the destination object. The request can also result in a data
199
+ * retrieval charge for the source if the source storage class bills for data
200
+ * retrieval. If the copy source is in a different region, the data transfer is
201
+ * billed to the copy source account. For pricing information, see <a href="http://aws.amazon.com/s3/pricing/">Amazon S3 pricing</a>.</p>
182
202
  * </dd>
183
203
  * <dt>HTTP Host header syntax</dt>
184
204
  * <dd>
@@ -32,9 +32,9 @@ declare const CreateBucketCommand_base: {
32
32
  * <code>CreateBucket</code>
33
33
  * </a>.</p>
34
34
  * </note>
35
- * <p>Creates a new S3 bucket. To create a bucket, you must set up Amazon S3 and have a
36
- * valid Amazon Web Services Access Key ID to authenticate requests. Anonymous requests are never allowed to
37
- * create buckets. By creating the bucket, you become the bucket owner.</p>
35
+ * <p>Creates a new S3 bucket. To create a bucket, you must set up Amazon S3 and have a valid Amazon Web Services
36
+ * Access Key ID to authenticate requests. Anonymous requests are never allowed to create
37
+ * buckets. By creating the bucket, you become the bucket owner.</p>
38
38
  * <p>There are two types of buckets: general purpose buckets and directory buckets. For more
39
39
  * information about these bucket types, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html">Creating, configuring, and
40
40
  * working with Amazon S3 buckets</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -42,12 +42,14 @@ declare const CreateBucketCommand_base: {
42
42
  * <ul>
43
43
  * <li>
44
44
  * <p>
45
- * <b>General purpose buckets</b> - If you send your <code>CreateBucket</code> request to the <code>s3.amazonaws.com</code> global endpoint,
46
- * the request goes to the <code>us-east-1</code> Region. So the signature
47
- * calculations in Signature Version 4 must use <code>us-east-1</code> as the Region, even
48
- * if the location constraint in the request specifies another Region where the bucket is
49
- * to be created. If you create a bucket in a Region other than US East (N. Virginia), your
50
- * application must be able to handle 307 redirect. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html">Virtual hosting of
45
+ * <b>General purpose buckets</b> - If you send your
46
+ * <code>CreateBucket</code> request to the <code>s3.amazonaws.com</code> global
47
+ * endpoint, the request goes to the <code>us-east-1</code> Region. So the signature
48
+ * calculations in Signature Version 4 must use <code>us-east-1</code> as the Region,
49
+ * even if the location constraint in the request specifies another Region where the
50
+ * bucket is to be created. If you create a bucket in a Region other than US East (N.
51
+ * Virginia), your application must be able to handle 307 redirect. For more
52
+ * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html">Virtual hosting of
51
53
  * buckets</a> in the <i>Amazon S3 User Guide</i>.</p>
52
54
  * </li>
53
55
  * <li>
@@ -65,33 +67,40 @@ declare const CreateBucketCommand_base: {
65
67
  * <ul>
66
68
  * <li>
67
69
  * <p>
68
- * <b>General purpose bucket permissions</b> - In addition to the <code>s3:CreateBucket</code> permission, the following permissions are
69
- * required in a policy when your <code>CreateBucket</code> request includes specific
70
- * headers: </p>
70
+ * <b>General purpose bucket permissions</b> - In
71
+ * addition to the <code>s3:CreateBucket</code> permission, the following
72
+ * permissions are required in a policy when your <code>CreateBucket</code>
73
+ * request includes specific headers: </p>
71
74
  * <ul>
72
75
  * <li>
73
76
  * <p>
74
- * <b>Access control lists (ACLs)</b> - In your <code>CreateBucket</code> request, if you specify an access control list (ACL)
75
- * and set it to <code>public-read</code>, <code>public-read-write</code>,
76
- * <code>authenticated-read</code>, or if you explicitly specify any other custom ACLs, both <code>s3:CreateBucket</code> and
77
- * <code>s3:PutBucketAcl</code> permissions are required. In your <code>CreateBucket</code> request, if you set the ACL to <code>private</code>,
78
- * or if you don't specify any ACLs, only the <code>s3:CreateBucket</code> permission is required.
79
- * </p>
77
+ * <b>Access control lists (ACLs)</b>
78
+ * - In your <code>CreateBucket</code> request, if you specify an
79
+ * access control list (ACL) and set it to <code>public-read</code>,
80
+ * <code>public-read-write</code>, <code>authenticated-read</code>, or
81
+ * if you explicitly specify any other custom ACLs, both
82
+ * <code>s3:CreateBucket</code> and <code>s3:PutBucketAcl</code>
83
+ * permissions are required. In your <code>CreateBucket</code> request,
84
+ * if you set the ACL to <code>private</code>, or if you don't specify
85
+ * any ACLs, only the <code>s3:CreateBucket</code> permission is
86
+ * required. </p>
80
87
  * </li>
81
88
  * <li>
82
89
  * <p>
83
90
  * <b>Object Lock</b> - In your
84
- * <code>CreateBucket</code> request, if you set
85
- * <code>x-amz-bucket-object-lock-enabled</code> to true, the
86
- * <code>s3:PutBucketObjectLockConfiguration</code> and
87
- * <code>s3:PutBucketVersioning</code> permissions are required.</p>
91
+ * <code>CreateBucket</code> request, if you set
92
+ * <code>x-amz-bucket-object-lock-enabled</code> to true, the
93
+ * <code>s3:PutBucketObjectLockConfiguration</code> and
94
+ * <code>s3:PutBucketVersioning</code> permissions are
95
+ * required.</p>
88
96
  * </li>
89
97
  * <li>
90
98
  * <p>
91
- * <b>S3 Object Ownership</b> - If your
92
- * <code>CreateBucket</code> request includes the
93
- * <code>x-amz-object-ownership</code> header, then the
94
- * <code>s3:PutBucketOwnershipControls</code> permission is required.</p>
99
+ * <b>S3 Object Ownership</b> - If
100
+ * your <code>CreateBucket</code> request includes the
101
+ * <code>x-amz-object-ownership</code> header, then the
102
+ * <code>s3:PutBucketOwnershipControls</code> permission is
103
+ * required.</p>
95
104
  * <important>
96
105
  * <p> To set an ACL on a bucket as part of a
97
106
  * <code>CreateBucket</code> request, you must explicitly set S3
@@ -102,10 +111,10 @@ declare const CreateBucketCommand_base: {
102
111
  * Public Access on the bucket before using <code>PutBucketAcl</code>
103
112
  * to set the ACL. If you try to create a bucket with a public ACL,
104
113
  * the request will fail. </p>
105
- * <p> For the majority of modern use cases in S3, we recommend
106
- * that you keep all Block Public Access settings enabled and keep
107
- * ACLs disabled. If you would like to share data with users outside
108
- * of your account, you can use bucket policies as needed. For more
114
+ * <p> For the majority of modern use cases in S3, we recommend that
115
+ * you keep all Block Public Access settings enabled and keep ACLs
116
+ * disabled. If you would like to share data with users outside of
117
+ * your account, you can use bucket policies as needed. For more
109
118
  * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Controlling ownership of objects and disabling ACLs for your
110
119
  * bucket </a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html">Blocking public access to your Amazon S3 storage </a> in
111
120
  * the <i>Amazon S3 User Guide</i>. </p>
@@ -113,30 +122,36 @@ declare const CreateBucketCommand_base: {
113
122
  * </li>
114
123
  * <li>
115
124
  * <p>
116
- * <b>S3 Block Public Access</b> - If your
117
- * specific use case requires granting public access to your S3 resources, you
118
- * can disable Block Public Access. Specifically, you can create a new bucket with Block
119
- * Public Access enabled, then separately call the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html">
125
+ * <b>S3 Block Public Access</b> - If
126
+ * your specific use case requires granting public access to your S3
127
+ * resources, you can disable Block Public Access. Specifically, you can
128
+ * create a new bucket with Block Public Access enabled, then separately
129
+ * call the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html">
120
130
  * <code>DeletePublicAccessBlock</code>
121
131
  * </a> API. To use this operation, you must have the
122
- * <code>s3:PutBucketPublicAccessBlock</code> permission. For more information about S3 Block Public
123
- * Access, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html">Blocking
124
- * public access to your Amazon S3 storage </a> in the
125
- * <i>Amazon S3 User Guide</i>. </p>
132
+ * <code>s3:PutBucketPublicAccessBlock</code> permission. For more
133
+ * information about S3 Block Public Access, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html">Blocking public access to your Amazon S3 storage </a> in the
134
+ * <i>Amazon S3 User Guide</i>. </p>
126
135
  * </li>
127
136
  * </ul>
128
137
  * </li>
129
138
  * <li>
130
139
  * <p>
131
- * <b>Directory bucket permissions</b> - You must have the <code>s3express:CreateBucket</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>
140
+ * <b>Directory bucket permissions</b> -
141
+ * You must have the <code>s3express:CreateBucket</code> permission in
142
+ * 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.
143
+ * 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>
132
144
  * <important>
133
- * <p>The permissions for ACLs, Object Lock, S3 Object Ownership, and S3 Block Public Access are not supported for directory buckets.
134
- * For directory buckets, all Block Public Access settings are enabled at the bucket level and S3
135
- * Object Ownership is set to Bucket owner enforced (ACLs disabled). These settings can't be modified.
136
- * </p>
145
+ * <p>The permissions for ACLs, Object Lock, S3 Object Ownership, and S3
146
+ * Block Public Access are not supported for directory buckets. For
147
+ * directory buckets, all Block Public Access settings are enabled at the
148
+ * bucket level and S3 Object Ownership is set to Bucket owner enforced
149
+ * (ACLs disabled). These settings can't be modified. </p>
137
150
  * <p>For more information about permissions for creating and working with
138
- * directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html">Directory buckets</a> in the <i>Amazon S3 User Guide</i>.
139
- * For more information about supported S3 features for directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features">Features of S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
151
+ * directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html">Directory buckets</a> in the
152
+ * <i>Amazon S3 User Guide</i>. For more information about
153
+ * supported S3 features for directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features">Features of S3 Express One Zone</a> in the
154
+ * <i>Amazon S3 User Guide</i>.</p>
140
155
  * </important>
141
156
  * </li>
142
157
  * </ul>