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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SetPasswordPolicy

系统规定参数。取值：SetPasswordPolicy。
MinimumPasswordLength Integer 否 12

最小密码长度。

取值范围：8~32。默认值：8。
RequireLowercaseCharacters Boolean 否 true

必须含有小写字母。
RequireUppercaseCharacters Boolean 否 true

必须含有大写字母。
RequireNumbers Boolean 否 true

必须含有数字。
RequireSymbols Boolean 否 true

必须含有特殊字符。
HardExpiry Boolean 否 false

密码是否过期。

取值为true或false，如果未指定此参数的值，系统默认为false。

  • 如果取值为true，此时必须由主账号重置密码后，RAM用户才能正常登录。
  • 如果取值为false，此时RAM用户可以在密码过期后自行更改密码，并继续以用户身份登录。
MaxPasswordAge Integer 否 0

密码有效期，单位是天（重置密码将重置密码过期时间）。0表示不启用密码过期策略，默认不启用。
PasswordReusePrevention Integer 否 0

禁止使用前N次密码。0表示不启用历史密码检查策略，默认不启用。
MaxLoginAttemps Integer 否 5

一小时内使用错误密码尝试登录最大次数（重置密码可清除尝试登录计数）。

返回数据

名称 类型 示例值 描述
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。
PasswordPolicy Object

密码策略。
RequireNumbers Boolean true

必须包含数字。
RequireLowercaseCharacters Boolean true

必须包含小写字母。
HardExpiry Boolean false

密码是否过期。

取值为true或false，如果未指定此参数的值，系统默认为false。

  • 如果取值为true，此时必须由主账号重置密码后，RAM用户才能正常登录。
  • 如果取值为false，此时RAM用户可以在密码过期后自行更改密码，并继续以用户身份登录。
PasswordReusePrevention Integer 0

禁止使用前N次密码。0表示不启用历史密码检查策略，默认不启用。
RequireSymbols Boolean true

必须包含字符。
MaxPasswordAge Integer 0

密码有效期，单位是天（重置密码将重置密码过期时间）。0表示不启用密码过期策略，默认不启用。
MinimumPasswordLength Integer 12

最小密码长度。
RequireUppercaseCharacters Boolean true

必须包含大写字母。
MaxLoginAttemps Integer 5

一小时内使用错误密码尝试登录最大次数（重置密码可清除尝试登录计数）。

示例

请求示例

https://ram.aliyuncs.com/?Action=SetPasswordPolicy
&MinimumPasswordLength=12
&RequireLowercaseCharacters=true
&RequireUppercaseCharacters=true
&RequireNumbers=true
&RequireSymbols=true
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SetPasswordPolicyResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <PasswordPolicy>
        <HardExpiry>false</HardExpiry>
        <MaxLoginAttemps>5</MaxLoginAttemps>
        <MaxPasswordAge>0</MaxPasswordAge>
        <PasswordReusePrevention>0</PasswordReusePrevention>
        <MinimumPasswordLength>12</MinimumPasswordLength>
        <RequireLowercaseCharacters>true</RequireLowercaseCharacters>
        <RequireUppercaseCharacters>true</RequireUppercaseCharacters>
        <RequireNumbers>true</RequireNumbers>
        <RequireSymbols>true</RequireSymbols>
    </PasswordPolicy>
</SetPasswordPolicyResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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