KDDIクラウドプラットフォームサービス ナレッジサイト

  • HOME
  • 開発者ガイドブック(APIリファレンス)
  • オブジェクトストレージ
  • サービス操作
  • オブジェクト操作
  • HEAD Object

HEAD Object

処理概要

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
2022/07/06 2022/07/06