デフォルトでは、Couchbaseのクラスタ用の推奨されるバケットの最大数は10です。これは、クラスタがあまりにも多くのバケットによりリソースやCPUを利用しすぎないようにするための安全機構です。この制限は、REST APIを使用して構成できます。

Couchbase REST APIは、Couchbaseのクラスタで使用されるバケットのデフォルトの最大数を変更できるように変更されました。このリクエストで許可されるバケット最大値は128ですが、推奨バケット最大値は、クラスタあたり10です。以下は、使用するエンドポイントとパラメータを示しています

shell> curl -X POST -u admin:password -d maxBucketCount=6 http://ip_address:8091/internalSettings

このリクエストでは、クラスタの管理者資格情報を提供する必要があります。次のHTTPリクエストが送信されます：

About to connect() to 127.0.0.1 port 8091 (#0)
Trying 127.0.0.1...
connected
Connected to 127.0.0.1 (127.0.0.1) port 8091 (#0)
Server auth using Basic with user 'Administrator'
POST /internalSettings HTTP/1.1

Couchbase Serverが正常にクラスタ用のバケット最大値を変更する場合は、HTTP 200 レスポンスを取得します：

HTTP/1.1 200 OK
Server: Couchbase Server 2.0.0r_501_gb614829
Pragma: no-cache
Date: Wed, 31 Oct 2012 21:21:48 GMT
Content-Type: application/json
Content-Length: 2
Cache-Control: no-cache

0、負の数など無効な数、または128バケット以上数を提供している場合は、このエラーメッセージが表示されます。

["Unexpected server error, request logged."]