批量查詢ACK叢集連接器列表。
介面說明
QPS 限制
本介面的單使用者 QPS 限制為 10 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| PageNo |
string |
是 |
頁碼。 |
1 |
| PageSize |
string |
是 |
每頁大小。 |
10 |
| MemberUid |
string |
否 |
ACK 叢集資源所屬的阿里雲 UID。 |
135809047715**** |
| RegionNo |
string |
否 |
ACK 叢集連接器地區 ID。取值來源：
說明
關於Cloud Firewall支援 ACK 叢集連接器地區的詳細資料，請參見 ACK 叢集同步節點。 |
cn-shenzhen |
| ConnectorName |
string |
否 |
ACK 叢集連接器名稱。 |
test |
| VpcId |
string |
否 |
ACK 叢集所屬的 VPC 執行個體 ID。 |
vpc-uf6b5lyul0x****** |
| ClusterId |
string |
否 |
ACK 叢集 ID。 |
0E0C30C977463**** |
| Lang |
string |
否 |
顯示 ACK 叢集連接器健康狀態錯誤原因的語言類型。 枚舉值：
|
zh |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| PageNo |
integer |
頁碼。 |
1 |
| AckClusterConnectors |
array<object> |
ACK 叢集連接器列表。 |
|
|
object |
ACK 叢集連接器。 |
||
| ConnectorId |
string |
ACK 叢集連接器 ID。 |
ac-7c1bad6c3cc84c33baab |
| ConnectorName |
string |
ACK 叢集連接器名稱。長度為 1~64 個字元，支援中文和大小寫英文字母，可包含數字、半形句號（.）、底線（_）和短劃線（-）。 |
ack-cluster-connector-name |
| MemberUid |
string |
ACK 叢集資源所屬的阿里雲 UID。 |
159663371500**** |
| RegionNo |
string |
ACK 叢集連接器地區 ID。取值來源：
說明
關於Cloud Firewall支援 ACK 叢集連接器地區的詳細資料，請參見 ACK 叢集同步節點。 |
cn-shanghai |
| ClusterId |
string |
ACK 叢集 ID。取值來源：
|
f9b9815a5280**** |
| ClusterName |
string |
ACK 叢集名稱。 |
TestClusterA |
| VpcId |
string |
ACK 叢集所屬 VPC 執行個體 ID。 |
vpc-j6cvhdscntzuvr0x**** |
| PrimaryVswitchId |
string |
ACK 叢集連接器主交換器。取值來源：
|
vsw-2ze2gtlfozrab01cfo**** |
| PrimaryVswitchZoneId |
string |
ACK 叢集連接器主交換器可用性區域。取值來源：
|
cn-beijing-g |
| PrimaryVswitchIp |
string |
ACK 叢集連接器主交換器 IP。 |
10.100.2.XXX |
| StandbyVswitchId |
string |
ACK 叢集連接器備交換器。取值來源：
|
vsw-2zerfbbje7dvnbii2**** |
| StandbyVswitchZoneId |
string |
ACK 叢集連接器備交換器可用性區域。取值來源：
|
cn-beijing-h |
| StandbyVswitchIp |
string |
ACK 叢集連接器備交換器 IP。 |
10.100.1.XXX |
| Ttl |
integer |
ACK 叢集連接器同步容器周期。 |
30 |
| ConnectorStatus |
string |
ACK 叢集連接器執行個體狀態。 枚舉值：
|
ready |
| ConnectorHealthCheckStatus |
string |
ACK 叢集連接器的健全狀態檢查狀態。 枚舉值：
|
healthy |
| UnhealthyReason |
string |
ACK 叢集連接器不健康的原因。 |
The ACK cluster status is unavailable. |
| GroupUuids |
array |
建立於 ACK 叢集連接器的地址簿 UUID 清單。 |
|
|
string |
建立於 ACK 叢集連接器的地址簿 UUID。 |
["b84dec36-c4fc-458e-98b8-f1b5dd23****","8015d9eb-8382-4388-b965-b92d806d****"] |
|
| CreateTime |
string |
建立 ACK 叢集連接器的時間戳記，單位：秒。 |
1760493347 |
| PageSize |
integer |
每頁大小。 |
10 |
| RequestId |
string |
請求 ID。 |
E7F333E0-7B70-54DA-A307-4B2B49DE**** |
| TotalCount |
integer |
總數。 |
20 |
樣本
正常返回樣本
JSON格式
{
"PageNo": 1,
"AckClusterConnectors": [
{
"ConnectorId": "ac-7c1bad6c3cc84c33baab",
"ConnectorName": "ack-cluster-connector-name",
"MemberUid": "159663371500****",
"RegionNo": "cn-shanghai",
"ClusterId": "f9b9815a5280****",
"ClusterName": "TestClusterA",
"VpcId": "vpc-j6cvhdscntzuvr0x****",
"PrimaryVswitchId": "vsw-2ze2gtlfozrab01cfo****",
"PrimaryVswitchZoneId": "cn-beijing-g",
"PrimaryVswitchIp": "10.100.2.XXX",
"StandbyVswitchId": "vsw-2zerfbbje7dvnbii2****",
"StandbyVswitchZoneId": "cn-beijing-h",
"StandbyVswitchIp": "10.100.1.XXX\n",
"Ttl": 30,
"ConnectorStatus": "ready",
"ConnectorHealthCheckStatus": "healthy",
"UnhealthyReason": "The ACK cluster status is unavailable.",
"GroupUuids": [
"[\"b84dec36-c4fc-458e-98b8-f1b5dd23****\",\"8015d9eb-8382-4388-b965-b92d806d****\"]"
],
"CreateTime": "1760493347"
}
],
"PageSize": 10,
"RequestId": "E7F333E0-7B70-54DA-A307-4B2B49DE****",
"TotalCount": 20
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | ErrorParametersUid | The aliUid parameter is invalid. | aliUid 不合法 |
| 400 | ErrorParameters | Parameters error. | 參數錯誤。 |
| 400 | ErrorRegionNo | regionNo error. | 地區選擇錯誤， 請重新輸入。 |
| 400 | ErrorDBSelect | An error occurred while querying database. | 內部錯誤：資料庫查詢錯誤 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。