Queries information about the databases of an ApsaraDB for ClickHouse cluster.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeSchemas

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

DBClusterId String Yes cc-bp108z124a8o7****

The ID of the cluster.

Response parameters

Parameter Type Example Description
RequestId String 05321590-BB65-4720-8CB6-8218E041CDD0

The ID of the request.

Items Array of Schema

The information about the databases of the cluster.

Schema
DBClusterId String cc-bp108z124a8o7****

The ID of the cluster.

SchemaName String database

The name of a database of the cluster.

Examples

Sample requests

http(s)://clickhouse.aliyuncs.com/?Action=DescribeSchemas
&DBClusterId=cc-bp108z124a8o7****
&Common request parameters

Sample success responses

XML format

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

<DescribeSchemasResponse>
    <RequestId>05321590-BB65-4720-8CB6-8218E041CDD0</RequestId>
    <Items>
        <DBClusterId>cc-bp108z124a8o7****</DBClusterId>
        <SchemaName>database</SchemaName>
    </Items>
</DescribeSchemasResponse>

JSON format

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

{
  "RequestId" : "05321590-BB65-4720-8CB6-8218E041CDD0",
  "Items" : {
    "DBClusterId" : "cc-bp108z124a8o7****",
    "SchemaName" : "database"
  }
}

Error codes

HttpCode Error code Error message Description
500 InternalError An error occurred while processing your request. The error message returned because an internal error has occurred. Try again later.
503 ServiceUnavailable An error occurred while processing your request. The error message returned because the service is unavailable. Try again later.

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