これはクラスタに対して任意の時点で行うことができますが、一般的に、ノードを新規のクラスタとする際の、最後のステップとなります。パラメータが受理されると、応答には新しいベースURIが示されます。クライアントは、この応答に基づいた、クラスタの情報のための新しいリクエストを送信することになるでしょう。
たとえば、curlを使用します:
shell> curl -u admin:password -d username=Administrator \ -d password=letmein \ -d port=8091 \ http://localhost:8091/settings/web
生のHTTPリクエスト:
POST /settings/web HTTP/1.1 Host: localhost:8091 Content-Type: application/x-www-form-urlencoded; charset=UTF-8 Authorization: Basic YWRtaW46YWRtaW4= Content-Length: xx username=Administrator&password=letmein&port=8091
対応するHTTPレスポンスのデータ:
HTTP/1.1 200 OK Content-Type: application/json Server: Couchbase Server 2.0 Pragma: no-cache Date: Mon, 09 Aug 2010 18:50:00 GMT Content-Type: application/json Content-Length: 39 Cache-Control: no-cache no-store max-age=0 {"newBaseUri":"http://localhost:8091/"}
変更する必要がない場合でも、ユーザ名/パスワードを更新するときは、ポート番号を指定しなければならないことに注意してください。