華為云計(jì)算 云知識(shí) 擴(kuò)容云硬盤(pán)ResizeVolume
擴(kuò)容云硬盤(pán)ResizeVolume
時(shí)間: 2023-08-22 10:43:59
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

功能介紹

對(duì)按需或者包周期 云硬盤(pán) 進(jìn)行擴(kuò)容。 在擴(kuò)容包周期云硬盤(pán)的場(chǎng)景下：

  • 如果您需要查看訂單可用的優(yōu)惠券，請(qǐng)參考"查詢(xún)訂單可用優(yōu)惠券"。

  • 如果您需要查詢(xún)訂單的資源開(kāi)通詳情，請(qǐng)參考"查詢(xún)訂單的資源開(kāi)通詳情"。

  • 如果您需要退訂該包周期資源，請(qǐng)參考“退訂包周期資源”。

  • 擴(kuò)容接口采用異步通知的方式實(shí)現(xiàn)。擴(kuò)容完成時(shí)，不會(huì)修改云盤(pán)分區(qū)和文件系統(tǒng)，您需要在擴(kuò)容后自行分配存儲(chǔ)空間。

接口約束

  • 擴(kuò)容狀態(tài)為available的云硬盤(pán)時(shí)，沒(méi)有約束限制。

  • 擴(kuò)容狀態(tài)為in-use的云硬盤(pán)時(shí)，有以下約束：

    • 不支持共享云硬盤(pán)，即multiattach參數(shù)值必須為false。

    • 云硬盤(pán)所掛載的 云服務(wù)器 狀態(tài)必須為ACTIVE、PAUSED、SUSPENDED、SHUTOFF才支持?jǐn)U容。

調(diào)試

您可以在API Explorer中調(diào)試該接口，支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。

URI

POST /v2.1/{project_id}/cloudvolumes/{volume_id}/action

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

project_id

是

String

項(xiàng)目ID。獲取方法請(qǐng)參見(jiàn)"獲取項(xiàng)目ID"。

volume_id

是

String

云硬盤(pán)ID。

請(qǐng)求參數(shù)

表2 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

X-Auth-Token

是

String

用戶(hù)Token。 通過(guò)調(diào)用 IAM 服務(wù)獲取用戶(hù)Token接口獲取（響應(yīng)消息頭中X-Subject-Token的值）。
表3 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

bssParam

否

BssParamForResizeVolume object

按需和包周期的擴(kuò)展參數(shù)。

os-extend

是

OsExtend object

標(biāo)記擴(kuò)容云硬盤(pán)操作。
表4 BssParamForResizeVolume

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

isAutoPay

否

String

功能說(shuō)明：是否立即支付。該參數(shù)只有在云硬盤(pán)為包周期的情況下有意義。默認(rèn)值為false 取值范圍：

  • true：立即支付，從帳戶(hù)余額中自動(dòng)扣費(fèi)

  • false：不立即支付，創(chuàng)建訂單暫不支付

缺省值：false

枚舉值：

  • false

  • true
表5 OsExtend

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

new_size

是

Integer

擴(kuò)容后的云硬盤(pán)大小，單位為GiB。擴(kuò)容的大小必須大于原有云硬盤(pán)容量且小于云硬盤(pán)最大容量。 云硬盤(pán)最大容量：

  • 數(shù)據(jù)盤(pán)：32768GiB

  • 系統(tǒng)盤(pán)：1024GiB

響應(yīng)參數(shù)

狀態(tài)碼： 202

表6 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

job_id

String

任務(wù)ID，云硬盤(pán)為按需計(jì)費(fèi)時(shí)返回該參數(shù)。> > > 如果需要查詢(xún)job的狀態(tài)，請(qǐng)參考："查詢(xún)job的狀態(tài)"。

order_id

String

訂單ID，云硬盤(pán)為包周期計(jì)費(fèi)時(shí)返回該參數(shù)。> > > - 如果您需要支付訂單，請(qǐng)參考：。

狀態(tài)碼： 400

表7 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

出現(xiàn)錯(cuò)誤時(shí)，返回的錯(cuò)誤信息，具體請(qǐng)參見(jiàn) error參數(shù)說(shuō)明。
表8 Error

參數(shù)

參數(shù)類(lèi)型

描述

code

String

出現(xiàn)錯(cuò)誤時(shí)，返回的錯(cuò)誤碼。錯(cuò)誤碼和其對(duì)應(yīng)的含義請(qǐng)參考錯(cuò)誤碼說(shuō)明。

message

String

出現(xiàn)錯(cuò)誤時(shí)，返回的錯(cuò)誤消息。

請(qǐng)求示例

擴(kuò)容云硬盤(pán)，擴(kuò)容后的云硬盤(pán)大小為100GiB，立即支付擴(kuò)容費(fèi)用，且從帳戶(hù)余額中自動(dòng)扣費(fèi)。

POST https://{endpoint}/v2.1/{project_id}/cloudvolumes/{volume_id}/action

{
  "os-extend" : {
    "new_size" : 100
  },
  "bssParam" : {
    "isAutoPay" : "true"
  }
}

響應(yīng)示例

狀態(tài)碼： 202

Accepted

  • 示例 1

    {
  "job_id" : "70a599e0-31e7-49b7-b260-868f441e862b"
}

  • 示例 2

    {
  "order_id" : "CS1711152257C60TL"
}

狀態(tài)碼： 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

狀態(tài)碼

狀態(tài)碼

描述

202

Accepted

400

Bad Request

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼。

 

擴(kuò)容云硬盤(pán)ResizeVolume

意見(jiàn)反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失??！請(qǐng)稍后重試！