すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:HeadObject

最終更新日:Feb 23, 2024

オブジェクトメタデータを照会します。 この操作を呼び出すと、オブジェクトの内容は応答で返されません。

バージョン管理

  • 既定では、HeadObject操作を呼び出してオブジェクトのメタデータを照会し、リクエストにバージョンIDを指定しない場合、オブジェクトの現在のバージョンのメタデータが返されます。 オブジェクトの現在のバージョンが削除マーカーである場合、object Storage Service (OSS) はHTTPステータスコード404とNoSuchKeyエラーコードを返します。

  • HeadObject操作を呼び出してオブジェクトのメタデータを照会し、リクエストにバージョンIDを指定すると、指定したバージョンのオブジェクトのメタデータが返されます。 HeadObjectリクエストで削除マーカーのバージョンIDを指定すると、OSSはHTTPステータスコード405とMethodNotAllowedエラーコードを返します。

リクエスト構文

HEAD /ObjectName HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue 

リクエストヘッダー

ヘッダー

データ型

必須

説明

If-Modified-Since

String

任意

情報の戻り条件。 指定された時刻がオブジェクトの最後に変更された時刻より前の場合、OSSはオブジェクトのメタデータを返し、OKを200します。 それ以外の場合、OSSはHTTPステータスコード304とNotModifiedエラーコードを返します。

デフォルトでは、このヘッダーは空のままです。

If-Unmodified-Since

String

任意

情報の戻り条件。 指定された時間がオブジェクトの最終変更時刻以降の場合、OSSはオブジェクトのメタデータを返し、OKを200します。 それ以外の場合、OSSはHTTPステータスコード412とPreconditionFailedエラーコードを返します。

デフォルトでは、このヘッダーは空のままです。

If-Match

String

任意

情報の戻り条件。 入力ETag値がオブジェクトのETag値と一致する場合、OSSはオブジェクトのメタデータを返し、OKを200します。 それ以外の場合、OSSはHTTPステータスコード412とPreconditionFailedエラーコードを返します。

デフォルトでは、このヘッダーは空のままです。

If-None-マッチ

String

任意

情報の戻り条件。 入力ETag値がオブジェクトのETag値と一致しない場合、OSSはオブジェクトのメタデータを返し、OKを200します。 それ以外の場合、OSSはHTTPステータスコード304とNotModifiedエラーコードを返します。

デフォルトでは、このヘッダーは空のままです。

HeadObjectリクエストの一般的なリクエストヘッダー (ホストや日付など) の詳細については、「一般的なリクエストヘッダー」をご参照ください。

レスポンスヘッダー

リクエストされたオブジェクトがシンボリックリンクの場合は、レスポンスの次のヘッダーに注意してください。

  • Content-Length、ETag、x-oss-storage-class、およびContent-Md5ヘッダーは、シンボリックリンクが指すオブジェクトのメタデータです。

  • Last-Modifiedヘッダーの戻り値は、シンボリックリンクの最終変更時刻またはシンボリックリンクが指すオブジェクトの最終変更時刻のいずれか遅い方を使用します。

  • その他のレスポンスヘッダーは、シンボリックリンクのメタデータです。

ヘッダー

データ型

説明

x-oss-meta-*

String

プレフィックスがx-oss-meta-のカスタムヘッダー。 これらのヘッダーはユーザーメタデータを記述します。 PutObjectリクエストの先頭にx-oss-meta-が付いたヘッダーを指定すると、オブジェクトのユーザーメタデータがレスポンスに含まれます。

x-oss-meta-が付いていないカスタムヘッダー

String

PutObjectリクエストの先頭にx-oss-metaが付いていないヘッダーを指定した場合、ヘッダーはレスポンスに含まれます。 例: x-oss-persistent-headers: key1:base64_encode(value1),key2:base64_encode(value2)....

x-oss-server-side-encryption

String

サーバー側でオブジェクトを暗号化するために使用されるアルゴリズム。 このヘッダは、エントロピー符号化に基づくサーバ側暗号化アルゴリズムを使用することによってオブジェクトが暗号化される場合、応答に含まれる。

x-oss-server-side-encryption-key-id

String

オブジェクトの暗号化に使用される顧客マスターキー (CMK) のID。 このヘッダーは、サーバー側でキー管理サービス (KMS) を使用してオブジェクトが暗号化されている場合、レスポンスに含まれます。

x-oss-storage-class

String

オブジェクトのストレージクラス。 有効な値: Standard、IA、Archive、ColdArchive、およびDeepColdArchive。

