GET /admin/v1/timestamp

Summary

Verify that MarkLogic Server is up and accepting requests.

Response Headers
Content-type	The MIME type of the data in the response body. Always `text/plain`.

Response

If MarkLogic Server is available, this request returns response code 200 (OK) and the reponse body contains a plain text timestamp that can be used with the timestamp returned by asynchronous admin and manage requests to confirm that a restart ocurred and has completed.

Required Privileges

If security has not yet been installed, no authentication is required. If security has been installed, digest authentication is required, but no privilege checking is done.

Usage Notes

This request must be directed to the MarkLogic Server Admin Interface on port 8001. For example: http://localhost:8001/admin/v1/timestamp.

Management REST API that cause a restart usually return a reference to this service in the response Location header and/or the data in the response body. You can use this reference to test whether the restart has successfully completed.

To test if MarkLogic Server is up and available on a given host, you can use eiher the GET or HEAD methods of /admin/v1/timestamp. If status code 200 (OK) is returned, MarkLogic Server is available.

To test for a restart, call GET /admin/v1/timestamp prior to the operation that can cause a restart, then call it again afterwards, and compare the two timestamps.

For details and a complete example, see Using the Timestamp Service to Verify a Restart in the Scripting Administrative Tasks Guide.

Example


curl --anyauth --user user:password -X GET -i \
    http://localhost:8001/admin/v1/timestamp

==> MarkLogic Server responds with a timestamp and headers similar 
    to the following. The timestamp in the response body is the time
    of the last restart.

HTTP/1.1 200 OK
Server: MarkLogic
Content-Type: text/plain; charset=UTF-8
Content-Length: 32
Connection: Keep-Alive
Keep-Alive: timeout=5

2013-05-15T10:34:38.932514-07:00

Example


An operation causing a restart returns a response similar to the following.
Note the Location header and <uriref> to the timestamp service. Use it
to construct a GET or HEAD request to this service.

HTTP/1.1 202 Accepted
Content-type: application/xml
Location: /admin/v1/timestamp
Server: MarkLogic
Content-Length: 260
Connection: Keep-Alive
Keep-Alive: timeout=5

<restart xmlns="http://marklogic.com/manage">
  <last-startup host-id="13544732455686476949">
    2013-05-15T09:01:43.019261-07:00
  </last-startup>
  <link>
    <kindref>timestamp</kindref>
    <uriref>/admin/v1/timestamp</uriref>
  </link>
  <message>Check for new timestamp to verify host restart.</message>
</restart>