UIP AOPS 接続

「uip aops connection」と「uip aops repo」の構文とオプション。SourceControl 接続を同期し、それらを介して検出されたリポジトリを検査します。

uip aops connection では、 SourceControl 接続 (StudioAdmin がリポジトリ、オートメーション プロジェクト、ソリューションを検出するために使用する Git プロバイダー (GitHub または Azure DevOps) へのテナントごとのリンクを管理します。uip aops repo からリポジトリ識別子を取得すると、単一のリポジトリのブランチとオートメーション プロジェクト ファイルを検査 connection repos。共通の概念および SC サービス/CICD サービスの分割については、「 uip aops の概要 」をご覧ください。

注:

コネクション の作成 は StudioAdmin UI を介して実行されます。この CLI は、識別子によってプロビジョニング済みのコネクションのみを使用します。connection list を使用して識別子を検出し、connection sync --wait を使用して識別子を更新します。

概要

uip aops connection list
uip aops connection state [--connection <id>]
uip aops connection sync [connection-id] [--wait] [--timeout <ms>] [--poll-interval <ms>]
uip aops connection delete <connection-id> -y
uip aops connection repos <connection-id> [--azure-projects-ids <csv>] [--organization-identifier <name>]
uip aops connection repos-bulk --ids <csv>
uip aops connection projects <connection-id> [--repository-ids <csv>] [--target-framework <name>] [--project-type <type>] [--azure-projects-ids <csv>] [--organization-identifier <name>] [--sort-by <field>] [--sort-order <asc|desc>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection solutions <connection-id> [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection azure-projects <connection-id> [--organization-identifier <name>]

uip aops repo branches <repo-id>
uip aops repo project-files <repo-id> [--reference <ref>]

UIP AOPS 接続のリスト

現在のユーザーに表示されるすべての SourceControl 接続を一覧表示します。

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

{
  "Code": "ConnectionList",
  "Data": [
    { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "name": "GitHub - main org", "type": "GitHub" }
  ]
}

返された identifier は、他の connection、 repo、 project コマンドで使用します。

UIP AOPS 接続ステート

コネクションの現在の同期ステートを取得します。

オプション

長押し	値 (Value)	説明
--connection <id>	string	フィルターを適用し、単一の接続識別子に絞り込む。クライアント側のフィルター — API はすべての接続の状態を返し、CLI はローカルにフィルター処理します。

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

{
  "Code": "ConnectionState",
  "Data": [
    { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "syncState": "Success", "syncingInProgress": false }
  ]
}

syncStateSuccess、Fail、または Brokenです。

UIP AOPS 接続の同期

1 つのコネクション、または組織内のすべてのコネクション (省略している場合は [connection-id] ) に対して同期をトリガーする。

引数

名前	Required	目的
[connection-id]	×	connection listの接続識別子です。組織内のすべてのコネクションの同期を省略します。

オプション

長押し	値 (Value)	説明
--wait	フラグ	同期がすぐに戻るのではなく、同期が最終ステートに達するまでステート エンドポイントをポーリングします。
--timeout <ms>	integer	[ --wait ] を設定した場合の待機の最大時間です。既定 300000 (5 分)。
--poll-interval <ms>	integer	ステート ポーリングの間隔。既定 2000です。

トリガー エンドポイントは、すぐに 202 を返します。を --waitしないと、同期がキューに入るとすぐに制御が戻ります (Code: "ConnectionSyncStarted")。--waitの場合、非成功の終了ステート (例:Broken) は成功ではなく失敗として報告されます。

例

uip aops connection sync f1e2d3c4-0000-0000-0000-000000000001 --wait

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

{ "Code": "ConnectionSynced", "Data": { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "syncState": "Success", "syncingInProgress": false } }

すべての接続 ( connection-idなし) を同期すると、1 つのオブジェクトではなく Data の下に配列が返されます。

UIP AOPS 接続の削除

識別子による SourceControl 接続の削除。永続的 — この接続を介して検出されたプロジェクトやソリューションにはアクセスできなくなります。

引数

名前	Required	目的
<connection-id>	○	connection listの接続識別子です。

オプション

長押し	説明
-y, --yes	必須。この元に戻せない操作を確認します。CLI はプロンプトを表示しません。

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

{ "Code": "ConnectionDeleted", "Data": { "ConnectionId": "f1e2d3c4-0000-0000-0000-000000000001" } }

UIP AOPS 接続リポジトリ

単一のコネクション経由で表示できるリポジトリのリストを取得します。

引数

名前	Required	目的
<connection-id>	○	connection listの接続識別子です。

オプション

長押し	値 (Value)	説明
--azure-projects-ids <csv>	コンマ区切り	特定の Azure DevOps プロジェクト識別子に絞り込みます。Azure 接続のみ。
--organization-identifier <name>	string	1 つの Azure DevOps 組織へのスコープ。Azure 接続 (組織間の接続の場合のみ)

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

{ "Code": "ConnectionRepos", "Data": [ { "identifier": "abcd1234-0000-0000-0000-000000000001", "name": "automation-hub" } ] }

uip aops 接続 repos-bulk

複数の接続のリポジトリを 1 回の往復で取得します。

オプション

長押し	値 (Value)	Required	説明
--ids <csv>	コンマ区切り	○	connection listのコネクション識別子。

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

{
  "Code": "ConnectionReposBulk",
  "Data": [
    { "ConnectionId": "f1e2d3c4-0000-0000-0000-000000000001", "Repositories": [ { "identifier": "abcd1234-0000-0000-0000-000000000001", "name": "automation-hub" } ] }
  ]
}

接続ごとに 1 行 — ConnectionId はプレーンな値 (正規化されたキーではない) として保持されるため、出力形式が設定されても connection repos <id>にフィードバックされます。

UIP AOPS 接続プロジェクト

コネクションを通じて検出されたオートメーション プロジェクトの一覧を表示します。

引数

名前	Required	目的
<connection-id>	○	connection listの接続識別子です。

オプション

長押し	値 (Value)	説明
--repository-ids <csv>	コンマ区切り	connection reposから特定のリポジトリ識別子に絞り込みます。
--target-framework <name>	string	プロジェクトのターゲット フレームワークに対するサーバー側のフィルター。
--project-type <type>	string	プロジェクトの種類に対するサーバー側のフィルター処理 (例:Process、 Library、 Agent)。
--azure-projects-ids <csv>	コンマ区切り	Azure 接続のみ。
--organization-identifier <name>	string	Azure 接続のみ。
--sort-by <field>	string	並べ替えの基準にするフィールドです (例:name、 lastModifiedDate)。
--sort-order <asc|desc>	ENUM	並べ替えの方向。--sort-byと組み合わせます。
--offset <n>	integer	スキップする番号。の倍数である必要があります--limit既定 0です。
--limit <n>	integer	返される最大値。既定 10です。
--search <term>	string	プロジェクト名に対するサーバー側の部分文字列フィルター。

例

uip aops connection projects f1e2d3c4-0000-0000-0000-000000000001

uip aops connection projects f1e2d3c4-0000-0000-0000-000000000001 \
  --repository-ids abcd1234-0000-0000-0000-000000000001 --sort-by name --sort-order asc

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

{
  "Code": "ConnectionProjects",
  "Data": [
    { "ProjectId": "9999dddd-0000-0000-0000-000000000001", "Name": "Invoice Processing", "Description": "Daily invoice ingest", "Type": "Process", "Repository": "automation-hub" }
  ]
}

UIP AOPS 接続ソリューション

コネクションを介して検出された Studio ソリューションのリストを表示します。

引数

名前	Required	目的
<connection-id>	○	connection listの接続識別子です。

オプション

長押し	値 (Value)	説明
--offset <n>	integer	スキップする番号。の倍数である必要があります--limit既定 0です。
--limit <n>	integer	返される最大値。既定 20です。
--search <term>	string	ソリューション名に対するサーバー側の部分文字列フィルター。

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

{ "Code": "ConnectionSolutions", "Data": { "result": [] } }

uip aops 接続 azure-projects

Azure 接続を介してアクセス可能な Azure DevOps プロジェクトの一覧を表示します。GitHub 接続は常に空のリストを返します。

引数

名前	Required	目的
<connection-id>	○	connection listの Azure 接続識別子です。

オプション

長押し	値 (Value)	説明
--organization-identifier <name>	string	1 つの Azure DevOps 組織へのスコープ (複数の接続用)。

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

{ "Code": "ConnectionAzureProjects", "Data": [] }

UIP AOPS リポジトリ

connection repos <connection-id>を介して既に公開されているリポジトリを調べます。

UIP AOPS リポジトリ ブランチ

リポジトリのブランチのリストを取得します。

引数

名前	Required	目的
<repo-id>	○	connection repos <connection-id>のリポジトリ識別子です。

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

{ "Code": "RepoBranches", "Data": [ { "Name": "main", "Main": true }, { "Name": "release", "Main": false } ] }

ブランチ Nameは、repo project-files、project contentなどの--referenceとして使用します。

uip aops リポジトリ project-files

指定した参照でリポジトリ内のオートメーション プロジェクト ファイル (project.json ルート) のリストを取得します。

引数

名前	Required	目的
<repo-id>	○	connection repos <connection-id>のリポジトリ識別子です。

オプション

長押し	値 (Value)	説明
--reference <ref>	ブランチ/タグ/SHA	既定値は既定のブランチの HEAD です。

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

{ "Code": "RepoProjectFiles", "Data": [] }

関連

• uip aops — 概要と概念
• projects — ここで発見されたプロジェクトまたはソリューションを調べます。
• pipelines — 検出されたプロジェクトに対して CI/CD パイプラインを定義して実行します。

参照

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