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

 

功能介紹

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

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

  • 如果您需要查詢訂單的資源開通詳情，請參考"查詢訂單的資源開通詳情"。

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

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

接口約束

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

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

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

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

調(diào)試

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

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

是

String

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

volume_id

是

String

云硬盤ID。

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

是

String

用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值）。
表3 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

bssParam

否

BssParamForResizeVolume object

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

os-extend

是

OsExtend object

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

參數(shù)

是否必選

參數(shù)類型

描述

isAutoPay

否

String

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

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

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

缺省值：false

枚舉值：

  • false

  • true
表5 OsExtend

參數(shù)

是否必選

參數(shù)類型

描述

new_size

是

Integer

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

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

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

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

狀態(tài)碼： 202

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

參數(shù)

參數(shù)類型

描述

job_id

String

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

order_id

String

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

狀態(tài)碼： 400

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

參數(shù)

參數(shù)類型

描述

code

String

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

message

String

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

請求示例

擴(kuò)容云硬盤，擴(kuò)容后的云硬盤大小為100GiB，立即支付擴(kuò)容費(fèi)用，且從帳戶余額中自動扣費(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

錯誤碼

請參見錯誤碼。

 

擴(kuò)容云硬盤ResizeVolume

意見反饋

0/200

提交 取消

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