创建卷实例 | 大装置帮助中心
跳到主要内容

创建卷实例

POST /storage/afs/v2/subscriptions/{subscription_name}/resourceGroups/{resource_group_name}/zones/{zone}/virtualVolumes/{virtual_volume_name}

请求头（Request Header）​

参考认证（authentication）

请求参数（Request Parameters​

名称类型必须位置默认值取值范围描述
subscription_namestring是path--订阅标识
resource_group_namestring是path--资源组标识
zonestring是path--可用区
virtual_volume_namestring是path-^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$存储卷资源名称

请求体（Request Body）​

名称类型必须默认值取值范围描述
idstring否--存储卷资源 ID
namestring否--存储卷资源名称
display_namestring是-最大 256 字符，支持中英文、数字、_-显示名称
descriptionstring否--资源描述
uidstring否--资源 UUID
resource_typestring是-固定值 storage.afs.v2.volume资源类型
creator_idstring否--创建者 ID
owner_idstring否--拥有者 ID
tenant_idstring否--租户 ID
zonestring是--可用区
stateenum否--资源状态
sku_idstring是--SKU 标识
tagsmap<string,string>否--资源标签
propertiesobject是--存储卷属性
order_infoobject是--订单信息
deletedbool否-true / false是否删除
create_timetimestamp否--创建时间
update_timetimestamp否--更新时间

其中，state有如下情况

状态含义
CREATING创建中(默认值)
UPDATING更新中
ACTIVE已激活
DELETING删除中
DELETED已删除
FAILED失败
EXPIREDOWNGRADING到期降级中
EXPIREDOWNGRADED到期已降级
RENEWUPGRADING续订升级中
EXPIRESTOPPING到期停服中
EXPIRESTOPPED到期已停服
RENEWSTARTING续订恢复中
DOWNGRADING服务降级中
DOWNGRADE服务降级
RESTORING服务降级恢复中

其中，properties的参数如下

名称类型必须默认值取值范围描述
resourcesobject是--资源规格
storage_classenum是STANDARDSTANDARD / EFFICIENT / OCEANSTOR存储类型

其中，resources的参数如下

名称类型必须默认值取值范围描述
billing_itemsobject是--计费项

其中，billing_items的参数如下

名称类型必须默认值取值范围描述
capacityint32是-> 0存储容量
capacity_unitenum是-EB / PB / TB / GB容量单位

其中，order_info的参数如下

参数名类型必须默认值取值范围描述
billing_cycle_numbernumber是--购买时长
auto_renewbool否--自动续费
currency_codestring是--货币代码
payment_channelPaymentChannel是--支付方式
notestring否--订单备注
order_typeOrderType是--订单类型
order_idstring否--订单id
start_timestring是--订单生效日期
payment_modelPaymentModel是--付费类型
billing_modelBillingModel是--计费类型
original_idstring否--合同包ID(专有云订单使用)
end_timestring否--订单结束时间
auto_convert_postpaidbool否--预付费自动转后付费

其中，payment_channel有如下情况

状态含义
PC_UNSPECIFIED未指定
PC_BALANCE余额支付
PC_CREDIT信用支付
PC_FROZENACCOUNT冻结款支付
PC_REMIT_OFFLINE线下汇款
PC_ALIPAY支付宝支付
PC_UNIONPAY银联支付
PC_REMIT_ONLINE在线转账
PC_CONTRACT合同包支付

其中，order_type有如下情况

状态含义
OT_UNSPECIFIED未指定
OT_ORIGINAL原始订单
OT_RENEW续费订单
OT_UPGRADED升配订单
OT_DOWNGRADED降配订单
OT_CONTRACT合同订单
OT_UNSUBSCRIBE退订订单
OT_RESIZE扩缩容订单

其中，payment_model有如下情况

状态含义
PM_UNSPECIFIED未指定
PM_PREPAID预付
PM_POSTPAID后付费

其中，billing_model有如下情况

状态含义
BM_UNSPECIFIED未指定
BM_USAGE按量计费
BM_MONTHLY包月
BM_YEARLY包年

请求示例（Request Example）​

