roles de uip insights

Sintaxis y opciones para los "roles de uip insights", que leen los roles de Insights del tenant activo.

uip insights roles lee los roles de Insights definidos en el tenant activo. Esta es una superficie de solo lectura: no hay verbos para crear, actualizar o eliminar.

Importante:

Leer los roles 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 roles list [--include-resource] [-l <n>] [-o <n>]
uip insights roles get <role-id> [--include-resource]

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 roles de uip insights

Enumerar los roles de Insights visibles para la persona que llama actual. La lista puede filtrarse por derechos (un tenant sin el derecho de modo completo solo ve el conjunto de roles de solo lectura) y el listado puede desencadenar una llamada en caché a Licencias para comprobar ese derecho.

Opciones

Marca	Descripción
--include-resource	Incluye la cadena de recursos del rol, que puede llevar los GUID de la organización y el tenant, en la salida. Desactivado de forma predeterminada.
-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 roles list

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

Forma de datos: vista predeterminada

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

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

Una lista vacía es un resultado correcto, no un error: la respuesta omite las notas permanentes/retenidas anteriores cuando no hay filas, ya que no se ha retenido nada de un resultado vacío.

Obtener roles de UIP Insights

Obtener un rol de Insights por su GUID. El filtro de derechos de la lista no se aplica aquí: get puede resolver un rol que list filtró.

Argumentos

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

Opciones

Marca	Descripción
--include-resource	Incluye la cadena de recursos del rol en la salida. Desactivado de forma predeterminada.

Ejemplo

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

Forma de datos (--json de salida)

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

Con --include-resource, la misma forma gana un campo resource, igual que la vista de lista.

Role <id> was not found in the active Insights tenant, or is not visible there. en un 404: 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, grupos : las otras superficies de lectura RBAC; ambos muestran nombres de roles resueltos por los datos de este comando.