Skip to content

FileSystem

Source code in docs_src/capo_fsx/types/file_system.py
class FileSystem(TypedDict, closed=True):
    owner_id: NotRequired["capo_fsx.types.aws_account_id.AWSAccountId"]
    """<p>The Amazon Web Services account that created the file system. If the file system was created by a user in IAM Identity Center, the Amazon Web Services account to which the IAM user belongs is the owner.</p>"""
    creation_time: NotRequired["capo_fsx.types.creation_time.CreationTime"]
    """<p>The time that the file system was created, in seconds (since 1970-01-01T00:00:00Z), also known as Unix time.</p>"""
    file_system_id: NotRequired["capo_fsx.types.file_system_id.FileSystemId"]
    """<p>The system-generated, unique 17-digit ID of the file system.</p>"""
    file_system_type: NotRequired["capo_fsx.types.file_system_type.FileSystemType"]
    """<p>The type of Amazon FSx file system, which can be <code>LUSTRE</code>, <code>WINDOWS</code>, <code>ONTAP</code>, or <code>OPENZFS</code>.</p>"""
    lifecycle: NotRequired["capo_fsx.types.file_system_lifecycle.FileSystemLifecycle"]
    """<p>The lifecycle status of the file system. The following are the possible values and what they mean:</p> <ul> <li> <p> <code>AVAILABLE</code> - The file system is in a healthy state, and is reachable and available for use.</p> </li> <li> <p> <code>CREATING</code> - Amazon FSx is creating the new file system.</p> </li> <li> <p> <code>DELETING</code> - Amazon FSx is deleting an existing file system.</p> </li> <li> <p> <code>FAILED</code> - An existing file system has experienced an unrecoverable failure. When creating a new file system, Amazon FSx was unable to create the file system.</p> </li> <li> <p> <code>MISCONFIGURED</code> - The file system is in a failed but recoverable state.</p> </li> <li> <p> <code>MISCONFIGURED_UNAVAILABLE</code> - (Amazon FSx for Windows File Server only) The file system is currently unavailable due to a change in your Active Directory configuration.</p> </li> <li> <p> <code>UPDATING</code> - The file system is undergoing a customer-initiated update.</p> </li> </ul>"""
    failure_details: NotRequired[
        "capo_fsx.types.file_system_failure_details.FileSystemFailureDetails"
    ]
    storage_capacity: NotRequired["capo_fsx.types.storage_capacity.StorageCapacity"]
    """<p>The storage capacity of the file system in gibibytes (GiB).</p> <p>Amazon FSx responds with an HTTP status code 400 (Bad Request) if the value of <code>StorageCapacity</code> is outside of the minimum or maximum values.</p>"""
    storage_type: NotRequired["capo_fsx.types.storage_type.StorageType"]
    """<p>The type of storage the file system is using.</p> <ul> <li> <p>If set to <code>SSD</code>, the file system uses solid state drive storage.</p> </li> <li> <p>If set to <code>HDD</code>, the file system uses hard disk drive storage.</p> </li> <li> <p>If set to <code>INTELLIGENT_TIERING</code>, the file system uses fully elastic, intelligently-tiered storage.</p> </li> </ul>"""
    vpc_id: NotRequired["capo_fsx.types.vpc_id.VpcId"]
    """<p>The ID of the primary virtual private cloud (VPC) for the file system.</p>"""
    subnet_ids: NotRequired["capo_fsx.types.subnet_ids.SubnetIds"]
    """<p>Specifies the IDs of the subnets that the file system is accessible from. For the Amazon FSx Windows and ONTAP <code>MULTI_AZ_1</code> 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 the <code>PreferredSubnetID</code> property. All other file systems have only one subnet ID.</p> <p>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 <code>MULTI_AZ_1</code> Windows and ONTAP file systems, the file system endpoint is available in the <code>PreferredSubnetID</code>.</p>"""
    network_interface_ids: NotRequired[
        "capo_fsx.types.network_interface_ids.NetworkInterfaceIds"
    ]
    """<p>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 <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html">Elastic Network Interfaces</a> in the <i>Amazon EC2 User Guide.</i> </p> <p>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.</p>"""
    dns_name: NotRequired["capo_fsx.types.dns_name.DNSName"]
    """<p>The Domain Name System (DNS) name for the file system.</p>"""
    kms_key_id: NotRequired["capo_fsx.types.kms_key_id.KmsKeyId"]
    """<p>The ID of the Key Management Service (KMS) key used to encrypt Amazon FSx file system data. Used as follows with Amazon FSx file system types:</p> <ul> <li> <p>Amazon FSx for Lustre <code>PERSISTENT_1</code> and <code>PERSISTENT_2</code> deployment types only.</p> <p> <code>SCRATCH_1</code> and <code>SCRATCH_2</code> types are encrypted using the Amazon FSx service KMS key for your account.</p> </li> <li> <p>Amazon FSx for NetApp ONTAP</p> </li> <li> <p>Amazon FSx for OpenZFS</p> </li> <li> <p>Amazon FSx for Windows File Server</p> </li> </ul>"""
    resource_arn: NotRequired["capo_fsx.types.resource_arn.ResourceARN"]
    """<p>The Amazon Resource Name (ARN) of the file system resource.</p>"""
    tags: NotRequired["capo_fsx.types.tags.Tags"]
    """<p>The tags to associate with the file system. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/LustreGuide/tag-resources.html">Tagging your Amazon FSx resources</a> in the <i>Amazon FSx for Lustre User Guide</i>.</p>"""
    windows_configuration: NotRequired[
        "capo_fsx.types.windows_file_system_configuration.WindowsFileSystemConfiguration"
    ]
    """<p>The configuration for this Amazon FSx for Windows File Server file system.</p>"""
    lustre_configuration: NotRequired[
        "capo_fsx.types.lustre_file_system_configuration.LustreFileSystemConfiguration"
    ]
    administrative_actions: NotRequired[
        "capo_fsx.types.administrative_actions.AdministrativeActions"
    ]
    """<p>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 <code>UpdateFileSystem</code> operation.</p>"""
    ontap_configuration: NotRequired[
        "capo_fsx.types.ontap_file_system_configuration.OntapFileSystemConfiguration"
    ]
    """<p>The configuration for this Amazon FSx for NetApp ONTAP file system.</p>"""
    file_system_type_version: NotRequired[
        "capo_fsx.types.file_system_type_version.FileSystemTypeVersion"
    ]
    """<p>The Lustre version of the Amazon FSx for Lustre file system, which can be <code>2.10</code>, <code>2.12</code>, or <code>2.15</code>.</p>"""
    open_zfs_configuration: NotRequired[
        "capo_fsx.types.open_zfs_file_system_configuration.OpenZFSFileSystemConfiguration"
    ]
    """<p>The configuration for this Amazon FSx for OpenZFS file system.</p>"""
    network_type: NotRequired["capo_fsx.types.network_type.NetworkType"]
    """<p>The network type of the file system.</p>"""

