cub revision list

List revisions

Synopsis

List revisions for a unit in a space, or across all spaces without --space. Revisions track the history of changes made to a unit's configuration.

The default output identifies each revision and shows what change management put on it: its ChangeSet, the ChangeOrders it belongs to, and its Tags, with the change description last and truncated. -o wide adds the timestamp, the user, the validation errors, and the Releases the revision has been bundled into, and shows the whole description. The ChangeOrders, Tags, and Releases columns are truncated in either layout, since each is a set; "cub revision get" and -o json show them in full.

Examples:

  # List all revisions for a unit
  cub revision list --space my-space my-ns

  # Include the timestamp, user, and validation errors, with untruncated descriptions
  cub revision list --space my-space -o wide my-ns

  # List the revisions a change order landed on, across every space it reached
  cub revision list --change-order my-base/release-42

  # List the revisions made in a change set
  cub revision list --changeset my-base/raise-replicas

  # List revisions without headers
  cub revision list --space my-space --no-headers my-ns

  # List revisions in JSON format
  cub revision list --space my-space -o json my-ns

  # List revisions of a unit named by its ID instead of its slug
  cub revision list --space my-space 61f26b06-3c34-4363-8b9d-7d0a7c2b5f1c

  # List revisions with custom JQ filter
  cub revision list --space my-space -o jq='.[].RevisionNum' my-ns

  # List revisions with specific criteria
  cub revision list --space my-space --where 'RevisionNum > 1' my-ns

  # List revisions across all spaces (organization-wide search, at most one revision per unit)
  cub revision list --where 'Tags.my-tag-id = "some-value"'

cub revision list [unit] [flags]

Options

      --change-order string           filter revisions by change order slug, space/slug, or UUID: the revisions the change landed on, in whichever space they are in
      --changeset string              filter revisions by change set slug, space/slug, or UUID: the revisions made in the change set, in whichever units it was added to
      --changeset-endtag string       filter revisions by a closed change set's end tag, naming either the change set or its end tag by slug, space/slug, or UUID
      --changeset-starttag string     filter revisions by a change set's start tag, naming either the change set or its start tag by slug, space/slug, or UUID
      --columns strings               columns to display; can be repeated or comma-separated (e.g., Slug,Labels.Environment)
      --contains string               Free text search for entities containing the specified text. Searches across string fields (like Slug, DisplayName) and map fields (like Labels, Annotations). Case-insensitive matching. Can be combined with --where using AND logic. Example: "backend" to find entities with backend in any searchable field
      --filter string                 Filter entity to apply to the list. Specify as 'space/filter' for cross-space filters or just 'filter' for current space. Supports both slugs and UUIDs. The filter will be combined with any --where clause using AND logic. Examples: "production-filters/security-check", "my-filter-uuid", "validation-rules"
  -h, --help                          help for list
      --include-hidden string[="*"]   Also select hidden entities, to list or to act on: those hidden for the given HiddenReasons, comma-separated, as in --include-hidden=BackingUnit, or for any reason when given no value or "*". ConfigHub/YAML Units, which hold the configuration of other entities, are hidden with the reason BackingUnit. A --where naming entities by Slug or ID selects them whether hidden or not
      --limit int                     Return at most this many entities; 0 returns all of them. They are read from the server in pages of at most 1000
      --no-headers                    Don't print headers for table output
      --order-by string               Order the entities by these fields, as comma-separated 'ASC:Field', 'DESC:Field' or 'Field' terms, such as "DESC:CreatedAt". Entities with equal values are ordered by ID. With --limit, this decides which entities are returned
  -o, --output string                 Output format. One of: json, yaml, name, wide, mutations, jq=<expr>, yq=<expr>, custom-columns=<spec>
      --quiet                         No default output.
      --select string                 Comma-separated list of fields to retrieve and display. Entity IDs and Slug are always included. Example: "DisplayName,CreatedAt,Labels"
      --tag string                    filter revisions by tag slug or UUID
      --verbose                       Detailed output, additive with default output
      --view string                   View, by slug or UUID, whose columns to display. The View's Filter, if it has one, selects the entities as --filter does
      --where string                  Filter expression using SQL-inspired syntax. Supports conjunctions with AND. String operators: =, !=, <, >, <=, >=, LIKE, NOT LIKE, ILIKE, ~~, !~~, ~, ~*, !~, !~*. Pattern matching with LIKE/ILIKE uses % and _ wildcards. Regex operators (~, ~*, !~, !~*) support POSIX regular expressions. A related entity is referenced by prefix, as in "UpstreamUnit.Slug = 'base'"; when the reference names a list, a * segment matches any element, as in "FromLink.*.Slug = 'upgrade-app'". Examples: "Slug LIKE 'app-%'", "DisplayName ILIKE '%backend%'", "Slug ~ '^[a-z]+-[0-9]+$'"

Options inherited from parent commands

      --component string   the Component of --variant, when that names the variant alone; --variant <component>/<variant> says the same in one flag
      --context string     The context to use for this command
      --debug              Debug output
      --space string       space to operate in, by slug or UUID. Omitted, a list or bulk operation spans the organization and a single entity is named as <space>/<slug>; "*" means the same as omitting it
      --variant string     variant to operate in, as <component>/<variant>, or as <variant> with --component: the space naming that Component whose Variant label is <variant>. The same scope as --space, named by what it is rather than by the space's slug; the two cannot be combined

cub revision list