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