共用方式為


has_any_ipv4()

適用於:✅Microsoft網狀架構Azure 數據✅總管 Azure 監視器✅Microsoft 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(source , ip_address [, ip_address_2, ...])

深入瞭解 語法慣例

參數

姓名 類型​​ 必要 描述
source string ✔️ 要搜尋的值。
ip_address 字串或動態 ✔️ 要搜尋的IP位址或IP位址數位。

傳回

true如果其中一個指定的IP位址是有效的IPv4位址,而且在來源中找到。 否則,此函式會傳回 false

範例

作為字串清單的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')
result
true

作為動態數位的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']))
result
true

無效的 IPv4 位址

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"]))
result
false

不適當取消限制的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
result
false