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

Cluster を詳細表示 (V2)

クラスターの詳細情報を表示します。

GET/v2/clusters/{CLUSTER_ID}
接続エンドポイント

https://api.cloud.zilliz.com

shell
export BASE_URL="https://api.cloud.zilliz.com"
パラメータ
Authorizationstringheader必要

認証トークンには、適切な権限を持つ API key を使用する必要があります。

値の例: Bearer {{TOKEN}}
Acceptstringheader

application/json を使用します。

値の例: application/json
CLUSTER_IDstringpath必要

詳細情報を返す対象のクラスターの ID。

値の例: inxx-xxxxxxxxxxxxxxx
bash
export TOKEN="YOUR_API_KEY"
export CLUSTER_ID="inxx-xxxxxxxxxxxxxxx"

curl --request GET \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Accept: application/json" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
レスポンス

指定したクラスターの詳細情報を返します。

codeinteger

レスポンスコード。

dataobject

レスポンスペイロード。

clusterIdstring

指定したクラスターの ID。

clusterNamestring

クラスター名。

projectIdstring

クラスターが属するプロジェクトの ID。

descriptionstring

クラスターの説明。

regionIdstring

クラスターをホストするクラウドリージョンの ID。

cuTypestring

クラスターのタイプ。
これは専用クラスターにのみ適用されます。Free および serverless クラスターでは、この値は空です。

planstring

クラスターが属するプロジェクトのサブスクリプションプラン。指定可能な値は FreeServerlessStandardEnterprise です。

statusstring

クラスターの現在のステータス。

connectAddressstring

クラスターのパブリックエンドポイント。

privateLinkAddressstring

クラスターのプライベートリンク。

replicastring

クラスターのレプリカ数。

cuSizeinteger

クラスターの CU サイズ。Free および serverless クラスターでは、この値は常に 0 です。

値の範囲: 0≤ 256
storageSizeinteger

このクラスターで使用されるストレージサイズ。

snapshotNumberinteger

作成されたバックアップの数。

createProgressinteger

クラスターの作成進捗。

createTimestring

クラスターが作成された時刻。

deploymentOptionstring

クラスターのデプロイオプション。

autoscalingobject

クラスターのオートスケーリング設定。

cuobject

CU のオートスケーリング設定。

mininteger

オートスケーリング時の最小 CU 数。このパラメーターと schedules は相互排他的です。

値の範囲: > 1≤ 256
maxinteger

オートスケーリング時の最大 CU 数。このパラメーターと schedules は相互排他的です。

値の範囲: > 1≤ 256
schedulesarray

オートスケーリングのスケジュール。このパラメーターと min/max は相互排他的です。

[]schedulesobject

オートスケーリングスケジュール。

cronstring

スケジュールを定義する Cron 式。

値の例: 0 0 * * *
targetinteger

このスケジュールの対象 CU 数。

replicaobject

レプリカのオートスケーリング設定。

mininteger

オートスケーリング時の最小レプリカ数。このパラメーターと schedules は相互排他的です。

値の範囲: > 1≤ 10
maxinteger

オートスケーリング時の最大レプリカ数。このパラメーターと schedules は相互排他的です。

値の範囲: > 1≤ 10
schedulesarray

オートスケーリングのスケジュール。このパラメーターと min/max は相互排他的です。

[]schedulesobject

オートスケーリングスケジュール。

cronstring

スケジュールを定義する Cron 式。

値の例: 0 0 * * *
targetinteger

このスケジュールの対象レプリカ数。

globalClusterMetaobject

現在のクラスターがグローバルクラスターに属している場合の、そのグローバルクラスターのメタデータ。そうでない場合、このフィールドは null です。

globalClusterIdstring

グローバルクラスターの ID。

rolestring

グローバルクラスター内でのクラスターの役割。指定可能な値は PRIMARYSECONDARY です。

エラーメッセージを返します。

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。