硅云幫助文檔中心
搜索文檔
熱門搜索詞:
產(chǎn)品簡介
產(chǎn)品定價
入門指南
經(jīng)典案例
快照
常見問題
知識拓展
名詞解釋
API參考
產(chǎn)品規(guī)格相關(guān)接口
服務器實例相關(guān)接口
安全組相關(guān)接口
磁盤相關(guān)接口
創(chuàng)建實例,此接口會自動從用戶余額中扣除創(chuàng)建實例所需的費用,這里創(chuàng)建的磁盤是不隨服務器續(xù)費的磁盤,可以掛載到服務器實例上,需要創(chuàng)建隨服務器實例續(xù)費的磁盤,請使用服務器實例擴容接口
/ncs-server/api/v1/disk/create
POST
字段 | 類型 | 最大長度 | 參數(shù)位置 | 默認必填 | 描述 |
areaMark | string | 32 | RequestBody | 地區(qū)標識 | |
hostId | string | 32 | RequestBody | 掛載到的服務器id,目前只能掛載到指定的服務器 | |
productId | string | 32 | RequestBody | 磁盤規(guī)格Id | |
diskSize | int | 10 | RequestBody | 磁盤大小 | |
month | int | 10 | RequestBody | 購買月份數(shù),一年傳12 | |
idempotent | string | 64 | RequestBody | 選填 | 冪等Id,防止創(chuàng)建成功但超時的情況,當傳遞相同的idempotent時,無論調(diào)用多少次,只會創(chuàng)建成功一次 |
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返回磁盤實例,實際以真實返回結(jié)果為準
{ "status": 2000, "message": "success", "data": { "userAccount": "z8z87878", "productId": "standard_cloud_disk", "productName": "高效云盤", "latestOrderId": "1706473244957868033", "areaMark": "test", "areaName": "測試環(huán)境", "diskSize": 15, "beginTime": 1589277056852, "endTime": 1591955456852, "status": "OPENING", "remoteDiskStatus": "creating", "attacheHostId": "cvm-3hdk8be2b2225", "refundStatus": "NONE", "configuration": "", "createTime": 1589277056853, "updateTime": 1589277056853, "id": "disk-3hdnwe228s223" } }
實例數(shù)據(jù)結(jié)構(gòu):
字段 | 類型 | 描述 |
id | string | 磁盤實例id |
userAccount | string | 用戶名 |
attacheHostId | string | 掛載的實例,是否是掛載狀態(tài)根據(jù)remoteDiskStatus判斷,有可能無 |
status | string | 實例狀態(tài) |
remoteDiskStatus | string | 實例運行狀態(tài) |
bindHostId | string | 綁定續(xù)費的服務器實例Id,不存在時為null |
isBootable | boolean | 是否為啟動盤,true是 |
attacheAs | string | data為掛載為數(shù)據(jù)盤,boot為掛載為系統(tǒng)盤,從沒掛載過為null |
endTime | long | 到期時間時間戳,精確到毫秒 |
createTime | long | 創(chuàng)建時間時間戳,精確到毫秒 |
您對該文檔有什么建議?
本文導航