目录挂载资源列表

分页查询当前正在挂载使用指定 NAS 存储实例的资源（如容器实例 / Pod），可了解该存储卷被哪些实例占用、挂载在实例内的路径及读写状态。在删除或调整存储前，可借此确认是否仍有实例在使用，避免误删导致业务中断。

GEThttps://api.alayanew.com/v1/nasStorage/instance/{id}/use/page

鉴权（Authorizations）

bearerAuth

AuthorizationString必填

用户可通过已获取的 Open API Key 做验证。例如：Bearer [YOUR_API_KEY]。

Path Parameters

idString必填

NAS 存储实例 ID，即要查询挂载资源的目标存储卷。例如：00964ce3-b99c-43da-8826-ab9c5574eef2。

Query Parameters

pageNoInteger

页码，从 1 开始。例如：1。

pageSizeInteger

每页行数。例如：20。

nasStorageIdString

按存储实例 ID 过滤挂载关系，通常与 Path 中的 id 一致。例如：00964ce3-b99c-43da-8826-ab9c5574eef2。

tenantIdString

按租户 ID 过滤，仅返回该租户下挂载此存储的资源。例如：4d7119bd-8e71-49a9-a319-f84d165f79d9。

Response

application/json · 200

statusInteger

业务状态码，200 表示成功。

messageString

接口响应信息，成功或失败原因描述。例如："OK"。

dataObject

分页数据对象，包含挂载资源记录列表与分页信息。

显示 properties

recordsArray

挂载资源记录列表，每条记录对应一个正在使用该存储的实例。

显示 properties

nasStorageIdString

被挂载的 NAS 存储实例 ID。例如："00964ce3-b99c-43da-8826-ab9c5574eef2"。

instanceIdString

挂载该存储的资源实例 ID。例如："7b3f9c10-2a8e-4d51-9f0a-1c2d3e4f5a6b"。

instanceNameString

资源实例名称。例如："train-job-001"。

instanceTypeNameString

资源实例类型名称，标识该实例属于哪类资源（如训练任务、推理服务等）。例如："分布式训练"。

instancePodPathString

该存储在实例内的挂载路径。例如："/root/nas/"。

statusString

实例当前状态。例如："RUNNING"。

onlyReadBoolean

挂载读写状态：true 只读、false 读写。例如：true。

pageNoInteger

当前页码。例如：1。

pageSizeInteger

每页行数。例如：20。

totalRowsInteger

总行数。例如：120。

curl -X 'GET' \
  'https://api.alayanew.com/v1/nasStorage/instance/00964ce3-b99c-43da-8826-ab9c5574eef2/use/page?pageNo=1&pageSize=20' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer [YOUR_API_KEY]'

import requests

storage_id = "00964ce3-b99c-43da-8826-ab9c5574eef2"
url = f"https://api.alayanew.com/v1/nasStorage/instance/{storage_id}/use/page"
params = {"pageNo": 1, "pageSize": 20}
headers = {
    "accept": "application/json",
    "Authorization": "Bearer [YOUR_API_KEY]"
}

response = requests.get(url, params=params, headers=headers)
print(response.json())

const storageId = '00964ce3-b99c-43da-8826-ab9c5574eef2';
const params = new URLSearchParams({
  pageNo: '1',
  pageSize: '20'
});

fetch(`https://api.alayanew.com/v1/nasStorage/instance/${storageId}/use/page?${params}`, {
  method: 'GET',
  headers: {
    'accept': 'application/json',
    'Authorization': 'Bearer [YOUR_API_KEY]'
  }
})
  .then(res => res.json())
  .then(console.log)
  .catch(console.error);

{
  "status": 200,
  "message": "OK",
  "data": {
    "records": [
      {
        "nasStorageId": "00964ce3-b99c-43da-8826-ab9c5574eef2",
        "instanceId": "7b3f9c10-2a8e-4d51-9f0a-1c2d3e4f5a6b",
        "instanceName": "train-job-001",
        "instanceTypeName": "分布式训练",
        "instancePodPath": "/root/nas/",
        "status": "RUNNING",
        "onlyRead": true
      }
    ],
    "pageNo": 1,
    "pageSize": 20,
    "totalRows": 120
  }
}

{
  "status": 403,
  "message": "Forbidden",
  "data": {}
}

{
  "status": 500,
  "message": "Internal Server Error",
  "data": {}
}