has_ipv4()
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Retorna um valor indicando se um endereço IPv4 especificado aparece em um texto.
As entradas de endereço IP em um texto devem ser delimitadas corretamente com caracteres não alfanuméricos. Por exemplo, os endereços IP delimitados corretamente são:
- "Essas solicitações vieram de: 192.168.1.1, 10.1.1.115 e 10.1.1.201"
- "05:04:54 127.0.0.1 GET /favicon.ico 404"
Sintaxe
has_ipv4(
fonte ,
ip_address )
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Digitar | Obrigatória | Descrição |
---|---|---|---|
source | string |
✔️ | O texto a ser pesquisado. |
ip_address | string |
✔️ | O valor que contém o endereço IP para o qual pesquisar. |
Devoluções
true
se o ip_address for um endereço IPv4 válido e tiver sido encontrado na origem. Caso contrário, a função retorna false
.
Dica
- Para pesquisar muitos endereços IPv4 de uma só vez, use a função has_any_ipv4( ).
- Para pesquisar o prefixo de endereços IPv4, use a função has_ipv4_prefix().
Exemplos
Endereço IP formatado corretamente
print result=has_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1')
Saída
result |
---|
true |
Endereço IP inválido
print result=has_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', '127.0.0.256')
Saída
result |
---|
false |
IP delimitado incorretamente
print result=has_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1')
Saída
result |
---|
false |