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

管理项目

在 Zilliz Cloud 中，项目位于组织和集群层级之间，用于分组集群和相关资源。您可以根据业务需求创建多个项目。例如，如果您的公司提供多媒体推荐服务，您可以为视频推荐服务创建一个项目，为音乐推荐服务创建另一个项目。本指南将介绍如何管理项目。

创建项目​

每个组织中默认自带项目 Default Project，其版本为企业版且不可删除。您可以根据业务需求，自行创建更多项目。当您创建项目时，您也会成为该项目的项目管理员。

限制​

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

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

操作步骤​

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

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

  • 通过 web 控制台

    create-project-zh

  • 通过 RESTful API

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

    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_01",
            "plan": "Enterprise"
          }'

    以下为输出结果。

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

查看全部项目​

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

  • 通过 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 控制台删除项目。

常见问题​

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