Partilhar via


tem_algum_prefixo_ipv4()

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

Retorna um valor booleano que indica se um dos prefixos de endereço 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_prefix( fonte,ip_address_prefix [,ip_address_prefix_2, ...] )

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
fonte string ✔️ O valor a pesquisar.
ip_address_prefix string ou dinâmico ✔️ Um prefixo de endereço IP, ou uma matriz de prefixos de endereço IP, para o qual pesquisar. Um prefixo de endereço IP válido é um endereço IPv4 completo, como 192.168.1.11, ou seu prefixo terminado com um ponto, como 192., 192.168. ou 192.168.1..

Devoluções

true se um dos prefixos de endereço IP especificados for um prefixo de 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_prefix 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_prefix('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.', '192.168.') // true

Resultado
verdadeiro

O exemplo a seguir demonstra o uso has_any_ipv4_prefix 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_prefix('05:04:54 127.0.0.1 GET /favicon.ico 404', dynamic(["127.0.", "192.168."]))
Resultado
verdadeiro

O exemplo a seguir demonstra o uso has_any_ipv4_prefix 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_prefix('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0')
Resultado
falso

O exemplo a seguir demonstra o uso has_any_ipv4_prefix 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_prefix('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.', '192.')
Resultado
falso