創建云硬盤v3
更新時間 2025-08-26 16:07:53
最近更新時間: 2025-08-26 16:07:53
分享文章
接口功能介紹
- 云硬盤功能請聯系客戶經理開通。
接口約束
無
URI
POST /v3/cloudVolume/create
路徑參數
無
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 資源池ID。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
請求參數
請求頭header參數
無
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| volumeName | 是 | String | 云硬盤名稱 | ||
| diskType | 是 | String | 云硬盤類型（uhio-超高IO;hio-高IO;cio-普通IO） | ||
| count | 是 | Integer | 數量，范圍：[1, 50] | ||
| volumeSize | 是 | Integer | 云硬盤大小（單位：GB），大于等于10 | ||
| encryption | 是 | Boolean | 是否加密，true表示為加密，false表示為不加密 | ||
| desktopOid | 否 | String | 云電腦ID，當使用立即掛載功能時，此字段必傳，創建出來的云硬盤會立即掛載到該云電腦上 | ||
| mountPath | 否 | String | 掛載目錄，當使用立即掛載功能且指定的計算增強型云電腦操作系統為Linux時，若此字段不為空，則創建出來的云硬盤會立即掛載到該云電腦的掛載目錄上 | ||
| vpcOid | 是 | String | VPC ID | ||
| resourcePackOid | 是 | String | 資源包ID |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 狀態碼。可能值： - 800：請求成功。 - 900：請求失敗。 |
800 | |
| error | String | 錯誤碼。 | ECPC_1000 | |
| message | String | 提示信息。 | OK. | |
| returnObj | Object | 返回數據對象 | returnObj |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| operations | Array of Objects | 創建云硬盤操作列表。可用于查詢操作狀態和新建云硬盤ID（相關接口：異步操作-查詢操作詳情）。 | operations |
表 operations
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| operationId | String | 操作ID。 |
枚舉參數
無
請求示例
請求url
無
請求頭header
無
請求體body
{
"volumeName":"cvtest",
"diskType":"uhio",
"count":1,
"volumeSize":40,
"encryption":false,
"vpcOid":"xxxxxxxxxxx",
"resourcePackOid":"xxxxxxxxxx"
}
響應示例
{
"statusCode":800,
"message":"OK.",
"returnObj":{
"operations":[{
"operationId":"job_orderabc7211cb74fbb283e4280kf87"
}]
}
}
狀態碼
請參考
錯誤碼
請參考
