Funções do UIP Insights

Sintaxe e opções para "funções do Insights", que lê as funções do Insights do tenant ativo.

uip insights roles lê as funções do Insights definidas no tenant ativo. Essa é uma superfície somente leitura — não há verbo criar, atualizar ou excluir.

Importante:

A leitura de funções 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 roles list [--include-resource] [-l <n>] [-o <n>]
uip insights roles get <role-id> [--include-resource]

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 funções do uip insights

Lista as funções do Insights visíveis para o chamador atual. A lista pode ser filtrada por direitos — um tenant sem direitos de modo completo vê apenas o conjunto de funções somente leitura — e a listagem pode disparar uma chamada em cache para Licenciamento para verificar esse direito.

Opções

Bandeira	Description
--include-resource	Inclua a string do recurso de função, que pode carregar os GUIDs da organização e do tenant, na saída. Desligado por padrão.
-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 roles list

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

Formato dos dados — exibição padrão

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

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

Uma lista vazia é um resultado bem-sucedido, não um erro — a resposta omite as notas pendentes/retidas acima quando não há linhas, pois nada foi retido de um resultado vazio.

funções do uip insights obter

Obtenha uma função do Insights pelo seu GUID. O filtro de direito da lista não se aplica aqui — get pode resolver uma função que list filtrou.

Argumentos

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

Opções

Bandeira	Description
--include-resource	Inclua a string de recurso de função na saída. Desligado por padrão.

Exemplo

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

Formato dos dados (--output json)

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

--include-resourceCom, a mesma forma ganha um resource campo, igual à exibição de lista.

Role <id> was not found in the active Insights tenant, or is not visible there. em um 404 — se todos os comandos do RBAC do Insights gerarem 404s, o tenant provavelmente não terá o serviço do Portal do Insights provisionado.

Veja também

• Visão geral do Insights
• usuários, grupos — as outras superfícies de leitura do RBAC; ambas mostram nomes de funções resolvidos pelos dados desse comando.