校验存储目录唯一性

在创建 NAS 存储实例前，校验指定智算中心下的存储目录名称是否已被占用。建议在提交创建表单前调用本接口做前置校验，避免因目录重名导致创建失败。

GEThttps://api.alayanew.com/v1/nasStorage/instance/checkName

鉴权（Authorizations）

bearerAuth

AuthorizationString必填

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

Query Parameters

nameString必填

待校验的存储目录名称。例如：nas0001。

aidcIdInteger必填

智算中心（AIDC）ID。目录唯一性在同一智算中心范围内校验，不同智算中心可存在同名目录。例如：1001。

Response

application/json · 200

statusInteger

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

messageString

接口响应信息。例如："OK"。

dataBoolean

校验结果：true 表示目录名称可用（未被占用）、false 表示名称已存在。例如：true。

curl -X 'GET' \
  'https://api.alayanew.com/v1/nasStorage/instance/checkName?name=nas0001&aidcId=1001' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer [YOUR_API_KEY]'

import requests

url = "https://api.alayanew.com/v1/nasStorage/instance/checkName"
params = {"name": "nas0001", "aidcId": 1001}
headers = {
    "accept": "application/json",
    "Authorization": "Bearer [YOUR_API_KEY]"
}

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

const params = new URLSearchParams({
  name: 'nas0001',
  aidcId: '1001'
});

fetch(`https://api.alayanew.com/v1/nasStorage/instance/checkName?${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": true
}

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

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