Partilhar via


tem_algum_ipv4()

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Retorna um valor que indica 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, endereços IP delimitados corretamente são:

  • "Estes pedidos provieram de: 192.168.1.1, 10.1.1.115 e 10.1.1.201"
  • "05:04:54 127.0.0.1 OBTER /favicon.ico 404"

Sugestões de desempenho

Observação

Quando mais de 128 termos de pesquisa são usados, a otimização da pesquisa de índice de texto é desativada, o que pode levar a um desempenho de consulta reduzido.

Sintaxe

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

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
fonte string ✔️ O valor a pesquisar.
ip_address string ou dinâmico ✔️ Um endereço IP, ou uma matriz de endereços IP, para o qual 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, onde cada endereço IP é fornecido como um argumento de cadeia de caracteres separado. Os endereços IP no texto são devidamente delimitados 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 devidamente delimitados 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 devidamente delimitados 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 devidamente delimitados 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