呼叫 DescribeDBInstances 介面查詢執行個體清單。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
polardbx:DescribeDBInstances |
get |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
執行個體所屬地域 ID。 |
cn-hangzhou |
| PageNumber |
integer |
否 |
分頁索引：從 1 開始。 |
1 |
| PageSize |
integer |
否 |
頁面大小，取值如下： |
30 |
| ResourceGroupId |
string |
否 |
資源群組 ID。 |
rg-acfmyst47****** |
| Tags |
string |
否 |
標籤清單。 |
[{\"TagKey\":\"test\",\"TagValue\":\"test-value\"}] |
| InstanceId |
string |
否 |
執行個體 ID。 |
dinga93c84f4d*** |
| Series |
string |
否 |
執行個體系列，取值如下： |
enterprise |
| MustHasCdc |
boolean |
否 |
是否必須有日誌引擎。 |
true |
| DbVersion |
string |
否 |
||
| Description |
string |
否 |
資料庫描述/備註。 |
app-test |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回資訊清單。 |
||
| RequestId |
string |
請求 ID。 |
C458B1E8-1683-3645-B154-6BA32080EEA |
| PageNumber |
integer |
頁面索引。 |
1 |
| PageSize |
integer |
頁面大小。 |
30 |
| TotalNumber |
integer |
總數。 |
30 |
| DBInstances |
array<object> |
執行個體清單。 |
|
|
array<object> |
執行個體詳細資訊。 |
||
| Type |
string |
執行個體類型： |
ReadWrite |
| Status |
string |
執行個體狀態，詳情請參見執行個體狀態表。 |
Running |
| CommodityCode |
string |
商品類型。 |
drds_polarxpre_public_cn |
| ExpireTime |
string |
過期時間。 |
2021-12-01T16:00:00.000+0000 |
| Expired |
boolean |
是否過期。 |
false |
| CreateTime |
string |
建立時間。 |
2021-11-01T03:49:50.000+0000 |
| PayType |
string |
執行個體付費方式，取值： |
Prepaid |
| LockReason |
string |
鎖定原因。 |
欠費 |
| DBType |
string |
資料庫類型。 |
polarx |
| LockMode |
string |
是否鎖定。 |
Unlock |
| VPCId |
string |
VPC ID。 |
VPCID |
| MinorVersion |
string |
目前核心版本。 |
polarx-kernel_5.4.12-16349923_xcluster-20210926 |
| RegionId |
string |
地域 ID。 |
cn-hangzhou |
| Network |
string |
網路類型。 |
VPC |
| DBVersion |
string |
資料庫版本。 |
5.7 |
| Description |
string |
資料庫描述。 |
測試 |
| NodeClass |
string |
規格。 |
polarx.x4.large.2e |
| StorageUsed |
integer |
儲存空間使用量。 |
40658534400 |
| NodeCount |
integer |
節點個數。 |
5 |
| ZoneId |
string |
可用區 ID。 |
cn-hangzhou-g |
| Engine |
string |
引擎型號。 |
polarx |
| Id |
string |
執行個體 ID。 |
pxc-hzr2yeov****** |
| Nodes |
array<object> |
節點清單。 |
|
|
object |
節點清單。 |
||
| ZoneId |
string |
可用區 ID。 |
cn-hangzhou-g |
| Id |
string |
節點 ID。 |
pxi-zd89wrzqh****** |
| RegionId |
string |
區域 ID。 |
cn-hangzhou-g-aliyun |
| ClassCode |
string |
執行個體規格。 |
polarx.x4.large.2e |
| Name |
string |
||
| ReadDBInstances |
array |
唯讀執行個體清單。 |
|
|
string |
唯讀執行個體名稱。 |
pxr-hzr2yeov****** |
|
| ColumnarReadDBInstances |
array |
列存唯讀執行個體資訊。 |
|
|
string |
列存唯讀執行個體資訊。 |
xxxxxxxx |
|
| ResourceGroupId |
string |
資源群組 ID。 |
rg-xxxxxx |
| TagSet |
array<object> |
標籤集合。 |
|
|
object |
標籤集合。 |
||
| Key |
string |
標籤名稱。 |
key1 |
| Value |
string |
標籤值。 |
value1 |
| DBInstanceName |
string |
資料庫執行個體名稱。 |
pxc-xxxxx |
| DnNodeCount |
integer |
DN 節點個數。 |
2 |
| CnNodeCount |
integer |
CN 節點個數。 |
2 |
| CnNodeClassCode |
string |
CN 節點規格。 |
polarx.x4.large.2e |
| DnNodeClassCode |
string |
DN 節點規格。 |
mysql.n4.medium.25 |
| Series |
string |
執行個體系列，取值如下： |
enterprise |
| ContainBinlogX |
boolean |
是否包含多流日誌服務，取值如下： |
true |
| SupportBinlogX |
boolean |
目前執行個體是否支援多流，取值如下： |
true |
| CdcInstanceName |
string |
日誌節點名稱。 |
pxc-c-dmlgit**** |
| TopologyType |
string |
拓撲類型： |
3azones |
| TertiaryZone |
string |
第三可用區。 |
cn-hangzhou-k |
| PrimaryZone |
string |
主可用區。 |
cn-hangzhou-j |
| SecondaryZone |
string |
次可用區。 |
cn-hangzhou-l |
| ColumnarInstanceName |
string |
列存引擎執行個體名稱。 |
xxxxxxxx |
| isInGdn |
boolean |
||
| gdnRole |
string |
||
| CpuType |
string |
||
| PrimaryInstanceId |
string |
||
| StorageType |
string |
||
| EngineVersion |
string |
樣本
正常返回樣本
JSON格式
{
"RequestId": "C458B1E8-1683-3645-B154-6BA32080EEA",
"PageNumber": 1,
"PageSize": 30,
"TotalNumber": 30,
"DBInstances": [
{
"Type": "ReadWrite",
"Status": "Running",
"CommodityCode": "drds_polarxpre_public_cn",
"ExpireTime": "2021-12-01T16:00:00.000+0000",
"Expired": false,
"CreateTime": "2021-11-01T03:49:50.000+0000",
"PayType": "Prepaid",
"LockReason": "欠費。",
"DBType": "polarx",
"LockMode": "Unlock",
"VPCId": "VPCID",
"MinorVersion": "polarx-kernel_5.4.12-16349923_xcluster-20210926",
"RegionId": "cn-hangzhou",
"Network": "VPC",
"DBVersion": "5.7",
"Description": "測試。",
"NodeClass": "polarx.x4.large.2e",
"StorageUsed": 40658534400,
"NodeCount": 5,
"ZoneId": "cn-hangzhou-g",
"Engine": "polarx",
"Id": "pxc-hzr2yeov******",
"Nodes": [
{
"ZoneId": "cn-hangzhou-g",
"Id": "pxi-zd89wrzqh******",
"RegionId": "cn-hangzhou-g-aliyun",
"ClassCode": "polarx.x4.large.2e",
"Name": ""
}
],
"ReadDBInstances": [
"pxr-hzr2yeov******"
],
"ColumnarReadDBInstances": [
"xxxxxxxx"
],
"ResourceGroupId": "rg-xxxxxx",
"TagSet": [
{
"Key": "key1",
"Value": "value1"
}
],
"DBInstanceName": "pxc-xxxxx",
"DnNodeCount": 2,
"CnNodeCount": 2,
"CnNodeClassCode": "polarx.x4.large.2e",
"DnNodeClassCode": "mysql.n4.medium.25",
"Series": "enterprise",
"ContainBinlogX": true,
"SupportBinlogX": true,
"CdcInstanceName": "pxc-c-dmlgit****",
"TopologyType": "3azones",
"TertiaryZone": "cn-hangzhou-k",
"PrimaryZone": "cn-hangzhou-j",
"SecondaryZone": "cn-hangzhou-l",
"ColumnarInstanceName": "xxxxxxxx",
"isInGdn": false,
"gdnRole": "",
"CpuType": "",
"PrimaryInstanceId": "",
"StorageType": "",
"EngineVersion": ""
}
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。