aws_sdk_s3/operation/put_bucket_ownership_controls/
builders.rs

Help
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::put_bucket_ownership_controls::_put_bucket_ownership_controls_output::PutBucketOwnershipControlsOutputBuilder;
3
4pub use crate::operation::put_bucket_ownership_controls::_put_bucket_ownership_controls_input::PutBucketOwnershipControlsInputBuilder;
5
6impl crate::operation::put_bucket_ownership_controls::builders::PutBucketOwnershipControlsInputBuilder {
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::put_bucket_ownership_controls::PutBucketOwnershipControlsOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.put_bucket_ownership_controls();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `PutBucketOwnershipControls`.
24///
25/// <note>
26/// <p>This operation is not supported for directory buckets.</p>
27/// </note>
28/// <p>Creates or modifies <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you must have the <code>s3:PutBucketOwnershipControls</code> permission. For more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-with-s3-actions.html">Specifying permissions in a policy</a>.</p>
29/// <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/user-guide/about-object-ownership.html">Using object ownership</a>.</p>
30/// <p>The following operations are related to <code>PutBucketOwnershipControls</code>:</p>
31/// <ul>
32/// <li>
33/// <p><code>GetBucketOwnershipControls</code></p></li>
34/// <li>
35/// <p><code>DeleteBucketOwnershipControls</code></p></li>
36/// </ul>
37#[derive(::std::clone::Clone, ::std::fmt::Debug)]
38pub struct PutBucketOwnershipControlsFluentBuilder {
39    handle: ::std::sync::Arc<crate::client::Handle>,
40    inner: crate::operation::put_bucket_ownership_controls::builders::PutBucketOwnershipControlsInputBuilder,
41    config_override: ::std::option::Option<crate::config::Builder>,
42}
43impl
44    crate::client::customize::internal::CustomizableSend<
45        crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsOutput,
46        crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsError,
47    > for PutBucketOwnershipControlsFluentBuilder
48{
49    fn send(
50        self,
51        config_override: crate::config::Builder,
52    ) -> crate::client::customize::internal::BoxFuture<
53        crate::client::customize::internal::SendResult<
54            crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsOutput,
55            crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsError,
56        >,
57    > {
58        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
59    }
60}
61impl PutBucketOwnershipControlsFluentBuilder {
62    /// Creates a new `PutBucketOwnershipControlsFluentBuilder`.
63    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
64        Self {
65            handle,
66            inner: ::std::default::Default::default(),
67            config_override: ::std::option::Option::None,
68        }
69    }
70    /// Access the PutBucketOwnershipControls as a reference.
71    pub fn as_input(&self) -> &crate::operation::put_bucket_ownership_controls::builders::PutBucketOwnershipControlsInputBuilder {
72        &self.inner
73    }
74    /// Sends the request and returns the response.
75    ///
76    /// If an error occurs, an `SdkError` will be returned with additional details that
77    /// can be matched against.
78    ///
79    /// By default, any retryable failures will be retried twice. Retry behavior
80    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
81    /// set when configuring the client.
82    pub async fn send(
83        self,
84    ) -> ::std::result::Result<
85        crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsOutput,
86        ::aws_smithy_runtime_api::client::result::SdkError<
87            crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsError,
88            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
89        >,
90    > {
91        let input = self
92            .inner
93            .build()
94            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
95        let runtime_plugins = crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControls::operation_runtime_plugins(
96            self.handle.runtime_plugins.clone(),
97            &self.handle.conf,
98            self.config_override,
99        );
100        crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControls::orchestrate(&runtime_plugins, input).await
101    }
102
103    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
104    pub fn customize(
105        self,
106    ) -> crate::client::customize::CustomizableOperation<
107        crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsOutput,
108        crate::operation::put_bucket_ownership_controls::PutBucketOwnershipControlsError,
109        Self,
110    > {
111        crate::client::customize::CustomizableOperation::new(self)
112    }
113    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
114        self.set_config_override(::std::option::Option::Some(config_override.into()));
115        self
116    }
117
118    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
119        self.config_override = config_override;
120        self
121    }
122    /// <p>The name of the Amazon S3 bucket whose <code>OwnershipControls</code> you want to set.</p>
123    pub fn bucket(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
124        self.inner = self.inner.bucket(input.into());
125        self
126    }
127    /// <p>The name of the Amazon S3 bucket whose <code>OwnershipControls</code> you want to set.</p>
128    pub fn set_bucket(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
129        self.inner = self.inner.set_bucket(input);
130        self
131    }
132    /// <p>The name of the Amazon S3 bucket whose <code>OwnershipControls</code> you want to set.</p>
133    pub fn get_bucket(&self) -> &::std::option::Option<::std::string::String> {
134        self.inner.get_bucket()
135    }
136    /// <p>The MD5 hash of the <code>OwnershipControls</code> request body.</p>
137    /// <p>For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.</p>
138    pub fn content_md5(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
139        self.inner = self.inner.content_md5(input.into());
140        self
141    }
142    /// <p>The MD5 hash of the <code>OwnershipControls</code> request body.</p>
143    /// <p>For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.</p>
144    pub fn set_content_md5(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
145        self.inner = self.inner.set_content_md5(input);
146        self
147    }
148    /// <p>The MD5 hash of the <code>OwnershipControls</code> request body.</p>
149    /// <p>For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.</p>
150    pub fn get_content_md5(&self) -> &::std::option::Option<::std::string::String> {
151        self.inner.get_content_md5()
152    }
153    /// <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>
154    pub fn expected_bucket_owner(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
155        self.inner = self.inner.expected_bucket_owner(input.into());
156        self
157    }
158    /// <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>
159    pub fn set_expected_bucket_owner(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
160        self.inner = self.inner.set_expected_bucket_owner(input);
161        self
162    }
163    /// <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>
164    pub fn get_expected_bucket_owner(&self) -> &::std::option::Option<::std::string::String> {
165        self.inner.get_expected_bucket_owner()
166    }
167    /// <p>The <code>OwnershipControls</code> (BucketOwnerEnforced, BucketOwnerPreferred, or ObjectWriter) that you want to apply to this Amazon S3 bucket.</p>
168    pub fn ownership_controls(mut self, input: crate::types::OwnershipControls) -> Self {
169        self.inner = self.inner.ownership_controls(input);
170        self
171    }
172    /// <p>The <code>OwnershipControls</code> (BucketOwnerEnforced, BucketOwnerPreferred, or ObjectWriter) that you want to apply to this Amazon S3 bucket.</p>
173    pub fn set_ownership_controls(mut self, input: ::std::option::Option<crate::types::OwnershipControls>) -> Self {
174        self.inner = self.inner.set_ownership_controls(input);
175        self
176    }
177    /// <p>The <code>OwnershipControls</code> (BucketOwnerEnforced, BucketOwnerPreferred, or ObjectWriter) that you want to apply to this Amazon S3 bucket.</p>
178    pub fn get_ownership_controls(&self) -> &::std::option::Option<crate::types::OwnershipControls> {
179        self.inner.get_ownership_controls()
180    }
181}
aws_sdk_s3/operation/put_bucket_ownership_controls/builders.rs

aws_sdk_s3/operation/put_bucket_ownership_controls/
builders.rs
