claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdatabase

⏳job

プラグイン
zilliz
ソース
GitHub で見る ↗

説明

次のような場合に使用: ユーザーが非同期クラウドジョブ（バックアップ、リストア、マイグレーション、インポート、またはクローン）のステータスを確認したいとき。 また、長時間実行される操作の完了を待機したいときにも使用。

原文を表示

Use when the user wants to check the status of an async Cloud Job (backup, restore, migration, import, or clone). Also use when the user wants to wait for a long-running operation to complete.

ユースケース

  • ✓非同期クラウドジョブのステータスを確認したいとき
  • ✓バックアップ処理の進行状況を確認するとき
  • ✓リストア操作の完了を待機するとき
  • ✓マイグレーション処理の状況を確認するとき
  • ✓長時間実行される操作の完了を待機するとき

本文（日本語訳）

前提条件

  1. CLIがインストールされ、ログイン済みであること（セットアップスキルを参照）。
  2. 以前の非同期オペレーション（バックアップ作成、インポート開始など）から取得したジョブIDがあること。

コマンドリファレンス

ジョブの詳細確認

zilliz job describe --job-id <job-id>

完了まで待機する

job describe コマンドは --wait フラグをサポートしており、ジョブが完了するまでポーリングを続けます:

# 完了までポーリング（デフォルト: 5秒間隔、30分タイムアウト）
zilliz job describe --job-id <job-id> --wait

# タイムアウトと間隔をカスタム指定
zilliz job describe --job-id <job-id> --wait --timeout 600 --interval 10

ジョブタイプ

タイプ トリガーとなる操作
BACKUP backup create
RESTORE backup restore-cluster、backup restore-collection
IMPORT import start
MIGRATION クラウドマイグレーション操作
CLONE_COLLECTION コレクションのクローン操作

ジョブステータス

ステータス 意味
PENDING ジョブがキューに入っている
IN_PROGRESS ジョブが実行中
SUCCESSFUL ジョブが正常に完了した
FAILED ジョブが失敗した（reason フィールドを確認）
CANCELING ジョブのキャンセル処理中
CANCELED ジョブがキャンセルされた

ガイダンス

  • コントロールプレーンの多くの操作は非同期であり、jobId を返します。進捗を追跡するには job describe の使用を推奨してください。
  • ジョブが失敗した場合、reason フィールドにエラーメッセージが含まれます。ユーザーに表示してください。
  • クラスター作成やデータマイグレーションなど長時間かかる操作では、ユーザーが手動でポーリングしなくて済むよう --wait の使用を提案してください。
  • --wait フラグはリアルタイムの進捗スピナーを表示します。ユーザーは Ctrl+C を押すことで、ジョブ自体をキャンセルすることなく待機を中断できます。
原文（English）を表示

Prerequisites

  1. CLI installed and logged in (see setup skill).
  2. A job ID from a previous async operation (backup create, import start, etc.).

Commands Reference

Describe a Job

zilliz job describe --job-id <job-id>

Wait for Completion

The job describe command supports a --wait flag to poll until the job finishes:

# Poll until done (default: 5s interval, 30min timeout)
zilliz job describe --job-id <job-id> --wait

# Custom timeout and interval
zilliz job describe --job-id <job-id> --wait --timeout 600 --interval 10

Job Types

Type Triggered By
BACKUP backup create
RESTORE backup restore-cluster, backup restore-collection
IMPORT import start
MIGRATION Cloud migration operations
CLONE_COLLECTION Collection clone operations

Job Statuses

Status Meaning
PENDING Job is queued
IN_PROGRESS Job is running
SUCCESSFUL Job completed successfully
FAILED Job failed (check reason field)
CANCELING Job is being cancelled
CANCELED Job was cancelled

Guidance

  • Many control-plane operations are asynchronous and return a jobId. Suggest using job describe to track progress.
  • When a job fails, the reason field contains the error message. Display it to the user.
  • For long-running operations (cluster creation, data migration), suggest using --wait so the user doesn't have to poll manually.
  • The --wait flag shows a live progress spinner. Users can press Ctrl+C to stop waiting without cancelling the job itself.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。