aws_sdk_s3/operation/get_bucket_ownership_controls/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::get_bucket_ownership_controls::_get_bucket_ownership_controls_output::GetBucketOwnershipControlsOutputBuilder;
3
4pub use crate::operation::get_bucket_ownership_controls::_get_bucket_ownership_controls_input::GetBucketOwnershipControlsInputBuilder;
5
6impl crate::operation::get_bucket_ownership_controls::builders::GetBucketOwnershipControlsInputBuilder {
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::get_bucket_ownership_controls::GetBucketOwnershipControlsOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::get_bucket_ownership_controls::GetBucketOwnershipControlsError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.get_bucket_ownership_controls();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `GetBucketOwnershipControls`.
24///
25/// <note>
26/// <p>This operation is not supported for directory buckets.</p>
27/// </note>
28/// <p>Retrieves <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you must have the <code>s3:GetBucketOwnershipControls</code> permission. For more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/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/userguide/about-object-ownership.html">Using Object Ownership</a>.</p>
30/// <p>The following operations are related to <code>GetBucketOwnershipControls</code>:</p>
31/// <ul>
32/// <li>
33/// <p><code>PutBucketOwnershipControls</code></p></li>
34/// <li>
35/// <p><code>DeleteBucketOwnershipControls</code></p></li>
36/// </ul>
37#[derive(::std::clone::Clone, ::std::fmt::Debug)]
38pub struct GetBucketOwnershipControlsFluentBuilder {
39    handle: ::std::sync::Arc<crate::client::Handle>,
40    inner: crate::operation::get_bucket_ownership_controls::builders::GetBucketOwnershipControlsInputBuilder,
41    config_override: ::std::option::Option<crate::config::Builder>,
42}
43impl
44    crate::client::customize::internal::CustomizableSend<
45        crate::operation::get_bucket_ownership_controls::GetBucketOwnershipControlsOutput,
46        crate::operation::get_bucket_ownership_controls::GetBucketOwnershipControlsError,
47    > for GetBucketOwnershipControlsFluentBuilder
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::get_bucket_ownership_controls::GetBucketOwnershipControlsOutput,
55            crate::operation::get_bucket_ownership_controls::GetBucketOwnershipControlsError,
56        >,
57    > {
58        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
59    }
60}
61impl GetBucketOwnershipControlsFluentBuilder {
62    /// Creates a new `GetBucketOwnershipControlsFluentBuilder`.
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 GetBucketOwnershipControls as a reference.
71    pub fn as_input(&self) -> &crate::operation::get_bucket_ownership_controls::builders::GetBucketOwnershipControlsInputBuilder {
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::get_bucket_ownership_controls::GetBucketOwnershipControlsOutput,
86        ::aws_smithy_runtime_api::client::result::SdkError<
87            crate::operation::get_bucket_ownership_controls::GetBucketOwnershipControlsError,
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::get_bucket_ownership_controls::GetBucketOwnershipControls::operation_runtime_plugins(
96            self.handle.runtime_plugins.clone(),
97            &self.handle.conf,
98            self.config_override,
99        );
100        crate::operation::get_bucket_ownership_controls::GetBucketOwnershipControls::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::get_bucket_ownership_controls::GetBucketOwnershipControlsOutput,
108        crate::operation::get_bucket_ownership_controls::GetBucketOwnershipControlsError,
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 retrieve.</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 retrieve.</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 retrieve.</p>
133    pub fn get_bucket(&self) -> &::std::option::Option<::std::string::String> {
134        self.inner.get_bucket()
135    }
136    /// <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>
137    pub fn expected_bucket_owner(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
138        self.inner = self.inner.expected_bucket_owner(input.into());
139        self
140    }
141    /// <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>
142    pub fn set_expected_bucket_owner(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
143        self.inner = self.inner.set_expected_bucket_owner(input);
144        self
145    }
146    /// <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>
147    pub fn get_expected_bucket_owner(&self) -> &::std::option::Option<::std::string::String> {
148        self.inner.get_expected_bucket_owner()
149    }
150}