UiPath Documentation
test-cloud
latest
false
Guide de l'API Test Cloud
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

Télécharger les événements

Points de terminaison de l'API pour le téléchargement des événements d'audit au niveau de l'organisation et du locataire sous forme de fichiers CSV dans Test Cloud.

Téléchargez les événements d'audit sous forme de fichier CSV. Chaque expérience de journalisation fournit des points de terminaison de téléchargement distincts.

New Audit experience​

La nouvelle expérience d’audit (journaux unifiés) utilise ces points de terminaison de l’API et fournit deux étendues:

  • Au niveau de l’organisation: /orgaudit_/
  • Au niveau du locataire: /tenantaudit_/

Ces API téléchargent des informations d'audit sur les services UiPath intégrés à l'infrastructure unifiée.

Point de terminaison de l’API​

Au niveau de l'organisation​

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

Remplacez {accessURL} dans tous les chemins de point de terminaison par l'URL de base de votre plate-forme cloud :

Cloud PlatformURL d'accès
Test Cloudhttps://cloud.uipath.com/
Test Cloud Secteur Publichttps://govcloud.uipath.us/
Test Cloud dédiéhttps://{customURL}.dedicated.uipath.com/
Niveau du locataire​

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

Remplacez {accessURL} dans tous les chemins de point de terminaison par l'URL de base de votre plate-forme cloud :

Cloud PlatformURL d'accès
Test Cloudhttps://cloud.uipath.com/
Test Cloud Secteur Publichttps://govcloud.uipath.us/
Test Cloud dédiéhttps://{customURL}.dedicated.uipath.com/

Étendues​

Nécessite l’une des étendues suivantes :

  • PM.Audit
  • PM.Audit.Read

En-têtes de requête.​

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

Pour obtenir le {access_token}, assurez-vous de vous authentifier via l'une des méthodes décrites ici.

Paramètres de requête​

Paramètre Saisie de texte Description
from (facultatif) DateTime Début de l’intervalle de temps
to (facultatif) DateTime Fin d’intervalle de temps
source (facultatif) Tableau [Chaîne] Liste des sources d'événements
target (facultatif) Tableau [Chaîne] Liste des catégories
type (facultatif) Tableau [Chaîne] Liste des activités
userIds (facultatif) Tableau [Chaîne] Liste des identificateurs utilisateur
status (facultatif) Entier
  • 0 = réussi
  • 1 = échec

Réponses​

200 OK​

Télécharge un fichier CSV contenant les événements d'audit sélectionnés.

Exemple de requête​

Au niveau de l'organisation​
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}'
Niveau du locataire​
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}'

Expérience des journaux classiques​

Point de terminaison de l’API​

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

Remplacez {accessURL} dans tous les chemins de point de terminaison par l'URL de base de votre plate-forme cloud :

Cloud PlatformURL d'accès
Test Cloudhttps://cloud.uipath.com/
Test Cloud Secteur Publichttps://govcloud.uipath.us/
Test Cloud dédiéhttps://{customURL}.dedicated.uipath.com/

Étendues​

Nécessite l’une des étendues suivantes :

  • PM.Audit
  • PM.Audit.Read

En-têtes de requête.​

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

Pour obtenir le {access_token}, assurez-vous de vous authentifier via l'une des méthodes décrites ici.

Paramètres de requête​

Paramètre de requêteType de donnéesDescription
language (facultatif)stringSpécifiez la langue d'affichage disponible, sous sa forme abrégée. Par exemple, en, fr, de, ou ja.
size (facultatif)Int32Indiquez la taille du téléchargement.

Réponses​

200 OK​

La liste des événements d'audit est téléchargée sur votre machine, au format .csv.

Exemple de requête​

Supposons que vous ayez rassemblé toutes les informations nécessaires pour créer l'appel d'API.

  • Votre {baseURL} est : https://cloud.uipath.com/{organizationName}
  • Votre {access_token} est : 1234 (pour des considérations de longueur).
  • Vous définissez les paramètres de requête suivants :
    • language = en
    • size = 13, pour télécharger les 13 premières entrées.

L'appel doit ressembler à l'exemple suivant (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'

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour