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}