UIP Insights ユーザー

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

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

重要:

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

概要

uip insights users list [--include-email] [-l <n>] [-o <n>]

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

UIP Insights ユーザーのリスト

現在の呼び出し元に表示されるテナント ユーザーを、その Insights のロール名とともに一覧表示します。

オプション

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

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

例

uip insights users list

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

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

{
  "Code": "InsightsUsersList",
  "Data": [
    {
      "id": "b2c3d4e5-0000-0000-0000-000000000001",
      "name": "Jane Doe",
      "roles": [{ "name": "Viewer" }]
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false },
  "Instructions": "Roles shown are the user's Insights roles in the active tenant, by name. A user's row is kept even when directory enrichment fails."
}

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

{
  "Code": "InsightsUsersList",
  "Data": [
    {
      "id": "b2c3d4e5-0000-0000-0000-000000000001",
      "name": "Jane Doe",
      "email": "[e-mail]",
      "roles": [{ "id": 3, "name": "Viewer" }]
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

ユーザーの行は、そのユーザーのディレクトリー・エンリッチメント (表示データの解決) が失敗してもリストに保持され、不完全な行は削除されません。

参照

• Insights の概要
• alerts、 alert-history — テナント スコープのその他の読み取り対象領域。