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

has_any_ipv4()

适用于:✅Azure 数据资源管理器Azure Monitor✅ Sentinel

返回一个值,该值指示指定的 IPv4 地址之一是否显示在文本中。

文本中的 IP 地址入口必须以非字母数字字符正确分隔。 例如,正确分隔的 IP 地址是:

  • “这些请求来自:192.168.1.1、10.1.1.115 和 10.1.1.201”
  • “05:04:54 127.0.0.1 GET /favicon.ico 404”

性能提示

注释

使用超过 128 个搜索词时,将禁用文本索引查找优化,这可能会导致查询性能降低。

语法

has_any_ipv4( ,ip_address [,ip_address_2, ...] )

详细了解语法约定

参数

客户 类型​​ 必需 说明
string ✔️ 要搜索的值。
ip_address 字符串或动态 ✔️ 要搜索的 IP 地址或 IP 地址数组。

返回

如果其中一个指定的 IP 地址是有效的 IPv4 地址,并且已在 source 中找到,则返回 true。 否则,该函数返回 false

示例

以下示例演示如何结合使用 has_any_ipv4 多个标量值,其中每个 IP 地址都作为单独的字符串参数提供。 文本中的 IP 地址由非字母数字字符正确分隔。

print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '127.0.0.2')
结果

以下示例演示如何将 IP 地址动态数组一 has_any_ipv4 起使用。 文本中的 IP 地址由非字母数字字符正确分隔。

print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', dynamic(['127.0.0.1', '127.0.0.2']))
结果

以下示例演示如何将 IPv4 地址与无效的 IPv4 地址一 has_any_ipv4 起使用。 文本中的 IP 地址由非字母数字字符正确分隔。

print result=has_any_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', dynamic(["127.0.0.256", "192.168.1.1"]))
结果

以下示例演示了如何与 has_any_ipv4 未正确分隔的 IP 地址一起使用。 文本中的 IP 地址未正确用非字母数字字符分隔。

print result=has_any_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '192.168.1.1') // false, improperly delimited IP address
结果