Поделиться через


ipv6_is_in_any_range()

Область применения: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Проверяет, находится ли адрес строки IPv6 в любом из указанных диапазонов адресов IPv6.

Советы по производительности

Примечание.

Если используются более 128 терминов поиска, оптимизация поиска текстовых индексов отключена, что может привести к снижению производительности запросов.

Синтаксис

ipv6_is_in_any_range(Ipv6Address , Ipv6Range [ , Ipv6Range ...])

ipv6_is_in_any_range(Ipv6Address , Ipv6Ranges )

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
Ipv6Address string ✔️ Выражение, представляющее IPv6-адрес.
Ipv6Range string ✔️ Выражение, представляющее диапазон IPv6 с использованием нотации IP-префикса.
Ipv6Ranges dynamic ✔️ Массив, содержащий диапазоны IPv6 с использованием нотации IP-префикса.

Примечание.

Требуется либо одна или несколько строк IPv6Range , либо динамический массив IPv6Ranges .

Нотация IP-префикса

Нотация IP-префикса (также известная как нотация CIDR) — это краткий способ представления IP-адреса и связанной с ней сетевой маски. Формат: <base IP>/<prefix length>длина префикса — это число ведущих 1 битов в netmask. Длина префикса определяет диапазон IP-адресов, принадлежащих сети.

Для IPv4 длина префикса составляет от 0 до 32. Поэтому нотация 192.168.2.0/24 представляет IP-адрес 192.168.2.0 с netmask 255.255.255.0. Эта netmask имеет 24 ведущих 1 бита или длину префикса 24.

Для IPv6 длина префикса составляет от 0 до 128. Поэтому нотация fe80::85d:e82c:9446:7994/120 представляет IP-адрес fe80::85d:e85d:9446:7994 с netmask ffff:ffff:ffff. Эта netmask имеет 120 ведущих 1 битов или длину префикса 120.

Возвраты

  • true: если IPv6-адрес находится в диапазоне любой из указанных сетей IPv6.
  • false:Иначе.
  • null: если преобразование для одной из двух строк IPv6 не выполнено.

Пример

let LocalNetworks=dynamic([
    "a5e:f127:8a9d:146d:e102:b5d3:c755:f6cd/112",
    "0:0:0:0:0:ffff:c0a8:ac/60"
]);
let IPs=datatable(IP:string) [
    "a5e:f127:8a9d:146d:e102:b5d3:c755:abcd",
    "a5e:f127:8a9d:146d:e102:b5d3:c755:abce",
    "a5e:f127:8a9d:146d:e102:b5d3:c755:abcf",
    "a5e:f127:8a9d:146d:e102:b5d3:c756:abd1",
];
IPs
| extend IsLocal=ipv6_is_in_any_range(IP, LocalNetworks)

Выходные данные

IP-адрес IsLocal
a5e:f127:8a9d:146d:e102:b5d3:c755:abcd Истина
a5e:f127:8a9d:146d:e102:b5d3:c755:abce Истина
a5e:f127:8a9d:146d:e102:b5d3:c755:abcf Истина
a5e:f127:8a9d:146d:e102:b5d3:c756:abd1 False