查询存储共享列表

分页查询指定 NAS 存储实例当前已共享的用户列表，可查看每位用户被授予的访问策略与授权时间，便于核对和管理共享关系。共享授权可通过设置存储共享添加或撤销。

GEThttps://api.alayanew.com/v1/nasStorage/instance/{id}/share/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。

userNameString

按被共享用户名称模糊查询，用于在共享列表中快速定位某位成员。例如：zhangsan。

Response

application/json · 200

statusInteger

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

messageString

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

dataObject

分页数据对象，包含共享用户记录列表与分页信息。

显示 properties

recordsArray

共享记录列表，每条记录对应一位被授权用户。

显示 properties

nasStorageIdString

所共享的 NAS 存储实例 ID。例如："00964ce3-b99c-43da-8826-ab9c5574eef2"。

userIdString

被共享用户的 ID。例如："00964ce3-b99c-43da-8826-ab9c5574eef1"。

userNameString

被共享用户的名称。例如："zhangsan"。

sharePolicyObject

该用户被授予的共享策略对象。

显示 properties

policyString

访问策略：R 只读、RW 读写。例如："R"。

tenantIdString

该共享关系所属的租户 ID。

createTimeString

共享创建时间。例如："2025-12-10 00:00:00"。

lastUpdateTimeString

共享最近更新时间。例如："2025-12-10 23:59:59"。

pageNoInteger

当前页码。例如：1。

pageSizeInteger

每页行数。例如：20。

totalRowsInteger

总行数。例如：120。

curl -X 'GET' \
  'https://api.alayanew.com/v1/nasStorage/instance/00964ce3-b99c-43da-8826-ab9c5574eef2/share/page?pageNo=1&pageSize=20&userName=zhangsan' \
  -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}/share/page"
params = {"pageNo": 1, "pageSize": 20, "userName": "zhangsan"}
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',
  userName: 'zhangsan'
});

fetch(`https://api.alayanew.com/v1/nasStorage/instance/${storageId}/share/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",
        "userId": "00964ce3-b99c-43da-8826-ab9c5574eef1",
        "userName": "zhangsan",
        "sharePolicy": {
          "policy": "R"
        },
        "tenantId": "4d7119bd-8e71-49a9-a319-f84d165f79d9",
        "createTime": "2025-12-10 00:00:00",
        "lastUpdateTime": "2025-12-10 23:59:59"
      }
    ],
    "pageNo": 1,
    "pageSize": 20,
    "totalRows": 120
  }
}

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

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