オンデマンドクラスターの管理

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

このガイドでは、Zilliz Cloud でオンデマンドクラスターを表示、確認、削除する方法について説明します。

オンデマンドクラスターは、オンデマンド検索ワークロード向けのコンピューティングを提供します。リクエストが到着すると起動し、アイドル状態になると、クラスター作成時に設定した自動サスペンドのタイムアウトに基づいてゼロにスケールバックします。

オンデマンドクラスターを管理するには、対象プロジェクトの Project Admin である必要があります。ロールと権限の詳細については、プラットフォームユーザーの管理を参照してください。

すべてのオンデマンドクラスターを表示する

この操作を使用して、プロジェクトおよびリージョン内のオンデマンドクラスターを一覧表示します。

RESTful API を使用する

bash
curl --request GET \
     --url "${BASE_URL}/v2/clusters/onDemandClusters?projectId=proj-xxxxxxxxxxxxxxx&regionId=aws-us-west-2" \
     --header "Authorization: Bearer ${TOKEN}" \
     --header "Accept: application/json"

応答例：

bash
{
    "code": 0,
    "data": {
        "count": 2,
        "onDemandClusters": [
            {
                "projectId": "proj-xxxxxxxxxxxxxxx",
                "clusterId": "inxx-xxxxxxxxxxxxxxx",
                "clusterName": "Cluster-01",
                "regionId": "aws-us-west-2",
                "cuSize": 8,
                "status": "RUNNING",
                "endpoint": "https://proj-xxxxxxxxxxxxxxx.aws-us-west-2.api.zillizcloud.com",
                "privateLink": "",
                "createdBy": "john.doe@zilliz.com",
                "createTime": "2024-04-21T10:15:15Z",
                "autoSuspend": 60,
                "description": "An on-demand cluster for vector search workloads."
            },
            {
                "projectId": "proj-xxxxxxxxxxxxxxx",
                "clusterId": "inxx-xxxxxxxxxxxxxxx",
                "clusterName": "Cluster-02",
                "regionId": "aws-us-west-2",
                "status": "RUNNING",
                "cuSize": 8,
                "endpoint": "https://proj-xxxxxxxxxxxxxxx.aws-us-west-2.api.zillizcloud.com",
                "privateLink": "",
                "createdBy": "john.doe@zilliz.com",
                "createTime": "2024-04-21T10:15:16Z",
                "autoSuspend": 60,
                "description": "An on-demand cluster for vector search workloads."
            }
        ]
    }
}

Web コンソールを使用する

W3nYwPc0AhxRDWbjEsWceJGVnbh

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

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

クラスター名、クラスター ID、ステータス、CU サイズ、エンドポイント、作成者、作成時刻を含むオンデマンドクラスターの一覧を確認します。

オンデマンドクラスターの詳細を確認する

この操作を使用して、クラスター ID を指定して 1 つのオンデマンドクラスターを確認します。

RESTful API を使用する

bash
curl --request GET \
     --url "https://${BASE_URL}/v2/on-demand-compute?projectId=proj-09ee1f4b1151d5dd1edbc5&regionId=aws-us-west-2" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json"

応答例：

bash
{
  "code": 0,
  "data": {
    "projectId": "proj-09ee1f4b1151d5dd1edbc5",
    "regionId": "aws-us-west-2",
    "status": "enabled"
  }
}

Web コンソールを使用する

XiWTwTJ3mhgjHBbS5dycYi4bn4c

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

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

対象クラスターをクリックして詳細を表示します。

クラスターのステータスを理解する

オンデマンドクラスターは、リクエストのアクティビティに基づいてステータスを自動的に変更します。

ステータス	説明
`RUNNING`	クラスターにはアクティブなコンピューティングリソースがあり、検索またはクエリのリクエストを処理できます。
`SUSPENDED`	クラスターは、設定されたアイドルタイムアウト後にゼロにスケールバックされています。サスペンド中はコンピューティングコストが発生しません。
`DELETING`	クラスターは削除中であり、使用できません。

サスペンドされたオンデマンドクラスターにリクエストが到着すると、Zilliz Cloud はワークロード用のコンピューティングリソースを起動します。設定された autoSuspend 期間内にリクエストを受信しなかった場合、クラスターはゼロにスケールバックします。

オンデマンドクラスターの名前を変更する

RESTful API を使用する

次の例では、クラスター名を変更します。詳細については、Update On-Demand クラスターを参照してください。

bash
curl --request PATCH \
--url "${BASE_URL}/v2/clusters/onDemandClusters/${CLUSTER_ID}" \
--header "Authorization: Bearer ${TOKEN}" \
--header "OrgId: org-xxxxxxxxxxxxxxxxxxx" \
--header "Content-Type: application/json" \
-d '{
    "clusterName": "New Cluster Name"
}'

