Grupos de UIP Insights

Sintaxis y opciones para `grupos de Insights de UIP`, que lee los grupos de Insights del tenant activo y sus nombres de rol de Insights.

uip insights groups lee los grupos de tenant visibles para la persona que llama actual, junto con sus nombres de rol de Insights. Esta es una superficie de solo lectura: no hay verbos para crear, actualizar o eliminar.

Importante:

Leer grupos de Insights requiere el permiso Ver de Insights Management en el tenant activo. Una sesión sin identidad de usuario (por ejemplo, una sesión iniciada con credenciales de cliente) no puede leer estos datos en absoluto y obtiene un 403.

Sinopsis

uip insights groups list [--include-email] [-l <n>] [-o <n>]
uip insights groups get <group-id> [--include-email]

Ambos verbos respetan las opciones globales y los códigos de salida estándar. Ninguno acepta -t, --tenant: utilizan el tenant seleccionado durante uip login.

lista de grupos de uip insights

Enumera los grupos de tenants visibles para la persona que llama actual, con sus nombres de rol de Insights. Cada fila se resuelve a través del directorio (una llamada en caché por grupo, en secuencia), por lo que la primera lista (caché en frío) de un tenant grande puede ser más lenta que una users list de tamaño similar.

Opciones

Marca	Descripción
--include-email	Incluye las direcciones de correo electrónico y los ID de rol anidados en la salida. Desactivado de forma predeterminada: la vista predeterminada omite ambos.
-l, --limit <number>	Máximo de filas para devolver. El valor predeterminado es 50.
-o, --offset <number>	Filas a omitir antes de devolver resultados.

La paginación es del lado del cliente: el backend devuelve la lista completa sin paginar y la CLI la corta después de recuperarla.

Ejemplos

uip insights groups list

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

Forma de datos: vista predeterminada

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

Forma de datos: con --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 }
}

El filtrado de directorios puede soltar filas. Un grupo que la búsqueda en el directorio del backend no puede resolver se omite por completo de la lista: la falta de un grupo no es prueba de que no exista; groups get aún puede resolverlo directamente. En una lista vacía, la nota de pie anterior se elimina ya que no se retuvo nada de las filas cero, pero la advertencia de resolución de directorio y la nota de coste por grupo siguen aplicándose.

los grupos de uip insights obtienen

Obtener un grupo de Insights por su GUID. A diferencia de list, esto puede persistir el nombre del directorio y los campos de correo electrónico actualizados para el grupo como efecto secundario: tiene forma de lectura pero no es una lectura pura.

Argumentos

Nombre	Obligatorio	Propósito
<group-id>	Sí	GUID de grupo. Debe ser un GUID real: un valor mal formado falla en el lado del cliente con Run 'uip insights groups list' to find a group ID. antes de cualquier llamada de red.

Opciones

Marca	Descripción
--include-email	Incluye las direcciones de correo electrónico y los ID de rol anidados en la salida. Desactivado de forma predeterminada.

Ejemplo

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

Forma de datos (--json de salida)

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

Con --include-email, la misma forma gana email y el roles[].id anidado, igual que la vista de lista.

Group <id> was not found in the active Insights tenant, or is not visible there. en un 404: un grupo que el directorio no puede resolver también los 404 aquí, por lo que un 404 por sí solo no es prueba de que el grupo almacenado no existe. Si cada comando RBAC de Insights es 404, es probable que el tenant no tenga aprovisionado el servicio del portal de Insights.

Ver también

• Descripción general de Insights
• usuarios, roles : las otras superficies de lectura de RBAC; roles asigna los nombres de rol que se muestran aquí a sus GUID y viceversa.