HeadObject
最終更新日：2025-08-18 15:52:08
HEADリクエストを送信して、オブジェクトのメタデータを取得します。この方法ではファイル内容は返されません。IAM wos:HeadObject 権限が必要です。
リクエスト構文
HEAD /ObjectName HTTP/1
Host: Bucket.Endpoint
Date: date
Authorization: authorization
URIリクエストパラメータ
なし
リクエストヘッダー
common request headers に加えて、以下のヘッダーも使用可能です。
| 名前 | 説明 | 必須 |
|---|---|---|
| If-Match | リクエストのETagがバケット内該当オブジェクトのETagと一致する場合にメタデータを返します。一致しない場合は412（precondition failed）を返します。型: 文字列（例: 0f64741bf7cb1089e988e4585d0d3434） | No |
| If-Modified-Since | 指定日時より以前にオブジェクトが変更された場合のみ、メタデータが返されます。そうでない場合は304（not modified）を返します。型: 文字列 | No |
| If-Unmodified-Since | 指定日時以降に一度も変更されていない場合のみメタデータが返されます。そうでない場合は412（Precondition Failed）を返します。型: 文字列 | No |
| If-None-Match | リクエストのETagが該当オブジェクトのETagと一致しない場合にメタデータが返されます。 一致した場合は304（not modified）を返します。型: 文字列（例: 0f64741bf7cb1089e988e4585d0d3434） | No |
| Range | 指定範囲のオブジェクト内容を取得します。範囲指定が不正な場合は416 Requested Range Not Satisfiableが返されます。範囲は開始バイトと終了バイト（最小0、最大はオブジェクト長-1）です。型: 文字列（例：bytes=0-4 または bytes=512-1024） | No |
リクエストボディ
なし
レスポンス構文
HTTP/1.1 status_code
x-amz-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time
Server: WS-web-server
レスポンスヘッダー
common response headers に加えて、次のヘッダーが利用可能です。
| 名前 | 説明 |
|---|---|
| Etag | アップロードしたオブジェクトのエンティティタグ。 |
| x-wos-storage-class | オブジェクトのストレージクラス（Standard：標準、IA：低頻度アクセス、Archive：アーカイブ）。デフォルトはバケットのストレージクラスです。 |
| x-amz-meta-* | カスタムメタデータ。 |
レスポンスボディ
なし
特殊エラー
| 状況 | HTTPステータス | エラーコード | メッセージ |
|---|---|---|---|
| Rangeヘッダーが不正値で指定された場合 | 416 Requested Range Not Satisfiable | InvalidRange | The requested range cannot be satisfied. |
例
HEAD /objectName HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/1
Host: bucket.s3-cn-east-1.wcsapi.com
Accept: */*
Date: Sat, 03 Dec 2011 09:17:57 +0000
Authorization: WOS BF6C09F302931425E9A7:++6NkzwVhw4qccNfIqf4G2vMggg=
HTTP/1.1 200 OK
x-amz-request-id: 001B21A61C6C0000013403373811529D
ETag: "507e3fff69b69bf57d303e807448560b"
Last-Modified: Sat, 03 Dec 2011 08:47:50 GMT
Content-Length: 30
Content-Type: binary/octet-stream
Date: Sat, 03 Dec 2011 09:17:57 GMT
Server: WS-web-server
このドキュメントの内容は役に立ちましたか?
はい
いいえ