创建卷实例

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

请求头（Request Header）

参考认证（authentication）

请求参数（Request Parameters

名称	类型	必须	位置	默认值	取值范围	描述
subscription_name	string	是	path	-	-	订阅名称.
resource_group_name	string	是	path	-	-	资源组.
zone	string	是	path	-	-	可用区.
virtual_volume_name	string	是	path	-	-	卷实例名.

请求体（Request Body）

名称	类型	必须	默认值	取值范围	描述
id	string	是	-	-	卷实例资源id.
name	string	是	-	-	卷实例资源名称，需符合正则：`^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
display_name	string	否	-	-	卷实例资源别名.
description	string	否	-	-	卷实例资源描述.
uid	string	是	-	-	卷实例资源uuid.
resource_type	string	是	-	-	卷实例资源类型, 例子: storage.afs.v2.volume.
creator_id	string	否	-	-	卷实例创建用户id.
owner_id	string	否	-	-	卷实例所有者id.
tenant_id	string	否	-	-	租户id.
zone	string	否	-	-	可用区.
state	string	否	-	-	卷实例状态.
sku_id	string	是	-	-	最小库存单元id.
tags	object	否	-	-	卷实例资源标签.
properties	object	否	-	-	卷实例规格属性.
order_info	object	否	-	-	订单信息.
deleted	boolean	否	-	-	卷实例资源是否删除.
create_time	string	否	-	-	卷实例资源创建时间.
update_time	string	否	-	-	卷实例资源更新时间.

其中，state有如下情况

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

其中，properties的参数如下

名称	类型	必须	默认值	取值范围	描述
resources	object	否	-	-	规格属性.

其中，resources的参数如下

名称	类型	必须	默认值	取值范围	描述
billing_items	string	否	-	-	计费项.

其中，billing_items的参数如下

名称	类型	必须	默认值	取值范围	描述
capacity	string	否	-	-	资源容量.
capacity_unit	string	否	-	-	资源容量单位.

其中，order_info的参数如下

名称	类型	必须	默认值	取值范围	描述
billing_cycle_number	integer	否	-	-	购买时长.
auto_renew	boolean	否	-	-	自动续费.
currency_code	string	否	-	-	货币代码.
payment_channel	string	否	-	-	支付方式.
note	string	否	-	-	订单备注.
order_type	string	否	-	-	订单类型.
order_id	string	否	-	-	订单id.
start_time	string	否	-	-	订单生效日期.
payment_model	string	否	-	-	付费类型.
billing_model	string	否	-	-	计费类型.
original_id	string	否	-	-	合同包ID.
end_time	string	否	-	-	订单结束时间.

其中，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 --location 'https://management.sensecoreapi.tech/storage/afs/v2/subscriptions/c28f173a-8f18-474c-866b-4ce89a612958/resourceGroups/default/zones/cn-sh-01a/virtualVolumes/ee5abdd5-8739-45fe-99db-ced1c727912e' \
  -H 'authority: management.sensecoreapi.tech' \
  -H 'sec-ch-ua: " Not;A Brand";v="99", "Google Chrome";v="97", "Chromium";v="97"' \
  -H 'accept-language: zh-CN' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6InB1YmxpYzpoeWRyYS5qd3QuYWNjZXNzLXRva2VuIiwidHlwIjoiSldUIn0.eyJhdWQiOltdLCJjbGllbnRfaWQiOiI0ZTQxNDg1NC03MjAwLTUwOWYtYjk2MC1mOGIwZGJiYmYzMzEiLCJleHAiOjE2OTUzNzc5MTgsImV4dCI6eyJpc19kZWRpY2F0ZWRfdGVuYW50IjpmYWxzZSwicHJwX2xpc3QiOlsiY24tc2gtMDFhLXBycDAxIiwiY24tc2gtMDFiLXBycDAxIl0sInRlbmFudF9jZXJ0aWZ5X3N0YXR1cyI6dHJ1ZSwidGVuYW50X2NlcnRpZnlfdHlwZSI6ImVudGVycHJpc2UiLCJ0ZW5hbnRfY29kZSI6ImNvZGUxMDEwIiwidGVuYW50X2lkIjoiYzI4ZjE3M2EtOGYxOC00NzRjLTg2NmItNGNlODlhNjEyOTU4IiwidXNlcl9pZCI6ImE1MWIzNDk1LTNiYTEtNGFkZC1iNzYwLTNkMjU3ZTI5OWYzNyIsInVzZXJfdHlwZSI6ImFkbWluIiwidXNlcm5hbWUiOiJyb290MTAxMCJ9LCJpYXQiOjE2OTUzNjcxMTgsImlzcyI6Imh0dHBzOi8vc2lnbmluLnNlbnNlY29yZS50ZWNoLyIsImp0aSI6ImU2NzRkNDVhLWZhYTEtNDc2Zi04MDU0LTBlYzMwMDU4ZGFhMSIsIm5iZiI6MTY5NTM2NzExOCwic2NwIjpbIm9wZW5pZCIsIm9mZmxpbmUiLCJvZmZsaW5lX2FjY2VzcyJdLCJzdWIiOiJyb290MTAxMDpjMjhmMTczYS04ZjE4LTQ3NGMtODY2Yi00Y2U4OWE2MTI5NTg6YTUxYjM0OTUtM2JhMS00YWRkLWI3NjAtM2QyNTdlMjk5ZjM3In0.qEdvVKcoBaeLPIXmqBLwhT77dVfXOAGi2BTVMAVCPngM6Y1zPY669KN8CEVxOAADMkFitoQMbri5S0hqGWC9pMdqYhldHhkqsWj6BEtP7eiySuOblJhJirX5C-dEtzu--FrfofuGFCbe6JahaevFab2mClb-CixsfSOCCVkoSj8erGdIVe8Fs9d22vtrAr9hzut4KWh_FLvPmKReOlZhBbcwvXuYZBkjB7PmIXTvr8LxnieBThTOwV87PJWMMtF8U2S3AZDWp-uSJRmNwe2v4Yif5r0bIsvLbia9-HCRt4h6bMWYgeGuy7GiDi0I4mU6KnomL84IgIEZE378ZvX65AziOUjmdlJzcbHwjmzxT4Mlx1zFAx2ixTHflQx3zfCVjQll5C26wFHQVFX6KhOkGLyf5kYqbI6ozGew7md8Bp2ysDuBscnkTjPBifUd6_HRdzze3YLvybNBIZEUjzZblgevIOS-Dq5ZxJ9yicpo-Ys45qHYhGN80YIcH_-Ye-yOouJkUvXXdtx-4Uwu5Zg483Hxm0frEc-YO93SNWLMbKxjKfzY1RMS14k_T6kaAQE4ei5p5WQU4ktPIcTTWxi9wenpoIqR1JKZWsSuFniuUBir1U2e4LNhhCKVQRvdQEGqa__3rwTXEvIv77KFQgY-vEl7xFXVPe_9mD3tbK0tvoc' \
  -H 'content-type: application/json' \
  -H 'accept: application/json' \
  -H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/97.0.4692.99 Safari/537.36' \
  -H 'sec-ch-ua-platform: "macOS"' \
  -H 'origin: https://console.sensecore.tech' \
  -H 'sec-fetch-site: cross-site' \
  -H 'sec-fetch-mode: cors' \
  -H 'sec-fetch-dest: empty' \
  -H 'referer: https://console.sensecore.tech/' \
  --data-raw '{
      "display_name": "test_create",
      "resource_type": "storage.afs.v2.volume",
      "zone": "cn-sh-01a",
      "sku_id": "de6c091b-4841-4602-b120-623ee620c8be",
      "properties": {
        "resources": {
          "billing_items": {
            "capacity": 10,
            "capacity_unit": "GB"
          }
        }
      },
      "order_info": {
        "billing_cycle_number": 1,
        "auto_renew": true,
        "currency_code": "CNY",
        "payment_channel": "PC_UNSPECIFIED",
        "note": "",
        "order_type": "OT_ORIGINAL",
        "start_time": "2023-09-22T16:43:57+08:00",
        "payment_model": "PM_PREPAID",
        "billing_model": "BM_MONTHLY"
      }
    }'  --compressed

响应（Response）

名称	类型	描述
id	string	卷实例资源id.
name	string	卷实例资源名称，需符合正则：`^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
display_name	string	卷实例资源别名.
description	string	卷实例资源描述.
uid	string	卷实例资源uuid.
resource_type	string	卷实例资源类型, 例子: storage.afs.v2.volume.
creator_id	string	卷实例创建用户id.
owner_id	string	卷实例所有者id.
tenant_id	string	租户id.
zone	string	可用区.
state	string	卷实例状态.
sku_id	string	最小库存单元id.
tags	object	卷实例资源标签.
properties	object	卷实例规格属性.
order_info	object	订单信息.
deleted	boolean	卷实例资源是否删除.
create_time	string	卷实例资源创建时间.
update_time	string	卷实例资源更新时间.

