ipv4_is_in_range()
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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 |
Contenido relacionado
- Introducción a las funciones IPv4/IPv6
- Información general sobre las funciones de coincidencia de texto IPv4