オブジェクトメタデータ取得 HEAD /v1/{account}/{container}/{object}

オブジェクトのメタデータを取得する

正常時のレスポンスコード: 200

Request Headers

X-Auth-Token

認証トークン。省略した場合、ACLによってアクセスを許可していない限り、リクエストは失敗します。詳細についてはACLをご参照ください。

Data Type Cardinality
String 0..1

X-Newest

このヘッダーにTrueが設定されている場合、全てのレプリカを検索して最新のものを返却する。このヘッダーを指定しない場合は、有効なレプリカを一つのみ検索するため、応答は速くなる。システムの負荷が増大するため、絶対に必要な場合にだけ使用してください。

Data Type Cardinality
Boolean 0..1

Request Parameter

{account}

アカウントのuniqueな名前。"アカウント"は、"プロジェクト"とも呼ばれる。

Data Type Cardinality
String 1..1

{container}

コンテナのuniqueな名前。

Data Type Cardinality
String 1..1

{object}

オブジェクトのuniqueな名前。

Data Type Cardinality
String 1..1

Query Parameter

temp_url_sig

有効期限付きURL 機能において、リクエストの署名に使用する。

Data Type Cardinality
String 0..1

temp_url_expires

有効期限付きURL 機能において、temp_url_sigの有効期限を指定する。

Data Type Cardinality
String 0..1

Response Headers

Last-Modified

オブジェクトが生成された日時、または、前回メタデータが更新された日時。

Data Type Cardinality
String 1..1

Content-Length

オブジェクトのサイズ。

Data Type Cardinality
String 1..1

Content-Type

オブジェクトのMIMEタイプ。

Data Type Cardinality
String 1..1

ETag

For objects smaller than 5 GB, this value is the MD5 checksum of the object content.

5GBより小さいオブジェクトの場合、オブジェクトのMD5チェックサム値が返却される。値は引用符で囲まれていない。

マニフェストオブジェクトの場合、マニフェストの各セグメントのETagとMD5 checksumsを連結した文字列に対して、MD5 checksum を取得した値が返却される。ダウンロードされたオブジェクトのMD5 checksumsではない。また値は、二重引用符で囲まれている。

レスポンスボディのMD5 checksumを算出し、ETagヘッダーで取得した値と比較する事を強く勧める。異なっていた場合は、コンテンツは壊れているため、再試行が必要。

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 0..1

X-Object-Manifest

動的ラージオブジェクトの設定が返却されます。この値は{container}/{prefix}の形式でコンテナ名および分割オブジェクトのプレフィクス名を取ります。

Data Type Cardinality
String 0..1

X-Object-Meta-name

オブジェクトメタデータ。{name}はメタデータ項目の名前。

Data Type Cardinality
String 0..1

X-Static-Large-Object

オブジェクトが静的ラージオブジェクトのマニフェストオブジェクトの場合、Trueが返却されます。

Data Type Cardinality
String 1..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 HEAD -H "X-Auth-Token:$token"
     

Example of Response


HTTP/1.1 200 OK
Content-Length: 14
Accept-Ranges: bytes
Last-Modified: Thu, 16 Jan 2014 21:12:31 GMT
Etag: 451e372e48e0f6b1114fa0724aa79fa1
X-Timestamp: 1389906751.73463
X-Object-Meta-Book: GoodbyeColumbus
Content-Type: application/octet-stream
X-Trans-Id: tx37ea34dcd1ed48ca9bc7d-0052d84b6f
Date: Thu, 16 Jan 2014 21:13:19 GMT