重新初始化雲端碟到建立時的初始狀態。

描述

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

  • 雲端碟的狀態必須為 使用中（In_use），且掛載的 ECS 執行個體的狀態必須為 已停止 （Stopped）。

  • 執行個體初次開機前，不能重新初始化掛載在其上的雲端碟。

  • 對於系統盤，初始化到鏡像的最初狀態。若建立雲端碟的源鏡像被刪除，則無法初始化。

  • 對於直接建立的資料盤，初始化到空盤狀態。

  • 對於通過快照建立的資料盤，初始化到快照狀態。若源快照已被刪除，則無法初始化並返回錯誤。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：ReInitDisk。
DiskId String 是 指定的雲端碟 ID。
SecurityEnhancementStrategy String 否 當指定的雲端碟為系統盤時，您可以設定是否開啟安全加固，載入Elastic Compute Service 安全性群組件雲盾等。取值範圍：
  • Active：啟用安全加固，免費安裝雲盾。該值僅支援公共鏡像。
  • Deactive：不啟用安全加固，卸載雲盾等安全性群組件。該值支援所有鏡像。

返回參數

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

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=ReInitDisk
&DiskId=d-23jbf2v5m
&<公共請求參數>
返回樣本

XML 格式

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

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category 400 指定雲端碟的磁碟類型不支援該操作。
DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet. 403 指定的雲端碟正在建立快照，請稍後再試。
IncorrectDiskStatus The current disk status does not support this operation. 403 雲端碟狀態必須為 使用中（In_use）。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 雲端碟掛載的 ECS 執行個體的狀態必須為 已停止（Stopped）。
InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 403 雲端碟掛載的 ECS 執行個體已欠費停機。
InstanceLockedForSecurity The instance is locked due to security. 403 雲端碟掛載的 ECS 執行個體已被 安全控制。
InvalidSnapshot.TooOld The disk is created from a snapshotId made before 2013-07-15, it cannot be re-initiated the specified disk any more since the detached first time. 403 指定雲端碟的源快照建立於 2013 年 7 月 15 日及其之前，不能初始化。
InvalidSourceSnapshot The snapshot which is used to create the specified disk has been deleted. 403 指定雲端碟的源快照已被刪除，無法初始化。
OperationDenied The snapshot which is used to create the specified disk has been deleted. 403 指定雲端碟的源快照已被刪除，無法初始化。
SharedImageDeleted The specified image by others shared is deleted. 403 建立指定雲端碟的共用鏡像已被刪除，無法初始化。
InvalidDiskId.NotFound The specified disk does not exist. 404 指定的雲端碟不存在。