Skip to content

mc batch list

Note

Changed: MinIO

RELEASE.2022-10-09T21-10-59Z or later

Syntax

The mc batch list command outputs a list of the batch jobs currently in progress on a deployment.

The following command outputs a list of all jobs currently in progress on the myminio alias.

mc batch list myminio

The command has the following syntax:

mc [GLOBALFLAGS] batch list TARGET           \
                            --type "string"
  • Brackets [] indicate optional parameters.
  • Parameters sharing a line are mutually dependent.
  • Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

TARGET

mc-cmd

Required

The alias of the deployment for which you want to list jobs in progress.

--type

mc-cmd

Optional

List batch jobs only of a certain type.

Global Flags

This command supports any of the global flags.

Example

List all replicate type batch jobs

The following command lists the replicate type job(s) on the deployment at alias myminio:

mc batch list myminio --type "replicate"

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

  • Replace replicate with the job type to output.

    Currently, mc batch only supports the replicate job type.

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

ID                      TYPE            USER            STARTED
E24HH4nNMcgY5taynaPfxu  replicate       minioadmin      1 minute ago

S3 Compatibility

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

Permissions

You must have the admin:ListBatchJobs permission to list jobs on the deployment.

Last modified 2026-10-31 · 20261031 metrics update (5eaf62b)
Adapted from minio/docs, © 2020–Present MinIO, Inc., under CC BY 4.0. See attribution and change history.