查看集群列表 (V2)

List all clusters scoped to API Key.

GET

/v2/clusters

Base URL

该 API 的 Base URL 格式如下：

https://api.cloud.zilliz.com.cn

📘说明

控制面接口速率限制为单用户单接口每秒最多 20 个请求。

export BASE_URL="https://api.cloud.zilliz.com.cn"

参数

Authorizationstringheaderrequired

认证令牌，应为具备适当权限的 API 密钥。

示例值：Bearer {{TOKEN}}

Acceptstringheader

使用 application/json。

示例值：application/json

pageSizeintegerquery

每次返回的记录数。

示例值：10

currentPageintegerquery

当前页码。

示例值：1

export TOKEN="YOUR_API_KEY"

curl --request GET \
--url "${BASE_URL}/v2/clusters" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Accept: application/json" \
--header "Content-Type: application/json"

响应200 - application/json

SUCCESS

codeinteger

响应码。

dataarray

响应负载，是一个集群详情列表。

[]dataobject

List of clusters in detail.

clusterIdstring

集群 ID。

clusterNamestring

集群名称。

descriptionstring

集群描述。

regionIdstring

集群所在云地域 ID。

planstring

集群所在项目的订阅计划。当前支持 Free、 Serverless 和 Enterprise 计划。

cuTypestring

集群类型。 仅适用于 Dedicated 集群。对于 Free 和 Serverless 集群，该值为空。

枚举值：

Performance-optimizedCapacity-optimized

cuSizeinteger

集群 CU 大小。 对于 Free 和 Serverless 集群，该值始终为 0。

取值范围：0≤ 256

statusstring

集群当前状态。

枚举值：

CREATINGRUNNINGDELETINGDELETEDSTOPPINGRESUMINGMODIFYINGABNORMALFREEZINGFROZENUNFREEZEDRESTORE_BACKUPMIGRATINGRESIZINGUPGRADINGWRITING_OPERATIONSET_PRIVATE_LINK

connectAddressstring

集群公开访问端点 (Public Endpoint)。

privateLinkAddressstring

集群私有访问端点 (Private Link)。

projectIdstring

集群所属项目 ID。

createTimestring

集群创建时间。

deploymentOptionstring

集群部署方式。

枚举值：

FreeServerlessDedicated

FAILURE

返回错误消息。

codeinteger

响应码。

messagestring

错误描述。

SUCCESS

{
    "code": 0,
    "data": {
        "count": 1,
        "currentPage": 1,
        "pageSize": 10,
        "clusters": [
            {
                "clusterId": "inxx-xxxxxxxxxxxxxxx",
                "clusterName": "dedicated-3",
                "description": "",
                "regionId": "aws-us-west-2",
                "plan": "Enterprise",
                "cuType": "Performance-optimized",
                "cuSize": 1,
                "status": "RUNNING",
                "connectAddress": "https://inxx-xxxxxxxxxxxxxxx.aws-us-west-2.vectordb.zillizcloud.com:19530",
                "privateLinkAddress": "",
                "createTime": "2024-06-30T16:49:50Z",
                "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
                "deploymentOption": "Dedicated"
            }
        ]
    }
}