创建集群

Zilliz Cloud 提供多种集群版本以满足不同的业务需求。请先查阅选择合适的 CU 类型进行合理的资源规划。本文介绍如何创建集群。

开始前

请确保已完成以下步骤：

• 已注册 Zilliz Cloud 账户。有关更多信息，请参见注册账号。

• 在目标组织或项目中，您具有集群创建权限。有关角色和权限的信息，请参见用户授权。

创建 Free 集群

Cloud 控制台

1. 登录 Zilliz Cloud 控制台。

2. 进入您需要创建集群的组织和项目。

3. 在打开的页面中，点击创建集群。

   

4. 在创建新集群页面，选择 Free 版并配置相关参数。

   📘说明

   仅支持创建 1 个 Free 集群。如需更多集群，请选择创建 Serverless 或 Dedicated 集群。

   参数	描述
   集群名称	请输入集群的名称。当前存在随机默认值，您可根据需要修改该名称。
   云服务提供商和地域	集群部署的云服务提供商和地域。 目前，Zilliz Cloud Free 版支持以下云服务提供商和地域： 阿里云 华东1（杭州）

   

5. 点击创建集群。

cURL

以下为示例代码，请将示例中的 {API_KEY} 替换为您自己的Zilliz Cloud API 密钥。

以下 POST 通过请求体在项目 proj-xxxxxxxxxxxxxxxxxxxxx 中创建了 1 个名称为 cluster-free 的 Free 集群。

curl --request POST \
     --url https://api.cloud.zilliz.com.cn/v2/clusters/createFree \
     --header 'Authorization: Bearer ${API_KEY}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data-raw '{
        "clusterName": "cluster-free",
        "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
        "regionId": "${REGION_ID}"
      }'
      
#  {
#    code: 0,
#    data: {
#      "clusterId": "inxx-xxxxxxxxxxxxxxx",
#      "username":"db_xxxxxxxx",
#      "password":"*************",
#      "prompt": "Successfully submitted, cluster is being created. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK with the admin account and the initial password you specified."
#    }
#  }

以下为参数说明：

• {API_KEY}：用于验证 API 请求的鉴权信息。请使用您自己的 Zilliz Cloud API 密钥。

• clusterName：需要创建的集群名称。

• projectId：需要创建的集群所属的项目的 ID。如需查看项目 ID，请使用查看项目列表。

• regionId：需要创建的集群所部署的云服务地域 ID。目前，仅支持在 ali-cn-hangzhou 创建 Free 集群。如需查看所有 Zilliz Cloud 支持的云服务地域 ID，请使用查看云服务区域。

创建 Serverless 集群

Cloud 控制台

1. 登录 Zilliz Cloud 控制台。

2. 进入您需要创建集群的组织和项目。

3. 在打开的页面中，点击创建集群。

   

4. 在创建新集群页面，选择 Serverless 版并配置相关参数。

   参数	描述
   集群名称	请输入集群的名称。当前存在随机默认值，您可根据需要修改该名称。
   云服务提供商和地域	集群部署的云服务提供商和地域。 目前，Zilliz Cloud Serverless 版支持以下云服务提供商和地域： 阿里云 华东1（杭州）

   

5. 点击创建集群。

cURL

以下为示例代码，请将示例中的 {API_KEY} 替换为您自己的Zilliz Cloud API 密钥。

以下 POST 通过请求体在项目 proj-xxxxxxxxxxxxxxxxxxxxx 中创建了 1 个名称为 cluster-serverless 的 Serverless 集群。

curl --request POST \
     --url https://api.cloud.zilliz.com.cn/v2/clusters/createServerless \
     --header 'Authorization: Bearer ${API_KEY}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data-raw '{
        "clusterName": "cluster-serverless",
        "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxxx",
        "regionId": "${REGION_ID}"
      }'
     
# {
#    code: 0,
#    data: {
#       "clusterId": "inxx-xxxxxxxxxxxxxxx",
#       "username":"db_xxxxxxxx",
#       "password":"***********",
#       "prompt": "Successfully submitted, cluster is being created. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK with the admin account and the initial password you specified."
#    }
#  }

