SKILLOfficialdatabase

privatelink

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

説明

次のような場合に使用: - ユーザーが利用可能なPrivateLink（専用接続サービス）のエンドポイント一覧を表示したい - プロジェクト内のPrivateLink接続を一覧表示・作成・削除したい - Zilliz Cloud上でエンドポイントのアクセス許可リストを管理したい

原文を表示

Use when the user wants to list available PrivateLink endpoint services, list/create/delete PrivateLink endpoints for a project, or manage the endpoint whitelist on Zilliz Cloud.

ユースケース

PrivateLinkエンドポイント一覧を表示したい
接続の一覧表示・作成・削除
エンドポイントのアクセス許可リストを管理したい

本文（日本語訳）

前提条件

CLIがインストール済みでログイン済みであること（setup skillを参照）。
エンドポイントを紐付けるプロジェクトが存在すること（project-region skillを参照）。

コマンドリファレンス

利用可能なPrivateLinkエンドポイントサービスの一覧表示

zilliz privatelink list-services
# オプション: --region-id <クラウドリージョンでフィルタリング>

Privatelinkの一覧表示

zilliz privatelink list --project-id <project-id>

Privatelinkの作成

zilliz privatelink create \
  --project-id <project-id> \
  --region-id <cloud-region> \
  --endpoint-id <vpc-endpoint-id>
# オプション: --gcp-project-id <gcp-project-id>

Privatelinkの削除

zilliz privatelink delete --project-id <project-id> --endpoint-id <endpoint-id-to-delete>

PrivateLinkエンドポイントのホワイトリストへのリージョン追加

zilliz privatelink add-whitelist --project-id <project-id> --region-id <cloud-region-to-whitelist>

ガイダンス

PrivateLinkを使用すると、クラスターをパブリックインターネット経由ではなく、クラウドプロバイダーのプライベートネットワーク（AWS PrivateLink、GCP Private Service Connect、Azure Private Link）経由で接続できます。エンドポイントはプロジェクトおよびリージョン単位でスコープされます。
新規エンドポイントの設定ワークフロー:
1. zilliz privatelink list-services --region-id <region> を実行し、対象リージョンの endpointService の値と whitelistRequired が true かどうかを確認する。
2. whitelistRequired が true の場合は、先に zilliz privatelink add-whitelist --project-id <id> --region-id <region> を実行し、対象リージョンでそのプロジェクトがエンドポイントを紐付けられるよう許可しておく。
3. 自身のクラウドアカウント上でVPCエンドポイントを作成し（AWS/GCP/Azureのコンソールまたはインフラコード経由で帯域外に実施）、そのエンドポイントID（例: vpce-xxxx）を控えておく。
4. zilliz privatelink create --project-id <id> --region-id <region> --endpoint-id <vpce-id> で登録する。GCPの場合は --gcp-project-id <gcp-project> も合わせて指定すること。
list はプロジェクト単位での実行となります: zilliz privatelink list --project-id <id>。グローバルな一覧表示はできません。
delete は取り消し不可の操作です。特に本番環境では、必ずユーザーに確認を取ってください。削除後、該当エンドポイントからの既存の接続は即座に切断されます。
クラスターに対してPrivateLinkを有効化すると、クラスターのエンドポイントURLがプライベートDNS形式に切り替わります。 zilliz cluster describe --cluster-id <id> を再実行して最新のエンドポイントを取得し、接続先の設定を更新してください。

原文（English）を表示

Prerequisites

CLI installed and logged in (see setup skill).
A project to attach endpoints to (see project-region skill).

Commands Reference

List available PrivateLink endpoint services

zilliz privatelink list-services
# Optional: --region-id <filter-by-cloud-region>

List Privatelinks

zilliz privatelink list --project-id <project-id>

Create a Privatelink

zilliz privatelink create \
  --project-id <project-id> \
  --region-id <cloud-region> \
  --endpoint-id <vpc-endpoint-id>
# Optional: --gcp-project-id <gcp-project-id>

Delete a Privatelink

zilliz privatelink delete --project-id <project-id> --endpoint-id <endpoint-id-to-delete>

Add region to PrivateLink endpoint whitelist

zilliz privatelink add-whitelist --project-id <project-id> --region-id <cloud-region-to-whitelist>

Guidance

PrivateLink lets a cluster be reached over a cloud-provider private network (AWS PrivateLink, GCP Private Service Connect, Azure Private Link) instead of the public internet. Endpoints are scoped to a project and a region.
Workflow for a new endpoint:
1. zilliz privatelink list-services --region-id <region> to find the endpointService value for that region (and whether whitelistRequired is true).
2. If whitelistRequired is true, call zilliz privatelink add-whitelist --project-id <id> --region-id <region> first so the project is allowed to attach an endpoint in that region.
3. Create the VPC endpoint in your own cloud account (out-of-band, in the AWS/GCP/Azure console or via IaC) and capture its endpoint ID (e.g. vpce-xxxx).
4. Register it with zilliz privatelink create --project-id <id> --region-id <region> --endpoint-id <vpce-id>. For GCP, also pass --gcp-project-id <gcp-project>.
list is per-project: zilliz privatelink list --project-id <id>. There is no global listing.
delete is irreversible -- always confirm with the user, especially in production. Existing connections from that endpoint stop working immediately.
After enabling PrivateLink for a cluster, the cluster's endpoint URL switches to the private DNS form. Re-run zilliz cluster describe --cluster-id <id> to fetch the updated endpoint and update any consumer config.

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