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 the environment is deployed inside.</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 specify 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. The VPC cannot be used with any other deployed Amazon EVS environment. Amazon EVS does not provide multi-VPC support for environments at this time.</p>
32    /// <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><note>
33    /// <p>Ensure that you specify a VPC that is adequately sized to accommodate the {evws} subnets.</p>
34    /// </note>
35    pub vpc_id: ::std::option::Option<::std::string::String>,
36    /// <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>
37    pub service_access_subnet_id: ::std::option::Option<::std::string::String>,
38    /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
39    pub vcf_version: ::std::option::Option<crate::types::VcfVersion>,
40    /// <p>Customer confirmation that the customer has purchased and will continue to maintain the required number of VCF software licenses to cover all physical processor cores in the Amazon EVS environment. Information about your VCF software in Amazon EVS will be shared with Broadcom to verify license compliance. Amazon EVS does not validate license keys. To validate license keys, visit the Broadcom support portal.</p>
41    pub terms_accepted: ::std::option::Option<bool>,
42    /// <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. The VCF solution key must cover a minimum of 256 cores. The vSAN license key must provide at least 110 TiB of vSAN capacity.</p>
43    /// <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>
44    /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
45    pub license_info: ::std::option::Option<::std::vec::Vec<crate::types::LicenseInfo>>,
46    /// <p>The initial VLAN subnets for the Amazon EVS environment.</p><note>
47    /// <p>For each Amazon EVS VLAN subnet, you must specify a non-overlapping CIDR block. Amazon EVS VLAN subnets have a minimum CIDR block size of /28 and a maximum size of /24.</p>
48    /// </note>
49    pub initial_vlans: ::std::option::Option<crate::types::InitialVlans>,
50    /// <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>
51    /// <p>For each host, you must provide the desired hostname, EC2 SSH keypair name, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
52    pub hosts: ::std::option::Option<::std::vec::Vec<crate::types::HostInfoForCreate>>,
53    /// <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 uplink subnet, providing BGP-based dynamic routing for overlay networks.</p>
54    pub connectivity_info: ::std::option::Option<crate::types::ConnectivityInfo>,
55    /// <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>
56    pub vcf_hostnames: ::std::option::Option<crate::types::VcfHostnames>,
57    /// <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>
58    pub site_id: ::std::option::Option<::std::string::String>,
59}
60impl CreateEnvironmentInput {
61    /// <note>
62    /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
63    /// </note>
64    /// <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>
65    pub fn client_token(&self) -> ::std::option::Option<&str> {
66        self.client_token.as_deref()
67    }
68    /// <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>
69    pub fn environment_name(&self) -> ::std::option::Option<&str> {
70        self.environment_name.as_deref()
71    }
72    /// <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>
73    pub fn kms_key_id(&self) -> ::std::option::Option<&str> {
74        self.kms_key_id.as_deref()
75    }
76    /// <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>
77    pub fn tags(&self) -> ::std::option::Option<&::std::collections::HashMap<::std::string::String, ::std::string::String>> {
78        self.tags.as_ref()
79    }
80    /// <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>
81    /// <p>The security group should allow access to the following.</p>
82    /// <ul>
83    /// <li>
84    /// <p>TCP/UDP access to the DNS servers</p></li>
85    /// <li>
86    /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
87    /// <li>
88    /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
89    /// </ul>
90    /// <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>
91    pub fn service_access_security_groups(&self) -> ::std::option::Option<&crate::types::ServiceAccessSecurityGroups> {
92        self.service_access_security_groups.as_ref()
93    }
94    /// <p>A unique ID for the VPC that the environment is deployed inside.</p>
95    /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
96    /// <p>The VPC that you specify 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. The VPC cannot be used with any other deployed Amazon EVS environment. Amazon EVS does not provide multi-VPC support for environments at this time.</p>
97    /// <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><note>
98    /// <p>Ensure that you specify a VPC that is adequately sized to accommodate the {evws} subnets.</p>
99    /// </note>
100    pub fn vpc_id(&self) -> ::std::option::Option<&str> {
101        self.vpc_id.as_deref()
102    }
103    /// <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>
104    pub fn service_access_subnet_id(&self) -> ::std::option::Option<&str> {
105        self.service_access_subnet_id.as_deref()
106    }
107    /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
108    pub fn vcf_version(&self) -> ::std::option::Option<&crate::types::VcfVersion> {
109        self.vcf_version.as_ref()
110    }
111    /// <p>Customer confirmation that the customer has purchased and will continue to maintain the required number of VCF software licenses to cover all physical processor cores in the Amazon EVS environment. Information about your VCF software in Amazon EVS will be shared with Broadcom to verify license compliance. Amazon EVS does not validate license keys. To validate license keys, visit the Broadcom support portal.</p>
112    pub fn terms_accepted(&self) -> ::std::option::Option<bool> {
113        self.terms_accepted
114    }
115    /// <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. The VCF solution key must cover a minimum of 256 cores. The vSAN license key must provide at least 110 TiB of vSAN capacity.</p>
116    /// <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>
117    /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
118    ///
119    /// 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()`.
120    pub fn license_info(&self) -> &[crate::types::LicenseInfo] {
121        self.license_info.as_deref().unwrap_or_default()
122    }
123    /// <p>The initial VLAN subnets for the Amazon EVS environment.</p><note>
124    /// <p>For each Amazon EVS VLAN subnet, you must specify a non-overlapping CIDR block. Amazon EVS VLAN subnets have a minimum CIDR block size of /28 and a maximum size of /24.</p>
125    /// </note>
126    pub fn initial_vlans(&self) -> ::std::option::Option<&crate::types::InitialVlans> {
127        self.initial_vlans.as_ref()
128    }
129    /// <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>
130    /// <p>For each host, you must provide the desired hostname, EC2 SSH keypair name, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
131    ///
132    /// 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()`.
133    pub fn hosts(&self) -> &[crate::types::HostInfoForCreate] {
134        self.hosts.as_deref().unwrap_or_default()
135    }
136    /// <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 uplink subnet, providing BGP-based dynamic routing for overlay networks.</p>
137    pub fn connectivity_info(&self) -> ::std::option::Option<&crate::types::ConnectivityInfo> {
138        self.connectivity_info.as_ref()
139    }
140    /// <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>
141    pub fn vcf_hostnames(&self) -> ::std::option::Option<&crate::types::VcfHostnames> {
142        self.vcf_hostnames.as_ref()
143    }
144    /// <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>
145    pub fn site_id(&self) -> ::std::option::Option<&str> {
146        self.site_id.as_deref()
147    }
148}
149impl CreateEnvironmentInput {
150    /// Creates a new builder-style object to manufacture [`CreateEnvironmentInput`](crate::operation::create_environment::CreateEnvironmentInput).
151    pub fn builder() -> crate::operation::create_environment::builders::CreateEnvironmentInputBuilder {
152        crate::operation::create_environment::builders::CreateEnvironmentInputBuilder::default()
153    }
154}
155
156/// A builder for [`CreateEnvironmentInput`](crate::operation::create_environment::CreateEnvironmentInput).
157#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
158#[non_exhaustive]
159pub struct CreateEnvironmentInputBuilder {
160    pub(crate) client_token: ::std::option::Option<::std::string::String>,
161    pub(crate) environment_name: ::std::option::Option<::std::string::String>,
162    pub(crate) kms_key_id: ::std::option::Option<::std::string::String>,
163    pub(crate) tags: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>,
164    pub(crate) service_access_security_groups: ::std::option::Option<crate::types::ServiceAccessSecurityGroups>,
165    pub(crate) vpc_id: ::std::option::Option<::std::string::String>,
166    pub(crate) service_access_subnet_id: ::std::option::Option<::std::string::String>,
167    pub(crate) vcf_version: ::std::option::Option<crate::types::VcfVersion>,
168    pub(crate) terms_accepted: ::std::option::Option<bool>,
169    pub(crate) license_info: ::std::option::Option<::std::vec::Vec<crate::types::LicenseInfo>>,
170    pub(crate) initial_vlans: ::std::option::Option<crate::types::InitialVlans>,
171    pub(crate) hosts: ::std::option::Option<::std::vec::Vec<crate::types::HostInfoForCreate>>,
172    pub(crate) connectivity_info: ::std::option::Option<crate::types::ConnectivityInfo>,
173    pub(crate) vcf_hostnames: ::std::option::Option<crate::types::VcfHostnames>,
174    pub(crate) site_id: ::std::option::Option<::std::string::String>,
175}
176impl CreateEnvironmentInputBuilder {
177    /// <note>
178    /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
179    /// </note>
180    /// <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>
181    pub fn client_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
182        self.client_token = ::std::option::Option::Some(input.into());
183        self
184    }
185    /// <note>
186    /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
187    /// </note>
188    /// <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>
189    pub fn set_client_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
190        self.client_token = input;
191        self
192    }
193    /// <note>
194    /// <p>This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.</p>
195    /// </note>
196    /// <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>
197    pub fn get_client_token(&self) -> &::std::option::Option<::std::string::String> {
198        &self.client_token
199    }
200    /// <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>
201    pub fn environment_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
202        self.environment_name = ::std::option::Option::Some(input.into());
203        self
204    }
205    /// <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>
206    pub fn set_environment_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
207        self.environment_name = input;
208        self
209    }
210    /// <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>
211    pub fn get_environment_name(&self) -> &::std::option::Option<::std::string::String> {
212        &self.environment_name
213    }
214    /// <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>
215    pub fn kms_key_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
216        self.kms_key_id = ::std::option::Option::Some(input.into());
217        self
218    }
219    /// <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>
220    pub fn set_kms_key_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
221        self.kms_key_id = input;
222        self
223    }
224    /// <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>
225    pub fn get_kms_key_id(&self) -> &::std::option::Option<::std::string::String> {
226        &self.kms_key_id
227    }
228    /// Adds a key-value pair to `tags`.
229    ///
230    /// To override the contents of this collection use [`set_tags`](Self::set_tags).
231    ///
232    /// <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>
233    pub fn tags(mut self, k: impl ::std::convert::Into<::std::string::String>, v: impl ::std::convert::Into<::std::string::String>) -> Self {
234        let mut hash_map = self.tags.unwrap_or_default();
235        hash_map.insert(k.into(), v.into());
236        self.tags = ::std::option::Option::Some(hash_map);
237        self
238    }
239    /// <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>
240    pub fn set_tags(mut self, input: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>) -> Self {
241        self.tags = input;
242        self
243    }
244    /// <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>
245    pub fn get_tags(&self) -> &::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>> {
246        &self.tags
247    }
248    /// <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>
249    /// <p>The security group should allow access to the following.</p>
250    /// <ul>
251    /// <li>
252    /// <p>TCP/UDP access to the DNS servers</p></li>
253    /// <li>
254    /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
255    /// <li>
256    /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
257    /// </ul>
258    /// <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>
259    pub fn service_access_security_groups(mut self, input: crate::types::ServiceAccessSecurityGroups) -> Self {
260        self.service_access_security_groups = ::std::option::Option::Some(input);
261        self
262    }
263    /// <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>
264    /// <p>The security group should allow access to the following.</p>
265    /// <ul>
266    /// <li>
267    /// <p>TCP/UDP access to the DNS servers</p></li>
268    /// <li>
269    /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
270    /// <li>
271    /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
272    /// </ul>
273    /// <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>
274    pub fn set_service_access_security_groups(mut self, input: ::std::option::Option<crate::types::ServiceAccessSecurityGroups>) -> Self {
275        self.service_access_security_groups = input;
276        self
277    }
278    /// <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>
279    /// <p>The security group should allow access to the following.</p>
280    /// <ul>
281    /// <li>
282    /// <p>TCP/UDP access to the DNS servers</p></li>
283    /// <li>
284    /// <p>HTTPS/SSH access to the host management VLAN subnet</p></li>
285    /// <li>
286    /// <p>HTTPS/SSH access to the Management VM VLAN subnet</p></li>
287    /// </ul>
288    /// <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>
289    pub fn get_service_access_security_groups(&self) -> &::std::option::Option<crate::types::ServiceAccessSecurityGroups> {
290        &self.service_access_security_groups
291    }
292    /// <p>A unique ID for the VPC that the environment is deployed inside.</p>
293    /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
294    /// <p>The VPC that you specify 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. The VPC cannot be used with any other deployed Amazon EVS environment. Amazon EVS does not provide multi-VPC support for environments at this time.</p>
295    /// <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><note>
296    /// <p>Ensure that you specify a VPC that is adequately sized to accommodate the {evws} subnets.</p>
297    /// </note>
298    /// This field is required.
299    pub fn vpc_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
300        self.vpc_id = ::std::option::Option::Some(input.into());
301        self
302    }
303    /// <p>A unique ID for the VPC that the environment is deployed inside.</p>
304    /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
305    /// <p>The VPC that you specify 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. The VPC cannot be used with any other deployed Amazon EVS environment. Amazon EVS does not provide multi-VPC support for environments at this time.</p>
306    /// <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><note>
307    /// <p>Ensure that you specify a VPC that is adequately sized to accommodate the {evws} subnets.</p>
308    /// </note>
309    pub fn set_vpc_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
310        self.vpc_id = input;
311        self
312    }
313    /// <p>A unique ID for the VPC that the environment is deployed inside.</p>
314    /// <p>Amazon EVS requires that all VPC subnets exist in a single Availability Zone in a Region where the service is available.</p>
315    /// <p>The VPC that you specify 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. The VPC cannot be used with any other deployed Amazon EVS environment. Amazon EVS does not provide multi-VPC support for environments at this time.</p>
316    /// <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><note>
317    /// <p>Ensure that you specify a VPC that is adequately sized to accommodate the {evws} subnets.</p>
318    /// </note>
319    pub fn get_vpc_id(&self) -> &::std::option::Option<::std::string::String> {
320        &self.vpc_id
321    }
322    /// <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>
323    /// This field is required.
324    pub fn service_access_subnet_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
325        self.service_access_subnet_id = ::std::option::Option::Some(input.into());
326        self
327    }
328    /// <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>
329    pub fn set_service_access_subnet_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
330        self.service_access_subnet_id = input;
331        self
332    }
333    /// <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>
334    pub fn get_service_access_subnet_id(&self) -> &::std::option::Option<::std::string::String> {
335        &self.service_access_subnet_id
336    }
337    /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
338    /// This field is required.
339    pub fn vcf_version(mut self, input: crate::types::VcfVersion) -> Self {
340        self.vcf_version = ::std::option::Option::Some(input);
341        self
342    }
343    /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
344    pub fn set_vcf_version(mut self, input: ::std::option::Option<crate::types::VcfVersion>) -> Self {
345        self.vcf_version = input;
346        self
347    }
348    /// <p>The VCF version to use for the environment. Amazon EVS only supports VCF version 5.2.1 at this time.</p>
349    pub fn get_vcf_version(&self) -> &::std::option::Option<crate::types::VcfVersion> {
350        &self.vcf_version
351    }
352    /// <p>Customer confirmation that the customer has purchased and will continue to maintain the required number of VCF software licenses to cover all physical processor cores in the Amazon EVS environment. Information about your VCF software in Amazon EVS will be shared with Broadcom to verify license compliance. Amazon EVS does not validate license keys. To validate license keys, visit the Broadcom support portal.</p>
353    /// This field is required.
354    pub fn terms_accepted(mut self, input: bool) -> Self {
355        self.terms_accepted = ::std::option::Option::Some(input);
356        self
357    }
358    /// <p>Customer confirmation that the customer has purchased and will continue to maintain the required number of VCF software licenses to cover all physical processor cores in the Amazon EVS environment. Information about your VCF software in Amazon EVS will be shared with Broadcom to verify license compliance. Amazon EVS does not validate license keys. To validate license keys, visit the Broadcom support portal.</p>
359    pub fn set_terms_accepted(mut self, input: ::std::option::Option<bool>) -> Self {
360        self.terms_accepted = input;
361        self
362    }
363    /// <p>Customer confirmation that the customer has purchased and will continue to maintain the required number of VCF software licenses to cover all physical processor cores in the Amazon EVS environment. Information about your VCF software in Amazon EVS will be shared with Broadcom to verify license compliance. Amazon EVS does not validate license keys. To validate license keys, visit the Broadcom support portal.</p>
364    pub fn get_terms_accepted(&self) -> &::std::option::Option<bool> {
365        &self.terms_accepted
366    }
367    /// Appends an item to `license_info`.
368    ///
369    /// To override the contents of this collection use [`set_license_info`](Self::set_license_info).
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. The VCF solution key must cover a minimum of 256 cores. The vSAN license key must provide at least 110 TiB of vSAN capacity.</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 license_info(mut self, input: crate::types::LicenseInfo) -> Self {
375        let mut v = self.license_info.unwrap_or_default();
376        v.push(input);
377        self.license_info = ::std::option::Option::Some(v);
378        self
379    }
380    /// <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. The VCF solution key must cover a minimum of 256 cores. The vSAN license key must provide at least 110 TiB of vSAN capacity.</p>
381    /// <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>
382    /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
383    pub fn set_license_info(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::LicenseInfo>>) -> Self {
384        self.license_info = input;
385        self
386    }
387    /// <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. The VCF solution key must cover a minimum of 256 cores. The vSAN license key must provide at least 110 TiB of vSAN capacity.</p>
388    /// <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>
389    /// <p>VCF license information can be retrieved from the Broadcom portal.</p>
390    pub fn get_license_info(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::LicenseInfo>> {
391        &self.license_info
392    }
393    /// <p>The initial VLAN subnets for the Amazon EVS environment.</p><note>
394    /// <p>For each Amazon EVS VLAN subnet, you must specify a non-overlapping CIDR block. Amazon EVS VLAN subnets have a minimum CIDR block size of /28 and a maximum size of /24.</p>
395    /// </note>
396    /// This field is required.
397    pub fn initial_vlans(mut self, input: crate::types::InitialVlans) -> Self {
398        self.initial_vlans = ::std::option::Option::Some(input);
399        self
400    }
401    /// <p>The initial VLAN subnets for the Amazon EVS environment.</p><note>
402    /// <p>For each Amazon EVS VLAN subnet, you must specify a non-overlapping CIDR block. Amazon EVS VLAN subnets have a minimum CIDR block size of /28 and a maximum size of /24.</p>
403    /// </note>
404    pub fn set_initial_vlans(mut self, input: ::std::option::Option<crate::types::InitialVlans>) -> Self {
405        self.initial_vlans = input;
406        self
407    }
408    /// <p>The initial VLAN subnets for the Amazon EVS environment.</p><note>
409    /// <p>For each Amazon EVS VLAN subnet, you must specify a non-overlapping CIDR block. Amazon EVS VLAN subnets have a minimum CIDR block size of /28 and a maximum size of /24.</p>
410    /// </note>
411    pub fn get_initial_vlans(&self) -> &::std::option::Option<crate::types::InitialVlans> {
412        &self.initial_vlans
413    }
414    /// Appends an item to `hosts`.
415    ///
416    /// To override the contents of this collection use [`set_hosts`](Self::set_hosts).
417    ///
418    /// <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>
419    /// <p>For each host, you must provide the desired hostname, EC2 SSH keypair name, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
420    pub fn hosts(mut self, input: crate::types::HostInfoForCreate) -> Self {
421        let mut v = self.hosts.unwrap_or_default();
422        v.push(input);
423        self.hosts = ::std::option::Option::Some(v);
424        self
425    }
426    /// <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>
427    /// <p>For each host, you must provide the desired hostname, EC2 SSH keypair name, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
428    pub fn set_hosts(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::HostInfoForCreate>>) -> Self {
429        self.hosts = input;
430        self
431    }
432    /// <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>
433    /// <p>For each host, you must provide the desired hostname, EC2 SSH keypair name, and EC2 instance type. Optionally, you can also provide a partition or cluster placement group to use, or use Amazon EC2 Dedicated Hosts.</p>
434    pub fn get_hosts(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::HostInfoForCreate>> {
435        &self.hosts
436    }
437    /// <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 uplink subnet, providing BGP-based dynamic routing for overlay networks.</p>
438    /// This field is required.
439    pub fn connectivity_info(mut self, input: crate::types::ConnectivityInfo) -> Self {
440        self.connectivity_info = ::std::option::Option::Some(input);
441        self
442    }
443    /// <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 uplink subnet, providing BGP-based dynamic routing for overlay networks.</p>
444    pub fn set_connectivity_info(mut self, input: ::std::option::Option<crate::types::ConnectivityInfo>) -> Self {
445        self.connectivity_info = input;
446        self
447    }
448    /// <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 uplink subnet, providing BGP-based dynamic routing for overlay networks.</p>
449    pub fn get_connectivity_info(&self) -> &::std::option::Option<crate::types::ConnectivityInfo> {
450        &self.connectivity_info
451    }
452    /// <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>
453    /// This field is required.
454    pub fn vcf_hostnames(mut self, input: crate::types::VcfHostnames) -> Self {
455        self.vcf_hostnames = ::std::option::Option::Some(input);
456        self
457    }
458    /// <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>
459    pub fn set_vcf_hostnames(mut self, input: ::std::option::Option<crate::types::VcfHostnames>) -> Self {
460        self.vcf_hostnames = input;
461        self
462    }
463    /// <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>
464    pub fn get_vcf_hostnames(&self) -> &::std::option::Option<crate::types::VcfHostnames> {
465        &self.vcf_hostnames
466    }
467    /// <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>
468    /// This field is required.
469    pub fn site_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
470        self.site_id = ::std::option::Option::Some(input.into());
471        self
472    }
473    /// <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>
474    pub fn set_site_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
475        self.site_id = input;
476        self
477    }
478    /// <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>
479    pub fn get_site_id(&self) -> &::std::option::Option<::std::string::String> {
480        &self.site_id
481    }
482    /// Consumes the builder and constructs a [`CreateEnvironmentInput`](crate::operation::create_environment::CreateEnvironmentInput).
483    pub fn build(
484        self,
485    ) -> ::std::result::Result<crate::operation::create_environment::CreateEnvironmentInput, ::aws_smithy_types::error::operation::BuildError> {
486        ::std::result::Result::Ok(crate::operation::create_environment::CreateEnvironmentInput {
487            client_token: self.client_token,
488            environment_name: self.environment_name,
489            kms_key_id: self.kms_key_id,
490            tags: self.tags,
491            service_access_security_groups: self.service_access_security_groups,
492            vpc_id: self.vpc_id,
493            service_access_subnet_id: self.service_access_subnet_id,
494            vcf_version: self.vcf_version,
495            terms_accepted: self.terms_accepted,
496            license_info: self.license_info,
497            initial_vlans: self.initial_vlans,
498            hosts: self.hosts,
499            connectivity_info: self.connectivity_info,
500            vcf_hostnames: self.vcf_hostnames,
501            site_id: self.site_id,
502        })
503    }
504}