出力例は以下の通りです。

json
{
    "code": 0,
    "data": {
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "prompt": "successfully submitted. Cluster is being upgraded, which is expected to take several minutes. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK."
    }
}

Web コンソールを使用する

1
対象のオンデマンドクラスターに移動します。
2
Actions をクリックし、Rename を選択します。
3
クラスターの新しい名前を入力し、Save をクリックします。

オンデマンドクラスターの説明を編集する

RESTful API を使用する

次の例では、クラスターの説明を変更します。詳細については、Update On-Demand クラスターを参照してください。

bash
curl --request PATCH \
--url "${BASE_URL}/v2/clusters/onDemandClusters/${CLUSTER_ID}" \
--header "Authorization: Bearer ${TOKEN}" \
--header "OrgId: org-xxxxxxxxxxxxxxxxxxx" \
--header "Content-Type: application/json" \
-d '{
    "description": ""
}'

出力例は以下の通りです。

json
{
    "code": 0,
    "data": {
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "prompt": "successfully submitted. Cluster is being upgraded, which is expected to take several minutes. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK."
    }
}

Web コンソールを使用する

1
対象のオンデマンドクラスターに移動します。
2
説明にカーソルを合わせ、Edit description アイコンをクリックします。
3
クラスターの新しい説明を入力し、Save をクリックします。

オンデマンドクラスターを変更する

オンデマンドクラスターの名前、説明、自動サスペンド設定などの設定を変更できます。

RESTful API を使用する

既存のオンデマンドクラスターの名前、説明、自動サスペンド時間、クエリ CU 数を変更できます。詳細については、Update On-Demand クラスターを参照してください。

bash
export TOKEN="YOUR_API_KEY"
export CLUSTER_ID="inxx-xxxxxxxxxxxxxxx"

curl --request PATCH \
     --url "https://${BASE_URL}/v2/clusters/onDemandClusters/in07-7d6ac8697204a6a" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --data-raw '{
        "autoSuspend": "5m",
        "clusterName": "my-on-demand-updated",
        "description": "Updated on-demand cluster description",
        "cuSize": 32
      }'

出力例は以下の通りです。

bash
{
  "code": 0,
  "data": {
    "clusterId": "inxx-xxxxxxxxxxxxxxx",
    "prompt": "Successfully submitted."
  }
}

Web コンソールを使用する

Web コンソールを使用して、既存のオンデマンドクラスターのクラスター名、説明、自動サスペンド時間、クエリ CU 数を変更できます。

キープウォームスケジュールを構成する

キープウォームスケジュールは、毎週繰り返される時間枠の間、オンデマンドクラスターを実行状態に保ちます。キープウォームの時間枠が開始されると、オンデマンドクラスターがサスペンドされている場合、Zilliz Cloud はそのクラスターを再開します。時間枠の間は、Auto Suspend が抑制されます。時間枠が終了すると、オンデマンドクラスターは既存の自動サスペンドポリシーに再び従います。

キープウォームスケジュールは、Auto Suspend を恒久的に無効にするものではなく、キープウォームの時間枠が終了したときにオンデマンドクラスターをアクティブにサスペンドするものでもありません。

Note

キープウォームの時間枠中にオンデマンドクラスターをサスペンドするには、先にキープウォームスケジュールを無効化または削除してください。

各オンデマンドクラスターには、1 つのキープウォームスケジュールを設定できます。スケジュールには、1〜10 個の毎週のルールを含めることができます。各ルールは組織のシステムタイムゾーンを使用し、曜日、開始時刻、終了時刻を含みます。

RESTful API を使用する

既存のオンデマンドクラスター API を使用して、キープウォームスケジュールを構成します。キープウォームの構成は、作成、記述、更新の各 API で keepWarm オブジェクトによって指定します。

キープウォームスケジュールを作成する

オンデマンドクラスターの作成時にキープウォームスケジュールを構成するには、作成リクエストに keepWarm を含めます。

次の例では、平日の 09:00 から 18:00 までのキープウォームスケジュールを持つオンデマンドクラスターを作成します。

bash
curl --request POST \
  --url "${BASE_URL}/v2/clusters/createOnDemandCluster" \
  --header "Authorization: Bearer ${TOKEN}" \
  --header "OrgId: org-xxxxxxxxxxxxxxxxxxx" \
  --header "Content-Type: application/json" \
  -d '{
    "projectId": "proj-xxxxxxxxxxxxxxxxxxx",
    "regionId": "aws-us-west-2",
    "cuSize": 8,
    "clusterName": "my-on-demand-cluster",
    "autoSuspend": "5m",
    "keepWarm": {
      "enabled": true,
      "schedules": [
        {
          "daysOfWeek": [1, 2, 3, 4, 5],
          "startTime": "09:00",
          "endTime": "18:00"
        }
      ]
    }
  }'

