调用CheckDBNameAvailable接口检查数据库名称是否重复或不符合命名规范。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CheckDBNameAvailable |
系统规定参数，取值：CheckDBNameAvailable。 |
| DBInstanceId | String | 是 | rm-t4n3axxxxx |
实例ID。 |
| DBName | String | 是 | test1 |
待检查的数据库名称。 |
| ClientToken | String | 否 | ETnLKlblzczshOTUbOCzxxxxxxxxxx |
用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符，且该参数值中不能包含非ASCII字符。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 6EF82B07-28D2-48D1-B5D6-7E78FED277C7 |
请求ID。 说明 仅返回请求ID时，表示数据库名称可用，否则会返回报错信息，提示数据库名称重复或不符合命名规范。
|
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=CheckDBNameAvailable
&DBInstanceId=rm-t4n3axxxxx
&DBName=test1
&<公共请求参数>正常返回示例
XML格式
<CheckDBNameAvailableResponse>
<RequestId>6EF82B07-28D2-48D1-B5D6-7E78FED277C7</RequestId>
</CheckDBNameAvailableResponse>JSON格式
{"RequestId":"6EF82B07-28D2-48D1-B5D6-7E78FED277C7"}错误码
访问错误中心查看更多错误码。