mc batch status

mcli 20261026 status and exit codes

mcli batch status TARGET JOBID follows a batch job until it completes or fails. When live metrics are not yet available, it reports pending (status: "pending" in JSON) rather than treating a queued job or missing metric sample as complete. If no job metrics arrive for 30 seconds or the stream ends early, the client queries persisted job status (with a 10-second timeout per request) and returns an error if no terminal state is available; re-run the command to resume observation.

Successfully retrieving either a complete or failed terminal state exits 0—automation scripts should inspect the returned status field to determine whether the job succeeded. Unavailable status, missing jobs, and request errors exit non-zero. IOPs calculations also no longer overflow at large object counts; see the release changes.

mcli 20261109 and next SILO release: pauses and skipped work

mcli 20261109 and the next coordinated SILO release add paused and complete-with-skips. paused is nonterminal: the server is waiting to retry, and the client keeps observing while live metrics remain available. complete-with-skips means the run finished but left protected versions or refused keys in place. It does not mean every selected object was removed. Like complete and failed, retrieving it exits 0; scripts must inspect the status and counters.

The text display includes VersionsSkippedLocked, KeysRefused, FailureReason, and PausedReason when present. JSON preserves the existing metric object and adds those fields under details as versionsSkippedLocked, keysRefused, failureReason, and pausedReason. The counters have different units: skipped versions and refused whole keys. They must not be added to get a count of deleted objects.

The client uses a complete live snapshot when available, including explicit zero counts to clear a previous pause or skip count. For servers or peers without the live extension, it refreshes saved details every five seconds during observation and once when live metrics report a terminal result (with a ten-second timeout per request). A saved snapshot older than live progress cannot restore a stale pause or attach old counters to a newer outcome. If terminal details cannot be confirmed, the live outcome remains visible with detailsUnavailable in JSON and an explanation in text; absent details must not be read as zero skips. Older servers without the added fields retain their existing output.

If the live stream ends while the saved state is still paused, the command prints the pause reason and exits nonzero because it has no terminal result. Re-run the command to continue observation; this does not cancel or resubmit the job.

The same freshness check applies after the stream ends: a saved terminal result older than the progress already observed is rejected with a nonzero exit status. Delayed live samples cannot move progress backward, and a report that claims both complete and failed is rejected.

Syntax

The mc batch status command outputs summaries of job events on a MinIO server.

mcli batch status myminio "KwSysDpxcBU9FNhGkn2dCf"

mcli [GLOBALFLAGS] batch status TARGET JOBID

Parameters

TARGET

mc-cmd

Required

The alias for which to display batch job statuses.

JOBID

mc-cmd

Required

The unique identifier of a job to summarize. To find the ID of a job, use mc batch list.

Both TARGET and JOBID are required.

Global Flags

This command supports any of the global flags.

Example

Summarize the Events of an Active Replicate Job

The following command provides the real-time summary of an active job on the deployment at alias myminio:

mcli batch status myminio "KwSysDpxcBU9FNhGkn2dCf"

• Replace myminio with the alias of the MinIO deployment that should run the job.

The output of the above command is similar to the following:

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

S3 Compatibility

SILO is the supported server for PGSTY mcli; compatibility with upstream MinIO and other S3 services is best effort.