uip maestro bpmn instances

Syntax and options for `uip maestro bpmn instance`, which inspects and steers individual Maestro BPMN process instances.

uip maestro bpmn instance inspects and steers individual process instances — one execution of a published Maestro BPMN process. The command name is singular (instance) even though the sidebar entry says instances. Every verb here is registered under the bpmn branch — there is no bare uip maestro bpmn instance.

Todos los subcomandos requieren uip login y respetan las opciones globales. Los códigos de salida siguen el contrato estándar.

Sinopsis

uip maestro bpmn instance list                                  -f <folder-key> [-l <limit>] [--next-page <cursor>] [--process-key <guid>] [--package-id <id>] [--error-code <code>] [--status <status>]... [--from-date <iso>] [--to-date <iso>]
uip maestro bpmn instance get                 <instance-id>     -f <folder-key>
uip maestro bpmn instance pause               <instance-id>     -f <folder-key> [--comment <text>]
uip maestro bpmn instance resume              <instance-id>     -f <folder-key> [--comment <text>]
uip maestro bpmn instance cancel              <instance-id>     -f <folder-key> [--comment <text>]
uip maestro bpmn instance retry               <instance-id>     -f <folder-key> [--comment <text>]
uip maestro bpmn instance migrate             <instance-id> <new-version> -f <folder-key> [--comment <text>]
uip maestro bpmn instance variables           <instance-id>     -f <folder-key> [--parent-element-id <id>]
uip maestro bpmn instance variables-set       <instance-id>     -f <folder-key> --inputs <json|@file>
uip maestro bpmn instance variables-all       <instance-id>     -f <folder-key>
uip maestro bpmn instance global-variables    <instance-id>     -f <folder-key>
uip maestro bpmn instance incidents           <instance-id>     -f <folder-key>
uip maestro bpmn instance asset               <instance-id>     -f <folder-key>
uip maestro bpmn instance cursors             <instance-id>     -f <folder-key>
uip maestro bpmn instance goto                <instance-id> <transitions> -f <folder-key>
uip maestro bpmn instance element-executions  <instance-id>     -f <folder-key>
uip maestro bpmn instance message send                          -f <folder-key> --inputs <json|@file>
uip maestro bpmn instance element cancel      <instance-id> <element-id> -f <folder-key> [--comment <text>]
uip maestro bpmn instance element retry       <instance-id> <element-id> -f <folder-key> [--comment <text>]

-f, --folder-key <key> es necesario en cada subcomando.

Opciones comunes

• -f, --folder-key <key> (obligatorio) : clave de carpeta (GUID).
• --comment <text> solo comandos de operación) : comentario opcional grabado con la operación. Enviado como una cadena vacía si se omite.

Subcomandos

uip maestro bpmn instance list

List instances in a folder, scoped to processType=ProcessOrchestration. Filters are applied server-side. Results page by cursor, not offset — read Pagination.NextPage from a response and pass it back via --next-page.

Opciones

Opción	Predeterminado	Descripción
-l, --limit <n>	DEFAULT_PAGE_SIZE	Number of items to return (1-500).
--next-page <cursor>	—	Cursor from a previous response's Pagination.NextPage.
--offset <n>	—	Not supported by this API. --offset 0 is silently accepted as a no-op (equivalent to no cursor); any other value fails with an error telling you to use --next-page instead.
--process-key <guid>	—	Filter by process key — must be a GUID. For the dotted package identifier (e.g. InvoiceOrchestration:1.0.0) that uip or processes list prints as ProcessKey, use --package-id instead.
--package-id <id>	—	Filter by package ID (the dotted package identifier).
--error-code <code>	—	Filtrar por código de error.
--status <status>	—	Filter by instance status. Repeatable, OR-semantics. An invalid value fails fast listing the accepted set.
--from-date <iso-8601>	—	Only include instances started at or after this timestamp, e.g. 2026-01-01T00:00:00Z.
--to-date <iso-8601>	—	Only include instances started at or before this timestamp.

Forma de datos

Code: "InstanceList", Data is an array of process-instance objects, plus a Pagination block (returned, limit, hasMore, nextPage).

uip maestro bpmn instance get

Obtener una sola instancia por ID. Forma de datos: Code: "InstanceGet", Data es el objeto de instancia de proceso.

uip maestro bpmn instance pause

Pausar una instancia en ejecución. Forma de datos: Code: "InstancePaused".

uip maestro bpmn instance resume

Reanudar una instancia en pausa. Forma de datos: Code: "InstanceResumed".

uip maestro bpmn instance cancel

Cancelar una instancia en ejecución. Forma de datos: Code: "InstanceCanceled".

uip maestro bpmn instance retry

Reintentar una instancia defectuosa. Forma de datos: Code: "InstanceRetried".

uip maestro bpmn instance migrate

Migra una instancia a una versión de paquete diferente.

