Skip to main content

​
describe

Describe the files in a training project’s shared cache, largest first. The cache is shared by every job in the project and persists between runs.

​
Options

​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
TEXT
required
Training project to describe, by name or ID.
​
TEXT
default:"size"
Sort the listing by ‘size’ (largest first) or ‘path’ (alphabetical).One of: size, path
​
BOOL
Enable verbose logging

​
Examples

Describe a project’s cache
Sort the cache listing by path

​
Filter output with --jq

Print the cached file paths

​
Output

Text mode (--output text): A total size line, then a table with columns: PATH, TYPE, SIZE, PERMISSIONS, MODIFIED. When the cache is empty, prints “Cache is empty.” to stderr. JSON mode (--output json): payload type managementapi.GetCacheSummaryResponse.