功能介紹
重裝彈性 云服務(wù)器 的操作系統(tǒng)。
本接口為異步接口，當(dāng)前重裝彈性云服務(wù)器操作系統(tǒng)請(qǐng)求下發(fā)成功后會(huì)返回job_id，此時(shí)重裝彈性云服務(wù)器操作系統(tǒng)并沒有立即完成，需要通過調(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 /v1/{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ù)雜度如下：
說明：
|
|
keyname |
否 |
String |
密鑰名稱。 |
|
userid |
否 |
String |
用戶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ù)類型 |
描述 |
|---|---|---|---|
|
__system__encrypted |
否 |
String |
metadata中的表示加密功能的字段，0代表不加密，1代表加密。 該字段不存在時(shí)，系統(tǒng)盤默認(rèn)為不加密。 |
|
__system__cmkid |
否 |
String |
用戶主密鑰ID，是metadata中的表示加密功能的字段，與__system__encrypted配合使用。 說明：
請(qǐng)參考查詢密鑰列表，通過HTTPS請(qǐng)求獲取密鑰ID。 |
響應(yīng)消息
請(qǐng)參考響應(yīng)（任務(wù)類）。
請(qǐng)求示例
重裝云服務(wù)器操作系統(tǒng)，重裝后采用密鑰方式登錄鑒權(quán)。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/reinstallos
{
"os-reinstall": {
"keyname": "KeyPair-350b",
"userid": "7e25b1da389f4697a79df3a0e5bd494e",
"metadata": {
"__system__encrypted": "1",
"__system__cmkid": "83cdb52d-9ebf-4469-9cfa-e7b5b80da846"
}
}
}
返回值
請(qǐng)參考通用請(qǐng)求返回值。
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
