Champs de filtre de requête compatibles

Consultez la section Filtres de requête pour en savoir plus sur la syntaxe des filtres, ainsi que les exemples de filtres ci-dessous.

Champs acceptés par alerts.list

Filtrer les champs
alertId

Doit être utilisé pour filtrer les alertes en fonction de leur ID.

La valeur correspondante doit être de type: string.

type

Doit être utilisé pour filtrer les alertes en fonction de leur type.

La valeur correspondante doit être de type: string. Les valeurs possibles pour ce filtre sont répertoriées dans la description du champ Alert.type.

source

À utiliser pour filtrer les alertes en fonction de leur source.

La valeur correspondante doit être de type: string. Les valeurs possibles pour ce filtre sont répertoriées dans la description du champ Alert.type.

createTime

Permet de filtrer les alertes en fonction de leur date de création.

La valeur correspondante doit être de type string (Timestamp format). Plus précisément, une chaîne date/heure RFC 3339, par exemple "2018-01-01T00:00:00Z".

startTime

Doit être utilisé pour filtrer les alertes en fonction de leur heure de début.

La valeur correspondante doit être de type string (Timestamp format). Plus précisément, une chaîne date/heure RFC 3339, par exemple "2018-01-01T00:00:00Z".

endTime

Doit être utilisé pour filtrer les alertes en fonction de leur heure de fin.

La valeur correspondante doit être de type string (Timestamp format). Plus précisément, une chaîne date/heure RFC 3339, par exemple "2018-01-01T00:00:00Z".

Lister des exemples de requêtes

  • Pour interroger toutes les alertes créées à partir du 5 avril 2018:
    createTime >= "2018-04-05T00:00:00Z"
  • Pour rechercher toutes les alertes de la source "hameçonnage dans Gmail":
    source:"Gmail phishing"
  • Pour rechercher toutes les alertes qui ont commencé en 2017:
    startTime >= "2017-01-01T00:00:00Z&" AND startTime < "2018-01-01T00:00:00Z"
  • Pour rechercher toutes les alertes d'hameçonnage signalées par les utilisateurs à partir de la source "hameçonnage dans Gmail":
    type:"User reported phishing" source:"Gmail phishing"

Champs acceptés par alerts.feedback.list

Filtrer les champs
alertId

À utiliser pour filtrer les commentaires sur les alertes en fonction de leur ID.

La valeur correspondante doit être de type: string. Permet de répertorier les commentaires concernant les alertes sélectionnées dans un appel lorsque le caractère générique "-" est utilisé dans le paramètre alertId de la requête.

feedbackId

À utiliser pour filtrer les commentaires sur les alertes en fonction de leur ID.

La valeur correspondante doit être de type: string.

Exemples de requêtes de liste de commentaires

  • Pour interroger les commentaires sur les alertes associées aux ID alertId01 ou alertId02:
    alertId = alertId01 OR alertId = alertId02
  • Pour interroger les commentaires d'une alerte alertId01 ayant l'ID feedbackId01:
    alertId = alertId01 AND feedbackId = feedbackId01