aws_sdk_evs/operation/create_environment/_create_environment_input.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2#[allow(missing_docs)] // documentation missing in model
3#[non_exhaustive]
4#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
5pub struct CreateEnvironmentInput {
6 /// <note>
7 /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
8 /// </note>
9 /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the environment creation request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.</p>
10 pub client_token: ::std::option::Option<::std::string::String>,
11 /// <p>The name to give to your environment. The name can contain only alphanumeric characters (case-sensitive), hyphens, and underscores. It must start with an alphanumeric character, and can't be longer than 100 characters. The name must be unique within the Amazon Web Services Region and Amazon Web Services account that you're creating the environment in.</p>
12 pub environment_name: ::std::option::Option<::std::string::String>,
13 /// <p>A unique ID for the customer-managed KMS key that is used to encrypt the VCF credential pairs for SDDC Manager, NSX Manager, and vCenter appliances. These credentials are stored in Amazon Web Services Secrets Manager.</p>
14 pub kms_key_id: ::std::option::Option<::std::string::String>,
15 /// <p>Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or Amazon Web Services resources.</p>
16 pub tags: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>,
17 /// <p>The security group that controls communication between the Amazon EVS control plane and VPC. The default security group is used if a custom security group isn't specified.</p>
18 /// <p>The security group should allow access to the following.</p>
19 /// <ul>
20 /// <li>
21 /// <p>TCP/UDP access to the DNS servers</p></li>
22 /// <li>
23 /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
24 /// <li>
25 /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
26 /// </ul>
27 /// <p>You should avoid modifying the security group rules after deployment, as this can break the persistent connection between the Amazon EVS control plane and VPC. This can cause future environment actions like adding or removing hosts to fail.</p>
28 pub service_access_security_groups: ::std::option::Option<crate::types::ServiceAccessSecurityGroups>,
29 /// <p>A unique ID for the VPC that connects to the environment control plane for service access.</p>
30 /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
31 /// <p>The VPC that you select must have a valid DHCP option set with domain name, at least two DNS servers, and an NTP server. These settings are used to configure your VCF appliances and hosts.</p>
32 /// <p>If you plan to use HCX over the internet, choose a VPC that has a primary CIDR block and a /28 secondary CIDR block from an IPAM pool. Make sure that your VPC also has an attached internet gateway.</p>
33 /// <p>Amazon EVS does not support the following Amazon Web Services networking options for NSX overlay connectivity: cross-Region VPC peering, Amazon S3 gateway endpoints, or Amazon Web Services Direct Connect virtual private gateway associations.</p>
34 pub vpc_id: ::std::option::Option<::std::string::String>,
35 /// <p>The subnet that is used to establish connectivity between the Amazon EVS control plane and VPC. Amazon EVS uses this subnet to validate mandatory DNS records for your VCF appliances and hosts and create the environment.</p>
36 pub service_access_subnet_id: ::std::option::Option<::std::string::String>,
37 /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
38 pub vcf_version: ::std::option::Option<crate::types::VcfVersion>,
39 /// <p>Customer confirmation that the customer has purchased and maintains sufficient VCF software licenses to cover all physical processor cores in the environment, in compliance with VMware's licensing requirements and terms of use.</p>
40 pub terms_accepted: ::std::option::Option<bool>,
41 /// <p>The license information that Amazon EVS requires to create an environment. Amazon EVS requires two license keys: a VCF solution key and a vSAN license key. VCF licenses must have sufficient core entitlements to cover vCPU core and vSAN storage capacity needs.</p>
42 /// <p>VCF licenses can be used for only one Amazon EVS environment. Amazon EVS does not support reuse of VCF licenses for multiple environments.</p>
43 /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
44 pub license_info: ::std::option::Option<::std::vec::Vec<crate::types::LicenseInfo>>,
45 /// <p>The initial VLAN subnets for the environment. You must specify a non-overlapping CIDR block for each VLAN subnet.</p>
46 pub initial_vlans: ::std::option::Option<crate::types::InitialVlans>,
47 /// <p>The ESXi hosts to add to the environment. Amazon EVS requires that you provide details for a minimum of 4 hosts during environment creation.</p>
48 /// <p>For each host, you must provide the desired hostname, EC2 SSH key, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
49 pub hosts: ::std::option::Option<::std::vec::Vec<crate::types::HostInfoForCreate>>,
50 /// <p>The connectivity configuration for the environment. Amazon EVS requires that you specify two route server peer IDs. During environment creation, the route server endpoints peer with the NSX edges over the NSX, providing BGP dynamic routing for overlay networks.</p>
51 pub connectivity_info: ::std::option::Option<crate::types::ConnectivityInfo>,
52 /// <p>The DNS hostnames for the virtual machines that host the VCF management appliances. Amazon EVS requires that you provide DNS hostnames for the following appliances: vCenter, NSX Manager, SDDC Manager, and Cloud Builder.</p>
53 pub vcf_hostnames: ::std::option::Option<crate::types::VcfHostnames>,
54 /// <p>The Broadcom Site ID that is allocated to you as part of your electronic software delivery. This ID allows customer access to the Broadcom portal, and is provided to you by Broadcom at the close of your software contract or contract renewal. Amazon EVS uses the Broadcom Site ID that you provide to meet Broadcom VCF license usage reporting requirements for Amazon EVS.</p>
55 pub site_id: ::std::option::Option<::std::string::String>,
56}
57impl CreateEnvironmentInput {
58 /// <note>
59 /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
60 /// </note>
61 /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the environment creation request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.</p>
62 pub fn client_token(&self) -> ::std::option::Option<&str> {
63 self.client_token.as_deref()
64 }
65 /// <p>The name to give to your environment. The name can contain only alphanumeric characters (case-sensitive), hyphens, and underscores. It must start with an alphanumeric character, and can't be longer than 100 characters. The name must be unique within the Amazon Web Services Region and Amazon Web Services account that you're creating the environment in.</p>
66 pub fn environment_name(&self) -> ::std::option::Option<&str> {
67 self.environment_name.as_deref()
68 }
69 /// <p>A unique ID for the customer-managed KMS key that is used to encrypt the VCF credential pairs for SDDC Manager, NSX Manager, and vCenter appliances. These credentials are stored in Amazon Web Services Secrets Manager.</p>
70 pub fn kms_key_id(&self) -> ::std::option::Option<&str> {
71 self.kms_key_id.as_deref()
72 }
73 /// <p>Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or Amazon Web Services resources.</p>
74 pub fn tags(&self) -> ::std::option::Option<&::std::collections::HashMap<::std::string::String, ::std::string::String>> {
75 self.tags.as_ref()
76 }
77 /// <p>The security group that controls communication between the Amazon EVS control plane and VPC. The default security group is used if a custom security group isn't specified.</p>
78 /// <p>The security group should allow access to the following.</p>
79 /// <ul>
80 /// <li>
81 /// <p>TCP/UDP access to the DNS servers</p></li>
82 /// <li>
83 /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
84 /// <li>
85 /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
86 /// </ul>
87 /// <p>You should avoid modifying the security group rules after deployment, as this can break the persistent connection between the Amazon EVS control plane and VPC. This can cause future environment actions like adding or removing hosts to fail.</p>
88 pub fn service_access_security_groups(&self) -> ::std::option::Option<&crate::types::ServiceAccessSecurityGroups> {
89 self.service_access_security_groups.as_ref()
90 }
91 /// <p>A unique ID for the VPC that connects to the environment control plane for service access.</p>
92 /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
93 /// <p>The VPC that you select must have a valid DHCP option set with domain name, at least two DNS servers, and an NTP server. These settings are used to configure your VCF appliances and hosts.</p>
94 /// <p>If you plan to use HCX over the internet, choose a VPC that has a primary CIDR block and a /28 secondary CIDR block from an IPAM pool. Make sure that your VPC also has an attached internet gateway.</p>
95 /// <p>Amazon EVS does not support the following Amazon Web Services networking options for NSX overlay connectivity: cross-Region VPC peering, Amazon S3 gateway endpoints, or Amazon Web Services Direct Connect virtual private gateway associations.</p>
96 pub fn vpc_id(&self) -> ::std::option::Option<&str> {
97 self.vpc_id.as_deref()
98 }
99 /// <p>The subnet that is used to establish connectivity between the Amazon EVS control plane and VPC. Amazon EVS uses this subnet to validate mandatory DNS records for your VCF appliances and hosts and create the environment.</p>
100 pub fn service_access_subnet_id(&self) -> ::std::option::Option<&str> {
101 self.service_access_subnet_id.as_deref()
102 }
103 /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
104 pub fn vcf_version(&self) -> ::std::option::Option<&crate::types::VcfVersion> {
105 self.vcf_version.as_ref()
106 }
107 /// <p>Customer confirmation that the customer has purchased and maintains sufficient VCF software licenses to cover all physical processor cores in the environment, in compliance with VMware's licensing requirements and terms of use.</p>
108 pub fn terms_accepted(&self) -> ::std::option::Option<bool> {
109 self.terms_accepted
110 }
111 /// <p>The license information that Amazon EVS requires to create an environment. Amazon EVS requires two license keys: a VCF solution key and a vSAN license key. VCF licenses must have sufficient core entitlements to cover vCPU core and vSAN storage capacity needs.</p>
112 /// <p>VCF licenses can be used for only one Amazon EVS environment. Amazon EVS does not support reuse of VCF licenses for multiple environments.</p>
113 /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
114 ///
115 /// If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use `.license_info.is_none()`.
116 pub fn license_info(&self) -> &[crate::types::LicenseInfo] {
117 self.license_info.as_deref().unwrap_or_default()
118 }
119 /// <p>The initial VLAN subnets for the environment. You must specify a non-overlapping CIDR block for each VLAN subnet.</p>
120 pub fn initial_vlans(&self) -> ::std::option::Option<&crate::types::InitialVlans> {
121 self.initial_vlans.as_ref()
122 }
123 /// <p>The ESXi hosts to add to the environment. Amazon EVS requires that you provide details for a minimum of 4 hosts during environment creation.</p>
124 /// <p>For each host, you must provide the desired hostname, EC2 SSH key, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
125 ///
126 /// If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use `.hosts.is_none()`.
127 pub fn hosts(&self) -> &[crate::types::HostInfoForCreate] {
128 self.hosts.as_deref().unwrap_or_default()
129 }
130 /// <p>The connectivity configuration for the environment. Amazon EVS requires that you specify two route server peer IDs. During environment creation, the route server endpoints peer with the NSX edges over the NSX, providing BGP dynamic routing for overlay networks.</p>
131 pub fn connectivity_info(&self) -> ::std::option::Option<&crate::types::ConnectivityInfo> {
132 self.connectivity_info.as_ref()
133 }
134 /// <p>The DNS hostnames for the virtual machines that host the VCF management appliances. Amazon EVS requires that you provide DNS hostnames for the following appliances: vCenter, NSX Manager, SDDC Manager, and Cloud Builder.</p>
135 pub fn vcf_hostnames(&self) -> ::std::option::Option<&crate::types::VcfHostnames> {
136 self.vcf_hostnames.as_ref()
137 }
138 /// <p>The Broadcom Site ID that is allocated to you as part of your electronic software delivery. This ID allows customer access to the Broadcom portal, and is provided to you by Broadcom at the close of your software contract or contract renewal. Amazon EVS uses the Broadcom Site ID that you provide to meet Broadcom VCF license usage reporting requirements for Amazon EVS.</p>
139 pub fn site_id(&self) -> ::std::option::Option<&str> {
140 self.site_id.as_deref()
141 }
142}
143impl CreateEnvironmentInput {
144 /// Creates a new builder-style object to manufacture [`CreateEnvironmentInput`](crate::operation::create_environment::CreateEnvironmentInput).
145 pub fn builder() -> crate::operation::create_environment::builders::CreateEnvironmentInputBuilder {
146 crate::operation::create_environment::builders::CreateEnvironmentInputBuilder::default()
147 }
148}
149
150/// A builder for [`CreateEnvironmentInput`](crate::operation::create_environment::CreateEnvironmentInput).
151#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
152#[non_exhaustive]
153pub struct CreateEnvironmentInputBuilder {
154 pub(crate) client_token: ::std::option::Option<::std::string::String>,
155 pub(crate) environment_name: ::std::option::Option<::std::string::String>,
156 pub(crate) kms_key_id: ::std::option::Option<::std::string::String>,
157 pub(crate) tags: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>,
158 pub(crate) service_access_security_groups: ::std::option::Option<crate::types::ServiceAccessSecurityGroups>,
159 pub(crate) vpc_id: ::std::option::Option<::std::string::String>,
160 pub(crate) service_access_subnet_id: ::std::option::Option<::std::string::String>,
161 pub(crate) vcf_version: ::std::option::Option<crate::types::VcfVersion>,
162 pub(crate) terms_accepted: ::std::option::Option<bool>,
163 pub(crate) license_info: ::std::option::Option<::std::vec::Vec<crate::types::LicenseInfo>>,
164 pub(crate) initial_vlans: ::std::option::Option<crate::types::InitialVlans>,
165 pub(crate) hosts: ::std::option::Option<::std::vec::Vec<crate::types::HostInfoForCreate>>,
166 pub(crate) connectivity_info: ::std::option::Option<crate::types::ConnectivityInfo>,
167 pub(crate) vcf_hostnames: ::std::option::Option<crate::types::VcfHostnames>,
168 pub(crate) site_id: ::std::option::Option<::std::string::String>,
169}
170impl CreateEnvironmentInputBuilder {
171 /// <note>
172 /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
173 /// </note>
174 /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the environment creation request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.</p>
175 pub fn client_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
176 self.client_token = ::std::option::Option::Some(input.into());
177 self
178 }
179 /// <note>
180 /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
181 /// </note>
182 /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the environment creation request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.</p>
183 pub fn set_client_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
184 self.client_token = input;
185 self
186 }
187 /// <note>
188 /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
189 /// </note>
190 /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the environment creation request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.</p>
191 pub fn get_client_token(&self) -> &::std::option::Option<::std::string::String> {
192 &self.client_token
193 }
194 /// <p>The name to give to your environment. The name can contain only alphanumeric characters (case-sensitive), hyphens, and underscores. It must start with an alphanumeric character, and can't be longer than 100 characters. The name must be unique within the Amazon Web Services Region and Amazon Web Services account that you're creating the environment in.</p>
195 pub fn environment_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
196 self.environment_name = ::std::option::Option::Some(input.into());
197 self
198 }
199 /// <p>The name to give to your environment. The name can contain only alphanumeric characters (case-sensitive), hyphens, and underscores. It must start with an alphanumeric character, and can't be longer than 100 characters. The name must be unique within the Amazon Web Services Region and Amazon Web Services account that you're creating the environment in.</p>
200 pub fn set_environment_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
201 self.environment_name = input;
202 self
203 }
204 /// <p>The name to give to your environment. The name can contain only alphanumeric characters (case-sensitive), hyphens, and underscores. It must start with an alphanumeric character, and can't be longer than 100 characters. The name must be unique within the Amazon Web Services Region and Amazon Web Services account that you're creating the environment in.</p>
205 pub fn get_environment_name(&self) -> &::std::option::Option<::std::string::String> {
206 &self.environment_name
207 }
208 /// <p>A unique ID for the customer-managed KMS key that is used to encrypt the VCF credential pairs for SDDC Manager, NSX Manager, and vCenter appliances. These credentials are stored in Amazon Web Services Secrets Manager.</p>
209 pub fn kms_key_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
210 self.kms_key_id = ::std::option::Option::Some(input.into());
211 self
212 }
213 /// <p>A unique ID for the customer-managed KMS key that is used to encrypt the VCF credential pairs for SDDC Manager, NSX Manager, and vCenter appliances. These credentials are stored in Amazon Web Services Secrets Manager.</p>
214 pub fn set_kms_key_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
215 self.kms_key_id = input;
216 self
217 }
218 /// <p>A unique ID for the customer-managed KMS key that is used to encrypt the VCF credential pairs for SDDC Manager, NSX Manager, and vCenter appliances. These credentials are stored in Amazon Web Services Secrets Manager.</p>
219 pub fn get_kms_key_id(&self) -> &::std::option::Option<::std::string::String> {
220 &self.kms_key_id
221 }
222 /// Adds a key-value pair to `tags`.
223 ///
224 /// To override the contents of this collection use [`set_tags`](Self::set_tags).
225 ///
226 /// <p>Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or Amazon Web Services resources.</p>
227 pub fn tags(mut self, k: impl ::std::convert::Into<::std::string::String>, v: impl ::std::convert::Into<::std::string::String>) -> Self {
228 let mut hash_map = self.tags.unwrap_or_default();
229 hash_map.insert(k.into(), v.into());
230 self.tags = ::std::option::Option::Some(hash_map);
231 self
232 }
233 /// <p>Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or Amazon Web Services resources.</p>
234 pub fn set_tags(mut self, input: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>) -> Self {
235 self.tags = input;
236 self
237 }
238 /// <p>Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or Amazon Web Services resources.</p>
239 pub fn get_tags(&self) -> &::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>> {
240 &self.tags
241 }
242 /// <p>The security group that controls communication between the Amazon EVS control plane and VPC. The default security group is used if a custom security group isn't specified.</p>
243 /// <p>The security group should allow access to the following.</p>
244 /// <ul>
245 /// <li>
246 /// <p>TCP/UDP access to the DNS servers</p></li>
247 /// <li>
248 /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
249 /// <li>
250 /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
251 /// </ul>
252 /// <p>You should avoid modifying the security group rules after deployment, as this can break the persistent connection between the Amazon EVS control plane and VPC. This can cause future environment actions like adding or removing hosts to fail.</p>
253 pub fn service_access_security_groups(mut self, input: crate::types::ServiceAccessSecurityGroups) -> Self {
254 self.service_access_security_groups = ::std::option::Option::Some(input);
255 self
256 }
257 /// <p>The security group that controls communication between the Amazon EVS control plane and VPC. The default security group is used if a custom security group isn't specified.</p>
258 /// <p>The security group should allow access to the following.</p>
259 /// <ul>
260 /// <li>
261 /// <p>TCP/UDP access to the DNS servers</p></li>
262 /// <li>
263 /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
264 /// <li>
265 /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
266 /// </ul>
267 /// <p>You should avoid modifying the security group rules after deployment, as this can break the persistent connection between the Amazon EVS control plane and VPC. This can cause future environment actions like adding or removing hosts to fail.</p>
268 pub fn set_service_access_security_groups(mut self, input: ::std::option::Option<crate::types::ServiceAccessSecurityGroups>) -> Self {
269 self.service_access_security_groups = input;
270 self
271 }
272 /// <p>The security group that controls communication between the Amazon EVS control plane and VPC. The default security group is used if a custom security group isn't specified.</p>
273 /// <p>The security group should allow access to the following.</p>
274 /// <ul>
275 /// <li>
276 /// <p>TCP/UDP access to the DNS servers</p></li>
277 /// <li>
278 /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
279 /// <li>
280 /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
281 /// </ul>
282 /// <p>You should avoid modifying the security group rules after deployment, as this can break the persistent connection between the Amazon EVS control plane and VPC. This can cause future environment actions like adding or removing hosts to fail.</p>
283 pub fn get_service_access_security_groups(&self) -> &::std::option::Option<crate::types::ServiceAccessSecurityGroups> {
284 &self.service_access_security_groups
285 }
286 /// <p>A unique ID for the VPC that connects to the environment control plane for service access.</p>
287 /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
288 /// <p>The VPC that you select must have a valid DHCP option set with domain name, at least two DNS servers, and an NTP server. These settings are used to configure your VCF appliances and hosts.</p>
289 /// <p>If you plan to use HCX over the internet, choose a VPC that has a primary CIDR block and a /28 secondary CIDR block from an IPAM pool. Make sure that your VPC also has an attached internet gateway.</p>
290 /// <p>Amazon EVS does not support the following Amazon Web Services networking options for NSX overlay connectivity: cross-Region VPC peering, Amazon S3 gateway endpoints, or Amazon Web Services Direct Connect virtual private gateway associations.</p>
291 /// This field is required.
292 pub fn vpc_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
293 self.vpc_id = ::std::option::Option::Some(input.into());
294 self
295 }
296 /// <p>A unique ID for the VPC that connects to the environment control plane for service access.</p>
297 /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
298 /// <p>The VPC that you select must have a valid DHCP option set with domain name, at least two DNS servers, and an NTP server. These settings are used to configure your VCF appliances and hosts.</p>
299 /// <p>If you plan to use HCX over the internet, choose a VPC that has a primary CIDR block and a /28 secondary CIDR block from an IPAM pool. Make sure that your VPC also has an attached internet gateway.</p>
300 /// <p>Amazon EVS does not support the following Amazon Web Services networking options for NSX overlay connectivity: cross-Region VPC peering, Amazon S3 gateway endpoints, or Amazon Web Services Direct Connect virtual private gateway associations.</p>
301 pub fn set_vpc_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
302 self.vpc_id = input;
303 self
304 }
305 /// <p>A unique ID for the VPC that connects to the environment control plane for service access.</p>
306 /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
307 /// <p>The VPC that you select must have a valid DHCP option set with domain name, at least two DNS servers, and an NTP server. These settings are used to configure your VCF appliances and hosts.</p>
308 /// <p>If you plan to use HCX over the internet, choose a VPC that has a primary CIDR block and a /28 secondary CIDR block from an IPAM pool. Make sure that your VPC also has an attached internet gateway.</p>
309 /// <p>Amazon EVS does not support the following Amazon Web Services networking options for NSX overlay connectivity: cross-Region VPC peering, Amazon S3 gateway endpoints, or Amazon Web Services Direct Connect virtual private gateway associations.</p>
310 pub fn get_vpc_id(&self) -> &::std::option::Option<::std::string::String> {
311 &self.vpc_id
312 }
313 /// <p>The subnet that is used to establish connectivity between the Amazon EVS control plane and VPC. Amazon EVS uses this subnet to validate mandatory DNS records for your VCF appliances and hosts and create the environment.</p>
314 /// This field is required.
315 pub fn service_access_subnet_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
316 self.service_access_subnet_id = ::std::option::Option::Some(input.into());
317 self
318 }
319 /// <p>The subnet that is used to establish connectivity between the Amazon EVS control plane and VPC. Amazon EVS uses this subnet to validate mandatory DNS records for your VCF appliances and hosts and create the environment.</p>
320 pub fn set_service_access_subnet_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
321 self.service_access_subnet_id = input;
322 self
323 }
324 /// <p>The subnet that is used to establish connectivity between the Amazon EVS control plane and VPC. Amazon EVS uses this subnet to validate mandatory DNS records for your VCF appliances and hosts and create the environment.</p>
325 pub fn get_service_access_subnet_id(&self) -> &::std::option::Option<::std::string::String> {
326 &self.service_access_subnet_id
327 }
328 /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
329 /// This field is required.
330 pub fn vcf_version(mut self, input: crate::types::VcfVersion) -> Self {
331 self.vcf_version = ::std::option::Option::Some(input);
332 self
333 }
334 /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
335 pub fn set_vcf_version(mut self, input: ::std::option::Option<crate::types::VcfVersion>) -> Self {
336 self.vcf_version = input;
337 self
338 }
339 /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
340 pub fn get_vcf_version(&self) -> &::std::option::Option<crate::types::VcfVersion> {
341 &self.vcf_version
342 }
343 /// <p>Customer confirmation that the customer has purchased and maintains sufficient VCF software licenses to cover all physical processor cores in the environment, in compliance with VMware's licensing requirements and terms of use.</p>
344 /// This field is required.
345 pub fn terms_accepted(mut self, input: bool) -> Self {
346 self.terms_accepted = ::std::option::Option::Some(input);
347 self
348 }
349 /// <p>Customer confirmation that the customer has purchased and maintains sufficient VCF software licenses to cover all physical processor cores in the environment, in compliance with VMware's licensing requirements and terms of use.</p>
350 pub fn set_terms_accepted(mut self, input: ::std::option::Option<bool>) -> Self {
351 self.terms_accepted = input;
352 self
353 }
354 /// <p>Customer confirmation that the customer has purchased and maintains sufficient VCF software licenses to cover all physical processor cores in the environment, in compliance with VMware's licensing requirements and terms of use.</p>
355 pub fn get_terms_accepted(&self) -> &::std::option::Option<bool> {
356 &self.terms_accepted
357 }
358 /// Appends an item to `license_info`.
359 ///
360 /// To override the contents of this collection use [`set_license_info`](Self::set_license_info).
361 ///
362 /// <p>The license information that Amazon EVS requires to create an environment. Amazon EVS requires two license keys: a VCF solution key and a vSAN license key. VCF licenses must have sufficient core entitlements to cover vCPU core and vSAN storage capacity needs.</p>
363 /// <p>VCF licenses can be used for only one Amazon EVS environment. Amazon EVS does not support reuse of VCF licenses for multiple environments.</p>
364 /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
365 pub fn license_info(mut self, input: crate::types::LicenseInfo) -> Self {
366 let mut v = self.license_info.unwrap_or_default();
367 v.push(input);
368 self.license_info = ::std::option::Option::Some(v);
369 self
370 }
371 /// <p>The license information that Amazon EVS requires to create an environment. Amazon EVS requires two license keys: a VCF solution key and a vSAN license key. VCF licenses must have sufficient core entitlements to cover vCPU core and vSAN storage capacity needs.</p>
372 /// <p>VCF licenses can be used for only one Amazon EVS environment. Amazon EVS does not support reuse of VCF licenses for multiple environments.</p>
373 /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
374 pub fn set_license_info(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::LicenseInfo>>) -> Self {
375 self.license_info = input;
376 self
377 }
378 /// <p>The license information that Amazon EVS requires to create an environment. Amazon EVS requires two license keys: a VCF solution key and a vSAN license key. VCF licenses must have sufficient core entitlements to cover vCPU core and vSAN storage capacity needs.</p>
379 /// <p>VCF licenses can be used for only one Amazon EVS environment. Amazon EVS does not support reuse of VCF licenses for multiple environments.</p>
380 /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
381 pub fn get_license_info(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::LicenseInfo>> {
382 &self.license_info
383 }
384 /// <p>The initial VLAN subnets for the environment. You must specify a non-overlapping CIDR block for each VLAN subnet.</p>
385 /// This field is required.
386 pub fn initial_vlans(mut self, input: crate::types::InitialVlans) -> Self {
387 self.initial_vlans = ::std::option::Option::Some(input);
388 self
389 }
390 /// <p>The initial VLAN subnets for the environment. You must specify a non-overlapping CIDR block for each VLAN subnet.</p>
391 pub fn set_initial_vlans(mut self, input: ::std::option::Option<crate::types::InitialVlans>) -> Self {
392 self.initial_vlans = input;
393 self
394 }
395 /// <p>The initial VLAN subnets for the environment. You must specify a non-overlapping CIDR block for each VLAN subnet.</p>
396 pub fn get_initial_vlans(&self) -> &::std::option::Option<crate::types::InitialVlans> {
397 &self.initial_vlans
398 }
399 /// Appends an item to `hosts`.
400 ///
401 /// To override the contents of this collection use [`set_hosts`](Self::set_hosts).
402 ///
403 /// <p>The ESXi hosts to add to the environment. Amazon EVS requires that you provide details for a minimum of 4 hosts during environment creation.</p>
404 /// <p>For each host, you must provide the desired hostname, EC2 SSH key, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
405 pub fn hosts(mut self, input: crate::types::HostInfoForCreate) -> Self {
406 let mut v = self.hosts.unwrap_or_default();
407 v.push(input);
408 self.hosts = ::std::option::Option::Some(v);
409 self
410 }
411 /// <p>The ESXi hosts to add to the environment. Amazon EVS requires that you provide details for a minimum of 4 hosts during environment creation.</p>
412 /// <p>For each host, you must provide the desired hostname, EC2 SSH key, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
413 pub fn set_hosts(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::HostInfoForCreate>>) -> Self {
414 self.hosts = input;
415 self
416 }
417 /// <p>The ESXi hosts to add to the environment. Amazon EVS requires that you provide details for a minimum of 4 hosts during environment creation.</p>
418 /// <p>For each host, you must provide the desired hostname, EC2 SSH key, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
419 pub fn get_hosts(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::HostInfoForCreate>> {
420 &self.hosts
421 }
422 /// <p>The connectivity configuration for the environment. Amazon EVS requires that you specify two route server peer IDs. During environment creation, the route server endpoints peer with the NSX edges over the NSX, providing BGP dynamic routing for overlay networks.</p>
423 /// This field is required.
424 pub fn connectivity_info(mut self, input: crate::types::ConnectivityInfo) -> Self {
425 self.connectivity_info = ::std::option::Option::Some(input);
426 self
427 }
428 /// <p>The connectivity configuration for the environment. Amazon EVS requires that you specify two route server peer IDs. During environment creation, the route server endpoints peer with the NSX edges over the NSX, providing BGP dynamic routing for overlay networks.</p>
429 pub fn set_connectivity_info(mut self, input: ::std::option::Option<crate::types::ConnectivityInfo>) -> Self {
430 self.connectivity_info = input;
431 self
432 }
433 /// <p>The connectivity configuration for the environment. Amazon EVS requires that you specify two route server peer IDs. During environment creation, the route server endpoints peer with the NSX edges over the NSX, providing BGP dynamic routing for overlay networks.</p>
434 pub fn get_connectivity_info(&self) -> &::std::option::Option<crate::types::ConnectivityInfo> {
435 &self.connectivity_info
436 }
437 /// <p>The DNS hostnames for the virtual machines that host the VCF management appliances. Amazon EVS requires that you provide DNS hostnames for the following appliances: vCenter, NSX Manager, SDDC Manager, and Cloud Builder.</p>
438 /// This field is required.
439 pub fn vcf_hostnames(mut self, input: crate::types::VcfHostnames) -> Self {
440 self.vcf_hostnames = ::std::option::Option::Some(input);
441 self
442 }
443 /// <p>The DNS hostnames for the virtual machines that host the VCF management appliances. Amazon EVS requires that you provide DNS hostnames for the following appliances: vCenter, NSX Manager, SDDC Manager, and Cloud Builder.</p>
444 pub fn set_vcf_hostnames(mut self, input: ::std::option::Option<crate::types::VcfHostnames>) -> Self {
445 self.vcf_hostnames = input;
446 self
447 }
448 /// <p>The DNS hostnames for the virtual machines that host the VCF management appliances. Amazon EVS requires that you provide DNS hostnames for the following appliances: vCenter, NSX Manager, SDDC Manager, and Cloud Builder.</p>
449 pub fn get_vcf_hostnames(&self) -> &::std::option::Option<crate::types::VcfHostnames> {
450 &self.vcf_hostnames
451 }
452 /// <p>The Broadcom Site ID that is allocated to you as part of your electronic software delivery. This ID allows customer access to the Broadcom portal, and is provided to you by Broadcom at the close of your software contract or contract renewal. Amazon EVS uses the Broadcom Site ID that you provide to meet Broadcom VCF license usage reporting requirements for Amazon EVS.</p>
453 /// This field is required.
454 pub fn site_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
455 self.site_id = ::std::option::Option::Some(input.into());
456 self
457 }
458 /// <p>The Broadcom Site ID that is allocated to you as part of your electronic software delivery. This ID allows customer access to the Broadcom portal, and is provided to you by Broadcom at the close of your software contract or contract renewal. Amazon EVS uses the Broadcom Site ID that you provide to meet Broadcom VCF license usage reporting requirements for Amazon EVS.</p>
459 pub fn set_site_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
460 self.site_id = input;
461 self
462 }
463 /// <p>The Broadcom Site ID that is allocated to you as part of your electronic software delivery. This ID allows customer access to the Broadcom portal, and is provided to you by Broadcom at the close of your software contract or contract renewal. Amazon EVS uses the Broadcom Site ID that you provide to meet Broadcom VCF license usage reporting requirements for Amazon EVS.</p>
464 pub fn get_site_id(&self) -> &::std::option::Option<::std::string::String> {
465 &self.site_id
466 }
467 /// Consumes the builder and constructs a [`CreateEnvironmentInput`](crate::operation::create_environment::CreateEnvironmentInput).
468 pub fn build(
469 self,
470 ) -> ::std::result::Result<crate::operation::create_environment::CreateEnvironmentInput, ::aws_smithy_types::error::operation::BuildError> {
471 ::std::result::Result::Ok(crate::operation::create_environment::CreateEnvironmentInput {
472 client_token: self.client_token,
473 environment_name: self.environment_name,
474 kms_key_id: self.kms_key_id,
475 tags: self.tags,
476 service_access_security_groups: self.service_access_security_groups,
477 vpc_id: self.vpc_id,
478 service_access_subnet_id: self.service_access_subnet_id,
479 vcf_version: self.vcf_version,
480 terms_accepted: self.terms_accepted,
481 license_info: self.license_info,
482 initial_vlans: self.initial_vlans,
483 hosts: self.hosts,
484 connectivity_info: self.connectivity_info,
485 vcf_hostnames: self.vcf_hostnames,
486 site_id: self.site_id,
487 })
488 }
489}