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}