mc batch status

mcli 20261026 状态与退出码

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

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

语法

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 命令 可能 仍能按文档说明工作，但此类 用法需要你自行承担风险。