mc ilm tier check
The mc ilm tier check command checks that a deployment can connect to a remote tier.
The command reports whether the check succeeded.
Syntax
The following example checks the existing remote tier called WARM-TIER on the myaistor deployment.
mc ilm tier check myaistor WARM-TIERThe command has the following syntax:
mc ilm tier check TARGET TIER_NAME- 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
The command accepts the following arguments:
TARGET
Required
The alias of a configured MinIO AIStor deployment on which the desired tier exists.
TIER_NAME
Required
The name of an existing remote tier to check.
You must specify the tier in all-caps, for example, WARM_TIER.
Global flags
This command supports any of the global flags.
Example
Check an existing tier
The following example checks the tier WARM-TIER on the myaistor deployment.
mc ilm tier check myaistor WARM-TIERBehavior
Tier configuration availability
If MinIO AIStor cannot read the remote tier configuration, this command fails with 503 XMinioAdminTierNotInitialized instead of returning an empty list.
See When the tier configuration is unavailable.
S3 compatibility
This command uses a MinIO AIStor administrative API and does not work against other S3-compatible services.
Required permissions
For permissions required to review a tier, refer to the required permissions on the parent command.