调用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"}
错误码
访问错误中心查看更多错误码。