Queries the information of file systems.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
FileSystemId String No 109c04****

The ID of the file system.

FileSystemType String No standard

The type of the file system.

Default value: all. Valid values:

  • all: all file systems
  • standard: General-purpose NAS file system
  • extreme: Extreme NAS file system
  • cpfs: CPFS file system
VpcId String No vpc-bp1sevsgtqvk5gxbl****

The ID of the virtual private cloud (VPC).

If you want to mount the file system on an Elastic Compute Service (ECS) instance, the file system and the ECS instance must reside in the same VPC.

PageSize Integer No 1

The number of entries to return on each page.

Valid values: 1 to 100

Default value: 10

PageNumber Integer No 1

The number of the page to return.

Minimum value: 1. Default value: 1.

Tag.N.Key String No N/A

The key of tag N.

Limits:

  • Valid values of N: 1 to 20.
  • The value of this parameter can be a maximum of 128 characters in length.
  • The value of this parameter cannot start with aliyun or acs:.
  • The value of this parameter cannot contain http:// or https://.
Tag.N.Value String No N/A

The value of tag N.

Limits:

  • Valid values of N: 1 to 20.
  • The value of this parameter can be a maximum of 128 characters in length.
  • The value of this parameter cannot start with aliyun or acs:.
  • The value of this parameter cannot contain http:// or https://.

Response parameters

Parameter Type Example Description
FileSystems Array of FileSystem

The list of file systems.

FileSystem
Status String Pending

The status of the fie system.

This parameter is returned for Extreme NAS and CPFS file systems. Valid values:

  • Pending: The file system is being created or modified.
  • Running: The file system is available. Before you create a mount target for the file system, make sure that the file system is in the Running state.
  • Stopped: The file system is unavailable.
  • Extending: The file system is being scaled.
  • Stopping: The file system is being stopped.
  • Deleting: The file system is being deleted.
MeteredIASize Long 362832

The storage usage of the Infrequent Access (IA) storage medium.

Unit: byte.

Capacity Long 1

The capacity of the file system.

Unit: GiB.

CreateTime String 2017-05-27T15:43:06CST

The time when the file system was created.

ChargeType String PayAsYouGo

The billing method of the file system.

Valid values:

  • Subscription: The subscription billing method is used.
  • PayAsYouGo: The pay-as-you-go billing method is used.
  • Package: A storage plan is attached to the file system.
Tags Array of Tag

The list of tags that are attached to the file system.

Tag
Key String sdf

The key of the tag.

Value String asd123

The value of the tag.

StorageType String Performance

The type of the storage.

Valid values:

  • Valid values for General-purpose NAS file systems: Capacity and Performance.
  • Valid values for Extreme NAS file systems: standard and advance.
  • Valid values for CPFS file systems: advance_100 (100 MB/s/TiB baseline) and advance_200 (200 MB/s/TiB baseline).
MeteredSize Long 1611661312

The storage usage of the file system.

The value of this parameter is the maximum storage usage of the file system within the last hour. Unit: byte.

Description String 31a8e48eda

The description of the file system.

Bandwidth Long 150

The bandwidth of the file system.

Unit: MB/s. This parameter is unavailable for General-purpose NAS file systems.

SupportedFeatures Array of String Lifecycle

The features that are supported by the file system.

Valid values:

  • Lifecycle: the lifecycle management feature.
  • ACL: the access control list feature.
  • Ipv6: the IPv6 feature.
Note Only Extreme NAS file systems that reside in the China (Hohhot) region support IPv6.
Version String 1

The version number of the file system.

This parameter is available only for Extreme NAS file systems.

ProtocolType String NFS

The type of the protocol.

Valid values:

  • NFS: the Network File System (NFS) protocol.
  • SMB: the Server Message Block (SMB) protocol.
  • cpfs: the protocols supported by CPFS file systems.
MountTargets Array of MountTarget

The list of mount targets.

MountTarget
VpcId String vpc-bp1sevsgtqvk5gxbl****

The ID of the virtual private cloud (VPC).

Status String active

The status of the mount target.

Valid values:

  • Active: The mount target is available.
  • Inactive: The mount target is unavailable.
  • Pending: The mount target is being created or modified.
  • Deleting: The mount target is being deleted.
ClientMasterNodes Array of ClientMasterNode

The list of clients in the management node.

ClientMasterNode
EcsId String i-hp3i3odi5ory1buo****

The ID of the ECS instance in the management node.

DefaultPasswd String 123456

The default logon password of the ECS instance in the management node.

