Descargar eventos

Puntos finales de la API para descargar eventos de auditoría como un archivo CSV, que cubre tanto los ámbitos de la organización como los del tenant en la nueva experiencia de auditoría.

Descarga los eventos de auditoría como archivo CSV. Cada experiencia de registro proporciona puntos finales de descarga independientes.

New Audit experience

La nueva experiencia de auditoría (registros unificados) utiliza estos puntos finales de API y proporciona dos ámbitos:

• Nivel de organización: /orgaudit_/
• Nivel de tenant: /tenantaudit_/

Estas API descargan información de auditoría en los servicios de UiPath integrados en el marco unificado.

Punto final de API

Nivel de organización

GET {accessURL}/{org-name}/orgaudit_/api/query/downloadevents

Sustituye {accessURL} en todas las rutas de los puntos finales por la URL base de tu plataforma en la nube:

Cloud Platform	URL de acceso
Automation Cloud	https://cloud.uipath.com/
Sector público de Automation Cloud	https://govcloud.uipath.us/
Automation Cloud dedicado	https://{customURL}.dedicated.uipath.com/

Nivel tenant

GET {accessURL}/{org-name}/{tenant-name}/tenantaudit_/api/query/downloadevents

Sustituye {accessURL} en todas las rutas de los puntos finales por la URL base de tu plataforma en la nube:

Cloud Platform	URL de acceso
Automation Cloud	https://cloud.uipath.com/
Sector público de Automation Cloud	https://govcloud.uipath.us/
Automation Cloud dedicado	https://{customURL}.dedicated.uipath.com/

Ámbitos

Requiere uno de los siguientes ámbitos:

• PM.Audit
• PM.Audit.Read

Solicitar encabezados.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Nota:

Para obtener el {access_token}, asegúrate de autenticarte a través de uno de los métodos descritos aquí.

Parámetros de consulta

Parámetro	Tipo	Descripción
from (opcional)	Datetime	Inicio del intervalo de tiempo
to (opcional)	Datetime	Fin del intervalo de tiempo
source (opcional)	Matriz [String]	Lista de orígenes de eventos
target (opcional)	Matriz [String]	Lista de categorías
type (opcional)	Matriz [String]	Enumerar todas las actividades
userIds (opcional)	Matriz [String]	Lista de identificadores de usuario
status (opcional)	Entero	0 = correcto 1 = fallido

Respuesta

200 OK

Descarga un archivo .CSV que contiene los eventos de auditoría seleccionados.

Solicitud de ejemplo

Nivel de organización

curl --location 'https://cloud.uipath.com/{org-name}/orgaudit_/api/query/downloadevents?from=2024-12-24T00:00:00Z&to=2025-03-24T00:00:00Z&status=0' \
--header 'Authorization: Bearer {token}'

Nivel tenant

curl --location 'https://cloud.uipath.com/{org-name}/{tenant-name}/tenantaudit_/api/query/events?status=0&from=2024-12-24T19%3A11%3A46.403Z&to=2025-03-24T19%3A11%3A46.403Z&source
=1bf33a0d-fbe0-4fe5-b7f6-c61379878989&source
=afef9b33-872c-4c10-9039-009866131e77&source=f51fa47f-a015-4b0b-b9c3-28caa3d00788
&source=3e5e8c49-5e7f-41cc-a2ec-c42f9deebb70&target=5c8402f9-0529-4317-8790-568842208620&target=19d7f55c-c580-4bec-b6f0-d5deab0b17f3&target=09d74792-21f4-4bc9-a650-9020f8811c32&type=a912d4d8-df39-44c7-b696-27c5660c06da&type
=a57e644c-2d80-4f40-ac3b-b7c934d0a510&userIds
=4120ea1c-5d2b-4287-ba6c-904c694d2767&userIds=a922809d-3956-4376-8406-4eb2d6d6b363' \
--header 'Authorization: Bearer {token}'

Experiencia de registro clásica

Punto final de API

GET {accessURL}/audit_/api/auditlogs/download

Sustituye {accessURL} en todas las rutas de los puntos finales por la URL base de tu plataforma en la nube:

Cloud Platform	URL de acceso
Automation Cloud	https://cloud.uipath.com/
Sector público de Automation Cloud	https://govcloud.uipath.us/
Automation Cloud dedicado	https://{customURL}.dedicated.uipath.com/

Ámbitos

Requiere uno de los siguientes ámbitos:

• PM.Audit
• PM.Audit.Read

Solicitar encabezados.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Nota:

Para obtener el {access_token}, asegúrate de autenticarte a través de uno de los métodos descritos aquí.

Parámetros de consulta

Parámetros de consulta	Tipo de datos	Descripción
language (opcional)	String	Especifica el idioma de visualización disponible en forma acortada. Por ejemplo, en, fr, de, ja etc.
size (opcional)	Int32	Especifica el tamaño de la descarga.

Respuesta

200 OK

La lista de eventos de auditoría se descargará en tu dispositivo en formato .csv.

Solicitud de ejemplo

Supongamos que has recopilado toda la información necesaria para crear la llamada a la API.

• Tu {baseURL} es: https://cloud.uipath.com/{organizationName}
• Tu {access_token} es: 1234 (para consideraciones de longitud)
• Puedes establecer los siguientes parámetros de consulta:
  • language = en
  • size = 13, para descargar las 13 primeras entradas.

La llamada debe parecerse al siguiente ejemplo (CURL):

curl --location --request GET ' https://cloud.uipath.com/{organizationName}/audit_/api/auditlogs/download?language=en&size=13' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'