跳到主要内容

删除快照仓库 API

注销一个或多个快照仓库。

DELETE /_snapshot/<repository>

前置条件​

  • 如果启用了 Elasticsearch 安全功能,你必须具有 manage 集群权限才能使用此 API。

描述​

当仓库被注销时,Elasticsearch 只会移除对仓库存储快照位置的引用。快照本身保持原样,不受影响。

路径参数​

<repository>

(必需,字符串)要注销的快照仓库的名称。支持通配符(*)模式。

查询参数​

master_timeout

(可选,时间单位)等待主节点的期限。如果在超时期限到期之前主节点不可用,则请求失败并返回错误。默认为 30s。也可以设置为 -1,表示请求永不超时。

timeout

(可选,时间单位)在更新集群元数据后,等待集群中所有相关节点响应的期限。如果在超时期限到期之前未收到响应,集群元数据的更新仍然生效,但响应将指示未被完全确认。默认为 30s。也可以设置为 -1,表示请求永不超时。

示例​

以下示例注销仓库 my_repository:

DELETE /_snapshot/my_repository

API 返回以下响应:

{
"acknowledged": true
}

原文链接