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 a um desempenho de consulta reduzido.

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
source 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

Endereços IP como lista de strings

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

Endereços IP como matriz dinâmica

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']))
result
true

Endereço IPv4 inválido

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"]))
result
false

Endereço IP eliminado incorretamente

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
result
false