跳到主要内容

RESTful API 参考

Zilliz Cloud 提供了 RESTful API,以便您可以操作您的集群、Collection 以及存储在其中的数据。在深入了解之前,有几件事情值得注意:

Zilliz Cloud 使用 Control Plane 来集中管理集群和相关资源,而 Data Plane 则负责特定集合中的数据存储和处理。

Control Plane 提供了 CloudClusterImportPipeline 的相关 API 接口。Data Plane 提供了 CollectionVector 的相关 API 接口。

  • 使用 Control Plane API 时,您需要使用 有效的 API 密钥 来验证您的请求。

    以下是一个列出所有可用云提供商的示例。

    export CLOUD_REGION="gcp-us-west1"
    export API_KEY="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

    curl --request GET \
    --url "https://api.cloud.zilliz.com/v2/clouds" \
    --header "Authorization: Bearer ${API_KEY}" \
    --header "accept: application/json" \
    --header "content-type: application/json"
  • 使用 Data Plane API 时,您可以使用 有效的 API 密钥或有效的集群用户名和密码对 来验证您的请求。

    以下是一个列出指定集群中所有可用集合的示例。

    export CLUSTER_ENDPOINT="https://${CLUSTER_ID}.api.${CLOUD_REGION}.zillizcloud.com"
    export TOKEN="db_admin:xxxxxxxxxxxx"

    curl --request GET \
    --url "${CLUSTER_ENDPOINT}/v2/vectordb/collections/list" \
    --header "Authorization: Bearer ${TOKEN}" \
    --header "accept: application/json" \
    --header "content-type: application/json" \
    -d '{}'