cub invocation update

Update an invocation or multiple invocations

Synopsis

Update an invocation or multiple invocations using bulk operations.

Single invocation update:

Function arguments can be provided as positional arguments or as named arguments using --argumentname=value syntax. Once a named argument is used, all subsequent arguments must be named. Use "--" to separate command flags from function arguments when using named function arguments.

Example with named arguments:

  cub invocation update --space my-space my-invocation Kubernetes/YAML -- set-annotation --key=cloned --value=true

An Invocation can call several functions, which are executed in the order they are listed. The positional form replaces the list with a single function; to set a list of several, supply FunctionInvocations with --from-stdin or --filename and omit the function positional arguments:

  echo '{"FunctionInvocations": [
           {"FunctionName": "set-default-names"},
           {"FunctionName": "set-annotation", "Arguments": [{"Value": "cloned"}, {"Value": "true"}]}
         ]}' | cub invocation update --space my-space --from-stdin my-invocation Kubernetes/YAML

Bulk update with --patch:

Update multiple invocations at once based on search criteria. Requires --patch flag with no positional arguments.

Examples:

  # Update worker for all invocations of a certain type using JSON patch
  echo '{"BridgeWorkerID": "worker-uuid"}' | cub invocation update --patch --where "ToolchainType = 'Kubernetes/YAML'" --from-stdin

  # Repoint every invocation still on a deprecated function to its replacement
  echo '{"FunctionInvocations": [{"FunctionName": "vet-cel"}]}' | cub invocation update --patch --where "FunctionInvocations.*.FunctionName = 'cel-validate'" --from-stdin

  # Update specific invocations by slug
  cub invocation update --patch --invocation my-invocation,another-invocation --worker new-worker

cub invocation update [<slug or id>] [<toolchain type> [<function> [<arg1> ...]]] [flags]

Options

      --annotation strings    annotations in key=value format; can separate by commas and/or use multiple instances of the flag
      --delete-gate strings   delete gates in key[=true] format; can separate by commas and/or use multiple instances of the flag
      --filename string       Read the ConfigHub entity JSON from file, URL (https://), or stdin (-); mutually exclusive with --from-stdin
      --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"
      --from-stdin            Read the ConfigHub entity JSON (e.g., retrieved with cub <entity> get --quiet --json) from stdin; merged with command arguments on create, and merged with command arguments and existing entity on update
  -h, --help                  help for update
      --invocation strings    target specific invocations by slug or UUID for bulk patch (can be repeated or comma-separated)
      --label strings         labels in key=value format; can separate by commas and/or use multiple instances of the flag
  -o, --output string         Output format. One of: json, yaml, name, wide, mutations, jq=<expr>, yq=<expr>, custom-columns=<spec>
      --patch                 use patch API for individual or bulk operations
      --quiet                 No default output.
      --replace               Replace entity instead of merging when using --from-stdin or --filename
      --verbose               Detailed output, additive with default output
      --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]+$'"
      --worker string         worker to execute the invocation function

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

cub invocation update