EcsIp String 192.168.1.0

The IP address of the ECS instance in the management node.

MountTargetDomain String 109c042666-w****.cn-hangzhou.nas.aliyuncs.com

The domain name of the mount target.

AccessGroupName String test-001

The name of the permission group that is attached to the mount target.

DualStackMountTargetDomain String 174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com

The dual-stack domain name of the mount target.

VswId String vsw-bp1omfzsszekkvaxn****

The ID of the vSwitch.

Tags Array of Tag

The list of tags that are attached to the mount target.

Tag
Key String adasfsdfd

The key of the tag.

Value String afsa

The value of the tag.

NetworkType String vpc

The network type of the mount target.

Valid values:

  • vpc: the VPC network.
  • classic: the classic network.
KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40****

The ID of the key that is managed by Key Management Service (KMS).

RegionId String cn-hangzhou

The ID of the region.

FileSystemType String all

The type of the file system.

Valid values:

  • standard: General-purpose NAS file system
  • extreme: Extreme NAS file system
  • cpfs: CPFS file system
FileSystemId String 109c04****

The ID of the file system.

EncryptType Integer 1

The type of the encryption.

Valid values:

  • 0: The data in the file system is not encrypted.
  • 1: NAS-managed keys are used to encrypt the data in the file system.
  • 2: User-managed keys are used to encrypt the data in the file system.
Ldap Object

The configuration of the Lightweight Directory Access Protocol (LDAP).

This parameter is available only for CPFS file systems.

BindDN String cn=alibaba,dc=com

An LDAP entry.

SearchBase String dc=example

An LDAP search base.

URI String ldap://ldap.example.example

An LDAP URI.

ExpiredTime String 2017-08-27T15:43:06CST

The expiration time of the file system.

ZoneId String cn-hangzhou-b

The ID of the zone where the file system resides.

Packages Array of Package

The list of storage plans.

Package
StartTime String 2019-12-05T01:40:56Z

The start time of the validity period for the storage plan.

ExpiredTime String 2020-01-05T16:00:00Z

The end time of the validity period for the storage plan.

Size Long 107374182400

The capacity of the storage plan.

PackageId String naspackage-0be9c4b624-37****

The ID of the storage plan.

PackageType String hybrid

The type of the storage plan.

Valid values:

  • ssd: the storage plan for Performance NAS file systems.
  • hybrid: the storage plan for Capacity NAS file systems.
TotalCount Integer 1

The total number of file systems.

RequestId String 035B3A3A-E514-4B41-B906-5D906CFB****

The ID of the request.

PageSize Integer 1

The number of entries returned per page.

PageNumber Integer 1

The page number of the returned page.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeFileSystems
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<FileSystems>
    <FileSystem>
        <Status>Pending</Status>
        <KMSKeyId>0e478b7a-4262-4802-b8cb-00d3fb40****</KMSKeyId>
        <StorageType>Performance</StorageType>
        <Description>31a8e48eda</Description>
        <ZoneId>cn-hangzhou-b</ZoneId>
        <MeteredIASize>362832</MeteredIASize>
        <CreateTime>2017-05-27T15:43:06CST</CreateTime>
        <MeteredSize>1611661312</MeteredSize>
        <EncryptType>1</EncryptType>
        <Version>1</Version>
        <Capacity>1</Capacity>
        <ChargeType>PayAsYouGo</ChargeType>
        <ProtocolType>NFS</ProtocolType>
        <Bandwidth>150</Bandwidth>
        <FileSystemType>all</FileSystemType>
        <ExpiredTime>2017-08-27T15:43:06CST</ExpiredTime>
        <FileSystemId>109c04****</FileSystemId>
        <RegionId>cn-hangzhou</RegionId>
    </FileSystem>
    <FileSystem>
        <MountTargets>
            <MountTarget>
                <Status>active</Status>
                <DualStackMountTargetDomain>174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com</DualStackMountTargetDomain>
                <VswId>vsw-bp1omfzsszekkvaxn****</VswId>
                <VpcId>vpc-bp1sevsgtqvk5gxbl****</VpcId>
                <MountTargetDomain>109c042666-w****.cn-hangzhou.nas.aliyuncs.com</MountTargetDomain>
                <NetworkType>vpc</NetworkType>
                <AccessGroupName>test-001</AccessGroupName>
            </MountTarget>
            <MountTarget>
                <ClientMasterNodes>
                    <ClientMasterNode>
                        <EcsId>i-hp3i3odi5ory1buo****</EcsId>
                        <EcsIp>192.168.1.0</EcsIp>
                        <DefaultPasswd>123456</DefaultPasswd>
                    </ClientMasterNode>
                </ClientMasterNodes>
                <Tags>
                    <Tag>
                        <Value>afsa</Value>
                        <Key>adasfsdfd</Key>
                    </Tag>
                </Tags>
            </MountTarget>
        </MountTargets>
        <Packages>
            <Package>
                <StartTime>2019-12-05T01:40:56Z</StartTime>
                <PackageId>naspackage-0be9c4b624-37****</PackageId>
                <Size>107374182400</Size>
                <ExpiredTime>2020-01-05T16:00:00Z</ExpiredTime>
                <PackageType>hybrid</PackageType>
            </Package>
        </Packages>
        <Tags>
            <Tag>
                <Value>asd123</Value>
                <Key>sdf</Key>
            </Tag>
        </Tags>
    </FileSystem>
    <FileSystem>
        <SupportedFeatures>
            <SupportedFeature>Lifecycle</SupportedFeature>
        </SupportedFeatures>
    </FileSystem>
    <FileSystem>
        <Ldap>
            <SearchBase>dc=example</SearchBase>
            <URI>ldap://ldap.example.example</URI>
            <BindDN>cn=alibaba,dc=com</BindDN>
        </Ldap>
    </FileSystem>
