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}