mc ilm tier info

The mc ilm tier info command outputs statistics about a tier or all tiers for a deployment.

Syntax

mc ilm tier info myaistor WARM-TIER

mc ilm tier info TARGET [TIER_NAME]

Parameters

The command accepts the following arguments:

TARGET

Required

The alias of a configured MinIO AIStor deployment on which the desired tier exists.

TIER_NAME

Optional

The name of an existing remote tier to display. If omitted, the command outputs statistics for all tiers.

You must specify the tier in all-caps, for example, WARM_TIER.

If not specified, MinIO AIStor lists statistics for all existing tiers on the deployment.

Global flags

This command supports any of the global flags.

Example

Display the statistics for an existing tier

The following example displays the statistics of the tier WARM-TIER on the myaistor deployment.

mc ilm tier info myaistor WARM-TIER

Display the statistics for all existing tiers on a deployment

The following example displays the statistics of all existing tiers on the myaistor deployment.

mc ilm tier info myaistor

Behavior

S3 compatibility

This command uses a MinIO AIStor administrative API and does not work against other S3-compatible services.

Required permissions

MinIO AIStor requires the admin:ListTier administrative permission on the cluster. The command only reads tier statistics, so it does not need permission to change tiers or lifecycle rules.

For example, the following policy provides permission to view tier statistics:

{
   "Version": "2012-10-17",
   "Statement": [
      {
            "Action": [
               "admin:ListTier"
            ],
            "Effect": "Allow",
            "Sid": "EnableRemoteTierStatistics"
      }
   ]
}