--- title: "Cato API en lecture seule - événements" slug: "cato-read-only-api-events" updated: 2026-07-30T02:53:02Z published: 2026-07-30T02:53:02Z canonical: "knowledge.catonetworks.com/cato-read-only-api-events" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Cato API en lecture seule - événements ## Aperçu de la requête API des événements La requête API des événements permet d'obtenir des informations résumées sur les événements générés pour un compte sans avoir à extraire d'abord les événements individuels et à effectuer l'analyse. Exemples de types d'analyse que l'API des événements inclut : - Nombre d'utilisateurs SDP qui se sont connectés sur une période spécifique - Pourcentage d'événements de blocage vs. autorisation du pare-feu - Afficher combien d'événements (cardinalité) ont été générés pour chaque type d'événement au cours des 30 derniers jours ## Arguments pour les événements Voici les arguments que vous pouvez passer à l'appel API des événements pour modifier son fonctionnement : - idCompte - mesures - filtres - dimensions - trier - période ### L'argument idCompte Ceci est l'idCompte pour le compte contre lequel vous exécutez la requête. > [!NOTE] > Remarque : > > Cet ID de compte n'est pas affiché dans l'Application de gestion Cato, il s'agit plutôt du numéro dans l'URL de l'Application de gestion Cato. Par exemple, l'ID de compte est 26 pour l'URL suivante : https://cc.catonetworks.com/#!/26/topology. ### L'argument mesures L'argument `mesures` vous permet de définir les champs que vous souhaitez que la requête `événements` examine et la manière dont les résultats doivent être agrégés. Pour chaque champ que vous souhaitez analyser, vous devez définir ce qui suit : - nomDuChamp - définit le champ que vous souhaitez agréger - typeDagg - définit la manière dont vous souhaitez que l'agrégation soit effectuée (par exemple, count_distinct) L'exemple suivant montre la syntaxe `mesures` pour une requête qui retourne la somme des champs event_count : ```plaintext  "mesures": [    {"fieldName":"event_count","aggType":"sum"} ] ``` ### L'argument filtres L'argument `filtres` vous permet de définir un filtre qui entraînera l'examen d'un sous-ensemble limité d'événements uniquement. Pour chaque filtre, vous devez définir ce qui suit : - nomDuChamp - définit le nom du champ que vous souhaitez filtrer - opérateur - définit l'opération de filtre qui doit être utilisée pour filtrer le champ - valeurs - définit la valeur de filtre utilisée avec l'opérateur Voici un exemple de l'argument filtres utilisé pour sélectionner uniquement les événements avec un event_type de **Sécurité** : ```plaintext "filtres": [    {        "fieldName": "event_type",                 "operator": "est",         "valeurs": ["Sécurité"]    } ] ``` ### L'argument dimensions Utilisez l'argument `dimensions` pour regrouper les champs ayant les mêmes valeurs en lignes de résumé. Voici un exemple qui regroupe les fichiers selon l'event_type : ```plaintext "dimensions": [    {"fieldName": "event_type"} ] ``` ### L'argument trier L'argument `trier` définit comment les données retournées doivent être triées. Voici un exemple d'utilisation de l'argument trier ```plaintext   'trier': [      {'fieldName': 'event_count', 'order': 'desc'},      {'fieldName': 'event_type', 'order': 'asc'}  ] ``` ### L'argument période Définit la `période` de la requête. Ceci est spécifié en utilisant le format défini par la spécification ISO 8601. Voici un exemple de comment vous pourriez spécifier le cadre temporel pour les 30 derniers jours : ```plaintext "timeFrame": "last.P30D"  ``` > [!NOTE] > **Note :** > > - La durée maximale pouvant être spécifiée pour l'argument période est actuellement de 89 jours. > - La spécification ISO 8601 réelle peut être obtenue [ici](https://www.iso.org/standard/70907.html), mais elle n'est pas gratuite. Vous pouvez également consulter cet [article Wikipedia](https://en.wikipedia.org/wiki/ISO_8601#Durations) pour plus d'informations afin de comprendre comment définir cet argument. ## Exemple de requête des événements ### Exemple de requête ```plaintext query événements(    $accountID: ID!,    $mesures: [EventsMeasure],    $dimensions: [EventsDimension],    $filtres: [EventsFilter!],    $trier: [EventsSort!],    $timeFrame: TimeFrame!,    $limite: Int,    $de: Int) {      événements(        accountID: $accountID        timeFrame: $timeFrame        mesures: $mesures        dimensions: $dimensions        filtres: $filtres        trier: $trier  ) {        id            de        total        enregistrements(limite: $limite, de: $de) {            fieldsMap        }    } } ``` ### Valeurs des variables ```plaintext {      "accountID": "1234",    "mesures": [ {          "fieldName": "event_sub_type",          "aggType": "count_distinct"          }    ],    "filtres": [ {          "fieldName": "event_type",          "operator": "est", "valeurs": ["Sécurité"]          }      ],      "timeFrame": "last.P1M" } ``` ### Exemple de sortie des événements ```plaintext {      "données": {        "événements": {            "id": "xxx",            "de": "2023-01-26T00:00:00Z",            "à": "2023-02-27T00:00:00Z",            "total": 1,            "enregistrements": [                        {                     "fieldsMap": {                                  "event_sub_type": "6"                        }                 }             ]        }    } } ```