调用CheckDBName校验数据库名称是否合法或当前集群中是否已存在重名的数据库。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 否 | CheckDBName |
系统规定参数，取值为CheckDBName。 |
| DBClusterId | String | 是 | pc-**************** |
集群ID。
说明 您可以调用
DescribeDBClusters接口查看目标地域下所有的集群信息，包括集群ID。 |
| DBName | String | 是 | test_db |
数据库名称。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | CDB3258F-B5DE-43C4-8935-CBA0CA****** |
请求ID。 |
- 若输入的数据库名称不合法，会返回错误信息
Specified DB name is not valid。 - 若输入的数据库名称与已有数据库名称重复，会返回错误信息
Specified DB name already exists。
示例
请求示例
http(s)://polardb.aliyuncs.com/?Action=CheckDBName
&DBClusterId=pc-****************
&DBName=test_db
&<公共请求参数>正常返回示例
XML 格式
<CheckDBNameResponse>
<RequestId>CDB3258F-B5DE-43C4-8935-CBA0CA******</RequestId>
</CheckDBNameResponse>JSON 格式
{
"RequestId": "CDB3258F-B5DE-43C4-8935-CBA0CA******"
}错误码
访问错误中心查看更多错误码。
