跳到主要内容
版本：Cloud 开发指南

集群
公测版

集群是一组用于运行您的向量数据库工作负载的计算资源。Zilliz Cloud 提供两种类型的集群：Serving 集群和 On-demand 集群。其中，Serving 集群始终保持运行，适用于需要始终在线、低延迟访问的生产工作负载；On-demand 集群仅在请求到达时启动，并在空闲时缩容至 0 CU。

本主题说明如何创建 On-demand 集群。

📘说明

此功能仅适用于企业版项目。

目前，您只能在阿里云华北2（北京）创建 On-demand 集群。如需其他地域，请联系我们。

使用限制​

  • 如需管理 On-demand 集群，您需要具备项目管理员权限。

  • 每个项目中最多只能创建 20 个 On-demand 集群。

  • 每 8 个 Query CU 的 On-demand 集群最多可查询 3 TB 原始数据。超过此限制的查询将报错。

创建 On-demand 集群​

  • 通过 RESTful API

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

    curl --request POST \
         --url "${BASE_URL}/v2/clusters/createOnDemandCluster" \
         --header "Authorization: Bearer ${TOKEN}" \
         --header "Accept: application/json" \
         --header "Content-Type: application/json" \
         --data-raw '{
            "projectId": "proj-09ee1f4b1151d5dd1edbc5",
            "regionId": "ali-cn-beijing",
            "clusterName": "my-on-demand",
            "cuSize": 8,
            "autoSuspend": 120
          }'
         
    # {
    #   "code": 0,
    #   "data": {
    #     "clusterId": "in07-7d6ac8697204a6a",
    #     "regionId": "ali-cn-beijing",
    #     "projectId": "proj-09ee1f4b1151d5dd1edbc5"
    #   }
    # }

    下表为参数说明。

    参数

    说明

    projectId

    待创建的 On-demand 集群所属项目的 ID。

    regionId

    集群部署地域。必须与项目地域一致。

    cuSize

    要分配的 Query CU 数量。集群会根据工作负载在 0 和该值之间自动伸缩：当收到请求时，扩容到指定的 Query CU 大小；空闲时缩容至 0。

    最小值为 8 CU，最大值为 256 CU，并且必须以 8 为梯度递增（例如 8、16、24）。超过 8 CU 的集群需要添加支付方式。

    将此值设置为 8 可支持对最多 3 TB 数据的查询；若要提升可查询的数据量，请增加 Query CU 大小。该值在创建后固定，无法更改。

    clusterName

    要创建的集群名称。

    autoSuspend

    集群自动挂起前的空闲超时时间。如果在此期间未收到任何请求，集群将自动挂起，以停止产生计算费用。

    • 字段类型：整数

    • 单位：秒

    • 最小值：60

    • 默认值：60

  • 通过 Web 控制台

    以下 Demo 展示了如何在 Web 控制台中创建 On-demand 集群。

    1

    点击按需计算 > 集群。

    2

    点击 + 集群。

    3

    配置集群。

    下表为参数说明。

    参数

    说明

    集群名称

    要创建的集群名称。

    Query CU

    要分配的 Query CU 数量。集群会根据工作负载在 0 和该值之间自动伸缩：当收到请求时，扩容到指定的 Query CU 大小；空闲时缩容至 0。

    最小值为 8 CU，最大值为 256 CU，并且必须以 8 为梯度递增（例如 8、16、24）。超过 8 CU 的集群需要添加支付方式。

    将此值设置为 8 可支持对最多 3 TB 数据的查询；若要提升可查询的数据量，请增加 Query CU 大小。该值在创建后固定，无法更改。

    自动挂起

    集群自动挂起前的空闲时间（以秒为单位）。默认值为 1 分钟。如果在此期间未收到任何请求，集群将自动挂起，以停止产生计算费用。

    4

    点击创建。

查看全部 On-demand 集群​

  • 通过 RESTful API

    您可以按如下方式列出所有 On-demand 集群：

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

    curl --request GET \
         --url "{BASE_URL}/v2/clusters/onDemandClusters?projectId={PROJECT_ID}&regionId=ali-cn-hangzhou" \
         --header "Authorization: Bearer ${TOKEN}" \
         --header "Accept: application/json"

    以下是输出示例。

    {
      "code": 0,
      "data": {
        "count": 2,
        "onDemandClusters": [
          {
            "clusterId": "in07-7d6ac8697204a6a",
            "clusterName": "xxx",
            "regionId": "ali-cn-beijing",
            "cuSize": 8,
            "status": "SUSPENDED",
            "endpoint": "https://proj-09ee1f4b1151d5dd1edbc5.ali-cn-hangzhou.zillizcloud.com",
            "privateLink": "",
            "createdBy": "admin@zilliz.com.cn",
            "createTime": 1745396115000
          }
        ]
      }
    }

  • 通过 Web 控制台

    J5GCwPH9Bh6FI8bcvEwcsSqenAx

查看 On-demand 集群详情​

  • 通过 RESTful API

    您可以按如下方式查看 On-demand 集群 详情：

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

    curl --request GET \
         --url "${BASE_URL}/v2/clusters/onDemandClusters/in07-7d6ac8697204a6a" \
         --header "Authorization: Bearer ${TOKEN}" \
         --header "Accept: application/json"

    以下是输出示例。

    {
      "code": 0,
      "data": {
        "clusterId": "in07-7d6ac8697204a6a",
        "clusterName": "xxx",
        "regionId": "ali-cn-beijing",
        "cuSize": 8,
        "status": "RUNNING",
        "endpoint": "https://proj-09ee1f4b1151d5dd1edbc5.ali-cn-hangzhou.zillizcloud.com",
        "privateLink": "",
        "createdBy": "admin@zilliz.com.cn",
        "createTime": 1745396115000
      }
    }

  • 通过 Web 控制台

    FvjhwLa0rh32Jfbhusocb2Ien3e

删除 On-demand 集群​

🚧警告

删除集群后，系统会立即将其移除，且无法恢复。此操作不可撤销。

  • 通过 RESTful API

    您可以按如下方式删除 On-demand 集群：

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

    curl --request DELETE \
         --url "${BASE_URL}/v2/clusters/onDemandClusters/in07-7d6ac8697204a6a" \
         --header "Authorization: Bearer ${TOKEN}" \
         --header "Accept: application/json"

    The following is an example output.

    {
      "code": 0,
      "data": {
        "clusterId": "in07-7d6ac8697204a6a",
        "status": "DELETING"
      }
    }

  • 通过 Web 控制台

    TFljws1JshqWmIbrKGXcFxTenxc