ipv4_is_private()
Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Sprawdza, czy adres ciągu IPv4 należy do zestawu adresów IP sieci prywatnej.
Pierwotnie zdefiniowano adresy sieci prywatnej, aby ułatwić opóźnienie wyczerpania adresów IPv4. Pakiety IP pochodzące z lub adresowane do prywatnego adresu IP nie mogą być kierowane za pośrednictwem publicznego Internetu.
Prywatne adresy IPv4
Internet Engineering Task Force (IETF) przekierował Internet Assigned Numbers Authority (IANA) do zarezerwowania następujących zakresów adresów IPv4 dla sieci prywatnych:
Zakres adresów IP | Liczba adresów | Największy blok CIDR (maska podsieci) |
---|---|---|
10.0.0.0 – 10.255.255.255 | 16777216 | 10.0.0.0/8 (255.0.0.0) |
172.16.0.0 – 172.31.255.255 | 1048576 | 172.16.0.0/12 (255.240.0.0) |
192.168.0.0 – 192.168.255.255 | 65536 | 192.168.0.0/16 (255.255.0.0) |
ipv4_is_private('192.168.1.1/24') == true
ipv4_is_private('10.1.2.3/24') == true
ipv4_is_private('202.1.2.3') == false
ipv4_is_private("127.0.0.1") == false
Składnia
ipv4_is_private(
Ip)
Dowiedz się więcej na temat konwencji składni.
Parametry
Nazwisko | Type | Wymagania | opis |
---|---|---|---|
Ip | string |
✔️ | Wyrażenie reprezentujące adres IPv4. Ciągi IPv4 można maskować przy użyciu notacji prefiksów IP. |
Notacja prefiksu IP
Notacja prefiksów 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. Notacja 192.168.2.0/24 reprezentuje adres IP 192.168.2.0 z maską sieciową 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. Notacja fe80::85d:e82c:9446:7994/120 reprezentuje adres IP fe80::85d:e82c:9446:7994 z maską netmask ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00. Ta maska sieci ma 120 wiodących 1 bitów lub długość prefiksu 120.
Zwraca
true
: Jeśli adres IPv4 należy do dowolnego z zakresów sieci prywatnej.false
:Inaczej.null
: Jeśli analizowanie danych wejściowych jako ciąg adresu IPv4 nie powiodło się.
Przykład: Sprawdzanie, czy protokół IPv4 należy do sieci prywatnej
datatable(ip_string:string)
[
'10.1.2.3',
'192.168.1.1/24',
'127.0.0.1',
]
| extend result = ipv4_is_private(ip_string)
Wyjście
ip_string | result |
---|---|
10.1.2.3 | prawda |
192.168.1.1/24 | prawda |
127.0.0.1 | fałsz |