procesos de uip aops

Sintaxis y opciones para el `canalización de UIP aops` y la `ejecución de UIP aops`, que gestionan los procesos CICD e inspeccionan o controlan sus ejecuciones.

uip aops pipeline gestiona los procesos de CI/CD: enumerar, obtener, crear, actualizar, ejecutar, eliminar. uip aops execution inspecciona y controla una ejecución de proceso: obtiene metadatos, transmite registros, obtiene detalles del trabajo o lo detiene. Ambos llaman al servicio CICD, un espacio de nombres de identificador independiente de los comandos de ControlDeOrigen en las páginas de conexiones/proyectos . Consulta la descripción generaluip aops de los conceptos compartidos.

Nota:

pipeline update <id> --file es de reemplazo completo (semántica HTTP PUT) y espera la forma EditPipelineDto , no la PipelineDto que pipeline get devuelve de forma predeterminada. No canalices pipeline get <id> > p.json directamente a update --file p.json: utiliza pipeline get <id> --for-update --output-file <path> en su lugar, que escribe la forma ya transformada.

Sinopsis

uip aops pipeline list [--repository-ids <csv>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops pipeline state
uip aops pipeline processes
uip aops pipeline process <process-id>
uip aops pipeline repos
uip aops pipeline get <pipeline-id> [--for-update] [--output-file <path>]
uip aops pipeline search [--name <name> | --prefix <prefix>]
uip aops pipeline create --file <path> [--telemetry-flow-id <id>]
uip aops pipeline update <pipeline-id> --file <path>
uip aops pipeline delete <pipeline-id> -y
uip aops pipeline run <pipeline-id>
uip aops pipeline save-and-run --file <path> [--telemetry-flow-id <id>]
uip aops pipeline executions <pipeline-id> [--offset <n>] [--limit <n>]
uip aops pipeline executions-bulk --ids <csv>

uip aops execution get <execution-id> [--with-arguments]
uip aops execution logs [execution-id] [--job-key <key>] [--follow] [--limit <n>] [--poll-interval <ms>] [--timeout <ms>]
uip aops execution details [execution-id] [--job-key <key>]
uip aops execution stop [execution-id] [--job-key <key>] [--wait] [--poll-interval <ms>] [--timeout <ms>]

lista de procesos de uip aops

Enumera los procesos visibles en el entorno de ejecución activo (establecido a través de la IU de StudioAdmin: cambia de tenants/carpetas allí si no ves lo que esperas).

Opciones

Largo	Valor	Descripción
--repository-ids <csv>	separados por comas	Limitar a uno o más UUID del repositorio SC (de connection repos).
--offset <n>	Entero	Número a omitir. Debe ser un múltiplo de --limit. Predeterminado 0.
--limit <n>	Entero	Máximo a devolver. Predeterminado 20.
--search <term>	String	Filtro de subcadena del lado del servidor en el nombre del proceso.

Forma de datos (--json de salida)

{
  "Code": "PipelineList",
  "Data": [
    { "PipelineId": "11111111-2222-3333-4444-555555555555", "Name": "release-main", "Repository": "automation-hub", "LastRunState": "Successful", "LastRunEnd": "2026-05-05T14:23:00.000Z" }
  ]
}

Una fila seleccionada por proceso: utiliza pipeline get <id> para el DTO completo, incluida la vinculación de rama y proyecto.

estado del proceso de uip aops

Obtener una instantánea de todo el entorno de runtime del estado de los procesos: recuentos y estado de resumen utilizado por el panel de StudioAdmin. Una forma económica de confirmar que se puede acceder al entorno de ejecución antes de enumerar o mutar.

Forma de datos (--json de salida)

{ "Code": "PipelinesState", "Data": {} }

procesos de canalización de uip aops

Enumerar los procesos de automatización a los que se pueden vincular los procesos.

Forma de datos (--json de salida)

{
  "Code": "PipelineProcesses",
  "Data": [ { "ProcessId": "33333333-4444-5555-6666-777777777777", "Name": "InvoiceProcessing", "Description": "Daily invoice ingest", "Package": "MyOrg.Invoice.Processing", "Version": "1.2.0" } ]
}

Una fila seleccionada por proceso: utiliza el ProcessId devuelto como processIdentifier de PipelineDto al crear un proceso. Profundiza en uno con pipeline process <process-id> para obtener el DTO completo, incluidos los argumentos.

proceso de canalización de uip aops

Resuelve un único proceso de automatización por identificador.

Argumentos

Nombre	Obligatorio	Propósito
<process-id>	Sí	Identificador de proceso de pipeline processes.

Forma de datos (--json de salida)

{ "Code": "PipelineProcess", "Data": {} }

repositorios de proceso de uip aops

Enumera los repositorios de ControlDeOrigen que tienen al menos un proceso.

Forma de datos (--json de salida)

{ "Code": "PipelineRepos", "Data": [] }

obtención de canalización de uip aops

Obtener un proceso por identificador.

Argumentos

Nombre	Obligatorio	Propósito
<pipeline-id>	Sí	Identificador de proceso de pipeline list.

Opciones

Largo	Valor	Descripción
--for-update	Marca	Devuelve la forma EditPipelineDto en lugar de la PipelineDto completa, con los campos solo del servidor eliminados: introduce el resultado directamente en pipeline update --file sin transformación manual.
--output-file <path>	Ruta	Escribe también la carga útil en este archivo como JSON (UTF-8, sangría de 2 espacios). La salida estándar sigue emitiendo el sobre estructurado completo.

--for-update mantiene la propia clave de DTO en Data (no PascalCased). --output-filter se ejecuta en Data tal como se imprime y distingue entre mayúsculas y minúsculas: con --for-update, coincide con los nombres de campo propios de la DTO.

Ejemplos

uip aops pipeline get 11111111-2222-3333-4444-555555555555

uip aops pipeline get 11111111-2222-3333-4444-555555555555 --for-update --output-file ./pipeline.json

Forma de datos (--json de salida)

{ "Code": "PipelineGet", "Data": { "identifier": "11111111-2222-3333-4444-555555555555", "name": "release-main" } }

búsqueda de proceso de uip aops

Buscar un proceso por nombre.

Opciones

Largo	Valor	Descripción
--name <name>	String	Búsqueda de coincidencia exacta. Devuelve un solo PipelineDto.
--prefix <prefix>	String	Comienza con una consulta. Devuelve una matriz.

Se requiere exactamente uno de --name/--prefix: pasar ambos o ninguno falla en el lado del cliente antes de cualquier llamada de red.

Ejemplos

uip aops pipeline search --name "release-main"

uip aops pipeline search --prefix "release-"

Forma de datos (--json de salida)

{ "Code": "PipelineSearch", "Data": {} }

Ninguna coincidencia falla con Pipeline '<name>' not found. (para --name) o No pipelines matched prefix '<prefix>'. (para --prefix) en lugar de un éxito vacío.

creación de proceso de uip aops

Crea un nuevo proceso a partir de un archivo JSON conforme a PipelineDto.

Opciones

Largo	Valor	Obligatorio	Descripción
--file <path>	Ruta	Sí	Archivo JSON que contiene el PipelineDto que se va a crear. No incluyas un identifier asignado por el servidor.
--telemetry-flow-id <id>	String	No	ID de flujo de telemetría para la correlación del lado del servidor.

Forma de datos (--json de salida)

{ "Code": "PipelineCreated", "Data": { "identifier": "11111111-2222-3333-4444-555555555555" } }

Capture las identifier devueltas para las llamadas de seguimiento run/update/delete. Un error de conflicto suele significar que ya existe un proceso con el mismo nombre.

actualización del proceso de uip aops

Actualizar un proceso existente. Reemplazo completo (HTTP PUT) : cualquier campo que omita el archivo se borra del lado del servidor.

Argumentos

Nombre	Obligatorio	Propósito
<pipeline-id>	Sí	Proceso que se actualizará. Debe coincidir con el campo identifier del archivo si ese campo está establecido.

Opciones

Largo	Valor	Obligatorio	Descripción
--file <path>	Ruta	Sí	Archivo JSON que contiene el EditPipelineDto que se va a aplicar.

Solo se envían las claves propias de EditPipelineDto: un archivo que contiene una clave no reconocida (incluida una que simplemente está mal escrita) se rechaza por completo en lugar de eliminarse silenciosamente como un borrado parcial.

Forma de datos (--json de salida)

{ "Code": "PipelineUpdated", "Data": { "Pipeline": { "identifier": "11111111-2222-3333-4444-555555555555", "name": "release-main" } } }

Data.Pipeline repite la solicitud que se envió, no el archivo leído del disco.

eliminación del proceso de uip aops

Eliminar un proceso por identificador. Permanente: las ejecuciones en curso no se detienen automáticamente, pero las nuevas ejecuciones se rechazan inmediatamente.

Argumentos

Nombre	Obligatorio	Propósito
<pipeline-id>	Sí	Identificador de proceso de pipeline list.

Opciones

Largo	Descripción
-y, --yes	Obligatorio. Confirma esta operación irreversible.

Forma de datos (--json de salida)

{ "Code": "PipelineDeleted", "Data": { "PipelineId": "11111111-2222-3333-4444-555555555555" } }

ejecución de proceso de uip aops

Desencadenar una ejecución de proceso. Devuelve 202 inmediatamente: la ejecución se pone en cola de forma asíncrona.

Argumentos

Nombre	Obligatorio	Propósito
<pipeline-id>	Sí	Identificador de proceso de pipeline list.

Forma de datos (--json de salida)

{ "Code": "PipelineRunStarted", "Data": { "PipelineId": "11111111-2222-3333-4444-555555555555" } }

Utiliza pipeline executions <pipeline-id> para descubrir el nuevo ID de ejecución y luego execution logs --follow para realizar un seguimiento.

uip aops canalización guardar y ejecutar

Mantén un DTO de proceso desde JSON y ejecútalo inmediatamente.

Opciones

Largo	Valor	Obligatorio	Descripción
--file <path>	Ruta	Sí	Archivo JSON que contiene PipelineDto para guardar y ejecutar.
--telemetry-flow-id <id>	String	No	ID de flujo de telemetría para la correlación del lado del servidor.

Forma de datos (--json de salida)

{
  "Code": "PipelineSavedAndRunStarted",
  "Data": { "pipeline": { "identifier": "11111111-2222-3333-4444-555555555555" }, "executionId": "22222222-3333-4444-5555-666666666666" }
}

executionId se elimina del latestPipelineExecution del proceso persistente para el encadenamiento inmediato en execution logs --follow; es null si el campo está ausente.

Ejecuciones de proceso de uip aops

Enumerar ejecuciones para un proceso.

Argumentos

Nombre	Obligatorio	Propósito
<pipeline-id>	Sí	Identificador de proceso de pipeline list.

Opciones

Largo	Valor	Descripción
--offset <n>	Entero	Número a omitir. Debe ser un múltiplo de --limit. Predeterminado 0.
--limit <n>	Entero	Máximo a devolver. Predeterminado 20.

Forma de datos (--json de salida)

{
  "Code": "PipelineExecutions",
  "Data": [ { "ExecutionId": "22222222-3333-4444-5555-666666666666", "BuildNumber": "42", "CommitRef": "0123456789abcdef0123456789abcdef01234567", "State": "Successful", "EnqueuedAt": "2026-05-05T14:21:00.000Z", "EndedAt": "2026-05-05T14:23:00.000Z" } ]
}

Profundiza en uno con execution get <execution-id> para el DTO completo (modo de ejecución, usuario desencadenador, jobExecutionIdentifier, código de error).

uip aops pipeline executions-bulk

Obtener metadatos para varias ejecuciones de proceso en un solo viaje de ida y vuelta.

Opciones

Largo	Valor	Obligatorio	Descripción
--ids <csv>	separados por comas	Sí	Identificadores de ejecución de proceso (de pipeline executions), no ID de proceso.

Forma de datos (--json de salida)

{ "Code": "PipelineExecutionsBulk", "Data": [] }

Ejecución de UIP aops

Inspeccionar y controlar las ejecuciones de procesos. Todos los verbos excepto get aceptan un posicional <execution-id> (la CLI busca el jobKey subyacente por ti) o --job-key <key> para omitir esa búsqueda cuando ya la tienes. get está tecleado solo por el ID de ejecución.

obtención de ejecución de uip aops

Obtener los metadatos de una ejecución de proceso por ID de ejecución.

Argumentos

Nombre	Obligatorio	Propósito
<execution-id>	Sí	Desde pipeline executions <pipeline-id>.

Opciones

Largo	Descripción
--with-arguments	Obtén también los argumentos de entrada del runtime con los que se ejecutó el proceso (JSON analizado o la cadena sin procesar si el análisis falla). Un viaje de ida y vuelta adicional.

Forma de datos (--json de salida)

{ "Code": "ExecutionGet", "Data": { "identifier": "22222222-3333-4444-5555-666666666666", "state": "Successful", "inputArguments": { "ArgumentName": "value" } } }

Utilice el jobExecutionIdentifier devuelto como --job-key para logs/details/stop para omitir su búsqueda automática.

registros de ejecución de uip aops

Obtener registros para una ejecución.

Argumentos

Nombre	Obligatorio	Propósito
[execution-id]	condicionalmente	Obligatorio a menos que se establezca --job-key; requerido independientemente de si --follow está establecido (el sondeo de estado es de clave de ID de ejecución).

Opciones

Largo	Valor	Descripción
--job-key <key>	String	Utilice esta clave de trabajo directamente, omitiendo la búsqueda de ID de ejecución.
--follow	Marca	Transmite los registros hasta que la ejecución alcanza un estado terminal (Successful/Faulted/Stopped).
--limit <n>	Entero	Tamaño de página por obtención de registro. Predeterminado 200.
--poll-interval <ms>	Entero	Intervalo entre sondeos cuando se establece --follow. Predeterminado 2000.
--timeout <ms>	Entero	Tiempo máximo para seguir antes de darse por vencido. Predeterminado 1800000 (30 minutos).

Sin --follow: imprime el segmento de registro actual y sale (Code: "ExecutionLogs"). Con --follow: las líneas de registro se transmiten a stderr a medida que llegan (no sujetas a --log-level, no capturadas por --log-file ; redirige a stderr explícitamente para mantenerlas), y stdout emite un sobre final con el estado del terminal y el recuento de líneas (Code: "ExecutionLogsFollowed").

Ejemplos

uip aops execution logs 22222222-3333-4444-5555-666666666666

uip aops execution logs 22222222-3333-4444-5555-666666666666 --follow 2> build.log

Forma de datos (--json de salida)

{ "Code": "ExecutionLogsFollowed", "Data": { "state": "Successful", "lineCount": 42 } }

detalles de ejecución de uip aops

Obtener el documento de detalles de ejecución del trabajo subyacente: robot, máquina, versión y contexto del host. Útil al clasificar un fallo para ver en qué ejecutor se ha ejecutado.

Argumentos

Nombre	Obligatorio	Propósito
[execution-id]	condicionalmente	Obligatorio a menos que se establezca --job-key.

Opciones

Largo	Valor	Descripción
--job-key <key>	String	Utilice esta clave de trabajo directamente, omitiendo la búsqueda de ID de ejecución.

Forma de datos (--json de salida)

{ "Code": "ExecutionDetails", "Data": {} }

parada de ejecución de uip aops

Solicitar una detención en la ejecución de un proceso. Idempotente : llamarlo en una ejecución ya terminal devuelve el estado actual sin errores.

Argumentos

Nombre	Obligatorio	Propósito
[execution-id]	condicionalmente	Obligatorio a menos que se establezca --job-key; requerido independientemente de si --wait está establecido.

Opciones

Largo	Valor	Descripción
--job-key <key>	String	Utilice esta clave de trabajo directamente, omitiendo la búsqueda de ID de ejecución.
--wait	Marca	Sondee hasta que la ejecución se asiente en el terminal en lugar de volver inmediatamente.
--poll-interval <ms>	Entero	Intervalo entre sondeos cuando se establece --wait. Predeterminado 2000.
--timeout <ms>	Entero	Tiempo máximo de espera cuando se establece --wait. Predeterminado 300000 (5 minutos).

Ejemplos

uip aops execution stop 22222222-3333-4444-5555-666666666666

uip aops execution stop 22222222-3333-4444-5555-666666666666 --wait

Forma de datos (--json de salida)

{ "Code": "ExecutionStopRequested", "Data": { "identifier": "22222222-3333-4444-5555-666666666666", "state": "Stopping" } }

Con --wait, el sobre final es Code: "ExecutionStopped" con el state resuelto. Llamar a stop en una ejecución que ya es terminal devuelve Code: "ExecutionAlreadyTerminal" en lugar de volver a emitir la detención.

Relacionado

• uip aops : descripción general y conceptos.
• connections : descubre el repositorio desde el que se crea un proceso.
• projects : descubre el proceso al que se vincula un proceso.

Ver también

• Opciones globales
• Códigos de salida