Skip to content

Latest commit

 

History

History
43 lines (30 loc) · 1.4 KB

File metadata and controls

43 lines (30 loc) · 1.4 KB

rc stat

Purpose

rc stat shows object metadata. It is a legacy-compatible command; prefer rc object stat for new scripts.

Syntax

rc [GLOBAL OPTIONS] stat [OPTIONS] <ALIAS/BUCKET/KEY>

Parameters

Parameter Description
ALIAS/BUCKET/KEY Object path to inspect.
--version-id Inspect a specific object version.
--rewind Inspect object state at a specific time where supported.

Examples

rc stat local/reports/summary.json
rc object stat local/reports/summary.json --json

Behavior

Metadata output includes object identity and storage metadata such as size, modified time, ETag, content type, and user metadata when available.

When --version-id is combined with JSON output, stat emits the output v3 versioned_objects envelope with data.operation set to stat. Metadata for the selected version is nested under data.object. JSON output without --version-id retains its legacy shape.

Global options shown in command syntax use the same meaning everywhere:

Option Description
--format auto|human|json Select automatic, human-readable, or JSON output.
--json Emit JSON output where the command supports structured output.
--no-color Disable terminal colors.
--no-progress Disable progress bars.
-q, --quiet Suppress non-error output.
--debug Enable debug logging.