通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ipv4_is_private()

  • 项目

适用于：✅Microsoft Fabric✅Azure 数据资源管理器Azure Monitor✅Microsoft✅ Sentinel

检查 IPv4 字符串地址是否属于一组专用网络 IP。

专用网络地址最初是为帮助延迟 IPv4 地址的耗尽而定义的。 源自或寻址到某个专用 IP 地址的 IP 数据包无法通过公共 Internet 进行路由。

专用 IPv4 地址

Internet 工程任务组 (IETF) 已指示 Internet 号码分配机构 (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)

详细了解语法约定。

参数

客户 类型​​ 必需 说明
ip string ✔️ 一个表示 IPv4 地址的表达式。 可以使用 IP 前缀表示法对 IPv4 字符串进行掩码操作。

IP 前缀表示法

IP 前缀表示法（也称 CIDR 表示法）是表示 IP 地址及其关联网络掩码的简明方式。 格式为 <base IP>/<prefix length>，其中，前缀长度是网络掩码中前导 1 位的数目。 前缀长度决定了属于该网络的 IP 地址范围。

对于 IPv4，前缀长度是介于 0 和 32 之间的数字。 因此，表示法 192.168.2.0/24 表示 IP 地址 192.168.2.0，且网络掩码为 255.255.255.0。 此网络掩码具有 24 个前导 1 位，或者说前缀长度为 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 个前导 1 位，或者说前缀长度为 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 result
10.1.2.3 是
192.168.1.1/24 是
127.0.0.1 false

相关内容