uip or triggers

Syntax and options for `uip or triggers`, which manages time, queue, and API triggers in Orchestrator.

Orchestrator のトリガーを管理する: 時刻 (スケジュール)、キュー、APIタイム トリガーとキュー トリガーはフォルダー範囲です。API トリガーはテナント範囲です。すべての動詞は --type <time|queue|api> を受け入れます(デフォルト time)。

リソース間の規則 (認証、フォルダー スコープ、キーの種類、出力エンベロープ) については、「 uip or の概要」をご覧ください。

概要

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]

注:

There is no dedicated enable or disable command. Toggle a trigger with update <trigger-key> --enabled or update <trigger-key> --disabled instead (the two flags are mutually exclusive).

リスト (List)

List triggers. Filters: -n, --name, --enabled, --disabled (mutually exclusive). --sort-by <field> sorts results. --all-fields returns the full API response instead of the curated subset.

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

get

Get a trigger by key. --all-fields returns the full API response instead of the curated subset.

作成

トリガーを作成します。必須のフラグ: --name、 --release-key、 --runtime-type <Serverless|Unattended|Headless|NonProduction|AgentService>、 --job-priority <Low|Normal|High> (既定 Normal)。

型固有:

• 時間 には --cron (Quartz 6フィールド形式)が必要であり、オプションで --time-zone。
• キュー には --queue-key が必要です ( --items-threshold、 --max-jobs、 --items-per-job、 --activate-on-completeを受け入れます)。
• API には --slug と --method <Get|Post|Put|Delete> が必要です (必要に応じて --calling-mode)。

Common: -d, --description, --input-arguments <json>, --calendar-key, --stop-strategy <SoftStop|Kill>, --kill-process-expression, --resume-on-same-context, --run-as-me, repeatable --target "machine=<guid>,user=<guid>,session=<int>", --mapping-mode <dynamic|strict> (default dynamic; use strict when the folder has "Enable account-machine mappings" turned on).

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

更新

Update by key. Same type-specific flags as create, all optional. Use --no-* counterparts to unset booleans (for example --no-activate-on-complete, --no-resume-on-same-context, --no-run-as-me). Pass --enabled or --disabled to toggle the trigger's state (mutually exclusive).

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

削除

Delete a trigger by key. Requires -y, --yes — the CLI never prompts for destructive operations.

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

履歴

Show the trigger execution history (fire log). Paginated via -l, --limit / --offset. --all-fields returns the full API response instead of the curated subset. Useful for diagnosing why a trigger did not fire (missing license, no machines, disabled, etc.).

終了コード

See Exit codes for the shared contract. delete exits 1 if -y, --yes is omitted.

関連コマンド

• uip or processes — triggers createの--release-keyを取得します。
• uip or queues — キュー トリガーで--queue-keyするためのキュー キー。

参照

• uip orの概要—すべてのuip or動詞に共通する規則。
• 方法: Orchestrator のアセットとキューを管理する — トリガーの作成パターン。