スナップショット復元ジョブを一覧表示 (V2)
On Requestスナップショット復元ジョブを一覧表示します。データベースまたはコレクションでフィルタリングすることもできます。
https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530
- サービングクラスターを使用している場合は、クラスターエンドポイントを使用してください。
Free & Serverless
https://{cluster-id}.serverless.{region}.vectordb.zillizcloud.comDedicated
https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530
export CLUSTER_ENDPOINT="https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530"
認証トークンは、適切な権限を持つ API key である必要があります。
フィルタリングに使用するデータベースの名前。
フィルタリングに使用するコレクションの名前。
export TOKEN="YOUR_API_KEY"
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/jobs/snapshot/list" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
"dbName": "default",
"collectionName": "my_collection"
}'
スナップショット復元ジョブを一覧表示します。データベースまたはコレクションでフィルタリングすることもできます。
スナップショットジョブを一覧表示する操作のレスポンスボディで、code と、data ペイロードまたは message を含みます。
レスポンスコード。
一覧表示操作で返されるスナップショットジョブの records を含むレスポンスペイロード。
リクエストのフィルターに一致するスナップショット復元ジョブ。
スナップショット復元ジョブの詳細情報。
復元ジョブの一意の識別子。
復元中のスナップショットの名前。
ターゲットデータベース名。
ターゲットコレクション名。
復元ジョブの現在の状態。
復元ジョブの進行状況(パーセント)。
復元ジョブが失敗した場合の失敗理由。
復元ジョブが開始されたタイムスタンプ。
復元ジョブの経過時間(ミリ秒)。
スナップショットジョブを一覧表示する操作のレスポンスボディで、code と、data ペイロードまたは message を含みます。
レスポンスコード。
エラーメッセージ。
{
"code": 0,
"data": {
"records": [
{
"jobId": 451799928999570200,
"snapshotName": "snapshot_2026_01",
"dbName": "default",
"collectionName": "my_collection",
"state": "RestoreSnapshotCompleted",
"progress": 100,
"reason": "",
"startTime": "2026-01-01T00:00:00Z",
"timeCost": 1200
}
]
}
}