aws_sdk_ec2/operation/enable_snapshot_block_public_access/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::enable_snapshot_block_public_access::_enable_snapshot_block_public_access_output::EnableSnapshotBlockPublicAccessOutputBuilder;
3
4pub use crate::operation::enable_snapshot_block_public_access::_enable_snapshot_block_public_access_input::EnableSnapshotBlockPublicAccessInputBuilder;
5
6impl crate::operation::enable_snapshot_block_public_access::builders::EnableSnapshotBlockPublicAccessInputBuilder {
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::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.enable_snapshot_block_public_access();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `EnableSnapshotBlockPublicAccess`.
24///
25/// <p>Enables or modifies the <i>block public access for snapshots</i> setting at the account level for the specified Amazon Web Services Region. After you enable block public access for snapshots in a Region, users can no longer request public sharing for snapshots in that Region. Snapshots that are already publicly shared are either treated as private or they remain publicly shared, depending on the <b>State</b> that you specify.</p><important>
26/// <p>Enabling block public access for snapshots in <i>block all sharing</i> mode does not change the permissions for snapshots that are already publicly shared. Instead, it prevents these snapshots from be publicly visible and publicly accessible. Therefore, the attributes for these snapshots still indicate that they are publicly shared, even though they are not publicly available.</p>
27/// <p>If you later disable block public access or change the mode to <i>block new sharing</i>, these snapshots will become publicly available again.</p>
28/// </important>
29/// <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/block-public-access-snapshots.html"> Block public access for snapshots</a> in the <i>Amazon EBS User Guide</i>.</p>
30#[derive(::std::clone::Clone, ::std::fmt::Debug)]
31pub struct EnableSnapshotBlockPublicAccessFluentBuilder {
32    handle: ::std::sync::Arc<crate::client::Handle>,
33    inner: crate::operation::enable_snapshot_block_public_access::builders::EnableSnapshotBlockPublicAccessInputBuilder,
34    config_override: ::std::option::Option<crate::config::Builder>,
35}
36impl
37    crate::client::customize::internal::CustomizableSend<
38        crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessOutput,
39        crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessError,
40    > for EnableSnapshotBlockPublicAccessFluentBuilder
41{
42    fn send(
43        self,
44        config_override: crate::config::Builder,
45    ) -> crate::client::customize::internal::BoxFuture<
46        crate::client::customize::internal::SendResult<
47            crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessOutput,
48            crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessError,
49        >,
50    > {
51        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
52    }
53}
54impl EnableSnapshotBlockPublicAccessFluentBuilder {
55    /// Creates a new `EnableSnapshotBlockPublicAccessFluentBuilder`.
56    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
57        Self {
58            handle,
59            inner: ::std::default::Default::default(),
60            config_override: ::std::option::Option::None,
61        }
62    }
63    /// Access the EnableSnapshotBlockPublicAccess as a reference.
64    pub fn as_input(&self) -> &crate::operation::enable_snapshot_block_public_access::builders::EnableSnapshotBlockPublicAccessInputBuilder {
65        &self.inner
66    }
67    /// Sends the request and returns the response.
68    ///
69    /// If an error occurs, an `SdkError` will be returned with additional details that
70    /// can be matched against.
71    ///
72    /// By default, any retryable failures will be retried twice. Retry behavior
73    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
74    /// set when configuring the client.
75    pub async fn send(
76        self,
77    ) -> ::std::result::Result<
78        crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessOutput,
79        ::aws_smithy_runtime_api::client::result::SdkError<
80            crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessError,
81            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
82        >,
83    > {
84        let input = self
85            .inner
86            .build()
87            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
88        let runtime_plugins = crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccess::operation_runtime_plugins(
89            self.handle.runtime_plugins.clone(),
90            &self.handle.conf,
91            self.config_override,
92        );
93        crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccess::orchestrate(&runtime_plugins, input).await
94    }
95
96    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
97    pub fn customize(
98        self,
99    ) -> crate::client::customize::CustomizableOperation<
100        crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessOutput,
101        crate::operation::enable_snapshot_block_public_access::EnableSnapshotBlockPublicAccessError,
102        Self,
103    > {
104        crate::client::customize::CustomizableOperation::new(self)
105    }
106    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
107        self.set_config_override(::std::option::Option::Some(config_override.into()));
108        self
109    }
110
111    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
112        self.config_override = config_override;
113        self
114    }
115    /// <p>The mode in which to enable block public access for snapshots for the Region. Specify one of the following values:</p>
116    /// <ul>
117    /// <li>
118    /// <p><code>block-all-sharing</code> - Prevents all public sharing of snapshots in the Region. Users in the account will no longer be able to request new public sharing. Additionally, snapshots that are already publicly shared are treated as private and they are no longer publicly available.</p></li>
119    /// <li>
120    /// <p><code>block-new-sharing</code> - Prevents only new public sharing of snapshots in the Region. Users in the account will no longer be able to request new public sharing. However, snapshots that are already publicly shared, remain publicly available.</p></li>
121    /// </ul>
122    /// <p><code>unblocked</code> is not a valid value for <b>EnableSnapshotBlockPublicAccess</b>.</p>
123    pub fn state(mut self, input: crate::types::SnapshotBlockPublicAccessState) -> Self {
124        self.inner = self.inner.state(input);
125        self
126    }
127    /// <p>The mode in which to enable block public access for snapshots for the Region. Specify one of the following values:</p>
128    /// <ul>
129    /// <li>
130    /// <p><code>block-all-sharing</code> - Prevents all public sharing of snapshots in the Region. Users in the account will no longer be able to request new public sharing. Additionally, snapshots that are already publicly shared are treated as private and they are no longer publicly available.</p></li>
131    /// <li>
132    /// <p><code>block-new-sharing</code> - Prevents only new public sharing of snapshots in the Region. Users in the account will no longer be able to request new public sharing. However, snapshots that are already publicly shared, remain publicly available.</p></li>
133    /// </ul>
134    /// <p><code>unblocked</code> is not a valid value for <b>EnableSnapshotBlockPublicAccess</b>.</p>
135    pub fn set_state(mut self, input: ::std::option::Option<crate::types::SnapshotBlockPublicAccessState>) -> Self {
136        self.inner = self.inner.set_state(input);
137        self
138    }
139    /// <p>The mode in which to enable block public access for snapshots for the Region. Specify one of the following values:</p>
140    /// <ul>
141    /// <li>
142    /// <p><code>block-all-sharing</code> - Prevents all public sharing of snapshots in the Region. Users in the account will no longer be able to request new public sharing. Additionally, snapshots that are already publicly shared are treated as private and they are no longer publicly available.</p></li>
143    /// <li>
144    /// <p><code>block-new-sharing</code> - Prevents only new public sharing of snapshots in the Region. Users in the account will no longer be able to request new public sharing. However, snapshots that are already publicly shared, remain publicly available.</p></li>
145    /// </ul>
146    /// <p><code>unblocked</code> is not a valid value for <b>EnableSnapshotBlockPublicAccess</b>.</p>
147    pub fn get_state(&self) -> &::std::option::Option<crate::types::SnapshotBlockPublicAccessState> {
148        self.inner.get_state()
149    }
150    /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
151    pub fn dry_run(mut self, input: bool) -> Self {
152        self.inner = self.inner.dry_run(input);
153        self
154    }
155    /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
156    pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
157        self.inner = self.inner.set_dry_run(input);
158        self
159    }
160    /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
161    pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
162        self.inner.get_dry_run()
163    }
164}