Table of Contents
The Couchbase Management REST API provides an easy to use interface for controlling your Couchbase installation.
The Couchbase Management REST API provides the ability to manage a Couchbase Server deployment. It conforms to Representational State Transfer (REST) constraints (is a RESTful architecture). The Couchbase Management REST API is used to manage clusters, server nodes, and buckets, and to retrieve run-time statistics, within your Couchbase Server deployment.
The REST API is not used to directly manage
data in memory or on disk. The cache data management operations
(set and get, for example) are
handled by clients and the appropriate SDKs. See
Couchbase SDKs.
The REST API makes use and reference to a number of different systems within the Couchbase Server product. For more information, readSection 8.1, “Key Concepts”.
The REST API is built on a number of basic principles:
JSON Responses
The Couchbase Management REST API returns many responses in the JavaScript Object Notation (JSON). Some responses have an empty body, but indicate the response with standard HTTP codes. For more information, see RFC 4627 (http://www.ietf.org/rfc/rfc4627.txt) andwww.json.org.
HTTP Basic Access Authentication
The Couchbase Management REST API uses HTTP basic authentication. The browser-based Chapter 6, Administration Web Consoleand Chapter 7, Couchbase Command-line Interfacealso use HTTP basic authentication.
Versatile Server Nodes
All server nodes in a cluster share the same properties and can handle any requests made via the Couchbase Management REST API. It does not matter which specific server node you communicate with via the API. If the server node cannot service a request directly (due to lack of access to state or some other information), it will forward the request to the appropriate server node, retrieve the results, and send the results back to the client.