# 查询账号密码策略 - ShowPasswordPolicyV5
#### 功能介绍
该接口可以用于查询账号密码策略。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IAM/doc?api=ShowPasswordPolicyV5&version=v5)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-iam5/iam_02_1124.html)。
| 授权项                                      | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| iam:securitypolicies:getPasswordPolicyV5 | Read | -           | -   | -  | -      |
   
#### URI
GET /v5/password-policy
#### 请求参数
无
#### 响应参数
**状态码：200**
表1响应Body参数 
| 参数              | 参数类型                                                                      | 描述                                                                                                                                                     |
|:---|:---|:---|
| password_policy | [password_policy] object | **参数解释**： 密码策略。 **取值范围**： 不涉及。 |
   
 表2password_policy 
| 参数                                  | 参数类型    | 描述                                                                                                                                                                                                                    |
|:---|:---|:---|
| maximum_consecutive_identical_chars | Integer | **参数解释**： 同一字符连续出现的最大次数。 **取值范围**： 不涉及。                                                       |
| maximum_password_length             | Integer | **参数解释**： 密码最大字符数。 **取值范围**： 不涉及。                                                             |
| minimum_password_age                | Integer | **参数解释**： 密码最短使用时间（分钟）。 **取值范围**： 不涉及。                                                        |
| minimum_password_length             | Integer | **参数解释**： 密码最小字符数。 **取值范围**： 不涉及。                                                             |
| password_reuse_prevention           | Integer | **参数解释**： 密码不能与历史密码重复次数。 **取值范围**： 不涉及。                                                       |
| password_not_username_or_invert     | Boolean | **参数解释**： 密码是否可以是用户名或用户名的反序。为true时表示密码不可以是用户名或用户名的反序，为false时表示密码可以是用户名或用户名的反序。 **取值范围**： 不涉及。 |
| password_requirements               | String  | **参数解释**： 设置密码必须包含的字符要求。 **取值范围**： 不涉及。                                                       |
| password_validity_period            | Integer | **参数解释**： 密码有效期（天）。 **取值范围**： 不涉及。                                                            |
| password_char_combination           | Integer | **参数解释**： 至少包含字符种类的个数。 **取值范围**： 不涉及。                                                         |
| allow_user_to_change_password       | Boolean | **参数解释**： 是否允许IAM用户修改自己的密码，不适用于根用户。 **取值范围**： 取值范围为\[true,false\]。                            |
   
**状态码：403**
表3响应Body参数 
| 参数                            | 参数类型   | 描述                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| error_code                    | String | **参数解释**： 错误码，请参见[错误码](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。 **取值范围**： 格式为PAP5.XXXX，例如PAP5.0012。                                    |
| error_msg                     | String | **参数解释**： 错误信息，请参见[错误信息](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。 **取值范围**： 不涉及。                                                       |
| request_id                    | String | **参数解释**： API请求的唯一标识，用于排查接口调用异常。 **取值范围**： 不涉及。                                                                                                         |
| encoded_authorization_message | String | **参数解释**： 认证失败时返回的加密详细信息，用于定位认证问题。 可以通过STS5解密接口进行解密，请参见[接口链接](https://support.huaweicloud.com/api-iam5/DecodeAuthorizationMessage.html)。 **取值范围**： 不涉及。 |
   
#### 请求示例
查询账号密码策略。
```
GET https://{endpoint}/v5/password-policy
```
#### 响应示例
**状态码：200**
```
{
  "password_policy" : {
    "maximum_consecutive_identical_chars" : 0,
    "maximum_password_length" : 32,
    "minimum_password_age" : 0,
    "minimum_password_length" : 8,
    "password_reuse_prevention" : 1,
    "password_not_username_or_invert" : true,
    "password_requirements" : "A password must contain at least two of the following: uppercase letters, lowercase letters, digits, and special characters.",
    "password_validity_period" : 180,
    "password_char_combination" : 2,
    "allow_user_to_change_password" : true
  }
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 请求成功。   |
| 403 | 没有操作权限。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。