创建ACK集群连接器。
接口说明
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| MemberUid |
string |
否 |
ACK 集群资源所属的阿里云 UID。 |
135809047715**** |
| RegionNo |
string |
是 |
ACK 集群连接器地域 ID。取值来源：
说明
关于云防火墙支持 ACK 集群连接器地域的详细信息，请参见 ACK 集群同步节点。 |
cn-hangzhou |
| ConnectorName |
string |
是 |
ACK 集群连接器名称。长度为 1~64 个字符，支持中文和大小写英文字母，可包含数字、半角句号（.）、下划线（_）和短划线（-）。 |
ack-cluster-connector-name |
| ClusterId |
string |
是 |
ACK 集群 ID。取值来源：
|
cb0f5640b1b2d404cad6ba21509d7847b |
| PrimaryVswitchId |
string |
是 |
ACK 集群连接器主交换机。取值来源：
|
vsw-2zerfbbje7dvnbii2**** |
| PrimaryVswitchIp |
string |
否 |
ACK 集群连接器主交换机 IP。 |
10.100.1.1 |
| StandbyVswitchId |
string |
否 |
ACK 集群连接器备交换机。取值来源：
|
vsw-2ze2gtlfozrab01cfo**** |
| StandbyVswitchIp |
string |
否 |
ACK 集群连接器备交换机 IP。 |
10.100.2.1 |
| Ttl |
string |
是 |
ACK 集群连接器同步周期间隔。范围：2~60 秒。 |
30 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AckClusterConnector |
object |
ACK 集群连接器返回体。 |
|
| ConnectorId |
string |
ACK 集群连接器唯一标识 ID。 |
ac-7c1bad6c3cc84c33baab |
| ConnectorName |
string |
ACK 集群连接器名称。长度为 1~64 个字符，支持中文和大小写英文字母，可包含数字、半角句号（.）、下划线（_）和短划线（-）。 |
ack-cluster-connector-name |
| MemberUid |
string |
ACK 集群资源所属的阿里云 UID。 |
135809047715**** |
| RegionNo |
string |
ACK 集群连接器地域 ID。取值来源：
说明
关于云防火墙支持 ACK 集群连接器地域的详细信息，请参见 ACK 集群同步节点。 |
cn-shanghai |
| ClusterId |
string |
ACK 集群 ID。取值来源：
|
cb0f5640b1b2d404cad6ba21509d7847b |
| ClusterName |
string |
ACK 集群名称。 |
ack-cluster-name |
| VpcId |
string |
ACK 集群所属 VPC 实例 ID。 |
vpc-j6cvhdscntzuvr0x**** |
| PrimaryVswitchId |
string |
ACK 集群连接器主交换机。取值来源：
|
vsw-2zerfbbje7dvnbii2**** |
| PrimaryVswitchZoneId |
string |
ACK 集群连接器主交换机可用区。取值来源：
|
cn-hangzhou-g |
| PrimaryVswitchIp |
string |
ACK 集群连接器主交换机 IP。 |
10.100.1.1 |
| StandbyVswitchId |
string |
ACK 集群连接器备交换机。取值来源：
|
vsw-2ze2gtlfozrab01cfo**** |
| StandbyVswitchZoneId |
string |
ACK 集群连接器备交换机可用区。取值来源：
|
cn-hangzhou-h |
| StandbyVswitchIp |
string |
ACK 集群连接器备交换机 IP。 |
10.100.2.1 |
| Ttl |
integer |
ACK 集群连接器同步周期间隔。范围：2~60 秒。 |
30 |
| ConnectorStatus |
string |
ACK 集群连接器实例状态。 枚举值：
|
ready |
| ConnectorHealthCheckStatus |
string |
ACK 集群连接器的健康检查状态。 枚举值：
|
healthy |
| AckClientHostIp |
string |
ACK 集群连接器，通过内网访问 ACK 集群的上车点 IP。 |
10.40.32.240 |
| TaskId |
string |
创建 ACK 集群连接器的任务唯一标识 ID。 |
task-c92d4544ef7b6a42 |
| CreateTime |
string |
创建 ACK 集群连接器的时间戳，单位：秒。 |
1724982259 |
| RequestId |
string |
请求 ID。 |
0DC783F1-B3A7-578D-8A63-***** |
示例
正常返回示例
JSON格式
{
"AckClusterConnector": {
"ConnectorId": "ac-7c1bad6c3cc84c33baab",
"ConnectorName": "ack-cluster-connector-name",
"MemberUid": "135809047715****",
"RegionNo": "cn-shanghai",
"ClusterId": "cb0f5640b1b2d404cad6ba21509d7847b",
"ClusterName": "ack-cluster-name",
"VpcId": "vpc-j6cvhdscntzuvr0x****",
"PrimaryVswitchId": "vsw-2zerfbbje7dvnbii2****",
"PrimaryVswitchZoneId": "cn-hangzhou-g",
"PrimaryVswitchIp": "10.100.1.1",
"StandbyVswitchId": "vsw-2ze2gtlfozrab01cfo****",
"StandbyVswitchZoneId": "cn-hangzhou-h",
"StandbyVswitchIp": "10.100.2.1",
"Ttl": 30,
"ConnectorStatus": "ready",
"ConnectorHealthCheckStatus": "healthy",
"AckClientHostIp": "10.40.32.240",
"TaskId": "task-c92d4544ef7b6a42",
"CreateTime": "1724982259"
},
"RequestId": "0DC783F1-B3A7-578D-8A63-*****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | ErrorVSwitchAndPrivateIpAddressMismatched | The vSwitch and privateIpAddress are mismatched. | 交换机和私网IP不匹配。 |
| 400 | ErrorAckClusterNotFound | The specified resource ACK cluster is not found. | 指定的ACK集群不存在。 |
| 400 | ErrorAckClusterConnectorReverseEndpointIpNotAllocated | The IP is already allocated, failed to create reverse endpoint. | 指定IP已经被分配，创建反向连接终端节点失败。 |
| 400 | ErrorParametersUid | The aliUid parameter is invalid. | aliUid 不合法 |
| 400 | ErrorParameters | Parameters error. | 参数错误。 |
| 400 | ErrorRegionNo | regionNo error. | 地域选择错误， 请重新输入。 |
| 400 | ErrorDBSelect | An error occurred while querying database. | 内部错误：数据库查询错误 |
| 400 | ErrorVswitchNoAvailableIP | the vswitch has no available ip. | 指定的交换机无可用IP |
| 400 | ErrorVswitchNotFound | vswitch not found | vswitch 不存在, 请重新选择 |
| 400 | ErrorDBInsert | An error occurred while performing an insert operation in the database. | 内部错误：数据库插入错误 |
| 400 | ErrorAckClusterNetworkOnlySupportTerway | The ACK cluster network only support Terway. | ACK集群的网络插件仅支持Terway。 |
| 400 | ErrorAckVpcAndVSwitchVpcMismatched | The ACK VPC and vSwitch VPC are mismatched. | ACK集群的VPC和VSwitch的VPC不匹配。 |
| 400 | ErrorPrimaryStandbyVswitchSameZone | The primary and standby vSwitch are in the same availability zone. | 多可用区交换机不能是同一可用区。 |
| 400 | ErrorAckClusterSpecOnlySupportAckPro | The ACK cluster spec only support ack.pro.small. | ACK集群的规格仅支持集群 Pro 版。 |
| 400 | ErrorAckClusterConnectorQuotaExceeded | ACK cluster connector resource exceeds the quota limit. | ACK集群连接器资源超过配额限制。 |
| 500 | ErrorAckNotOpen | ACK service is not open. | |
| 500 | ErrorAckClusterConnectorExist | The ACK cluster connector already exist. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。