Search:

Search all manuals
Search this manual
Manual
Couchbase Server マニュアル 2.0
Community Wiki and Resources
Couchbase Server 2.0をダウンロード
Couchbase 開発者ガイド 2.0
クライアントライブラリ
Couchbase Server フォーラム
Additional Resources
Community Wiki
Community Forums
Couchbase SDKs
Parent Section
8.6 バケットの管理
Chapter Sections
Chapters

8.6.5. データバケットの作成と編集

クラスタ内のバケットのURIにPOSTコマンドを送信することで新しいバケットを作成することができます。これは、CouchbaseまたはMemcachedタイプのバケットを作成するために使用することができます。バケット名は、先頭にアンダースコアを設定できません。

新しいCouchbaseのバケットを作成するか、既存のバケットの既存のパラメータを編集するには、REST APIのエンドポイントへPOSTリクエストを送信します。また、この同じエンドポイントを使用して、クラスタに存在するバケットのリストを取得することもできます。

メソッドPOST /pools/default/buckets
リクエストデータ新しいバケットのペイロードパラメータのリスト
レスポンスデータバケット確認のもしくはエラー状況のJSON
認証情報の要否必要
ペイロード引数 
authType 必須パラメータ。 新しいバケットで有効にする認証のタイプで、文字列指定。 指定しなければ、デフォルトの空白のパスワードとなる。 "sasl"は認証を有効。 "none"は認証を無効。
bucketType 必須パラメータ。 作成するバケットのタイプ。 文字列値。 "memcached" はMemcachedバケットを構成。 "couchbase" はCouchbaseバケットを構成。
flushEnabled 任意のパラメータ。 指定したバケットで'flush all'の機能を有効にします。 真偽値。 1は'flush all'のサポートを有効にし、0は'flush all'のサポートを無効にします。 デフォルトは0。
name 必須パラメータ。 新しいバケットの名前。
parallelDBAndViewCompaction 任意のパラメータ。 文字列値。 ディスク上のデータベースとビューのファイルが同時にコンパクションされるかどうかを指定。 デフォルトは"false"。
proxyPort 必須パラメータ。 数値。 バケットと通信するためのプロキシのポート番号。 まだ使用されていない有効なネットワークポートであることが必要。 認証のタイプがSASLでない場合、有効なポート番号を指定する必要があります。
ramQuotaMB 必須パラメータ。 新しいバケットのRAMクォータで、単位はMB。 数値。 100が最小値で、そのノードで確立されたメモリクォータと同じ量が最大値。 他のバケットがそのノードに関連付られている場合、 その他のバケットのメモリクォータに依存し、 RAMクォータはそのノードで残っているメモリの量と同じ値まで指定可能。
replicaIndex 任意のパラメータ。 真偽値。 1はレプリカバケットデータのレプリカインデックスを有効にし、0は無効にします。 デフォルトは1。
replicaNumber 任意のパラメータ。 数値。 このバケットを構成するためのレプリカの数。 Couchbaseバケットを作成する場合は必須パラメータ。 デフォルトは1、最小値は0、最大値は3。
saslPassword 任意のパラメータ。 文字列。 SASL認証のためのパスワード。 SASL認証を有効にしている場合、必須。
リターンコード 
202受け付けられました
204不正なリクエスト。{"errors": { .... }}の形式でerrorsのあるJSON。name: すでに存在する名前のバケット、ramQuotaMB: RAM クォータが大きすぎるもしくは小さすぎる、replicaNumber: 正整数を指定する必要がある、proxyPort: ポート番号が無効、もしkはすでに使用されている
404オブジェクトが見つかりません

バケットを作成するときは、authTypeパラメータを提供しなければなりません:

ramQuotaMBパラメータは、バケットのために各ノードへどのくらいのメモリを割り当てたいかをメガバイト単位で指定します。サポートされる最小値は、100MBです。

例:

shell> curl -X POST -u admin:password -d name=newbucket -d ramQuotaMB=200 -d authType=none \
     -d replicaNumber=2 -d proxyPort=11215 http://localhost:8091/pools/default/buckets

バケットを設定するためのパラメータは、アンパサンドで区切られたキー/値のペアとして各パラメータと値でペイロード・データとして提供されます。

HTTPリクエストはPOSTリクエストのペイロードで設定されるパラメータを含める必要があります。

HTTP Request
POST /pools/default/buckets
HTTP/1.1
Host: localhost:8091
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Authorization: Basic YWRtaW46YWRtaW4=
Content-Length: xx
name=newbucket&ramQuotaMB=20&authType=none&replicaNumber=2&proxyPort=11215

バケットの作成が成功した場合、HTTPレスポンス202(Accepted)と空のコンテンツが返されます。

HTTP Response
202 Accepted

パラメータが不足していたり、間違っているために、バケットが作成できなかった場合は、エラーの理由を含むJSONペイロードを用いてHTTPレスポンス400が返されます。