说明:
1. 接口描述
本接口 (ResetInstancePassword) 用于将实例操作系统的密码重置为用户指定的值。
接口请求域名:cvm.api.qcloud.com
只修改管理员账号的密码;实例的操作系统不同,管理员账号也会不一样(Windows 为 Administrator;Ubuntu 为 ubuntu;其它系统为 root)。
支持批量操作,以将多个 CVM 实例修改为相同的密码。
只有处于关机状态的实例才允许执行重置密码操作。
2. 输入参数
参数名称 | 是否必选 | 类型 | 描述 |
instanceIds.n | 是 | String | 待操作的实例 ID。可通过 DescribeInstances API返回值中的 unInstanceId 获取(此接口支持同时传入多个 ID。此参数的具体格式可参考 API 简介的 id.n 一节)。 |
password | 是 | String | 实例密码。 Linux 实例密码必须8到16位,至少包括两项[a-z,A-Z]、[0-9] 和 [( ) ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? / ]中的特殊符号。<br><br>Windows实例密码必须12到16位,至少包括三项[a-z],[A-Z],[0-9] 和 [( ) ~ ! @ # $ % ^ & * - + = { } [ ] : ; ' , . ? /]中的特殊符号。 |
3. 输出参数
参数名称 | 类型 | 描述 |
code | Int | 公共错误码。0表示成功,其他值表示失败。 |
message | String | 模块错误信息描述,与接口相关。 |
4. 错误码
错误码 | 描述 |
OperationConstraints.InvaildInstanceStatus | 实例状态不正确或获取实例状态失败 |
5. 示例
输入
https://cvm.api.qcloud.com/v2/index.php?Action=ResetInstancePassword&instanceIds.0=ins-xxxxxxxx&password=abce1234
输出