擴容一塊資料盤。

描述

調用該介面時，您需要注意：

  • 該介面暫時僅支援擴容資料盤，不支援擴容系統盤。

  • 僅支援擴容磁碟類型為普通雲端碟（Cloud）、高效雲端碟（Cloud_efficiency）和 SSD 雲端碟（Cloud_ssd）的資料盤。

  • 當磁碟正在建立快照時，不允許擴容。

  • 對於已掛載的資料盤：

    • 磁碟掛載的執行個體的狀態必須為 運行中（Running）或者 已停止（Stopped）。

    • 擴容後，您需要在控制台 重啟執行個體 或者調用 API RebootInstance 使操作生效。

  • 擴容時，不會修改磁碟分割和檔案系統，您需要在擴容後自行分配儲存空間。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：ResizeDisk
DiskId String 是 磁碟 ID。
NewSize Integer 是 希望擴容到的磁碟容量大小。單位為 GB。取值範圍：
  • 普通雲端碟（Cloud）：[5, 2000]
  • 高效雲端碟（Cloud_efficiency）:[5, 2000]
  • SSD 雲端碟（Cloud_ssd）：[5, 2000]
指定的新磁碟容量必須比原磁碟容量大。且 2 TB 以下的磁碟不能擴容到 2 TB 以上。
ClientToken String 否 用於保證請求的等冪性。由用戶端生成該參數值，要保證在不同請求間唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多詳情，請參閱 如何保證等冪性。

返回參數

全是公共返回參數。參閱 公共參數

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=ResizeDisk
&DiskId=xxx
&NewSize=1024
&<公共請求參數>
返回樣本

XML 格式

<ResizeDiskResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ResizeDiskResponse>
JSON 格式 
{
    "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet. 403 指定的磁碟正在建立快照，請稍後再試。
DiskError IncorrectDiskStatus 403 磁碟狀態異常。
DiskInArrears The specified operation is denied as your disk owing fee. 403 指定磁碟已經欠費。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 磁碟掛載的執行個體的狀態必須為 運行中（Running）或者 已停止（Stopped）。
InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 403 指定磁碟掛載的執行個體已過期。
InvalidDiskSize.TooLarge Specified new disk size is beyond the permitted range. 403 指定的新磁碟大小超出取值範圍。
InvalidDiskSize.TooSmall Specified new disk size is less than the original disk size. 403 指定的新磁碟容量必須比原磁碟容量大。
OperationDenied The status of the disk or the instance that the disk is attaching with does not support the operation. 403 僅支援擴容資料盤。或者磁碟掛載的執行個體的狀態必須為 運行中（Running）或者 已停止（Stopped）。
OperationDenied The type of the disk does not support the operation. 403 僅支援擴容普通雲端碟、高效雲端碟和 SSD 雲端碟。
InvalidDiskId.NotFound The specified disk does not exist. 404 指定的磁碟不存在。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 ECS 執行個體不存在。