UIP Insights のロール

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

uip insights roles は、アクティブなテナントで定義されている Insights ロールを読み取ります。これは読み取り専用のサーフェスであり、作成、更新、削除動詞はありません。

重要:

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

概要

uip insights roles list [--include-resource] [-l <n>] [-o <n>]
uip insights roles get <role-id> [--include-resource]

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

uip insights のロールのリスト

現在の呼び出し元に表示される Insights ロールのリストを表示します。このリストは権利フィルター処理することができ (フル モードの権利のないテナントには、読み取り専用のロール セットのみが表示されます)、リストを作成すると、その権利を確認するためのライセンスへのキャッシュ呼び出しをトリガーできます。

オプション

フラグ	説明
--include-resource	組織とテナントの GUID を運ぶことができるロール リソース文字列を出力に含めます。既定ではオフです。
-l, --limit <number>	返される最大行数。既定値は 50です。
-o, --offset <number>	結果を返す前にスキップする行です。

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

例

uip insights roles list

uip insights roles list --include-resource --limit 100

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

{
  "Code": "InsightsRolesList",
  "Data": [
    { "id": "c1d2e3f4-0000-0000-0000-000000000001", "name": "Viewer", "actions": ["Read"] }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false },
  "Instructions": "Role names can be entitlement-filtered: a role missing from this list can still exist and 'roles get' can still resolve it. Listing roles can trigger a cached entitlement call to Licensing. 'uip insights users list' and 'uip insights groups list' show these roles by name on each principal's row."
}

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

{
  "Code": "InsightsRolesList",
  "Data": [
    {
      "id": "c1d2e3f4-0000-0000-0000-000000000001",
      "name": "Viewer",
      "actions": ["Read"],
      "resource": "orn:orch:tenant:t1:role:Viewer"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

空のリストは成功の結果であり、エラーではありません — 空の結果から何も保留されなかったため、行がない場合、応答では上記のスタンディング ノート/保留ノートが省略されます。

UIP Insights のロールの取得

Insights のロールを 1 つ GUID で取得します。リストのエンタイトルメント フィルターはここでは適用されません。 get フィルター処理 list ロールを解決できます。

引数

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

オプション

フラグ	説明
--include-resource	出力にロール リソース文字列を含めます。既定ではオフです。

例

uip insights roles get c1d2e3f4-0000-0000-0000-000000000001

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

{
  "Code": "InsightsRoleGet",
  "Data": { "id": "c1d2e3f4-0000-0000-0000-000000000001", "name": "Viewer", "actions": ["Read"] }
}

--include-resourceでは、リスト ビューと同じ図形にresourceフィールドが追加されます。

404 のRole <id> was not found in the active Insights tenant, or is not visible there. — すべての Insights RBAC が 404 をコマンドする場合は、テナントに Insights ポータル サービスがプロビジョニングされていない可能性があります。

参照

• Insights の概要
• ユーザー、 グループ — その他の RBAC 読み取りサーフェス。どちらも、このコマンドのデータによって解決されたロール名を示します。