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

Cluster Backup の復元 (V2)

同じクラウドリージョン内の同じ CU タイプの新しい専用クラスターにクラスターバックアップを復元します。この API は専用クラスターにのみ適用されることに注意してください。

POST/v2/clusters/{CLUSTER_ID}/backups/{BACKUP_ID}/restoreCluster
接続エンドポイント

https://api.cloud.zilliz.com

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

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

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

バックアップ対象のクラスターの ID。

値の例： inxx-xxxxxxxxxxxxxxx
BACKUP_IDstringpath必要

対象のバックアップの ID。

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

復元後のクラスターが属するプロジェクトの ID。パスで指定されたクラスターがそのプロジェクトに紐付くリージョン内に存在しない場合、復元は失敗します。

clusterNamestring必要

復元後のクラスターの名前。

cuSizeinteger必要

復元後のクラスターに割り当てられる CU サイズ。

値の範囲： ≥ 1≤ 1024
collectionStatusstring必要

復元後のクラスター内のコレクションのステータス。

restoreVersionPolicystring

復元後のクラスターに使用する Milvus バージョンを選択するポリシー。指定可能な値は次のとおりです:

  • LATEST: クラスターを利用可能な最新の互換性のある GA Milvus バージョンに復元します。
  • ORIGINAL: クラスターを元の互換性のある Milvus バージョンに復元します。
bash
export TOKEN="YOUR_API_KEY"
export CLUSTER_ID="inxx-xxxxxxxxxxxxxxx"
export BACKUP_ID="backup-xxxxxxxxxxxxxxx"

curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/${BACKUP_ID}/restoreCluster" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "projectId": "proj-xxxxxxxxxxxxxxxxxxxx",
    "clusterName": "Dedicated-12",
    "cuSize": 2,
    "collectionStatus": "KEEP",
    "restoreVersionPolicy": "LATEST"
}'
レスポンス200 OK - application/json

レスポンス

codeinteger

レスポンスコード。

dataobject

復元後のクラスター情報を含むレスポンスペイロード。

clusterIdstring

復元後のクラスターの ID。

usernamestring

復元後のクラスターへのアクセスに使用するユーザー名。

passwordstring

復元後のクラスターへのアクセスに使用するパスワード。これは一度だけ表示されます。パスワードは控えて、安全な場所に保存することを推奨します。

jobIdstring

このリクエストによって作成されるクラスター復元ジョブの ID。

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

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。

Successjson
{
    "code": 0,
    "data": {
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "username": "db_admin",
        "password": "xxxxxxxxx",
        "jobId": "job-xxxxxxxxxxxxxx"
    }
}
Ctrl I