Prüfungsereignisse abrufen

Rufen Sie die Prüfungsprotokolle für Ihre Organisation ab. Die APIs unterscheiden sich je nach Protokollierungserfahrung.

Einheitliche Protokollierung

Die einheitliche Protokollierung verwendet diese API-Endpunkte und bietet zwei Scopes:

• Organisationsebene: /orgaudit_/
• Mandantenebene: /tenantaudit_/

Diese APIs geben Prüfungsinformationen über die UiPath-Dienste hinweg zurück, die in das einheitliche Framework integriert sind.

API-Endpunkt

Zum Abrufen von Prüfungsprotokollen in der einheitlichen Protokollierungsumgebung können Sie zwei verschiedene Endpunkte verwenden:

• Metadaten: Ruft alle verfügbaren Prüfungsereignistypen ab, die als Hierarchie von Quellen, Kategorien und Aktivitäten strukturiert sind.

  Umfang	API-Endpunkt
  Organisationsebene	GET https://cloud.uipath.com/{org-name}/orgaudit_/api/query/sources
  Mandantenebene	GET https://cloud.uipath.com/{org-name}/{tenant-name}/tenantaudit_/api/query/sources

• Ereignisse abfragen: Ruft Prüfungsereignisse für den angegebenen Scope mit erweiterter Filterung ab.

  Umfang	API-Endpunkt
  Organisationsebene	GET https://cloud.uipath.com/{org-name}/orgaudit_/api/query/events
  Mandantenebene	GEThttps://cloud.uipath.com/{org-name}/{tenant-name}/tenantaudit_/api/query/events

Scopes

Erfordert einen der folgenden Scopes:

• PM.Audit
• PM.Audit.Read

Anforderungsheader

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

Abfrageparameter

Parameter	Datentyp	Beschreibung
from (optional)	DateTime	Beginn des Zeitintervalls.
to (optional)	DateTime	Ende des Zeitintervalls.
source (optional)	Array [Zeichenfolge]	Liste der Ereignisquellen (wie von der Metadaten- API zurückgegeben).
target (optional)	Array [Zeichenfolge]	Liste der Ereigniskategorien.
type (optional)	Array [Zeichenfolge]	Liste der Aktivitätstypen.
userIds (optional)	Array [Zeichenfolge]	Liste der Benutzerbezeichner.
searchTerm (optional)	String	Schlüsselwort oder Begriff, nach dem gesucht werden soll.
status (optional)	Integer	0 = Erfolgreich 1 = fehlgeschlagen.
maxCount (optional)	Integer	Maximale Anzahl der zurückzugebenden Datensätze.

Antworten

200 OK

Gibt ein JSON-Objekt zurück mit:

• Liste der Prüfungsereignisse

• next Link für die Paginierung mit neueren Ereignissen
• previous Link für die Paginierung mit älteren Ereignissen

Beispielantwort

{
  "auditEvents": [
    {
      "id": "string",
      "createdOn": "2025-03-24T18:35:38.122Z",
      "organizationId": "string",
      "organizationName": "string",
      "tenantId": "string",
      "tenantName": "string",
      "actorId": "string",
      "actorName": "string",
      "actorEmail": "string",
      "eventType": "string",
      "eventSource": "string",
      "eventTarget": "string",
      "eventDetails": "string",
      "eventSummary": "string",
      "status": 0,
      "clientInfo": {
        "ipAddress": "string",
        "ipCountry": "string"
      }
    }
  ],
  "next": "string",
  "previous": "string"
}

Beispielabfragen

• Organisationsebene

  curl --location 'https://cloud.uipath.com/{org-name}/orgaudit_/api/query/events?status=0&from=2024-12-24T19%3A11%3A46.403Z&to=2025-03-24T19%3A11%3A46.403Z' \
  --header 'Authorization: Bearer {token}'
  

• Mandantenebene

  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' \
  --header 'Authorization: Bearer {token}'
  

Klassische Protokollierungsumgebung

Ruft Prüfungsprotokolle für eine Organisation basierend auf ihrem Namen ab.

API-Endpunkt

GET https://cloud.uipath.com/audit_/api/auditlogs/partitionGlobalId

Scopes

Erfordert einen der folgenden Scopes:

• PM.Audit
• PM.Audit.Read

Anforderungsheader

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

Abfrageparameter

Abfrageparameter	Datentyp	Beschreibung
language (optional)	string	Geben Sie die verfügbare Anzeigesprache in verkürzter Form an. Zum Beispiel: en, fr, de, ja etc.
top (optional)	Int32	Zeigen Sie die obersten N Einträge der Prüfung an.
skip (optional)	Int32	Überspringen Sie die Anzeige der obersten N Prüfungseinträge.
sortBy (optional)	string	Geben Sie die DTO-Eigenschaft an, nach der Prüfungseinträge sortiert werden. Zum Beispiel: createdOn, category, email etc.
sortOrder (optional)	string	Bestimmen Sie die Sortierreihenfolge. Zum Beispiel aufsteigend (asc) oder absteigend (desc).
api-version (optional)	string	Geben Sie die von Ihnen verwendete API-Version an.

Antworten

200 OK

Gibt die abgefragten Prüfungsereignisse zurück.

Beispielanforderung

Angenommen, Sie haben alle Informationen gesammelt, die zum Erstellen des API-Aufrufs erforderlich sind.

• Ihre {baseURL} ist: https://cloud.uipath.com/{organizationName}
• Ihre {access_token} ist: 1234 (aus Gründen der Länge).

• Sie legen die folgenden Abfrageparameter fest:

  • language = en
  • top = 2, um die beiden obersten Einträge anzuzeigen
  • skip = 2, um die ersten beiden Einträge zu überspringen
  • sortBy = createdOn, um die Einträge nach ihrem Erstellungsdatum zu sortieren
  • sortOrder = asc, um die Einträge vom ältesten bis zum neuesten Eintrag zu sortieren

Der Aufruf sollte dem folgenden Beispiel ähneln (cURL):

curl --location --request GET ' https://cloud.uipath.com/{organizationName}/audit_/api/auditlogs?language=en&top=2&skip=2&sortBy=createdOn&sortOrder=asc' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'

Hier ist der Antworttext für einen erfolgreichen Abruf von Prüfungseinträgen:

{
    "totalCount": 29,
    "results": [
        {
            "createdOn": "2021-10-14T13:10:15.1964174+00:00",
            "category": "User",
            "action": "Login",
            "auditLogDetails": "{\r\n \"userName\": \"System Administrator admin\",\r\n \"email\": \"\"\r\n}", 
            "userName": "System Administrator",
            "email": "",
            "message": "User 'System Administrator admin' logged in",
            "detailsVersion": "1.0",
            "source": "Cis"
        },
....
        {
            "createdOn": "2021-10-14T12:41:00.3268964+00:00",
            "category": "User",
            "action": "Login",
            "auditLogDetails": "{\r\n \"userName\": \"System Administrator admin\",\r\n \"email\": \"\"\r\n}", 
            "userName": "System Administrator",
            "email": "",
            "message": "User 'System Administrator admin' logged in",
            "detailsVersion": "1.0",
            "source": "Cis"
        }
    ]
}