mc admin object info
Description
mc admin object info displays a summary of part and shard information about a specified object.
The output includes information for each part or shard of the object, including:
- Part number
- Pool number
- Node
- Erasure set
- Drive
- Filename
- Size
By default, the output uses a set of gridded blocks to indicate the parts of object. Colors indicate the status of the specific part.
- Green: Part is ok
- Red: Missing part or otherwise has an error, check output for suggestions
- Orange: Unknown or unexpected part, check output for suggestions
- Gray: Missing version
Syntax
The following command displays part and shard details, including missing parts, for the object my-file.txt at the alias myaistor and the bucket mybucket:
mc admin object info myaistor/mybucket/my-file.txtThe command has the following syntax:
mc admin object info [FLAGS] TARGET \
[--bitrot] \
[--err] \
[--import <value>] \
[--list] \
[--versions]- 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
Required
The full path to the object about which to display information.
Specify the alias of a configured MinIO AIStor deployment, the bucket that contains the object, the prefix, and the object.
For example:
mc admin object info myaistor/mybucket/my-prefix/object.json--bitrot
Perform a bit rot check on the specified object.
--err
Limit output to show only parts that are missing or have errors.
--import
Return output from a previously downloaded JSON formatted summary file.
Provide the path to the .json file to show.
You can output the summary to JSON for an object by using the global --json flag.
--list
Show the output as a list instead of using graphical-style blocks.
--versions
Include version IDs and directories.
Examples
Output basic information about an object’s missing parts
The following command outputs information about the parts that are missing for my-object in the bucket bucket on the server at the alias myaistor:
mc admin object info myaistor/bucket/my-objectOutput information about an object as a list
The following command outputs information about a file as a list instead of blocks:
mc admin object info myaistor/bucket/my-object --list