接口说明
本接口用于更新云主机的密码。
说明:
- 如果实例已绑定密钥对,重置密码后系统将可以通过新密码进行登录。
- 如果Windows实例默认管理员账号administrator被修改,则重置密码将会失败。
- 实例系统初始化完成后才可修改密码,否则修改密码可能会报错。
- 云主机密码(采用RSA对明文加密,公钥内容详见接口说明,用户可用该公钥自行加密明文得到密文。明文8-16位字符,同时包括数字、大小写字母和特殊字符,其中不能出现3个及以上连续或重复的数字,如123、111等,以及特殊字符最多不能超过3个,且需要在“~ @ # $ % * _ - + = , . ? [ ] { }”范围内。(password和keypairName仅能填写一个 )不建议使用包含姓名、电话、出生日期、账号名、系统名以及公司名的密码;不建议使用包含连续的字母、键位或重复的字母、字符的密码,比如abc、asd、@#$、AAA、###等。)
- 公钥内容:
-----BEGIN PUBLIC KEY----- MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC/VpRysi0bPRLS7sbgQDJHo1MAt9/bK+nwK5Pe3z0/O4cH5I/8kFNYy4yFsLMM+zyFvVw9C4wzjHaRcmEuF3ziJMC9PD5ufUWgfO5nSGgZW1cmgjqnhcWJ3i+Azj72RnhKQRCn9DgJduEC9MiKfbyTICGd6FXf9cxb21nkxI7vtwIDAQAB -----END PUBLIC KEY-----
URL
PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/password
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
serverUpdatePasswordReq
|
云主机更新密码请求体
|
是
|
更新云主机密码请求体。 |
|
password
|
string
|
是
|
云主机密码(采用RSA对明文加密,公钥内容详见接口说明,用户可用该公钥自行加密明文得到密文。明文8-16位字符,同时包括数字、大小写字母和特殊字符,其中不能出现3个及以上连续或重复的数字,如123、111等,以及特殊字符最多不能超过3个,且需要在“~ @ # $ % * _ - + = , . ? [ ] { }”范围内。(password和keypairName仅能填写一个 )不建议使用包含姓名、电话、出生日期、账号名、系统名以及公司名的密码;不建议使用包含连续的字母、键位或重复的字母、字符的密码,比如abc、asd、@#$、AAA、###等)。 |
|
serverId
|
string
|
是
|
云主机ID,可通过主机列表详情接口获取。 |
请求示例
PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/password
{
"password":"V5HjWQds4NRVzIaLDyS7ch1HT2jizU5QVPsyc9ORmvY9H3m79ekX1wMjVOr09AQVBa5CjH4yoivU1uQrgLZ3X6JRP55YvWGWLtVp4RXMHla6GHVlbzdbVqQnHloNEuPjaQ+dxTXjeUfPnCeu+JlnAc3fkEwJHJu7qnGVfg7lnP0=",
"serverId":"00014ed8-7e91-42c3-8b6d-8878720431a9"
}
返回参数
返回码:200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
object
|
请求成功时返回的数据 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN |
返回示例
返回码:200
OK
{
"requestId":"reqId-b1f0de6b38344fbeb51df-5ea5c198-9",
"state":"OK",
"body":null
}