FileSystem
A description of a specific Amazon FSx file system.
Contents
- AdministrativeActions
-
A list of administrative actions for the file system that are in process or waiting to be processed. Administrative actions describe changes to the Amazon FSx system that you have initiated using the
UpdateFileSystem
operation.Type: Array of AdministrativeAction objects
Array Members: Maximum number of 50 items.
Required: No
- CreationTime
-
The time that the file system was created, in seconds (since 1970-01-01T00:00:00Z), also known as Unix time.
Type: Timestamp
Required: No
- DNSName
-
The Domain Name System (DNS) name for the file system.
Type: String
Length Constraints: Minimum length of 16. Maximum length of 275.
Pattern:
^((fs|fc)i?-[0-9a-f]{8,}\..{4,253})$
Required: No
- FailureDetails
-
A structure providing details of any failures that occurred.
Type: FileSystemFailureDetails object
Required: No
- FileSystemId
-
The system-generated, unique 17-digit ID of the file system.
Type: String
Length Constraints: Minimum length of 11. Maximum length of 21.
Pattern:
^(fs-[0-9a-f]{8,})$
Required: No
- FileSystemType
-
The type of Amazon FSx file system, which can be
LUSTRE
,WINDOWS
,ONTAP
, orOPENZFS
.Type: String
Valid Values:
WINDOWS | LUSTRE | ONTAP | OPENZFS
Required: No
- FileSystemTypeVersion
-
The Lustre version of the Amazon FSx for Lustre file system, which can be
2.10
,2.12
, or2.15
.Type: String
Length Constraints: Minimum length of 1. Maximum length of 20.
Pattern:
^[0-9](.[0-9]*)*$
Required: No
- KmsKeyId
-
The ID of the AWS Key Management Service (AWS KMS) key used to encrypt Amazon FSx file system data. Used as follows with Amazon FSx file system types:
-
Amazon FSx for Lustre
PERSISTENT_1
andPERSISTENT_2
deployment types only.SCRATCH_1
andSCRATCH_2
types are encrypted using the Amazon FSx service AWS KMS key for your account. -
Amazon FSx for NetApp ONTAP
-
Amazon FSx for OpenZFS
-
Amazon FSx for Windows File Server
Type: String
Length Constraints: Minimum length of 1. Maximum length of 2048.
Pattern:
^.{1,2048}$
Required: No
-
- Lifecycle
-
The lifecycle status of the file system. The following are the possible values and what they mean:
-
AVAILABLE
- The file system is in a healthy state, and is reachable and available for use. -
CREATING
- Amazon FSx is creating the new file system. -
DELETING
- Amazon FSx is deleting an existing file system. -
FAILED
- An existing file system has experienced an unrecoverable failure. When creating a new file system, Amazon FSx was unable to create the file system. -
MISCONFIGURED
- The file system is in a failed but recoverable state. -
MISCONFIGURED_UNAVAILABLE
- (Amazon FSx for Windows File Server only) The file system is currently unavailable due to a change in your Active Directory configuration. -
UPDATING
- The file system is undergoing a customer-initiated update.
Type: String
Valid Values:
AVAILABLE | CREATING | FAILED | DELETING | MISCONFIGURED | UPDATING | MISCONFIGURED_UNAVAILABLE
Required: No
-
- LustreConfiguration
-
The configuration for the Amazon FSx for Lustre file system.
Type: LustreFileSystemConfiguration object
Required: No
- NetworkInterfaceIds
-
The IDs of the elastic network interfaces from which a specific file system is accessible. The elastic network interface is automatically created in the same virtual private cloud (VPC) that the Amazon FSx file system was created in. For more information, see Elastic Network Interfaces in the Amazon EC2 User Guide.
For an Amazon FSx for Windows File Server file system, you can have one network interface ID. For an Amazon FSx for Lustre file system, you can have more than one.
Type: Array of strings
Array Members: Maximum number of 50 items.
Length Constraints: Minimum length of 12. Maximum length of 21.
Pattern:
^(eni-[0-9a-f]{8,})$
Required: No
- OntapConfiguration
-
The configuration for this Amazon FSx for NetApp ONTAP file system.
Type: OntapFileSystemConfiguration object
Required: No
- OpenZFSConfiguration
-
The configuration for this Amazon FSx for OpenZFS file system.
Type: OpenZFSFileSystemConfiguration object
Required: No
- OwnerId
-
The AWS account that created the file system. If the file system was created by a user in IAM Identity Center, the AWS account to which the IAM user belongs is the owner.
Type: String
Length Constraints: Fixed length of 12.
Pattern:
^\d{12}$
Required: No
- ResourceARN
-
The Amazon Resource Name (ARN) of the file system resource.
Type: String
Length Constraints: Minimum length of 8. Maximum length of 512.
Pattern:
^arn:(?=[^:]+:fsx:[^:]+:\d{12}:)((|(?=[a-z0-9-.]{1,63})(?!\d{1,3}(\.\d{1,3}){3})(?![^:]*-{2})(?![^:]*-\.)(?![^:]*\.-)[a-z0-9].*(?<!-)):){4}(?!/).{0,1024}$
Required: No
- StorageCapacity
-
The storage capacity of the file system in gibibytes (GiB).
Amazon FSx responds with an HTTP status code 400 (Bad Request) if the value of
StorageCapacity
is outside of the minimum or maximum values.Type: Integer
Valid Range: Minimum value of 0. Maximum value of 2147483647.
Required: No
- StorageType
-
The type of storage the file system is using. If set to
SSD
, the file system uses solid state drive storage. If set toHDD
, the file system uses hard disk drive storage.Type: String
Valid Values:
SSD | HDD
Required: No
- SubnetIds
-
Specifies the IDs of the subnets that the file system is accessible from. For the Amazon FSx Windows and ONTAP
MULTI_AZ_1
file system deployment type, there are two subnet IDs, one for the preferred file server and one for the standby file server. The preferred file server subnet identified in thePreferredSubnetID
property. All other file systems have only one subnet ID.For FSx for Lustre file systems, and Single-AZ Windows file systems, this is the ID of the subnet that contains the file system's endpoint. For
MULTI_AZ_1
Windows and ONTAP file systems, the file system endpoint is available in thePreferredSubnetID
.Type: Array of strings
Array Members: Maximum number of 50 items.
Length Constraints: Minimum length of 15. Maximum length of 24.
Pattern:
^(subnet-[0-9a-f]{8,})$
Required: No
- Tags
-
The tags to associate with the file system. For more information, see Tagging your Amazon FSx resources in the Amazon FSx for Lustre User Guide.
Type: Array of Tag objects
Array Members: Minimum number of 1 item. Maximum number of 50 items.
Required: No
- VpcId
-
The ID of the primary virtual private cloud (VPC) for the file system.
Type: String
Length Constraints: Minimum length of 12. Maximum length of 21.
Pattern:
^(vpc-[0-9a-f]{8,})$
Required: No
- WindowsConfiguration
-
The configuration for this Amazon FSx for Windows File Server file system.
Type: WindowsFileSystemConfiguration object
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: