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

项目管理

在 Zilliz Cloud 中，项目位于组织和集群层级之间，用于分组集群、Volume 和相关资源。同一项目下所有资源都部署在同一云地域中。

您可以根据业务需求创建多个项目。例如，如果您的公司提供多媒体推荐服务，您可以为视频推荐服务创建一个项目，为音乐推荐服务创建另一个项目。本指南将介绍如何管理项目。

创建项目​

每个组织中默认自带项目 Default Project，其版本为企业版且不可删除。在注册账号完成后的引导流程中，您需要选择要部署工作负载的云地域，随后系统会在该地域自动创建该默认项目。您可以根据业务需求，自行创建更多项目。当您创建项目时，您也会成为该项目的项目管理员。

限制​

  • 要创建项目，您必须是组织管理员。

  • 每个组织中最多可创建 100 个项目。

操作步骤​

创建项目时，您需要输入项目名称并选择合适的项目版本。项目版本决定了可用功能特性与费用计算。如需了解不同版本的定价、版本差异以及如何选择合适的版本，请参考 Zilliz Cloud 版本对比。如果您需要使用跨域多副本容灾、PITR、行级别权限（RLS）、CMEK、数据脱敏（Tokenization）、快照（Snapshot）等功能，请联系我们。

您可以通过 Web 控制台或 RESTful API 创建项目。

  • 通过 web 控制台

    1

    前往目标组织，在左侧导航中点击项目。

    2

    点击 + 项目。

    3

    配置项目设置。

    下表说明了创建项目时使用的各项参数。

    参数

    说明

    版本

    选择最适合您需求的项目版本。版本决定了可用功能和计费。详情请参见Zilliz Cloud 版本对比。

    名称

    输入要创建的项目名称。

    地域

    选择用于部署工作负载的云地域。项目中的所有资源（例如集群、Volume 等）都会部署在该地域。项目创建后，地域不可更改。详情请参见选择合适的集群类型。

    多地域（可选）

    启用后，您可以在同一个项目中跨多个云地域部署资源。如果您计划使用全球集群功能，则必须启用此选项。

    项目创建后，仍可稍后启用多地域。

  • 通过 RESTful API

    以下示例创建了一个名称为 project-05 的企业版项目。详情请参考创建项目。

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

    curl --request POST \
         --url "https://${BASE_URL}/v2/projects" \
         --header "Authorization: Bearer ${TOKEN}" \
         --header "Accept: application/json" \
         --header "Content-type: application/json" \
         --data-raw '{
            "projectName": "project-05",
            "plan": "Enterprise",
            "projectType": "Regional",
            "regions": ["ali-cn-hangzhou"]
          }'

    以下为输出结果。

    {
      "code": 0,
      "data": [
        {
          "ProjectId": "proj-xxxxxxxxxxxxxxx"
        }
      ]
    }

添加项目地域​

如果您需要使用全球集群功能，你必须创建多地域项目。您可以联系我们开通多地域项目的功能。

  • 通过 RESTful API

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

    curl --request POST \
         --url "https://${BASE_URL}/v2/projects/proj-a0195d6acacaf2bb985173/regions" \
         --header "Authorization: Bearer ${TOKEN}" \
         --header "Accept: application/json" \
         --header "Content-Type: application/json" \
         --data-raw '{
            "regions": ["ali-cn-hangzhou"]
          }'

    以下为返回结果示例。

    {
      "code": 0,
      "data": {
        "projectId": "proj-a0195d6acacaf2bb985173",
        "regions": ["ali-cn-hangzhou", "ali-cn-beijing"]
      }
    }

查看全部项目​

您可以查看在您的权限范围内的所有项目的列表。

  • 通过 Web 控制台

    zh-view-projects-saas

  • 通过 RESTful API

    以下示例查看当前组织下的全部项目。详情请参考查看项目列表。

    export TOKEN="YOUR_API_KEY"

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

    以下为输出结果。

    {
        "code": 0,
        "data": [
            {
                "projectName": "Default Project",
                "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxxx",
                "instanceCount": 2,
                "createTime": "2023-08-16T07:34:06Z"
            }
        ]
    }

查看项目详情​

您还可以查看某个项目的具体详情。

  • 通过 Web 控制台

    您可以在项目列表页查看项目名称、版本、集群数量、创建时间。您还可以点击某个项目，查看项目下的集群信息。

    C2ItbMdsMoH2FWxmmHncejKVn0e

  • 通过 RESTful API

    以下示例查看项目 proj-xxxxxxxxxxxxxxx 的详细信息。详情请参考查看项目详情。

    export TOKEN="YOUR_API_KEY"
    export PROJECT_ID="proj-xxxxxxxxxxxxxxx"

    curl --request GET \
         --url "https://${BASE_URL}/v2/projects/${PROJECT_ID}" \
         --header "Authorization: Bearer ${API_KEY}"   \
         --header "accept: application/json"

    以下为输出结果。

    {
      "code": 0,
      "data": [
        {
          "projectName": "project1",
          "projectId": "proj-xxxxxxxxxxxxxxx",
          "instanceCount": 3,
          "createTime": "2023-12-07T03:21:32Z",
          "plan": "Enterprise"
        }
      ]
    }

重命名项目​

要重命名项目，您必须是组织管理员。您可以通过 Web 控制台对项目进行重命名。

📘说明

每个组织中都有一个默认项目。

删除项目​

要删除项目，您必须是组织管理员。删除项目前，您需要先删除该项目下的所有集群和 Volume。

项目一旦删除，该项目下的所有数据和资源将被清理。该操作不可撤销。

📘说明

组织中的默认项目不可删除。

您可以通过 Web 控制台删除项目。

常见问题​

能否降级项目版本？ 暂不支持直接降级。如需切换至更低版本，请创建一个新项目并选择所需的版本，然后将数据迁移至该项目。