mc admin ilm-scanner status

Retrieves the current status of the lifecycle scanner. Supports global overview, per-bucket detail, and verbose mode with active bucket breakdowns.

Syntax

mc admin ilm-scanner status [FLAGS] TARGET [BUCKET]

Following are the status values displayed:

Table 1. Status Values for mc admin ilm-scanner status command
Status Description
idle Scanner is not running any scan
active Scanner is currently running one or more scans
disabled Scanner is disabled cluster-wide
Table 2. Last scan status values
Status Description
completed Last scan finished successfully
aborted Last scan was aborted
failed Last scan failed with an error
none No scan has run yet

Parameters

Parameter Description
TARGET The alias of a configured HPE Data Fabric Object Store on which the command creates or updates a policy. This parameter is mandatory.
BUCKET The bucket to be scanned. This is an optional parameter. When no bucket is specified, the command stops all running scans.
--verbose, -v Use either --verboseor -v to display per-bucket details for all active scans at the object store level.
--json Use to display the output in JSON format.

Examples

Sample output for global status

Text output

CLI 
$ mc admin ilm-scanner status myminio
Scanner status: active, Buckets under scan: 3, Throttle min wait: 5s, Throttle max wait: 20s

JSON output

CLI
$ mc admin ilm-scanner status --json myminio
{
  "op": "status",
  "status": "active",
  "num_buckets_under_scan": 3,
  "scan_delay_min": "5s",
  "scan_delay_max": "20s"
}

Sample output for global status - verbose

Text output

CLI 
$ mc admin ilm-scanner status --verbose myminio
Scanner status: active, Buckets under scan: 3, Throttle min wait: 5s, Throttle max wait: 20s
  Active bucket details:
    Bucket: bucket-a, Objects deleted: 142, Size reclaimed: 3.5 GiB, Current throttle: 5s
    Bucket: bucket-b, Objects deleted: 38, Size reclaimed: 512 MiB, Current throttle: 5s
    Bucket: bucket-c, Objects deleted: 10, Size reclaimed: 128 MiB

JSON output

CLI
$ mc admin ilm-scanner status --json --verbose myminio
{
  "op": "status",
  "status": "active",
  "num_buckets_under_scan": 3,
  "scan_delay_min": "5s",
  "scan_delay_max": "20s",
  "buckets": [
    {
      "bucket": "bucket-a",
      "status": "active",
      "objects_deleted": 142,
      "size_reclaimed": "3.5 GiB",
      "scan_delay_current": "5s"
    },
    {
      "bucket": "bucket-b",
      "status": "active",
      "objects_deleted": 38,
      "size_reclaimed": "512 MiB",
      "scan_delay_current": "5s"
    },
    {
      "bucket": "bucket-c",
      "status": "active",
      "objects_deleted": 10,
      "size_reclaimed": "128 MiB"
    }
  ]
}

Sample output for per-bucket status - never scanned

Text output

CLI 
$ mc admin ilm-scanner status myminio/mybucket
Scanner status for bucket mybucket: idle

JSON output

CLI
$ mc admin ilm-scanner status --json myminio/mybucket
{
  "bucket": "mybucket",
  "status": "idle"
}

Sample output for per-bucket status -idle, last scan completed

Text output

CLI 
$ mc admin ilm-scanner status myminio/mybucket
Scanner status for bucket mybucket: idle, Last scan status: completed, Objects deleted: 350, Size reclaimed: 12.8 GiB, Last scan time: 2026-03-30 14:22:05

JSON output

CLI
$ mc admin ilm-scanner status --json myminio/mybucket
{
  "bucket": "mybucket",
  "status": "idle",
  "last_scan_status": "completed",
  "last_scan_time": "2026-03-30 14:22:05",
  "objects_deleted": 350,
  "size_reclaimed": "12.8 GiB"
}

Sample output for scanner disabled

Text output

CLI 
$ mc admin ilm-scanner status myminio
Scanner status: disabled, Throttle min wait: 5s, Throttle max wait: 20s