设置存储共享

将指定 NAS 存储实例共享给企业内的其他用户，或调整、撤销已有的共享授权。请求体为一个数组，可在一次调用中对多个用户批量设置授权，每个授权项通过 policy 指定该用户对该存储的访问权限。设置完成后，可调用查询存储共享列表确认共享结果。

POSThttps://api.alayanew.com/v1/nasStorage/instance/{id}/share

鉴权（Authorizations）

bearerAuth

AuthorizationString必填

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

Path Parameters

idString必填

NAS 存储实例 ID，即要设置共享的目标存储卷。例如：00964ce3-b99c-43da-8826-ab9c5574eef2。

Request body

application/json

bodyArray必填

请求体为共享授权项数组，数组中每一项对应一个被授权用户，可一次性传入多个用户实现批量授权。

显示 properties

userIdString

被共享用户的 ID，即把该存储授权给哪位企业成员。例如：00964ce3-b99c-43da-8826-ab9c5574eef2。

policyString

共享策略，决定该用户对存储的访问权限。取值：R 只读、RW 读写、取消共享（移除该用户对此存储的授权）。例如：R。

Response

application/json · 200

statusInteger

业务状态码，200 表示共享设置成功。

messageString

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

dataObject

本接口成功时不返回业务数据，固定为空对象 {}。

curl -X 'POST' \
  'https://api.alayanew.com/v1/nasStorage/instance/00964ce3-b99c-43da-8826-ab9c5574eef2/share' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer [YOUR_API_KEY]' \
  -d '[
  {
    "userId": "00964ce3-b99c-43da-8826-ab9c5574eef1",
    "policy": "R"
  }
]'

import requests

storage_id = "00964ce3-b99c-43da-8826-ab9c5574eef2"
url = f"https://api.alayanew.com/v1/nasStorage/instance/{storage_id}/share"
headers = {
    "accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": "Bearer [YOUR_API_KEY]"
}
payload = [
    {
        "userId": "00964ce3-b99c-43da-8826-ab9c5574eef1",
        "policy": "R"
    }
]

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const storageId = '00964ce3-b99c-43da-8826-ab9c5574eef2';
const payload = [
  {
    userId: '00964ce3-b99c-43da-8826-ab9c5574eef1',
    policy: 'R'
  }
];

fetch(`https://api.alayanew.com/v1/nasStorage/instance/${storageId}/share`, {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer [YOUR_API_KEY]'
  },
  body: JSON.stringify(payload)
})
  .then(res => res.json())
  .then(console.log)
  .catch(console.error);

{
  "status": 200,
  "message": "OK",
  "data": {}
}

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

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