オブジェクトのコンテンツを返さずに、オブジェクトのメタ情報を取得します。

PutObject リクエストの送信時にプレフィックスが x-oss-meta- のユーザーメタ情報をアップロードした場合 (x-oss-meta-location など)、ユーザーメタ情報が返されます。

バージョン管理

デフォルトでは、HeadObject は、オブジェクトの現在のバージョンに関するメタ情報を取得します。 ターゲットオブジェクトの現在のバージョンが削除マーカーの場合、404 Not Found エラーが返されます。 versionId を指定すると、ターゲットオブジェクトの特定のバージョンに関するメタ情報を取得できます。

リクエスト構文

HEAD /ObjectName HTTP/1.1
Host: BucketName/oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

ヘッダー 必須 説明
If-Modified-Since String いいえ パラメーターに指定した時刻が変更時刻より前の場合、200 OK メッセージとオブジェクトメタ情報が返されます。 それ以外の場合、304 Not Modified メッセージが返されます。

デフォルト値:なし

If-Unmodified-Since String いいえ パラメーターに指定した時刻がオブジェクトの変更時刻以降の場合、200 OK メッセージとオブジェクトメタ情報が返されます。 それ以外の場合、412 Precondition Failed メッセージが返されます。

デフォルト値:なし

If-Match String いいえ 指定した ETag がオブジェクトの ETag と一致する場合、200 OK メッセージとオブジェクトメタ情報が返されます。 それ以外の場合、412 Precondition Failed メッセージが返されます。

デフォルト値:なし

If-None-Match String いいえ 指定された ETag がオブジェクトの ETag と一致しない場合、200 OK メッセージとオブジェクトメタ情報が返されます。 それ以外の場合、304 Not Modified メッセージが返されます。

デフォルト値:なし

レスポンスヘッダー

リクエストされたオブジェクトのタイプがシンボルリンクの場合、オブジェクトのコンテンツが返されます。 レスポンスヘッダー内の Content-LengthETagContent-Md5 は、リクエストされたオブジェクトのメタ情報です。 Last-Modified は、リクエストされたオブジェクトとシンボルリンクの最大値 (遅い方の変更時刻)、その他のパラメーターはシンボルリンクのメタ情報です。
ヘッダー 説明
x-oss-meta-* String カスタムメタヘッダー。 PutObject リクエストの送信時にプレフィックスが x-oss-meta- のユーザーメタ情報をアップロードした場合、ユーザーメタ情報が返されます。
カスタムヘッダー (プレフィックスが x-oss-meta- 以外) String プレフィックスが x-oss-meta- 以外のカスタムヘッダー。 PutObject リクエストの送信時に x-oss-meta- 以外のプレフィックスを持つユーザーメタ情報をアップロードした場合 (x-oss-persistent- ヘッダー key1:base64_encode(value1),key2:base64_encode(value2).... など)、このカスタムヘッダーに該当するプレフィックスを持つユーザーメタ情報が返されます。
x-oss-server-side-encryption String リクエストされたオブジェクトが、サーバー上でエントロピー符号アルゴリズムを使用して暗号化されている場合、OSS はオブジェクトを復号化し、このヘッダーをレスポンスに含めて、サーバー上でオブジェクトの暗号化に使用された暗号化アルゴリズムを示します。
x-oss-server-side-encryption-key-id String ユーザーの Key Management Service (KMS) キー ID 。 オブジェクトの作成時に KMS を使用して暗号化する場合、このヘッダーが返されます。
x-oss-storage-class String オブジェクトのストレージクラス。 ストレージクラスには、Standard、Infrequent Access、Archive があります。
  • Standard ストレージは、高信頼性、高可用性、高性能のオブジェクトストレージサービスを提供し、頻繁なデータアクセスをサポートします。
  • Infrequent Access ストレージは、データを長期間保存する必要があり、アクセス頻度が低いシナリオに適用できます (1 か月のアクセス頻度は平均で 1~2 回)。
  • Archive ストレージは、データを 6 か月以上保存する必要があり、保存期間中はほとんどアクセスされないシナリオに適用できます。 保存されたデータが読み取り可能になるまでに約 1 分かかります。
