クラスタのノードをフェールオーバするためにこのリクエストが利用できます。ノードをフェールオーバすると、そのノードがクラスタ内でもう利用可能ではないこと、そしてもうひとつのノードにあるレプリカデータがクライアントに利用可能となることを意味します。Webコンソールを使用してノードをフェイルオーバすることも可能です。詳細については、Couchbase Server Manual, Initiating Node Failover.を参照してください。

REST-APIのエンドポイントhost:port/controller/failOverを使用する場合、管理者の資格情報と、そのノードの内部の名前であるパラメータoptNodeを与える必要があります：

> curl -v -X POST -u admin:password http://10.3.3.61:8091/controller/failOver -d otpNode=ns_2@10.3.3.63

HTTPリクエストは次のようになります。

POST /controller/failOver HTTP/1.1
Authorization: Basic

成功した場合、Couchbase Serverは、次のようにレスポンスを送信します：

HTTP/1.1 200 OK
HTTP/1.1 200 OK

クラスタ内に存在しないノードをフェールオーバしようとした場合、HTTP 404エラーとなります。クラスタ内のノードについてのoptNodeの情報を取得する詳細な方法についてはクラスタの詳細の表示を参照してください。