更新云主机密码

接口说明

本接口用于更新云主机的密码。
说明:

  1. 如果实例已绑定密钥对,重置密码后系统将可以通过新密码进行登录。
  2. 如果Windows实例默认管理员账号administrator被修改,则重置密码将会失败。
  3. 实例系统初始化完成后才可修改密码,否则修改密码可能会报错。
  4. 云主机密码(采用RSA对明文加密,公钥内容详见接口说明,用户可用该公钥自行加密明文得到密文。明文8-16位字符,同时包括数字、大小写字母和特殊字符,其中不能出现3个及以上连续或重复的数字,如123、111等,以及特殊字符最多不能超过3个,且需要在“~ @ # $ % * _ - + = , . ? [ ] { }”范围内。(password和keypairName仅能填写一个 )不建议使用包含姓名、电话、出生日期、账号名、系统名以及公司名的密码;不建议使用包含连续的字母、键位或重复的字母、字符的密码,比如abc、asd、@#$、AAA、###等。)
  5. 公钥内容:
    -----BEGIN PUBLIC KEY----- MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC/VpRysi0bPRLS7sbgQDJHo1MAt9/bK+nwK5Pe3z0/O4cH5I/8kFNYy4yFsLMM+zyFvVw9C4wzjHaRcmEuF3ziJMC9PD5ufUWgfO5nSGgZW1cmgjqnhcWJ3i+Azj72RnhKQRCn9DgJduEC9MiKfbyTICGd6FXf9cxb21nkxI7vtwIDAQAB -----END PUBLIC KEY-----

推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

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
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。