x-oss-object-type String オブジェクトタイプ。
  • PutObject でアップロードされるオブジェクトのタイプは、Normal です。
  • AppendObject でアップロードされるオブジェクトのタイプは、Appendable です。
  • MultipartUpload でアップロードされるオブジェクトのタイプは、Multipart です。
x-oss-next-append-position String 次回のリクエストで指定する位置。 このヘッダーは、Appendable オブジェクトの場合に返されます。
x-oss-hash-crc64ecma String オブジェクトの 64 ビット CRC 値。 この値は、ECMA-182 標準に基づいて計算されます。 既存のオブジェクトには、この値がない可能性があります。
x-oss-expiration String オブジェクトにライフサイクルルールが設定されている場合、x-oss-expiration ヘッダーが返されます。 返されるヘッダー内の expiry-date の値はオブジェクトの有効期限、rule-id の値はルール ID です。
x-oss-restore String バケットタイプがアーカイブで、Restore リクエストが送信された場合、オブジェクトの復元状態はレスポンスヘッダーの x-oss-restore に示されます。
  • Restore リクエストが送信されなかったか、タイムアウトした場合、このフィールドは返されません。
  • Restore リクエストが送信され、タイムアウトしていない場合、返される x-oss-restore の値は ongoing-request=”true” です。
  • Restore リクエストが送信され、完了した場合、返される x-oss-restore の値は、ongoing-request=”false”、expiry-date=”Sun, 16 Apr 2017 08:12:33 GMT” です。 返される値の expiry-date の値は、復元されたファイルの読み取り可能な状態の有効期限です。
