功能介紹
重裝彈性 云服務(wù)器 的操作系統(tǒng)。支持彈性云服務(wù)器數(shù)據(jù)盤不變的情況下，使用原 鏡像 重裝系統(tǒng)盤。
本接口為異步接口，當(dāng)前重裝彈性云服務(wù)器操作系統(tǒng)請(qǐng)求下發(fā)成功后會(huì)返回job_id，此時(shí)重裝彈性云服務(wù)器操作系統(tǒng)并沒有立即完成，需要通過(guò)調(diào)用查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢job狀態(tài)，當(dāng)Job狀態(tài)為 SUC CES S 時(shí)代表云服務(wù)器操作系統(tǒng)重裝成功。
調(diào)用該接口后，系統(tǒng)將卸載系統(tǒng)盤，然后使用原鏡像重新創(chuàng)建系統(tǒng)盤，并掛載至彈性云服務(wù)器，實(shí)現(xiàn)重裝操作系統(tǒng)功能。
接口約束
- 該接口僅支持安裝Cloud-init或Cloudbase-init的鏡像。如果鏡像未安裝Cloud-init或者Cloudbase-init，請(qǐng)使用 重裝彈性云服務(wù)器操作系統(tǒng)（未安裝Cloud-init）接口。
- 不包含系統(tǒng)盤的彈性云服務(wù)器不能執(zhí)行重裝操作。
- 執(zhí)行重裝操作系統(tǒng)任務(wù)時(shí)，請(qǐng)勿并行執(zhí)行其他任務(wù)，否則可能會(huì)引起重裝操作系統(tǒng)失敗。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v2/{project_id}/cloudservers/{server_id}/reinstallos
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請(qǐng)參見獲取項(xiàng)目ID。 |
|
server_id |
是 |
彈性云服務(wù)器ID。 |
請(qǐng)求消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
adminpass |
否 |
String |
云服務(wù)器管理員帳戶的初始登錄密碼。 其中，Windows管理員帳戶的用戶名為Administrator，Linux管理員賬戶的用戶名為root。 建議密碼復(fù)雜度如下：
說(shuō)明：
|
|
keyname |
否 |
String |
密鑰名稱。 密鑰可以通過(guò)密鑰創(chuàng)建接口進(jìn)行創(chuàng)建（請(qǐng)參見創(chuàng)建和導(dǎo)入SSH密鑰），或使用SSH密鑰查詢接口查詢已有的密鑰（請(qǐng)參見查詢SSH密鑰列表 ）。 |
|
userid |
否 |
String |
用戶ID。 查看用戶ID方法：
|
|
metadata |
否 |
Object |
重裝云服務(wù)器的元數(shù)據(jù)。 |
|
mode |
否 |
String |
取值為withStopServer ，支持開機(jī)狀態(tài)下重裝彈性云服務(wù)器。 mode取值為withStopServer時(shí)，對(duì)開機(jī)狀態(tài)的 彈性云服務(wù)器執(zhí)行重裝操作，系統(tǒng)自動(dòng)對(duì)云服務(wù)器先執(zhí)行關(guān)機(jī)，再重裝操作系統(tǒng)。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
user_data |
否 |
String |
創(chuàng)建云服務(wù)器過(guò)程中待注入實(shí)例自定義數(shù)據(jù)。支持注入文本、文本文件。 說(shuō)明：
了解更多實(shí)例自定義數(shù)據(jù)注入請(qǐng)參考用戶數(shù)據(jù)注入。 示例： base64編碼前：
base64編碼后：
|
|
__system__encrypted |
否 |
String |
metadata中的表示加密功能的字段，0代表不加密，1代表加密。 該字段不存在時(shí)，系統(tǒng)盤默認(rèn)為不加密。 |
|
__system__cmkid |
否 |
String |
用戶主密鑰ID，是metadata中的表示加密功能的字段，與__system__encrypted配合使用。 說(shuō)明：
請(qǐng)參考查詢密鑰列表，通過(guò)HTTPS請(qǐng)求獲取密鑰ID。 |
響應(yīng)參數(shù)
請(qǐng)參考響應(yīng)（任務(wù)類）。
請(qǐng)求示例
- 重裝云服務(wù)器操作系統(tǒng)，重裝后采用密碼方式登錄鑒權(quán)。
POST https://{endpoint}/v2/{project_id}/cloudservers/{server_id}/reinstallos { "os-reinstall": { "adminpass": "!QAZxsw2", "userid": "7e25b1da389f4697a79df3a0e5bd494e", "mode": "withStopServer" } }
- 重裝云服務(wù)器操作系統(tǒng)，重裝后采用密鑰方式登錄鑒權(quán)。
POST https://{endpoint}/v2/{project_id}/cloudservers/{server_id}/reinstallos { "os-reinstall": { "keyname": "KeyPair-350b", "userid": "7e25b1da389f4697a79df3a0e5bd494e" } }
返回值
請(qǐng)參考通用請(qǐng)求返回值。
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
