接口说明
本接口用于批量修改云主机密码
-
最多支持10台云主机修改密码
-
password参数：采用RSA对明文加密，公钥内容详见接口说明，用户可用该公钥自行加密明文得到密文。明文8-16位字符，同时包括数字、大小写字母和特殊字符，其中不能出现3个及以上连续或重复的数字，如123、111等以及特殊字符最多不能超过3个，且需要在“~ @ # $ % * _ - + = , . ? [ ] { }”范围内。不建议使用包含姓名、电话、出生日期、账号名、系统名以及公司名的密码;不建议使用包含连续的字母、键位或重复的字母、字符的密码，比如abc、asd、@#$、AAA、###等。
-
公钥内容： -----BEGIN PUBLIC KEY----- MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC/VpRysi0bPRLS7sbgQDJHo1MAt9/bK +nwK5Pe3z0/O4cH5I/8kFNYy4yFsLMM+zyFvVw9C4wzjHaRcmEuF3ziJMC9PD5ufUWgfO 5nSGgZW1cmgjqnhcWJ3i+Azj72RnhKQRCn9DgJduEC9MiKfbyTICGd6FXf9cxb21nkxI7vtwIDAQAB -----END PUBLIC KEY-----
URL
PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/batch/password
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
serverBatchUpdatePasswordReq
|
ServerBatchUpdatePasswordReq
|
是
|
批量改密请求体。 |
|
password
|
string
|
是
|
云主机密码（采用RSA对明文加密，公钥内容详见接口说明，用户可用该公钥自行加密明文得到密文。明文8-16位字符，同时包括数字、大小写字母和特殊字符，其中不能出现3个及以上连续或重复的数字，如123、111等，以及特殊字符最多不能超过3个，且需要在“~ @ # $ % * _ - + = , . ? [ ] { }”范围内。（password和keypairName仅能填写一个 ）不建议使用包含姓名、电话、出生日期、账号名、系统名以及公司名的密码;不建议使用包含连续的字母、键位或重复的字母、字符的密码，比如abc、asd、@#$、AAA、###等。 |
|
serverIds
|
<string> array
|
是
|
主机ID数组，可通过主机列表详情接口获取。 |
请求示例
PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/batch/password{
"serverIds":[
"000037f9-2bda-420f-b0e9-bf5514a5762d",
"00014ed8-7e91-42c3-8b6d-8878720431a9"
],
"password":"srzE9jsTwO044EAhipn2gS1fZ9W/5Boi3fb0JME1j3gdFSKZ9u5pPCifzb/9mXQdpnasy/JKV70h5m7fSnLYtF33CMw0n9kqONNlIELUBurfoI9Wtyf0eKFmnDAxqV8UO4T2/BdO1WeF4Um9d9fyBe1OqFCczl15Jfaj9/GI9c="
}返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
ServerBatchActionResp
|
请求成功时返回的数据 |
|
serverBatchResult
|
<ActionResult> array
|
云主机批量操作结果集 |
|
result
|
boolean
|
操作是否下发成功 |
|
serverId
|
string
|
云主机id |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码;返回正常：OK,返回错误：ERROR,返回异常：EXCEPTION,需要告警实现的：ALARM,禁止访问：FORBIDDEN |
返回示例
{
"body":{
"serverBatchResult":[
{
"serverId":"000037f9-2bda-420f-b0e9-bf5514a5762d",
"result":true
},
{
"serverId":"00014ed8-7e91-42c3-8b6d-8878720431a9",
"result":true
}
]
},
"requestId":"req-Id-bb15dfdf-f7eb-4303-895a-cfffb13269d5",
"state":"OK"
}