curl 'https://management.sensecoreapi.tech/storage/afs/v2/subscriptions/076cf030-087d-4855-9833-4fac39707563/resourceGroups/default/zones/cn-sh-01a/virtualVolumes/afs-createfs' \
  -H 'Accept: application/json' \
  -H 'Accept-Language: zh-CN' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json' \
  -H 'Origin: https://console.sensecore.tech' \
  -H 'Referer: https://console.sensecore.tech/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: cross-site' \
  -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36' \
  -H 'authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6InB1YmxpYzpoeWRyYS5qd3QuYWNjZXNzLXRva2VuIiwidHlwIjoiSldUIn0.eyJhdWQiOltdLCJjbGllbnRfaWQiOiI0ZTQxNDg1NC03MjAwLTUwOWYtYjk2MC1mOGIwZGJiYmYzMzEiLCJleHAiOjE3NjUzNTkyMTUsImV4dCI6eyJhbGxfYXoiOmZhbHNlLCJhel9saXN0IjpbImNuLXNoLTAxYSIsImNuLXNoLTAxYiIsImNuLXNoLTAxYyIsImNuLXNoLTAxZSIsImNuLXNoLTAxZiIsImNuLXNoLTAxcCIsImNuLXNoLTAxcSIsImNuLXNoLTAxdCIsImNuLXNoLTAxeiJdLCJpc19kZWRpY2F0ZWRfdGVuYW50Ijp0cnVlLCJwYXJ0bmVyX2lkIjoiIiwicHJpbmNpcGFsX2lkIjoiOTRkOWIwZmItZDI4NC00ZmVkLWI3MzItNGE3M2Q3YTViNmJjIiwicHJpbmNpcGFsX25hbWUiOiJzdG9yYWdlMTAyMCIsInByaW5jaXBhbF90eXBlIjoidXNlciIsInBycF9saXN0IjpbImNuLXNoLTAxYS1wcnAwMSIsImNuLXNoLTAxYi1wcnAwMSIsImNuLXNoLTAxYy1wcnAwMSIsImNuLXNoLTAxZS1wcnAwMSIsImNuLXNoLTAxZi1wcnAwMSIsImNuLXNoLTAxcC1wcnAwMSIsImNuLXNoLTAxcS1wcnAwMSIsImNuLXNoLTAxdC1wcnAwMSIsImNuLXNoLTAyYS1wcnAwMSIsImNuLXNoLTAyYi1wcnAwMSIsImNuLXNoLTAyYy1wcnAwMSJdLCJ0ZW5hbnRfY2F0ZWdvcnkiOiJjdXN0b21lciIsInRlbmFudF9jZXJ0aWZ5X3N0YXR1cyI6dHJ1ZSwidGVuYW50X2NlcnRpZnlfdHlwZSI6ImVudGVycHJpc2UiLCJ0ZW5hbnRfY29kZSI6InN0b3JhZ2UxMDIwIiwidGVuYW50X2lkIjoiMDc2Y2YwMzAtMDg3ZC00ODU1LTk4MzMtNGZhYzM5NzA3NTYzIiwidXNlcl9pZCI6Ijk0ZDliMGZiLWQyODQtNGZlZC1iNzMyLTRhNzNkN2E1YjZiYyIsInVzZXJfdHlwZSI6ImFkbWluIiwidXNlcm5hbWUiOiJzdG9yYWdlMTAyMCJ9LCJpYXQiOjE3NjUzNDg0MTQsImlzcyI6Imh0dHBzOi8vc2lnbmluLnNlbnNlY29yZS50ZWNoLyIsImp0aSI6ImFhMGFhYjFmLTFkMDktNDYzMS1iYmMwLTYwZWE3YzBiNTg2NCIsIm5iZiI6MTc2NTM0ODQxNCwic2NwIjpbIm9wZW5pZCIsIm9mZmxpbmUiLCJvZmZsaW5lX2FjY2VzcyJdLCJzdWIiOiI5NGQ5YjBmYi1kMjg0LTRmZWQtYjczMi00YTczZDdhNWI2YmMifQ.j6NZmFX716c655Xy-JaazSMYAdMutbICAlUww0ZlqKmzeGykw8vJNa3OMlNyedWeSycy5oO0elKRgqMHXP2YzhDut-X8gnTvCLPny8zNLORZLg17jOC-QJ4W-OcBM9tyEGog_R0_QkWgMfiedM4vJG2QU8YG9qi2Tp-CgvC_nOoRRWSWDfLHvG5dxVHbs9LKkziyzvmGYNZnpXTzX7UIvaCvScykLVJKa92oX0AdPFj3ChYBbv4Vu08SiZAX4cUQZYKjwHViRe2jMT47GKFOHiR0yPwgdyro0qDZAmFDYxEVKILcdjdcs4kTBsFOhUA5Ba3_uy-i34G7PP6IcfWZZSFSSC0-kXYhkO286KKql8VjE7GEtXgXoDVQ19iQcu-facQWX9vG1igKfRu5dIjbRjJ86RzZqTOCjcKWz8JzYy4BsTfXtXAHF01wDCWYoAcVOsVKpeo6gvti2O7meGSNim2DLsmIMov9aOd1qPgbrUnTOUgjhcv04oM6n8KrBRvVK-iKttNDNQxA1qAD-kAa2XxmokXB3Ub5XkDqgKANvXTFgWNYq1JGdmoYw5HflQ6t1vkSy6PnOfvUkhdys7dG7LUZzCMpLmjI_a5LcdObidHYCvc1acp7u5zmIgYpOqighvfaFRm5H_G_TXA_90BW8NHNhjL5_nbLCChXbH94ObY' \
  -H 'sec-ch-ua: "Google Chrome";v="141", "Not?A_Brand";v="8", "Chromium";v="141"' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'sec-ch-ua-platform: "macOS"' \
  --data-raw '{
    "display_name": "createfs",
    "name": "afs-createfs",
    "resource_type": "storage.afs.v2.volume",
    "zone": "cn-sh-01a",
    "sku_id": "3e486bc1-5430-4dd5-aa79-a6c7029b91a2",
    "properties": {
        "resources": {
            "billing_items": {
                "capacity": 10,
                "capacity_unit": "GB"
            }
        },
        "storage_class": "EFFICIENT"
    },
    "order_info": {
        "billing_cycle_number": 1,
        "auto_renew": true,
        "currency_code": "CNY",
        "payment_channel": "PC_UNSPECIFIED",
        "note": "",
        "order_type": "OT_ORIGINAL",
        "start_time": "2025-12-10T14:34:10+08:00",
        "payment_model": "PM_PREPAID",
        "billing_model": "BM_MONTHLY"
    }
}
'

