使用SetPasswordPolicy接口设置RAM用户密码策略-访问控制-阿里云

调用SetPasswordPolicy接口设置RAM用户密码强度等策略信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ram:SetPasswordPolicy

update

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
MinimumPasswordLength	integer	否	最小密码长度。取值范围：8~32。默认值：8。	12
RequireLowercaseCharacters	boolean	否	必须含有小写字母。	true
RequireUppercaseCharacters	boolean	否	必须含有大写字母。	true
RequireNumbers	boolean	否	必须含有数字。	true
RequireSymbols	boolean	否	必须含有特殊字符。	true
HardExpiry	boolean	否	密码是否过期。取值为`true`或`false`，如果未指定此参数的值，系统默认为`false`。如果取值为`true`，此时必须由主账号重置密码后，RAM 用户才能正常登录。如果取值为`false`，此时 RAM 用户可以在密码过期后自行更改密码，并继续以用户身份登录。	false
MaxPasswordAge	integer	否	密码有效期，单位是天（重置密码将重置密码过期时间）。0 表示不启用密码过期策略，默认不启用。	0
PasswordReusePrevention	integer	否	禁止使用前 N 次密码。0 表示不启用历史密码检查策略，默认不启用。	0
MaxLoginAttemps	integer	否	一小时内使用错误密码尝试登录最大次数（重置密码可清除尝试登录计数）。	5

返回参数

名称	类型	描述	示例值
	object	返回参数。
RequestId	string	请求 ID。	04F0F334-1335-436C-A1D7-6C044FE73368
PasswordPolicy	object	密码策略。
RequireNumbers	boolean	必须包含数字。	true
RequireLowercaseCharacters	boolean	必须包含小写字母。	true
HardExpiry	boolean	密码是否过期。取值为`true`或`false`，如果未指定此参数的值，系统默认为`false`。如果取值为`true`，此时必须由主账号重置密码后，RAM 用户才能正常登录。如果取值为`false`，此时 RAM 用户可以在密码过期后自行更改密码，并继续以用户身份登录。	false
PasswordReusePrevention	integer	禁止使用前 N 次密码。0 表示不启用历史密码检查策略，默认不启用。	0
RequireSymbols	boolean	必须包含字符。	true
MaxPasswordAge	integer	密码有效期，单位是天（重置密码将重置密码过期时间）。0 表示不启用密码过期策略，默认不启用。	0
MinimumPasswordLength	integer	最小密码长度。	12
RequireUppercaseCharacters	boolean	必须包含大写字母。	true
MaxLoginAttemps	integer	一小时内使用错误密码尝试登录最大次数（重置密码可清除尝试登录计数）。	5

示例

正常返回示例

JSON格式

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "PasswordPolicy": {
    "RequireNumbers": true,
    "RequireLowercaseCharacters": true,
    "HardExpiry": false,
    "PasswordReusePrevention": 0,
    "RequireSymbols": true,
    "MaxPasswordAge": 0,
    "MinimumPasswordLength": 12,
    "RequireUppercaseCharacters": true,
    "MaxLoginAttemps": 5
  }
}

异常返回示例

JSON格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "PasswordPolicy": {
        "MinimumPasswordLength": 12,
        "RequireLowercaseCharacters": true,
        "RequireUppercaseCharacters": true,
        "RequireNumbers": true,
        "RequireSymbols": true
    }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。