功能介紹
重裝 裸金屬服務(wù)器 的操作系統(tǒng)?？焖侔l(fā)放裸金屬服務(wù)器支持裸金屬服務(wù)器數(shù)據(jù)盤不變的情況下，使用原 鏡像 重裝系統(tǒng)盤。重裝操作系統(tǒng)支持密碼或者密鑰注入。
確定裸金屬服務(wù)器是否為快速發(fā)放，請(qǐng)參考查詢規(guī)格詳情和規(guī)格擴(kuò)展信息列表API。
重裝操作系統(tǒng)屬于異步API，接口調(diào)用成功只表示請(qǐng)求下發(fā)成功，任務(wù)執(zhí)行結(jié)果請(qǐng)通過查詢Job狀態(tài)API獲取。
約束
- 使用私有鏡像創(chuàng)建的裸金屬服務(wù)器，請(qǐng)確保已經(jīng)安裝了Cloud-init（Linux鏡像）或Cloudbase-init（Windows鏡像）。如使用未安裝Cloud-init或Cloudbase-init的鏡像，該接口不能注入密鑰或密碼。公共鏡像默認(rèn)已安裝Cloud-init或Cloudbase-init。
- 執(zhí)行重裝操作系統(tǒng)任務(wù)時(shí)，請(qǐng)勿并行執(zhí)行其他任務(wù)，否則可能會(huì)引起重裝操作系統(tǒng)失敗。
- 關(guān)機(jī)狀態(tài)或者重裝操作系統(tǒng)失敗的裸金屬服務(wù)器，才能執(zhí)行重裝操作。
- 目前Windows鏡像不支持注入密碼，Linux鏡像的user_data為加密后的密碼。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/baremetalservers/{server_id}/reinstallos
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方式請(qǐng)參見獲取項(xiàng)目ID。 |
|
server_id |
是 |
裸金屬服務(wù)器ID。 可以從裸金屬服務(wù)器控制臺(tái)查詢，或者通過調(diào)用查詢裸金屬服務(wù)器列表（OpenStack原生）API獲取。 |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
adminpass |
否 |
String |
裸金屬服務(wù)器管理員帳號(hào)的初始登錄密碼。 其中，Linux管理員帳戶為root，Windows管理員帳戶為Administrator。 建議密碼復(fù)雜度如下：
說明：
|
|
keyname |
否 |
String |
密鑰名稱。 密鑰可以通過創(chuàng)建和導(dǎo)入SSH密鑰（OpenStack原生）API創(chuàng)建，或者使用查詢SSH密鑰列表（OpenStack原生）API查詢已有的密鑰。 |
|
userid |
否 |
String |
用戶ID（登錄管理控制臺(tái)，進(jìn)入我的憑證，即可看到“用戶ID”）。 |
|
metadata |
否 |
Object |
請(qǐng)求示例
POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/reinstallos
|
{ "os-reinstall": { "keyname": "KeyPair-350b", "userid": "7e25b1da389f4697a79df3a0e5bd494e", "metadata": { "user_data": " |
響應(yīng)參數(shù)
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
job_id |
String |
提交任務(wù)成功后返回的任務(wù)ID，用戶可以使用該ID對(duì)任務(wù)執(zhí)行情況進(jìn)行查詢。 如何根據(jù)job_id來查詢Job的執(zhí)行狀態(tài)，請(qǐng)參考查詢Job狀態(tài)。 |
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
error |
字典數(shù)據(jù)結(jié)構(gòu) |
提交任務(wù)異常時(shí)返回的異常信息，詳情請(qǐng)參見表1 error數(shù)據(jù)結(jié)構(gòu)。 |
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
message |
String |
任務(wù)異常錯(cuò)誤信息描述。 |
|
code |
String |
任務(wù)異常錯(cuò)誤信息編碼。 |
響應(yīng)示例
- 正常響應(yīng)
{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
