IP 地址字段类型 #

IP 字段类型用于存储 IPv4 或 IPv6 格式的 IP 地址。

要表示 IP 地址范围，可以使用 IP 范围字段类型

参考代码 #

创建一个有 IP 地址的 mapping

PUT testindex
{
  "mappings" : {
    "properties" :  {
      "ip_address" : {
        "type" : "ip"
      }
    }
  }
}

索引一个有 IP 地址的文档

PUT testindex/_doc/1
{
  "ip_address" : "10.24.34.0"
}

查询一个特定 IP 地址的索引

GET testindex/_doc/1
{
  "query": {
    "term": {
      "ip_address": "10.24.34.0"
    }
  }
}

搜索 IP 地址及其关联的网络掩码 #

您可以使用无类别域间路由 (CIDR) 表示法查询索引中的 IP 地址。在 CIDR 表示法中，通过斜杠 / 分隔 IP 地址和前缀长度（0–32）。例如，前缀长度为 24 表示匹配所有具有相同前 24 位的 IP 地址。

查询 IPV4 格式的参考代码 #

GET testindex/_search
{
  "query": {
    "term": {
      "ip_address": "10.24.34.0/24"
    }
  }
}

查询 IPV6 格式的参考代码 #

GET testindex/_search
{
  "query": {
    "term": {
      "ip_address": "2001:DB8::/24"
    }
  }
}

如果在 query_string 查询中使用 IPv6 格式的 IP 地址，需要对 : 字符进行转义，因为它们会被解析为特殊字符。可以通过将 IP 地址用引号括起来，并使用 \ 转义引号来实现。

GET testindex/_search
{
  "query" : {
    "query_string": {
      "query": "ip_address:\"2001:DB8::/24\""
    }
  }
}

参数说明 #

下面是 IP 字段的参数说明，都是可选参数 参数说明：