中国站

产品

硅云帮助文档中心

搜索文档

热门搜索词:

创建磁盘实例

更新时间:2020-07-14 14:52  版本:v1.2
分享到:
我要反馈 
收藏 我的收藏

简要描述:


    创建实例,此接口会自动从用户余额中扣除创建实例所需的费用,这里创建的磁盘是不随服务器续费的磁盘,可以挂载到服务器实例上,需要创建随服务器实例续费的磁盘,请使用服务器实例扩容接口


请求url:


/ncs-server/api/v1/disk/create


请求方式:


POST


请求参数:


字段
类型最大长度参数位置默认必填
描述
areaMark
string32RequestBody
地区标识
hostIdstring32RequestBody
挂载到的服务器id,目前只能挂载到指定的服务器
productIdstring32RequestBody
磁盘规格Id
diskSizeint10RequestBody
磁盘大小
month
int10RequestBody
购买月份数,一年传12
idempotentstring64RequestBody选填幂等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"
    }
}


实例数据结构:


字段类型
描述
idstring磁盘实例id
userAccount
string用户名
attacheHostId
string挂载的实例,是否是挂载状态根据remoteDiskStatus判断,有可能无
status
string实例状态
remoteDiskStatusstring实例运行状态
bindHostIdstring绑定续费的服务器实例Id,不存在时为null
isBootableboolean是否为启动盘,true是
attacheAsstringdata为挂载为数据盘,boot为挂载为系统盘,从没挂载过为null
endTimelong到期时间时间戳,精确到毫秒
createTimelong创建时间时间戳,精确到毫秒










您对该文档有什么建议?

您对该文档的评分:

本文导航

搜索文档