UIP ああ

「uip ah」ツールを使用して、Automation Hub の自動化のアイデア、パイプライン、タクソノミー、Marketplace、ユーザーを管理する。

uip ah は、Automation Hub ツール (コマンド プレフィックス ah、パッケージ @uipath/automation-hub-tool) です。自動化のアイデアの案件 (評価を通じて提出され、構成可能なフェーズを通過し、スコアリングされ、納品に至るまで追跡されるアイデア) に加えて、タクソノミー、コラボレーション、Marketplace の画面を管理します。uip tools install ahを使用してインストールするか、uip ah … を呼び出して自動インストールを実行します。インストール モデルの「 ツール (プラグイン) 」をご覧ください。

概念

• すべての書き込みは、パッチではなく、完全なレコードの置換です。automations update、 categories update、 users update、 tags set はすべて Automation Hub の完全なレコード形状を送信します。つまり、渡さないフィールドは既に保存されているものから引き継がれます (または、 categories update/tags setの場合は、コレクション全体が完全に置き換えられます)。各動詞のメモで、何が保持されているのか、何が上書きされているのかを正確に確認してください。
• すべての読み取りコマンドで--all-fields。Automation Hub の生のレコードには約 300 個のキーが含まれています。そのほとんどに __display 個の事前に書式設定されたツインが含まれています。すべての list/get コマンドは、既定で設定された管理可能なフィールドに投影されます。手つかずのペイロードの --all-fields を渡します。
• ページ化されたエンドポイントとページ化されていないエンドポイントほとんどの list コマンドは、ページングされた Automation Hub エンドポイントにヒットし、通常どおり --limit/--offset を受け入れます。いくつかのエンドポイント (roles、 idea-flows、 questionnaires list、 audit-logs list、 collaborators list) は、サーバー側のページングなしで 1 回の呼び出しでコレクション全体を返します。 --limit/--offset は、フルセットが取得された後にクライアント側で適用されます。
• ID は、UI からではなく、他の list コマンドから取得されます。Automation Hub の Web UI では、この CLI が取得するほとんどの数値 ID (カテゴリ ID、フェーズ ステータス ID、ロール ID) は公開されません。各動詞の独自のエラー メッセージが示しているように、対応する list --all-fields コマンドでこれらを検索します。
• このツールに固有のエラー: 403 は「Automation Hub のロールには表示されない」を意味し、「見つかりません」ということはありません。Automation Hub は、範囲外のレコードには 404 を使用しません。500 クラスの「Automation Hub はこのテナントにプロビジョニングされていません。」または「独自のテナント レコードがまだありません」という応答は、認証の失敗とは別の、テナントへのオンボーディングの手順とともに Result: "ConfigError" として表示されます。

リソース

各リソースには、独自のリファレンス ページがあります。各ページに設定された動詞は、 uip ah によって登録されたコマンドと一致します— uip ah --help を実行して、インストールの完全な表面を確認します。

リソース	目的
自動化、アイデア フロー、ビジネス ケース、フェーズ、アンケート、パイプライン	アイデアから成果までの中心的なライフサイクル: 自動化のアイデアの提出と読み取り、フェーズ/ステータスの遷移の検出、費用便益分析の読み取り、フェーズ間でのアイデアの移動、評価の質問カタログの読み取り、利益ランク付けされたパイプライン ビューの読み取り。
アプリケーション、コンポーネント、ドキュメント、メディア、ストア リスト、ストア レビュー	アプリケーション インベントリ オートメーションは、再利用可能なコンポーネント、添付のドキュメントやメディア、および Automation Store マーケットプレース (公開済みのリストとそのレビュー) に対してタグ付けされます。
カテゴリ、タグ、共同作業者、ロール、ユーザー	カテゴリのタクソノミー、フリーテキスト タグ、自動化ごとの共同作業者とそのロール、割り当て可能なロール カタログ、Automation Hub ユーザー アカウント。
audit-logs, auth-info	このページでは、小規模で分野横断的なユーティリティリソースについて説明します。

uip ah audit-logs

Automation Hub の監査証跡を確認します。Automation Hub では、証跡はフラット ログではなく週単位の CSV バンドルにグループ化されます。

uip ah audit-logs のリスト

日付範囲の監査ログ バンドルのリストを表示します。

オプション

長押し	値 (Value)	説明
--start-date <date>	YYYY-MM-DD	範囲の開始点。
--end-date <date>	YYYY-MM-DD	範囲の終わり。
--limit <n>	integer	返すバンドルの最大数既定 20です。
--offset <n>	integer	スキップするバンドルの数です。既定 0です。
--all-fields	フラグ	予測された Name/EntryCount フィールドではなく生のペイロードを返します。

ページなしのエンドポイント — 日付範囲のコレクション全体が取得され、クライアント側でウィンドウ化されます。空の証跡 (404「監査ログが見つかりませんでした。」)は、エラーとして表面化されるのではなく、空の Data 配列に折りたたまれます。

例

uip ah audit-logs list --start-date 2026-07-01 --end-date 2026-08-04

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

{
  "Code": "AhAuditLogsList",
  "Data": [
    { "Name": "tenant-service-audit-log-(2026-08-02)-to-(2026-08-08).csv", "EntryCount": 12 }
  ]
}

インライン エントリの代わりにオブジェクト参照 BLOB によってサポートされるバンドルは、 EntryCountの代わりに Uri (download --uri が取得する値) を返します。

uip ah audit-logs のダウンロード

1 つの監査ログ バンドルをローカルの CSV ファイルとして保存します。

オプション

長押し	値 (Value)	Required	説明
--uri <name>	string	○	バンドル名です。audit-logs listのNameフィールドとまったく同じです。
--destination <path>	パス	○	CSV の書き込み先のローカル パスです。

例

uip ah audit-logs download --uri <name> --destination ./audit.csv

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

{ "Code": "AhAuditLogsDownload", "Data": { "Destination": "./audit.csv", "Bytes": 4096, "Rows": 20 } }

uip ah auth-info

単数形の質量名詞リソース — セッションごとに 1 つのアイデンティティがちょうど 1 つあるので、リストするものはありません。

uip ah auth-info get

Automation Hub テナントとその中のユーザーの ID を表示する - Automation Hub が有効化され、アクティブなテナントに対してオンボーディングされていることを最も素早く確認できます。

オプション

長押し	説明
--all-fields	要約された Type/Tenant/User フィールドの代わりに生のペイロードを返します。

例

uip ah auth-info get

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

{
  "Code": "AhAuthInfoGet",
  "Data": {
    "Type": "automation-cloud",
    "Tenant": { "Uuid": "...", "CompanyName": "acme - finance", "Url": "..." },
    "User": {
      "Id": 3, "Email": "[e-mail]", "FirstName": "Jane", "LastName": "Doe",
      "JobTitle": "Analyst", "Department": "Finance", "BusinessUnit": "EMEA",
      "IsAdmin": 1, "IsActive": 1, "Roles": ["ah-system-admin"]
    }
  }
}

概要

uip ah audit-logs list [--start-date <date>] [--end-date <date>] [--limit <n>] [--offset <n>] [--all-fields]
uip ah audit-logs download --uri <name> --destination <path>
uip ah auth-info get [--all-fields]

コマンド画面の残りの部分については、自動化、アイデア フロー、ビジネス ケース、フェーズ、アンケート、パイプライン、アプリケーション、コンポーネント、ドキュメント、メディア、ストア リスト、ストア レビュー、およびカテゴリ、タグ、共同作業者、ロール、ユーザーを参照してください。

参照

• ツール (プラグイン)
• uip tools
• グローバル オプション
• 終了コード