オブジェクトメタデータ取得 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