usuários do uipath insights

Sintaxe e opções para "uip insights Users", que lê os usuários do Insights do tenant ativo e seus nomes de funções do Insights.

uip insights users lê os usuários do tenant visíveis para o chamador atual, juntamente com seus nomes de funções do Insights. Essa é uma superfície somente leitura — não há verbo criar, atualizar ou excluir.

Importante:

A leitura de usuários do Insights requer a permissão Visualização de gerenciamento do Insights no tenant ativo. Uma sessão sem identidade do usuário (por exemplo, uma sessão conectada com credenciais do cliente) não pode ler esses dados e recebe um 403.

Resumo

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

Esse verbo respeita as opções globais e os códigos de saída padrão. Ele não aceita -t, --tenant — usa o tenant selecionado durante uip login.

lista de usuários do uip insights

Listar os usuários do tenant visíveis para o chamador atual, com seus nomes de função no Insights.

Opções

Bandeira	Description
--include-email	Inclua endereços de email e os IDs de função aninhados na saída. Desligado por padrão — a visualização padrão omite ambos.
-l, --limit <number>	Máximo de linhas a serem retornadas. O padrão é 50.
-o, --offset <number>	Linhas a ignorar antes de retornar resultados.

A paginação é do lado do cliente: o back-end retorna a lista completa não paginada, e a CLI a fatia após a busca.

Exemplos

uip insights users list

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

Formato dos dados — exibição padrão

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

Formato dos dados — com --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 }
}

A linha de um usuário é mantida na lista mesmo quando o enriquecimento do diretório (resolvido de dados de exibição) falha para esse usuário — uma linha incompleta não é descartada.

Veja também

• Visão geral do Insights
• alertas, histórico de alerta — outras superfície de leitura com escopo de tenant.