All Products
Search

This Product

    Cloud Firewall:UpdateAckClusterConnector

    Document Center

    Cloud Firewall:UpdateAckClusterConnector

    Last Updated:Jan 14, 2026

    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 call the DescribeAckClusterConnectors operation to query the list of ACK cluster connectors.

    ac-7c1bad6c3cc84c33baab
    ConnectorName

    string

    No

    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
    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 call the DescribeAckClusterConnectors operation to query the 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 Alibaba Cloud account ID (UID) of the account to which the ACK cluster resources belong.

    135809047715****

    RegionNo

    string

    The region ID of the ACK cluster connector. You can call the DescribeAccessInstanceRegionList operation to query the list of regions for synchronization nodes.

    Note

    For more information about the regions that Cloud Firewall supports for ACK cluster connectors, see ACK cluster synchronization nodes.

    cn-beijing
    ClusterId

    string

    The ID of the ACK cluster. You can call the DescribeAckClusters operation to query the list of ACK clusters.

    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 call the DescribeAccessInstanceVSwitchList operation to query the list of vSwitches for synchronization nodes.

    vsw-2zerfbbje7dvnbii2****
    PrimaryVswitchZoneId

    string

    The zone of the primary vSwitch for the ACK cluster connector. You can call the DescribeAccessInstanceZoneList operation to query the list of zones for synchronization nodes.

    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 call the DescribeAccessInstanceVSwitchList operation to query the list of vSwitches for synchronization nodes.

    vsw-2ze2gtlfozrab01cfo****
    StandbyVswitchZoneId

    string

    The zone of the standby vSwitch for the ACK cluster connector. You can call the DescribeAccessInstanceZoneList operation to query the list of zones for synchronization nodes.

    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 :

      The connector is being initialized.

    • deleting :

      The connector is being deleted.

    • ready :

      Normal.

    ready
    ConnectorHealthCheckStatus

    string

    The health check status of the ACK cluster connector.

    Valid values:

    • init :

      The connector is being initialized.

    • 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.
    400 ErrorAckClusterConnectorStatusNotAllowOperate The ACK cluster connector status is not allow operate. 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.