UiPath Documentation
automation-cloud
latest
false
Automation Cloud-API-Handbuch
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Ereignisse herunterladen

API-Endpunkte zum Herunterladen von Prüfungsereignissen als CSV-Datei, die in der neuen Prüfung sowohl Scopes auf Organisations- als auch Mandantenebene abdecken.

Laden Sie Prüfungsereignisse als CSV-Datei herunter. Jede Protokollierungsumgebung bietet separate Download-Endpunkte.

New Audit experience​

Die neue Prüfung (Einheitliche Protokolle) verwendet diese API-Endpunkte und bietet zwei Scopes:

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

Diese APIs laden Prüfungsinformationen über UiPath-Dienste hinweg herunter, die in das einheitliche Framework integriert sind.

API-Endpunkt​

Organisationsebene​

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

Ersetzen Sie {accessURL} in allen Endpunktpfaden durch die Basis-URL für Ihre Cloud-Plattform:

Cloud PlatformZugriffs-URL
Automation Cloudhttps://cloud.uipath.com/
Automation Cloud – Öffentlicher Sektorhttps://govcloud.uipath.us/
Automatisierung – cloudgeeignethttps://{customURL}.dedicated.uipath.com/
Mandantenebene​

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

Ersetzen Sie {accessURL} in allen Endpunktpfaden durch die Basis-URL für Ihre Cloud-Plattform:

Cloud PlatformZugriffs-URL
Automation Cloudhttps://cloud.uipath.com/
Automation Cloud – Öffentlicher Sektorhttps://govcloud.uipath.us/
Automatisierung – cloudgeeignethttps://{customURL}.dedicated.uipath.com/

Scopes​

Erfordert einen der folgenden Scopes:

  • PM.Audit
  • PM.Audit.Read

Anforderungsheader​

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

Um das {access_token} zu erhalten, müssen Sie sich mit einer der hier beschriebenen Methoden authentifizieren.

Abfrageparameter​

Parameter Typ Beschreibung
from (optional) DateTime Beginn des Zeitintervalls
to (optional) DateTime Ende des Zeitintervalls
source (optional) Array [Zeichenfolge] Liste der Ereignisquellen
target (optional) Array [Zeichenfolge] Liste der Kategorien
type (optional) Array [Zeichenfolge] Liste der Aktivitäten
userIds (optional) Array [Zeichenfolge] Liste der Benutzerbezeichner
status (optional) Integer
  • 0 = Erfolgreich
  • 1 = fehlgeschlagen

Antworten​

200 OK​

Lädt eine CSV-Datei mit den ausgewählten Prüfungsereignissen herunter.

Beispielanforderung​

Organisationsebene​
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}'
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}'
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&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}'
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}'

Klassische Protokollierungsumgebung​

API-Endpunkt​

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

Ersetzen Sie {accessURL} in allen Endpunktpfaden durch die Basis-URL für Ihre Cloud-Plattform:

Cloud PlatformZugriffs-URL
Automation Cloudhttps://cloud.uipath.com/
Automation Cloud – Öffentlicher Sektorhttps://govcloud.uipath.us/
Automatisierung – cloudgeeignethttps://{customURL}.dedicated.uipath.com/

Scopes​

Erfordert einen der folgenden Scopes:

  • PM.Audit
  • PM.Audit.Read

Anforderungsheader​

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

Um das {access_token} zu erhalten, müssen Sie sich mit einer der hier beschriebenen Methoden authentifizieren.

Abfrageparameter​

AbfrageparameterDatentypBeschreibung
language (optional)stringGeben Sie die verfügbare Anzeigesprache in verkürzter Form an. Zum Beispiel: en, fr, de, ja etc.
size (optional)Int32Geben Sie die Downloadgröße an.

Antworten​

200 OK​

Die Liste der Prüfungsereignisse wird im Format .csv auf Ihre Maschine heruntergeladen.

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
    • size = 13, um die 13 wichtigsten Einträge herunterzuladen.

Der Aufruf sollte dem folgenden Beispiel ähneln (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'
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'

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben