[couchdb-documentation] branch master updated: Document /_up endpoint

[wo...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

wohali pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git


The following commit(s) were added to refs/heads/master by this push:
     new 07f02a8  Document /_up endpoint
07f02a8 is described below

commit 07f02a813550412e8e4361bce9182f4b51a8ceb1
Author: Joan Touzet <jo...@atypical.net>
AuthorDate: Sat Mar 17 01:04:23 2018 -0400

    Document /_up endpoint
---
 src/api/server/common.rst | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/src/api/server/common.rst b/src/api/server/common.rst
index 163736a..71da705 100644
--- a/src/api/server/common.rst
+++ b/src/api/server/common.rst
@@ -1407,6 +1407,40 @@ is as follows:
     :>header Last-Modified: Static files modification timestamp
     :code 200: Request completed successfully
 
+.. _api/server/up:
+
+========
+``/_up``
+========
+
+.. versionadded:: 2.0
+
+.. http:get:: /_up
+    :synopsis: Health check endpoint
+
+    Confirms that the server is up, running, and ready to respond to requests.
+    If :config:option:`maintenance_mode <couchdb/maintenance_mode>` is
+    ``true`` or ``nolb``, the endpoint will return a 404 response.
+
+    :>header Content-Type: :mimetype:`application/json`
+    :code 200: Request completed successfully
+    :code 404: The server is unavaialble for requests at this time.
+
+    **Response**:
+
+    .. code-block:: http
+
+        HTTP/1.1 200 OK
+        Cache-Control: must-revalidate
+        Content-Length: 16
+        Content-Type: application/json
+        Date: Sat, 17 Mar 2018 04:46:26 GMT
+        Server: CouchDB/2.2.0-f999071ec (Erlang OTP/19)
+        X-Couch-Request-ID: c57a3b2787
+        X-CouchDB-Body-Time: 0
+
+        {"status":"ok"}
+
 .. _api/server/uuids:
 
 ===========

-- 
To stop receiving notification emails like this one, please contact
wohali@apache.org.