All Products
Search
Document Center

File Storage NAS:DescribeFilesystemsAssociatedHpnZones

Last Updated:Aug 28, 2026

Queries the HpnZones associated with file systems. Compute nodes in an associated HpnZone achieve optimal access performance.

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 file system IDs.

Note

The maximum number of elements in the set cannot exceed 20.

object

No

FileSystemId

string

No

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

bmcpfs-290t15yn4uo8lid****

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

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

Filesystems

array<object>

The HpnZones associated with the file system.

object

The HpnZone associated with the file system.

AssociatedHpnZones

array

The 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. This API operation does not support this file system type.
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.