Class: Aws::FSx::Types::CreateFileSystemOntapConfiguration

Inherits:

Struct

Object
Struct
Aws::FSx::Types::CreateFileSystemOntapConfiguration

show all

Includes:: Structure

Defined in:: lib/aws-sdk-fsx/types.rb

Overview

The ONTAP configuration properties of the FSx for ONTAP file system that you are creating.

Constant Summary collapse

SENSITIVE =

[:fsx_admin_password]

Instance Attribute Summary collapse

#automatic_backup_retention_days ⇒ Integer

The number of days to retain automatic backups.
#daily_automatic_backup_start_time ⇒ String

A recurring daily time, in the format ‘HH:MM`.
#deployment_type ⇒ String

Specifies the FSx for ONTAP file system deployment type to use in creating the file system.
#disk_iops_configuration ⇒ Types::DiskIopsConfiguration

The SSD IOPS configuration for the FSx for ONTAP file system.
#endpoint_ip_address_range ⇒ String

(Multi-AZ only) Specifies the IP address range in which the endpoints to access your file system will be created.
#fsx_admin_password ⇒ String

The ONTAP administrative password for the ‘fsxadmin` user with which you administer your file system using the NetApp ONTAP CLI and REST API.
#ha_pairs ⇒ Integer

Specifies how many high-availability (HA) pairs of file servers will power your file system.
#preferred_subnet_id ⇒ String

Required when ‘DeploymentType` is set to `MULTI_AZ_1` or `MULTI_AZ_2`.
#route_table_ids ⇒ Array<String>

(Multi-AZ only) Specifies the route tables in which Amazon FSx creates the rules for routing traffic to the correct file server.
#throughput_capacity ⇒ Integer

Sets the throughput capacity for the file system that you’re creating in megabytes per second (MBps).
#throughput_capacity_per_ha_pair ⇒ Integer

Use to choose the throughput capacity per HA pair, rather than the total throughput for the file system.
#weekly_maintenance_start_time ⇒ String

A recurring weekly time, in the format ‘D:HH:MM`.

Instance Attribute Details

#automatic_backup_retention_days ⇒ `Integer`

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`.

Returns:

(Integer)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#daily_automatic_backup_start_time ⇒ `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.

Returns:

(String)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#deployment_type ⇒ `String`

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].

[1]: docs.aws.amazon.com/fsx/latest/ONTAPGuide/high-availability-AZ.html

Returns:

(String)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#disk_iops_configuration ⇒ `Types::DiskIopsConfiguration`

The SSD IOPS configuration for the FSx for ONTAP file system.

Returns:

(Types::DiskIopsConfiguration)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#endpoint_ip_address_range ⇒ `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.

Returns:

(String)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#fsx_admin_password ⇒ `String`

The ONTAP administrative password for the ‘fsxadmin` user with which you administer your file system using the NetApp ONTAP CLI and REST API.

Returns:

(String)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#ha_pairs ⇒ `Integer`

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`, and `ThroughputCapacity`. 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 ‘HAPairs` is less than 1 or greater than 12.
The value of ‘HAPairs` is greater than 1 and the value of `DeploymentType` is `SINGLE_AZ_1`, `MULTI_AZ_1`, or `MULTI_AZ_2`.

[1]: docs.aws.amazon.com/fsx/latest/ONTAPGuide/administering-file-systems.html#HA-pairs [2]: docs.aws.amazon.com/fsx/latest/ONTAPGuide/supported-fsx-clients.html#using-block-storage

Returns:

(Integer)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#preferred_subnet_id ⇒ `String`

Required when ‘DeploymentType` is set to `MULTI_AZ_1` or `MULTI_AZ_2`. This specifies the subnet in which you want the preferred file server to be located.

Returns:

(String)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#route_table_ids ⇒ `Array<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.

<note markdown=“1”> 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.

</note>

Returns:

(Array<String>)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#throughput_capacity ⇒ `Integer`

Sets the throughput capacity for the file system that you’re creating in megabytes per second (MBps). For more information, see

Managing throughput capacity][1: 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` and `ThroughputCapacityPerHAPair` are not the same value.
The value of ‘ThroughputCapacity` when divided by the value of `HAPairs` is outside of the valid range for `ThroughputCapacity`.

[1]: docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-throughput-capacity.html

Returns:

(Integer)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#throughput_capacity_per_ha_pair ⇒ `Integer`

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 file systems powered by one HA pair.

For ‘SINGLE_AZ_1` and `MULTI_AZ_1` file 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 ‘ThroughputCapacity` and `ThroughputCapacityPerHAPair` are not the same value for file systems with one HA pair.
The value of deployment type is ‘SINGLE_AZ_2` and `ThroughputCapacity` / `ThroughputCapacityPerHAPair` is not a valid HA pair (a value between 1 and 12).
The value of ‘ThroughputCapacityPerHAPair` is not a valid value.

Returns:

(Integer)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

#weekly_maintenance_start_time ⇒ `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.

[1]: en.wikipedia.org/wiki/ISO_week_date

Returns:

(String)

# File 'lib/aws-sdk-fsx/types.rb', line 2227

class CreateFileSystemOntapConfiguration < Struct.new(
  :automatic_backup_retention_days,
  :daily_automatic_backup_start_time,
  :deployment_type,
  :endpoint_ip_address_range,
  :fsx_admin_password,
  :disk_iops_configuration,
  :preferred_subnet_id,
  :route_table_ids,
  :throughput_capacity,
  :weekly_maintenance_start_time,
  :ha_pairs,
  :throughput_capacity_per_ha_pair)
  SENSITIVE = [:fsx_admin_password]
  include Aws::Structure
end

Class: Aws::FSx::Types::CreateFileSystemOntapConfiguration

Overview

Constant Summary collapse

Instance Attribute Summary collapse

Instance Attribute Details

#automatic_backup_retention_days ⇒ Integer

#daily_automatic_backup_start_time ⇒ String

#deployment_type ⇒ String

#disk_iops_configuration ⇒ Types::DiskIopsConfiguration

#endpoint_ip_address_range ⇒ String

#fsx_admin_password ⇒ String

#ha_pairs ⇒ Integer

#preferred_subnet_id ⇒ String

#route_table_ids ⇒ Array<String>

#throughput_capacity ⇒ Integer

#throughput_capacity_per_ha_pair ⇒ Integer

#weekly_maintenance_start_time ⇒ String

#automatic_backup_retention_days ⇒ `Integer`

#daily_automatic_backup_start_time ⇒ `String`

#deployment_type ⇒ `String`

#disk_iops_configuration ⇒ `Types::DiskIopsConfiguration`

#endpoint_ip_address_range ⇒ `String`

#fsx_admin_password ⇒ `String`

#ha_pairs ⇒ `Integer`

#preferred_subnet_id ⇒ `String`

#route_table_ids ⇒ `Array<String>`

#throughput_capacity ⇒ `Integer`

#throughput_capacity_per_ha_pair ⇒ `Integer`

#weekly_maintenance_start_time ⇒ `String`