#[non_exhaustive]pub struct CreateFileSystemOntapConfiguration {
pub automatic_backup_retention_days: Option<i32>,
pub daily_automatic_backup_start_time: Option<String>,
pub deployment_type: Option<OntapDeploymentType>,
pub endpoint_ip_address_range: Option<String>,
pub fsx_admin_password: Option<String>,
pub disk_iops_configuration: Option<DiskIopsConfiguration>,
pub preferred_subnet_id: Option<String>,
pub route_table_ids: Option<Vec<String>>,
pub throughput_capacity: Option<i32>,
pub weekly_maintenance_start_time: Option<String>,
pub ha_pairs: Option<i32>,
pub throughput_capacity_per_ha_pair: Option<i32>,
}
Expand description
The ONTAP configuration properties of the FSx for ONTAP file system that you are creating.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.automatic_backup_retention_days: Option<i32>
The number of days to retain automatic backups. Setting this property to 0
disables automatic backups. You can retain automatic backups for a maximum of 90 days. The default is 30
.
daily_automatic_backup_start_time: Option<String>
A recurring daily time, in the format HH:MM
. HH
is the zero-padded hour of the day (0-23), and MM
is the zero-padded minute of the hour. For example, 05:00
specifies 5 AM daily.
deployment_type: Option<OntapDeploymentType>
Specifies the FSx for ONTAP file system deployment type to use in creating the file system.
-
MULTI_AZ_1
- (Default) A high availability file system configured for Multi-AZ redundancy to tolerate temporary Availability Zone (AZ) unavailability. -
SINGLE_AZ_1
- A file system configured for Single-AZ redundancy. -
SINGLE_AZ_2
- A file system configured with multiple high-availability (HA) pairs for Single-AZ redundancy.
For information about the use cases for Multi-AZ and Single-AZ deployments, refer to Choosing a file system deployment type.
endpoint_ip_address_range: Option<String>
(Multi-AZ only) Specifies the IP address range in which the endpoints to access your file system will be created. By default in the Amazon FSx API, Amazon FSx selects an unused IP address range for you from the 198.19.* range. By default in the Amazon FSx console, Amazon FSx chooses the last 64 IP addresses from the VPC’s primary CIDR range to use as the endpoint IP address range for the file system. You can have overlapping endpoint IP addresses for file systems deployed in the same VPC/route tables, as long as they don't overlap with any subnet.
fsx_admin_password: Option<String>
The ONTAP administrative password for the fsxadmin
user with which you administer your file system using the NetApp ONTAP CLI and REST API.
disk_iops_configuration: Option<DiskIopsConfiguration>
The SSD IOPS configuration for the FSx for ONTAP file system.
preferred_subnet_id: Option<String>
Required when DeploymentType
is set to MULTI_AZ_1
. This specifies the subnet in which you want the preferred file server to be located.
route_table_ids: Option<Vec<String>>
(Multi-AZ only) Specifies the route tables in which Amazon FSx creates the rules for routing traffic to the correct file server. You should specify all virtual private cloud (VPC) route tables associated with the subnets in which your clients are located. By default, Amazon FSx selects your VPC's default route table.
Amazon FSx manages these route tables for Multi-AZ file systems using tag-based authentication. These route tables are tagged with Key: AmazonFSx; Value: ManagedByAmazonFSx
. When creating FSx for ONTAP Multi-AZ file systems using CloudFormation we recommend that you add the Key: AmazonFSx; Value: ManagedByAmazonFSx
tag manually.
throughput_capacity: Option<i32>
Sets the throughput capacity for the file system that you're creating in megabytes per second (MBps). For more information, see Managing throughput capacity in the FSx for ONTAP User Guide.
Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
ThroughputCapacity
andThroughputCapacityPerHAPair
are not the same value. -
The value of
ThroughputCapacity
when divided by the value ofHAPairs
is outside of the valid range forThroughputCapacity
.
weekly_maintenance_start_time: Option<String>
A recurring weekly time, in the format D:HH:MM
.
D
is the day of the week, for which 1 represents Monday and 7 represents Sunday. For further details, see the ISO-8601 spec as described on Wikipedia.
HH
is the zero-padded hour of the day (0-23), and MM
is the zero-padded minute of the hour.
For example, 1:05:00
specifies maintenance at 5 AM Monday.
ha_pairs: Option<i32>
Specifies how many high-availability (HA) pairs of file servers will power your file system. Scale-up file systems are powered by 1 HA pair. The default value is 1. FSx for ONTAP scale-out file systems are powered by up to 12 HA pairs. The value of this property affects the values of StorageCapacity
, Iops
, and ThroughputCapacity
. For more information, see High-availability (HA) pairs in the FSx for ONTAP user guide.
Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
HAPairs
is less than 1 or greater than 12. -
The value of
HAPairs
is greater than 1 and the value ofDeploymentType
isSINGLE_AZ_1
orMULTI_AZ_1
.
throughput_capacity_per_ha_pair: Option<i32>
Use to choose the throughput capacity per HA pair, rather than the total throughput for the file system.
You can define either the ThroughputCapacityPerHAPair
or the ThroughputCapacity
when creating a file system, but not both.
This field and ThroughputCapacity
are the same for scale-up file systems powered by one HA pair.
-
For
SINGLE_AZ_1
andMULTI_AZ_1
file systems, valid values are 128, 256, 512, 1024, 2048, or 4096 MBps. -
For
SINGLE_AZ_2
file systems, valid values are 3072 or 6144 MBps.
Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
ThroughputCapacity
andThroughputCapacityPerHAPair
are not the same value for file systems with one HA pair. -
The value of deployment type is
SINGLE_AZ_2
andThroughputCapacity
/ThroughputCapacityPerHAPair
is a valid HA pair (a value between 2 and 12). -
The value of
ThroughputCapacityPerHAPair
is not a valid value.
Implementations§
source§impl CreateFileSystemOntapConfiguration
impl CreateFileSystemOntapConfiguration
sourcepub fn automatic_backup_retention_days(&self) -> Option<i32>
pub fn automatic_backup_retention_days(&self) -> Option<i32>
The number of days to retain automatic backups. Setting this property to 0
disables automatic backups. You can retain automatic backups for a maximum of 90 days. The default is 30
.
sourcepub fn daily_automatic_backup_start_time(&self) -> Option<&str>
pub fn daily_automatic_backup_start_time(&self) -> Option<&str>
A recurring daily time, in the format HH:MM
. HH
is the zero-padded hour of the day (0-23), and MM
is the zero-padded minute of the hour. For example, 05:00
specifies 5 AM daily.
sourcepub fn deployment_type(&self) -> Option<&OntapDeploymentType>
pub fn deployment_type(&self) -> Option<&OntapDeploymentType>
Specifies the FSx for ONTAP file system deployment type to use in creating the file system.
-
MULTI_AZ_1
- (Default) A high availability file system configured for Multi-AZ redundancy to tolerate temporary Availability Zone (AZ) unavailability. -
SINGLE_AZ_1
- A file system configured for Single-AZ redundancy. -
SINGLE_AZ_2
- A file system configured with multiple high-availability (HA) pairs for Single-AZ redundancy.
For information about the use cases for Multi-AZ and Single-AZ deployments, refer to Choosing a file system deployment type.
sourcepub fn endpoint_ip_address_range(&self) -> Option<&str>
pub fn endpoint_ip_address_range(&self) -> Option<&str>
(Multi-AZ only) Specifies the IP address range in which the endpoints to access your file system will be created. By default in the Amazon FSx API, Amazon FSx selects an unused IP address range for you from the 198.19.* range. By default in the Amazon FSx console, Amazon FSx chooses the last 64 IP addresses from the VPC’s primary CIDR range to use as the endpoint IP address range for the file system. You can have overlapping endpoint IP addresses for file systems deployed in the same VPC/route tables, as long as they don't overlap with any subnet.
sourcepub fn fsx_admin_password(&self) -> Option<&str>
pub fn fsx_admin_password(&self) -> Option<&str>
The ONTAP administrative password for the fsxadmin
user with which you administer your file system using the NetApp ONTAP CLI and REST API.
sourcepub fn disk_iops_configuration(&self) -> Option<&DiskIopsConfiguration>
pub fn disk_iops_configuration(&self) -> Option<&DiskIopsConfiguration>
The SSD IOPS configuration for the FSx for ONTAP file system.
sourcepub fn preferred_subnet_id(&self) -> Option<&str>
pub fn preferred_subnet_id(&self) -> Option<&str>
Required when DeploymentType
is set to MULTI_AZ_1
. This specifies the subnet in which you want the preferred file server to be located.
sourcepub fn route_table_ids(&self) -> &[String]
pub fn route_table_ids(&self) -> &[String]
(Multi-AZ only) Specifies the route tables in which Amazon FSx creates the rules for routing traffic to the correct file server. You should specify all virtual private cloud (VPC) route tables associated with the subnets in which your clients are located. By default, Amazon FSx selects your VPC's default route table.
Amazon FSx manages these route tables for Multi-AZ file systems using tag-based authentication. These route tables are tagged with Key: AmazonFSx; Value: ManagedByAmazonFSx
. When creating FSx for ONTAP Multi-AZ file systems using CloudFormation we recommend that you add the Key: AmazonFSx; Value: ManagedByAmazonFSx
tag manually.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .route_table_ids.is_none()
.
sourcepub fn throughput_capacity(&self) -> Option<i32>
pub fn throughput_capacity(&self) -> Option<i32>
Sets the throughput capacity for the file system that you're creating in megabytes per second (MBps). For more information, see Managing throughput capacity in the FSx for ONTAP User Guide.
Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
ThroughputCapacity
andThroughputCapacityPerHAPair
are not the same value. -
The value of
ThroughputCapacity
when divided by the value ofHAPairs
is outside of the valid range forThroughputCapacity
.
sourcepub fn weekly_maintenance_start_time(&self) -> Option<&str>
pub fn weekly_maintenance_start_time(&self) -> Option<&str>
A recurring weekly time, in the format D:HH:MM
.
D
is the day of the week, for which 1 represents Monday and 7 represents Sunday. For further details, see the ISO-8601 spec as described on Wikipedia.
HH
is the zero-padded hour of the day (0-23), and MM
is the zero-padded minute of the hour.
For example, 1:05:00
specifies maintenance at 5 AM Monday.
sourcepub fn ha_pairs(&self) -> Option<i32>
pub fn ha_pairs(&self) -> Option<i32>
Specifies how many high-availability (HA) pairs of file servers will power your file system. Scale-up file systems are powered by 1 HA pair. The default value is 1. FSx for ONTAP scale-out file systems are powered by up to 12 HA pairs. The value of this property affects the values of StorageCapacity
, Iops
, and ThroughputCapacity
. For more information, see High-availability (HA) pairs in the FSx for ONTAP user guide.
Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
HAPairs
is less than 1 or greater than 12. -
The value of
HAPairs
is greater than 1 and the value ofDeploymentType
isSINGLE_AZ_1
orMULTI_AZ_1
.
sourcepub fn throughput_capacity_per_ha_pair(&self) -> Option<i32>
pub fn throughput_capacity_per_ha_pair(&self) -> Option<i32>
Use to choose the throughput capacity per HA pair, rather than the total throughput for the file system.
You can define either the ThroughputCapacityPerHAPair
or the ThroughputCapacity
when creating a file system, but not both.
This field and ThroughputCapacity
are the same for scale-up file systems powered by one HA pair.
-
For
SINGLE_AZ_1
andMULTI_AZ_1
file systems, valid values are 128, 256, 512, 1024, 2048, or 4096 MBps. -
For
SINGLE_AZ_2
file systems, valid values are 3072 or 6144 MBps.
Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
ThroughputCapacity
andThroughputCapacityPerHAPair
are not the same value for file systems with one HA pair. -
The value of deployment type is
SINGLE_AZ_2
andThroughputCapacity
/ThroughputCapacityPerHAPair
is a valid HA pair (a value between 2 and 12). -
The value of
ThroughputCapacityPerHAPair
is not a valid value.
source§impl CreateFileSystemOntapConfiguration
impl CreateFileSystemOntapConfiguration
sourcepub fn builder() -> CreateFileSystemOntapConfigurationBuilder
pub fn builder() -> CreateFileSystemOntapConfigurationBuilder
Creates a new builder-style object to manufacture CreateFileSystemOntapConfiguration
.
Trait Implementations§
source§impl Clone for CreateFileSystemOntapConfiguration
impl Clone for CreateFileSystemOntapConfiguration
source§fn clone(&self) -> CreateFileSystemOntapConfiguration
fn clone(&self) -> CreateFileSystemOntapConfiguration
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl PartialEq for CreateFileSystemOntapConfiguration
impl PartialEq for CreateFileSystemOntapConfiguration
source§fn eq(&self, other: &CreateFileSystemOntapConfiguration) -> bool
fn eq(&self, other: &CreateFileSystemOntapConfiguration) -> bool
self
and other
values to be equal, and is used
by ==
.