重置密码

最近更新时间:2018-07-02 09:56:35

功能描述

ResetDevicePasswd接口用来重置物理服务器root密码。

接口访问域名:bm.api.qcloud.com

请求

请求示例

https://bm.api.qcloud.com/v2/index.php?
    Action=ResetDevicePasswd
    &<公共请求参数>
    &instanceIds.1=<设备ID1>
    &instanceIds.2=<设备ID2>
    &passwd=<密码>

请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,其它参数参见公共请求参数页面。其中,此接口的Action字段为ResetDevicePasswd。

参数名称 必选 类型 描述
instanceIds.n String 待操作的设备ID。可通过 查询服务器(DescribeDeviceList) API返回值中的 instanceId 获取(此接口支持同时传入多个ID。此参数的具体格式可参考API简介id.n一节)。
passwd String 密码。 用户设置的linux root或Windows Administrator密码。密码校验规则:
  • Windows机器密码需12到16位,至少包括三项[a-z],[A-Z],[0-9][()'~!@#$%^&*-+=_|{}[]:;'<>,.?/]的特殊符号, 密码不能包含Administrator(不区分大小写);
  • Linux机器密码需8到16位,至少包括两项[a-z,A-Z],[0-9][()'~!@#$%^&*-+=_|{}[]:;'<>,.?/]的特殊符号。
  • 响应

    响应示例

    {
      "code": 0,
      "message": "OK",
      "data": {
           “taskId”: 101
       }
    }
    

    响应参数

    响应参数部分包含两层结构,外层展示接口的响应结果,内层展示具体的接口内容,包括异步操作的ID等信息。

    参数名称 类型 描述
    code Int 错误码,0:成功,其他值:失败,具体含义参见错误码
    message String 错误信息。
    data Object 返回异步操作的ID信息,具体结构描述如data结构所示。

    data结构

    参数名称 类型 描述
    taskId Int 以taskId为key,对应的值为异步操作的ID。

    错误码

    错误码 英文提示 错误描述
    9001 InternalError.DbError 操作数据库错误
    9005 InternalError.RbmqError 操作系统队列错误
    9008 InternalError.TscRequestFail 请求内部后端接口错误
    10001 InvalidParameter 参数错误
    12002 OperationDenied.IncorrectInstanceStatus 设备不能重置密码
    12006 OperationDenied.TsysAgentNotAlive agent不存在,无法进行此操作

    实际案例

    输入

    https://bm.api.qcloud.com/v2/index.php?
        Action=ResetDevicePasswd
        &SecretId=AKID52SKw5uMEy3jhpMUBqSylEBJBby6E0KC
        &Nonce=48476
        &Timestamp=1476436689
        &Region=bj
        &Signature=afRlJQ0disdT97B7uIfVB4v2KWo%3D
        &instanceIds.1=cpm-34xs43xs
        &instanceIds.2=cpm-3xwssdfx
        &passwd=abce1234
    

    输出

    {
      "code": 0,
      "message": "OK",
      "data": {
           “taskId”: 101
       }
    }