Queries the number of connections and user information of an AnalyticDB for MySQL 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 Yes DescribeConnectionCountRecords

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

DBClusterId String Yes am-bp1jj9xqft1po****

The ID of the cluster.

Note You can call the DescribeDBClusters operation to query the details of all AnalyticDB for MySQL clusters within a specific region, including cluster IDs.

Response parameters

Parameter Type Example Description
RequestId String 562C7F89-FBE6-4A04-AAAA-7EBC25******

The ID of the request.

DBClusterId String am-bp1jj9xqft1po****

The ID of the cluster.

AccessIpRecords Array of AccessIps

Details of the client IP addresses.

AccessIp String 42.120.XX.XX

The IP address of the client used to connect to the cluster.

Count Long 1

The number of connections.

UserRecords Array of Users

Details of the users.

User String test

The name of the user used to connect to the cluster.

Count Long 1

The number of connections.

Examples

Sample requests

http(s)://adb.aliyuncs.com/?Action=DescribeConnectionCountRecords
&DBClusterId=am-bp1jj9xqft1po****
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeConnectionCountRecordsResponse>
    <RequestId>562C7F89-FBE6-4A04-AAAA-7EBC25******</RequestId>
    <DBClusterId>am-bp1jj9xqft1po****</DBClusterId>
    <AccessIpRecords>
        <AccessIp>42.120.XX.XX</AccessIp>
        <Count>1</Count>
    </AccessIpRecords>
    <UserRecords>
        <User>test</User>
        <Count>1</Count>
    </UserRecords>
</DescribeConnectionCountRecordsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "562C7F89-FBE6-4A04-AAAA-7EBC25******",
  "DBClusterId" : "am-bp1jj9xqft1po****",
  "AccessIpRecords" : {
    "AccessIp" : "42.120.XX.XX",
    "Count" : 1
  },
  "UserRecords" : {
    "User" : "test",
    "Count" : 1
  }
}

Error codes

HTTP status code Error code Error message Description
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. The error message returned because the specified DBClusterId parameter does not exist. Check whether the cluster ID is valid.

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