Passer au contenu principal
POST
Créer une exportation d'événements à risque
Soumettez un objet tel que { "format": "json", "event_types": ["signal", "decision"] }. Enregistrez export_id et interrogez le point de terminaison de lecture. Une réponse 202 confirme que le travail existe ; elle ne confirme pas que le traitement est terminé. Les exportations de risques contiennent les signaux et les décisions de risque de l’espace de travail. Elles ne configurent pas la transmission automatique des journaux d’audit. Voir intégration SIEM pour la distinction.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

application/json
format
enum<string>
défaut:json
Options disponibles:
json,
csv,
cef,
leef
event_types
enum<string>[]

Enregistrez les catégories à inclure. Vide ou omis inclut les deux ; ce ne sont pas des noms de fournisseurs ou des sous-types de signaux de risque.

Maximum array length: 2
Options disponibles:
signal,
decision
since
string<date-time>

Borne inférieure inclusive. Par défaut, 30 jours avant la fin.

until
string<date-time>

Borne supérieure exclusive. Par défaut, l'heure de la requête. Plage maximale : 366 jours ; les plages futures sont rejetées.

Réponse

Tâche persistante ; interrogez son export_id

export_id
string<uuid>
status
enum<string>
Options disponibles:
pending,
running,
complete,
failed
format
enum<string>
Options disponibles:
json,
csv,
cef,
leef
since
string<date-time>
until
string<date-time>
event_types
enum<string>[]
Options disponibles:
signal,
decision
record_count
integer
created_at
string<date-time>
completed_at
string<date-time>
error_message
string
export_data

Preuve JSON analysée pour le format json ; texte pour CSV, CEF et LEEF. Présent uniquement lorsque complet.