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

错误码

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