uip oder Trigger

Syntax und Optionen für „uip oder triggers“, die Zeit, Warteschlange und API-Trigger in Orchestrator verwaltet.

Verwalten Sie Orchestrator -Trigger: Zeit (Zeitplan), Warteschlange und API. Zeit- und Warteschlangentrigger haben einen Ordner-Scope; API-Trigger haben einen Mandanten-Scope. Jedes Verb akzeptiert --type <time|queue|api> (Standardwert: time).

Die ressourcenübergreifenden Konventionen (Authentifizierung, Ordner-Scoping, Schlüsseltypen, Ausgabeumschlag) finden Sie in der uip or -Übersicht.

Zusammenfassung

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]

Hinweis:

Es gibt keinen dedizierten enable - oder disable -Befehl. Schalten Sie stattdessen einen Trigger mit update <trigger-key> --enabled oder update <trigger-key> --disabled um (die beiden Flags schließen sich gegenseitig aus).

Liste

Listen Sie Trigger auf. Filter: -n, --name, --enabled, --disabled (ausschließend). --sort-by <field> sortiert Ergebnisse. --all-fields gibt die vollständige API-Antwort anstelle der kuratierten Teilmenge zurück.

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

get

Rufen Sie einen Trigger nach Taste ab. --all-fields gibt die vollständige API-Antwort anstelle der kuratierten Teilmenge zurück.

Erstellen

Erstellen Sie einen Trigger. Erforderliche Flags: --name, --release-key, --runtime-type <Serverless|Unattended|Headless|NonProduction|AgentService>, --job-priority <Low|Normal|High> (Standard: Normal).

Typspezifisch:

• Zeit benötigt --cron (Quartz-6-Feld-Format) und optional --time-zone.
• Warteschlange benötigt --queue-key (und akzeptiert --items-threshold, --max-jobs, --items-per-job, --activate-on-complete).
• API benötigt --slug und --method <Get|Post|Put|Delete> (mit optionalen --calling-mode).

Häufig: -d, --description, --input-arguments <json>, --calendar-key, --stop-strategy <SoftStop|Kill>, --kill-process-expression, --resume-on-same-context, --run-as-me, wiederholbar --target "machine=<guid>,user=<guid>,session=<int>", --mapping-mode <dynamic|strict> (Standard: dynamic; verwenden Sie strict, wenn die ist „Konto-Maschinen-Zuordnungen aktivieren“ aktiviert).

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

Aktualisieren

Nach Schlüssel aktualisieren. Die gleichen typspezifischen Flags wie create, alle optional. Verwenden Sie --no-* -Gegenstück zu deaktivierten Booleschen Werten (z. B. --no-activate-on-complete, --no-resume-on-same-context, --no-run-as-me). Übergeben Sie --enabled oder --disabled, um den Status des Triggers umzuschalten ( sodass sich diese gegenseitig ausschließen).

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

Löschen

Löschen Sie einen Trigger nach Taste. Erfordert -y, --yes – die CLI fordert nie zu destruktiven Vorgängen auf.

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

Verlauf

Anzeigen des Trigger-Ausführungsverlaufs (Brandprotokoll). Paginiert über -l, --limit / --offset. --all-fields gibt die vollständige API-Antwort anstelle der kuratierten Teilmenge zurück. Nützlich für die Diagnose, warum ein Trigger nicht ausgelöst wurde (fehlende Lizenz, keine Maschinen, deaktiviert usw.).

Exitcodes

Siehe Austrittscodes für den gemeinsamen Vertrag. delete beendet 1, wenn -y, --yes weggelassen wird.

Zugehörige Befehle

• uip or processes – --release-key für triggers create erhalten.
• uip or queues – Warteschlangenschlüssel für --queue-key für Warteschlangentrigger.

Siehe auch

• uip or Übersicht – gemeinsame Konventionen für jedes uip or -Verb.
• So: Verwalten von Orchestrator-Assets und Warteschlangen – Trigger-Erstellungsmuster.