auditoría de administración de UIP

Sintaxis y opciones para `auditoría de administración de UIP`, que consulta y exporta eventos de auditoría de administración de UiPath en el ámbito de la organización y el tenant.

uip admin audit consulta y exporta eventos de auditoría de UiPath : el seguimiento de auditoría de administración a nivel de plataforma (distinto de uip or audit-logs, que cubre los cambios de entidad de Orchestrator). Parte de uip admin (descripción general), la herramienta de administración de UiPath.

Dos subgrupos de ámbito registran la forma idéntica de tres verbos:

• org : auditoría del ámbito de la organización (eventos de administración que son independientes del tenant).
• tenant : auditoría con ámbito de tenant (eventos con ámbito en el tenant de inicio de sesión activo, o --tenant-id).

Flujo de trabajo típico: audit <scope> sources (descubrir ID de origen) → audit <scope> events --source <guid> --from-date … --to-date … (encontrar las filas) → audit <scope> export --from-date … --to-date … --output-path … (descargarlas).

Sinopsis

uip admin audit org sources [--login-validity <minutes>]
uip admin audit org events [--from-date <iso>] [--to-date <iso>] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--user-id <guid>...] [--search <term>] [--status Success|Failure] [--limit <n>]
uip admin audit org export --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

uip admin audit tenant sources [--tenant-id <guid>] [--login-validity <minutes>]
uip admin audit tenant events [--tenant-id <guid>] [... same filters as org events]
uip admin audit tenant export [--tenant-id <guid>] --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

tenant verbos además aceptan --tenant-id <guid> para anular el tenant de su contexto de inicio de sesión; org verbos no (el ámbito de la organización no tiene tenant que anular).

fuentes de la organización de auditoría de administración de uip / fuentes de tenant de auditoría de administración de uip

Enumera los orígenes de eventos de auditoría visibles en este ámbito: cada origen es una categoría de evento de nivel superior (por ejemplo, Identity, Tenant, Robot). Utiliza los valores id devueltos con events --source <guid>.

Opciones

Largo	Valor	Descripción
--tenant-id <guid>	GUID	(solo ámbito tenant ). Anula el tenant desde el contexto de inicio de sesión.
--login-validity <minutes>	Entero	Anula la vigencia del token de inicio de sesión interactivo para esta llamada. Rara vez es necesario.

Ejemplo

uip admin audit org sources

Forma de datos (--json de salida)

{
  "Code": "AuditOrgSources",
  "Data": [
    { "id": "11111111-1111-1111-1111-111111111111", "name": "Identity", "eventTargets": [] }
  ]
}

Code es AuditTenantSources bajo tenant.

eventos de organización de auditoría de administración de uip / eventos de tenant de auditoría de administración de uip

Consultar eventos de auditoría en este ámbito, paginado. Devuelve { auditEvents, next, previous } , no una matriz vacía. La denominación del cursor es cronológica: next son eventos más nuevos, previous es más antiguo. Cuando --limit supera 200, la CLI pagina internamente (siguiendo a previous) ya que el servidor limita cada llamada a 200 filas.

Opciones

Largo	Valor	Descripción
--from-date <iso>	ISO 8601	Inicio del intervalo de tiempo. Inclusivo.
--to-date <iso>	ISO 8601	Fin del intervalo de tiempo. Inclusivo.
--source <guid>	GUID, repetible	Filtrar por ID de origen de eventos. Descubrir con sources.
--target <guid>	GUID, repetible	Filtrar por ID de destino de evento.
--type <guid>	GUID, repetible	Filtrar por ID de tipo de evento.
--user-id <guid>	GUID, repetible	Filtrar por ID de usuario activos.
--search <term>	String	Búsqueda de subcadenas del lado del servidor.
--status <status>	Success | Failure	Filtro de estado de evento que no distingue entre mayúsculas y minúsculas.
--limit <n>	Entero	Total de eventos para devolver, 1–10000. Los valores superiores a 200 están paginados en el lado del cliente (el servidor limita cada llamada a 200).
--tenant-id <guid>	GUID	(solo ámbito tenant ). Anula el tenant desde el contexto de inicio de sesión.
--login-validity <minutes>	Entero	Anula la vigencia del token de inicio de sesión interactivo para esta llamada. Rara vez es necesario.

Ejemplos

# Fetch the latest 50 org audit events
uip admin audit org events --limit 50

