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

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"
レスポンス

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

指定した CLUSTER_ID に対して要求された Cluster を含む成功レスポンス本文です。

codeinteger<int32>

レスポンスコード。

dataobject

レスポンスペイロード。

clusterIdstring

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

clusterNamestring

クラスター名。

projectIdstring

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

descriptionstring

クラスターの説明。

regionIdstring

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

cuTypestring

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

planstring

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

statusstring

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

connectAddressstring

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

privateLinkAddressstring

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

publicAddressEnabledboolean

クラスターでパブリックエンドポイントが有効かどうか。未設定の場合は省略されます。

createTimestring<date-time>

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

replicainteger<int32>

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

cuSizeinteger<int64>

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

storageSizeinteger<int64>

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

snapshotNumberinteger<int32>

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

createProgressinteger<int32>

クラスターの作成進捗。

deploymentOptionstring

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

autoscalingobject

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

cuobject

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

mininteger<int64>

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

maxinteger<int64>

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

schedulesarray

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

[]schedulesobject

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

cronstring

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

値の例: 0 0 * * *
targetinteger<int64>

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

timezonestring

cron スケジュールのタイムゾーン。

replicaobject

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

mininteger<int64>

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

maxinteger<int64>

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

schedulesarray

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

[]schedulesobject

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

cronstring

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

値の例: 0 0 * * *
targetinteger<int64>

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

timezonestring

cron スケジュールのタイムゾーン。

globalClusterMetaobject

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

globalClusterIdstring

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

rolestring

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

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

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。