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

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

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

事前準備

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

対象プロジェクトで Project Admin であること。ロールと権限の詳細については、プラットフォームロールの管理を参照してください。
オンデマンドクラスターを作成するプロジェクトの ID を持っていること。
プロジェクト内のリソースを管理する権限を持つ API キーを持っていること。
プロジェクトがオンデマンドクラスターと同じリージョンにあること。現在サポートされているリージョンは aws-us-west-2 です。

制限事項

制限	説明
プロジェクトタイプ	オンデマンドクラスターは Enterprise プロジェクトでのみ利用できます。
リージョン	現在、オンデマンドクラスターを作成できるのは AWS us-west-2 のみです。
権限	オンデマンドクラスターを管理するには、Project Admin である必要があります。
クラスター数	各プロジェクトで最大 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 の数です。クラスターはワークロードに基づいてゼロとこの値の間で自動的にスケールします。最小値は 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 コンソールを使用する

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

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

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

クラスター設定を構成します。

パラメーター	説明
クラスター Name	作成するオンデマンドクラスターの名前です。
クラスター Description	作成するオンデマンドクラスターの説明です。最大 255 文字です。
Query CU	割り当てるクエリ CU の数です。クラスターはゼロとこの値の間で自動的にスケールします。最小値は 8 CU、最大値は 256 CU で、値は 8 の増分で大きくなります。この値は作成後に固定され、変更できません。
Auto suspend	クラスターが自動的にサスペンドするまでのアイドル時間（秒）です。デフォルトは 1 分です。

Create をクリックします。

次のステップ

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

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

事前準備​

制限事項​

オンデマンドクラスターを作成する​

RESTful API を使用する​

Web コンソールを使用する​