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

has_ipv4_prefix()

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

返回一个值,该值指示文本中是否出现指定的 IPv4 地址前缀。

有效的 IP 地址前缀是完整的 IPv4 地址 (192.168.1.11),或者是以点结尾的地址前缀(192.192.168.192.168.1.)。

文本中的 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”

语法

has_ipv4_prefix( ,ip_address_prefix)

详细了解语法约定

参数

客户 类型​​ 必需 说明
string ✔️ 要搜索的文本。
ip_address_prefix string ✔️ 要搜索的 IP 地址前缀。

返回

true,前提是 ip_address_prefix 是有效的 IPv4 地址前缀,并且已在 source 中找到 。 否则,该函数返回 false

提示

若要一次搜索多个 IPv4 前缀,请使用 has_any_ipv4_prefix() 函数。

示例

以下示例演示如何使用 has_ipv4_prefix 函数在文本中搜索特定的 IPv4 地址前缀。

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

以下示例演示如何使用 has_ipv4_prefix 无效的 IP 地址前缀。 文本中的 IP 地址由非字母字符正确分隔。

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

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

print result=has_ipv4_prefix('05:04:54 127.0.0.256 GET /favicon.ico 404', '127.0.')
结果

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

print result=has_ipv4_prefix('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.')
结果