Queries the information about a Global Database Network (GDN).
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
GDNId | string | Yes | The ID of the GDN. | gdn-bp1fttxsrmv***** |
ResourceGroupId | string | No | The ID of the resource group. | rg-************ |
Response parameters
Examples
Sample success responses
JSON
format
{
"GDNStatus": "active",
"Connections": [
{
"ConnectionString": "abc.polardb.rds.aliyuncs.com",
"NetType": "Private",
"Port": "3306"
}
],
"DBVersion": "8.0",
"RequestId": "67F2E75F-AE67-4FB2-821F-A81237EACD15",
"GDNId": "gdn-bp1fttxsrmv*****",
"CreateTime": "2020-02-24T11:57:54Z",
"DBType": "MySQL",
"GDNDescription": "GDN-fortest",
"DBClusters": [
{
"ReplicaLag": "1",
"ExpireTime": "2020-11-14T16:00:00Z",
"Expired": "false",
"DBNodeClass": "polar.mysql.x4.large",
"PayType": "Prepaid",
"DBType": "MySQL",
"RegionId": "cn-hangzhou",
"DBVersion": "8.0",
"DBClusterId": "pc-wz9fb5nn44u1d****",
"DBClusterStatus": "Running",
"StorageUsed": "3012558848",
"DBClusterDescription": "test",
"Role": "primary",
"ServerlessType": "AgileServerless",
"DBNodes": [
{
"DBNodeClass": "polar.mysql.x4.large",
"ZoneId": "cn-hangzhou-i",
"CreationTime": "2020-03-23T21:35:43Z",
"DBNodeRole": "Reader",
"DBNodeStatus": "Running",
"FailoverPriority": 1,
"MaxConnections": 8000,
"MaxIOPS": 32000,
"DBNodeId": "pi-****************"
}
]
}
],
"DBClusterId": "pc-bp1s826a1up******",
"ResourceGroupId": "rg-************"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | GDN.NotFound | Failed to found GdnInstance by name:%s | Failed to find cluster %s by GDN name. |
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | The specified DBClusterId parameter does not exist in the current record. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-01-24 | The Error code has changed. The response structure of the API has changed | View Change Details |
2021-06-21 | Add Operation | View Change Details |