SKILLOfficialdatabase

cluster

プラグイン: zilliz
ソース: GitHub で見る ↗

説明

次のような場合に使用: ユーザーが Zilliz Cloud のクラスター（複数のコンピュータを連携させた計算資源）を作成、一覧表示、説明、削除、停止、再開、または変更したいとき。

原文を表示

Use when the user wants to create, list, describe, delete, suspend, resume, or modify Zilliz Cloud clusters.

ユースケース

Zilliz Cloudのクラスターを作成したいとき
クラスターの一覧を表示したいとき
クラスターの詳細を確認したいとき
クラスターを削除したいとき
クラスターを停止・再開・変更したいとき

本文（日本語訳）

前提条件

CLIがインストールされ、ログイン済みであること（セットアップスキルを参照）。
クラスターコンテキストは不要 -- これらはコントロールプレーン操作です。

コマンドリファレンス

クラスターの作成

# サーバーレス クラスター
zilliz cluster create \
  --name <cluster-name> \
  --type serverless \
  --project-id <project-id> \
  --region <region-id>

# 無料ティア クラスター
zilliz cluster create \
  --name <cluster-name> \
  --type free \
  --project-id <project-id> \
  --region <region-id>

# 専用クラスター
zilliz cluster create \
  --name <cluster-name> \
  --type dedicated \
  --project-id <project-id> \
  --region <region-id> \
  --cu-type <Performance-optimized|Capacity-optimized> \
  --cu-size <cu-size>

利用可能なプロジェクトID、クラウドプロバイダー、リージョンを確認するには:

zilliz project list
zilliz cluster providers
zilliz cluster regions --cloud-id <aws|gcp|azure>

Vector Lake インスタンスの作成

Vector Lake（「VectorLake クラスター」と呼ばれることもあります）は、オンデマンドクラスターがアタッチするストレージレイヤーです（on-demand-cluster スキルを参照）。 POST /v2/clusters/createVectorLake を呼び出す専用サブコマンドで作成します:

zilliz cluster create-vectorlake \
  --project-id <project-id> \
  --region-id <region-id> \
  [--session-ttl <duration>] \      # アイドル時の自動サスペンドTTL（最小60秒）
  [--max-query-node-cu <integer>] \
  [--max-query-node-replicas <integer>]

Vector Lake が RUNNING 状態になったら、 zilliz on-demand-cluster create --project-id <id> --region-id <region> --cu-size <n> --cluster-name <name> でクエリワークロードをアタッチしてください。

クラスターの一覧表示

zilliz cluster list
# オプション: --region-id <filter-by-region-id>
# ページネーション: --page-size <n> --page <n>
# 全ページ取得: --all

クラスターの詳細表示

zilliz cluster describe --cluster-id <cluster-id>

クラスターの変更

zilliz cluster modify --cluster-id <cluster-id-to-modify>
# オプション: --cu-size <コンピュートユニット数>, --replica <レプリカ数>
# または生のJSONで指定: --body '{"cuSize": 2, "replica": 2}'

クラスターのサスペンド

zilliz cluster suspend --cluster-id <cluster-id-to-suspend>

クラスターの再開

zilliz cluster resume --cluster-id <cluster-id-to-resume>

クラスターの削除

zilliz cluster delete --cluster-id <cluster-id-to-delete>

クラウドプロバイダーの一覧表示

zilliz cluster providers

リージョンの一覧表示

zilliz cluster regions
# オプション: --cloud-id <aws|gcp|azure>

ガイダンス

