為指定的輕量應(yīng)用服務(wù)器重置系統(tǒng)。
接口說(shuō)明
重置系統(tǒng)可以重新安裝服務(wù)器的應(yīng)用或者操作系統(tǒng)，達(dá)到重新初始化服務(wù)器的目的。重置系統(tǒng)有兩種選擇，重置當(dāng)前系統(tǒng)和重置為其他鏡像。
重置系統(tǒng)包括以下兩種方式：
-
重置當(dāng)前系統(tǒng)：不改變當(dāng)前鏡像，重新安裝操作系統(tǒng)。
-
重置為其他鏡像：選擇阿里云提供的其他鏡像或者您創(chuàng)建的自定義鏡像，重新安裝操作系統(tǒng)。
注意事項(xiàng)
-
重置系統(tǒng)或更換鏡像會(huì)清除輕量應(yīng)用服務(wù)器上的磁盤(pán)數(shù)據(jù)，請(qǐng)您根據(jù)需要做好數(shù)據(jù)備份。
-
重置系統(tǒng)或更換鏡像后，可能會(huì)導(dǎo)致監(jiān)控失效。如果監(jiān)控出現(xiàn)問(wèn)題，您可以手動(dòng)安裝云監(jiān)控插件。
-
遠(yuǎn)程連接服務(wù)器安裝：具體操作，請(qǐng)參見(jiàn)為阿里云主機(jī)手動(dòng)安裝插件。
-
使用命令助手安裝：具體操作，請(qǐng)參見(jiàn)使用命令助手，安裝云監(jiān)控的命令，您可以從使用命令助手文檔的常用命令中獲取。
-
使用限制
-
重置系統(tǒng)或更換鏡像前創(chuàng)建的快照會(huì)保留，但無(wú)法通過(guò)重置前創(chuàng)建的快照回滾磁盤(pán)。
-
含有數(shù)據(jù)盤(pán)數(shù)據(jù)的自定義鏡像創(chuàng)建的輕量應(yīng)用服務(wù)器，不支持重置系統(tǒng)。
-
選擇自定義鏡像重置系統(tǒng)時(shí)：
-
僅支持選擇與當(dāng)前服務(wù)器同一地域下的自定義鏡像。
-
不支持選擇當(dāng)前服務(wù)器對(duì)應(yīng)的自定義鏡像。如果您有恢復(fù)服務(wù)器數(shù)據(jù)的需求，可以使用當(dāng)前服務(wù)器對(duì)應(yīng)的快照回滾磁盤(pán)數(shù)據(jù)。
-
非中國(guó)內(nèi)地地域不支持 Windows Server 系統(tǒng)和 Linux 系統(tǒng)互相切換，即 Windows 系統(tǒng)的自定義鏡像無(wú)法重置 Linux 服務(wù)器；Linux 系統(tǒng)的自定義鏡像無(wú)法重置 Windows 服務(wù)器。僅支持 Windows Server 不同版本之間或 Linux 不同發(fā)行版本之間的更換。
-
云盤(pán)存在以下限制：
-
當(dāng)自定義鏡像中包含系統(tǒng)盤(pán)與數(shù)據(jù)盤(pán)，但待重置服務(wù)器中只掛載了系統(tǒng)盤(pán)，沒(méi)有掛載數(shù)據(jù)盤(pán)時(shí)，您無(wú)法使用該自定義鏡像重置系統(tǒng)。
-
當(dāng)自定義鏡像中包含的系統(tǒng)盤(pán)容量比待重置系統(tǒng)的服務(wù)器中系統(tǒng)盤(pán)容量大時(shí)，您無(wú)法直接使用該自定義鏡像重置系統(tǒng)。
-
當(dāng)服務(wù)器中系統(tǒng)盤(pán)容量大于等于自定義鏡像中系統(tǒng)盤(pán)容量時(shí)，即可使用該自定義鏡像重置系統(tǒng)。您可以為待重置系統(tǒng)的服務(wù)器升級(jí)配置，將服務(wù)器中系統(tǒng)盤(pán)容量升級(jí)。具體操作，請(qǐng)參見(jiàn)升級(jí)配置。
-
當(dāng)自定義鏡像中包含的數(shù)據(jù)盤(pán)容量比待重置系統(tǒng)的服務(wù)器中數(shù)據(jù)盤(pán)容量大時(shí)，您無(wú)法使用該自定義鏡像重置系統(tǒng)。
-
-
QPS 限制
本接口的單用戶 QPS 限制為 10 次/分鐘。超過(guò)限制，API 調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請(qǐng)合理調(diào)用。更多信息，請(qǐng)參見(jiàn) QPS 限制。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語(yǔ)句的Action元素中使用，用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問(wèn)級(jí)別：是指每個(gè)操作的訪問(wèn)級(jí)別，取值為寫(xiě)入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說(shuō)明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問(wèn)級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| swas-open:ResetSystem | update |
|
| 無(wú) |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 指定的輕量應(yīng)用服務(wù)器的實(shí)例 ID。 | ace0706b2ac4454d984295a94213**** |
| RegionId | string | 是 | 地域 ID。您可以調(diào)用 ListRegions 查詢可用地域。 | cn-hangzhou |
| ImageId | string | 否 | 目標(biāo)鏡像 ID。如果不輸入目標(biāo)鏡像 ID，默認(rèn)為重置當(dāng)前鏡像。 | 794c230fd3e64ea19f83f4d7a0ad**** |
| ClientToken | string | 否 | 保證請(qǐng)求冪等性。從您的客戶端生成一個(gè)參數(shù)值，確保不同請(qǐng)求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符，且不能超過(guò) 64 個(gè)字符。更多信息，請(qǐng)參見(jiàn)如何保證冪等性。 | 123e4567-e89b-12d3-a456-426655440000 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidImageId.NotSupport | The specified ImageId does not support the operation. | 指定的鏡像不支持當(dāng)前操作。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的實(shí)例不存在，請(qǐng)您檢查實(shí)例ID是否正確。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的鏡像不存在，請(qǐng)您檢查鏡像ID是否正確。 |
| 500 | InternalError | An error occurred while processing your request. | 內(nèi)部錯(cuò)誤，請(qǐng)重試。如果多次嘗試失敗，請(qǐng)?zhí)峤还巍?/span> |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-09-18 | OpenAPI 描述信息更新、OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |