Compartilhar via


has_ipv4()

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft 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
origem 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

Exemplos

O exemplo a seguir demonstra o uso has_ipv4 com vários valores escalares, em que cada endereço IP é fornecido como um argumento de cadeia de caracteres separado. Os endereços IP no texto são delimitados corretamente por caracteres não alfanuméricos.

print result=has_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1')

Saída

resultado
verdadeiro

O exemplo a seguir demonstra o uso has_ipv4 com um endereço IP inválido. O endereço IP no texto é delimitado corretamente por caracteres não alfanuméricos.

print result=has_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', '127.0.0.256')

Saída

resultado
falso

O exemplo a seguir demonstra o uso has_ipv4 com um endereço IP delimitado incorretamente. O endereço IP no texto é delimitado incorretamente por caracteres não alfanuméricos.

print result=has_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1')

Saída

resultado
falso