uip o desencadenadores

Sintaxis y opciones para `uip o desencadenadores`, que gestiona el tiempo, la cola y los desencadenadores de API en Orchestrator.

Gestionar desencadenadores de Orchestrator: hora (programación), cola y API. Los desencadenadores de tiempo y cola tienen ámbito de carpeta; Los desencadenadores de API tienen ámbito de tenant. Cada verbo acepta --type <time|queue|api> (predeterminado time).

Para las convenciones de recursos cruzados (autenticación, ámbito de carpeta, tipos de clave, sobre de salida), consulta la uip or descripción general.

Sinopsis

uip or triggers list     [--type <type>] [--folder-path <path> | --folder-key <key>] [-n <name>] [--enabled | --disabled] [--sort-by <field>] [--all-fields]
uip or triggers get      <trigger-key> --type <type> [--folder-path <path> | --folder-key <key>] [--all-fields]
uip or triggers create   --type <type> --name <n> --release-key <k> --runtime-type <r> --job-priority <p> [type-specific flags]
uip or triggers update   <trigger-key> --type <type> [type-specific flags] [--enabled | --disabled]
uip or triggers delete   <trigger-key> --type <type> [--folder-path <path> | --folder-key <key>] --yes
uip or triggers history  <trigger-key> --type <type> [--folder-path <path> | --folder-key <key>] [-l <n>] [--offset <n>] [--all-fields]

Nota:

No hay ningún comando enable o disable dedicado. Alterna un desencadenador con update <trigger-key> --enabled o update <trigger-key> --disabled en su lugar (los dos marcadores se excluyen mutuamente).

Lista

Enumerar desencadenadores. Filtros: -n, --name, --enabled, --disabled (mutuamente excluyentes). --sort-by <field> ordena los resultados. --all-fields devuelve la respuesta completa de la API en lugar del subconjunto seleccionado.

uip or triggers list --type time --folder-path Shared --enabled

get

Obtener un desencadenador por clave. --all-fields devuelve la respuesta completa de la API en lugar del subconjunto seleccionado.

Crear

Crea un desencadenador. Marcadores necesarios: --name, --release-key, --runtime-type <Serverless|Unattended|Headless|NonProduction|AgentService>, --job-priority <Low|Normal|High> (predeterminado Normal).

Específico del tipo:

• el tiempo necesita --cron (formato de 6 campos de cuarzo) y, opcionalmente, --time-zone.
• la cola necesita --queue-key (y acepta --items-threshold, --max-jobs, --items-per-job, --activate-on-complete).
• api necesita --slug y --method <Get|Post|Put|Delete> (con --calling-mode opcional).

Común: -d, --description, --input-arguments <json>, --calendar-key, --stop-strategy <SoftStop|Kill>, --kill-process-expression, --resume-on-same-context, --run-as-me, repetible --target "machine=<guid>,user=<guid>,session=<int>", --mapping-mode <dynamic|strict> (predeterminado dynamic; utiliza strict cuando el tiene activada "Habilitar asignaciones cuenta-máquina").

uip or triggers create --type time \
  --name NightlyInvoices --release-key <release-guid> \
  --runtime-type Unattended --job-priority Normal \
  --folder-path Shared --cron "0 0 2 * * ?" --time-zone UTC

Actualizar

Actualizar por clave. Los mismos marcadores específicos de tipo que create, todos opcionales. Usa --no-* contrapartes para anular la configuración de los booleanos (por ejemplo, --no-activate-on-complete, --no-resume-on-same-context, --no-run-as-me). Pasa --enabled o --disabled para alternar el estado del desencadenador (mutuamente excluyentes).

uip or triggers update <trigger-key> --type time --disabled

Eliminar

Eliminar un desencadenador por clave. Requiere -y, --yes: la CLI nunca solicita operaciones destructivas.

uip or triggers delete <trigger-key> --type time --yes

Historial

Muestra el historial de ejecución del desencadenador (registro de activación). Paginado mediante -l, --limit / --offset. --all-fields devuelve la respuesta completa de la API en lugar del subconjunto seleccionado. Útil para diagnosticar por qué no se activó un desencadenador (licencia faltante, sin máquinas, deshabilitado, etc.).

Códigos de salida

Consulta Códigos de salida para el contrato compartido. delete sale de 1 si se omite -y, --yes.

Comandos relacionados

• uip or processes : obtener un --release-key para triggers create.
• uip or queues : claves de cola para --queue-key en desencadenadores de cola.

Ver también

• Información generaluip or : convenciones compartidas para cada verbo uip or .
• Tutorial: gestionar activos y colas de Orchestrator : desencadenar patrones de creación.