ipv4_is_private()
適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
IPv4 文字列アドレスがプライベート ネットワーク IP のセットに属しているかどうかを確認します。
プライベート ネットワーク アドレス は、もともと IPv4 アドレスの枯渇を遅らせるために定義されていました。 プライベート IP アドレスから発信またはアドレス指定された IP パケットは、パブリック インターネット経由でルーティングできません。
プライベート IPv4 アドレス
Internet Engineering Task Force (IETF) は、Internet Assigned Numbers Authority (IANA) に対して以下の IPv4 アドレス範囲をプライベート ネットワーク用に予約するように指示しています。
| IP アドレスの範囲 | アドレスの数 | 最大 CIDR ブロック (サブネット マスク) |
|---|---|---|
| 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
構文
ipv4_is_private(ip)
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| ip | string |
✔️ | IPv4 アドレスを表す式。 IPv4 文字列は、IP プレフィックス表記 を使用してマスクできます。 |
IP - プレフィックスの表記
IP プレフィックス表記 (CIDR 表記とも呼ばれます) は、IP アドレスとそれに関連付けられているネットワーク マスクを表す簡潔な方法です。 形式は <base IP>/<prefix length>で、プレフィックスの長さはネットマスク内の先頭の 1 ビットの数です。 プレフィックスの長さは、ネットワークに属する IP アドレスの範囲を決定します。
IPv4 の場合、プレフィックスの長さは 0 から 32 までの数値です。 したがって、表記 192.168.2.0/24 は、255.255.255.0 のネットマスクを持つ IP アドレス 192.168.2.0 を表します。 このネットマスクには、先頭に 1 ビットが 24 個、プレフィックスの長さが 24 個あります。
IPv6 の場合、プレフィックスの長さは 0 から 128 までの数値です。 そのため、表記 fe80::85d:e82c:9446:7994/120 は、ip アドレス fe80::85d:e82c:9446:7994 を ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00 のネットマスクで表します。 このネットマスクの先頭は 120 ビット、プレフィックス長は 120 です。
返品
true: その IPv4 アドレスがプライベート ネットワークの範囲のいずれかに属している場合。false: それ以外の場合。null: IPv4 アドレス文字列としての入力の解析がうまくいかなかった場合。
例: IPv4 がプライベート ネットワークに属しているかどうかを確認する
datatable(ip_string:string)
[
'10.1.2.3',
'192.168.1.1/24',
'127.0.0.1',
]
| extend result = ipv4_is_private(ip_string)
出力
| ip_string | 結果 |
|---|---|
| 10.1.2.3 | true |
| 192.168.1.1/24 | true |
| 127.0.0.1 | false |