其中，state有如下情况

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

其中，properties的参数如下

名称	类型	描述
resources	object	规格属性.

其中，resources的参数如下

名称	类型	必须	默认值	取值范围	描述
billing_items	string	否	-	-	计费项.

其中，billing_items的参数如下

名称	类型	必须	默认值	取值范围	描述
capacity	string	否	-	-	资源容量.
capacity_unit	string	否	-	-	资源容量单位.

其中，order_info的参数如下

名称	类型	描述
billing_cycle_number	integer	购买时长.
auto_renew	boolean	自动续费.
currency_code	string	货币代码.
payment_channel	string	支付方式.
note	string	订单备注.
order_type	string	订单类型.
order_id	string	订单id.
start_time	string	订单生效日期.
payment_model	string	付费类型.
billing_model	string	计费类型.
original_id	string	合同包ID.
end_time	string	订单结束时间.

其中，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	包年

响应示例（Response Example）

{
  "id": "/subscriptions/c28f173a-8f18-474c-866b-4ce89a612958/resourceGroups/default/zones/cn-sh-01a/virtualVolumes/ee5abdd5-8739-45fe-99db-ced1c727912e",
  "name": "ee5abdd5-8739-45fe-99db-ced1c727912e",
  "display_name": "test_create",
  "description": "",
  "uid": "2b9b33e9-5924-11ee-9a29-3afbe6a6e3ae",
  "resource_type": "storage.afs.v2.volume",
  "creator_id": "a51b3495-3ba1-4add-b760-3d257e299f37",
  "owner_id": "a51b3495-3ba1-4add-b760-3d257e299f37",
  "tenant_id": "c28f173a-8f18-474c-866b-4ce89a612958",
  "zone": "cn-sh-01a",
  "state": "CREATING",
  "sku_id": "de6c091b-4841-4602-b120-623ee620c8be",
  "tags": {

  },
  "properties": {
    "resources": {
      "billing_items": {
        "capacity": 10,
        "capacity_unit": "GB"
      }
    }
  },
  "order_info": {
    "billing_cycle_number": 1,
    "auto_renew": true,
    "currency_code": "CNY",
    "payment_channel": "PC_UNSPECIFIED",
    "note": "",
    "order_type": "OT_ORIGINAL",
    "order_id": "37be1967188294676930560",
    "start_time": "2023-09-22T08:43:57Z",
    "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
}

创建卷实例

请求头（Request Header）​

请求参数（Request Parameters​

请求体（Request Body）​

请求示例（Request Example）​

响应（Response）​

响应示例（Response Example）​