Delete API

Delete API #

按 ID 删除单条文档。

请求格式 #

DELETE /<index>/_doc/<_id>

路径参数 #

参数	必需	说明
`<index>`	是	目标索引
`<_id>`	是	文档 ID

查询参数 #

参数	类型	默认值	说明
`routing`	string	—	自定义路由值
`timeout`	time	`1m`	等待主分片可用的超时
`refresh`	string	`false`	删除后刷新策略
`version`	long	—	期望版本号
`version_type`	string	`internal`	版本类型
`if_seq_no`	long	—	乐观并发控制
`if_primary_term`	long	—	乐观并发控制
`wait_for_active_shards`	string	—	活跃分片数量

示例 #

DELETE /website/_doc/123

响应：

{
  "_index":   "website",
  "_type":    "_doc",
  "_id":      "123",
  "_version": 2,
  "result":   "deleted"
}

删除后 _version 递增。即使文档被删除后重新写入同一 _id，_version 仍会继续递增。

参考导航 #

需求	参见
按查询批量删除	Delete by Query
写入文档	Index API
乐观并发控制	并发控制与版本