UIP Insights のグループ

「uip insights グループ」の構文とオプション。アクティブなテナントの Insights グループとその Insights ロール名を読み取ります。

uip insights groups は、現在の呼び出し元に表示されているテナント グループを、その Insights のロール名とともに読み取ります。これは読み取り専用のサーフェスであり、作成、更新、削除動詞はありません。

重要:

Insights グループを読み取るには、アクティブなテナントで Insights の管理の表示 権限が必要です。ユーザー ID のないセッション (たとえば、クライアント資格情報でサインインするセッション) は、このデータをまったく読み取ることができず、403 が返されます。

概要

uip insights groups list [--include-email] [-l <n>] [-o <n>]
uip insights groups get <group-id> [--include-email]

どちらの動詞も 、グローバル オプション と標準の 終了コードを尊重します。どちらも -t, --tenant を受け入れません。 uip login時に選択したテナントを使用します。

UIP Insights グループのリスト

現在の呼び出し元に表示されるテナント グループを、その Insights のロール名とともに一覧表示します。各行はディレクトリ (グループごとに 1 つの呼び出しが順番にキャッシュされます) を介して解決されるため、大規模なテナントの最初の (コールド キャッシュ) リストは、同様のサイズの users list よりも遅くなる可能性があります。

オプション

フラグ	説明
--include-email	メール アドレスと入れ子になったロール ID を出力に含めます。既定ではオフです。既定のビューでは両方が省略されます。
-l, --limit <number>	返される最大行数。既定値は 50です。
-o, --offset <number>	結果を返す前にスキップする行です。

ページネーションはクライアント側で行われます。バックエンドはページネーションされていない完全なリストを返し、CLI はそれをフェッチ後にスライスします。

例

uip insights groups list

uip insights groups list --include-email --limit 100

データシェイプ - 既定のビュー

{
  "Code": "InsightsGroupsList",
  "Data": [
    { "id": "d1e2f3a4-0000-0000-0000-000000000001", "name": "Automation Users", "roles": [{ "name": "Viewer" }] }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false },
  "Instructions": "Roles shown are the group's Insights roles in the active tenant, by name; 'uip insights roles list' maps a role name to its role GUID and back. Directory filtering can omit unresolved groups, so a missing row is not proof the stored group does not exist. Listing groups resolves each row through the directory, one cached call per group in sequence. 'uip insights groups get' returns the same fields as a row here and can persist refreshed directory name and email fields for the group, so read the row here when it is enough."
}

データシェイプ — --include-email

{
  "Code": "InsightsGroupsList",
  "Data": [
    {
      "id": "d1e2f3a4-0000-0000-0000-000000000001",
      "name": "Automation Users",
      "email": "[e-mail]",
      "roles": [{ "id": "c1d2e3f4-0000-0000-0000-000000000001", "name": "Viewer" }]
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

ディレクトリをフィルター処理すると、行が削除される可能性があります。バックエンドのディレクトリ検索で解決できないグループはリストから完全に除外されます — 欠落しているグループは、それが存在しないことを証明するものではありません。 groups get でも直接解決できる場合があります。空のリストでは、0 行から何も保留されなかったため、上記のスタンディング ノートは削除されますが、ディレクトリ解決の警告とグループごとのコスト ノートは引き続き適用されます。

UIP Insights グループは以下を取得します。

GUID で 1 つの Insights グループを取得します。listとは異なり、この方法では、更新されたグループのディレクトリ名フィールドとメール アドレス フィールドが保持されたままになる可能性があります。副作用として、既読形式になりますが、純粋な可読性ではありません。

引数

名前	Required	目的
<group-id>	○	グループ GUID。実際の GUID である必要があります — 形式が正しくない値は、ネットワーク呼び出しの前にクライアント側で Run 'uip insights groups list' to find a group ID. で失敗します。

オプション

フラグ	説明
--include-email	メール アドレスと入れ子になったロール ID を出力に含めます。既定ではオフです。

例

uip insights groups get d1e2f3a4-0000-0000-0000-000000000001

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

{
  "Code": "InsightsGroupGet",
  "Data": { "id": "d1e2f3a4-0000-0000-0000-000000000001", "name": "Automation Users", "roles": [{ "name": "Viewer" }] }
}

--include-emailでは、リスト ビューと同じ図形がemailされ、入れ子になったroles[].idはリスト ビューと同じになります。

Group <id> was not found in the active Insights tenant, or is not visible there. 404 — ディレクトリが解決できないグループもここで 404 であるため、404 だけでは、保存されたグループが存在しないことを証明することはできません。すべての Insights RBAC コマンドが 404 である場合は、テナントに Insights ポータル サービスがプロビジョニングされていない可能性があります。

参照

• Insights の概要
• ユーザー、ロール — その他の RBAC 読み取り サーフェス 。 roles 、ここに示されているロール名を GUID にマップし、その逆にマップします。