grupos do uipath insights

Sintaxe e opções para "uip insights Groups", que lê os grupos do Insights do tenant ativo e seus nomes de função do Insights.

uip insights groups lê os grupos de 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 grupos 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 groups list [--include-email] [-l <n>] [-o <n>]
uip insights groups get <group-id> [--include-email]

Ambos os verbos honram as opções globais e os códigos de saída padrão. Nenhum dos dois aceita -t, --tenant — eles usam o tenant selecionado durante uip login.

lista de grupos do uip insights

Listar grupos de tenant visíveis para o chamador atual, com seus nomes de função no Insights. Cada linha é resolvida por meio do diretório — uma chamada em cache por grupo, em sequência — para que a primeira lista (cold-cache) de um tenant grande possa ser mais lenta que uma users list de tamanho semelhante.

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 groups list

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

Formato dos dados — exibição padrão

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

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

A filtragem de diretório pode descartar linhas. Um grupo que a pesquisa do diretório do back-end não pode resolver é omitido totalmente da lista — um grupo ausente não é prova de que não existe; groups get ainda podem resolvê-lo diretamente. Em uma lista vazia, a nota de tempo acima é descartada, pois nada foi retido de zero linhas, mas a requisição de resolução de diretório e a nota de custo por grupo ainda se aplicam.

grupos de insights do uip obter

Obter um grupo do Insights por seu GUID. Ao contrário de list, isso pode persistir os campos de nome do diretório e e-mail atualizados para o grupo como um efeito lateral — é em forma de leitura, mas não uma leitura pura.

Argumentos

Name	Required	Finalidade
<group-id>	sim	GUID do grupo. Deve ser um GUID real — um valor malformado falha no lado do cliente com Run 'uip insights groups list' to find a group ID. antes de qualquer chamada de rede.

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.

Exemplo

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

Formato dos dados (--output json)

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

Com --include-email, a mesma forma ganha email e a roles[].id aninhada, da mesma forma que a exibição de lista.

Group <id> was not found in the active Insights tenant, or is not visible there. em um 404 — um grupo que o diretório não pode resolver também 404s aqui; portanto, um 404 isolado não é prova de que o grupo armazenado não existe. Se todos os comandos RBAC do Insights forem 404s, o tenant provavelmente não terá o serviço Portal do Insights provisionado.

Veja também

• Visão geral do Insights
• usuários, funções — as outras superfícies de leitura do RBAC; roles mapeia os nomes das funções mostrados aqui para seus GUIDs e vice-versa.