校验数据库名称是否合法或当前集群中是否已存在重名的数据库。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
polardb:CheckDBName |
get |
*dbcluster
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DBClusterId |
string |
是 |
集群 ID。 说明
您可以调用 DescribeDBClusters 接口查看目标地域下所有的集群信息,包括集群 ID。 |
pc-**************** |
| DBName |
string |
是 |
数据库名称。 |
test_db |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
CDB3258F-B5DE-43C4-8935-CBA0CA****** |
| DBName |
string |
数据库名称 |
test_db |
若输入的数据库名称不合法,会返回错误信息
Specified DB name is not valid。若输入的数据库名称与已有数据库名称重复,会返回错误信息
Specified DB name already exists。
示例
正常返回示例
JSON格式
{
"RequestId": "CDB3258F-B5DE-43C4-8935-CBA0CA******",
"DBName": "test_db"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidDBName.Duplicate | The specified DB name already exists. | 操作失败,指定的数据库名称已存在。 |
| 400 | InvalidAccountName.Malformed | The specified parameter AccountName is not valid. | 指定的参数AccountName无效。 |
| 404 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | 指定的参数DBClusterId无效 |
| 404 | InvalidDBClusterId.NotFound | The DBInstanceId provided does not exist in our records. | 当前的记录中不存在提供的DBClusterId。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。
该文章对您有帮助吗?