› › ›

只读 URL 存储库

只读 URL 存储库编辑

仅当您在自己的硬件上运行 Elasticsearch 时，此存储库类型才可用。如果您使用 Elasticsearch Service，请参阅Elasticsearch Service 存储库类型。

您可以使用 URL 存储库为集群提供对共享文件系统的只读访问权限。由于 URL 存储库始终是只读的，因此它们是注册只读共享文件系统存储库的一种更安全、更方便的替代方案。

使用 Kibana 或创建快照存储库 API来注册 URL 存储库。

PUT _snapshot/my_read_only_url_repository
{
  "type": "url",
  "settings": {
    "url": "file:/mount/backups/my_fs_backup_location"
  }
}

chunk_size

（可选，字节值）快照中文件的最大大小。在快照中，大于此值的文件将被分解为此大小或更小的块。默认为null（文件大小不受限制）。

http_max_retries

（可选，整数）http 和https URL 的最大重试次数。默认为5。

http_socket_timeout

（可选，时间值）通过连接进行数据传输的最长等待时间。默认为50 秒。

compress

（可选，布尔值）如果为true，则元数据文件（如索引映射和设置）将在快照中压缩。数据文件不会被压缩。默认为true。

max_number_of_snapshots

（可选，整数）存储库可以包含的最大快照数。默认为Integer.MAX_VALUE，即2^31-1 或2147483647。

max_restore_bytes_per_sec

（可选，字节值）每个节点的最大快照恢复速率。默认为无限制。请注意，恢复也会通过恢复设置进行限制。

max_snapshot_bytes_per_sec

（可选，字节值）每个节点的最大快照创建速率。默认为每秒40MB。请注意，如果设置了托管服务的恢复设置，则默认为无限制，并且速率还会通过恢复设置进行限制。

url

（必填，字符串）共享文件系统存储库根目录的 URL 位置。支持以下协议

必须使用repositories.url.allowed_urls集群设置明确允许使用http、https 或ftp 协议的 URL。此设置支持在 URL 中的主机、路径、查询或片段位置使用通配符。

使用file 协议的 URL 必须指向集群中所有主节点和数据节点都可以访问的共享文件系统的位置。此位置必须在path.repo 设置中注册。您无需在path.repo 设置中注册使用ftp、http、https 或jar 协议的 URL。