更換一台 ECS 執行個體的系統盤或者作業系統。

描述

調用該介面時,您需要注意:

  • 您不能更換系統盤的磁碟類型。

  • 換系統盤不能修改磁碟的類型和付費方式,但是會改變系統盤的磁碟 ID,原磁碟會被釋放。

  • 執行個體的狀態必須為 已停止Stopped)狀態。如果您的專有網路 VPC 類型執行個體開啟了 VPC 內執行個體停機不收費功能後,為防止地域內 ECS 執行個體資源不足而引起更換系統盤後無法重啟執行個體,您需要在停止執行個體時關閉停機不收費功能。更多詳情,請參閱 StopInstance

  • 安全控制 的 ECS 執行個體的 OperationLocks 不能標記為 "LockReason" : "security"

  • 執行個體不能為欠費狀態。

  • 您可以通過參數 SystemDisk.Size 重新指定系統盤的容量大小,SystemDisk.Size 的值必須大於等於 max{20, 當前系統盤容量}。超過 max{20, 更換前的系統盤容量} 的磁碟容量部分,將收取額外費用。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:ReplaceSystemDisk
InstanceId String 指定執行個體的 ID。
ImageId String 重設系統時使用的鏡像 ID。
Password String 執行個體的密碼。
  • 長度為 [8, 30] 位字元,必須同時包含三類不同的字元(大、小寫字母,數字和特殊符號)。
  • 支援以下特殊字元:( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /
如果傳入 Password 參數,請務必使用 HTTPS 協議調用 API,避免密碼泄露。
PasswordInherit Boolean 是否使用鏡像預設的密碼。使用該參數時,Password參數必須為空,同時您需要確保使用的鏡像已經設定了密碼。
KeyPairName String 金鑰組名稱。
  • Windows ECS 執行個體,忽略該參數。預設為空。即使填寫了該參數,仍舊只執行 Password 的內容。
  • Linux ECS 執行個體的密碼登入方式會被初始化成禁止。
SystemDisk.Size Integer 新的系統盤容量,單位為 GB。取值範圍:[Max{20, 參數ImageId對應的鏡像大小}, 500]

預設值:Max{40, 參數ImageId對應的鏡像大小}

ClientToken String 用於保證請求的等冪性。由用戶端生成該參數值,要保證在不同請求間唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多詳情,請參閱 如何保證等冪性
SecurityEnhancementStrategy String 當指定的雲端碟為系統盤時,您可以設定是否開啟安全加固,載入Elastic Compute Service 安全性群組件雲盾等。取值範圍:
  • Active:啟用安全加固,免費安裝雲盾。該值僅支援公共鏡像。
  • DeactiveDeactive:不啟用安全加固,卸載雲盾等安全性群組件。該值支援所有鏡像。

返回參數

名稱 類型 描述
DiskId String 新系統盤的磁碟 ID

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=ReplaceSystemDisk
&InstanceId=i-23jggx34b
&ImageId=m-myimage11
&<公共請求參數>
返回樣本

XML 格式

<ReplaceSystemDiskResponse>
    <DiskId>d-23jbf2v5m</DiskId>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReplaceSystemDiskResponse>
JSON 格式
{
    "RequestId":"337568C5-64F3-4B76-8CDD-D3D8C57B5B8C",
    "DiskId":"d-j6cam2z21u4ks3dj6flb"
}

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidParameter.Conflict The specified image does not support the specified instance type. 400 指定的鏡像不支援建立這一類規格的執行個體。
InvalidPassword.Malformed The specified parameter “Password” is not valid. 400 指定的 Password 格式不合法。
InvalidPasswordParam.Mismatch The input password should be null when passwdInherit is true. 400 指定了 PasswdInherit後,您不能指定 Password 參數。
InvalidSystemDiskSize The specified parameter SystemDisk.Size is invalid. 400 指定的參數 SystemDisk.Size 不合法。
InvalidSystemDiskSize.ImageNotSupportResize The specified image does not support resize. 400 指定的鏡像不支援磁碟擴容。
InvalidSystemDiskSize.ValueNotSupported The specified parameter SystemDisk.Size is invalid. 400 指定的參數 SystemDisk.Size 不合法。
OperationDenied The specified image contains the snapshot of the data disk,does not support this operation. 400 包含資料盤快照的鏡像不能進行更換系統盤操作。
ChargeTypeViolation The operation is not permitted due to charge type of the instance. 403 指定執行個體的付費方式不支援更換系統盤。
DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet. 403 指定的磁碟正在建立快照。
ImageNotSubscribed The specified image has not be subscribed. 403 指定的鏡像未在鏡像市場訂閱。
ImageNotSupportInstanceType The specified image don not support the InstanceType instance. 403 指定鏡像不支援該執行個體類型。
ImageRemovedInMarket The specified market image is not available, Or the specified user defined image includes product code because it is based on an image subscribed from marketplace, and that image in marketplace includeing exact the same product code has been removed. 403 指定的鏡像已經從鏡像市場中下架。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 指定的執行個體狀態不正確。
INST_HAS_UNPAID_ORDER The instance has unpaid order. 403 該執行個體有未支付的訂單。
InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 403 指定的執行個體已欠費。
InstanceLockedForSecurity The instance is locked due to security. 403 指定的執行個體被安全鎖定。
IoOptimized.NotSupported The specified image is not support IoOptimized Instance. 403 鏡像必須支援 I/O 優化執行個體。
QuotaExceed.BuyImage The specified image is from the image market,You have not bought it or your quota has been exceeded. 403 指定鏡像來自鏡像市場,您需要先購買再使用,或者您的鏡像個數已超出最大限制。
InvalidImageId.NotFound The specified ImageId does not exist. 404 指定的鏡像不存在。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的執行個體不存在。
InvalidSystemDiskSize.LessThanImageSize The specified parameter SystemDisk.Size is less than the image size. 404 指定的參數 SystemDisk.Size 小於參數 ImageId 對應的鏡像大小。
InvalidSystemDiskSize.LessThanMinSize The specified parameter SystemDisk.Size is less than the min size. 404 指定的參數 SystemDisk.Size 不能小於 40 GB。
InvalidSystemDiskSize.MoreThanMaxSize The specified SystemDisk.Size parameter exceeds the maximum size. 404 指定的參數 SystemDisk.Size 不能大於 500 GB。
NoSuchResource The specified resource is not found. 404 指定資源不存在。
OperationDenied Internal Error. 500 內部錯誤,請稍後再試。