シリアライズ応答形式¶
Object Storage API は、デフォルトで text/plain 応答形式を使用します。さらに、JSON と XML のデータシリアライズ応答形式もサポートします。
注釈
cURL コマンド例を実行する場合、環境変数をエクスポートする必要があります。詳細は サンプル実行に必要な環境変数 を参照してください。
これらのメソッドのどれかを使用して、応答形式を定義します。
| メソッド | 説明 |
|---|---|
format= format クエリーパラメーター |
このパラメーターを GET リクエストの URL に追加します。ここで format は json か xml です。 |
Accept リクエストヘッダー |
このヘッダーを
|
例 1. format クエリーパラメーターを用いた JSON の例¶
例えば、このリクエストは format クエリーパラメーターを使用して、JSON 応答を要求します。
$ curl -i $publicURL?format=json -X GET -H "X-Auth-Token: $token"
HTTP/1.1 200 OK
Content-Length: 96
X-Account-Object-Count: 1
X-Timestamp: 1389453423.35964
X-Account-Meta-Subject: Literature
X-Account-Bytes-Used: 14
X-Account-Container-Count: 2
Content-Type: application/json; charset=utf-8
Accept-Ranges: bytes
X-Trans-Id: tx274a77a8975c4a66aeb24-0052d95365
Date: Fri, 17 Jan 2014 15:59:33 GMT
Object Storage は、コンテナー名と追加情報を JSON 形式で一覧表示します。
[
{
"count":0,
"bytes":0,
"name":"janeausten"
},
{
"count":1,
"bytes":14,
"name":"marktwain"
}
]
例 2. Accept ヘッダーを用いた XML の例¶
このリクエストは Accept リクエストヘッダーを使用して、XML 応答を要求します。
$ curl -i $publicURL -X GET -H "X-Auth-Token: $token" -H \
”Accept: application/xml; charset=utf-8"
HTTP/1.1 200 OK
Content-Length: 263
X-Account-Object-Count: 3
X-Account-Meta-Book: MobyDick
X-Timestamp: 1389453423.35964
X-Account-Bytes-Used: 47
X-Account-Container-Count: 2
Content-Type: application/xml; charset=utf-8
Accept-Ranges: bytes
X-Trans-Id: txf0b4c9727c3e491694019-0052e03420
Date: Wed, 22 Jan 2014 21:12:00 GMT
Object Storage は、コンテナー名と追加情報を XML 形式で一覧表示します。
<?xml version="1.0" encoding="UTF-8"?>
<account name="AUTH_73f0aa26640f4971864919d0eb0f0880">
<container>
<name>janeausten</name>
<count>2</count>
<bytes>33</bytes>
</container>
<container>
<name>marktwain</name>
<count>1</count>
<bytes>14</bytes>
</container>
</account>
このガイドにある残りの例は、標準的な非シリアライズ応答を使用します。しかしながら、一覧表示処理を実行する、すべての GET リクエストは、format クエリーパラメーターや Accept リクエストヘッダーを受け付けます。
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.