x-oss-process-status String MNS を介して OSS イベント通知を作成し、OSS 操作を実行するリクエストを送信すると、一致するイベント通知ルールが検出された場合、このヘッダーが返されます。 この場合、値は Base64 でエンコードされた JSON 形式のイベント通知結果です。
x-oss-request-charged String バケット所有者ではなく、リクエスト送信者がオブジェクトの属するバケットの料金を支払う場合、このヘッダーは値 requester が返されます。
Content-Md5 String Normal オブジェクトのメッセージコンテンツ (ヘッダーを除く) は RFC 1864 標準に基づいて計算され、128 ビットの数値が取得されます。 メッセージの Content-Md5 値は、Base64 に基づいて 128 ビットの数値がエンコードされた後に取得されます。 このヘッダーは、Multipart オブジェクトと Appendable オブジェクトでは返されません。
Last-Modified String オブジェクトの最終変更時刻。 時刻は HTTP 1.1 で指定された GMT 形式です。
Access-Control-Allow-Origin String オブジェクトが属するバケットに CORS ルールが設定されている場合、リクエストされたオリジンが CORS ルールを満たすと、オリジンが返されます。
Access-Control-Allow-Methods String オブジェクトが属するバケットに CORS ルールが設定されている場合、リクエストされた Access-Control-Request-Method が CORS ルールを満たすと、対応するメソッドが返されます。
Access-Control-Max-Age String オブジェクトが属するバケットに CORS ルールが設定されている場合、リクエストが CORS ルールを満たすと、MaxAgeSeconds の値が返されます。
Access-Control-Allow-Headers String オブジェクトが属するバケットに CORS ルールが設定されている場合、リクエストが CORS ルールを満たすと、ヘッダーが返されます。
Access-Control-Expose-Headers String クライアント JavaScript にアクセスできるヘッダーのリスト。 オブジェクトが属するバケットに CORS ルールが設定されている場合、リクエストが CORS ルールを満たすと、ExposeHeader が返されます。
x‑oss‑tagging‑count String オブジェクトに関連付けられているタグの数。 このパラメーターの値は、タグの読み取り権限を持っている場合のみ返されます。

  • 通常のリクエスト例

    HEAD /oss.jpg HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Fri, 24 Feb 2012 07:32:52 GMT
    Authorization: OSS qn6qrrqxo2oawuk53otf****:JbzF2LxZUtanlJ5dLA092wpD****

    レスポンス例

    HTTP/1.1 200 OK
    x-oss-request-id: 559CC9BDC755F95A6448****
    x-oss-object-type: Normal
    x-oss-storage-class: Archive
    Date: Fri, 24 Feb 2012 07:32:52 GMT
    Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
    ETag: "fba9dede5f27731c9771645a39863328"
    Content-Length: 344606
    Content-Type: image/jpg
    Connection: keep-alive
    Server: AliyunOSS
  • Restore リクエストが送信されたが完了していない場合のリクエストの例

    HEAD /oss.jpg HTTP/1.1
    Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
    Date: Sat, 15 Apr 2017 07:32:52 GMT
    Authorization: OSS e1Unnbm1rg****:KKxkdNrUBu2t1kqlDh0MLbDb****

    レスポンス例

    HTTP/1.1 200 OK
    x-oss-request-id: 58F71A164529F18D7F00****
    x-oss-object-type: Normal
    x-oss-storage-class: Archive
    x-oss-restore: ongoing-request="true"
    Date: Sat, 15 Apr 2017 07:32:52 GMT
    Last-Modified: Sat, 15 Apr 2017 06:07:48 GMT
    ETag: "fba9dede5f27731c9771645a39863328"
    Content-Length: 5246
    Content-Type: image/jpg
    Connection: keep-alive
    Server: AliyunOSS
  • Restore リクエストが送信され、完了した場合のリクエストの例

    HEAD /oss.jpg HTTP/1.1
    Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
    Date: Sat, 15 Apr 2017 09:35:51 GMT
    Authorization: OSS e1Unnbm1rg****:21qtGJ+ykDVmdu6O6FMJnn+W****

    レスポンス例

    HTTP/1.1 200 OK
    x-oss-request-id: 58F725344529F18D7F00****
    x-oss-object-type: Normal
    x-oss-storage-class: Archive
    x-oss-restore: ongoing-request="false", expiry-date="Sun, 16 Apr 2017 08:12:33 GMT"
    Date: Sat, 15 Apr 2017 09:35:51 GMT
    Last-Modified: Sat, 15 Apr 2017 06:07:48 GMT
    ETag: "fba9dede5f27731c9771645a39863328"
    Content-Length: 344606
  • オブジェクトの現在のバージョンに関するメタ情報を取得するために開始されたリクエストの例

    HEAD /example?versionId=CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYyNDFm
    Host: versioning-test.oss-cn-hangzhou.aliyuncs.com
    Date: Tue, 09 Apr 2019 06:27:12 GMT
    Authorization: OSS ryghu9rp3mq****:RvyjGvKxaUhdF0ibyEwX5mOM****

    レスポンス例

    HTTP/1.1 200 OK
    x-oss-versionId: CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYyNDFm
    x-oss-request-id: 5CAC3B40B7AEADE01700****
    x-oss-object-type: Normal
    x-oss-storage-class: Archive
    Date: Tue, 09 Apr 2019 06:27:12 GMT
    Last-Modified: Tue, 09 Apr 2019 06:27:12 GMT
    ETag: "A082B659EF78733A5A042FA253B19BA4"
    Content-Length: 481827
    Content-Type: text/html
    Connection: keep-alive
    Server: AliyunOSS

エラーコード

エラーコード HTTP ステータスコード 説明
NoSuchKey 404 リクエストされたオブジェクトは存在しません。
SymlinkTargetNotExist 404 リクエストされたオブジェクトはシンボルリンクです。
InvalidTargetType 400 リクエストされたオブジェクトとターゲットオブジェクトは、シンボルリンクとターゲットです。
Not Modified 304
  • If-Modified-Since ヘッダーがリクエストに指定されていますが、リクエストに指定された時間以降にソースオブジェクトは変更されていません。
  • If-None-Match ヘッダーがリクエストに指定され、リクエストに指定された ETag はソースオブジェクトの ETag と同じです。
Precondition Failed 412
  • If-Unmodified-Since ヘッダーが指定されていますが、リクエストに指定された時刻はオブジェクトの変更時刻より前です。
  • If-Match ヘッダーが指定されていますが、指定された ETag はソースオブジェクトの ETag とは異なります。