调用CheckAccountName接口校验账号名称是否合法或当前集群中是否已存在重名的账号。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CheckAccountName

系统规定参数,取值为CheckAccountName

AccountName String test_acc

账号名称。

DBClusterId String pc-****************

集群ID。

说明 您可以调用DescribeDBClusters接口查看目标地域下所有的集群信息,包括集群ID。

返回数据

名称 类型 示例值 描述
RequestId String 925B84D9-CA72-432C-95CF-738C22******

请求ID。

  • 若输入的账号名称不合法,会返回错误信息Specified account name is not valid
  • 若输入的账号名称与已有账号名称重复,会返回错误信息The specified account name already exists

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=CheckAccountName
&AccountName=test_acc
&DBClusterId=pc-****************
&<公共请求参数>

正常返回示例

XML 格式

<CheckAccountNameResponse>
  <RequestId>925B84D9-CA72-432C-95CF-738C22******</RequestId>
</CheckAccountNameResponse>

JSON 格式

{
  "RequestId": "925B84D9-CA72-432C-95CF-738C22******"
}

错误码

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