メインコンテンツまでスキップ
バージョン: User Guides (Cloud)

プロジェクトの管理

Zilliz Cloud では、プロジェクトは組織内の論理的なコンテナとして機能し、クラスタ、ボリューム、および関連リソースをグループ化します。プロジェクト内のすべてのリソースは、同じクラウドプロバイダーとリージョンを共有します。

ビジネスの異なる側面に合わせて、複数のプロジェクトを作成できます。たとえば、会社がマルチメディア推薦サービスを提供している場合、動画推薦用のプロジェクトと音楽推薦用のプロジェクトをそれぞれ作成できます。

このガイドでは、プロジェクトの管理手順について説明します。

プロジェクトの作成​

各組織には、デフォルトで Default Project という名前の Enterprise プロジェクトが付属しています。オンボーディング時に、ワークロードをデプロイしたいクラウドリージョンを選択すると、システムがそのリージョンにこのデフォルトプロジェクトを自動的に作成します。デフォルトプロジェクトは削除できません。ワークロードやビジネスニーズに応じて、追加のプロジェクトを作成できます。プロジェクトを作成すると、自動的にそのプロジェクトの プロジェクト管理者 になります。

制限​

  • プロジェクトを作成するには、組織オーナー である必要があります。

  • 各組織で作成できるプロジェクトの最大数は 100 です。

手順​

プロジェクトは、Zilliz Cloud Web コンソールまたは RESTful API を使用して作成できます。

  • RESTful API経由

    以下の例は、現在の組織内で gcp-us-west1 にデプロイされた Enterprise プロジェクトを作成する方法を示しています。詳細については、プロジェクトの作成 を参照してください。

    export BASE_URL="https://api.cloud.zilliz.com"
    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": ["aws-us-west-2"]
          }'

    以下は出力例です。

    {
        "code": 0,
        "data": {
            "projectId": "proj-x"
        }
    }

  • ウェブコンソール経由

    次のデモでは、Zilliz Cloud のウェブコンソールでプロジェクトを作成する方法を示します。

    1

    対象の組織に移動します。左側のナビゲーションで プロジェクト をクリックします。

    2

    + プロジェクト をクリックします。

    3

    プロジェクト設定を構成します。

    次の表は、プロジェクトの作成時に使用される各パラメーターの説明です。

    パラメーター

    説明

    プラン

    ニーズに最も適したプロジェクトプランを選択します。プランによって、利用可能な機能と課金が決まります。価格、プランの違い、適切なプランの選び方の詳細については、プランの詳細比較 を参照してください。

    名前

    作成するプロジェクトの名前を入力します。

    リージョン

    ワークロードをデプロイするクラウドリージョンを選択します。プロジェクト内のすべてのリソース（クラスター、ボリュームなど）は、このリージョンにデプロイされます。プロジェクト作成後はリージョンを変更できません。利用可能なリージョンについては、クラウドプロバイダーとリージョン を参照してください。

    マルチリージョン（オプション）

    ビジネスクリティカル プロジェクトでのみ利用可能です。有効にすると、同じプロジェクト内で複数のクラウドリージョンにリソースをデプロイできます。これは、グローバルクラスター機能を使用する場合に必要です。マルチリージョンは、プロジェクト作成後に有効にすることもできます。

プロジェクトリージョンの追加​

プロジェクトが ビジネスクリティカル プランの場合、プロジェクトにさらにリージョンを追加できます。グローバルクラスター 機能を使用する必要がある場合、プロジェクトはマルチリージョンである必要があります。

  • RESTful API経由

    export BASE_URL="https://api.cloud.zilliz.com"
    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": ["gcp-us-west1"]
          }'

    以下は出力例です。

    {
      "code": 0,
      "data": {
        "projectId": "proj-a0195d6acacaf2bb985173",
        "regions": ["aws-us-west-2", "gcp-us-west1"]
      }
    }

  • ウェブコンソール経由

    Cw14w6V8Ih4QqWbuYstcKqjVnUx

Upgrade a project​

高度な機能を利用するには、既存のプロジェクトのプランをアップグレードできます。

プロジェクトをアップグレードすると、プロジェクト内のすべてのクラスターもアップグレードされます。

プロジェクトを ビジネスクリティカル または BYOC プランにアップグレードする必要がある場合は、営業担当にお問い合わせください。

  • RESTful API経由

    次のデモでは、プロジェクトのプランを Standard から Enterprise にアップグレードする方法を示しています。詳細については、プロジェクトのアップグレード を参照してください。

    export TOKEN="YOUR_API_KEY"
    export projectId="proj-xx"

    curl --request PATCH \
    --url "${BASE_URL}/v2/projects/${projectId}/plan" \
    --header "Authorization: Bearer ${TOKEN}" \
    --header "Content-Type: application/json" \
    -d '{
        "plan": "Enterprise"
    }'

    以下は出力例です。

    {
        "code": 0,
        "data": {
            "projectId": "proj-x"
        }
    }

  • ウェブコンソール経由

    次のデモでは、プロジェクトのプランを Standard から Enterprise にアップグレードする方法を示します。

View all projects​

組織内で自分の権限範囲にあるすべてのプロジェクトの一覧を表示できます。

  • 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": "project1",
          "projectId": "proj-a0195d6acacaf2bb985173",
          "instanceCount": 3,
          "createTime": "2023-12-07T03:21:32Z",
          "plan": "Standard",
          "projectType": "Regional",
          "regions": ["aws-us-west-2"]
        },
        {
          "projectName": "Default Project",
          "projectId": "proj-412e874430bfa02e857247",
          "instanceCount": 0,
          "createTime": "2023-08-16T07:34:06Z",
          "plan": "Enterprise",
          "projectType": "Legacy",
          "regions": []
        }
      ]
    }

  • ウェブコンソール経由

    VnLHwjlDbhA62GbPXsYcIl6CnKb

View project details​

特定のプロジェクトの詳細を確認することもできます。

  • RESTful API経由

    以下の例では、プロジェクト proj-xxxxxxxxxxxxxxx について説明します。詳細については、Describe Project を参照してください。

    export TOKEN="YOUR_API_KEY"
    export projectId="proj-xx"

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

    以下は出力例です

    {
      "code": 0,
      "data": [
        {
          "projectName": "project1",
          "projectId": "proj-a0195d6acacaf2bb985173",
          "instanceCount": 3,
          "createTime": "2023-12-07T03:21:32Z",
          "plan": "Standard",
          "projectType": "Regional",
          "regions": ["aws-us-west-2"]
        }
      ]
    }

  • ウェブコンソール経由

    プロジェクト ページで、プロジェクト名、プラン、作成時間、およびプロジェクト内のクラスター数を確認できます。さらに、特定のプロジェクトをクリックして、そのクラスターを表示できます。

    KgjvbAvUkopKWsxnGXycOZEynZd

プロジェクトの名前変更​

プロジェクトの名前を変更するには、組織オーナー である必要があります。ウェブコンソール経由でプロジェクトの名前を変更できます。

プロジェクトの削除​

プロジェクトを削除するには、組織オーナー である必要があります。

プロジェクトを削除する前に、プロジェクト内のすべての クラスター と ボリューム を削除する必要があります。

プロジェクトが削除されると、関連するすべてのデータとリソースも不可逆的に削除されます。

📘Notes

デフォルトのプロジェクトは削除できません。

ウェブコンソール経由でプロジェクトを削除できます。

FAQ​

プロジェクトのプランをダウングレードできますか？

プランの直接ダウングレードはサポートされていません。より低いプランに切り替えるには、希望のプランで新しいプロジェクトを作成し、データを 移行 してください。