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