Skip to content

cub unit refresh

cub unit refresh

Refresh a configuration unit from the target

Synopsis

Refresh a configuration unit from the target. If no unit is specified, performs bulk refresh based on filter criteria.

A target must be attached to the unit (cub unit set-target can be used to add one), and the worker corresponding to the target must be connected and ready (cub worker get can be used to get the worker status).

Single unit refresh: 

  cub unit refresh my-unit

Bulk refresh with --where:

Refresh multiple units at once based on search criteria.

Examples: 

  # Refresh all units with specific label
  cub unit refresh --where "Labels.Tier = 'backend'"

  # Refresh units across all spaces (requires --space "*")
  cub unit refresh --space "*" --where "Slug = 'backend'"

  # Refresh specific units by slug
  cub unit refresh --unit my-unit,another-unit

  # Dry run to preview which units would be refreshed
  cub unit refresh --where "Labels.Environment = 'test'" --dry-run

cub unit refresh [unit-slug] [flags]

Options

      --display-mutations   display resource mutations
      --drift-mode string   Drift reconciliation mode (OnDemand, ContinuousApply, ContinuousRefresh)
      --dry-run             Preview refresh results
      --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 refresh
      --jq string           jq expression, suppressing default output
      --json                JSON output, suppressing default output
      --quiet               No default output.
      --timeout string      completion timeout as a duration with units, such as 10s or 2m (default "10m0s")
      --unit strings        target specific units by slug or UUID for bulk refresh (can be repeated or comma-separated)
      --verbose             Detailed output, additive with default output
      --wait                wait for completion
      --where string        Filter expression using SQL-inspired syntax. Supports conjunctions with AND. String operators: =, !=, <, >, <=, >=, LIKE, ILIKE, ~~, !~~, ~, ~*, !~, !~*. Pattern matching with LIKE/ILIKE uses % and _ wildcards. Regex operators (~, ~*, !~, !~*) support POSIX regular expressions. Examples: "Slug LIKE 'app-%'", "DisplayName ILIKE '%backend%'", "Slug ~ '^[a-z]+-[0-9]+$'"
      --yaml                YAML output, suppressing default output
      --yq string           yq expression, suppressing default output

Options inherited from parent commands

      --context string   The context to use for this command
      --debug            Debug output
      --space string     space ID to perform command on

SEE ALSO