ストレージクラスの詳細については、「概要」をご参照ください。

x-oss-object-type

String

オブジェクトのタイプです。 有効な値:

  • Normal: オブジェクトは、PutObjectまたはCreateDirectory操作を呼び出してアップロードされます。

  • Appendable: オブジェクトはAppendObject操作を呼び出してアップロードされます。

  • マルチパート: オブジェクトはマルチパートアップロードを使用してアップロードされます。

x-oss-next-append-position

String

次の追加操作の位置。The position for the next append operation. オブジェクトのタイプがAppendableの場合、このヘッダーはレスポンスに含まれます。

x-oss-hash-crc64ecma

String

オブジェクトの64ビットCRC値。 この値は、ECMA-182 標準に基づいて計算されます。

OSSがCRC-64をサポートする前にオブジェクトが作成された場合、HeadObject操作を呼び出してオブジェクトのメタデータを照会するときに、このヘッダーがレスポンスに含まれないことがあります。

x-oss-expiration

String

ライフサイクルルールが設定されているバケット内のオブジェクトの有効期限。

  • バケットのバージョン管理が有効

    • リクエストに含まれていないバージョンID

      要求されたオブジェクトがライフサイクルルールで指定された削除条件と一致する場合、x-oss-expirationヘッダーがレスポンスに含まれ、オブジェクトの現在のバージョンの有効期限が示されます。

    • リクエストに含まれるバージョンID

      要求されたオブジェクトがライフサイクルルールで指定された削除条件と一致するかどうかにかかわらず、x-oss-expirationヘッダーは応答に含まれません。

  • バケットのバージョン管理が有効になっていない

    • 要求されたオブジェクトがライフサイクルルールで指定された削除条件と一致する場合、x-oss-expirationヘッダーがレスポンスに含まれます。

    • 要求されたオブジェクトがライフサイクルルールで指定された削除条件と一致しない場合、x-oss-expirationヘッダーはレスポンスに含まれません。

x-oss-restore

String

オブジェクトを復元するときのオブジェクトのステータス。 RestoreObjectリクエストがアーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトに対して送信された場合、このヘッダーがレスポンスに含まれます。

  • RestoreObjectリクエストが送信されないかタイムアウトした場合、このヘッダーはレスポンスに含まれません。

  • RestoreObjectリクエストが送信され、復元が完了していない場合、このヘッダーの戻り値は継続-request="true" です。

  • RestoreObjectリクエストが送信され、復元が完了した場合、このヘッダーの戻り値は次の形式になります。継続-リクエスト="false" 、有効期限-日付="Sun, 16 Apr 2017 08:12:33 GMT" 。 expiry-dateパラメーターの値は、復元されたオブジェクトを読み取ることができる時間を示します。

x-oss-process-status

String

オブジェクトに対してトリガーされたイベント通知の結果。 Message Service (MNS) を使用してOSSイベント通知ルールを作成し、オブジェクトに対して実行された操作がルールをトリガーする場合、このヘッダーがレスポンスに含まれます。 このヘッダーの戻り値はJSON形式でBase64-encodedされます。

x-oss-request-charged

String

リクエスタ。 このヘッダーは、pay-by-requesterモードがバケットに対して有効であり、要求者がバケット所有者でない場合に、応答に含まれます。 このヘッダーの値はrequesterです。

コンテンツ-Md5

String

  • Content-Md5だ オブジェクトタイプがNormalの場合、このヘッダーはレスポンスに含まれます。 このヘッダの値は、以下のプロセスを実行することによって計算される。 RFC 1864に基づいてメッセージコンテンツのMD5ハッシュを計算し、128ビットの桁を取得します。 MD5ハッシュの計算にヘッダーを含めないでください。 2. Base64を使用して数字をエンコードします。

  • オブジェクトタイプがMultipartまたはAppendableの場合、このヘッダーはレスポンスに含まれません。

Last-Modified

String

オブジェクトが最後に変更された時刻。 時刻はHTTP/1.1で指定されたGMTです。

アクセス制御-許可-オリジン

String

オリジンは、クロスオリジンリソース共有 (CORS) に許可されています。 オブジェクトを格納するバケットにCORSルールが設定されており、リクエストのOriginヘッダーがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。

アクセス制御-許可-メソッド

String

CORSに許可された方法。 オブジェクトを格納するバケットに対してCORSルールが設定されており、リクエスト内のAccess-Control-Request-MethodヘッダーがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。

アクセス制御-Max-Age

String

