aws_sdk_ec2/operation/create_subnet/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_subnet::_create_subnet_output::CreateSubnetOutputBuilder;
3
4pub use crate::operation::create_subnet::_create_subnet_input::CreateSubnetInputBuilder;
5
6impl crate::operation::create_subnet::builders::CreateSubnetInputBuilder {
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::create_subnet::CreateSubnetOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::create_subnet::CreateSubnetError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.create_subnet();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `CreateSubnet`.
24///
25/// <p>Creates a subnet in the specified VPC. For an IPv4 only subnet, specify an IPv4 CIDR block. If the VPC has an IPv6 CIDR block, you can create an IPv6 only subnet or a dual stack subnet instead. For an IPv6 only subnet, specify an IPv6 CIDR block. For a dual stack subnet, specify both an IPv4 CIDR block and an IPv6 CIDR block.</p>
26/// <p>A subnet CIDR block must not overlap the CIDR block of an existing subnet in the VPC. After you create a subnet, you can't change its CIDR block.</p>
27/// <p>The allowed size for an IPv4 subnet is between a /28 netmask (16 IP addresses) and a /16 netmask (65,536 IP addresses). Amazon Web Services reserves both the first four and the last IPv4 address in each subnet's CIDR block. They're not available for your use.</p>
28/// <p>If you've associated an IPv6 CIDR block with your VPC, you can associate an IPv6 CIDR block with a subnet when you create it.</p>
29/// <p>If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.</p>
30/// <p>When you stop an instance in a subnet, it retains its private IPv4 address. It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.</p>
31/// <p>For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html">Subnets</a> in the <i>Amazon VPC User Guide</i>.</p>
32#[derive(::std::clone::Clone, ::std::fmt::Debug)]
33pub struct CreateSubnetFluentBuilder {
34 handle: ::std::sync::Arc<crate::client::Handle>,
35 inner: crate::operation::create_subnet::builders::CreateSubnetInputBuilder,
36 config_override: ::std::option::Option<crate::config::Builder>,
37}
38impl
39 crate::client::customize::internal::CustomizableSend<
40 crate::operation::create_subnet::CreateSubnetOutput,
41 crate::operation::create_subnet::CreateSubnetError,
42 > for CreateSubnetFluentBuilder
43{
44 fn send(
45 self,
46 config_override: crate::config::Builder,
47 ) -> crate::client::customize::internal::BoxFuture<
48 crate::client::customize::internal::SendResult<
49 crate::operation::create_subnet::CreateSubnetOutput,
50 crate::operation::create_subnet::CreateSubnetError,
51 >,
52 > {
53 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
54 }
55}
56impl CreateSubnetFluentBuilder {
57 /// Creates a new `CreateSubnetFluentBuilder`.
58 pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
59 Self {
60 handle,
61 inner: ::std::default::Default::default(),
62 config_override: ::std::option::Option::None,
63 }
64 }
65 /// Access the CreateSubnet as a reference.
66 pub fn as_input(&self) -> &crate::operation::create_subnet::builders::CreateSubnetInputBuilder {
67 &self.inner
68 }
69 /// Sends the request and returns the response.
70 ///
71 /// If an error occurs, an `SdkError` will be returned with additional details that
72 /// can be matched against.
73 ///
74 /// By default, any retryable failures will be retried twice. Retry behavior
75 /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
76 /// set when configuring the client.
77 pub async fn send(
78 self,
79 ) -> ::std::result::Result<
80 crate::operation::create_subnet::CreateSubnetOutput,
81 ::aws_smithy_runtime_api::client::result::SdkError<
82 crate::operation::create_subnet::CreateSubnetError,
83 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
84 >,
85 > {
86 let input = self
87 .inner
88 .build()
89 .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
90 let runtime_plugins = crate::operation::create_subnet::CreateSubnet::operation_runtime_plugins(
91 self.handle.runtime_plugins.clone(),
92 &self.handle.conf,
93 self.config_override,
94 );
95 crate::operation::create_subnet::CreateSubnet::orchestrate(&runtime_plugins, input).await
96 }
97
98 /// Consumes this builder, creating a customizable operation that can be modified before being sent.
99 pub fn customize(
100 self,
101 ) -> crate::client::customize::CustomizableOperation<
102 crate::operation::create_subnet::CreateSubnetOutput,
103 crate::operation::create_subnet::CreateSubnetError,
104 Self,
105 > {
106 crate::client::customize::CustomizableOperation::new(self)
107 }
108 pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
109 self.set_config_override(::std::option::Option::Some(config_override.into()));
110 self
111 }
112
113 pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
114 self.config_override = config_override;
115 self
116 }
117 ///
118 /// Appends an item to `TagSpecifications`.
119 ///
120 /// To override the contents of this collection use [`set_tag_specifications`](Self::set_tag_specifications).
121 ///
122 /// <p>The tags to assign to the subnet.</p>
123 pub fn tag_specifications(mut self, input: crate::types::TagSpecification) -> Self {
124 self.inner = self.inner.tag_specifications(input);
125 self
126 }
127 /// <p>The tags to assign to the subnet.</p>
128 pub fn set_tag_specifications(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::TagSpecification>>) -> Self {
129 self.inner = self.inner.set_tag_specifications(input);
130 self
131 }
132 /// <p>The tags to assign to the subnet.</p>
133 pub fn get_tag_specifications(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::TagSpecification>> {
134 self.inner.get_tag_specifications()
135 }
136 /// <p>The Availability Zone or Local Zone for the subnet.</p>
137 /// <p>Default: Amazon Web Services selects one for you. If you create more than one subnet in your VPC, we do not necessarily select a different zone for each subnet.</p>
138 /// <p>To create a subnet in a Local Zone, set this value to the Local Zone ID, for example <code>us-west-2-lax-1a</code>. For information about the Regions that support Local Zones, see <a href="https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html">Available Local Zones</a>.</p>
139 /// <p>To create a subnet in an Outpost, set this value to the Availability Zone for the Outpost and specify the Outpost ARN.</p>
140 pub fn availability_zone(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
141 self.inner = self.inner.availability_zone(input.into());
142 self
143 }
144 /// <p>The Availability Zone or Local Zone for the subnet.</p>
145 /// <p>Default: Amazon Web Services selects one for you. If you create more than one subnet in your VPC, we do not necessarily select a different zone for each subnet.</p>
146 /// <p>To create a subnet in a Local Zone, set this value to the Local Zone ID, for example <code>us-west-2-lax-1a</code>. For information about the Regions that support Local Zones, see <a href="https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html">Available Local Zones</a>.</p>
147 /// <p>To create a subnet in an Outpost, set this value to the Availability Zone for the Outpost and specify the Outpost ARN.</p>
148 pub fn set_availability_zone(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
149 self.inner = self.inner.set_availability_zone(input);
150 self
151 }
152 /// <p>The Availability Zone or Local Zone for the subnet.</p>
153 /// <p>Default: Amazon Web Services selects one for you. If you create more than one subnet in your VPC, we do not necessarily select a different zone for each subnet.</p>
154 /// <p>To create a subnet in a Local Zone, set this value to the Local Zone ID, for example <code>us-west-2-lax-1a</code>. For information about the Regions that support Local Zones, see <a href="https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html">Available Local Zones</a>.</p>
155 /// <p>To create a subnet in an Outpost, set this value to the Availability Zone for the Outpost and specify the Outpost ARN.</p>
156 pub fn get_availability_zone(&self) -> &::std::option::Option<::std::string::String> {
157 self.inner.get_availability_zone()
158 }
159 /// <p>The AZ ID or the Local Zone ID of the subnet.</p>
160 pub fn availability_zone_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
161 self.inner = self.inner.availability_zone_id(input.into());
162 self
163 }
164 /// <p>The AZ ID or the Local Zone ID of the subnet.</p>
165 pub fn set_availability_zone_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
166 self.inner = self.inner.set_availability_zone_id(input);
167 self
168 }
169 /// <p>The AZ ID or the Local Zone ID of the subnet.</p>
170 pub fn get_availability_zone_id(&self) -> &::std::option::Option<::std::string::String> {
171 self.inner.get_availability_zone_id()
172 }
173 /// <p>The IPv4 network range for the subnet, in CIDR notation. For example, <code>10.0.0.0/24</code>. We modify the specified CIDR block to its canonical form; for example, if you specify <code>100.68.0.18/18</code>, we modify it to <code>100.68.0.0/18</code>.</p>
174 /// <p>This parameter is not supported for an IPv6 only subnet.</p>
175 pub fn cidr_block(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
176 self.inner = self.inner.cidr_block(input.into());
177 self
178 }
179 /// <p>The IPv4 network range for the subnet, in CIDR notation. For example, <code>10.0.0.0/24</code>. We modify the specified CIDR block to its canonical form; for example, if you specify <code>100.68.0.18/18</code>, we modify it to <code>100.68.0.0/18</code>.</p>
180 /// <p>This parameter is not supported for an IPv6 only subnet.</p>
181 pub fn set_cidr_block(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
182 self.inner = self.inner.set_cidr_block(input);
183 self
184 }
185 /// <p>The IPv4 network range for the subnet, in CIDR notation. For example, <code>10.0.0.0/24</code>. We modify the specified CIDR block to its canonical form; for example, if you specify <code>100.68.0.18/18</code>, we modify it to <code>100.68.0.0/18</code>.</p>
186 /// <p>This parameter is not supported for an IPv6 only subnet.</p>
187 pub fn get_cidr_block(&self) -> &::std::option::Option<::std::string::String> {
188 self.inner.get_cidr_block()
189 }
190 /// <p>The IPv6 network range for the subnet, in CIDR notation. This parameter is required for an IPv6 only subnet.</p>
191 pub fn ipv6_cidr_block(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
192 self.inner = self.inner.ipv6_cidr_block(input.into());
193 self
194 }
195 /// <p>The IPv6 network range for the subnet, in CIDR notation. This parameter is required for an IPv6 only subnet.</p>
196 pub fn set_ipv6_cidr_block(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
197 self.inner = self.inner.set_ipv6_cidr_block(input);
198 self
199 }
200 /// <p>The IPv6 network range for the subnet, in CIDR notation. This parameter is required for an IPv6 only subnet.</p>
201 pub fn get_ipv6_cidr_block(&self) -> &::std::option::Option<::std::string::String> {
202 self.inner.get_ipv6_cidr_block()
203 }
204 /// <p>The Amazon Resource Name (ARN) of the Outpost. If you specify an Outpost ARN, you must also specify the Availability Zone of the Outpost subnet.</p>
205 pub fn outpost_arn(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
206 self.inner = self.inner.outpost_arn(input.into());
207 self
208 }
209 /// <p>The Amazon Resource Name (ARN) of the Outpost. If you specify an Outpost ARN, you must also specify the Availability Zone of the Outpost subnet.</p>
210 pub fn set_outpost_arn(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
211 self.inner = self.inner.set_outpost_arn(input);
212 self
213 }
214 /// <p>The Amazon Resource Name (ARN) of the Outpost. If you specify an Outpost ARN, you must also specify the Availability Zone of the Outpost subnet.</p>
215 pub fn get_outpost_arn(&self) -> &::std::option::Option<::std::string::String> {
216 self.inner.get_outpost_arn()
217 }
218 /// <p>The ID of the VPC.</p>
219 pub fn vpc_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
220 self.inner = self.inner.vpc_id(input.into());
221 self
222 }
223 /// <p>The ID of the VPC.</p>
224 pub fn set_vpc_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
225 self.inner = self.inner.set_vpc_id(input);
226 self
227 }
228 /// <p>The ID of the VPC.</p>
229 pub fn get_vpc_id(&self) -> &::std::option::Option<::std::string::String> {
230 self.inner.get_vpc_id()
231 }
232 /// <p>Indicates whether to create an IPv6 only subnet.</p>
233 pub fn ipv6_native(mut self, input: bool) -> Self {
234 self.inner = self.inner.ipv6_native(input);
235 self
236 }
237 /// <p>Indicates whether to create an IPv6 only subnet.</p>
238 pub fn set_ipv6_native(mut self, input: ::std::option::Option<bool>) -> Self {
239 self.inner = self.inner.set_ipv6_native(input);
240 self
241 }
242 /// <p>Indicates whether to create an IPv6 only subnet.</p>
243 pub fn get_ipv6_native(&self) -> &::std::option::Option<bool> {
244 self.inner.get_ipv6_native()
245 }
246 /// <p>An IPv4 IPAM pool ID for the subnet.</p>
247 pub fn ipv4_ipam_pool_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
248 self.inner = self.inner.ipv4_ipam_pool_id(input.into());
249 self
250 }
251 /// <p>An IPv4 IPAM pool ID for the subnet.</p>
252 pub fn set_ipv4_ipam_pool_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
253 self.inner = self.inner.set_ipv4_ipam_pool_id(input);
254 self
255 }
256 /// <p>An IPv4 IPAM pool ID for the subnet.</p>
257 pub fn get_ipv4_ipam_pool_id(&self) -> &::std::option::Option<::std::string::String> {
258 self.inner.get_ipv4_ipam_pool_id()
259 }
260 /// <p>An IPv4 netmask length for the subnet.</p>
261 pub fn ipv4_netmask_length(mut self, input: i32) -> Self {
262 self.inner = self.inner.ipv4_netmask_length(input);
263 self
264 }
265 /// <p>An IPv4 netmask length for the subnet.</p>
266 pub fn set_ipv4_netmask_length(mut self, input: ::std::option::Option<i32>) -> Self {
267 self.inner = self.inner.set_ipv4_netmask_length(input);
268 self
269 }
270 /// <p>An IPv4 netmask length for the subnet.</p>
271 pub fn get_ipv4_netmask_length(&self) -> &::std::option::Option<i32> {
272 self.inner.get_ipv4_netmask_length()
273 }
274 /// <p>An IPv6 IPAM pool ID for the subnet.</p>
275 pub fn ipv6_ipam_pool_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
276 self.inner = self.inner.ipv6_ipam_pool_id(input.into());
277 self
278 }
279 /// <p>An IPv6 IPAM pool ID for the subnet.</p>
280 pub fn set_ipv6_ipam_pool_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
281 self.inner = self.inner.set_ipv6_ipam_pool_id(input);
282 self
283 }
284 /// <p>An IPv6 IPAM pool ID for the subnet.</p>
285 pub fn get_ipv6_ipam_pool_id(&self) -> &::std::option::Option<::std::string::String> {
286 self.inner.get_ipv6_ipam_pool_id()
287 }
288 /// <p>An IPv6 netmask length for the subnet.</p>
289 pub fn ipv6_netmask_length(mut self, input: i32) -> Self {
290 self.inner = self.inner.ipv6_netmask_length(input);
291 self
292 }
293 /// <p>An IPv6 netmask length for the subnet.</p>
294 pub fn set_ipv6_netmask_length(mut self, input: ::std::option::Option<i32>) -> Self {
295 self.inner = self.inner.set_ipv6_netmask_length(input);
296 self
297 }
298 /// <p>An IPv6 netmask length for the subnet.</p>
299 pub fn get_ipv6_netmask_length(&self) -> &::std::option::Option<i32> {
300 self.inner.get_ipv6_netmask_length()
301 }
302 /// <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>
303 pub fn dry_run(mut self, input: bool) -> Self {
304 self.inner = self.inner.dry_run(input);
305 self
306 }
307 /// <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>
308 pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
309 self.inner = self.inner.set_dry_run(input);
310 self
311 }
312 /// <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>
313 pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
314 self.inner.get_dry_run()
315 }
316}