You can call this operation to query the details of a Cassandra instance.

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 DescribeCluster

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

ClusterId String Yes cds-bp1b136j****5d58

The ID of the cluster.

Response parameters

Parameter Type Example Description
Cluster Struct

The list of cluster information.

ClusterId String cds-bp1b136j****5d56

The ID of the cluster.

ClusterName String Cassandra-test

The name of the cluster.

The name must be 2 to 128 characters in length, and can contain letters, digits, periods (.), underscores (_), and hyphens (-). It must start with a letter.

CreatedTime String 2019-09-20T16:02:34Z

The time when the cluster was created. The time follows the ISO 8601 standard in the yyyy-MM-ddThh:mm:ssZ format. The time is displayed in UTC and denoted by Z.

DataCenterCount Integer 1

The number of data centers.

ExpireTime String 2019-10-20T16:02:34Z

The expiration time of the cluster. The time follows the ISO 8601 standard in the yyyy-MM-ddThh:mm:ssZ format. The time is displayed in UTC and denoted by Z.

IsLatestVersion Boolean true

Indicates whether the current minor version is the latest.

LockMode String None

The lock mode of the cluster. Valid values:

  • None: The cluster is not locked.
  • Expired: The cluster is locked upon expiration of subscription.
  • DiskFull: The cluster is locked because the disk is full.
MaintainEndTime String 4:00Z

The end time of the maintenance window of the instance. The time is in the HH:mmZ format, displayed in UTC and denoted by Z.

MaintainStartTime String 2:00Z

The start time of the maintenance window of the instance. The time is in the HH:mmZ format, displayed in UTC and denoted by Z.

MajorVersion String 3.11

The major version number of the cluster.

MinorVersion String 3.11.7

The minor version number of the cluster.

PayType String PayAsYouGo

The billing method. Valid values:

  • Subscription
  • PayAsYouGo
Note Pay-as-you-go clusters never expire.
Status String Running

The running status of the cluster. Valid values:

  • Creating
  • CreateFailed
  • Running
  • Deleting
  • DeleteFailed
  • Deleted
Tags Array

The tag.

Tag
Key String test-key

The tag key.

Value String test-value

The tag value.

RequestId String 17E2B462-5FD3-4A0C-AF13-225C66E47BD5

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=DescribeCluster
&ClusterId=cds-bp1b136j****5d58
&<Common request parameters>

Sample success responses

XML format

<DescribeClusterResponse>
  <RequestId>E42FA994-8629-4BFE-A796-8FC512775306</RequestId>
  <Cluster>
        <MajorVersion>3.11</MajorVersion>
        <Status>Running</Status>
        <CreatedTime>2020-02-26T01:29:03Z</CreatedTime>
        <ClusterId>cds-bp11tjzh****o87v</ClusterId>
        <MinorVersion>3.11.9</MinorVersion>
        <LockMode>None</LockMode>
        <PayType>Subscription</PayType>
        <IsLatestVersion>true</IsLatestVersion>
        <MaintainEndTime>22:00Z</MaintainEndTime>
        <DataCenterCount>1</DataCenterCount>
        <ClusterName>hz_test_jy</ClusterName>
        <ExpireTime>2020-04-11T00:00:00Z</ExpireTime>
        <MaintainStartTime>18:00Z</MaintainStartTime>
  </Cluster>
</DescribeClusterResponse>

JSON format

{
  "RequestId": "E42FA994-8629-4BFE-A796-8FC512775306",
  "Cluster": {
    "MajorVersion": "3.11",
    "Status": "Running",
    "CreatedTime": "2020-02-26T01:29:03Z",
    "ClusterId": "cds-bp11tjzh****o87v",
    "MinorVersion": "3.11.9",
    "LockMode": "None",
    "PayType": "Subscription",
    "IsLatestVersion": true,
    "MaintainEndTime": "22:00Z",
    "DataCenterCount": 1,
    "ClusterName": "hz_test_jy",
    "ExpireTime": "2020-04-11T00:00:00Z",
    "MaintainStartTime": "18:00Z"
  }
}

Error codes

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