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

グローバルクラスターの切り替え (V2)

Performs a planned switch from the current primary cluster to a specified secondary cluster.

POST/v2/globalClusters/{globalClusterId}/switchover
接続エンドポイント

https://api.cloud.zilliz.com

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

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

値の例： Bearer {{TOKEN}}
globalClusterIdstringpath必要

Global Cluster の ID。

値の例： glo-xxxxxxxxxxxxxxx
リクエスト・ボディapplication/json
newPrimaryClusterIdstring必要

新しいプライマリクラスターとして昇格させるセカンダリクラスターの ID。

値の例： in01-secondary
Examplebash
export TOKEN="YOUR_API_KEY"
export globalClusterId="glo-xxxxxxxxxxxxxxx"

curl --request POST \
--url "${BASE_URL}/v2/globalClusters/${globalClusterId}/switchover" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "newPrimaryClusterId": "in01-secondary"
}'
レスポンス200 OK - application/json

切り替えジョブを返します。

globalClusterIdstring

Global Cluster ID。

値の例： glo-xxxxxxxxxxxxxxx
oldPrimaryClusterIdstring

以前のプライマリクラスター ID。

値の例： in01-primary
newPrimaryClusterIdstring

新しいプライマリクラスター ID。

値の例： in01-secondary
jobIdstring

非同期操作の Job ID。

値の例： job-xxxxxxxxxxxxxxx

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

codeinteger

レスポンスコード。

値の例： 400
messagestring

エラーメッセージ。

値の例： Invalid request parameters.
Successjson
{
    "globalClusterId": "glo-xxxxxxxxxxxxxxx",
    "oldPrimaryClusterId": "in01-primary",
    "newPrimaryClusterId": "in01-secondary",
    "jobId": "job-xxxxxxxxxxxxxxx"
}
Ctrl I