クラスターを作成する前に、zilliz cluster providers および zilliz cluster regions を実行し、ユーザーがリージョンを選択できるよう案内してください。
クラスターの作成は非同期です。cluster create 実行後、クラスターのステータスは CREATING になります。データプレーン操作に進む前に、zilliz cluster describe --cluster-id <id> でポーリングし、ステータスが RUNNING になるまで待機してください。
クラスターを削除する前は、必ずユーザーに確認を取ってください -- この操作は取り消せません。
クラスターを作成したら、zilliz context set --cluster-id <id> でアクティブコンテキストとして設定することを提案してください。
クラスターがサスペンド中の場合は、データプレーン操作の前に再開が必要であることをユーザーに通知してください。
クラスタータイプによって利用できる機能が異なります。詳細はセットアップスキルの「クラスタータイプの違い」表を参照してください。
cluster create-vectorlake は通常のクラスターではなく、Vector Lake ストレージインスタンスを作成します。このインスタンスへのクエリワークロードはオンデマンドクラスター上で実行されます（on-demand-cluster スキルを参照）。このサブコマンドに --type は指定しないでください。専用のパラメーターセットが用意されています。
cluster list では --region-id <region> フィルターで対象リージョンを絞り込むことができます。

原文（English）を表示

Prerequisites

CLI installed and logged in (see setup skill).
No cluster context required -- these are control-plane operations.

Commands Reference

Create a Cluster

# Serverless cluster
zilliz cluster create \
  --name <cluster-name> \
  --type serverless \
  --project-id <project-id> \
  --region <region-id>

# Free-tier cluster
zilliz cluster create \
  --name <cluster-name> \
  --type free \
  --project-id <project-id> \
  --region <region-id>

# Dedicated cluster
zilliz cluster create \
  --name <cluster-name> \
  --type dedicated \
  --project-id <project-id> \
  --region <region-id> \
  --cu-type <Performance-optimized|Capacity-optimized> \
  --cu-size <cu-size>

To find available project IDs, cloud providers, and regions:

zilliz project list
zilliz cluster providers
zilliz cluster regions --cloud-id <aws|gcp|azure>

Create a Vector Lake instance

A Vector Lake (sometimes called a "VectorLake" cluster) is the storage layer that on-demand clusters attach to (see the on-demand-cluster skill). It is created via a hand-written subcommand calling POST /v2/clusters/createVectorLake:

zilliz cluster create-vectorlake \
  --project-id <project-id> \
  --region-id <region-id> \
  [--session-ttl <duration>] \      # idle auto-suspend TTL, min 60s
  [--max-query-node-cu <integer>] \
  [--max-query-node-replicas <integer>]

After the Vector Lake is RUNNING, attach a query workload with zilliz on-demand-cluster create --project-id <id> --region-id <region> --cu-size <n> --cluster-name <name>.

List Clusters

zilliz cluster list
# Optional: --region-id <filter-by-region-id>
# Pagination: --page-size <n> --page <n>
# Fetch all pages: --all

Describe a Cluster

zilliz cluster describe --cluster-id <cluster-id>

Modify a Cluster

zilliz cluster modify --cluster-id <cluster-id-to-modify>
# Optional: --cu-size <number-of-compute-units>, --replica <number-of-replicas>
# Or use raw JSON: --body '{"cuSize": 2, "replica": 2}'

Suspend a Cluster

zilliz cluster suspend --cluster-id <cluster-id-to-suspend>

Resume a Cluster

zilliz cluster resume --cluster-id <cluster-id-to-resume>

Delete a Cluster

zilliz cluster delete --cluster-id <cluster-id-to-delete>

List Cloud Providers

zilliz cluster providers

List Regions

zilliz cluster regions
# Optional: --cloud-id <aws|gcp|azure>

Guidance

Before creating a cluster, help the user choose a region by running zilliz cluster providers and zilliz cluster regions.
Cluster creation is asynchronous. After cluster create, the cluster status will be CREATING. Poll with zilliz cluster describe --cluster-id <id> until the status becomes RUNNING before proceeding with data-plane operations.
Before deleting a cluster, always confirm with the user -- this is irreversible.
After creating a cluster, suggest setting it as the active context with zilliz context set --cluster-id <id>.
When a cluster is suspended, remind the user it must be resumed before data-plane operations.
Different cluster types have different capabilities. See the "Cluster Type Differences" table in the setup skill for details.
cluster create-vectorlake creates a Vector Lake storage instance, not a regular cluster. Query workloads against it run on on-demand clusters (see the on-demand-cluster skill). Do not pass --type to this subcommand; it has its own dedicated parameter set.
cluster list supports a --region-id <region> filter for scoping to a single region.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。