has_ipv4()
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Retourne une valeur indiquant si une adresse IPv4 spécifiée apparaît dans un texte.
Les entrées d’adresse IP dans un texte doivent être correctement délimitées par des caractères non alphanumériques. Par exemple, les adresses IP correctement délimitées sont les suivantes :
- « Ces demandes proviennent de : 192.168.1.1, 10.1.1.115 et 10.1.1.201 »
- « 05:04:54 127.0.0.1 GET /favicon.ico 404 »
Syntaxe
has_ipv4(ip_address source , )
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| source | string |
✔️ | Texte à rechercher. |
| ip_address | string |
✔️ | Valeur contenant l’adresse IP pour laquelle effectuer une recherche. |
Retours
true si le ip_address est une adresse IPv4 valide et qu’elle a été trouvée dans la source. Sinon, la fonction retourne false.
Conseil
- Pour rechercher de nombreuses adresses IPv4 à la fois, utilisez has_any_ipv4().
- Pour rechercher le préfixe d’adresses IPv4, utilisez la fonction has_ipv4_prefix().
Exemples
Adresse IP correctement mise en forme
print result=has_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1')
Sortie
| result |
|---|
| true |
Adresse IP non valide
print result=has_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', '127.0.0.256')
Sortie
| result |
|---|
| false |
Adresse IP incorrectement délimitée
print result=has_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1')
Sortie
| result |
|---|
| false |