SetPasswordPolicy - 设置RAM用户密码强度等策略信息

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ram:SetPasswordPolicyupdate
  • 全部资源
    *

请求参数

名称类型必填描述示例值
MinimumPasswordLengthinteger

最小密码长度。

取值范围:8~32。默认值:8。

12
RequireLowercaseCharactersboolean

必须含有小写字母。

true
RequireUppercaseCharactersboolean

必须含有大写字母。

true
RequireNumbersboolean

必须含有数字。

true
RequireSymbolsboolean

必须含有特殊字符。

true
HardExpiryboolean

密码是否过期。 取值为truefalse,如果未指定此参数的值,系统默认为false

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

密码有效期,单位是天(重置密码将重置密码过期时间)。0 表示不启用密码过期策略,默认不启用。

0
PasswordReusePreventioninteger

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

0
MaxLoginAttempsinteger

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

5

返回参数

名称类型描述示例值
object

返回参数。

RequestIdstring

请求 ID。

04F0F334-1335-436C-A1D7-6C044FE73368
PasswordPolicyobject

密码策略。

RequireNumbersboolean

必须包含数字。

true
RequireLowercaseCharactersboolean

必须包含小写字母。

true
HardExpiryboolean

密码是否过期。 取值为truefalse,如果未指定此参数的值,系统默认为false

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

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

0
RequireSymbolsboolean

必须包含字符。

true
MaxPasswordAgeinteger

密码有效期,单位是天(重置密码将重置密码过期时间)。0 表示不启用密码过期策略,默认不启用。

0
MinimumPasswordLengthinteger

最小密码长度。

12
RequireUppercaseCharactersboolean

必须包含大写字母。

true
MaxLoginAttempsinteger

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

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
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史