aws_sdk_s3/operation/complete_multipart_upload/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::complete_multipart_upload::_complete_multipart_upload_output::CompleteMultipartUploadOutputBuilder;
3
4pub use crate::operation::complete_multipart_upload::_complete_multipart_upload_input::CompleteMultipartUploadInputBuilder;
5
6impl crate::operation::complete_multipart_upload::builders::CompleteMultipartUploadInputBuilder {
7 /// Sends a request with this input using the given client.
8 pub async fn send_with(
9 self,
10 client: &crate::Client,
11 ) -> ::std::result::Result<
12 crate::operation::complete_multipart_upload::CompleteMultipartUploadOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::complete_multipart_upload::CompleteMultipartUploadError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.complete_multipart_upload();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `CompleteMultipartUpload`.
24///
25/// <p>Completes a multipart upload by assembling previously uploaded parts.</p>
26/// <p>You first initiate the multipart upload and then upload all parts using the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a> operation or the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a> operation. After successfully uploading all relevant parts of an upload, you call this <code>CompleteMultipartUpload</code> operation to complete the upload. Upon receiving this request, Amazon S3 concatenates all the parts in ascending order by part number to create a new object. In the CompleteMultipartUpload request, you must provide the parts list and ensure that the parts list is complete. The CompleteMultipartUpload API operation concatenates the parts that you provide in the list. For each part in the list, you must provide the <code>PartNumber</code> value and the <code>ETag</code> value that are returned after that part was uploaded.</p>
27/// <p>The processing of a CompleteMultipartUpload request could take several minutes to finalize. After Amazon S3 begins processing the request, it sends an HTTP response header that specifies a <code>200 OK</code> response. While processing is in progress, Amazon S3 periodically sends white space characters to keep the connection from timing out. A request could fail after the initial <code>200 OK</code> response has been sent. This means that a <code>200 OK</code> response can contain either a success or an error. The error response might be embedded in the <code>200 OK</code> response. If you call this API operation directly, make sure to design your application to parse the contents of the response and handle it appropriately. If you use Amazon Web Services SDKs, SDKs handle this condition. The SDKs detect the embedded error and apply error handling per your configuration settings (including automatically retrying the request as appropriate). If the condition persists, the SDKs throw an exception (or, for the SDKs that don't use exceptions, they return an error).</p>
28/// <p>Note that if <code>CompleteMultipartUpload</code> fails, applications should be prepared to retry any failed requests (including 500 error responses). For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html">Amazon S3 Error Best Practices</a>.</p><important>
29/// <p>You can't use <code>Content-Type: application/x-www-form-urlencoded</code> for the CompleteMultipartUpload requests. Also, if you don't provide a <code>Content-Type</code> header, <code>CompleteMultipartUpload</code> can still return a <code>200 OK</code> response.</p>
30/// </important>
31/// <p>For more information about multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart Upload</a> in the <i>Amazon S3 User Guide</i>.</p><note>
32/// <p><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> </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 <i>Amazon S3 User Guide</i>.</p>
33/// </note>
34/// <dl>
35/// <dt>
36/// Permissions
37/// </dt>
38/// <dd>
39/// <ul>
40/// <li>
41/// <p><b>General purpose bucket permissions</b> - For information about permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and Permissions</a> in the <i>Amazon S3 User Guide</i>.</p></li>
42/// <li>
43/// <p><b>Directory bucket permissions</b> - To grant access to this API operation on a directory bucket, we recommend that you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html"> <code>CreateSession</code> </a> API operation for session-based authorization. Specifically, you grant the <code>s3express:CreateSession</code> permission to the directory bucket in a bucket policy or an IAM identity-based policy. Then, you make the <code>CreateSession</code> API call on the bucket to obtain a session token. With the session token in your request header, you can make API requests to this operation. After the session token expires, you make another <code>CreateSession</code> API call to generate a new session token for use. Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html"> <code>CreateSession</code> </a>.</p></li>
44/// <li>
45/// <p>If you provide an <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html">additional checksum value</a> in your <code>MultipartUpload</code> requests and the object is encrypted with Key Management Service, you must have permission to use the <code>kms:Decrypt</code> action for the <code>CompleteMultipartUpload</code> request to succeed.</p></li>
46/// </ul>
47/// </dd>
48/// <dt>
49/// Special errors
50/// </dt>
51/// <dd>
52/// <ul>
53/// <li>
54/// <p>Error Code: <code>EntityTooSmall</code></p>
55/// <ul>
56/// <li>
57/// <p>Description: Your proposed upload is smaller than the minimum allowed object size. Each part must be at least 5 MB in size, except the last part.</p></li>
58/// <li>
59/// <p>HTTP Status Code: 400 Bad Request</p></li>
60/// </ul></li>
61/// <li>
62/// <p>Error Code: <code>InvalidPart</code></p>
63/// <ul>
64/// <li>
65/// <p>Description: One or more of the specified parts could not be found. The part might not have been uploaded, or the specified ETag might not have matched the uploaded part's ETag.</p></li>
66/// <li>
67/// <p>HTTP Status Code: 400 Bad Request</p></li>
68/// </ul></li>
69/// <li>
70/// <p>Error Code: <code>InvalidPartOrder</code></p>
71/// <ul>
72/// <li>
73/// <p>Description: The list of parts was not in ascending order. The parts list must be specified in order by part number.</p></li>
74/// <li>
75/// <p>HTTP Status Code: 400 Bad Request</p></li>
76/// </ul></li>
77/// <li>
78/// <p>Error Code: <code>NoSuchUpload</code></p>
79/// <ul>
80/// <li>
81/// <p>Description: The specified multipart upload does not exist. The upload ID might be invalid, or the multipart upload might have been aborted or completed.</p></li>
82/// <li>
83/// <p>HTTP Status Code: 404 Not Found</p></li>
84/// </ul></li>
85/// </ul>
86/// </dd>
87/// <dt>
88/// HTTP Host header syntax
89/// </dt>
90/// <dd>
91/// <p><b>Directory buckets </b> - The HTTP Host header syntax is <code> <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
92/// </dd>
93/// </dl>
94/// <p>The following operations are related to <code>CompleteMultipartUpload</code>:</p>
95/// <ul>
96/// <li>
97/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a></p></li>
98/// <li>
99/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a></p></li>
100/// <li>
101/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html">AbortMultipartUpload</a></p></li>
102/// <li>
103/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html">ListParts</a></p></li>
104/// <li>
105/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html">ListMultipartUploads</a></p></li>
106/// </ul>
107#[derive(::std::clone::Clone, ::std::fmt::Debug)]
108pub struct CompleteMultipartUploadFluentBuilder {
109 handle: ::std::sync::Arc<crate::client::Handle>,
110 inner: crate::operation::complete_multipart_upload::builders::CompleteMultipartUploadInputBuilder,
111 config_override: ::std::option::Option<crate::config::Builder>,
112}
113impl
114 crate::client::customize::internal::CustomizableSend<
115 crate::operation::complete_multipart_upload::CompleteMultipartUploadOutput,
116 crate::operation::complete_multipart_upload::CompleteMultipartUploadError,
117 > for CompleteMultipartUploadFluentBuilder
118{
119 fn send(
120 self,
121 config_override: crate::config::Builder,
122 ) -> crate::client::customize::internal::BoxFuture<
123 crate::client::customize::internal::SendResult<
124 crate::operation::complete_multipart_upload::CompleteMultipartUploadOutput,
125 crate::operation::complete_multipart_upload::CompleteMultipartUploadError,
126 >,
127 > {
128 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
129 }
130}
131impl CompleteMultipartUploadFluentBuilder {
132 /// Creates a new `CompleteMultipartUploadFluentBuilder`.
133 pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
134 Self {
135 handle,
136 inner: ::std::default::Default::default(),
137 config_override: ::std::option::Option::None,
138 }
139 }
140 /// Access the CompleteMultipartUpload as a reference.
141 pub fn as_input(&self) -> &crate::operation::complete_multipart_upload::builders::CompleteMultipartUploadInputBuilder {
142 &self.inner
143 }
144 /// Sends the request and returns the response.
145 ///
146 /// If an error occurs, an `SdkError` will be returned with additional details that
147 /// can be matched against.
148 ///
149 /// By default, any retryable failures will be retried twice. Retry behavior
150 /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
151 /// set when configuring the client.
152 pub async fn send(
153 self,
154 ) -> ::std::result::Result<
155 crate::operation::complete_multipart_upload::CompleteMultipartUploadOutput,
156 ::aws_smithy_runtime_api::client::result::SdkError<
157 crate::operation::complete_multipart_upload::CompleteMultipartUploadError,
158 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
159 >,
160 > {
161 let input = self
162 .inner
163 .build()
164 .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
165 let runtime_plugins = crate::operation::complete_multipart_upload::CompleteMultipartUpload::operation_runtime_plugins(
166 self.handle.runtime_plugins.clone(),
167 &self.handle.conf,
168 self.config_override,
169 );
170 crate::operation::complete_multipart_upload::CompleteMultipartUpload::orchestrate(&runtime_plugins, input).await
171 }
172
173 /// Consumes this builder, creating a customizable operation that can be modified before being sent.
174 pub fn customize(
175 self,
176 ) -> crate::client::customize::CustomizableOperation<
177 crate::operation::complete_multipart_upload::CompleteMultipartUploadOutput,
178 crate::operation::complete_multipart_upload::CompleteMultipartUploadError,
179 Self,
180 > {
181 crate::client::customize::CustomizableOperation::new(self)
182 }
183 pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
184 self.set_config_override(::std::option::Option::Some(config_override.into()));
185 self
186 }
187
188 pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
189 self.config_override = config_override;
190 self
191 }
192 /// <p>Name of the bucket to which the multipart upload was initiated.</p>
193 /// <p><b>Directory buckets</b> - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format <code> <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>. Path-style requests are not supported. Directory bucket names must be unique in the chosen Availability Zone. Bucket names must follow the format <code> <i>bucket_base_name</i>--<i>az-id</i>--x-s3</code> (for example, <code> <i>DOC-EXAMPLE-BUCKET</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>.</p>
194 /// <p><b>Access points</b> - When you use this action with an access point, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p><note>
195 /// <p>Access points and Object Lambda access points are not supported by directory buckets.</p>
196 /// </note>
197 /// <p><b>S3 on Outposts</b> - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code> <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
198 pub fn bucket(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
199 self.inner = self.inner.bucket(input.into());
200 self
201 }
202 /// <p>Name of the bucket to which the multipart upload was initiated.</p>
203 /// <p><b>Directory buckets</b> - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format <code> <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>. Path-style requests are not supported. Directory bucket names must be unique in the chosen Availability Zone. Bucket names must follow the format <code> <i>bucket_base_name</i>--<i>az-id</i>--x-s3</code> (for example, <code> <i>DOC-EXAMPLE-BUCKET</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>.</p>
204 /// <p><b>Access points</b> - When you use this action with an access point, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p><note>
205 /// <p>Access points and Object Lambda access points are not supported by directory buckets.</p>
206 /// </note>
207 /// <p><b>S3 on Outposts</b> - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code> <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
208 pub fn set_bucket(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
209 self.inner = self.inner.set_bucket(input);
210 self
211 }
212 /// <p>Name of the bucket to which the multipart upload was initiated.</p>
213 /// <p><b>Directory buckets</b> - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format <code> <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>. Path-style requests are not supported. Directory bucket names must be unique in the chosen Availability Zone. Bucket names must follow the format <code> <i>bucket_base_name</i>--<i>az-id</i>--x-s3</code> (for example, <code> <i>DOC-EXAMPLE-BUCKET</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>.</p>
214 /// <p><b>Access points</b> - When you use this action with an access point, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p><note>
215 /// <p>Access points and Object Lambda access points are not supported by directory buckets.</p>
216 /// </note>
217 /// <p><b>S3 on Outposts</b> - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code> <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
218 pub fn get_bucket(&self) -> &::std::option::Option<::std::string::String> {
219 self.inner.get_bucket()
220 }
221 /// <p>Object key for which the multipart upload was initiated.</p>
222 pub fn key(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
223 self.inner = self.inner.key(input.into());
224 self
225 }
226 /// <p>Object key for which the multipart upload was initiated.</p>
227 pub fn set_key(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
228 self.inner = self.inner.set_key(input);
229 self
230 }
231 /// <p>Object key for which the multipart upload was initiated.</p>
232 pub fn get_key(&self) -> &::std::option::Option<::std::string::String> {
233 self.inner.get_key()
234 }
235 /// <p>The container for the multipart upload request information.</p>
236 pub fn multipart_upload(mut self, input: crate::types::CompletedMultipartUpload) -> Self {
237 self.inner = self.inner.multipart_upload(input);
238 self
239 }
240 /// <p>The container for the multipart upload request information.</p>
241 pub fn set_multipart_upload(mut self, input: ::std::option::Option<crate::types::CompletedMultipartUpload>) -> Self {
242 self.inner = self.inner.set_multipart_upload(input);
243 self
244 }
245 /// <p>The container for the multipart upload request information.</p>
246 pub fn get_multipart_upload(&self) -> &::std::option::Option<crate::types::CompletedMultipartUpload> {
247 self.inner.get_multipart_upload()
248 }
249 /// <p>ID for the initiated multipart upload.</p>
250 pub fn upload_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
251 self.inner = self.inner.upload_id(input.into());
252 self
253 }
254 /// <p>ID for the initiated multipart upload.</p>
255 pub fn set_upload_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
256 self.inner = self.inner.set_upload_id(input);
257 self
258 }
259 /// <p>ID for the initiated multipart upload.</p>
260 pub fn get_upload_id(&self) -> &::std::option::Option<::std::string::String> {
261 self.inner.get_upload_id()
262 }
263 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 32-bit CRC32 checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
264 pub fn checksum_crc32(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
265 self.inner = self.inner.checksum_crc32(input.into());
266 self
267 }
268 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 32-bit CRC32 checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
269 pub fn set_checksum_crc32(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
270 self.inner = self.inner.set_checksum_crc32(input);
271 self
272 }
273 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 32-bit CRC32 checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
274 pub fn get_checksum_crc32(&self) -> &::std::option::Option<::std::string::String> {
275 self.inner.get_checksum_crc32()
276 }
277 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 32-bit CRC32C checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
278 pub fn checksum_crc32_c(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
279 self.inner = self.inner.checksum_crc32_c(input.into());
280 self
281 }
282 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 32-bit CRC32C checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
283 pub fn set_checksum_crc32_c(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
284 self.inner = self.inner.set_checksum_crc32_c(input);
285 self
286 }
287 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 32-bit CRC32C checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
288 pub fn get_checksum_crc32_c(&self) -> &::std::option::Option<::std::string::String> {
289 self.inner.get_checksum_crc32_c()
290 }
291 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 160-bit SHA-1 digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
292 pub fn checksum_sha1(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
293 self.inner = self.inner.checksum_sha1(input.into());
294 self
295 }
296 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 160-bit SHA-1 digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
297 pub fn set_checksum_sha1(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
298 self.inner = self.inner.set_checksum_sha1(input);
299 self
300 }
301 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 160-bit SHA-1 digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
302 pub fn get_checksum_sha1(&self) -> &::std::option::Option<::std::string::String> {
303 self.inner.get_checksum_sha1()
304 }
305 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 256-bit SHA-256 digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
306 pub fn checksum_sha256(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
307 self.inner = self.inner.checksum_sha256(input.into());
308 self
309 }
310 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 256-bit SHA-256 digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
311 pub fn set_checksum_sha256(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
312 self.inner = self.inner.set_checksum_sha256(input);
313 self
314 }
315 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the base64-encoded, 256-bit SHA-256 digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
316 pub fn get_checksum_sha256(&self) -> &::std::option::Option<::std::string::String> {
317 self.inner.get_checksum_sha256()
318 }
319 /// <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for corresponding charges to copy the object. For information about downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p><note>
320 /// <p>This functionality is not supported for directory buckets.</p>
321 /// </note>
322 pub fn request_payer(mut self, input: crate::types::RequestPayer) -> Self {
323 self.inner = self.inner.request_payer(input);
324 self
325 }
326 /// <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for corresponding charges to copy the object. For information about downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p><note>
327 /// <p>This functionality is not supported for directory buckets.</p>
328 /// </note>
329 pub fn set_request_payer(mut self, input: ::std::option::Option<crate::types::RequestPayer>) -> Self {
330 self.inner = self.inner.set_request_payer(input);
331 self
332 }
333 /// <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for corresponding charges to copy the object. For information about downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p><note>
334 /// <p>This functionality is not supported for directory buckets.</p>
335 /// </note>
336 pub fn get_request_payer(&self) -> &::std::option::Option<crate::types::RequestPayer> {
337 self.inner.get_request_payer()
338 }
339 /// <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
340 pub fn expected_bucket_owner(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
341 self.inner = self.inner.expected_bucket_owner(input.into());
342 self
343 }
344 /// <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
345 pub fn set_expected_bucket_owner(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
346 self.inner = self.inner.set_expected_bucket_owner(input);
347 self
348 }
349 /// <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
350 pub fn get_expected_bucket_owner(&self) -> &::std::option::Option<::std::string::String> {
351 self.inner.get_expected_bucket_owner()
352 }
353 /// <p>Uploads the object only if the object key name does not already exist in the bucket specified. Otherwise, Amazon S3 returns a <code>412 Precondition Failed</code> error.</p>
354 /// <p>If a conflicting operation occurs during the upload S3 returns a <code>409 ConditionalRequestConflict</code> response. On a 409 failure you should re-initiate the multipart upload with <code>CreateMultipartUpload</code> and re-upload each part.</p>
355 /// <p>Expects the '*' (asterisk) character.</p>
356 /// <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>, or <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html">Conditional requests</a> in the <i>Amazon S3 User Guide</i>.</p>
357 pub fn if_none_match(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
358 self.inner = self.inner.if_none_match(input.into());
359 self
360 }
361 /// <p>Uploads the object only if the object key name does not already exist in the bucket specified. Otherwise, Amazon S3 returns a <code>412 Precondition Failed</code> error.</p>
362 /// <p>If a conflicting operation occurs during the upload S3 returns a <code>409 ConditionalRequestConflict</code> response. On a 409 failure you should re-initiate the multipart upload with <code>CreateMultipartUpload</code> and re-upload each part.</p>
363 /// <p>Expects the '*' (asterisk) character.</p>
364 /// <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>, or <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html">Conditional requests</a> in the <i>Amazon S3 User Guide</i>.</p>
365 pub fn set_if_none_match(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
366 self.inner = self.inner.set_if_none_match(input);
367 self
368 }
369 /// <p>Uploads the object only if the object key name does not already exist in the bucket specified. Otherwise, Amazon S3 returns a <code>412 Precondition Failed</code> error.</p>
370 /// <p>If a conflicting operation occurs during the upload S3 returns a <code>409 ConditionalRequestConflict</code> response. On a 409 failure you should re-initiate the multipart upload with <code>CreateMultipartUpload</code> and re-upload each part.</p>
371 /// <p>Expects the '*' (asterisk) character.</p>
372 /// <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>, or <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html">Conditional requests</a> in the <i>Amazon S3 User Guide</i>.</p>
373 pub fn get_if_none_match(&self) -> &::std::option::Option<::std::string::String> {
374 self.inner.get_if_none_match()
375 }
376 /// <p>The server-side encryption (SSE) algorithm used to encrypt the object. This parameter is required only when the object was created using a checksum algorithm or if your bucket policy requires the use of SSE-C. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html#ssec-require-condition-key">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
377 /// <p>This functionality is not supported for directory buckets.</p>
378 /// </note>
379 pub fn sse_customer_algorithm(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
380 self.inner = self.inner.sse_customer_algorithm(input.into());
381 self
382 }
383 /// <p>The server-side encryption (SSE) algorithm used to encrypt the object. This parameter is required only when the object was created using a checksum algorithm or if your bucket policy requires the use of SSE-C. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html#ssec-require-condition-key">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
384 /// <p>This functionality is not supported for directory buckets.</p>
385 /// </note>
386 pub fn set_sse_customer_algorithm(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
387 self.inner = self.inner.set_sse_customer_algorithm(input);
388 self
389 }
390 /// <p>The server-side encryption (SSE) algorithm used to encrypt the object. This parameter is required only when the object was created using a checksum algorithm or if your bucket policy requires the use of SSE-C. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html#ssec-require-condition-key">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
391 /// <p>This functionality is not supported for directory buckets.</p>
392 /// </note>
393 pub fn get_sse_customer_algorithm(&self) -> &::std::option::Option<::std::string::String> {
394 self.inner.get_sse_customer_algorithm()
395 }
396 /// <p>The server-side encryption (SSE) customer managed key. This parameter is needed only when the object was created using a checksum algorithm. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
397 /// <p>This functionality is not supported for directory buckets.</p>
398 /// </note>
399 pub fn sse_customer_key(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
400 self.inner = self.inner.sse_customer_key(input.into());
401 self
402 }
403 /// <p>The server-side encryption (SSE) customer managed key. This parameter is needed only when the object was created using a checksum algorithm. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
404 /// <p>This functionality is not supported for directory buckets.</p>
405 /// </note>
406 pub fn set_sse_customer_key(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
407 self.inner = self.inner.set_sse_customer_key(input);
408 self
409 }
410 /// <p>The server-side encryption (SSE) customer managed key. This parameter is needed only when the object was created using a checksum algorithm. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
411 /// <p>This functionality is not supported for directory buckets.</p>
412 /// </note>
413 pub fn get_sse_customer_key(&self) -> &::std::option::Option<::std::string::String> {
414 self.inner.get_sse_customer_key()
415 }
416 /// <p>The MD5 server-side encryption (SSE) customer managed key. This parameter is needed only when the object was created using a checksum algorithm. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
417 /// <p>This functionality is not supported for directory buckets.</p>
418 /// </note>
419 pub fn sse_customer_key_md5(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
420 self.inner = self.inner.sse_customer_key_md5(input.into());
421 self
422 }
423 /// <p>The MD5 server-side encryption (SSE) customer managed key. This parameter is needed only when the object was created using a checksum algorithm. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
424 /// <p>This functionality is not supported for directory buckets.</p>
425 /// </note>
426 pub fn set_sse_customer_key_md5(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
427 self.inner = self.inner.set_sse_customer_key_md5(input);
428 self
429 }
430 /// <p>The MD5 server-side encryption (SSE) customer managed key. This parameter is needed only when the object was created using a checksum algorithm. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Protecting data using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p><note>
431 /// <p>This functionality is not supported for directory buckets.</p>
432 /// </note>
433 pub fn get_sse_customer_key_md5(&self) -> &::std::option::Option<::std::string::String> {
434 self.inner.get_sse_customer_key_md5()
435 }
436}