用途:查询 Zilliz Cloud 异步任务(Cloud Job)的状态,适用于备份、恢复、迁移、导入、克隆等由控制面异步发起、返回 jobId 的操作。
前置条件:已安装并登录 CLI(参见 setup 技能);拥有此前异步操作(如 backup create、import start)返回的 job ID。
主要命令: 查看任务:zilliz job describe --job-id <job-id> 等待完成:该命令支持 --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 停止等待,但不会取消任务本身。
限制:需要已登录的 CLI 和有效 job ID;资料未说明其他认证方式、并发限制或费用信息。