All Products
Search
Document Center

Cloud Firewall:UpdateAckClusterConnector

Last Updated:Oct 16, 2025

Updates an 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 from the following source:

ac-7c1bad6c3cc84c33baab

ConnectorName

string

No

The name of the ACK cluster connector. The name must be 1 to 64 characters in length. It can contain Chinese characters, letters, digits, periods (.), underscores (_), and hyphens (-).

ack-cluster-connector-name

Ttl

string

No

The synchronization interval for the ACK cluster connector. Valid values: 2 to 60. Unit: seconds.

30

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 from the following source:

ac-7c1bad6c3cc84c33baab

ConnectorName

string

The name of the ACK cluster connector. The name must be 1 to 64 characters in length. It 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 resources belong.

135809047715****

RegionNo

string

The region ID of the ACK cluster connector. You can obtain the ID from the following source:

Note

For more information, see ACK cluster synchronization nodes.

cn-beijing

ClusterId

string

The ID of the ACK cluster. You can obtain the ID from the following source:

c57ecf39ff32c415e8549a7df27a7e947

ClusterName

string

The name of the ACK cluster.

ack-cluster-name

VpcId

string

The ID of the VPC to which the ACK cluster belongs.

vpc-j6cvhdscntzuvr0x****

PrimaryVswitchId

string

The primary vSwitch of the ACK cluster connector. You can obtain the ID from the following source:

vsw-2zerfbbje7dvnbii2****

PrimaryVswitchZoneId

string

The zone of the primary vSwitch for the ACK cluster connector. You can obtain the zone ID from the following source:

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 from the following source:

vsw-2ze2gtlfozrab01cfo****

StandbyVswitchZoneId

string

The zone of the standby vSwitch for the ACK cluster connector. You can obtain the zone ID from the following source:

cn-beijing-h

StandbyVswitchIp

string

The IP address of the standby vSwitch for the ACK cluster connector.

10.100.2.1

Ttl

integer

The synchronization interval for the ACK cluster connector. Valid values: 2 to 60. Unit: seconds.

30

ConnectorStatus

string

The instance status of the ACK cluster connector.

Valid values:

  • init :

    Initializing

  • deleting :

    Deleting

  • ready :

    Normal

ready

ConnectorHealthCheckStatus

string

The health check status of the ACK cluster connector.

Valid values:

  • init :

    Initializing

  • healthy :

    Healthy

  • unhealthy :

    Unhealthy

healthy

CreateTime

string

The UNIX timestamp when the ACK cluster connector was created. Unit: seconds.

1724982259

RequestId

string

The request ID.

5D16AADE-DA2E-5CAB-AA3B-AA197D97****

Examples

Success response

JSON format

{
  "AckClusterConnector": {
    "ConnectorId": "ac-7c1bad6c3cc84c33baab",
    "ConnectorName": "ack-cluster-connector-name",
    "MemberUid": "135809047715****\n",
    "RegionNo": "cn-beijing",
    "ClusterId": "c57ecf39ff32c415e8549a7df27a7e947",
    "ClusterName": "ack-cluster-name",
    "VpcId": "vpc-j6cvhdscntzuvr0x****",
    "PrimaryVswitchId": "vsw-2zerfbbje7dvnbii2****",
    "PrimaryVswitchZoneId": "cn-beijing-g",
    "PrimaryVswitchIp": "10.100.1.1",
    "StandbyVswitchId": "vsw-2ze2gtlfozrab01cfo****",
    "StandbyVswitchZoneId": "cn-beijing-h",
    "StandbyVswitchIp": "10.100.2.1",
    "Ttl": 30,
    "ConnectorStatus": "ready",
    "ConnectorHealthCheckStatus": "healthy",
    "CreateTime": "1724982259"
  },
  "RequestId": "5D16AADE-DA2E-5CAB-AA3B-AA197D97****"
}

Error codes

HTTP status code

Error code

Error message

Description

200 ErrorParametersUid The aliUid is invalid. The aliUid is invalid.
400 ErrorParameters Parameters error. Parameter error.
400 ErrorDBSelect An error occurred while querying database. An error occurred while querying database.
400 ErrorDBUpdate internal error: sql updat. An error occurred while updating the database.
500 ErrorAckClusterConnectorStatusNotAllowOperate The ACK cluster connector status is not allow operate.
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.