Audit d’administrateur UIP

Syntaxe et options de `uip admin audit`, qui interroge et exporte les événements d'audit d'administrateur UiPath au niveau de l'organisation et du locataire.

uip admin audit interroge et exporte les événements d'audit UiPath — la piste d'audit d'administration au niveau de la plate-forme (différente à uip or audit-logs qui couvre les modifications d'entité Orchestrator). Une partie de uip admin (aperçu), l’outil d’administration UiPath.

Deux sous-groupes d'étendue enregistrent la forme identique à trois verbes:

• org — Audit au niveau de l'organisation (événements d'administration indépendants du locataire).
• tenant — audit à l'échelle du locataire (événements étendus au locataire de connexion actif ou --tenant-id).

Workflow type: audit <scope> sources (découvrir les ID de source) → audit <scope> events --source <guid> --from-date … --to-date … (rechercher les lignes) → audit <scope> export --from-date … --to-date … --output-path … (les télécharger).

Synthèse

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 verbes acceptent également --tenant-id <guid> pour remplacer le locataire de votre contexte de connexion; Ce n’est pas le cas des org verbes (l’étendue de l’organisation n’a pas de locataire à remplacer).

sources d'organisation d'audit d'administrateur uip / sources de locataire d'audit d'administrateur uip

Répertoriez les sources d'événements d'audit visibles à cette étendue, — chaque source étant une catégorie d'événements de niveau supérieur (par exemple Identity, Tenant, Robot). Utilisez les valeurs id renvoyées par events --source <guid>.

Options

Long	Valeur (Value)	Description
--tenant-id <guid>	GUID	(Étendue tenant uniquement.) Remplacez le locataire à partir du contexte de connexion.
--login-validity <minutes>	Integer	Remplacez la durée de vie du jeton de connexion interactive pour cet appel. Rarement nécessaire.

Exemple

uip admin audit org sources

Format des données (--sortie json)

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

Code est AuditTenantSources sous tenant.

événements d'organisation d'audit d'administrateur uip / événements de locataire d'audit d'administrateur uip

Interroger les événements d'audit à cette étendue, paginés. Renvoie { auditEvents, next, previous } — et pas un tableau à barres. L'affectation de noms du curseur est chronologique: next correspond à des événements plus récents, previous est plus ancien. Lorsque --limit dépasse 200, la pagination de la CLI est effectuée en interne (Suivant previous) car le serveur bloque chaque appel sur 200 lignes.

Options

Long	Valeur (Value)	Description
--from-date <iso>	ISO 8601	Début de l’intervalle de temps. Inclus.
--to-date <iso>	ISO 8601	Fin de l’intervalle de temps. Inclus.
--source <guid>	GUID, répétable	Filtrez par ID de source d'événements. Découvrez avec sources.
--target <guid>	GUID, répétable	Filtrer par ID de cibles d'événements.
--type <guid>	GUID, répétable	Filtrez par ID de type d'événement.
--user-id <guid>	GUID, répétable	Filtrer par ID utilisateur agissant.
--search <term>	string	Recherche de sous-chaînes côté serveur.
--status <status>	Success | Failure	Filtre de statut d’événement insensible à la casse.
--limit <n>	Integer	Nombre total d'événements à renvoyer, 1-10 000. Les valeurs supérieures à 200 sont paginées côté client (le serveur bloque chaque appel sur 200).
--tenant-id <guid>	GUID	(Étendue tenant uniquement.) Remplacez le locataire à partir du contexte de connexion.
--login-validity <minutes>	Integer	Remplacez la durée de vie du jeton de connexion interactive pour cet appel. Rarement nécessaire.

Exemples

# 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

Format des données (--sortie json)

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

Code est AuditTenantEvents sous tenant.

Exportation de l'organisation d'audit d'UIP/Exportation du locataire d'audit d'UIP

Exportez les événements d'audit du magasin à long terme. Émet un appel HTTP par jour UTC à l'intérieur de [--from-date, --to-date] et agrège les résultats en mémoire avant d'écrire n'importe quoi — la fenêtre complète est extraite en premier, et en cas d'échec d'un jour unique, l'exportation est abandonnée de manière atomique ( plan n'est rien écrit; l'échec nomme le jour qui échoué).

--output-path est un répertoire de base, pas un chemin d'accès au fichier — passez un dossier, et la CLI génère une sortie nommée de manière unique à l'intérieur, tamponnée avec la fenêtre et l'heure de génération (par exemple audit_2026-01-01_2026-02-01_20260617T112630), les exportations répétées de la même fenêtre ne correspondent jamais:

• --file-format json (par défaut) — un dossier d'un fichier JSON par jour UTC.
• --file-format csv — un seul fichier CSV avec chaque événement fusionné sous un en-tête partagé.

Options

Long	Valeur (Value)	Requis	Description
--from-date <iso>	ISO 8601	oui	Début de l’intervalle de temps.
--to-date <iso>	ISO 8601	oui	Fin de l’intervalle de temps.
--output-path <dir>	Chemin d'accès	Conditionnel	Répertoire de base pour l’exportation (créé s’il est manquant). Transmettez uniquement un répertoire, jamais un nom de fichier — la CLI nomme la sortie pour vous. Obligatoire, sauf si --output-file (alias obsolète) est transmis à la place.
--output-file <dir>	Chemin d'accès	non	Alias obsolète pour --output-path, conservé à des fins de rétrocompatibilité. Malgré le nom, toujours traité comme un répertoire de base. Lorsque les deux sont respectées, --output-path l'emporte et un avertissement d'obsolescence est consigné.
--file-format <format>	json | csv	non	Format de sortie. Par défaut json.
--tenant-id <guid>	GUID	non	(Étendue tenant uniquement.) Remplacez le locataire à partir du contexte de connexion.
--login-validity <minutes>	Integer	non	Remplacez la durée de vie du jeton de connexion interactive pour cet appel. Rarement nécessaire.

Exemples

# 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

Format des données (--sortie json)

Format 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"
  }
}

Le format CSV ajoute un nombre Events à la place 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 est AuditTenantExport sous tenant.

Résolution des problèmes

• HTTP 401 — le jeton ne dispose probablement pas de l'étendue Audit.Read . Exécutez uip logout && uip login pour explorer un nouveau jeton.
• HTTP 403 — l'utilisateur connecté ne dispose pas de l'autorisation de lecture d'audit sur ce locataire; vérifier les attributions de rôles dans Automation Cloud.
• Tenant ID required (étendue du locataire): passez --tenant-id <guid>, ou connectez-vous et sélectionnez d'abord un locataire.
• HTTP 504 lors de l'exportation, ou « Échec de l'exportation d'audit pour <date>» — segment d'un seul jour expiré. Réexécuter: l'exportation est idempotente. Si cela persiste, affinez --from-date/--to-date pour ignorer le jour d’échec.
• « se résout en dehors du dossier de sortie»/nom de fichier non sécurisé lors de l'exportation — indique une réponse du serveur mal formée; réexécuter et le signaler si elle persiste.

Associé

• uip admin — Vue d'ensemble de l'ensemble de l'outil uip admin .
• uip or audit-logs — la piste d'audit de l'entité Orchestrator, une surface distincte de cet audit au niveau de l'administrateur.

Voir également

• Options globales
• Codes de sortie