処理概要

object自体を取得せずにメタデータだけを取得します。objectのメタデータのみが欲しい時に有効です。objectに対してREAD権限が必要です。

リクエスト

リクエストパラメタ

Name	Type	Description	Required
versionId	–	利用不可	–

リクエストヘッダー

このオペレーションはすべての操作に共通するリクエストヘッダに加えて下記のリクエストヘッダを利用できます。詳細については、一般的なリクエストヘッダを参照してください。

Name	Type	Description	Required
Range	–	利用不可	–
If-Modified-Since	string	objectの更新日時がヘッダー指定更新日時以降に更新されている場合に実行します。そうでない場合、HTTP status code 304 not modified を返します。	No
If-Unmodified-Since	string	objectの更新日時がヘッダー指定更新日時以降に更新されていない場合に実行します。そうでない場合、HTTP status code 412 precondition failed errorを返します。	No
If-Match	string	objectのETagとヘッダー指定ETagが一致した場合にコピーを実行します。そうでない場合、HTTP status code 412 precondition failed errorを返します。	No
If-None-Match	string	objectのETagとヘッダー指定ETagが不一致の場合にコピーに実行します。そうでない場合、HTTP status code 304 notmodified を返します。	No

リクエストボディ

なし

リクエストサンプル

HEAD /sample-bucket/sample-object.txt HTTP/1.1
Host: 192.168.0.1
Connection: keep-alive
Date: Tue, 01 Sep 2015 10:00:00 +0000
Authorization: AWS EXAMPLEjU2So5By3H5v2:EXAMPLEAjwlAvEi2cPLfQaM588ROWW90so7LwfPr

レスポンス

レスポンスヘッダ

このオペレーションはすべての操作に共通するレスポンスヘッダに加えて下記のレスポンスヘッダを利用できます。詳細については、一般的なレスポンスヘッダを参照してください。

Name	Type	Description
x-amz-expiration	–	利用不可
x-amz-meta-*	string	この接頭辞で始まるヘッダーはユーザー定義メタデータです。それぞれKey-Valueペアで扱います。S3はユーザー定義メタデータに対して検証や解釈を行いません。
x-amz-missing-meta	string	このヘッダにはx-amz-metaヘッダで返されるものを除いて多くのメタデータエントリを設定できます。REST APIよりも柔軟なSOAPのようなAPIを利用してメタデータを作成する場合、HTTPヘッダーとして妥当では無いメタデータを設定できます。
x-amz-replication-status	–	利用不可
x-amz-restore	–	利用不可
x-amz-version-id	–	利用不可

レスポンスボディ

なし

レスポンスサンプル

HTTP/1.1 200 OK
Date: Tue, 01 Sep 2015 10:00:00 GMT
X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef
Server: Cleversafe/3.5.1.0
X-Clv-S3-Version: 2.4
x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 123
Last-Modified: Tue, 01 Sep 2015 10:00:00
ETag: "abcdef0123456789abcdef0123456789"
Content-Type: text/plain