› › ›

创建或更新 IP 地理位置数据库配置 API

创建或更新 IP 地理位置数据库配置。

下面显示的 Maxmind account_id 需要许可证密钥。由于许可证密钥是敏感信息，它以安全设置的形式存储在 Elasticsearch 中，名为 ingest.geoip.downloader.maxmind.license_key。每个 Elasticsearch 集群目前只允许使用一个 Maxmind 许可证密钥。要从 Maxmind 下载，必须在安全设置中包含有效的许可证密钥。许可证密钥设置只有在所有节点重启或执行 reload_secure_settings 请求后才会生效。

PUT _ingest/ip_location/database/my-database-1
{
  "name": "GeoIP2-Domain",
  "maxmind": {
    "account_id": "1234567"
  }
}

下面显示的 IPinfo 配置需要令牌。由于令牌是敏感信息，它以安全设置的形式存储在 Elasticsearch 中，名为 ingest.ip_location.downloader.ipinfo.token。每个 Elasticsearch 集群目前只允许使用一个 IPinfo 令牌。要从 IPinfo 下载，必须在安全设置中包含有效的令牌。令牌设置只有在所有节点重启或执行 reload_secure_settings 请求后才会生效。

PUT _ingest/ip_location/database/my-database-2
{
  "name": "standard_location",
  "ipinfo": {
  }
}

请求

编辑

PUT /_ingest/ip_location/database/<database>

前提条件

编辑

如果启用了 Elasticsearch 安全功能，您必须拥有 manage 集群权限才能使用此 API。

路径参数

编辑

<database>: __(必需，字符串) 要创建或更新的数据库配置的 ID。

查询参数

编辑

master_timeout: (可选，时间单位) 等待主节点的时间。如果在超时到期之前主节点不可用，则请求失败并返回错误。默认为 30s。也可以设置为 -1 表示请求永远不应超时。
timeout: (可选，时间单位) 在更新集群元数据后，等待集群中所有相关节点响应的时间。如果在超时到期之前没有收到响应，则集群元数据更新仍然适用，但响应将表明它没有被完全确认。默认为 30s。也可以设置为 -1 表示请求永远不应超时。

请求正文

编辑

name

(必需，字符串) 要下载的 IP 地理位置数据库的提供商分配的名称。

<provider>

(必需，提供商对象及其关联的配置) 标识要用于下载数据库的 IP 地理位置提供商所必需的配置，以及下载所需任何提供商特定的配置。

目前，仅支持的提供商是 maxmind 和 ipinfo。maxmind 提供商需要配置 account_id (字符串)。ipinfo 提供商在请求正文中不需要其他配置。

许可

编辑

从第三方提供商下载数据库是一项商业功能，需要适当的许可证。有关更多信息，请参阅 https://elastic.ac.cn/subscriptions。

« GeoIP 统计 API 获取 IP 地理位置数据库配置 API »