批量查询ACK集群连接器列表。
接口说明
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| PageNo |
string |
是 |
页码。 |
1 |
| PageSize |
string |
是 |
每页大小。 |
10 |
| MemberUid |
string |
否 |
当前阿里云账号的成员账号 UID。 |
135809047715**** |
| RegionNo |
string |
否 |
ACK 集群连接器地域 ID。取值来源：
说明
关于云防火墙支持 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 集群连接器名称。 |
ack-cluster-connector-name |
| MemberUid |
string |
阿里云成员账号的 UID。 |
159663371500**** |
| RegionNo |
string |
地域 ID。 |
cn-shanghai |
| ClusterId |
string |
ACK 集群 ID。 |
f9b9815a5280**** |
| ClusterName |
string |
ACK 集群名称。 |
TestClusterA |
| VpcId |
string |
ACK 集群所属 VPC 实例 ID。 |
vpc-j6cvhdscntzuvr0x**** |
| PrimaryVswitchId |
string |
主交换机。 |
vsw-2ze2gtlfozrab01cfo**** |
| PrimaryVswitchZoneId |
string |
主交换机可用区。 |
cn-beijing-g |
| PrimaryVswitchIp |
string |
主交换机 IP。 |
10.100.2.XXX |
| StandbyVswitchId |
string |
备交换机。 |
vsw-2zerfbbje7dvnbii2**** |
| StandbyVswitchZoneId |
string |
备交换机可用区。 |
cn-beijing-h |
| StandbyVswitchIp |
string |
备交换机 IP。 |
10.100.1.XXX |
| Ttl |
integer |
ACK 集群连接器同步容器周期。 |
30 |
| ConnectorStatus |
string |
ACK 集群连接器实例状态。 枚举值：
|
ready |
| ConnectorHealthCheckStatus |
string |
ACK 集群连接器的健康检查状态。 枚举值：
|
healthy |
| UnhealthyReason |
string |
ACK 集群连接器不健康的原因。 |
指定的ACK集群不存在 |
| 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": "指定的ACK集群不存在",
"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. | 内部错误：数据库查询错误 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。