DescribeFileSystems - Apsara File Storage NAS - Alibaba Cloud Documentation Center

Queries file systems.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
FileSystemId	string	No	The ID of the file system. Sample ID of a General-purpose NAS file system: 31a8e4**. The IDs of Extreme NAS file systems must start with extreme-, for example, extreme-0015. The IDs of Cloud Parallel File Storage (CPFS) file systems must start with cpfs-, for example, cpfs-125487. Note** CPFS file systems are available only on the China site (aliyun.com).	109c04****
FileSystemType	string	No	The type of the file system. Valid values: all (default): all types standard: General-purpose NAS file system extreme: Extreme NAS file system cpfs: CPFS file system Note CPFS file systems are available only on the China site (aliyun.com).	standard
VpcId	string	No	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.	vpc-bp1sevsgtqvk5gxbl****
PageSize	integer	No	The number of entries per page. Valid values: 1 to 100. Default value: 10.	1
PageNumber	integer	No	The page number. Pages start from page 1. Default value: 1.	1
Tag	object []	No	The details about the tags.
Key	string	No	The key of tag N to add to the resource. Limits: Valid values of N: 1 to 20. The tag key must be 1 to 128 characters in length. The tag key cannot start with `aliyun` or `acs:`. The tag key cannot contain `http://` or `https://`.
Value	string	No	The value of tag N to add to the resource. Limits: Valid values of N: 1 to 20. The tag value must be 1 to 128 characters in length. The tag value cannot start with `aliyun` or `acs:`. The tag value cannot contain `http://` or `https://`.

Response parameters

Parameter	Type	Description	Example
	object
FileSystems	object []	The queried file systems.
Status	string	The status of the file system. 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 up. Stopping: The file system is being stopped. Deleting: The file system is being deleted.	Pending
MeteredIASize	long	The storage usage of the Infrequent Access (IA) storage medium. Unit: bytes.	362832
Capacity	long	The capacity of the file system. Unit: GiB.	1
CreateTime	string	The time when the file system was created.	2020-01-05T16:00:00Z
ChargeType	string	The billing method. 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.	PayAsYouGo
Tags	object []	The tags that are attached to the file system.
Key	string	The tag key.	sdf
Value	string	The tag value.	asd123
StorageType	string	The storage type. 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). Note CPFS file systems are available only on the China site (aliyun.com).	Performance
MeteredSize	long	The storage usage of the file system. The value of this parameter is the maximum storage usage of the file system over the last hour. Unit: bytes.	1611661312
Description	string	The description of the file system.	31a8e48eda
Bandwidth	long	The bandwidth of the file system. Unit: MB/s. This parameter is unavailable for General-purpose NAS file systems.	150
SupportedFeatures	array	The features that are supported by the file system.
	string	The feature that is supported by the file system. Valid values: Lifecycle: lifecycle management ACL: access control list (ACL) Ipv6: IPv6 Note Only Extreme NAS file systems that reside in the Chinese mainland support IPv6.	Lifecycle
