Checks whether an account name is valid or unique in the cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No CheckAccountName

The operation that you want to perform. Set the value to CheckAccountName.

AccountName String Yes test_acc

The name of the account.
DBClusterId String Yes pc-****************

The ID of the cluster.

Note You can call the DescribeDBClusters operation to query information about all clusters that are deployed in a specified region, such as the cluster ID.

Response parameters

Parameter Type Example Description
RequestId String 925B84D9-CA72-432C-95CF-738C22******

The ID of the request.
  • If the account name that you enter is invalid, the error message Specified account name is not valid is returned.
  • If the account name that you enter exists in the cluster, the error message The specified account name already exists is returned.

Examples

Sample requests

http(s)://polardb.aliyuncs.com/? Action=CheckAccountName
&AccountName=test_acc
&DBClusterId=pc-****************
&<Common request parameters>

Sample success responses

XML format 

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

JSON format 

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

Error codes

For a list of error codes, visit the API Error Center.