CORSの最大キャッシュ期間。 オブジェクトを格納するバケットにCORSルールが設定されており、リクエストがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。

アクセス制御-許可ヘッダー

String

CORSに許可されているヘッダー。 オブジェクトを格納するバケットにCORSルールが設定されており、リクエストがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。

アクセス制御-公開ヘッダー

String

クライアント上のJavaScriptアプリケーションがアクセスできるヘッダー。 オブジェクトを格納するバケットにCORSルールが設定されており、リクエストがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。

x-oss-tagging-count

String

オブジェクトに追加されたタグの数。 このヘッダーは、タグの読み取り権限がある場合にのみレスポンスに含まれます。

HeadObjectリクエストへのレスポンスのETagやx-oss-request-idなどの一般的なレスポンスヘッダーの詳細については、「一般的なレスポンスヘッダー」をご参照ください。

  • バージョン化されていないバケット内のオブジェクトのメタデータの照会

    リクエストの例

    HEAD /oss.jpg HTTP/1.1
    ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
    日付: 8月7日金曜日2020 07:32:52 GMT
    権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:JbzF2LxZUtanlJ5dLA092wpD **** 

    オブジェクトのサンプル応答

    HTTP/1.1 200 OK
    x-oss-request-id: 559CC9BDC755F95A6448 ****
    x-oss-object-type: Normal
    x-oss-storage-class: アーカイブ
    日付: 8月7日金曜日2020 07:32:52 GMT
    最終変更: 2月24日金曜日2012 06:07:48 GMT
    ETag: "fba9dede5f27731c9771645a3986 ****"
    コンテンツ-長さ: 344606
    コンテンツタイプ: image/jpg
    接続: キープアライブ
    サーバー: AliyunOSS 

    ディレクトリのサンプル応答

    HTTP/1.1 200 OK
    x-oss-request-id: 559CC9BDC755F95A6448 ****
    x-oss-object-type: Normal
    x-oss-storage-class: 標準
    日付: 3月31日水2021 07:32:52 GMT
    最終変更: 3月30日2021日火曜日06:07:48 GMT
    ETag: "null"
    コンテンツ長: 0
    Content-Type: application/x-directory
    接続: キープアライブ
    サーバー: AliyunOSS 
  • バージョン管理が有効なバケット内のオブジェクトの特定のバージョンのメタデータを照会する

    リクエストの例

    HEAD /example?versionId=CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYy ****
    ホスト: versioning-test.oss-cn-hangzhou.aliyuncs.com
    日付: 8月7日金曜日2020 06:27:12 GMT
    承認: OSS ryghu9rp3mqp1ya:RvyjGvKxaUhdF0ibyEwX5mOM **** 

    レスポンスの例

    HTTP/1.1 200 OK
    x-oss-versionId: CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYy ****
    x-oss-request-id: 5CAC3B40B7AEADE01700 ****
    x-oss-object-type: Normal
    x-oss-storage-class: アーカイブ
    日付: 8月7日金曜日2020 06:27:12 GMT
    最終変更: 8月7日金曜日2020 06:27:12 GMT
    ETag: "A082B659EF78733A5A042FA253B1 ****"
    コンテンツ-長さ: 481827
    コンテンツタイプ: text/html
    接続: キープアライブ
    サーバー: AliyunOSS 
  • バージョン管理が有効なバケット内のオブジェクトの現在のバージョンのメタデータを照会する

    リクエストの例

    HEAD /例HTTP/1.1
    ホスト: versioning-test.oss-cn-hangzhou.aliyuncs.com
    日付: 8月7日金曜日2020 06:27:12 GMT
    承認: OSS ryghu9rp3mqp1ya:RvyjGvKxaUhdF0ibyEwX5mOM **** 

    レスポンスの例

    HTTP/1.1 200 OK
    x-oss-versionId: CAEQMxiBgMCZov2D0BYiIDY4MDllOTc2YmY5MjQxMzdiOGI3OTlhNTU0ODIx ****
    x-oss-request-id: 5CAC3B40B7AEADE01700 ****
    x-oss-object-type: Normal
    x-oss-storage-class: アーカイブ
    日付: 8月7日金曜日2020 06:27:12 GMT
    最終変更: 8月7日金曜日2020 06:27:12 GMT
    ETag: "3663F7B0B9D3153F884C821E7CF4 ****"
    コンテンツ-長さ: 485859
    コンテンツタイプ: text/html
    接続: キープアライブ
    サーバー: AliyunOSS 
  • RestoreObjectリクエストが送信され、復元が進行中のオブジェクトのメタデータを照会します。

    リクエストの例

    HEAD /oss.jpg HTTP/1.1
    ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
    日付: 8月7日金曜日2020 07:32:52 GMT
    権限付与: OSS e1Unnbm1rgdnpI:KKxkdNrUBu2t1kqlDh0MLbDb **** 

    レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 58F71A164529F18D7F00 ****
    x-oss-object-type: Normal
    x-oss-storage-class: アーカイブ
    x-oss-restore: 継続的-要求="true"
    日付: 8月7日金曜日2020 07:32:52 GMT
    最終変更: 8月7日金曜日2020 06:07:48 GMT
    ETag: "fba9dede5f27731c9771645a3986 ****"
    コンテンツ-長さ: 344606
    コンテンツタイプ: image/jpg
    接続: キープアライブ
    サーバー: AliyunOSS 
  • RestoreObjectリクエストが送信され、復元が完了したオブジェクトのメタデータを照会します。

    リクエストの例

    HEAD /oss.jpg HTTP/1.1
    ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
    日付: 8月7日金曜日2020 09:35:51 GMT
    承認: OSS e1Unnbm1rgdnpI:21qtGJ + ykDVmdu6O6FMJnn + W **** 

    レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 58F725344529F18D7F00 ****
    x-oss-object-type: Normal
    x-oss-storage-class: アーカイブ
    x-oss-restore: 継続的な要求="false" 、有効期限="Sun、4月16日08:12:33 GMT" 2017
    日付: 8月7日金曜日2020 09:35:51 GMT
    最終変更: 8月7日金曜日2020 06:07:48 GMT
    ETag: "fba9dede5f27731c9771645a3986 ****"
    コンテンツ-長さ: 344606 
  • SSE-OSSを使用して暗号化されたオブジェクトのメタデータを照会する

    リクエストの例

    HEAD /oss.jpg HTTP/1.1
    ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
    日付: 8月7日金曜日2020 07:32:52 GMT
    権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:JbzF2LxZUtanlJ5dLA092wpD **** 

    レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 559CC9BDC755F95A6448 ****
    x-oss-object-type: Normal
    x-oss-storage-class: アーカイブ
    x-oss-server-side-encryption: AES256
    日付: 8月7日金曜日2020 07:32:52 GMT
    最終変更: 8月7日金曜日2020 06:07:48 GMT
    ETag: "fba9dede5f27731c9771645a3986 ****"
    コンテンツ-長さ: 344606
    コンテンツタイプ: image/jpg
    接続: キープアライブ
    サーバー: AliyunOSS 
  • SSE-KMSを使用して暗号化されたオブジェクトのメタデータを照会する

    リクエストの例

    HEAD /oss.jpg HTTP/1.1
    ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
    日付: 8月7日金曜日2020 07:32:52 GMT
    権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:JbzF2LxZUtanlJ5dLA092wpD **** 

    レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 559CC9BDC755F95A64485981
    x-oss-object-type: Normal
    x-oss-storage-class: アーカイブ
    x-oss-server-side-encryption: KMS
    x-oss-server-side-encryption-key-id: 9468da86-3509-4f8d-a61e-6eab1eac ****
    日付: 8月7日金曜日2020 07:32:52 GMT
    最終変更: 8月7日金曜日2020 06:07:48 GMT
    ETag: "fba9dede5f27731c9771645a3986 ****"
    コンテンツ-長さ: 344606
    コンテンツタイプ: image/jpg
    接続: キープアライブ
    サーバー: AliyunOSS 

エラーコード

エラーコード

HTTPステータスコード

説明

NoSuchKey

404

リクエストされたオブジェクトは存在しません。

SymlinkTargetNotExist

404

要求されたオブジェクトはシンボリックリンクです。

InvalidTargetType

400

要求されたオブジェクトは、別のシンボリックリンクを指すシンボリックリンクである。

NotModified

304

考えられる原因:

  • If-Modified-Sinceヘッダーはリクエストで指定されていますが、リクエストされたオブジェクトはリクエストで指定された時間以降変更されていません。

  • If-None-Matchヘッダーはリクエストに指定されており、リクエストのETag値はリクエストされたオブジェクトのETag値と同じです。

PreconditionFailed

412

考えられる原因:

  • If-Unmodified-Sinceヘッダーがリクエストに指定されていますが、指定された時刻は、リクエストされたオブジェクトの最後に変更された時刻より前です。

  • If-Matchヘッダーはリクエストに指定されていますが、リクエストのETag値はリクエストされたオブジェクトのETag値とは異なります。