DescribeAckClusterConnector API Reference - Cloud Firewall

Retrieves the details of a specified ACK cluster connector.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
ConnectorId	string	Yes	The ID of the ACK cluster connector. You can obtain the ID by calling the DescribeAckClusterConnectors operation to query a list of ACK cluster connectors. DescribeAckClusterConnectors: Queries a list of ACK cluster connectors.	ac-7c1bad6c3cc84c33baab
Lang	string	No	The language of the error messages that are returned for the health check status of the ACK cluster connector. Valid values: en : English zh : Chinese (default)	zh

Response elements

Element	Type	Description	Example
	object
AckClusterConnector	object	The ACK cluster connector.
ConnectorId	string	The ID of the ACK cluster connector. You can obtain the ID by calling the DescribeAckClusterConnectors operation to query a list of ACK cluster connectors. DescribeAckClusterConnectors: Queries a list of ACK cluster connectors.	ac-7c1bad6c3cc84c33baab
ConnectorName	string	The name of the ACK cluster connector. The name must be 1 to 64 characters in length and can contain Chinese characters, letters, digits, periods (.), underscores (_), and hyphens (-).	ack-cluster-connector-name
MemberUid	string	The UID of the Alibaba Cloud account to which the ACK cluster resource belongs.	135809047715****
RegionNo	string	The region ID of the ACK cluster connector. You can obtain the ID by calling the DescribeAccessInstanceRegionList operation to query a list of regions for synchronization nodes. DescribeAccessInstanceRegionList: Queries the list of regions for sync nodes. Note For more information about the regions where Cloud Firewall supports ACK cluster connectors, see ACK cluster synchronization nodes.	cn-beijing
ClusterId	string	The ID of the ACK cluster. You can obtain the ID by calling the DescribeAckClusters operation to query a list of ACK clusters. DescribeAckClusters: Queries a list of ACK clusters.	c857d908016794125883a9ee8196cba17
ClusterName	string	The name of the ACK cluster.	ack-cluster-name
VpcId	string	The ID of the VPC instance to which the ACK cluster belongs.	vpc-j6cvhdscntzuvr0x****
Ttl	integer	The synchronization interval of the ACK cluster connector. Valid values: 2 to 60. Unit: seconds.	30
PrimaryVswitchId	string	The primary vSwitch of the ACK cluster connector. You can obtain the ID by calling the DescribeAccessInstanceVSwitchList operation to query a list of vSwitches for synchronization nodes. DescribeAccessInstanceVSwitchList: Queries one or more vSwitches of synchronization nodes.	vsw-2zerfbbje7dvnbii2****
PrimaryVswitchZoneId	string	The zone of the primary vSwitch for the ACK cluster connector. You can obtain the zone ID by calling the DescribeAccessInstanceZoneList operation to query a list of zones for synchronization nodes. DescribeAccessInstanceZoneList: Queries the list of zones for the vSwitches of sync nodes in a batch.	cn-beijing-g
PrimaryVswitchIp	string	The IP address of the primary vSwitch for the ACK cluster connector.	10.100.1.1
StandbyVswitchId	string	The standby vSwitch of the ACK cluster connector. You can obtain the ID by calling the DescribeAccessInstanceVSwitchList operation to query a list of vSwitches for synchronization nodes. DescribeAccessInstanceVSwitchList: Batch queries the list of vSwitches for sync nodes.	vsw-2ze2gtlfozrab01cfo****
StandbyVswitchZoneId	string	The zone of the standby vSwitch for the ACK cluster connector. You can obtain the zone ID by calling the DescribeAccessInstanceZoneList operation to query a list of zones for synchronization nodes. DescribeAccessInstanceZoneList: Batch queries the list of zones for sync node vSwitches.	cn-beijing-h
StandbyVswitchIp	string	The IP address of the standby vSwitch for the ACK cluster connector.	10.100.2.1
ConnectorStatus	string	The instance status of the ACK cluster connector. Valid values: init : Initialization deleting : Deleting ready : Normal	ready
ConnectorHealthCheckStatus	string	The health check status of the ACK cluster connector. Valid values: init : Initialization healthy : Healthy unhealthy : Unhealthy	healthy
UnhealthyReason	string	The reason why the ACK cluster connector is unhealthy.	The ACK cluster status is unavailable.
CreateTime	string	The UNIX timestamp when the ACK cluster connector was created. Unit: seconds.	1724982259
RequestId	string	The request ID.	45E2E720-D2B4-506F-B682-1FCBE971****

Examples

Success response

JSON format

{
  "AckClusterConnector": {
    "ConnectorId": "ac-7c1bad6c3cc84c33baab",
    "ConnectorName": "ack-cluster-connector-name",
    "MemberUid": "135809047715****\n",
    "RegionNo": "cn-beijing",
    "ClusterId": "c857d908016794125883a9ee8196cba17",
    "ClusterName": "ack-cluster-name",
    "VpcId": "vpc-j6cvhdscntzuvr0x****",
    "Ttl": 30,
    "PrimaryVswitchId": "vsw-2zerfbbje7dvnbii2****",
    "PrimaryVswitchZoneId": "cn-beijing-g",
    "PrimaryVswitchIp": "10.100.1.1",
    "StandbyVswitchId": "vsw-2ze2gtlfozrab01cfo****",
    "StandbyVswitchZoneId": "cn-beijing-h",
    "StandbyVswitchIp": "10.100.2.1",
    "ConnectorStatus": "ready",
    "ConnectorHealthCheckStatus": "healthy",
    "UnhealthyReason": "The ACK cluster status is unavailable.",
    "CreateTime": "1724982259"
  },
  "RequestId": "45E2E720-D2B4-506F-B682-1FCBE971****"
}

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	ErrorDBSelect	An error occurred while querying database.	An error occurred while querying database.
404	ErrorAckClusterConnectorNotFound	The specified resource ACK cluster connector is not found.	The specified resource ACK cluster connector is not found.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.