调用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******"
}

错误码

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