mc batch status

mcli 20261026 状态与退出码

mcli batch status TARGET JOBID 会持续观察批处理作业直至完成或失败。当实时指标暂未生成时，命令输出 pending（JSON 模式下为 status: "pending"），避免将排队中或暂缺采样点的任务误判为已完成。若连续 30 秒未收到任务指标或指标流提前中断，客户端会主动回查服务端持久化状态（单次查询超时为 10 秒）；若仍无法获取终态则返回错误，此时可重新运行命令继续观察。

只要成功获取到 complete 或 failed 终态，命令均以退出码 0 结束，自动化脚本应根据返回的 status 字段判断作业成败；当状态无法获取、任务不存在或请求出错时则返回非零退出码。此外，本版修复了海量对象下 IOPs 中间计算整数溢出的问题，详见本版变更。

mcli 20261109 与下一个 SILO 版本：暂停与跳过结果

mcli 20261109 与下一个配套的 SILO 版本增加 paused 和 complete-with-skips。paused 是非终态：服务器正在等待重试，实时指标仍可用时客户端继续观察。complete-with-skips 表示本轮已经结束，但仍保留了受保护版本或整 key 被拒绝的对象，不代表所有选中对象都已删除。与 complete、failed 一样，成功取得它时退出码为 0；脚本必须检查状态与计数。

文本输出按需显示 VersionsSkippedLocked、KeysRefused、FailureReason 和 PausedReason。JSON 保留原有 metric 对象，在新增的 details 下提供 versionsSkippedLocked、keysRefused、failureReason、pausedReason。两个计数的单位不同，分别是跳过的版本数和整 key 拒绝数，不能相加当作已删除对象数。

实时指标包含完整详情时，客户端直接使用该快照，其中显式的零计数可清除此前的暂停或跳过状态。服务端或 peer 不支持实时扩展时，客户端在观察期间每五秒刷新持久化详情，实时指标到达终态时再查询一次（单次请求以十秒为超时）。早于实时进度的快照不能把旧暂停状态带回来，也不能把旧计数拼接到更新的结果上。无法确认终态详情时，保留实时结果，JSON 增加 detailsUnavailable，文本给出说明；详情缺失不能理解为跳过数为零。未提供新增字段的旧服务器保留原有输出。

若实时流结束时持久状态仍为暂停，命令会输出暂停原因并以非零退出码结束，因为还没有终态。重新运行命令即可继续观察，不会取消或重新提交作业。

实时流结束后同样检查状态的新旧：保存的终态如果早于已经观察到的进度，命令会拒绝采用并以非零退出码结束。延迟到达的实时采样不能使进度倒退，同时声称完成和失败的报告也会被拒绝。

语法

mc batch status 命令会输出 MinIO 服务器上作业事件的汇总信息。

mcli batch status myminio "KwSysDpxcBU9FNhGkn2dCf"

mcli [GLOBALFLAGS] batch status TARGET JOBID

参数

TARGET

mc-cmd

Required

要显示批处理作业状态的 alias。

JOBID

mc-cmd

Required

要汇总的作业的唯一标识符。 要查找作业 ID，请使用 mc batch list。

TARGET 与 JOBID 都是必填参数。

全局标志

此命令支持 全局标志 中的任意选项。

示例

汇总活动复制作业的事件

以下命令会为 alias myminio 对应部署上的活动作业提供实时汇总：

mcli batch status myminio "KwSysDpxcBU9FNhGkn2dCf"

• 将 myminio 替换为应运行该作业的 MinIO 部署的 alias。

上述命令的输出如下所示：

●∙∙
JobType:        replicate
Objects:        28766
Versions:       28766
FailedObjects:  0
Transferred:    406 MiB
Elapsed:        2m14.227222868s
CurrObjName:    share/doc/xml-core/examples/foo.xmlcatalogs

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建，并针对 MinIO 和 AWS S3 进行了测试，以验证预期的功能与行为。

对于其他 S3 兼容服务，MinIO 不提供任何保证，因为这些服务的 S3 API 实现未知， 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作，但此类 用法需要你自行承担风险。