Skip to content

cub unit move

cub unit move

Move units to another space

Synopsis

Move units, and the links from them, to another space.

A unit keeps its identity: its revisions, mutations, events, links, clones and approvals come with it. Moving requires Manage permission on each unit and CreateChildren permission on the destination space.

Every check runs over the whole selection before anything moves, so a move that would collide with a name in the destination, or that names a unit with an operation in flight, moves nothing. Rename first if a name is taken; --dry-run reports what a move would do.

A unit on its space's release target takes the destination's, as it does when a space's release target changes. The destination's triggers and attributes are applied afterwards, and until that finishes the unit carries a temporary validation gate.

Examples: 

  # Move one unit
  cub unit move --space my-space my-unit other-space

  # Move every unit of an app
  cub unit move --space my-space --where "Labels.App = 'web'" other-space

  # Preview a move across all spaces
  cub unit move --space "*" --where "Labels.App = 'web'" --dry-run other-space

  # Move specific units by slug
  cub unit move --space my-space --unit my-unit,another-unit other-space

cub unit move [<unit-slug>] <to-space> [flags]

Options

      --dry-run         report what the move would do without moving anything
      --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 move
      --unit strings    move specific units by slug or UUID (can be repeated or comma-separated)
      --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

      --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>

SEE ALSO