硅云帮助文档中心
搜索文档
热门搜索词:
产品简介
产品定价
入门指南
经典案例
快照
常见问题
知识拓展
名词解释
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 | 创建时间时间戳,精确到毫秒 |
您对该文档有什么建议?
本文导航