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

オンデマンドクラスターの作成

Plan availability

この機能は Enterprise プラン以上でのみ利用できます。

Region availability

現在、この機能は AWS us-west-2 および Azure East US リージョンでのみ利用可能です。他のリージョンでオンデマンドクラスターをご利用になりたい場合は、お問い合わせください。

オンデマンドクラスターは、オンデマンドの検索やクエリワークロード向けにコンピューティングリソースを提供します。リクエスト受信時に起動し、アイドル時はゼロまでスケールダウンするため、バッチ検索、検証、探索、および常時稼働が不要なワークロードに適しています。

前提条件​

オンデマンドクラスターを作成する前に、以下の条件を満たしていることを確認してください。

  • 対象プロジェクトで Project Admin ロールを有していること。ロールと権限の詳細については、プラットフォームロールの管理を参照してください。

  • オンデマンドクラスターを作成するプロジェクトのプロジェクト ID を把握していること。

  • プロジェクト内のリソースを管理できる権限を持つ API キーを保有していること。

  • プロジェクトがオンデマンドクラスターと同じリージョンに存在すること。現在サポートされているリージョンは aws-us-west-2 です。

制限事項​

制限説明
プロジェクトタイプオンデマンドクラスターは Enterprise プロジェクトでのみ利用できます。
リージョン現在、オンデマンドクラスターは AWS us-west-2 でのみ作成可能です。
権限オンデマンドクラスターの管理には Project Admin 権限が必要です。
クラスター数1 つのプロジェクトあたり最大 20 個のオンデマンドクラスターを作成できます。
データ量オンデマンドクラスターでは、8 CU あたり最大 3 TB の生データをクエリできます。この上限を超えるクエリを実行するとエラーが返されます。

オンデマンドクラスターの作成​

オンデマンドクラスターは、Zilliz Cloud コンソールまたは RESTful API を使用して作成できます。

RESTful API を使用した作成​

以下はオンデマンドクラスターを作成する例です。詳細については、オンデマンドクラスターの作成を参照してください。

bash
curl --request POST \
--url "${BASE_URL}/v2/clusters/createOnDemandCluster" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "projectId": "proj-xxxxxxxxxxxxxxxxxxx",
    "regionId": "aws-us-west-2",
    "clusterName": "my-on-demand",
    "cuSize": 8,
    "autoSuspend": 60,
    "description": "A cluster for vector search workloads."
}'

各パラメーターの説明は以下の表のとおりです。

パラメーター説明
projectIdオンデマンドクラスターを作成するプロジェクトの ID です。
regionIdオンデマンドクラスターをデプロイするリージョンです。プロジェクトのリージョンと一致させる必要があり、現在は aws-us-west-2 を指定します。
clusterName作成するオンデマンドクラスターの名前です。
cuSize割り当てるクエリ CU 数です。クラスターはワークロードに応じて 0 からこの値の間で自動的にスケールします。最小値は 8 CU、最大値は 256 CU で、8 CU 刻みで指定できます。この値は作成後に固定され、変更できません。
autoSuspendクラスターが自動サスペンドするまでのアイドルタイムアウト（秒）です。この期間内にリクエストがない場合、クラスターはサスペンド状態になりコンピューティングコストの発生が停止します。最小値は 60 秒、デフォルト値も 60 秒です。
description(オプション)作成するオンデマンドクラスターの説明です。最大 255 文字まで入力できます。

以下は出力例です。

json
{
    "code": 0,
    "data": {
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "prompt": "Successfully submitted. The on-demand cluster is being created. Use the Describe On-Demand Cluster API to check its creation progress and status. Once the cluster status is RUNNING, use your API key to access the on-demand cluster."
    }
}

Web コンソールを使用した作成​

1

Zilliz Cloud コンソールで、対象のプロジェクトを開きます。

2

On-Demand Compute > クラスター に移動します。

3

+ クラスター をクリックします。

4

クラスター設定を行います。

パラメーター説明
クラスター名作成するオンデマンドクラスターの名前です。
クラスターの説明作成するオンデマンドクラスターの説明です。最大 255 文字まで入力できます。
クエリ CU割り当てるクエリ CU 数です。クラスターは 0 からこの値の間で自動的にスケールします。最小値は 8 CU、最大値は 256 CU で、8 CU 刻みで指定できます。この値は作成後に固定され、変更できません。
自動サスペンドクラスターが自動サスペンドするまでのアイドル時間（秒）です。デフォルトは 1 分です。
5

Create をクリックします。

次のステップ​

クラスター作成後、オンデマンド検索用のプロジェクトエンドポイントへ接続する際にクラスター ID を使用します。詳細については、オンデマンド検索への接続を参照してください。

オンデマンドクラスターの一覧表示、詳細確認、削除を行う場合は、オンデマンドクラスターの管理を参照してください。

Ctrl I