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

Parameters

TARGET

Required

The full path to the object about which to display information. Specify the alias of a configured AIStor deployment, the bucket that contains the object, the prefix, and the object. For example:

mc admin heal aistor/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-object

Output 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
All rights reserved 2024-Present, MinIO, Inc.