メインコンテンツまでスキップ

プロジェクトの管理

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

ビジネスのさまざまな用途に合わせて、複数のプロジェクトを作成できます。たとえば、マルチメディアレコメンデーションサービスを提供している場合、動画レコメンデーション用のプロジェクトと音楽レコメンデーション用のプロジェクトをそれぞれ作成できます。

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

プロジェクトの作成​

各組織には、Default Project という名前のデフォルト Enterprise プロジェクトが用意されています。オンボーディング時にワークロードのデプロイ先となるクラウドリージョンを選択すると、システムによってそのリージョンにデフォルトプロジェクトが自動作成されます。デフォルトプロジェクトは削除できません。ワークロードやビジネス要件に応じて、追加のプロジェクトを作成できます。プロジェクトを作成すると、自動的にそのプロジェクトの Project Admin になります。

制限事項​

  • プロジェクトを作成するには、Organization Owner である必要があります。

  • 1つの組織あたり最大100個のプロジェクトを作成できます。

手順​

プロジェクトは、Zilliz Cloud WebコンソールまたはRESTful APIから作成できます。

  • RESTful APIを使用する場合

    以下にプロジェクト作成の例を示します。詳細については、Create Project を参照してください。

    bash
    curl --request POST \
    --url "${BASE_URL}/v2/projects" \
    --header "Authorization: Bearer ${TOKEN}" \
    --header "Request-Timeout: 5" \
    --header "Content-Type: application/json" \
    -d '{
        "projectName": "My Project",
        "plan": "Enterprise",
        "regionIds": [
            "aws-us-east-1"
        ],
        "description": "A project for organizing clusters and resources."
    }'

    以下は出力例です。

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

  • Webコンソールを使用する場合

    以下のデモでは、Zilliz Cloud Webコンソールでプロジェクトを作成する手順を紹介しています。

    1

    対象の組織に移動し、左側ナビゲーションの Projects をクリックします。

    2

    + Project をクリックします。

    3

    プロジェクトの設定を行います。

    プロジェクト作成時に指定する各パラメータの説明は、以下の表のとおりです。

    パラメータ説明
    プラン用途に最適なプロジェクトプランを選択します。プランによって利用可能な機能や課金体系が異なります。料金、プラン間の違い、適切なプランの選び方などの詳細については、Detailed Plan Comparison を参照してください。
    名前作成するプロジェクトの名前を入力します。
    説明（任意）作成するプロジェクトの説明を255文字以内で入力します。
    リージョンワークロードをデプロイするクラウドリージョンを選択します。プロジェクト内のすべてのリソース（クラスター、ボリュームなど）はこのリージョンにデプロイされます。プロジェクト作成後にリージョンを変更することはできません。利用可能なリージョンについては、Cloud Providers & Regions を参照してください。
    マルチリージョン（任意）Business Critical プロジェクトでのみ利用可能です。有効にすると、同じプロジェクト内の複数のクラウドリージョンにリソースをデプロイできます。Global クラスター Explained 機能を使用する予定がある場合は必須です。マルチリージョンは、プロジェクトの作成後に有効にすることもできます。

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

プロジェクトが Business Critical プランの場合、プロジェクトにリージョンを追加できます。Global クラスター 機能を使用する必要がある場合は、プロジェクトがマルチリージョンである必要があります。

  • RESTful APIを使用する場合

    bash
    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"]
          }'

    以下は出力例です。

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

  • Webコンソールを使用する場合

    Cw14w6V8Ih4QqWbuYstcKqjVnUx

プロジェクトリージョンの削除​

マルチリージョンプロジェクトからリージョンを削除できます。

  • RESTful APIを使用する場合

    bash
    curl -i --request DELETE \
        --url "https://${BASE_URL}/v2/projects/proj-a0195d6acacaf2bb985173/regions/gcp-us-west1" \
        --header "Authorization: Bearer ${API_KEY}" \
        --header "accept: application/json"

    以下は出力例です。

    bash
    {
      "code": 0,
      "data": ["aws-us-west-2"]
    }

  • Webコンソールを使用する場合

    DpQXwPmA9hnquubow8UcnFnQn9c

プロジェクトのアップグレード​

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

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

プロジェクトを Business Critical または BYOC プランにアップグレードする場合は、contact sales までお問い合わせください。

  • RESTful APIを使用する場合

    以下のデモでは、プロジェクトのプランをStandardからEnterpriseへアップグレードする手順を紹介しています。詳細については、Upgrade Project を参照してください。

    bash
    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"
    }'

    以下は出力例です。

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

  • Webコンソールを使用する場合

    以下のデモでは、プロジェクトのプランを Standard から Enterprise へアップグレードする手順を紹介しています。

すべてのプロジェクトの表示​

権限範囲内のすべてのプロジェクト一覧を表示できます。

  • RESTful APIを使用する場合

    以下に現在の組織内のすべてのプロジェクトを一覧表示する例を示します。詳細については、List Projects を参照してください。

    bash
    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"

    以下は出力例です。

    bash
    {
        "code": 0,
        "data": [
            {
                "projectName": "Default Project",
                "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxxx",
                "regionIds": [
                    "aws-us-east-1"
                ],
                "instanceCount": 2,
                "createTime": "2023-08-16T07:34:06Z",
                "plan": "Enterprise",
                "orgType": "SAAS",
                "description": "A project for organizing clusters and resources."
            }
        ]
    }

  • Webコンソールを使用する場合

    VnLHwjlDbhA62GbPXsYcIl6CnKb

プロジェクトの詳細を表示する​

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

  • RESTful API を使用する場合

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

    bash
    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"

    以下は出力例です。

    json
    {
        "code": 0,
        "data": {
            "projectId": "proj-x",
            "projectName": "My Project",
            "regionIds": [
                "aws-us-east-1"
            ],
            "instanceCount": 2,
            "createTime": "2023-08-16T07:34:06Z",
            "plan": "Enterprise",
            "orgType": "SAAS",
            "description": "A project for organizing clusters and resources."
        }
    }

  • Web コンソールを使用する場合

    Projects ページでは、プロジェクト名、プラン、作成日時、およびプロジェクト内のクラスター数を確認できます。また、特定のプロジェクトをクリックすると、そのクラスターを表示できます。

    HhfsbgOXco1fdGxoEYxc6QXBnpc

プロジェクトの詳細を編集する​

プロジェクトの名前変更や説明の編集を行うには、Organization Owner である必要があります。プロジェクトの詳細は Web コンソールから編集できます。

プロジェクトを削除する​

プロジェクトを削除するには、Organization Owner である必要があります。

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

プロジェクトを削除すると、関連するすべてのデータとリソースも復元不可能な形で消去されます。

プロジェクトは Web コンソールから削除できます。

FAQ​

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

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

Ctrl I