Compartir a través de


ipv4_is_in_range()

Se aplica a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Comprueba si la dirección de la cadena IPv4 está en el intervalo de notación de prefijos IPv4.

Sintaxis

ipv4_is_in_range(Ipv4Address,Ipv4Range)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
Ipv4Address string ✔️ Expresión que representa una dirección IPv4.
Ipv4Range string ✔️ Un intervalo IPv4 o una lista de intervalos IPv4 escritos con notación de prefijo IP.

Notación de prefijo IP

La notación de prefijo IP (también conocida como notación CIDR) es una manera concisa de representar una dirección IP y su máscara de red asociada. El formato es <base IP>/<prefix length>, donde la longitud del prefijo es el número de 1 bits iniciales en la máscara de red. La longitud del prefijo determina el intervalo de direcciones IP que pertenecen a la red.

Para IPv4, la longitud del prefijo es un número comprendido entre 0 y 32. Por lo tanto, la notación 192.168.2.0/24 representa la dirección IP 192.168.2.0 con una máscara de red de 255.255.255.0. Esta máscara de red tiene 24 bits iniciales o una longitud de prefijo de 24.

Para IPv6, la longitud del prefijo es un número comprendido entre 0 y 128. Por lo tanto, la notación fe80::85d:e82c:9446:7994/120 representa la dirección IP fe80::85d:e82c:9446:7994 con una máscara de red de ffff:ffff:ffff:ffff:ffff:ffff:ff00. Esta máscara de red tiene 120 bits iniciales o una longitud de prefijo de 120.

Devoluciones

  • true: si la representación larga del primer argumento de cadena IPv4 está en el intervalo del segundo argumento de cadena IPv4.
  • false:De otra manera.
  • null: si la conversión de una de las dos cadenas IPv4 no se realizó correctamente.

Ejemplo

datatable(ip_address:string, ip_range:string)
[
 '192.168.1.1',    '192.168.1.1',       // Equal IPs
 '192.168.1.1',    '192.168.1.255/24',  // 24 bit IP-prefix is used for comparison
]
| extend result = ipv4_is_in_range(ip_address, ip_range)

Salida

ip_address ip_range resultado
192.168.1.1 192.168.1.1 true
192.168.1.1 192.168.1.255/24 true