响应（Response）​

名称类型描述
idstring卷实例资源id.
namestring卷实例资源名称，需符合正则：^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$.
display_namestring卷实例资源别名.
descriptionstring卷实例资源描述.
uidstring卷实例资源uuid.
resource_typestring卷实例资源类型, 例子: storage.afs.v2.volume.
creator_idstring卷实例创建用户id.
owner_idstring卷实例所有者id.
tenant_idstring租户id.
zonestring可用区.
statestring卷实例状态.
sku_idstring最小库存单元id.
tagsobject卷实例资源标签.
propertiesobject卷实例规格属性.
order_infoobject订单信息.
deletedboolean卷实例资源是否删除.
create_timestring卷实例资源创建时间.
update_timestring卷实例资源更新时间.

响应示例（Response Example）​

{
  "id": "/subscriptions/076cf030-087d-4855-9833-4fac39707563/resourceGroups/default/zones/cn-sh-01a/virtualVolumes/afs-createfs",
  "name": "afs-createfs",
  "display_name": "createfs",
  "description": "",
  "uid": "019b06f7-a384-7df0-a8a7-ea9533430077",
  "resource_type": "storage.afs.v2.volume",
  "creator_id": "94d9b0fb-d284-4fed-b732-4a73d7a5b6bc",
  "owner_id": "94d9b0fb-d284-4fed-b732-4a73d7a5b6bc",
  "tenant_id": "076cf030-087d-4855-9833-4fac39707563",
  "zone": "cn-sh-01a",
  "state": "CREATING",
  "sku_id": "3e486bc1-5430-4dd5-aa79-a6c7029b91a2",
  "tags": {},
  "properties": {
    "resources": {
      "billing_items": {
        "capacity": 10,
        "capacity_unit": "GB"
      }
    },
    "storage_class": "EFFICIENT"
  },
  "order_info": {
    "billing_cycle_number": 1,
    "auto_renew": true,
    "currency_code": "CNY",
    "payment_channel": "PC_UNSPECIFIED",
    "note": "",
    "order_type": "OT_ORIGINAL",
    "order_id": "bca22260689806889967616",
    "start_time": "2025-12-10T06:34:10Z",
    "payment_model": "PM_PREPAID",
    "billing_model": "BM_MONTHLY",
    "original_id": "",
    "end_time": null,
    "auto_convert_postpaid": false
  },
  "deleted": false,
  "create_time": null,
  "update_time": null
}