administrative_actions instance-attribute

administrative_actions: NotRequired[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.

creation_time instance-attribute

creation_time: NotRequired[CreationTime]

The time that the file system was created, in seconds (since 1970-01-01T00:00:00Z), also known as Unix time.

dns_name instance-attribute

dns_name: NotRequired[DNSName]

The Domain Name System (DNS) name for the file system.

failure_details instance-attribute

failure_details: NotRequired[FileSystemFailureDetails]

file_system_id instance-attribute

file_system_id: NotRequired[FileSystemId]

The system-generated, unique 17-digit ID of the file system.

file_system_type instance-attribute

file_system_type: NotRequired[FileSystemType]

The type of Amazon FSx file system, which can be LUSTRE, WINDOWS, ONTAP, or OPENZFS.

file_system_type_version instance-attribute

file_system_type_version: NotRequired[FileSystemTypeVersion]

The Lustre version of the Amazon FSx for Lustre file system, which can be 2.10, 2.12, or 2.15.

kms_key_id instance-attribute

kms_key_id: NotRequired[KmsKeyId]

The ID of the Key Management Service (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 and PERSISTENT_2 deployment types only.

    SCRATCH_1 and SCRATCH_2 types are encrypted using the Amazon FSx service KMS key for your account.

  • Amazon FSx for NetApp ONTAP

  • Amazon FSx for OpenZFS

  • Amazon FSx for Windows File Server

lifecycle instance-attribute

lifecycle: NotRequired[FileSystemLifecycle]

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.

lustre_configuration instance-attribute

lustre_configuration: NotRequired[LustreFileSystemConfiguration]

network_interface_ids instance-attribute

network_interface_ids: NotRequired[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.

network_type instance-attribute

network_type: NotRequired[NetworkType]

The network type of the file system.

ontap_configuration instance-attribute

ontap_configuration: NotRequired[OntapFileSystemConfiguration]

The configuration for this Amazon FSx for NetApp ONTAP file system.

open_zfs_configuration instance-attribute

open_zfs_configuration: NotRequired[OpenZFSFileSystemConfiguration]

The configuration for this Amazon FSx for OpenZFS file system.

owner_id instance-attribute

owner_id: NotRequired[AWSAccountId]

The Amazon Web Services account that created the file system. If the file system was created by a user in IAM Identity Center, the Amazon Web Services account to which the IAM user belongs is the owner.

resource_arn instance-attribute

resource_arn: NotRequired[ResourceARN]

The Amazon Resource Name (ARN) of the file system resource.

storage_capacity instance-attribute

storage_capacity: NotRequired[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.

storage_type instance-attribute

storage_type: NotRequired[StorageType]

The type of storage the file system is using.

  • If set to SSD, the file system uses solid state drive storage.

  • If set to HDD, the file system uses hard disk drive storage.

  • If set to INTELLIGENT_TIERING, the file system uses fully elastic, intelligently-tiered storage.

subnet_ids instance-attribute

subnet_ids: NotRequired[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 the PreferredSubnetID 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 the PreferredSubnetID.

tags instance-attribute

tags: NotRequired[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.

vpc_id instance-attribute

vpc_id: NotRequired[VpcId]

The ID of the primary virtual private cloud (VPC) for the file system.

windows_configuration instance-attribute

windows_configuration: NotRequired[WindowsFileSystemConfiguration]

The configuration for this Amazon FSx for Windows File Server file system.