You need to enable JavaScript to run this app.
文档中心
云数据库 MySQL 版

云数据库 MySQL 版

复制全文
下载 pdf
账号管理
DescribeDBInstancePasswordPolicy - 查询自定义密码策略
复制全文
下载 pdf
DescribeDBInstancePasswordPolicy - 查询自定义密码策略
调用 DescribeDBInstancePasswordPolicy 接口查询自定义密码策略。​
请求类型​
同步请求​
注意事项​
数据库内核版本需满足以下条件:​
  • MySQL 5.7 实例:内核小版本需为 MySQL 5.7.44_20260815 及以上。​
  • MySQL 8.0 实例:内核小版本需为 MySQL 8.0.43_20260815 及以上。​
  • MySQL 8.4 实例:内核小版本需为 MySQL 8.4.7_20260815 及以上。​
说明​
您可通过查看实例信息查看实例的内核小版本。若您的实例不满足要求,可手动升级实例内核小版本。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
InstanceId​
String​
是​
mysql-r3xq0zdlxxxx​
实例 ID。​
说明​
您可以调用 DescribeDBInstances接口查看实例 ID。​
​
返回参数​
​
参数​
类型​
示例值​
描述​
InstanceId​
String​
mysql-r3xq0zdlxxxx​
实例 ID。​
PasswordPolicy​
Object of PasswordPolicy​
请参见请求示例。​
自定义密码策略。​
​
PasswordPolicy​
​
参数​
类型​
示例值​
描述​
Enabled​
Boolean​
true​
是否启用自定义密码策略。取值:​
  • true:启用。​
  • false (默认值):不启用。​
PolicyLevel​
String​
MEDIUM​
密码强度等级。取值如下:​
  • LOW(默认值):低等强度。仅校验密码长度,密码可在满足长度要求的前提下按需设置。​
  • MEDIUM:中等强度。校验密码长度,且密码需至少包含大写字母、小写字母、数字和特殊字符中的任意三种。​
  • STRONG:高等强度。校验密码长度,且密码需至少包含大写字母、小写字母、数字和特殊字符中的任意三种。​
说明​
  • 仅 Enabled 参数取值为 true 时,配置该参数。​
  • 由于当前不支持指定字典文件,因此 MEDIUM (中等强度)与 STRONG(高等强度)的校验规则相同。​
MinLength​
Integer​
8​
密码的最小长度。默认值为 8,取值范围为 8~256。​
说明​
仅 Enabled 参数取值为 true时,配置该参数。​
NumberCount​
Integer​
1​
密码中需包含数字的个数。默认值为 1,取值范围为 0~256。​
说明​
  • 仅 Enabled 参数取值为 true 时,配置该参数。​
  • 该参数的可设置范围会根据 MinLength、MixedCaseCount 和 SpecialCharCount参数的当前值动态调整。​
MixedCaseCount​
Integer​
1​
密码中需分别包含的大写字母和小写字母的最少个数。默认值为 1,取值范围为 0~256。​
例如,该参数设置为 2 时,密码中至少包含 2 个大写字母和 2 个小写字母,即总计至少包含 4 个字母。​
说明​
  • 仅 Enabled 参数取值为 true 时,配置该参数。​
  • 该参数的可设置范围会根据 MinLength、NumberCount 和 SpecialCharCount参数的当前值动态调整。​
SpecialCharCount​
Integer​
1​
密码中需包含特殊字符的个数。默认值为 1,取值范围为 0~256。​
说明​
  • 仅 Enabled 参数取值为 true 时,配置该参数。​
  • 该参数的可设置范围会根据 MinLength、NumberCount 和 MixedCaseCount参数的当前值动态调整。​
​
示例​
请求示例​
​
POST /?Action=DescribeDBInstancePasswordPolicy&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host: rds-mysql.cn-beijing.volcengineapi.com​
X-Date: 20211202T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****​
{​
"InstanceId": "mysql-r3xq0zdlxxxx"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribeDBInstancePasswordPolicy",​
"Version": "2022-01-01",​
"Service": "rds_mysql",​
"Region": "cn-north-1"​
},​
"Result": {​
"InstanceId": "mysql-r3xq0zdlxxxx",​
"PasswordPolicy": {​
"Enabled": true,​
"MinLength": 8,​
"NumberCount": 1,​
"PolicyLevel": "MEDIUM",​
"MixedCaseCount": 1,​
"SpecialCharCount": 1​
}​
}​
}​
​
错误码​
更多详情,请参见错误码。​
最近更新时间:2026.10.16 15:31:27
这个页面对您有帮助吗?
有用
有用
无用
无用