UiPath CLI - uip insights users

uipath-cli

latest

false

UiPath CLI ユーザーガイド

重要 :

このコンテンツは機械翻訳によって処理されています。新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。

uip insights users

Syntax and options for `uip insights users`, which reads the Insights users of the active tenant and their Insights role names.

uip insights users reads the tenant users visible to the current caller, along with their Insights role names. This is a read-only surface — there is no create, update, or delete verb.

重要:

Reading Insights users requires the Insights Management View permission in the active tenant. A session with no user identity (for example, one signed in with client credentials) cannot read this data at all and gets a 403.

概要

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

This verb honors the global options and the standard exit codes. It does not accept -t, --tenant — it uses the tenant selected during uip login.

uip insights users list

List tenant users visible to the current caller, with their Insights role names.

オプション

フラグ	説明
`--include-email`	Include email addresses and the nested role IDs in the output. Off by default — the default view omits both.
`-l, --limit <number>`	Maximum rows to return. Defaults to `50`.
`-o, --offset <number>`	Rows to skip before returning results.

Pagination is client-side: the backend returns the full unpaginated list, and the CLI slices it after fetching.

例

uip insights users list

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

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

Data shape — default view

{
  "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."
}
{
  "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."
}

Data shape — with `--include-email`

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

A user's row is kept in the list even when directory enrichment (resolving display data) fails for that user — an incomplete row is not dropped.

参照

Insights overview
alerts, alert-history — other tenant-scoped read surfaces.

概要
uip insights users list
オプション
例
Data shape — default view
Data shape — with --include-email
参照

このページは役に立ちましたか?

前へalert-deliveries

次へロール

概要​

uip insights users list​

オプション​

例​

Data shape — default view​

Data shape — with --include-email​

参照​

このページは役に立ちましたか?

概要

uip insights users list

オプション

例

Data shape — default view

Data shape — with `--include-email`

参照