更新时间:2023-12-13 GMT+08:00

修改密码

功能介绍

修改缓存实例的密码。

URI

PUT /v1.0/{project_id}/instances/{instance_id}/password

参数说明见表1
表1 参数说明

参数

类型

必选

说明

project_id

String

项目ID。获取方式,参考获取项目ID

instance_id

String

实例ID。

请求消息

请求参数

参数说明见表2
表2 参数说明

参数

类型

必选

说明

old_password

String

旧密码。

new_password

String

新密码。

实例密码复杂度要求:

  • 密码不能为空。
  • 密码不能和账号及账号的倒序相同。
  • 密码长度在8到64位之间。
  • 至少必须包含如下四种字符中的三种:
    • 小写字母
    • 大写字母
    • 数字
    • 特殊字符包括(`~!@#$^&*()-_=+\|{}:,<.>/?)

请求示例

  • 请求URL:
    PUT https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/password
  • 示例:
    {
        "old_password": "XXXXXX",
        "new_password": "XXXXXX"
    }

响应消息

响应参数

参数说明见表3
表3 参数说明

参数

类型

说明

result

String

密码修改结果:

  • 成功:success;
  • 密码验证失败:passwordFailed;
  • 已锁定:locked;
  • 失败:failed。

message

String

修改结果。

retry_times_left

String

密码验证剩余次数。验证失败时该参数返回不为null。

lock_time

String

锁定时间。验证失败时和锁定时该参数返回不为null。

lock_time_left

String

锁定剩余时间。锁定时该参数返回不为null。

响应示例
//Change password success.
{
    "result" : "Success",
    "message" : "Modify DCSInstance password success.",
    "retry_times_left" : "5",
    "lock_time" : "0",
    "lock_time_left" : "0"
}
//Change password failed.
{
    "result" : "passwordFailed",
    "message" : "verify password failed.",
    "retry_times_left" : "4",
    "lock_time" : "5",
    "lock_time_left" : "5"
}

状态码

操作成功的状态码如表4所示,其他响应见表1

表4 状态码

状态码

描述

200

修改密码成功。