華為云計(jì)算 云知識(shí) 重裝彈性云服務(wù)器操作系統(tǒng)(未安裝Cloud init)ReinstallServerWithCloudInit
重裝彈性云服務(wù)器操作系統(tǒng)(未安裝Cloud init)ReinstallServerWithCloudInit
時(shí)間: 2023-07-24 11:05:51
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

功能介紹

重裝彈性 云服務(wù)器 的操作系統(tǒng)。

本接口為異步接口，當(dāng)前重裝彈性云服務(wù)器操作系統(tǒng)請(qǐng)求下發(fā)成功后會(huì)返回job_id，此時(shí)重裝彈性云服務(wù)器操作系統(tǒng)并沒(méi)有立即完成，需要通過(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)盤(pán)，然后使用原 鏡像 重新創(chuàng)建系統(tǒng)盤(pán)，并掛載至彈性云服務(wù)器，實(shí)現(xiàn)重裝操作系統(tǒng)功能。

該接口支持未安裝Cloud-init或Cloudbase-init的鏡像，如果鏡像安裝了Cloud-init或者Cloudbase-init，請(qǐng)使用 重裝彈性云服務(wù)器操作系統(tǒng)（安裝Cloud-init）接口。

接口約束

  • 不包含系統(tǒng)盤(pán)的彈性云服務(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ù)說(shuō)明請(qǐng)參見(jiàn)表1。
表1 參數(shù)說(shuō)明

參數(shù)

是否必選

描述

project_id

是

項(xiàng)目ID。

獲取方法請(qǐng)參見(jiàn)獲取項(xiàng)目ID。

server_id

是

彈性云服務(wù)器ID。

請(qǐng)求消息

請(qǐng)求參數(shù)如表2所示。
表2 請(qǐng)求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

os-reinstall

是

Object

重裝彈性云服務(wù)器，詳情參見(jiàn)表3。
表3 os-reinstall字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

是否必選

參數(shù)類型

描述

adminpass

否

String

云服務(wù)器管理員帳戶的初始登錄密碼。

其中，Windows管理員帳戶的用戶名為Administrator，Linux管理員賬戶的用戶名為root。

建議密碼復(fù)雜度如下：

  • 長(zhǎng)度為8-26位。
  • 密碼至少必須包含大寫(xiě)字母、小寫(xiě)字母、數(shù)字和特殊字符（!@$%^-_=+[{}]:,./?~#*）中的三種。
說(shuō)明：
  • 對(duì)于Windows彈性云服務(wù)器，僅支持密碼方式，且密碼不能包含用戶名或用戶名的逆序，不能包含用戶名中超過(guò)兩個(gè)連續(xù)字符的部分。
  • adminpass和keyname不能同時(shí)為空。
  • adminpass和keyname不能同時(shí)有值。

keyname

否

String

密鑰名稱。

userid

否

String

用戶ID。

metadata

否

Object

重裝云服務(wù)器的元數(shù)據(jù)。

更多信息，請(qǐng)參見(jiàn)表4。

mode

否

String

取值為withStopServer ，支持開(kāi)機(jī)狀態(tài)下重裝彈性云服務(wù)器。

mode取值為withStopServer時(shí)，對(duì)開(kāi)機(jī)狀態(tài)的

彈性云服務(wù)器執(zhí)行重裝操作，系統(tǒng)自動(dòng)對(duì)云服務(wù)器先執(zhí)行關(guān)機(jī)，再重裝操作系統(tǒng)。
表4 metadata字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

是否必選

參數(shù)類型

描述

__system__encrypted

否

String

metadata中的表示加密功能的字段，0代表不加密，1代表加密。

該字段不存在時(shí)，系統(tǒng)盤(pán)默認(rèn)為不加密。

__system__cmkid

否

String

用戶主密鑰ID，是metadata中的表示加密功能的字段，與__system__encrypted配合使用。

說(shuō)明：

請(qǐng)參考查詢密鑰列表，通過(guò)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"
        }
    }
}

響應(yīng)示例

請(qǐng)參考響應(yīng)（任務(wù)類）。

{      
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" 
}

返回值

請(qǐng)參考通用請(qǐng)求返回值。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。

 

重裝彈性云服務(wù)器操作系統(tǒng)(未安裝Cloud init)ReinstallServerWithCloudInit

意見(jiàn)反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失敗！請(qǐng)稍后重試！