Queries the details about the PolarDB clusters that contain backup sets and reside in a specified region.


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
RegionId String Yes cn-hangzhou

The ID of the region. The region ID cannot exceed 50 characters in length.

Note You can call the DescribeRegions operation to query available regions.
DBClusterIds String No pc-**************

The ID of the PolarDB cluster. If you need to specify multiple cluster IDs, separate the cluster IDs with commas (,).

DBClusterDescription String No pc-**************

The description of the cluster.

DBType String No MySQL

The type of the database engine.

IsDeleted Integer No 0

Specifies whether the cluster is deleted. Valid values:

  • 0: not deleted
  • 1: deleted
PageSize Integer No 30

The number of entries to return on each page. Default value: 30. Valid values:

  • 30
  • 50
  • 100
PageNumber Integer No 1

The number of the page to return. Default value: 1. The value must be a positive integer.

DBVersion String No 8.0

The version of the database engine. Valid values:

  • MySQL:
    • 5.6
    • 5.7
    • 8.0
  • PostgreSQL: 11
  • Oracle: 11

Response parameters

Parameter Type Example Description
Items Array

The details about the cluster.

CreateTime String 2020-05-09T09:33:51Z

The time when the cluster was created.

DBClusterDescription String pc-****************

The description of the cluster.

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

The ID of the PolarDB cluster.

DBClusterNetworkType String VPC

The network type of the cluster.

DBClusterStatus String Running

The status of the cluster. Valid values:

  • Creating: The cluster is being created.
  • Running: The cluster is running.
  • Deleting: The cluster is being deleted.
  • Rebooting: The cluster is restarting.
  • DBNodeCreating: The node is being added to the cluster.
  • DBNodeDeleting: The node is being removed from the cluster.
  • ClassChanging: The node specification is being changed.
  • NetAddressCreating: The network connection is being created.
  • NetAddressDeleting: The network connection is being deleted.
  • NetAddressModifying: The network connection is being modified.
  • Deleted: The cluster is deleted.
DBNodeClass String polar.mysql.x4.medium

The specification of the node.

DBType String MySQL

The type of the database engine.

DBVersion String 8.0

The version of the database engine.

DeletedTime String 2020-05-12T03:25:37Z

The time when the cluster was deleted.

DeletionLock Integer 0

Indicates whether the cluster is locked and can be deleted. Valid values:

  • 0: The cluster is not locked and can be deleted.
  • 1: The cluster is locked and cannot be deleted.
Engine String POLARDB

The engine of the cluster.

ExpireTime String 2019-09-14T16:00:00Z

The expiration time of the cluster.

Note Pay-as-you-go clusters do not expire.
Expired String false

Indicates whether the cluster expired.

IsDeleted Integer 1

Indicates whether the cluster was deleted. Valid values:

  • 1: deleted
  • 0: not deleted
LockMode String Unlock

The lock status of the cluster. Valid values:

  • Unlock: The cluster is not locked.
  • ManualLock: The cluster is manually locked.
  • LockByExpiration: The cluster is automatically locked after the cluster expires.
PayType String Postpaid

The billing method of the cluster. Valid values:

  • Postpaid: pay-as-you-go
  • Prepaid: subscription
RegionId String cn-hangzhou

The region ID of the cluster.

VpcId String vpc-******************

The ID of the virtual private cloud (VPC).

ZoneId String cn-hangzhou-h

The zone ID of the cluster.

PageNumber Integer 1

The page number of the returned page.

PageRecordCount Integer 1

The number of clusters that are returned on the current page.

RequestId String F8529AA2-522F-4B30-B80B-8F7D39******

The ID of the request.

TotalRecordCount Integer 1

The total number of entries returned.


Sample requests

http(s)://polardb.aliyuncs.com/? Action=DescribeDBClustersWithBackups
&<Common request parameters>

Sample success responses

XML format


JSON format

	"TotalRecordCount": 1,
	"PageRecordCount": 1,
	"RequestId": "F8529AA2-522F-4B30-B80B-8F7D39******",
	"PageNumber": 1,
	"Items": {
		"DBCluster": [
				"IsDeleted": 1,
				"ZoneId": "cn-hangzhou-h",
				"DeletedTime": "2020-05-12T03:25:37Z",
				"DBClusterStatus": "Deleted",
				"CreateTime": "2020-05-09T09:33:51Z",
				"DBClusterId": "pc-****************",
				"DBClusterDescription": "pc-****************",
				"PayType": "Postpaid",
				"DBClusterNetworkType": "VPC",
				"DBType": "MySQL",
				"LockMode": "Unlock",
				"DBNodeClass": "polar.mysql.x4.medium",
				"DBVersion": "5.6",
				"VpcId": "vpc-*****************",
				"RegionId": "cn-hangzhou",
				"Engine": "POLARDB"

Error codes

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