華為云計(jì)算 云知識(shí) 批量重置彈性云服務(wù)器密碼BatchResetServersPassword
批量重置彈性云服務(wù)器密碼BatchResetServersPassword

 

功能介紹

批量重置彈性 云服務(wù)器 管理帳號(hào)(root用戶或Administrator用戶)的密碼。

接口約束

  • 使用此API,需預(yù)先安裝重置密碼插件。一鍵式重置密碼插件的下載與安裝,請參見《彈性云服務(wù)器用戶指南》的“安裝一鍵式重置密碼插件”章節(jié)。
  • 彈性云服務(wù)器的重置密碼請求下發(fā)后,腳本執(zhí)行失敗,該API不會(huì)報(bào)錯(cuò)。
  • 彈性云服務(wù)器開機(jī)或重啟后,新密碼生效。
  • 該接口支持虛擬機(jī)狀態(tài)為開機(jī)或者關(guān)機(jī)狀態(tài)下執(zhí)行。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

PUT /v1/{project_id}/cloudservers/os-reset-passwords

參數(shù)說明請參見表1。

表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

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

請求消息

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

表2 請求參數(shù)

參數(shù)

參數(shù)類型

是否必選

描述

new_password

String

新密碼。

當(dāng)dry_run字段為true時(shí),該字段為非必填字段,否則為必填字段。

新密碼的校驗(yàn)規(guī)則:
  • 長度為8-26位。
  • 密碼至少必須包含大寫字母(A-Z)、小寫字母(a-z)、數(shù)字(0-9)和特殊字符(!@%-_=+[]:./?)中的三種。
  • 密碼不能包含用戶名或用戶名的逆序。
  • Windows系統(tǒng)密碼不能包含用戶名或用戶名的逆序,不能包含用戶名中超過兩個(gè)連續(xù)字符的部分。

dry_run

Boolean

是否只預(yù)檢此次請求。

  • true:發(fā)送檢查請求,不會(huì)重置密碼。檢查項(xiàng)包括是否填寫了必需參數(shù)、請求格式、業(yè)務(wù)限制。如果檢查不通過,則返回對應(yīng)錯(cuò)誤。如果檢查通過,則返回響應(yīng)結(jié)果。
  • false:發(fā)送正常請求,通過檢查后并且進(jìn)行重置密碼請求。

默認(rèn)值:false

servers

Array of objects

待批量重置密碼的彈性云服務(wù)器ID信息,詳情參見 表3。

表3 servers字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

是否必選

描述

id

String

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

響應(yīng)消息

響應(yīng)參數(shù)請參見 響應(yīng)(批量操作類) 所示。

請求示例

批量重置ID為“1bd0eb17-4466-4c15-a9ce-87727ad311b5”和“fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2”的云服務(wù)器的密碼為“YNbUwp!dUc9MClnv”(此密碼僅為示例,請勿復(fù)制使用該示例密碼)。

PUT https://{endpoint}/v1/{project_id}/cloudservers/os-reset-passwords

{
    "new_password": "YNbUwp!dUc9MClnv",
    "dry_run": true,
    "servers": [
                {
                  "id":"1bd0eb17-4466-4c15-a9ce-87727ad311b5"  
                },
                {
                  "id":"fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2" 
                }
               ]
}

響應(yīng)示例

響應(yīng)示例請參見響應(yīng)(批量操作類)所示。

{      
    "response": [                   
                  {                     
                    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"                      
                   },                   
                  {                     
                    "id": "516fb98f-46ca-475e-917e-2563e5a8cd12"                      
                   }                
                 ] 
}

返回值

請參考通用請求返回值。

錯(cuò)誤碼

請參考錯(cuò)誤碼。