Class CreateFileSystemOntapConfiguration
- java.lang.Object
-
- software.amazon.awssdk.services.fsx.model.CreateFileSystemOntapConfiguration
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<CreateFileSystemOntapConfiguration.Builder,CreateFileSystemOntapConfiguration>
@Generated("software.amazon.awssdk:codegen") public final class CreateFileSystemOntapConfiguration extends Object implements SdkPojo, Serializable, ToCopyableBuilder<CreateFileSystemOntapConfiguration.Builder,CreateFileSystemOntapConfiguration>
The ONTAP configuration properties of the FSx for ONTAP file system that you are creating.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceCreateFileSystemOntapConfiguration.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description IntegerautomaticBackupRetentionDays()Returns the value of the AutomaticBackupRetentionDays property for this object.static CreateFileSystemOntapConfiguration.Builderbuilder()StringdailyAutomaticBackupStartTime()Returns the value of the DailyAutomaticBackupStartTime property for this object.OntapDeploymentTypedeploymentType()Specifies the FSx for ONTAP file system deployment type to use in creating the file system.StringdeploymentTypeAsString()Specifies the FSx for ONTAP file system deployment type to use in creating the file system.DiskIopsConfigurationdiskIopsConfiguration()The SSD IOPS configuration for the FSx for ONTAP file system.StringendpointIpAddressRange()(Multi-AZ only) Specifies the IP address range in which the endpoints to access your file system will be created.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)StringfsxAdminPassword()The ONTAP administrative password for thefsxadminuser with which you administer your file system using the NetApp ONTAP CLI and REST API.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)IntegerhaPairs()Specifies how many high-availability (HA) pairs of file servers will power your file system.inthashCode()booleanhasRouteTableIds()For responses, this returns true if the service returned a value for the RouteTableIds property.StringpreferredSubnetId()Required whenDeploymentTypeis set toMULTI_AZ_1orMULTI_AZ_2.List<String>routeTableIds()(Multi-AZ only) Specifies the route tables in which Amazon FSx creates the rules for routing traffic to the correct file server.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends CreateFileSystemOntapConfiguration.Builder>serializableBuilderClass()IntegerthroughputCapacity()Sets the throughput capacity for the file system that you're creating in megabytes per second (MBps).IntegerthroughputCapacityPerHAPair()Use to choose the throughput capacity per HA pair, rather than the total throughput for the file system.CreateFileSystemOntapConfiguration.BuildertoBuilder()StringtoString()Returns a string representation of this object.StringweeklyMaintenanceStartTime()Returns the value of the WeeklyMaintenanceStartTime property for this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
automaticBackupRetentionDays
public final Integer automaticBackupRetentionDays()
Returns the value of the AutomaticBackupRetentionDays property for this object.- Returns:
- The value of the AutomaticBackupRetentionDays property for this object.
-
dailyAutomaticBackupStartTime
public final String dailyAutomaticBackupStartTime()
Returns the value of the DailyAutomaticBackupStartTime property for this object.- Returns:
- The value of the DailyAutomaticBackupStartTime property for this object.
-
deploymentType
public final OntapDeploymentType deploymentType()
Specifies the FSx for ONTAP file system deployment type to use in creating the file system.
-
MULTI_AZ_1- A high availability file system configured for Multi-AZ redundancy to tolerate temporary Availability Zone (AZ) unavailability. This is a first-generation FSx for ONTAP file system. -
MULTI_AZ_2- A high availability file system configured for Multi-AZ redundancy to tolerate temporary AZ unavailability. This is a second-generation FSx for ONTAP file system. -
SINGLE_AZ_1- A file system configured for Single-AZ redundancy. This is a first-generation FSx for ONTAP file system. -
SINGLE_AZ_2- A file system configured with multiple high-availability (HA) pairs for Single-AZ redundancy. This is a second-generation FSx for ONTAP file system.
For information about the use cases for Multi-AZ and Single-AZ deployments, refer to Choosing a file system deployment type.
If the service returns an enum value that is not available in the current SDK version,
deploymentTypewill returnOntapDeploymentType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromdeploymentTypeAsString().- Returns:
- Specifies the FSx for ONTAP file system deployment type to use in creating the file system.
-
MULTI_AZ_1- A high availability file system configured for Multi-AZ redundancy to tolerate temporary Availability Zone (AZ) unavailability. This is a first-generation FSx for ONTAP file system. -
MULTI_AZ_2- A high availability file system configured for Multi-AZ redundancy to tolerate temporary AZ unavailability. This is a second-generation FSx for ONTAP file system. -
SINGLE_AZ_1- A file system configured for Single-AZ redundancy. This is a first-generation FSx for ONTAP file system. -
SINGLE_AZ_2- A file system configured with multiple high-availability (HA) pairs for Single-AZ redundancy. This is a second-generation FSx for ONTAP file system.
For information about the use cases for Multi-AZ and Single-AZ deployments, refer to Choosing a file system deployment type.
-
- See Also:
OntapDeploymentType
-
-
deploymentTypeAsString
public final String deploymentTypeAsString()
Specifies the FSx for ONTAP file system deployment type to use in creating the file system.
-
MULTI_AZ_1- A high availability file system configured for Multi-AZ redundancy to tolerate temporary Availability Zone (AZ) unavailability. This is a first-generation FSx for ONTAP file system. -
MULTI_AZ_2- A high availability file system configured for Multi-AZ redundancy to tolerate temporary AZ unavailability. This is a second-generation FSx for ONTAP file system. -
SINGLE_AZ_1- A file system configured for Single-AZ redundancy. This is a first-generation FSx for ONTAP file system. -
SINGLE_AZ_2- A file system configured with multiple high-availability (HA) pairs for Single-AZ redundancy. This is a second-generation FSx for ONTAP file system.
For information about the use cases for Multi-AZ and Single-AZ deployments, refer to Choosing a file system deployment type.
If the service returns an enum value that is not available in the current SDK version,
deploymentTypewill returnOntapDeploymentType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromdeploymentTypeAsString().- Returns:
- Specifies the FSx for ONTAP file system deployment type to use in creating the file system.
-
MULTI_AZ_1- A high availability file system configured for Multi-AZ redundancy to tolerate temporary Availability Zone (AZ) unavailability. This is a first-generation FSx for ONTAP file system. -
MULTI_AZ_2- A high availability file system configured for Multi-AZ redundancy to tolerate temporary AZ unavailability. This is a second-generation FSx for ONTAP file system. -
SINGLE_AZ_1- A file system configured for Single-AZ redundancy. This is a first-generation FSx for ONTAP file system. -
SINGLE_AZ_2- A file system configured with multiple high-availability (HA) pairs for Single-AZ redundancy. This is a second-generation FSx for ONTAP file system.
For information about the use cases for Multi-AZ and Single-AZ deployments, refer to Choosing a file system deployment type.
-
- See Also:
OntapDeploymentType
-
-
endpointIpAddressRange
public final String endpointIpAddressRange()
(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.
- Returns:
- (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.
-
fsxAdminPassword
public final String fsxAdminPassword()
The ONTAP administrative password for the
fsxadminuser with which you administer your file system using the NetApp ONTAP CLI and REST API.- Returns:
- The ONTAP administrative password for the
fsxadminuser with which you administer your file system using the NetApp ONTAP CLI and REST API.
-
diskIopsConfiguration
public final DiskIopsConfiguration diskIopsConfiguration()
The SSD IOPS configuration for the FSx for ONTAP file system.
- Returns:
- The SSD IOPS configuration for the FSx for ONTAP file system.
-
preferredSubnetId
public final String preferredSubnetId()
Required when
DeploymentTypeis set toMULTI_AZ_1orMULTI_AZ_2. This specifies the subnet in which you want the preferred file server to be located.- Returns:
- Required when
DeploymentTypeis set toMULTI_AZ_1orMULTI_AZ_2. This specifies the subnet in which you want the preferred file server to be located.
-
hasRouteTableIds
public final boolean hasRouteTableIds()
For responses, this returns true if the service returned a value for the RouteTableIds property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
routeTableIds
public final List<String> routeTableIds()
(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 theKey: AmazonFSx; Value: ManagedByAmazonFSxtag manually.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasRouteTableIds()method.- Returns:
- (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 theKey: AmazonFSx; Value: ManagedByAmazonFSxtag manually.
-
throughputCapacity
public final Integer throughputCapacity()
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
ThroughputCapacityandThroughputCapacityPerHAPairare not the same value. -
The value of
ThroughputCapacitywhen divided by the value ofHAPairsis outside of the valid range forThroughputCapacity.
- Returns:
- 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
ThroughputCapacityandThroughputCapacityPerHAPairare not the same value. -
The value of
ThroughputCapacitywhen divided by the value ofHAPairsis outside of the valid range forThroughputCapacity.
-
-
-
weeklyMaintenanceStartTime
public final String weeklyMaintenanceStartTime()
Returns the value of the WeeklyMaintenanceStartTime property for this object.- Returns:
- The value of the WeeklyMaintenanceStartTime property for this object.
-
haPairs
public final Integer haPairs()
Specifies how many high-availability (HA) pairs of file servers will power your file system. First-generation file systems are powered by 1 HA pair. Second-generation multi-AZ file systems are powered by 1 HA pair. Second generation single-AZ file systems are powered by up to 12 HA pairs. The default value is 1. The value of this property affects the values of
StorageCapacity,Iops, andThroughputCapacity. For more information, see High-availability (HA) pairs in the FSx for ONTAP user guide. Block storage protocol support (iSCSI and NVMe over TCP) is disabled on file systems with more than 6 HA pairs. For more information, see Using block storage protocols.Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
HAPairsis less than 1 or greater than 12. -
The value of
HAPairsis greater than 1 and the value ofDeploymentTypeisSINGLE_AZ_1,MULTI_AZ_1, orMULTI_AZ_2.
- Returns:
- Specifies how many high-availability (HA) pairs of file servers will power your file system.
First-generation file systems are powered by 1 HA pair. Second-generation multi-AZ file systems are
powered by 1 HA pair. Second generation single-AZ file systems are powered by up to 12 HA pairs. The
default value is 1. The value of this property affects the values of
StorageCapacity,Iops, andThroughputCapacity. For more information, see High-availability (HA) pairs in the FSx for ONTAP user guide. Block storage protocol support (iSCSI and NVMe over TCP) is disabled on file systems with more than 6 HA pairs. For more information, see Using block storage protocols.Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
HAPairsis less than 1 or greater than 12. -
The value of
HAPairsis greater than 1 and the value ofDeploymentTypeisSINGLE_AZ_1,MULTI_AZ_1, orMULTI_AZ_2.
-
-
-
throughputCapacityPerHAPair
public final Integer throughputCapacityPerHAPair()
Use to choose the throughput capacity per HA pair, rather than the total throughput for the file system.
You can define either the
ThroughputCapacityPerHAPairor theThroughputCapacitywhen creating a file system, but not both.This field and
ThroughputCapacityare the same for file systems powered by one HA pair.-
For
SINGLE_AZ_1andMULTI_AZ_1file systems, valid values are 128, 256, 512, 1024, 2048, or 4096 MBps. -
For
SINGLE_AZ_2, valid values are 1536, 3072, or 6144 MBps. -
For
MULTI_AZ_2, valid values are 384, 768, 1536, 3072, or 6144 MBps.
Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
ThroughputCapacityandThroughputCapacityPerHAPairare not the same value for file systems with one HA pair. -
The value of deployment type is
SINGLE_AZ_2andThroughputCapacity/ThroughputCapacityPerHAPairis not a valid HA pair (a value between 1 and 12). -
The value of
ThroughputCapacityPerHAPairis not a valid value.
- Returns:
- Use to choose the throughput capacity per HA pair, rather than the total throughput for the file system.
You can define either the
ThroughputCapacityPerHAPairor theThroughputCapacitywhen creating a file system, but not both.This field and
ThroughputCapacityare the same for file systems powered by one HA pair.-
For
SINGLE_AZ_1andMULTI_AZ_1file systems, valid values are 128, 256, 512, 1024, 2048, or 4096 MBps. -
For
SINGLE_AZ_2, valid values are 1536, 3072, or 6144 MBps. -
For
MULTI_AZ_2, valid values are 384, 768, 1536, 3072, or 6144 MBps.
Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
-
The value of
ThroughputCapacityandThroughputCapacityPerHAPairare not the same value for file systems with one HA pair. -
The value of deployment type is
SINGLE_AZ_2andThroughputCapacity/ThroughputCapacityPerHAPairis not a valid HA pair (a value between 1 and 12). -
The value of
ThroughputCapacityPerHAPairis not a valid value.
-
-
-
toBuilder
public CreateFileSystemOntapConfiguration.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<CreateFileSystemOntapConfiguration.Builder,CreateFileSystemOntapConfiguration>
-
builder
public static CreateFileSystemOntapConfiguration.Builder builder()
-
serializableBuilderClass
public static Class<? extends CreateFileSystemOntapConfiguration.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-