応答例：

json
{
  "code": 0,
  "data": {
    "clusterId": "inxx-xxxxxxxxxxxxxxx",
    "prompt": "successfully submitted. Cluster is being created."
  }
}

キープウォームスケジュールを表示する

次の例では、オンデマンドクラスターのキープウォームスケジュールを確認します。

bash
curl --request GET \
  --url "${BASE_URL}/v2/clusters/onDemandClusters/${CLUSTER_ID}" \
  --header "Authorization: Bearer ${TOKEN}" \
  --header "OrgId: org-xxxxxxxxxxxxxxxxxxx" \
  --header "Accept: application/json"

応答例：

json
{
  "code": 0,
  "data": {
    "clusterId": "inxx-xxxxxxxxxxxxxxx",
    "clusterName": "my-on-demand-cluster",
    "status": "RUNNING",
    "autoSuspend": 300,
    "keepWarmActive": true,
    "keepWarm": {
      "enabled": true,
      "systemTimezone": "Asia/Shanghai",
      "schedules": [
        {
          "daysOfWeek": [1, 2, 3, 4, 5],
          "startTime": "09:00",
          "endTime": "18:00"
        }
      ],
      "nextTransitionAt": "2026-09-15T10:00:00Z",
      "nextTransitionType": "END"
    }
  }
}

スケジュールが構成されていない場合、keepWarm は null、keepWarmActive は false です。

キープウォームスケジュールを更新する

キープウォームスケジュールを更新するには、完全な keepWarm オブジェクトを含む PATCH リクエストを送信します。Zilliz Cloud は、既存のスケジュールを送信されたスケジュールに置き換えます。

次の例では、既存のオンデマンドクラスターのキープウォームスケジュールを更新します。

bash
curl --request PATCH \
  --url "${BASE_URL}/v2/clusters/onDemandClusters/${CLUSTER_ID}" \
  --header "Authorization: Bearer ${TOKEN}" \
  --header "OrgId: org-xxxxxxxxxxxxxxxxxxx" \
  --header "Content-Type: application/json" \
  -d '{
    "keepWarm": {
      "enabled": true,
      "schedules": [
        {
          "daysOfWeek": [1, 2, 3, 4, 5],
          "startTime": "09:00",
          "endTime": "18:00"
        }
      ]
    }
  }'

応答例：

json
{
  "code": 0,
  "data": {
    "clusterId": "inxx-xxxxxxxxxxxxxxx"
  }
}

キープウォームスケジュールを無効化する

キープウォームスケジュールを無効化するには、完全な keepWarm オブジェクトを含む PATCH リクエストを送信し、enabled を false に設定します。

Note

スケジュールを無効化しても、構成済みのすべてのルールは保持されます。オンデマンドクラスターがキープウォームの時間枠内にある場合、Zilliz Cloud は直ちにキープウォームモードを終了します。スケジュールによってオンデマンドクラスターはサスペンドされません。

次の例では、既存のキープウォームスケジュールを無効化します。

bash
curl --request PATCH \
  --url "${BASE_URL}/v2/clusters/onDemandClusters/${CLUSTER_ID}" \
  --header "Authorization: Bearer ${TOKEN}" \
  --header "OrgId: org-xxxxxxxxxxxxxxxxxxx" \
  --header "Content-Type: application/json" \
  -d '{
    "keepWarm": {
      "enabled": false,
      "schedules": [
        {
          "daysOfWeek": [1, 2, 3, 4, 5],
          "startTime": "09:00",
          "endTime": "18:00"
        }
      ]
    }
  }'

応答例：

json
{
  "code": 0,
  "data": {
    "clusterId": "inxx-xxxxxxxxxxxxxxx"
  }
}

キープウォームスケジュールを削除する

キープウォームスケジュールを削除すると、スケジュールとすべてのルールが削除されます。オンデマンドクラスター、データ、イベント、監査レコードは削除されません。

キープウォームスケジュールを削除するには、空の schedules リストを含む PATCH リクエストを送信します。

bash
curl --request PATCH \
  --url "${BASE_URL}/v2/clusters/onDemandClusters/${CLUSTER_ID}" \
  --header "Authorization: Bearer ${TOKEN}" \
  --header "OrgId: org-xxxxxxxxxxxxxxxxxxx" \
  --header "Content-Type: application/json" \
  -d '{
    "keepWarm": {
      "enabled": false,
      "schedules": []
    }
  }'

応答例：

json
{
  "code": 0,
  "data": {
    "clusterId": "inxx-xxxxxxxxxxxxxxx"
  }
}

Web コンソールを使用する

EnHUwxZCUhT8hlbvMJRchiAQnfY

