UIP Maestro フロー ジョブ

「uip maestro フロー ジョブ」の構文とオプション。実行トレースをストリーミングし、個々のフロー ジョブの詳細なステータスを取得します。

uip maestro flow job は、トレースをストリーミングするか、詳細ステータスを取得して、個々の フロー ジョブ (プロセス インスタンスの 1 回の実行試行) を検査します。

すべてのサブコマンドには uip login が必要であり、 グローバルオプションが適用されます。終了コードは 標準コントラクトに従います。

概要

uip maestro flow job list  [--folder-key <key>] [--state <state>] [--process-name <name>]
                    [-l, --limit <n>] [--offset <n>] [--sort-by <field>] [--all-fields]
                    [--login-validity <minutes>]

uip maestro flow job traces <job-key>
                    [--poll-interval <ms>]
                    [--traces-service <name>] [--pretty]
                    [--login-validity <minutes>]

uip maestro flow job status <job-key>
                    [--folder-key <key>] [--detailed]
                    [--login-validity <minutes>]

UIP Maestro フローのジョブのリスト

フォルダー内のフロー ジョブのリストを取得します。

オプション

オプション	既定 (Default)	説明
--folder-key <key>	認証されたフォルダー	フォルダー キー (GUID)。
--state <state>	—	ジョブのステートでフィルター処理します: Pending、 Running、 Successful、 Faulted、 Stopped、 Stopping、 Suspended、 Resumed、 Terminating。
--process-name <name>	—	フロー プロセス名 (一致を含む) でフィルター処理します。
-l, --limit <n>	50	返すアイテムの数です。
--offset <n>	0	スキップするアイテムの数です。
--sort-by <field>	サーバーの既定	結果をフィールドで並べ替える (例:'Id desc'です。
--all-fields	無効	選定された要約の代わりに API 応答からすべてのフィールドを返します。
--login-validity <minutes>	10	トークン更新のしきい値。

例

uip maestro flow job list --folder-key c3d4e5f6-… --limit 2

データ形状 (既定のサマリー)

{
  "Code": "FlowJobList",
  "Data": [
    {
      "key": "b2c3d4e5-…",
      "state": "Successful",
      "processName": "InvoiceFlow",
      "source": "Manual",
      "startTime": "2025-04-15T10:30:00Z",
      "endTime": "2025-04-15T10:32:11Z"
    }
  ]
}

--all-fieldsでは、各アイテムには、この選定された要約ではなく完全な Orchestrator ジョブ オブジェクトが含まれます。

UIP Maestro フローのジョブのトレース

実行中のジョブまたは最近完了したジョブのストリーム実行トレース イベント。回線は、到着すると stderr にストリーミングされます。最終状態と期間もストリーミングされます。

引数

• <job-key> (必須) — ジョブ キー ( process runの GUID)。

オプション

オプション	既定 (Default)	説明
--poll-interval <ms>	2000	ポーリング間隔。正の数である必要があります。
--traces-service <name>	llmopstenant_	サービス名をトレースします (詳細。指示された場合にのみ上書きされます)。
--pretty	無効	整形トレース イベント。指定しない場合、各イベントは 1 つの JSON 行として出力され、 jqへのパイプ処理に適しています。
--login-validity <minutes>	10	トークン更新のしきい値。

動作

• stderr に見出し行を書き込みます: Streaming traces for job: <key> Polling every Ns...
• 各トレース イベントを ScreenLogger.progress (stderr) 経由でストリーミングします。
• 完了すると、 Job <key>: <finalState> (<durationMs>ms)を出力します。
• 終了コード: ジョブが成功した場合は 0、それ以外の場合は (result.success単位1)。

例

# Raw JSON lines — best for piping
uip maestro flow job traces b2c3d4e5-… | jq -c 'select(.level=="error")'

# Human-readable
uip maestro flow job traces b2c3d4e5-… --pretty

# Slower polling for quiet jobs
uip maestro flow job traces b2c3d4e5-… --poll-interval 5000

出力: トレースは直接ストリーミングされます。最終的な Data ペイロードはストリーミングされません。

UIP Maestro フロージョブのステータス

フロージョブのステータスを取得します。既定では、選定された 14 フィールドの要約を返します。 --detailed は Orchestrator の完全な応答を返します。

引数

• <job-key> (必須) — ジョブ キー (GUID)。

オプション

オプション	既定 (Default)	説明
--folder-key <key>	認証されたフォルダー	フォルダー キー (GUID)。
--detailed	無効	14 フィールドの概要ではなく、完全な応答を返します。
--login-validity <minutes>	10	トークン更新のしきい値。

データ形状 (既定のサマリー)

{
  "Code": "FlowJobStatus",
  "Data": {
    "key":             "b2c3d4e5-…",
    "state":           "Successful",
    "runtimeType":     "…",
    "processType":     "Flow",
    "startTime":       "2025-04-15T10:30:00Z",
    "endTime":         "2025-04-15T10:32:11Z",
    "creationTime":    "2025-04-15T10:29:58Z",
    "inputArguments":  "{}",
    "outputArguments": "{}",
    "info":            "",
    "releaseName":     "InvoiceFlow",
    "processKey":      "a1b2c3d4-…",
    "robotName":       "…",
    "hostMachineName": "…"
  }
}

--detailedでは、Orchestrator の完全なジョブ オブジェクト (すべてのフィールド、フラット化されていないData) を示します。

注:

完全な詳細回答の形状は、Orchestrator が返すものであり、CLI によって厳密に型指定されるものではありません。フィールドの存在は、特定のフィールドを解析し、防御的にクエリを実行し、CI に @uipath/cli ピン留めするスクリプトの場合、Orchestrator のバージョン間でドリフトする可能性があります。

例

# Start a job, capture the key, stream traces to completion
JOB_KEY=$(uip maestro flow process run "InvoiceFlow.flow.Flow:1.0.0" "<folder-key>" \
           --inputs '{}' --output-filter "jobKey" --output plain)
uip maestro flow job traces "$JOB_KEY" --pretty

# Get the summary once the job is done
uip maestro flow job status "$JOB_KEY" --folder-key "<folder-key>"

# Full response
uip maestro flow job status "$JOB_KEY" --detailed

参照

• uip maestro flow process run — ジョブを開始する
• uip maestro flow instance — 同じ実行のインスタンスのビュー
• Orchestrator のジョブ
• フローの概要