以下为参数说明：

• {API_KEY}：用于验证 API 请求的鉴权信息。请使用您自己的 Zilliz Cloud API 密钥。

• clusterName：需要创建的集群名称。

• projectId：需要创建的集群所属的项目的 ID。如需查看项目 ID，请使用查看项目列表。

• regionId：需要创建的集群所部署的云服务地域 ID。目前，仅支持在 ali-cn-hangzhou 创建 Serverless 集群。如需查看所有 Zilliz Cloud 支持的云服务地域 ID，请使用查看云服务区域。

创建 Dedicated 集群

Cloud 控制台

1. 登录 Zilliz Cloud 控制台。

2. 进入您需要创建集群的组织和项目。

3. 在打开的页面中，点击创建集群。

   

4. 在创建新集群页面，选择 Dedicated 版并配置相关参数。

   参数	描述
   集群名称	请输入集群的名称。当前存在随机默认值，您可根据需要修改该名称。
   云服务提供商和地域	集群部署的云服务提供商和地域。 目前，Zilliz Cloud 支持以下云服务提供商和地域： 阿里云 华东1（杭州） 华北2（北京） 华南1（深圳） 腾讯云 华北地区（北京） 华东地区（上海） 美国东部（弗吉尼亚） 亚马逊云科技 中国（宁夏） 更多详情，请见云服务提供商和地域。
   CU 类型和大小	集群需要使用的 CU 类型及大小。 界面上有关于 CU 类型的简要介绍，并提供了价格计算器供您自助估算成本。 想了解更多关于 CU 选型的相关内容，可参见选择合适的 CU 类型。
   用户名和密码	用于在集群创建完成后访问该集群的凭据。 用户名默认为 db_admin 且不可修改，密码**需要满足界面提示中的条件。 记住在此处设置的用户名和密码，之后你需要它们来连接到集群。

   

5. 点击创建集群。

cURL

以下为示例代码，请将示例中的 {API_KEY} 替换为您自己的Zilliz Cloud API 密钥。

以下 POST 通过请求体在项目 proj-xxxxxxxxxxxxxxxxxxxxx 中创建了 1 个名称为 Cluster-02、CU 规格为 1 CU、CU 类型为性能型的 Dedicated 集群。

curl --request POST \
     --url https://api.cloud.zilliz.com.cn/v2/clusters/createDedicated \
     --header 'Authorization: Bearer ${API_KEY}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data-raw '{
        "clusterName": "Cluster-02",
        "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
        "regionId": "${REGION_ID}",
        "plan": "Enterprise",
        "cuType": "Performance-optimized",
        "cuSize": 1
      }'
     
#  {
#    code: 0,
#    data: {
#      "clusterId": "inxx-xxxxxxxxxxxxxxx",
#      "username":"db_admin",
#      "password":"****************",
#      "prompt": "Successfully submitted, cluster is being created. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK with the admin account and the initial password you specified."
#     }
#  }

以下为参数说明：

• {API_KEY}：用于验证 API 请求的鉴权信息。请使用您自己的 Zilliz Cloud API 密钥。

• clusterName：需要创建的集群名称。

• projectId：需要创建的集群所属的项目的 ID。如需查看项目 ID，请使用查看项目列表。

• regionId：需要创建的集群所部署的云服务地域 ID。如需查看所有 Zilliz Cloud 支持的云服务地域 ID，请使用查看云服务区域。

• plan: Dedicated 集群的版本类型。仅支持 Enterprise（企业版）。

• cuType：集群的 CU 类型。可选的参数值包含：Performance-optimized（性能型）和 Capacity-optimized（容量型）。

• cuSize：集群的 CU 规格。参数值为 1-256 之间的整数。

结果验证

创建集群后，您可以在集群列表页面上检查集群状态。如果集群的状态为运行中，则表示集群创建成功。