与えられたバケットから既存のデザインドキュメントを入手するには、以下の表に詳述するようにGET
リクエストを使用して、対応するバケットからデザインドキュメントにアクセスする必要があります。
メソッド | GET /bucket/_design/[デザインドキュメント] |
リクエストデータ | デザインドキュメント定義(JSON) |
レスポンスデータ | 成功したかどうかと、格納されたデザインドキュメントID |
認証情報の要否 | 任意 |
リターンコード | |
200 | リクエストは成功しました |
401 | リクエストしたアイテムが指定した認証情報では利用できないか、認証情報が指定されていません |
404 | リクエストしたアイテムは見つかりません。返却される内容は利用可能であればJSONオブジェクトでより多くの情報を含みます |
たとえば、デザインドキュメントbyfield
のバケットsales
から既存のデザインドキュメントを取得するには:
shell> curl -X GET \ -H 'Content-Type: application/json' \ 'http://user
:password
@192.168.0.77:8092/sales
/_design/dev_byfield
curlを通して、これはdev_byfield
というファイル名のファイルにデザインドキュメントをダウンロードします。
バケットにパスワードが設定されていない場合、認証情報を省略することができます。ビューが存在しない場合、エラーが表示されます。
{ "error":"not_found", "reason":"missing" }
HTTPレスポンスヘッダには、アクセスしているデザインドキュメントに関するメタデータを含むJSONドキュメントが含まれます。情報は返されるデータのX-Couchbase-Meta
ヘッダ内にあります。curlに-v
オプションを使用してこの情報を得ることができます。
例:
shell> curl -v -X GET \ -H 'Content-Type: application/json' \ 'http://user:password@192.168.0.77:8092/sales/_design/ * About to connect() to 192.168.0.77 port 8092 (#0) * Trying 192.168.0.77... % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0* connected * Connected to 192.168.0.77 (192.168.0.77) port 8092 (#0) * Server auth using Basic with user 'Administrator' > GET /sales/_design/something HTTP/1.1 > Authorization: Basic QWRtaW5pc3RyYXRvcjpUYW1zaW4= > User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8r zlib/1.2.5 > Host: 192.168.0.77:8092 > Accept: */* > Content-Type: application/json > < HTTP/1.1 200 OK < X-Couchbase-Meta: {"id":"_design/dev_sample","rev":"5-2785ea87","type":"json"} < Server: MochiWeb/1.0 (Any of you quaids got a smint?) < Date: Mon, 13 Aug 2012 10:45:46 GMT < Content-Type: application/json < Content-Length: 159 < Cache-Control: must-revalidate < { [data not shown] 100 159 100 159 0 0 41930 0 --:--:-- --:--:-- --:--:-- 53000 * Connection #0 to host 192.168.0.77 left intact * Closing connection #0
メタデータは、データドキュメントに対応するメタデータと一致します。