创建块存储云盘资源
接口描述
POST /storage/abs/v1/subscriptions/{subscription_name}/resourceGroups/{resource_group_name}/zones/{zone}/disks/{disk_name}
请求头(Request Header)
请求参数(Request Parameters)
名称 | 类型 | 必须 | 位置 | 默认值 | 取值范围 | 描述 |
---|---|---|---|---|---|---|
subscription_name | string | 是 | path | - | - | 订阅标识 |
resource_group_name | string | 是 | path | - | - | 资源组标识 |
zone | string | 是 | path | - | - | 可用区 |
disk_name | string | 是 | path | - | ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$ | 块存储资源名称 |
请求体(Request Body)
参数名 | 类型 | 必须 | 默认值 | 取值范围 | 描述 |
---|---|---|---|---|---|
name | string | 否 | - | - | 资源名称(同disk_name) |
display_name | string | 是 | - | - | 资源别名 |
resource_type | string | 是 | storage.abs.v1.disk | - | 资源类型 |
zone | string | 否 | - | - | 可用区 |
sku_id | string | 是 | - | - | 云管sku_id |
properties | object | 是 | - | - | 资源属性 |
order_info | object | 是 | - | - | 订单信息 |
请求体中state
的值,自定义 State
类型,是enum类型,有以下不同含义值:
状态值 | 状态 | 含义 |
---|---|---|
0 | CREATING | 创建中(瞬时状态) |
1 | UPDATING | 更新中(瞬时状态) |
2 | ACTIVE | 正常 |
3 | DELETING | 删除中(瞬时状态) |
4 | DELETED | 已删除 |
5 | FAILED | 操作失败(不保存) |
6 | EXPIREDOWNGRADING | 到期降级进入宽限期中(瞬时状态) |
7 | EXPIREDOWNGRADED | 已降级宽限期 |
8 | RENEWUPGRADING | 宽限期续订恢复中(瞬时状态) |
9 | EXPIRESTOPPING | 到期停服进入保留期中(瞬时状态) |
10 | EXPIRESTOPPED | 已停服保留期 |
11 | RENEWSTARTING | 保留期续费恢复中(瞬时状态) |
12 | DOWNGRADING | 服务降级变更中(瞬时状态) |
13 | DOWNGRADE | 服务已经降级 |
14 | RESTORING | 服务降级恢复中(瞬时状态) |
15 | ATTACHING | 挂载中 |
16 | INUSE | 使用中 |
17 | DETACHING | 卸载中 |
18 | DETACHFAILED | 卸载失败 |
19 | ATTACHFAILED | 挂载失败 |
20 | DELETEDFAILED | 删除失败 |
21 | RESIZING | 扩容变更中(瞬时状态) |
22 | RESIZEFAILED | 扩容失败 |
23 | ARREARSTOPPING | 欠费停服变更中(瞬时状态) |
24 | ARREARSTOPPED | 已欠费停服 |
25 | RECHARGESTARTING | 充值恢复中(瞬时状态) |
26 | RESIZECANCELING | 取消扩容变更中(瞬时状态) |
请求体中,properties
的参数如下:
参数名 | 类型 | 必须 | 默认值 | 取值范围 | 描述 |
---|---|---|---|---|---|
resources | object | 是 | - | - | 资源规格属性 |
请求体中properties
内的resources
的参数如下:
参数名 | 类型 | 必须 | 默认值 | 取值范围 | 描述 |
---|---|---|---|---|---|
billing_items | object | 是 | - | - | 资源计费项 |
disk_type | DiskCategoryUnit | 是 | CLOUDSSD | - | 云盘类型 |
system_disk | bool | 否 | false | - | 是否为系统盘(false为数据盘) |
ecs_lifecycle | bool | 否 | false | - | 是否随ecs实例释放 |
snapshot_id | string | 否 | - | - | 根据指定的快照id进行盘的创建 |
image_id | string | 否 | - | - | 根据指定的镜像id进行盘的创建 |
以上disk_type
的值,自定义 DiskCategoryUnit
类型,是enum类型,有以下不同含义值:
类型值 | 类型 | 含义 |
---|---|---|
0 | CLOUDEFFICIENCY | 高效云盘 |
1 | CLOUDSSD | SSD 云盘 |
以上billing_items
的参数如下:
参数名 | 类型 | 必须 | 默认值 | 取值范围 | 描述 |
---|---|---|---|---|---|
capacity | number | 是 | 20 | - | 云盘资源容量大小 |
capacity_unit | CapacityUnit | 是 | GB | - | 容量单位 |
以上 CapacityUnit
为自定义的单位值,是enum类型,有以下不同含义值(注:块存储资源默认使用单位 GB
,其他单位值暂不使用):
单位值 | 单位 | 含义 |
---|---|---|
0 | EB | EB |
1 | PB | PB |
2 | TB | TB |
3 | GB | 千兆字节 |
4 | MB | 兆字节 |
请求体中,order_info
的参数如下:
参数名 | 类型 | 必须 | 默认值 | 取值范围 | 描述 |
---|---|---|---|---|---|
billing_cycle_number | number | 是 | 1 | - | 购买时长 |
auto_renew | bool | 否 | false | - | 自动续费 |
currency_code | string | 是 | CNY | - | 货币代码 |
payment_channel | PaymentChannel | 是 | PC_BALANCE | - | 支付方式 |
note | string | 否 | - | - | 订单备注 |
order_type | OrderType | 是 | OT_ORIGINAL | - | 订单类型 |
order_id | string | 是 | - | - | 订单id |
start_time | string | 是 | - | - | 订单生效日期 |
payment_model | PaymentModel | 是 | PM_PREPAID | - | 付费类型 |
billing_model | BillingModel | 是 | BM_MONTHLY | - | 计费类型 |
original_id | string | 否 | - | - | 合同包ID(专有云订单使用) |
end_time | string | 是 | - | - | 订单结束时间 |
auto_convert_postpaid | bool | 否 | - | - | 预付费自动转后付费 |
以上payment_channel
的值,自定义 PaymentChannel
类型,是enum类型,有以下不同含义值:
单位值 | 单位 | 含义 |
---|---|---|
0 | PC_UNSPECIFIED | 未指定 |
1 | PC_BALANCE | 余额支付 |
2 | PC_CREDIT | 信用支付 |
3 | PC_FROZENACCOUNT | 冻结款支付 |
4 | PC_REMIT_OFFLINE | 线下汇款 |
5 | PC_ALIPAY | 支付宝支付 |
6 | PC_UNIONPAY | 银联支付 |
7 | PC_REMIT_ONLINE | 在线转账 |
8 | PC_CONTRACT | 合同包支付 |
以上order_type
的值,自定义 OrderType
类型,是enum类型,有以下不同含义值:
单位值 | 单位 | 含义 |
---|---|---|
0 | OT_UNSPECIFIED | 未指定 |
1 | OT_ORIGINAL | 原始订单 |
2 | OT_RENEW | 续费订单 |
3 | OT_UPGRADED | 升配订单 |
4 | OT_DOWNGRADED | 降配订单 |
5 | OT_CONTRACT | 合同订单 |
6 | OT_UNSUBSCRIBE | 退订订单 |
7 | OT_RESIZE | 扩缩容订单 |
以上payment_model
的值,自定义 PaymentModel
类型,是enum类型,有以下不同含义值:
单位值 | 单位 | 含义 |
---|---|---|
0 | PM_UNSPECIFIED | 未指定 |
1 | PM_PREPAID | 预付费 |
2 | PM_POSTPAID | 后付费 |
以上billing_model
的值,自定义 BillingModel
类型,是enum类型,有以下不同含义值:
单位值 | 单位 | 含义 |
---|---|---|
0 | BM_UNSPECIFIED | 未指定 |
1 | BM_USAGE | 按量计费 |
2 | BM_MONTHLY | 包月 |
3 | BM_YEARLY | 包年 |
请求示例(Request Example)
curl --request POST 'https://management.sensecoreapi.dev/storage/abs/v1/subscriptions/e995c396-83f6-4a1b-a055-2acb8bc7cf1f/resourceGroups/default/zones/cn-sh-01e/disks/c6d8b27b-55b7-4ca3-992d-7f369e5076cb'\
-H 'authority: management.sensecoreapi.dev' \
-H 'accept: application/json' \
-H 'accept-language: zh-CN' \
-H 'authorization: xxxxx'\
-d '{
"display_name": "0830自测",
"resource_type": "storage.abs.v1.disk",
"zone": "cn-sh-01e",
"sku_id": "3583abdc-f096-4b82-a0ff-15a13a7b5c1c",
"properties": {
"resources": {
"billing_items": {
"capacity": 20,
"capacity_unit": "GB"
},
"disk_type": "CLOUDSSD"
}
},
"order_info": {
"billing_cycle_number": 1,
"auto_renew": false,
"currency_code": "CNY",
"payment_channel": "PC_UNSPECIFIED",
"note": "",
"order_type": "OT_ORIGINAL",
"start_time": "2024-08-30T11:37:09+08:00",
"payment_model": "PM_PREPAID",
"billing_model": "BM_MONTHLY"
}
}'
响应参数(Response Parameters)
名称 | 类型 | 描述 |
---|---|---|
display_name | string | 资源别名 |
uid | string | 资源实例UUID |
resource_type | string | 资源类型 |
zone | string | 可用区 |
sku_id | string | 云管sku_id |
properties | object | 资源属性 |
order_info | object | 订单信息 |
响应示例(Response Example)
{
"id": "/subscriptions/e995c396-83f6-4a1b-a055-2acb8bc7cf1f/resourceGroups/default/zones/cn-sh-01e/disks/c6d8b27b-55b7-4ca3-992d-7f369e5076cb",
"name": "c6d8b27b-55b7-4ca3-992d-7f369e5076cb",
"display_name": "0830自测",
"description": "",
"uid": "2330e95e-6681-11ef-9e0a-523e95af74a9",
"resource_type": "storage.abs.v1.disk",
"creator_id": "57463cd8-3ee9-4bf4-b139-8890fd26c914",
"owner_id": "57463cd8-3ee9-4bf4-b139-8890fd26c914",
"tenant_id": "e995c396-83f6-4a1b-a055-2acb8bc7cf1f",
"zone": "cn-sh-01e",
"state": "CREATING",
"sku_id": "3583abdc-f096-4b82-a0ff-15a13a7b5c1c",
"tags": {},
"properties": {
"resources": {
"billing_items": {
"capacity": 20,
"capacity_unit": "GB"
},
"disk_type": "CLOUDSSD",
"system_disk": false,
"ecs_lifecycle": false,
"snapshot_id": "",
"image_id": ""
}
},
"order_info": {
"billing_cycle_number": 1,
"auto_renew": false,
"currency_code": "CNY",
"payment_channel": "PC_UNSPECIFIED",
"note": "",
"order_type": "OT_ORIGINAL",
"order_id": "141c2091410124043829248",
"start_time": "2024-08-30T03:37:09Z",
"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
}