UIP 管理者による監査

「uip admin audit」の構文とオプション - 組織とテナントの範囲で UiPath 管理者監査イベントをクエリしてエクスポートします。

uip admin audit UiPath 監査イベントのクエリとエクスポート — プラットフォーム レベルの管理者監査証跡です (Orchestrator エンティティの変更をカバーする uip or audit-logsとは異なります)。uip admin (概要) の一部である「UiPath 管理ツール」

2 つのスコープ サブグループは、同一の 3 動詞の図形を登録します。

• org — 組織範囲の監査 (テナントに依存しない管理者イベント)。
• tenant — テナントを対象範囲とした監査 (アクティブなログイン、テナント、または --tenant-idを対象としたイベント)。

一般的なワークフロー: audit <scope> sources (ソース ID の検出) → audit <scope> events --source <guid> --from-date … --to-date … (行の検索) → audit <scope> export --from-date … --to-date … --output-path … (行のダウンロード)。

概要

uip admin audit org sources [--login-validity <minutes>]
uip admin audit org events [--from-date <iso>] [--to-date <iso>] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--user-id <guid>...] [--search <term>] [--status Success|Failure] [--limit <n>]
uip admin audit org export --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

uip admin audit tenant sources [--tenant-id <guid>] [--login-validity <minutes>]
uip admin audit tenant events [--tenant-id <guid>] [... same filters as org events]
uip admin audit tenant export [--tenant-id <guid>] --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

tenant 動詞はさらに、ログイン コンテキストからテナントを上書きする --tenant-id <guid> を受け入れます。 org 動詞はそうしません (組織の範囲には上書きするテナントがありません)。

[UIP 管理者監査] 組織のソース/[UIP 管理者監査] のテナントのソース

このスコープに表示される監査イベント ソースを一覧表示します。各ソースは最上位のイベント カテゴリです (例: Identity、 Tenant、 Robot)。返された id 値は events --source <guid>とします。

オプション

長押し	値 (Value)	説明
--tenant-id <guid>	GUID	(tenant スコープのみ)ログイン コンテキストからテナントを上書きします。
--login-validity <minutes>	integer	この呼び出しの対話型ログイン トークンの有効期間を上書きします。必要になることはほとんどありません。

例

uip admin audit org sources

データシェイプ(--output json)

{
  "Code": "AuditOrgSources",
  "Data": [
    { "id": "11111111-1111-1111-1111-111111111111", "name": "Identity", "eventTargets": [] }
  ]
}

Codeは tenantでAuditTenantSourcesされています。

[UIP 管理者監査] 組織イベント/[UIP 管理者監査テナント イベント]

このスコープで監査イベントをページ分割してクエリを実行します。{ auditEvents, next, previous }を返します。ベア配列ではありません。カーソルの名前は時系列です。 next は新しいイベントで、 previous 古いイベントです。--limit が 200 を超えると、サーバーは各呼び出しを 200 行にクランプするため、CLI は内部でページングします ( previousに続きます)。

オプション

長押し	値 (Value)	説明
--from-date <iso>	ISO8601認証取得	間隔の開始。包括的。
--to-date <iso>	ISO8601認証取得	間隔の終了包括的。
--source <guid>	GUID、繰り返し可能	イベント ソース ID でフィルター処理します。sourcesで発見する
--target <guid>	GUID、繰り返し可能	イベント ターゲット ID でフィルター処理します。
--type <guid>	GUID、繰り返し可能	イベントの種類の ID でフィルター処理します。
--user-id <guid>	GUID、繰り返し可能	動作するユーザー ID でフィルター処理します。
--search <term>	string	サーバー側の部分文字列検索。
--status <status>	Success | Failure	大文字と小文字を区別しないイベント ステータス フィルターです。
--limit <n>	integer	返される予定の合計 (1 から 10000)200 を超える値は、クライアント側でページ分割されます (サーバーは各呼び出しを 200 にクランプします)。
--tenant-id <guid>	GUID	(tenant スコープのみ)ログイン コンテキストからテナントを上書きします。
--login-validity <minutes>	integer	この呼び出しの対話型ログイン トークンの有効期間を上書きします。必要になることはほとんどありません。

例

# Fetch the latest 50 org audit events
uip admin audit org events --limit 50

# Filter by source and a 7-day window
uip admin audit tenant events --source 11111111-1111-1111-1111-111111111111 \
  --from-date 2026-04-22T00:00:00Z --to-date 2026-04-29T00:00:00Z

