為指定的Simple Application Server重設系統。
介面說明
重設系統可以重新安裝伺服器的應用或者作業系統,達到重新初始化伺服器的目的。重設系統有兩種選擇,重設當前系統和重設為其他鏡像。
重設系統包括以下兩種方式:
-
重設當前系統:不改變當前鏡像,重新安裝作業系統。
-
重設為其他鏡像:選擇阿里雲提供的其他鏡像或者您建立的自訂鏡像,重新安裝作業系統。
注意事項
-
重設系統或更換鏡像會清除Simple Application Server上的磁碟資料,請您根據需要做好資料備份。
-
重設系統或更換鏡像後,可能會導致監控失效。如果監控出現問題,您可以手動安裝CloudMonitor外掛程式。
-
遠端連線伺服器安裝:具體操作,請參見為阿里雲主機手動安裝外掛程式。
-
使用命令助手安裝:具體操作,請參見使用命令助手,安裝CloudMonitor的命令,您可以從使用命令助手文檔的常用命令中擷取。
-
使用限制
-
重設系統或更換鏡像前建立的快照會保留,但無法通過重設前建立的快照復原磁碟。
-
含有資料盤資料的自訂鏡像建立的Simple Application Server,不支援重設系統。
-
選擇自訂鏡像重設系統時:
-
僅支援選擇與當前伺服器同一地區下的自訂鏡像。
-
不支援選擇當前伺服器對應的自訂鏡像。如果您有恢複伺服器資料的需求,可以使用當前伺服器對應的快照復原磁碟資料。
-
非中國內地地區不支援 Windows Server 系統和 Linux 系統互相切換,即 Windows 系統的自訂鏡像無法重設 Linux 伺服器;Linux 系統的自訂鏡像無法重設 Windows 伺服器。僅支援 Windows Server 不同版本之間或 Linux 不同發行版本之間的更換。
-
雲端硬碟存在以下限制:
-
當自訂鏡像中包含系統硬碟與資料盤,但待重設伺服器中只掛載了系統硬碟,沒有掛載資料盤時,您無法使用該自訂鏡像重設系統。
-
當自訂鏡像中包含的系統硬碟容量比待重設系統的伺服器中系統硬碟容量大時,您無法直接使用該自訂鏡像重設系統。
-
當伺服器中系統硬碟容量大於等於自訂鏡像中系統硬碟容量時,即可使用該自訂鏡像重設系統。您可以為待重設系統的伺服器升級配置,將伺服器中系統硬碟容量升級。具體操作,請參見升級配置。
-
當自訂鏡像中包含的資料盤容量比待重設系統的伺服器中資料盤容量大時,您無法使用該自訂鏡像重設系統。
-
-
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
swas-open:ResetSystem |
update |
*Instance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| InstanceId |
string |
是 |
指定的Simple Application Server的執行個體 ID。 |
ace0706b2ac4454d984295a94213**** |
| RegionId |
string |
是 |
地區 ID。您可以調用 ListRegions 查詢可用地區。 |
cn-hangzhou |
| ImageId |
string |
否 |
目標鏡像 ID。如果不輸入目標鏡像 ID,預設為重設當前鏡像。 |
794c230fd3e64ea19f83f4d7a0ad**** |
| ClientToken |
string |
否 |
保證請求等冪性。從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元,且不能超過 64 個字元。更多資訊,請參見如何保證等冪性。 |
123e4567-e89b-12d3-a456-426655440000 |
| LoginCredentials |
object |
否 |
登入憑證資訊。 |
|
| Password |
string |
否 |
輸入Simple Application Server管理員帳號對應的密碼。
|
*** |
| KeyPairName |
string |
否 |
金鑰組名稱。僅 Linux 伺服器支援設定金鑰組。 |
aliyunkey |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
20758A-585D-4A41-A9B2-28DA8F4F534F |
樣本
正常返回樣本
JSON格式
{
"RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidImageId.NotSupport | The specified ImageId does not support the operation. | 指定的鏡像不支援當前操作。 |
| 500 | InternalError | An error occurred while processing your request. | 內部錯誤,請重試。如果多次嘗試失敗,請提交工單。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的執行個體不存在,請您檢查執行個體ID是否正確。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的鏡像不存在,請您檢查鏡像ID是否正確。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。