九章智算云

订阅 NAS 存储

按指定产品规格开通一块 NAS 文件存储,用于在 CCI、分布式训练等容器化任务中持久化保存数据集、模型权重与日志。该接口为异步接口:调用成功后返回一个订阅结果标识 resultKey,需再通过查询 NAS 存储订阅结果轮询,拿到真正的存储 ID 与开通结果。

POSThttps://api.alayanew.com/v1/subscription/nasStorage/create

鉴权(Authorizations)

AuthorizationString必填

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

Request body

productCodeString必填

产品编码,决定所开通存储的产品类型与计费规格。可从资源配置/产品列表获取。例如:PRD-CCI-1

storageParamsObject

存储开通自选参数(实例化配置),用于指定本块 NAS 的目录名、容量与挂载路径等。

显示 properties
nameString

存储目录名,作为该块 NAS 的标识名,后续挂载时按此目录区分。例如:nas0001

descriptionString

存储描述,便于在控制台区分用途。例如:Nas 型存储

storageCapacityString

存储限额(容量,单位 GB),以字符串形式传入。例如:100

mountPathString

容器内默认挂载路径,挂载到任务后从该路径读写数据。例如:/root/nas

Response

statusInteger

业务状态码,200 表示请求已受理。

messageString

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

dataString

订阅结果标识 resultKey。用它调用查询 NAS 存储订阅结果轮询最终开通结果。例如:"nasStorageSubscribeResult:0d27b6b7-2dfc-476f-b9b9-f4cfda7955d5:1751597454"

curl -X 'POST' \
  'https://api.alayanew.com/v1/subscription/nasStorage/create' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer [YOUR_API_KEY]' \
  -d '{
  "productCode": "PRD-CCI-1",
  "storageParams": {
    "name": "nas0001",
    "description": "Nas 型存储",
    "storageCapacity": "100",
    "mountPath": "/root/nas"
  }
}'
import requests

url = "https://api.alayanew.com/v1/subscription/nasStorage/create"
headers = {
    "accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": "Bearer [YOUR_API_KEY]"
}
payload = {
    "productCode": "PRD-CCI-1",
    "storageParams": {
        "name": "nas0001",
        "description": "Nas 型存储",
        "storageCapacity": "100",
        "mountPath": "/root/nas"
    }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
const payload = {
  productCode: 'PRD-CCI-1',
  storageParams: {
    name: 'nas0001',
    description: 'Nas 型存储',
    storageCapacity: '100',
    mountPath: '/root/nas'
  }
};

fetch('https://api.alayanew.com/v1/subscription/nasStorage/create', {
  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": "nasStorageSubscribeResult:0d27b6b7-2dfc-476f-b9b9-f4cfda7955d5:1751597454"
}
{
  "status": 403,
  "message": "Forbidden",
  "data": {}
}
{
  "status": 500,
  "message": "Internal Server Error",
  "data": {}
}

最后更新于