查看全球集群 (V2)
返回全球集群的基础拓扑和连接信息。本接口不返回复制延迟。
该 API 的 Base URL 格式如下:
https://api.cloud.zilliz.com
控制面接口速率限制为单用户单接口每秒最多 20 个请求。
export BASE_URL="https://api.cloud.zilliz.com"
认证令牌,应为具备适当权限的 API 密钥。
要查看的全球集群 ID。
export TOKEN="YOUR_API_KEY"
export globalClusterId="glo-xxxxxxxxxxxxxxx"
curl --request GET \
--url "${BASE_URL}/v2/globalClusters/${globalClusterId}" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
返回全球集群信息。
查询单个 Global Cluster 成功时返回的响应载荷之一。
全球集群 ID。
全球集群显示名称。
项目 ID。
成员集群的区域 ID。取值保留成员顺序且不会去重。
与 Global Cluster 关联的一个区域 ID。
成员集群共享的 CU 类型。
成员集群共享的 CU 大小。
全球端点地址。
ISO 8601 格式的创建时间。
全球集群中的成员集群。
Global Cluster 中的一个成员集群。
成员集群 ID。
成员集群名称。
成员集群部署的区域 ID。
成员角色。
成员集群状态。
响应负载,类型随端点而变化。
全球集群的 ID。
全球集群的名称。
全球集群所属项目的 ID。
全球集群覆盖的地域的 ID 列表。
与全局 Cluster 关联的某个区域的标识符。
全球集群的 CU 类型。
全球集群的 CU 规格。
全球集群的自动扩缩容配置。
CU 自动扩缩容的范围与定时计划。
CU 的最小数量。
CU 的最大数量。
CU 的定时扩缩容目标列表。
定时扩缩容规则。
定义定时计划生效时间的 Cron 表达式。
定时计划触发时应用的目标值。
Cron 定时计划使用的时区。
副本自动扩缩容的范围与定时计划。
副本的最小数量。
副本的最大数量。
副本的定时扩缩容目标列表。
定时扩缩容规则。
定义定时计划生效时间的 Cron 表达式。
定时计划触发时应用的目标值。
Cron 定时计划使用的时区。
全球集群的连接地址。
全球集群的创建时间。
全球集群的成员集群列表。
全球集群的一个成员集群。
成员集群的 ID。
成员集群的名称。
成员集群所在地域的 ID。
成员集群的角色,例如主集群或备集群。
成员集群的状态。
成员集群的副本数量。
返回错误消息。
响应码。
错误描述。
{
"globalClusterId": "glo-xxxxxxxxxxxxxxx",
"globalClusterName": "my-global-cluster",
"projectId": "proj-xxxxxxxxxxxxxxx",
"regionIds": [
"ali-cn-hangzhou",
"ali-cn-beijing"
],
"cuType": "Performance-optimized",
"cuSize": 4,
"connectAddress": "https://glo-xxxxxxxx.global-cluster.vectordb.cloud.zilliz.com.cn",
"createTime": "2026-06-04T10:00:00Z",
"clusters": [
{
"clusterId": "in01-primary",
"clusterName": "primary-cluster",
"regionId": "ali-cn-hangzhou",
"role": "PRIMARY",
"status": "RUNNING"
},
{
"clusterId": "in01-secondary",
"clusterName": "secondary-cluster",
"regionId": "ali-cn-beijing",
"role": "SECONDARY",
"status": "RUNNING"
}
]
}