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

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

Plan availability

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

Region availability

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

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

前提条件​

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

  • 対象プロジェクトの Project Admin であること。ロールと権限の詳細については、Manage Platform Roles を参照してください。

  • オンデマンドクラスターを作成するプロジェクトのプロジェクト 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 を使用する場合​

次の例では、オンデマンドクラスターを作成します。詳細については、Create On-Demand クラスター を参照してください。

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 刻みで指定できます。この値は作成後に固定され、変更できません。
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 文字まで入力できます。
Query CU割り当てるクエリ CU 数です。クラスターは 0 からこの値の間で自動的にスケーリングされます。最小値は 8 CU、最大値は 256 CU で、8 刻みで指定できます。この値は作成後に固定され、変更できません。
Auto suspendクラスターが自動サスペンドするまでのアイドル時間（秒）です。デフォルトは 1 分です。
5

Create をクリックします。

次のステップ​

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

オンデマンドクラスターの一覧表示、検査、削除については、Manage On-Demand クラスター を参照してください。

Ctrl I