Compartilhar via


has_any_ipv4()

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Retorna um valor indicando se um dos endereços IPv4 especificados 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"

Dicas de desempenho

Observação

Quando mais de 128 termos de pesquisa são usados, a otimização de pesquisa de índice de texto é desabilitada, o que pode levar à redução do desempenho da consulta.

Sintaxe

has_any_ipv4( fonte, ip_address [,ip_address_2, ...])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
origem string ✔️ O valor a pesquisar.
ip_address string ou dinâmico ✔️ Um endereço IP ou uma matriz de endereços IP para pesquisar.

Devoluções

true se um dos endereços IP especificados for um endereço IPv4 válido e tiver sido encontrado na origem. Caso contrário, a função retorna false.

Exemplos

O exemplo a seguir demonstra o uso has_any_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_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '127.0.0.2')
resultado
verdadeiro

O exemplo a seguir demonstra o uso has_any_ipv4 com uma matriz dinâmica de endereços IP. Os endereços IP no texto são delimitados corretamente por caracteres não alfanuméricos.

print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', dynamic(['127.0.0.1', '127.0.0.2']))
resultado
verdadeiro

O exemplo a seguir demonstra o uso has_any_ipv4 com um endereço IPv4 inválido. Os endereços IP no texto são delimitados corretamente por caracteres não alfanuméricos.

print result=has_any_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', dynamic(["127.0.0.256", "192.168.1.1"]))
resultado
falso

O exemplo a seguir demonstra o uso has_any_ipv4 com um endereço IP delimitado incorretamente. Os endereços IP no texto não são delimitados corretamente por caracteres não alfanuméricos.

print result=has_any_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '192.168.1.1') // false, improperly delimited IP address
resultado
falso