# 修改密码
#### 功能介绍
修改缓存实例的密码。
#### **URI**
PUT /v1.0/{project_id}/instances/{instance_id}/password
参数说明见[表1]。
 表1参数说明 
| 参数          | 类型       | 必选 | 说明     |
|:---|:---|:---|:---|
| project_id | String | 是   | 项目ID。 |
| instance_id  | String | 是 | 实例ID。   |
   
#### **请求消息**
**请求参数**
参数说明见[表2]。
 表2参数说明 
| 参数            | 类型     | 必选 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| old_password | String    | 是  | 旧密码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| new_password   | String | 是  | 新密码。 实例密码复杂度要求： - 密码不能为空。  - 密码不能和账号及账号的倒序相同。  - 密码长度在8到32位之间。  - 至少必须包含如下四种字符中的三种： - 小写字母  - 大写字母  - 数字  - 特殊字符包括（\`\~!@#$\^\&\*()-_=+\\\|{}:,\<.\>/?）     |
   
**请求示例**
```
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 sucessful.
{
    "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](https://support.huaweicloud.com/api-dcs/dcs-api-0312043.html#dcs-api-0312043__table5210141351517)。
 表4状态码 
| 状态码 | 描述   |
|:---|:---|
| 200 | 修改密码成功。 |