All Products
Search
Document Center

Cloud Parallel File Storage:DescribeFilesystemsAssociatedHpnZones

Last Updated:Aug 28, 2026

Retrieves the list of HpnZones for a file system. Access performance is optimal when compute nodes are located in one of the associated HpnZones.

Operation description

  • 仅支持 CPFS 智算版文件系统。

  • 此接口为批量接口,每次最多允许查询 20 个文件系统。

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The ID of the region where the file system resides.

cn-hangzhou

Filesystems

array<object>

No

The collection of file system IDs.

Note

The maximum number of elements in the set must be less than or equal to 20.

object

No

FileSystemId

string

No

The ID of the CPFS for Lingjun file system. Must start with bmcpfs-. Example: bmcpfs-290w65p03ok64ya****.

bmcpfs-290t15yn4uo8lid****

Response elements

Element

Type

Description

Example

object

RequestId

string

Request ID.

98696EF0-1607-4E9D-B01D-F20930B6****

Filesystems

array<object>

The list of HpnZones associated with the file system.

object

The HpnZone associated with the file system.

AssociatedHpnZones

array

The list of HpnZones supported by the file system.

string

The HpnZone supported by the file system.

A2

ZoneId

string

The zone ID.

cn-hangzhou-k

FileSystemId

string

The ID of the CPFS for Lingjun file system.

bmcpfs-290t15yn4uo8lid****

Examples

Success response

JSON format

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "Filesystems": [
    {
      "AssociatedHpnZones": [
        "A2"
      ],
      "ZoneId": "cn-hangzhou-k",
      "FileSystemId": "bmcpfs-290t15yn4uo8lid****"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidFilesystemType.NotSupport This Api does not support this fileSystem type. The current interface does not support this type of file system.
404 InvalidFileSystem.NotFound The specified file system does not exist. The specified file system does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.