ipv4_is_in_range()

  • Artykuł

Sprawdza, czy adres ciągu IPv4 znajduje się w zakresie notacji prefiksu IPv4.

Składnia

ipv4_is_in_range(Ipv4Address,Ipv4Range)

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
Ipv4Address string ✔️ Wyrażenie reprezentujące adres IPv4.
Ipv4Range string ✔️ Zakres IPv4 lub lista zakresów IPv4 napisanych przy użyciu notacji prefiksu IP.

Notacja prefiksu IP

Notacja prefiksu IP (znana również jako notacja CIDR) to zwięzły sposób reprezentowania adresu IP i skojarzonej maski sieciowej. Format to <base IP>/<prefix length>, gdzie długość prefiksu to liczba wiodących 1 bitów maski sieci. Długość prefiksu określa zakres adresów IP należących do sieci.

W przypadku protokołu IPv4 długość prefiksu jest liczbą z zakresu od 0 do 32. W związku z tym notacja 192.168.2.0/24 reprezentuje adres IP 192.168.2.0 z maską sieci 255.255.255.255.0. Ta maska sieci ma 24 wiodące 1 bity lub długość prefiksu 24.

W przypadku protokołu IPv6 długość prefiksu jest liczbą z zakresu od 0 do 128. Tak więc notacja fe80::85d:e82c:9446:7994/120 reprezentuje adres IP fe80::85d:e82c:9446:7994 z maską sieci ffff:ff00. Ta maska sieci ma 120 wiodących 1 bitów lub długość prefiksu 120.

Zwraca

  • true: Jeśli długa reprezentacja pierwszego argumentu ciągu IPv4 jest w zakresie drugiego argumentu ciągu IPv4.
  • false:Inaczej.
  • null: Jeśli konwersja dla jednego z dwóch ciągów IPv4 nie powiodła się.

Przykład

Uruchamianie zapytania

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)

Dane wyjściowe

Adres_ip ip_range result
192.168.1.1 192.168.1.1 true
192.168.1.1 192.168.1.255/24 true

Zawartość pokrewna