</FileSystems>
<TotalCount>1</TotalCount>
<PageSize>1</PageSize>
<RequestId>035B3A3A-E514-4B41-B906-5D906CFB****</RequestId>
<PageNumber>1</PageNumber>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "FileSystems" : {
    "FileSystem" : [ {
      "Status" : "Pending",
      "KMSKeyId" : "0e478b7a-4262-4802-b8cb-00d3fb40****",
      "StorageType" : "Performance",
      "Description" : "31a8e48eda",
      "ZoneId" : "cn-hangzhou-b",
      "MeteredIASize" : 362832,
      "CreateTime" : "2017-05-27T15:43:06CST",
      "MeteredSize" : 1611661312,
      "EncryptType" : 1,
      "Version" : 1,
      "Capacity" : 1,
      "ChargeType" : "PayAsYouGo",
      "ProtocolType" : "NFS",
      "Bandwidth" : 150,
      "FileSystemType" : "all",
      "ExpiredTime" : "2017-08-27T15:43:06CST",
      "FileSystemId" : "109c04****",
      "RegionId" : "cn-hangzhou"
    }, {
      "MountTargets" : {
        "MountTarget" : [ {
          "Status" : "active",
          "DualStackMountTargetDomain" : "174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com",
          "VswId" : "vsw-bp1omfzsszekkvaxn****",
          "VpcId" : "vpc-bp1sevsgtqvk5gxbl****",
          "MountTargetDomain" : "109c042666-w****.cn-hangzhou.nas.aliyuncs.com",
          "NetworkType" : "vpc",
          "AccessGroupName" : "test-001"
        }, {
          "ClientMasterNodes" : {
            "ClientMasterNode" : {
              "EcsId" : "i-hp3i3odi5ory1buo****",
              "EcsIp" : "192.168.1.0",
              "DefaultPasswd" : 123456
            }
          },
          "Tags" : {
            "Tag" : {
              "Value" : "afsa",
              "Key" : "adasfsdfd"
            }
          }
        } ]
      },
      "Packages" : {
        "Package" : {
          "StartTime" : "2019-12-05T01:40:56Z",
          "PackageId" : "naspackage-0be9c4b624-37****",
          "Size" : 107374182400,
          "ExpiredTime" : "2020-01-05T16:00:00Z",
          "PackageType" : "hybrid"
        }
      },
      "Tags" : {
        "Tag" : {
          "Value" : "asd123",
          "Key" : "sdf"
        }
      }
    }, {
      "SupportedFeatures" : {
        "SupportedFeature" : "Lifecycle"
      }
    }, {
      "Ldap" : {
        "SearchBase" : "dc=example",
        "URI" : "ldap://ldap.example.example",
        "BindDN" : "cn=alibaba,dc=com"
      }
    } ]
  },
  "TotalCount" : 1,
  "PageSize" : 1,
  "RequestId" : "035B3A3A-E514-4B41-B906-5D906CFB****",
  "PageNumber" : 1
}

Error codes

HttpCode Error code Error message Description
404 InvalidFileSystem.NotFound The specified file system does not exist. The error message returned because the specified file system does not exist.

For a list of error codes, visit the API Error Center.