aws_sdk_s3/operation/restore_object/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::restore_object::_restore_object_output::RestoreObjectOutputBuilder;
3
4pub use crate::operation::restore_object::_restore_object_input::RestoreObjectInputBuilder;
5
6impl crate::operation::restore_object::builders::RestoreObjectInputBuilder {
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::restore_object::RestoreObjectOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::restore_object::RestoreObjectError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.restore_object();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `RestoreObject`.
24///
25/// <note>
26/// <p>This operation is not supported by directory buckets.</p>
27/// </note> <important>
28/// <p>The <code>SELECT</code> job type for the RestoreObject operation is no longer available to new customers. Existing customers of Amazon S3 Select can continue to use the feature as usual. <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">Learn more</a></p>
29/// </important>
30/// <p>Restores an archived copy of an object back into Amazon S3</p>
31/// <p>This functionality is not supported for Amazon S3 on Outposts.</p>
32/// <p>This action performs the following types of requests:</p>
33/// <ul>
34/// <li>
35/// <p><code>restore an archive</code> - Restore an archived object</p></li>
36/// </ul>
37/// <p>For more information about the <code>S3</code> structure in the request body, see the following:</p>
38/// <ul>
39/// <li>
40/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html">PutObject</a></p></li>
41/// <li>
42/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Managing Access with ACLs</a> in the <i>Amazon S3 User Guide</i></p></li>
43/// <li>
44/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Protecting Data Using Server-Side Encryption</a> in the <i>Amazon S3 User Guide</i></p></li>
45/// </ul>
46/// <dl>
47/// <dt>
48/// Permissions
49/// </dt>
50/// <dd>
51/// <p>To use this operation, you must have permissions to perform the <code>s3:RestoreObject</code> action. The bucket owner has this permission by default and can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3 Resources</a> in the <i>Amazon S3 User Guide</i>.</p>
52/// </dd>
53/// <dt>
54/// Restoring objects
55/// </dt>
56/// <dd>
57/// <p>Objects that you archive to the S3 Glacier Flexible Retrieval Flexible Retrieval or S3 Glacier Deep Archive storage class, and S3 Intelligent-Tiering Archive or S3 Intelligent-Tiering Deep Archive tiers, are not accessible in real time. For objects in the S3 Glacier Flexible Retrieval Flexible Retrieval or S3 Glacier Deep Archive storage classes, you must first initiate a restore request, and then wait until a temporary copy of the object is available. If you want a permanent copy of the object, create a copy of it in the Amazon S3 Standard storage class in your S3 bucket. To access an archived object, you must restore the object for the duration (number of days) that you specify. For objects in the Archive Access or Deep Archive Access tiers of S3 Intelligent-Tiering, you must first initiate a restore request, and then wait until the object is moved into the Frequent Access tier.</p>
58/// <p>To restore a specific object version, you can provide a version ID. If you don't provide a version ID, Amazon S3 restores the current version.</p>
59/// <p>When restoring an archived object, you can specify one of the following data access tier options in the <code>Tier</code> element of the request body:</p>
60/// <ul>
61/// <li>
62/// <p><code>Expedited</code> - Expedited retrievals allow you to quickly access your data stored in the S3 Glacier Flexible Retrieval Flexible Retrieval storage class or S3 Intelligent-Tiering Archive tier when occasional urgent requests for restoring archives are required. For all but the largest archived objects (250 MB+), data accessed using Expedited retrievals is typically made available within 1–5 minutes. Provisioned capacity ensures that retrieval capacity for Expedited retrievals is available when you need it. Expedited retrievals and provisioned capacity are not available for objects stored in the S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier.</p></li>
63/// <li>
64/// <p><code>Standard</code> - Standard retrievals allow you to access any of your archived objects within several hours. This is the default option for retrieval requests that do not specify the retrieval option. Standard retrievals typically finish within 3–5 hours for objects stored in the S3 Glacier Flexible Retrieval Flexible Retrieval storage class or S3 Intelligent-Tiering Archive tier. They typically finish within 12 hours for objects stored in the S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier. Standard retrievals are free for objects stored in S3 Intelligent-Tiering.</p></li>
65/// <li>
66/// <p><code>Bulk</code> - Bulk retrievals free for objects stored in the S3 Glacier Flexible Retrieval and S3 Intelligent-Tiering storage classes, enabling you to retrieve large amounts, even petabytes, of data at no cost. Bulk retrievals typically finish within 5–12 hours for objects stored in the S3 Glacier Flexible Retrieval Flexible Retrieval storage class or S3 Intelligent-Tiering Archive tier. Bulk retrievals are also the lowest-cost retrieval option when restoring objects from S3 Glacier Deep Archive. They typically finish within 48 hours for objects stored in the S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier.</p></li>
67/// </ul>
68/// <p>For more information about archive retrieval options and provisioned capacity for <code>Expedited</code> data access, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html">Restoring Archived Objects</a> in the <i>Amazon S3 User Guide</i>.</p>
69/// <p>You can use Amazon S3 restore speed upgrade to change the restore speed to a faster speed while it is in progress. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html"> Upgrading the speed of an in-progress restore</a> in the <i>Amazon S3 User Guide</i>.</p>
70/// <p>To get the status of object restoration, you can send a <code>HEAD</code> request. Operations return the <code>x-amz-restore</code> header, which provides information about the restoration status, in the response. You can use Amazon S3 event notifications to notify you when a restore is initiated or completed. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Amazon S3 Event Notifications</a> in the <i>Amazon S3 User Guide</i>.</p>
71/// <p>After restoring an archived object, you can update the restoration period by reissuing the request with a new period. Amazon S3 updates the restoration period relative to the current time and charges only for the request-there are no data transfer charges. You cannot update the restoration period when Amazon S3 is actively processing your current restore request for the object.</p>
72/// <p>If your bucket has a lifecycle configuration with a rule that includes an expiration action, the object expiration overrides the life span that you specify in a restore request. For example, if you restore an object copy for 10 days, but the object is scheduled to expire in 3 days, Amazon S3 deletes the object in 3 days. For more information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html">PutBucketLifecycleConfiguration</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle Management</a> in <i>Amazon S3 User Guide</i>.</p>
73/// </dd>
74/// <dt>
75/// Responses
76/// </dt>
77/// <dd>
78/// <p>A successful action returns either the <code>200 OK</code> or <code>202 Accepted</code> status code.</p>
79/// <ul>
80/// <li>
81/// <p>If the object is not previously restored, then Amazon S3 returns <code>202 Accepted</code> in the response.</p></li>
82/// <li>
83/// <p>If the object is previously restored, Amazon S3 returns <code>200 OK</code> in the response.</p></li>
84/// </ul>
85/// <ul>
86/// <li>
87/// <p>Special errors:</p>
88/// <ul>
89/// <li>
90/// <p><i>Code: RestoreAlreadyInProgress</i></p></li>
91/// <li>
92/// <p><i>Cause: Object restore is already in progress.</i></p></li>
93/// <li>
94/// <p><i>HTTP Status Code: 409 Conflict</i></p></li>
95/// <li>
96/// <p><i>SOAP Fault Code Prefix: Client</i></p></li>
97/// </ul></li>
98/// <li>
99/// <ul>
100/// <li>
101/// <p><i>Code: GlacierExpeditedRetrievalNotAvailable</i></p></li>
102/// <li>
103/// <p><i>Cause: expedited retrievals are currently not available. Try again later. (Returned if there is insufficient capacity to process the Expedited request. This error applies only to Expedited retrievals and not to S3 Standard or Bulk retrievals.)</i></p></li>
104/// <li>
105/// <p><i>HTTP Status Code: 503</i></p></li>
106/// <li>
107/// <p><i>SOAP Fault Code Prefix: N/A</i></p></li>
108/// </ul></li>
109/// </ul>
110/// </dd>
111/// </dl>
112/// <p>The following operations are related to <code>RestoreObject</code>:</p>
113/// <ul>
114/// <li>
115/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html">PutBucketLifecycleConfiguration</a></p></li>
116/// <li>
117/// <p><a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html">GetBucketNotificationConfiguration</a></p></li>
118/// </ul>
119#[derive(::std::clone::Clone, ::std::fmt::Debug)]
120pub struct RestoreObjectFluentBuilder {
121 handle: ::std::sync::Arc<crate::client::Handle>,
122 inner: crate::operation::restore_object::builders::RestoreObjectInputBuilder,
123 config_override: ::std::option::Option<crate::config::Builder>,
124}
125impl
126 crate::client::customize::internal::CustomizableSend<
127 crate::operation::restore_object::RestoreObjectOutput,
128 crate::operation::restore_object::RestoreObjectError,
129 > for RestoreObjectFluentBuilder
130{
131 fn send(
132 self,
133 config_override: crate::config::Builder,
134 ) -> crate::client::customize::internal::BoxFuture<
135 crate::client::customize::internal::SendResult<
136 crate::operation::restore_object::RestoreObjectOutput,
137 crate::operation::restore_object::RestoreObjectError,
138 >,
139 > {
140 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
141 }
142}
143impl RestoreObjectFluentBuilder {
144 /// Creates a new `RestoreObjectFluentBuilder`.
145 pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
146 Self {
147 handle,
148 inner: ::std::default::Default::default(),
149 config_override: ::std::option::Option::None,
150 }
151 }
152 /// Access the RestoreObject as a reference.
153 pub fn as_input(&self) -> &crate::operation::restore_object::builders::RestoreObjectInputBuilder {
154 &self.inner
155 }
156 /// Sends the request and returns the response.
157 ///
158 /// If an error occurs, an `SdkError` will be returned with additional details that
159 /// can be matched against.
160 ///
161 /// By default, any retryable failures will be retried twice. Retry behavior
162 /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
163 /// set when configuring the client.
164 pub async fn send(
165 self,
166 ) -> ::std::result::Result<
167 crate::operation::restore_object::RestoreObjectOutput,
168 ::aws_smithy_runtime_api::client::result::SdkError<
169 crate::operation::restore_object::RestoreObjectError,
170 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
171 >,
172 > {
173 let input = self
174 .inner
175 .build()
176 .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
177 let runtime_plugins = crate::operation::restore_object::RestoreObject::operation_runtime_plugins(
178 self.handle.runtime_plugins.clone(),
179 &self.handle.conf,
180 self.config_override,
181 );
182 crate::operation::restore_object::RestoreObject::orchestrate(&runtime_plugins, input).await
183 }
184
185 /// Consumes this builder, creating a customizable operation that can be modified before being sent.
186 pub fn customize(
187 self,
188 ) -> crate::client::customize::CustomizableOperation<
189 crate::operation::restore_object::RestoreObjectOutput,
190 crate::operation::restore_object::RestoreObjectError,
191 Self,
192 > {
193 crate::client::customize::CustomizableOperation::new(self)
194 }
195 pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
196 self.set_config_override(::std::option::Option::Some(config_override.into()));
197 self
198 }
199
200 pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
201 self.config_override = config_override;
202 self
203 }
204 /// <p>The bucket name containing the object to restore.</p>
205 /// <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>
206 /// <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>
207 pub fn bucket(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
208 self.inner = self.inner.bucket(input.into());
209 self
210 }
211 /// <p>The bucket name containing the object to restore.</p>
212 /// <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>
213 /// <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>
214 pub fn set_bucket(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
215 self.inner = self.inner.set_bucket(input);
216 self
217 }
218 /// <p>The bucket name containing the object to restore.</p>
219 /// <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>
220 /// <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>
221 pub fn get_bucket(&self) -> &::std::option::Option<::std::string::String> {
222 self.inner.get_bucket()
223 }
224 /// <p>Object key for which the action was initiated.</p>
225 pub fn key(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
226 self.inner = self.inner.key(input.into());
227 self
228 }
229 /// <p>Object key for which the action was initiated.</p>
230 pub fn set_key(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
231 self.inner = self.inner.set_key(input);
232 self
233 }
234 /// <p>Object key for which the action was initiated.</p>
235 pub fn get_key(&self) -> &::std::option::Option<::std::string::String> {
236 self.inner.get_key()
237 }
238 /// <p>VersionId used to reference a specific version of the object.</p>
239 pub fn version_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
240 self.inner = self.inner.version_id(input.into());
241 self
242 }
243 /// <p>VersionId used to reference a specific version of the object.</p>
244 pub fn set_version_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
245 self.inner = self.inner.set_version_id(input);
246 self
247 }
248 /// <p>VersionId used to reference a specific version of the object.</p>
249 pub fn get_version_id(&self) -> &::std::option::Option<::std::string::String> {
250 self.inner.get_version_id()
251 }
252 /// <p>Container for restore job parameters.</p>
253 pub fn restore_request(mut self, input: crate::types::RestoreRequest) -> Self {
254 self.inner = self.inner.restore_request(input);
255 self
256 }
257 /// <p>Container for restore job parameters.</p>
258 pub fn set_restore_request(mut self, input: ::std::option::Option<crate::types::RestoreRequest>) -> Self {
259 self.inner = self.inner.set_restore_request(input);
260 self
261 }
262 /// <p>Container for restore job parameters.</p>
263 pub fn get_restore_request(&self) -> &::std::option::Option<crate::types::RestoreRequest> {
264 self.inner.get_restore_request()
265 }
266 /// <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>
267 /// <p>This functionality is not supported for directory buckets.</p>
268 /// </note>
269 pub fn request_payer(mut self, input: crate::types::RequestPayer) -> Self {
270 self.inner = self.inner.request_payer(input);
271 self
272 }
273 /// <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>
274 /// <p>This functionality is not supported for directory buckets.</p>
275 /// </note>
276 pub fn set_request_payer(mut self, input: ::std::option::Option<crate::types::RequestPayer>) -> Self {
277 self.inner = self.inner.set_request_payer(input);
278 self
279 }
280 /// <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>
281 /// <p>This functionality is not supported for directory buckets.</p>
282 /// </note>
283 pub fn get_request_payer(&self) -> &::std::option::Option<crate::types::RequestPayer> {
284 self.inner.get_request_payer()
285 }
286 /// <p>Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding <code>x-amz-checksum</code> or <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. 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>
287 /// <p>If you provide an individual checksum, Amazon S3 ignores any provided <code>ChecksumAlgorithm</code> parameter.</p>
288 pub fn checksum_algorithm(mut self, input: crate::types::ChecksumAlgorithm) -> Self {
289 self.inner = self.inner.checksum_algorithm(input);
290 self
291 }
292 /// <p>Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding <code>x-amz-checksum</code> or <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. 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>
293 /// <p>If you provide an individual checksum, Amazon S3 ignores any provided <code>ChecksumAlgorithm</code> parameter.</p>
294 pub fn set_checksum_algorithm(mut self, input: ::std::option::Option<crate::types::ChecksumAlgorithm>) -> Self {
295 self.inner = self.inner.set_checksum_algorithm(input);
296 self
297 }
298 /// <p>Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding <code>x-amz-checksum</code> or <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. 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>
299 /// <p>If you provide an individual checksum, Amazon S3 ignores any provided <code>ChecksumAlgorithm</code> parameter.</p>
300 pub fn get_checksum_algorithm(&self) -> &::std::option::Option<crate::types::ChecksumAlgorithm> {
301 self.inner.get_checksum_algorithm()
302 }
303 /// <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>
304 pub fn expected_bucket_owner(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
305 self.inner = self.inner.expected_bucket_owner(input.into());
306 self
307 }
308 /// <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>
309 pub fn set_expected_bucket_owner(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
310 self.inner = self.inner.set_expected_bucket_owner(input);
311 self
312 }
313 /// <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>
314 pub fn get_expected_bucket_owner(&self) -> &::std::option::Option<::std::string::String> {
315 self.inner.get_expected_bucket_owner()
316 }
317}