データシェイプ(--output json)

{
  "Code": "AuditOrgEvents",
  "Data": { "auditEvents": [], "next": null, "previous": null }
}

Codeは tenantでAuditTenantEventsされています。

[UIP 管理者監査] 組織のエクスポート / [UIP 管理者監査] テナントのエクスポート

長期ストアから監査イベントをエクスポートします。[--from-date, --to-date]内で UTC 日ごとに 1 つの HTTP 呼び出しを発行し、何かを書き出す前に結果をメモリに集約します — ウィンドウ全体が最初に取得され、1 日失敗するとエクスポートはアトミックに中止されます (何も書き込まれず、失敗した日に名前が付けられます)。

--output-path はファイル パスではなく ベース ディレクトリです。フォルダーを渡すと、CLI はその中に一意の名前の付いた出力を生成し、ウィンドウと生成時刻がスタンプされます (例:audit_2026-01-01_2026-02-01_20260617T112630)、同じウィンドウを繰り返しエクスポートしても競合しないようにします。

• --file-format json (既定) — UTC 日ごとに 1 つの JSON ファイルのフォルダー。
• --file-format csv — すべてのイベントが共有ヘッダーの下に結合された 1 つの CSV ファイルです。

オプション

長押し	値 (Value)	Required	説明
--from-date <iso>	ISO8601認証取得	○	間隔の開始。
--to-date <iso>	ISO8601認証取得	○	間隔の終了
--output-path <dir>	パス	条件付き	エクスポートのベース ディレクトリです (存在しない場合は作成されます)。ディレクトリのみを渡し、ファイル名は渡しません。CLI によって出力に名前が付けられます。代わりに --output-file (非推奨のエイリアス) を渡さない限り、必須です。
--output-file <dir>	パス	×	--output-pathのエイリアスは非推奨であり、後方互換性のために保持されています。名前にもかかわらず、引き続きベース ディレクトリとして扱われます。両方が合格すると、 --output-path が優先され、非推奨化の警告がログに記録されます。
--file-format <format>	json | csv	×	出力図形。既定 jsonです。
--tenant-id <guid>	GUID	×	(tenant スコープのみ)ログイン コンテキストからテナントを上書きします。
--login-validity <minutes>	integer	×	この呼び出しの対話型ログイン トークンの有効期間を上書きします。必要になることはほとんどありません。

例

# JSON export — a timestamped folder of day-wise JSON files is created under the base dir
uip admin audit org export --from-date 2026-01-01 --to-date 2026-02-01 --output-path ./audit-exports

# CSV export — a single uniquely-named .csv file under the base dir
uip admin audit tenant export --from-date 2026-01-01 --to-date 2026-02-01 \
  --file-format csv --output-path ./audit-exports

データシェイプ(--output json)

JSON 形式:

{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630",
    "Format": "json",
    "Files": 27,
    "Bytes": 12345,
    "Days": 31,
    "NonEmptyDays": 27,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}

CSV 形式では、 の代わりに Events カウントが追加されますFiles

{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630.csv",
    "Format": "csv",
    "Bytes": 98765,
    "Days": 31,
    "NonEmptyDays": 27,
    "Events": 1234,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}

Codeは tenantでAuditTenantExportされています。

トラブルシューティング

• HTTP 401 — トークンにAudit.Readスコープがない可能性があります。uip logout && uip loginを実行して、新しいトークンを鋳造します。
• HTTP 403 — ログインしているユーザーには、このテナントに対する監査読み取り権限がありません。Automation Cloud でロールの割り当てを確認する。
• Tenant ID required (テナント スコープ) — --tenant-id <guid>渡すか、最初にログインしてテナントを選択します。
• エクスポート時にHTTP 504、または「<date>の監査エクスポートが失敗しました」 — 1 日分のチャンクがタイムアウトしました。再実行 — エクスポートはべき等です。問題が解決しない場合は、 --from-date/--to-date を絞り込んで失敗した日をスキップします。
• "resolves outside the output folder" / エクスポート時に安全でないファイル名 — サーバーの応答の形式が正しくないことを示します。再実行し、問題が解決しない場合は報告してください。

関連

• uip admin — uip adminツール全体の概要です。
• uip or audit-logs — Orchestrator エンティティの監査証跡です。この管理者レベルの監査とは異なる画面です。

参照

• グローバル オプション
• 終了コード