Version	string	The version number of the file system. This parameter is available only for Extreme NAS file systems.	1
ProtocolType	string	The protocol type of the file system. Valid values: NFS: Network File System (NFS) SMB: Server Message Block (SMB) cpfs: the protocol type supported by the CPFS file system Note CPFS file systems are available only on the China site (aliyun.com).	NFS
MountTargets	object []	The information about mount targets.
VpcId	string	The ID of the VPC.	vpc-bp1sevsgtqvk5gxbl****
Status	string	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. Hibernating: The mount target is being hibernated. Hibernated: The mount target is hibernated.	active
ClientMasterNodes	object []	The information about client management nodes. This parameter is available only for CPFS file systems.
EcsId	string	The ID of the ECS instance on the client management node.	i-hp3i3odi5ory1buo****
DefaultPasswd	string	The default logon password of the ECS instance on the client management node.	123456
EcsIp	string	The IP address of the ECS instance on the client management node.	192.168.1.0
MountTargetDomain	string	The domain name of the mount target.	109c042666-w****.cn-hangzhou.nas.aliyuncs.com
AccessGroupName	string	The name of the permission group that is attached to the mount target.	test-001
DualStackMountTargetDomain	string	The dual-stack (IPv4 and IPv6) domain name of the mount target. Note Only Extreme NAS file systems that reside in the Chinese mainland support IPv6.	174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com
VswId	string	The ID of the vSwitch.	vsw-bp1omfzsszekkvaxn****
Tags	object []	The tags that are attached to the mount target.
Key	string	The tag key.	adasfsdfd
Value	string	The tag value.	afsa
NetworkType	string	The network type. Valid value: vpc.	vpc
KMSKeyId	string	The ID of the key that is managed by Key Management Service (KMS).	0e478b7a-4262-4802-b8cb-00d3fb40****
RegionId	string	The region ID.	cn-hangzhou
FileSystemType	string	The type of the file system. Valid values: standard: General-purpose NAS file system extreme: Extreme NAS file system cpfs: CPFS file system Note CPFS file systems are available only on the China site (aliyun.com).	standard
FileSystemId	string	The ID of the file system.	109c04****
EncryptType	integer	The encryption type. Valid values: 0: The data in the file system is not encrypted. 1: A NAS-managed key is used to encrypt the data in the file system. 2: A KMS-managed key is used to encrypt the data in the file system.	1
Ldap	object	The Lightweight Directory Access Protocol (LDAP) configurations. This parameter is available only for CPFS file systems.
BindDN	string	An LDAP entry.	cn=alibaba,dc=com
SearchBase	string	An LDAP search base.	dc=example
URI	string	An LDAP URI.	ldap://ldap.example.example
ExpiredTime	string	The time when the file system expires.	2020-01-05T16:00:00Z
ZoneId	string	The ID of the zone where the file system resides.	cn-hangzhou-b
Packages	object []	The information about storage plans.
StartTime	string	The start time of the validity period for the storage plan.	2019-12-05T01:40:56Z
ExpiredTime	string	The end time of the validity period for the storage plan.	2020-01-05T16:00:00Z
Size	long	The capacity of the storage plan. Unit: bytes.	107374182400
PackageId	string	The ID of the storage plan.	naspackage-0be9c4b624-37****
PackageType	string	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	hybrid
TotalCount	integer	The total number of file systems.	1
RequestId	string	The request ID.	035B3A3A-E514-4B41-B906-5D906CFB****
PageSize	integer	The number of entries per page.	1
PageNumber	integer	The page number.	1

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status code	Error code	Error message	Description
404	InvalidFileSystem.NotFound	The specified file system does not exist.	The specified file system does not exist.

For a list of error codes, visit the Service error codes.

Change history

Change time

Summary of changes

Operation

2023-12-26

The Error code has changed. The request parameters of the API has changed. The response structure of the API has changed

see changesets

Change item	Change content
Error Codes	The Error code has changed.
	delete Error Codes: 400
	delete Error Codes: 404
Input Parameters	The request parameters of the API has changed.
	Added Input Parameters: ResourceGroupId
Output Parameters	The response structure of the API has changed.

2023-11-03

The Error code has changed

see changesets

Change item	Change content
Error Codes	The Error code has changed.
	delete Error Codes: 404
	Added Error Codes: 400

2023-10-05

The Error code has changed

see changesets

Change item	Change content
Error Codes	The Error code has changed.
	delete Error Codes: 404

2023-04-29

The Error code has changed

see changesets

Change item	Change content
Error Codes	The Error code has changed.
	delete Error Codes: 404

2022-07-29

The Error code has changed. The response structure of the API has changed

see changesets

Change item	Change content
Error Codes	The Error code has changed.
	delete Error Codes: 404
Output Parameters	The response structure of the API has changed.