Queries the detailed attributes of a PolarDB cluster.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeDBClusterAttribute | The action that you want to perform. Set the value to DescribeDBClusterAttribute. |
DBClusterId | String | Yes | pc-***************** | The ID of the cluster. Note You can call the DescribeDBClusters operation to query the details of the clusters that belong to your Alibaba Cloud account, such as cluster IDs. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
DeletionLock | Integer | 0 | Indicates whether the cluster is locked and can be deleted. Valid values:
|
Category | String | Normal | The edition of PolarDB. Valid values:
Note
|
ResourceGroupId | String | rg-*************** | The ID of the resource group. |
DataLevel1BackupChainSize | Long | 74448896 | The total physical storage of level-1 backups (snapshots). Unit: bytes. |
DBClusterId | String | pc-***************** | The ID of the cluster. |
DBType | String | MySQL | The type of the engine. |
DBClusterNetworkType | String | VPC | The network type of the cluster. |
IsLatestVersion | Boolean | false | Indicates whether the kernel is of the latest version. Valid values:
|
StorageMax | Long | 10995116277760 | The maximum storage capacity of the current cluster specification. Unit: bytes. |
DBVersion | String | 8.0 | The version of the engine. |
DBNodes | Array of DBNode | Details about the nodes. | |
CreationTime | String | 2020-03-23T21:35:43Z | The time when the node was created. |
FailoverPriority | Integer | 1 | The failover priority. Each node is assigned a failover priority. If a failover occurs, a node can be selected as a primary node. The priority determines the probability at which a node is selected as a primary node. A larger value indicates a higher priority. Valid values: 1 to 15. |
MaxIOPS | Integer | 32000 | The maximum IOPS. |
DBNodeClass | String | polar.mysql.x4.large | The specifications of the node. |
DBNodeRole | String | Reader | The role of the node. Valid values:
|
ZoneId | String | cn-hangzhou-i | The zone ID of the cluster. |
MaxConnections | Integer | 8000 | The maximum number of concurrent connections in the cluster. |
DBNodeStatus | String | Running | The status of the node. Valid values:
|
DBNodeId | String | pi-**************** | The ID of the node. |
ImciSwitch | String | ON | Indicates whether the In-Memory Column Index (IMCI) feature is enabled. Valid values:
|
HotReplicaMode | String | ON | Indicates whether the hot standby feature is enabled. Valid values:
|
AddedCpuCores | String | 6 | The number of CPU cores for compute node scale-out within seconds. |
MasterId | String | pi-bp18z52akld3***** | The ID of the primary node in the Multi-master Cluster Edition cluster. |
SccMode | String | ON | Indicates whether the SCC feature is enabled for the node. Valid values:
|
ServerWeight | String | 1 | The routing weight of the node. Valid values: 1 to 100. Default value: 1. |
ZoneIds | String | cn-hangzhou-i,cn-hangzhou-g | The zone ID of the cluster. |
MaintainTime | String | 18:00Z-19:00Z | The maintenance window of the cluster. The format is |
Engine | String | POLARDB | The database type. |
Tags | Array of Tag | The details of the tag. | |
Key | String | test | A tag key. |
Value | String | MySQL | The value of the tag that you want to create for the cluster. |
RequestId | String | 074467EF-86B9-4C23-ACBF-E9B81A****** | The ID of the request. |
VPCId | String | vpc-******************* | The VPC ID of the cluster. |
DBClusterStatus | String | Running | The state of the clusters that you want to query. For information about valid values, see Cluster status. |
VSwitchId | String | vsw-********************* | The vSwitch ID of the cluster. |
DBClusterDescription | String | test | The description of the cluster. |
Expired | String | false | Indicates whether the cluster has expired. Valid values: Note This parameter is returned only for clusters that use the subscription billing method. |
PayType | String | Prepaid | The billing method of the cluster. Valid values:
|
StoragePayType | String | Prepaid | The billing method of the storage. Valid values:
|
LockMode | String | Unlock | The lock mode. Valid values:
|
StorageUsed | Long | 3012558848 | The storage space consumed by the cluster. Unit: bytes. |
StorageSpace | Long | 50 | The storage space that uses the subscription billing method. Unit: GB. |
DBVersionStatus | String | Stable | The status of the minor version. Valid values:
Note For more information about how to upgrade the minor version, see Upgrade versions. |
CreationTime | String | 2020-08-14T05:58:42Z | The time when the cluster was created. |
SQLSize | Long | 0 | The storage of SQL. Unit: bytes. If the value is -1, no data is stored. |
InodeTotal | Long | 6,291,456 | Maximum inodes in file system. |
InodeUsed | Long | 4,194,304 | The current inode usage. |
BlktagTotal | Long | 7,864,320 | Maximum blktags in file system. |
BlktagUsed | Long | 5,242,880 | The current blktag usage. |
RegionId | String | cn-hangzhou | The region ID of the cluster. |
ExpireTime | String | 2020-11-14T16:00:00Z | The time when the cluster expires. Note Expiration time is returned only for clusters that use the subscription billing method. An empty string is returned for clusters that use the pay-as-you-go billing method. |
SubCategory | String | Exclusive | The specification type of the compute node. Valid values:
Note This parameter is returned for only PolarDB for MySQL clusters of Cluster Edition. |
IsProxyLatestVersion | Boolean | false | Indicates whether PolarProxy uses the latest version. Valid values:
|
StorageType | String | HighPerformance | The storage type. Set the value to HighPerformance. |
ServerlessType | String | AgileServerless | The type of the serverless cluster. Set the value to AgileServerless. |
ProxyCpuCores | String | 4 | The number of CPU cores for PolarProxy. |
ProxyStandardCpuCores | String | 2 | The number of CPU cores for PolarProxy Standard Enterprise Edition. |
ProxyType | String | Exclusive | The type of PolarProxy. Valid values:
|
ProxyStatus | String | Running | The status of PolarProxy. Valid values:
|
Examples
Sample requests
http(s)://polardb.aliyuncs.com/?Action=DescribeDBClusterAttribute
&DBClusterId=pc-*****************
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeDBClusterAttributeResponse>
<DeletionLock>0</DeletionLock>
<Category>Normal</Category>
<ResourceGroupId>rg-***************</ResourceGroupId>
<DataLevel1BackupChainSize>74448896</DataLevel1BackupChainSize>
<DBClusterId>pc-*****************</DBClusterId>
<DBType>MySQL</DBType>
<DBClusterNetworkType>VPC</DBClusterNetworkType>
<IsLatestVersion>false</IsLatestVersion>
<StorageMax>10995116277760</StorageMax>
<DBVersion>8.0</DBVersion>
<DBNodes>
<CreationTime>2020-03-23T21:35:43Z</CreationTime>
<FailoverPriority>1</FailoverPriority>
<MaxIOPS>32000</MaxIOPS>
<DBNodeClass>polar.mysql.x4.large</DBNodeClass>
<DBNodeRole>Reader</DBNodeRole>
<ZoneId>cn-hangzhou-i</ZoneId>
<MaxConnections>8000</MaxConnections>
<DBNodeStatus>Running</DBNodeStatus>
<DBNodeId>pi-****************</DBNodeId>
<ImciSwitch>ON</ImciSwitch>
<HotReplicaMode>ON</HotReplicaMode>
<AddedCpuCores>6</AddedCpuCores>
<MasterId>pi-bp18z52akld3*****</MasterId>
<SccMode>ON</SccMode>
<ServerWeight>1</ServerWeight>
</DBNodes>
<ZoneIds>cn-hangzhou-i,cn-hangzhou-g</ZoneIds>
<MaintainTime>18:00Z-19:00Z</MaintainTime>
<Engine>POLARDB</Engine>
<Tags>
<Key>test</Key>
<Value>MySQL</Value>
</Tags>
<RequestId>074467EF-86B9-4C23-ACBF-E9B81A******</RequestId>
<VPCId>vpc-*******************</VPCId>
<DBClusterStatus>Running</DBClusterStatus>
<VSwitchId>vsw-*********************</VSwitchId>
<DBClusterDescription>test</DBClusterDescription>
<Expired>false</Expired>
<PayType>Prepaid</PayType>
<StoragePayType>Prepaid</StoragePayType>
<LockMode>Unlock</LockMode>
<StorageUsed>3012558848</StorageUsed>
<StorageSpace>50</StorageSpace>
<DBVersionStatus>Stable</DBVersionStatus>
<CreationTime>2020-08-14T05:58:42Z</CreationTime>
<SQLSize>0</SQLSize>
<RegionId>cn-hangzhou</RegionId>
<ExpireTime>2020-11-14T16:00:00Z</ExpireTime>
<SubCategory>Exclusive</SubCategory>
<IsProxyLatestVersion>false</IsProxyLatestVersion>
<StorageType>HighPerformance</StorageType>
<ServerlessType>AgileServerless</ServerlessType>
<ProxyCpuCores>4</ProxyCpuCores>
<ProxyStandardCpuCores>2</ProxyStandardCpuCores>
<ProxyType>Exclusive</ProxyType>
<ProxyStatus>Running</ProxyStatus>
</DescribeDBClusterAttributeResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"DeletionLock" : 0,
"Category" : "Normal",
"ResourceGroupId" : "rg-***************",
"DataLevel1BackupChainSize" : 74448896,
"DBClusterId" : "pc-*****************",
"DBType" : "MySQL",
"DBClusterNetworkType" : "VPC",
"IsLatestVersion" : false,
"StorageMax" : 10995116277760,
"DBVersion" : "8.0",
"DBNodes" : [ {
"CreationTime" : "2020-03-23T21:35:43Z",
"FailoverPriority" : 1,
"MaxIOPS" : 32000,
"DBNodeClass" : "polar.mysql.x4.large",
"DBNodeRole" : "Reader",
"ZoneId" : "cn-hangzhou-i",
"MaxConnections" : 8000,
"DBNodeStatus" : "Running",
"DBNodeId" : "pi-****************",
"ImciSwitch" : "ON",
"HotReplicaMode" : "ON",
"AddedCpuCores" : "6",
"MasterId" : "pi-bp18z52akld3*****",
"SccMode" : "ON",
"ServerWeight" : "1"
} ],
"ZoneIds" : "cn-hangzhou-i,cn-hangzhou-g",
"MaintainTime" : "18:00Z-19:00Z",
"Engine" : "POLARDB",
"Tags" : [ {
"Key" : "test",
"Value" : "MySQL"
} ],
"RequestId" : "074467EF-86B9-4C23-ACBF-E9B81A******",
"VPCId" : "vpc-*******************",
"DBClusterStatus" : "Running",
"VSwitchId" : "vsw-*********************",
"DBClusterDescription" : "test",
"Expired" : "false",
"PayType" : "Prepaid",
"StoragePayType" : "Prepaid",
"LockMode" : "Unlock",
"StorageUsed" : 3012558848,
"StorageSpace" : 50,
"DBVersionStatus" : "Stable",
"CreationTime" : "2020-08-14T05:58:42Z",
"SQLSize" : 0,
"RegionId" : "cn-hangzhou",
"ExpireTime" : "2020-11-14T16:00:00Z",
"SubCategory" : "Exclusive",
"IsProxyLatestVersion" : false,
"StorageType" : "HighPerformance",
"ServerlessType" : "AgileServerless",
"ProxyCpuCores" : "4",
"ProxyStandardCpuCores" : "2",
"ProxyType" : "Exclusive",
"ProxyStatus" : "Running"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | The error message returned because the specified DBClusterId is invalid. |
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | The error message returned because the specified cluster ID does not exist in the current record. |
For a list of error codes, see Service error codes.