# Filter by source and a 7-day window
uip admin audit tenant events --source 11111111-1111-1111-1111-111111111111 \
  --from-date 2026-04-22T00:00:00Z --to-date 2026-04-29T00:00:00Z

Forma de datos (--json de salida)

{
  "Code": "AuditOrgEvents",
  "Data": { "auditEvents": [], "next": null, "previous": null }
}

Code es AuditTenantEvents bajo tenant.

exportación de la organización de auditoría de administración de uip/exportación del tenant de auditoría de administración de uip

Exporta eventos de auditoría desde el almacén a largo plazo. Emite una llamada HTTP por día UTC dentro de [--from-date, --to-date] y agrega los resultados en la memoria antes de escribir algo: primero se obtiene la ventana completa y, en cualquier fallo de un solo día, la exportación se aborta de forma atómica (no se escribe nada; el fallo nombra el día que fallido).

--output-path un directorio base, no una ruta de archivo: pasa una carpeta y CLI genera una salida con nombre único dentro de ella, marcada con la ventana y el tiempo de generación (por ejemplo audit_2026-01-01_2026-02-01_20260617T112630), por lo que las exportaciones repetidas de la misma ventana nunca colisionan:

• --file-format json (predeterminado): una carpeta de un archivo JSON por día UTC.
• --file-format csv: un único archivo CSV con cada evento fusionado bajo un encabezado compartido.

Opciones

Largo	Valor	Obligatorio	Descripción
--from-date <iso>	ISO 8601	Sí	Inicio del intervalo de tiempo.
--to-date <iso>	ISO 8601	Sí	Fin del intervalo de tiempo.
--output-path <dir>	Ruta	condicionalmente	Directorio base para la exportación (creado si falta). Pasa solo un directorio, nunca un nombre de archivo: la CLI nombra la salida por ti. Obligatorio a menos que se pase --output-file (alias obsoleto) en su lugar.
--output-file <dir>	Ruta	No	Alias obsoleto para --output-path, mantenido por compatibilidad con versiones anteriores. A pesar del nombre, se sigue tratando como un directorio base. Cuando se pasan ambos, --output-path gana y se registra una advertencia de obsolescencia.
--file-format <format>	json | csv	No	Forma de salida. Predeterminado json.
--tenant-id <guid>	GUID	No	(solo ámbito tenant ). Anula el tenant desde el contexto de inicio de sesión.
--login-validity <minutes>	Entero	No	Anula la vigencia del token de inicio de sesión interactivo para esta llamada. Rara vez es necesario.

Ejemplos

# JSON export — a timestamped folder of day-wise JSON files is created under the base dir
uip admin audit org export --from-date 2026-01-01 --to-date 2026-02-01 --output-path ./audit-exports

# CSV export — a single uniquely-named .csv file under the base dir
uip admin audit tenant export --from-date 2026-01-01 --to-date 2026-02-01 \
  --file-format csv --output-path ./audit-exports

Forma de datos (--json de salida)

Formato JSON:

{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630",
    "Format": "json",
    "Files": 27,
    "Bytes": 12345,
    "Days": 31,
    "NonEmptyDays": 27,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}

El formato CSV añade un recuento Events en lugar de Files:

{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630.csv",
    "Format": "csv",
    "Bytes": 98765,
    "Days": 31,
    "NonEmptyDays": 27,
    "Events": 1234,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}

Code es AuditTenantExport bajo tenant.

Solución de problemas

• HTTP 401 : es probable que el token no esté en el ámbito Audit.Read . Ejecuta uip logout && uip login para acuñar un token nuevo.
• HTTP 403 : el usuario que ha iniciado sesión carece de permiso de lectura de auditoría en este tenant; comprueba las asignaciones de roles en Automation Cloud.
• Tenant ID required (ámbito de tenant): pasa --tenant-id <guid> o inicia sesión y selecciona primero un tenant.
• HTTP 504 en la exportación, o "Error de exportación de auditoría para <date>" : se agotó el tiempo de espera de un solo día. Volver a ejecutar: la exportación es idempotente. Si persiste, restrinja --from-date/--to-date para omitir el día que falla.
• "se resuelve fuera de la carpeta de salida"/nombre de archivo no seguro al exportar : indica una respuesta del servidor mal formada; volver a ejecutar e informar si persiste.

Relacionado

• uip admin : descripción general de toda la herramienta uip admin .
• uip or audit-logs : el seguimiento de auditoría de la entidad de Orchestrator, una superficie distinta de esta auditoría a nivel de administrador.

Ver también

• Opciones globales
• Códigos de salida