硅云帮助文档中心
搜索文档
热门搜索词:
产品简介
产品定价
入门指南
经典案例
快照
常见问题
知识拓展
名词解释
API参考
创建实例,此接口会自动从用户余额中扣除创建实例所需的费用,这里创建的磁盘是不随服务器续费的磁盘,可以挂载到服务器实例上,需要创建随服务器实例续费的磁盘,请使用服务器实例扩容接口
/ncs-server/api/v1/disk/create
POST
| 字段 | 类型 | 最大长度 | 参数位置 | 默认必填 | 描述 |
| areaMark | string | 32 | RequestBody | 地区标识 | |
| hostId | string | 32 | RequestBody | 挂载到的服务器id,目前只能挂载到指定的服务器 | |
| productId | string | 32 | RequestBody | 磁盘规格Id | |
| diskSize | int | 10 | RequestBody | 磁盘大小 | |
| month | int | 10 | RequestBody | 购买月份数,一年传12 | |
| idempotent | string | 64 | RequestBody | 选填 | 幂等Id,防止创建成功但超时的情况,当传递相同的idempotent时,无论调用多少次,只会创建成功一次 |
POST /ncs-server/api/v1/disk/create HTTP/1.1
Content-Type: application/json
request_id: 2942183558593ffc9d75fb8e16793ff
api_key: 1706006863049654272
signature: d669a4fc8d7d227465907d2d4e6887e42e7f42618bc5a76283468fd14344597d
Content-Type: application/json
{
"areaMark": "test",
"productId": "standard_cloud_disk",
"hostId": "cvm-3hdk8be2b2225",
"diskSize": 15,
"month": 1,
"idempotent": "321"
}data返回磁盘实例,实际以真实返回结果为准
{
"status": 2000,
"message": "success",
"data": {
"userAccount": "z8z87878",
"productId": "standard_cloud_disk",
"productName": "高效云盘",
"latestOrderId": "1706473244957868033",
"areaMark": "test",
"areaName": "测试环境",
"diskSize": 15,
"beginTime": 1589277056852,
"endTime": 1591955456852,
"status": "OPENING",
"remoteDiskStatus": "creating",
"attacheHostId": "cvm-3hdk8be2b2225",
"refundStatus": "NONE",
"configuration": "",
"createTime": 1589277056853,
"updateTime": 1589277056853,
"id": "disk-3hdnwe228s223"
}
}实例数据结构:
| 字段 | 类型 | 描述 |
| id | string | 磁盘实例id |
| userAccount | string | 用户名 |
| attacheHostId | string | 挂载的实例,是否是挂载状态根据remoteDiskStatus判断,有可能无 |
| status | string | 实例状态 |
| remoteDiskStatus | string | 实例运行状态 |
| bindHostId | string | 绑定续费的服务器实例Id,不存在时为null |
| isBootable | boolean | 是否为启动盘,true是 |
| attacheAs | string | data为挂载为数据盘,boot为挂载为系统盘,从没挂载过为null |
| endTime | long | 到期时间时间戳,精确到毫秒 |
| createTime | long | 创建时间时间戳,精确到毫秒 |
您对该文档有什么建议?
本文导航