文档首页/ 分布式缓存服务 DCS/ API参考（巴黎区域）/ 历史API（V1）/ 实例管理/ 修改密码
更新时间：2023-12-13 GMT+08:00
查看PDF
分享

修改密码

功能介绍

修改缓存实例的密码。

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

修改密码成功。
父主题： 实例管理