Argumentos: <instance-id>, <new-version> (versión del paquete de destino).

Forma de datos: Code: "InstanceMigrated".

uip maestro bpmn instance variables

Obtener variables para una instancia.

Opciones: --parent-element-id <id> — filtrar variables por elemento principal.

Forma de datos: Code: "InstanceVariables", Data lleva la carga útil de las variables de instancia.

uip maestro bpmn instance variables-set

Patch (update) variables for a running instance.

Opciones

Opción	Descripción
--inputs <value>	Patch-variables payload as a JSON string, @file path, or piped via stdin. Required (the command fails if no payload resolves).

Forma de datos

Code: "InstanceVariablesSet".

uip maestro bpmn instance variables-all

Get every variable for an instance, including subprocess variables.

Forma de datos: Code: "InstanceVariablesAll".

uip maestro bpmn instance global-variables

Get an instance's global variables.

Forma de datos: Code: "InstanceGlobalVariables".

uip maestro bpmn instance incidents

Forma de datos: Code: "InstanceIncidents", Data es una matriz de objetos incidentes.

uip maestro bpmn instance asset

Obtenga el activo BPMN adjunto a la versión de esta instancia.

Forma de datos: Code: "InstanceAsset", Data es la carga útil del activo BPMN.

uip maestro bpmn instance cursors

Obtener las posiciones actuales del cursor de ejecución: en qué elemento(s) se detiene la instancia.

Forma de datos: Code: "InstanceCursors", Data enumera las posiciones actuales del cursor.

uip maestro bpmn instance goto

Mueve un cursor de ejecución de un elemento a otro.

Argumentos

• <instance-id> (obligatorio)
• <transitions> (obligatorio) : matriz JSON de transiciones, cada una con sourceElementId y targetElementId.

uip maestro bpmn instance goto c3d4e5f6-… \
  '[{"sourceElementId":"Activity_1","targetElementId":"Activity_3"}]' \
  --folder-key c3d4e5f6-…

Forma de datos

Code: "InstanceGoto".

uip maestro bpmn instance element-executions

Obtener el historial de ejecución por elemento para una instancia.

Forma de datos

Code: "InstanceElementExecutions", Data es el historial de ejecución por elemento.

uip maestro bpmn instance message send

Send a message to workflow subscriptions listening on this process — not scoped to a single instance ID; the vendor payload determines which instance(s) the message reaches.

Opciones

Opción	Obligatorio	Descripción
-f, --folder-key <key>	Sí	Clave de carpeta (GUID).
--inputs <value>	—	Message payload as a JSON string, @file path, or piped via stdin. Fails if no payload resolves.

Forma de datos

Code: "MessageSent".

uip maestro bpmn instance element cancel

Cancel one element within a running instance, without canceling the whole instance.

Argumentos

• <instance-id> (obligatorio)
• <element-id> (obligatorio)

Opciones

Opción	Descripción
-f, --folder-key <key>	Folder key (GUID). Required.
--comment <text>	Optional comment for the operation.

Forma de datos

Code: "ElementCanceled".

uip maestro bpmn instance element retry

Retry one faulted element within an instance.

Argumentos

• <instance-id> (obligatorio)
• <element-id> (obligatorio)

Opciones

Opción	Descripción
-f, --folder-key <key>	Folder key (GUID). Required.
--comment <text>	Optional comment for the operation.

Forma de datos

Code: "ElementRetried".

Ejemplos

# Paginate through instances for a specific process, filtered by status
uip maestro bpmn instance list --folder-key <k> \
  --status Faulted --status Paused --limit 50

# Page through with the cursor from a previous response
uip maestro bpmn instance list --folder-key <k> --next-page <cursor>

# Pause, fix, resume
uip maestro bpmn instance pause  <id> --folder-key <k> --comment "Investigating"
uip maestro bpmn instance resume <id> --folder-key <k>

# Inspect cursors, jump a faulted node, retry
uip maestro bpmn instance cursors <id> --folder-key <k>
uip maestro bpmn instance goto    <id> '[{"sourceElementId":"A","targetElementId":"C"}]' --folder-key <k>
uip maestro bpmn instance retry   <id> --folder-key <k>

# Upgrade a long-running instance to a new package version
uip maestro bpmn instance migrate <id> "1.2.0" --folder-key <k> --comment "Patch release"

# Retry a single faulted element instead of the whole instance
uip maestro bpmn instance element retry <id> Activity_2 --folder-key <k>

# Patch a variable on a running instance
uip maestro bpmn instance variables-set <id> --folder-key <k> --inputs '{"amount": 250}'

Ver también

• uip maestro bpmn incidents — incidentes separados de una instancia específica
• uip maestro bpmn job : la vista de trabajo de una ejecución de instancia
• uip maestro bpmn process — iniciar nuevas instancias
• Trabajos de Orchestrator
• Descripción general de Maestro