対象のオンデマンドクラスターに移動します。

Actions メニューを開き、Manage Keep-warm をクリックします。

Enable Keep-warm Schedule を有効にします。

Schedule Rules で、1 つ以上の毎週のルールを追加します。

各ルールについて、繰り返し曜日、開始時刻、終了時刻を構成します。

次の移行時刻を確認します。

Save をクリックします。

クラスターの詳細ページには、キープウォームスケジュールのステータスが表示されます。スケジュールが構成されている場合は、次の移行時刻も表示されます。

オンデマンドクラスターが現在キープウォームの時間枠内にある場合、ページにはプライマリクラスターステータスの横にセカンダリの Keep-warm タグが表示されます。

IF04w32RNhEbr7b8OBUcM8n3nnc

スケジュールを無効化しても、構成済みのすべてのルールは保持されます。オンデマンドクラスターがキープウォームの時間枠内にある場合、Zilliz Cloud は直ちにキープウォームモードを終了します。スケジュールによってオンデマンドクラスターはサスペンドされません。キープウォームスケジュールを無効化するには、以下に示すように Enable Keep-warm Schedule をオフにして Save をクリックします。

OzydwQkLjhVsoBbckHzciUAbnmc

オンデマンドクラスターを削除する

Danger

オンデマンドクラスターを削除すると、直ちに削除され、復元できません。この操作は元に戻せません。

RESTful API を使用する

bash
curl --request DELETE \
     --url "${BASE_URL}/v2/clusters/onDemandClusters/inxx-xxxxxxxxxxxxxxx" \
     --header "Authorization: Bearer ${TOKEN}" \
     --header "Accept: application/json"

応答例：

bash
{
  "code": 0,
  "data": {
    "clusterId": "inxx-xxxxxxxxxxxxxxx",
    "status": "DELETING"
  }
}

Web コンソールを使用する

H9p9wioiohNX3Ub6evBcWGTBnse

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

On-Demand Compute > Clusters に移動します。

対象のオンデマンドクラスターを選択します。

クラスターを削除し、操作を確認します。

オンデマンドクラスターの作成については、オンデマンドクラスターの作成を参照してください。
プロジェクトエンドポイント経由で接続するには、オンデマンド検索用の接続を参照してください。

すべてのオンデマンドクラスターを表示する​

RESTful API を使用する​

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

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

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

クラスター名、クラスター ID、ステータス、CU サイズ、エンドポイント、作成者、作成時刻を含むオンデマンドクラスターの一覧を確認します。

オンデマンドクラスターの詳細を確認する​

RESTful API を使用する​

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

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

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

対象クラスターをクリックして詳細を表示します。

クラスターのステータスを理解する​

オンデマンドクラスターの名前を変更する​

対象のオンデマンドクラスターに移動します。

Actions をクリックし、Rename を選択します。

クラスターの新しい名前を入力し、Save をクリックします。

オンデマンドクラスターの説明を編集する​

対象のオンデマンドクラスターに移動します。

説明にカーソルを合わせ、Edit description アイコンをクリックします。

クラスターの新しい説明を入力し、Save をクリックします。

オンデマンドクラスターを変更する​

キープウォームスケジュールを構成する​

RESTful API を使用する​

キープウォームスケジュールを作成する​

キープウォームスケジュールを表示する​

キープウォームスケジュールを更新する​

キープウォームスケジュールを無効化する​

キープウォームスケジュールを削除する​

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

対象のオンデマンドクラスターに移動します。

Actions メニューを開き、Manage Keep-warm をクリックします。

Enable Keep-warm Schedule を有効にします。

Schedule Rules で、1 つ以上の毎週のルールを追加します。

各ルールについて、繰り返し曜日、開始時刻、終了時刻を構成します。

次の移行時刻を確認します。

Save をクリックします。

オンデマンドクラスターを削除する​

RESTful API を使用する​

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

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

On-Demand Compute > Clusters に移動します。

対象のオンデマンドクラスターを選択します。

クラスターを削除し、操作を確認します。

関連トピック​

すべてのオンデマンドクラスターを表示する

RESTful API を使用する

Web コンソールを使用する

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

オンデマンドクラスターの詳細を確認する

RESTful API を使用する

Web コンソールを使用する

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

クラスターのステータスを理解する

オンデマンドクラスターの名前を変更する

オンデマンドクラスターの説明を編集する

オンデマンドクラスターを変更する

キープウォームスケジュールを構成する

RESTful API を使用する

キープウォームスケジュールを作成する

キープウォームスケジュールを表示する

キープウォームスケジュールを更新する

キープウォームスケジュールを無効化する

キープウォームスケジュールを削除する

Web コンソールを使用する

オンデマンドクラスターを削除する

RESTful API を使用する

Web コンソールを使用する

関連トピック