オブジェクト取得 GET /v1/{account}/{container}/{object}
オブジェクトの内容とメタデータをダウンロードする
ラージオブジェクトを取り扱う場合レスポンスには結合後のオブジェクトが含まれます。静的ラージオブジェクトのマニフェストファイルそのものを取得する場合、multipart-manifestクエリパラメーターを使用してください。
オブジェクトのダウンロードに成功した場合、200ステータスコードが返却されます。オブジェクトが存在してなかった場合は404ステータスコードが返却されます。
Request Headers
X-Auth-Token
認証トークン。省略した場合、ACLによってアクセスを許可していない限り、リクエストは失敗します。詳細についてはACLをご参照ください。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Newest
Trueを設定すると、オブジェクトストレージはすべてのレプリカから最新のものを探して返却します。本ヘッダーを省略すると、オブジェクトストレージは正常なレプリカを一つ選んで返却します。本ヘッダーにTrueを指定することは非常に高コストとなります。絶対に必要な場合にだけ使用してください。
| Data Type | Cardinality |
|---|---|
| Boolean | 0..1 |
Range
取得するコンテンツのレンジ。
Rangeヘッダーを使ってレンジを指定してデータの一部を取得することができます。多数のレンジを指定する場合は、カンマ区切りで記述します。
レンジの指定方法は次のとおりです。
- Byte range：
データの何バイト目から何バイト目まで返却するかを指定します。データの終了バイトの記述を省略した場合はデータの末尾まで返却します。
- Suffix byte range
データの末尾の何バイトを返却するかを指定します。
| Data Type | Cardinality |
|---|---|
| Dict | 0..1 |
If-Match
http://www.ietf.org/rfc/rfc2616.txtをご参照ください。
| Data Type | Cardinality |
|---|---|
| Dict | 0..1 |
If-Modified-Since
http://www.ietf.org/rfc/rfc2616.txtをご参照ください。
| Data Type | Cardinality |
|---|---|
| Dict | 0..1 |
If-Unmodified-Since
http://www.ietf.org/rfc/rfc2616.txtをご参照ください。
| Data Type | Cardinality |
|---|---|
| Dict | 0..1 |
Request Parameter
{account}
プロジェクト単位でユニークに割り当てられる名前
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{container}
コンテナ名
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{object}
オブジェクト名
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
temp_url_sig
有効期限付きURL 機能において、リクエストの署名に使用する。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
temp_url_expires
有効期限付きURL 機能において、temp_url_sigの有効期限を指定する。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
multipart-manifest
オブジェクトがラージオブジェクトの場合、クエリパラメーターにはmultipart-manifest=getを指定できます。その際、オブジェクト自体は返却されません。その代わりに、動的ラージオブジェクトの場合はX-Object-Manifestレスポンスヘッダー、静的ラージオブジェクトの場合はレスポンスボディにManifestが返却されます。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Response Headers
Content-Length
オブジェクトのサイズ(バイト)
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Accept-Ranges
オブジェクトの取得で指定できるRangesのタイプ
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Last-Modified
オブジェクトが作成された日付と時間、またはメタデータが最後に変更された日付と時間
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
ETag
オブジェクトが5GBよりも小さい場合、この値はオブジェクトのMD5チェックサムになります。また、この値はクォーテーションで囲まれない値となります。
マニフェストオブジェクトの場合、マニフェストの各セグメントのETagとMD5 checksumsを連結した文字列に対して、MD5 checksum を取得した値が返却される。
実際にダウンロードしたオブジェクトのMD5チェックサムの値とETagヘッダーの値を比べることを強くお勧めします。もし違いがあった場合は、コンテンツが破損しているため、リトライ処理を行ってください。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Content-Type
レスポンスボディのMIMEタイプ。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Content-Encoding
Content-Encodingのメタデータ。
設定されていない場合は返却されません。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Content-Disposition
ブラウザの振る舞いを設定していた場合に、返却されます。
返却される値については、http://www.ietf.org/rfc/rfc2183.txtをご参照ください。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Delete-At
オブジェクトが削除される日をUNIX Epochタイムスタンプの形式で返却する。設定されていない場合は返却されません。
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
X-Object-Meta-name
オブジェクトメタデータ。{name}はメタデータ項目の名前。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Object-Manifest
動的ラージオブジェクトの設定が返却されます。この値は次のようにコンテナ名および分割オブジェクトのプレフィクス名を取ります。container/prefix
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Static-Large-Object
オブジェクトが静的ラージオブジェクトのマニフェストオブジェクトの場合、Trueが返却されます。
| Data Type | Cardinality |
|---|---|
| Bool | 0..1 |
X-Trans-Id
このリクエストに付与されるID。トラブルについて問い合わせる際に利用されます。
| Data Type | Cardinality |
|---|---|
| Uuid | 1..1 |
Date
トランザクションの実行された日付と時間
| Data Type | Cardinality |
|---|---|
| Datetime | 1..1 |
Response Elements
オブジェクトが返却される。
オブジェクトが存在する場合
Example of Request
curl -i $publicURL/marktwain/goodbye -X GET -o ./helloworld.txt -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 200 OK
Content-Length: 14
Accept-Ranges: bytes
Last-Modified: Wed, 15 Jan 2014 16:41:49 GMT
Etag: 451e372e48e0f6b1114fa0724aa79fa1
X-Timestamp: 1389804109.39027
X-Object-Meta-Orig-Filename: goodbyeworld.txt
Content-Type: application/octet-stream
X-Trans-Id: tx8145a190241f4cf6b05f5-0052d82a34
Date: Thu, 16 Jan 2014 18:51:32 GMT
Goodbye World!
オブジェクトが存在しない場合
Example of Request
curl -i $publicURL/janeausten/goodbye -X GET -o ./helloworld.txt -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 404 Not Found
Content-Length: 70
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx073f7cbb850c4c99934b9-0052d82b04
Date: Thu, 16 Jan 2014 18:55:00 GMT
<html><h1>Not Found</h1><p>The resource could not be found.</p></html>