访问端点

Zilliz Cloud 提供了三类端点，每类端点都有不同的职责。

	控制平面 API 端点	按需计算端点	实时服务端点
URL 模式	https://api.cloud.zilliz.com.cn	https://{project-id}.{region}.api.cloud.zilliz.com.cn	https://{cluster-id}.{region}.vectordb.zilliz.com.cn:19530
职责	资源生命周期：集群、卷、作业以及所有其他控制平面活动	数据导入，批量搜索	完整的集合 API (DDL + DML + DQL)
数据操作	无（数据导入除外）	批量插入和导入；按 CU 计费的搜索	插入、更新和删除，具有低延迟搜索和查询
何时使用	配置基础设施和自动化	批处理、探索、验证、实验	生产服务，持续的低延迟查询

连接到实时服务集群

Zilliz Cloud 提供以下类型的服务集群：Free、Serverless 版和 Dedicated 版。您需要遵循以下示例来设置连接。

from pymilvus import MilvusClient

# 连接到一个 Dedicated 集群
client = MilvusClient(
    uri="https://{cluster-id}.{region}.vectordb.zilliz.com.cn:19530",
    token="YOUR_API_KEY"
)

# 连接到一个 Free / Serverless 集群
client = MilvusClient(
    uri="https://{cluster-id}.serverless.{region}.cloud.zilliz.com.cn",
    token="YOUR_API_KEY"
)

您可以使用具有适当权限的有效 API 密钥或 username:password 格式的集群凭据进行身份验证。

连接到按需计算集群

Zilliz Cloud 还提供专门用于按需计算的 Database。

from pymilvus import MilvusClient

client = MilvusClient(
    uri="https://{project-id}.{region}.api.cloud.zilliz.com.cn",
    cluster="inxx-xxxxxxxxxxxxxxx",
    token="YOUR_API_KEY"
)

当连接到按需计算端点时，您还需要设置一个按需集群的集群 ID，以便您可以使用该集群中的计算资源来执行搜索和查询。

您可以使用具有适当权限的有效 API 密钥或 username:password 格式的集群凭据进行身份验证。

连接到 Zilliz Cloud 控制平面 API 端点

当您需要创建集群和 Volume，或管理控制平面资源（如备份、恢复和迁移）时，请使用控制平面端点。

例如，您可以按如下方式查看可用的云提供商：

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

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

有关详细信息，请参阅 RESTful API 参考。