Cluster API

    +
    The Cluster REST API manages cluster operations.

    APIs in this Section

    Cluster operations include managing server nodes, viewing cluster details, viewing cluster information, and managing auto-failover. Each operation can be managed by means of the REST API, and all are explained in this section. All endpoints are listed in the tables provided below.

    Cluster Initialization and Provisioning

    HTTP Method URI Documented at

    POST

    /nodes/self/controller/settings

    Initializing a Node

    POST

    /settings/web

    Establishing Credentials

    POST

    POST /node/controller/rename

    Naming a Node

    POST

    /pools/default

    Configuring Memory

    POST

    /nodes/self/controller/settings

    Assigning Services

    POST

    /pools/default

    Naming a Cluster

    Adding and Removing Nodes

    HTTP Method URI Documented at

    POST

    /controller/addNode

    Adding Nodes to Clusters

    POST

    /node/controller/doJoinCluster

    Joining Nodes to Clusters

    POST

    /controller/ejectNode

    Removing Nodes from Clusters

    Rebalance

    HTTP Method URI Documented at

    POST

    /controller/rebalance

    Rebalancing the Cluster

    GET

    /pools/default/rebalanceProgress

    Getting Rebalance Progress

    GET

    /pools/default/retryRebalance

    Configuring Rebalance Retries

    POST

    /pools/default/retryRebalance

    Configuring Rebalance Retries

    GET

    /pools/default/pendingRetryRebalance

    Getting Rebalance-Retry Status

    POST

    /controller/cancelRebalanceRetry/<rebalance-id>

    Canceling Rebalance Retries

    GET

    /settings/rebalance

    Limiting Concurrent vBucket Moves

    POST

    /settings/rebalance

    Limiting Concurrent vBucket Moves

    POST

    /internalSettings

    Disabling Consistent View Query Results on Rebalance

    Auto-Failover

    HTTP Method URI Documented at

    GET

    /settings/autoFailover

    Retrieving Auto-Failover Settings

    POST

    /settings/autoFailover

    Enabling and Disabling Auto-Failover

    POST

    /settings/autoFailover/resetCount

    Resetting Auto-Failover

    POST

    /controller/setRecoveryType

    Setting Recovery Type

    Settings and Connections

    HTTP Method URI Documented at

    GET

    /internalSettings

    Managing Internal Settings

    POST

    /internalSettings

    Managing Internal Settings

    GET

    /settings/maxParallelIndexers

    Managing Internal Settings

    POST

    /settings/maxParallelIndexers

    Managing Internal Settings

    GET

    /pools/default/settings/memcached/global

    Managing Cluster Connections

    POST

    /pools/default/settings/memcached/global

    Managing Cluster Connections

    Status and Events

    HTTP Method URI Documented at

    GET

    /pools/default/tasks

    Getting Cluster Tasks

    GET

    /logs/rebalanceReport?reportID=<report-id>

    Getting Cluster Tasks

    GET

    /pools

    Retrieving Cluster Information

    GET

    /pools/default

    Viewing Cluster Details

    GET

    /events

    Getting System Events

    GET

    /eventsStreaming

    Getting System Events

    GET

    /pools/default/terseClusterInfo

    Identifying the Orchestrator Node

    GET

    /pools/nodes

    Getting Information on Nodes

    GET

    /pools/default/nodeServices

    Listing Node Services