[COUCHDB-3326] Implement clustered purge API: _purge

• Type: New Feature
• Status: Closed
• Priority: Major
• Resolution: Won't Fix
• Component/s: Database Core, Documentation, HTTP Interface
• Assignee: Unassigned
• Reporter: Mayya Sharipova
• Created: 15/Mar/17 17:43
• Updated: 21/Nov/18 17:14
• Resolved: 02/Sep/18 07:06

Description

This implements the clustered purge API:

curl -H 'Content-Type: application/json' -X POST "http://adm:pass@127.0.0.1:5984/test1/_purge" -d '{"d1":["3-410e46c04b51b4c3304ed232790a49da", "3-420e46c04b51b4c3304ed232790a35db"],"d2":["2-a39d6d63f29a956ae39930f84dd71ec3"], "d3":["1-bdca7a3ac9503bf6e46d7d7a782e8f03"]}'

Response: status_code 201 or 202

{
  "purged": [
    {
      "ok": true,             //Quorum was reached, at least W nodes successfully purged doc
      "id": "d1",
      "revs": [
        "3-410e46c04b51b4c3304ed232790a49da",
	 "3-420e46c04b51b4c3304ed232790a35db"
      ]
    },
    {
      "accepted": true,      //Quorum was NOT reached, but request was accepted
      "id": "d2",   
      "revs": [
        "2-a39d6d63f29a956ae39930f84dd71ec3"
      ]
    },
    {
      "ok": true,   
      "id": "d3",
      "revs": []            //(DocId or Revs missing) OR (Revs are not leaf revisions) 
    }  ],
  "purge_seq": "6-g1AAAABMeJzLYWBgYMpgTmHgz8tPSTV2MDQy1zMAQsMckEQiQ5L8____sxKZ4UoMcSrJAgC9PRRl"
}