列出全球集群 (V2)
列出账户中的所有全球集群。
GET/v2/globalClusters
该 API 的 Base URL 格式如下:
https://api.cloud.zilliz.com
📘说明
控制面接口速率限制为单用户单接口每秒最多 20 个请求。
shell
export BASE_URL="https://api.cloud.zilliz.com"
参数
Authorizationstringheader必填项
认证令牌,应为具备适当权限的 API 密钥。
示例值:Bearer {{TOKEN}}
pageSizeintegerquery
每次返回的记录数。
示例值:10
currentPageintegerquery
当前页码。
示例值:1
bash
export TOKEN="YOUR_API_KEY"
curl --request GET \
--url "${BASE_URL}/v2/globalClusters" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
响应200 OK - application/json
全球集群列表。
包含 globalClusters 列表的响应载荷。
countinteger
全球集群总数。
currentPageinteger
当前页码。
pageSizeinteger
每页记录数。
globalClustersarray
全球集群列表。
[]globalClustersobject
列表中返回的一个 Global Cluster。
globalClusterIdstring
全球集群 ID。
示例值:glo-xxxxxxxxxxxxxxx
globalClusterNamestring
全球集群名称。
示例值:my-global-cluster
projectIdstring
全球集群所属项目 ID。
示例值:proj-xxxxxxxxxxxxxxx
regionIdsarray
全球集群部署的区域 ID 列表。
[]regionIdsstring
区域 ID。
cuTypestring
全球集群的计算单元类型(CU)。
示例值:Performance-optimized
cuSizeinteger
全球集群的计算单元大小(CU)。
示例值:4
connectAddressstring
全球集群的连接地址。
createTimestring<date-time>
全球集群的创建时间。
示例值:2026-06-01T12:00:00Z
dataobject
响应负载,类型随端点而变化。
countinteger<int32>
全球集群的总数量。
currentPageinteger<int32>
当前页码。
pageSizeinteger<int32>
每页条目数。
globalClustersarray
当前页的全球集群列表。
[]globalClustersobject
全球集群的概要信息。
globalClusterIdstring
全球集群的 ID。
globalClusterNamestring
全球集群的名称。
projectIdstring
全球集群所属项目的 ID。
regionIdsarray
全球集群覆盖的地域的 ID 列表。
[]regionIdsstring
与全局集群关联的一个 Region ID。每个条目通过其 Region 标识符标识一个 Region。
cuTypestring
全球集群的 CU 类型。
cuSizeinteger<int64>
全球集群的 CU 规格。
connectAddressstring
全球集群的连接地址。
createTimestring<date-time>
全球集群的创建时间。
返回错误消息。
codeinteger<int32>
响应码。
messagestring
错误描述。
Successjson
{
"count": 1,
"currentPage": 1,
"pageSize": 10,
"globalClusters": [
{
"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-01T12:00:00Z"
}
]
}