Queries a list of ACK cluster connectors.
Operation description
QPS Limits
The queries per second (QPS) limit for a single user is 10 calls per second. Calls that exceed this limit are throttled. Throttling may affect your business. Call this API at a reasonable rate.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| PageNo |
string |
Yes |
The page number. |
1 |
| PageSize |
string |
Yes |
The number of entries per page. |
10 |
| MemberUid |
string |
No |
The UID of the member account. |
135809047715**** |
| RegionNo |
string |
No |
The region ID of the ACK cluster connector.
Note
For more information about the regions that Cloud Firewall supports for ACK cluster connectors, see ACK cluster synchronization nodes. |
cn-shenzhen |
| ConnectorName |
string |
No |
The name of the ACK cluster connector. |
test |
| VpcId |
string |
No |
The ID of the VPC to which the ACK cluster belongs. |
vpc-uf6b5lyul0x****** |
| ClusterId |
string |
No |
The ID of the ACK cluster. |
0E0C30C977463**** |
| Lang |
string |
No |
The language of the response message that is returned if the ACK cluster connector is unhealthy. Valid values:
|
zh |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| PageNo |
integer |
The page number. |
1 |
| AckClusterConnectors |
array<object> |
The list of ACK cluster connectors. |
|
|
object |
The ACK cluster connector. |
||
| ConnectorId |
string |
The ID of the ACK cluster connector. |
ac-7c1bad6c3cc84c33baab |
| ConnectorName |
string |
The name of the ACK cluster connector. |
ack-cluster-connector-name |
| MemberUid |
string |
The UID of the Alibaba Cloud member account. |
159663371500**** |
| RegionNo |
string |
The region ID. |
cn-shanghai |
| ClusterId |
string |
The ID of the ACK cluster. |
f9b9815a5280**** |
| ClusterName |
string |
The name of the ACK cluster. |
TestClusterA |
| VpcId |
string |
The ID of the VPC to which the ACK cluster belongs. |
vpc-j6cvhdscntzuvr0x**** |
| PrimaryVswitchId |
string |
The primary vSwitch. |
vsw-2ze2gtlfozrab01cfo**** |
| PrimaryVswitchZoneId |
string |
The zone of the primary vSwitch. |
cn-beijing-g |
| PrimaryVswitchIp |
string |
The IP address of the primary vSwitch. |
10.100.2.XXX |
| StandbyVswitchId |
string |
The standby vSwitch. |
vsw-2zerfbbje7dvnbii2**** |
| StandbyVswitchZoneId |
string |
The zone of the standby vSwitch. |
cn-beijing-h |
| StandbyVswitchIp |
string |
The IP address of the standby vSwitch. |
10.100.1.XXX |
| Ttl |
integer |
The synchronization interval for the ACK cluster connector container. |
30 |
| ConnectorStatus |
string |
The status of the ACK cluster connector. Valid values:
|
ready |
| ConnectorHealthCheckStatus |
string |
The health check status of the ACK cluster connector. Valid values:
|
healthy |
| UnhealthyReason |
string |
The reason why the ACK cluster connector is unhealthy. |
指定的ACK集群不存在 |
| GroupUuids |
array |
The UUIDs of the address books that are created for the ACK cluster connector. |
|
|
string |
The UUID of an address book that is created for the ACK cluster connector. |
["b84dec36-c4fc-458e-98b8-f1b5dd23****","8015d9eb-8382-4388-b965-b92d806d****"] |
|
| CreateTime |
string |
The time when the ACK cluster connector was created. |
1760493347 |
| PageSize |
integer |
The number of entries per page. |
10 |
| RequestId |
string |
The request ID. |
E7F333E0-7B70-54DA-A307-4B2B49DE**** |
| TotalCount |
integer |
The total number of entries. |
20 |
Examples
Success response
JSON format
{
"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": "指定的ACK集群不存在",
"GroupUuids": [
"[\"b84dec36-c4fc-458e-98b8-f1b5dd23****\",\"8015d9eb-8382-4388-b965-b92d806d****\"]"
],
"CreateTime": "1760493347"
}
],
"PageSize": 10,
"RequestId": "E7F333E0-7B70-54DA-A307-4B2B49DE****",
"TotalCount": 20
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ErrorParametersUid | The aliUid parameter is invalid. | The aliUid parameter is invalid. |
| 400 | ErrorParameters | Parameters error. | Parameter error. |
| 400 | ErrorRegionNo | regionNo error. | Region selection error, please re-enter. |
| 400 | ErrorDBSelect | An error occurred while querying database. | An error occurred while querying database. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.