すべてのプロダクト
Search

このプロダクト

    Object Storage Service:HeadObject

    ドキュメントセンター

    Object Storage Service:HeadObject

    最終更新日:Nov 01, 2024

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

    バージョン管理

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

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

    リクエスト構文

    HEAD /ObjectName HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: 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-transition-time

    String

    ライフサイクルルールに基づいて、返されたオブジェクトのストレージクラスがコールドアーカイブまたはディープコールドアーカイブに変更された時刻。

    説明

    • オブジェクトのストレージクラスが変換されてから180日を超えてオブジェクトが保存された場合、最小保存期間未満で保存されたコールドアーカイブまたはディープコールドアーカイブオブジェクトのストレージ使用量に対しては課金されません。 オブジェクトのストレージクラスが変換されてから180日以内にオブジェクトが保存された場合、最小保存期間未満で保存されたコールドアーカイブまたはディープコールドアーカイブオブジェクトのストレージ使用量に対して課金されます。

    • このヘッダーを使用して、ライフサイクルルールに基づいてオブジェクトのストレージクラスが低頻度アクセス (IA) またはアーカイブに変換された時刻を照会することはできません。 Last-Modifiedヘッダーの値に基づいて、オブジェクトが最小保存期間を超えて保存されているかどうかを判断できます。

    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

    オブジェクトに対してトリガーされたイベント通知の結果。 Simple Message Queue (SMQ) を使用して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です。

    説明

    • IAオブジェクトの最小保存期間 (30日) は、オブジェクトの最後に変更された時刻に基づいて計算されます。 Last-Modifiedヘッダーの値が現在の時刻より30日前の場合、最小保存期間未満で保存されたIAオブジェクトのストレージ使用量に対しては課金されません。

    • アーカイブオブジェクトの最小保存期間 (60日) は、オブジェクトの最終変更時刻に基づいて計算されます。 Last-Modifiedヘッダーの値が現在の時刻より60日前の場合、最小保存期間未満で保存されたアーカイブオブジェクトのストレージ使用量に対しては課金されません。

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

    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
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 07:32:52 GMT
Authorization: OSS qn6q**************:77Dv****************

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

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Normal
x-oss-storage-class: Archive
Date: Fri, 7 Aug 2020 07:32:52 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

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

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Normal
x-oss-storage-class: Standard
Date: Wed, 31 Mar 2021 07:32:52 GMT
Last-Modified: Tue, 30 Mar 2021 06:07:48 GMT
ETag: "null"
Content-Length: 0
Content-Type: application/x-directory
Connection: keep-alive
Server: AliyunOSS

    • バージョン管理が有効なバケット内のオブジェクトの特定のバージョンのメタデータを照会する

      リクエストの例

      HEAD /example?versionId=CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYy****
Host: versioning-test.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 06:27:12 GMT
Authorization: OSS qn6q**************:77Dv****************

      レスポンスの例 

      HTTP/1.1 200 OK
x-oss-versionId: CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYy****
x-oss-request-id: 5CAC3B40B7AEADE01700****
x-oss-object-type: Normal
x-oss-storage-class: Archive
Date: Fri, 7 Aug 2020 06:27:12 GMT
Last-Modified: Fri, 7 Aug 2020 06:27:12 GMT
ETag: "A082B659EF78733A5A042FA253B1****"
Content-Length: 481827
Content-Type: text/html
Connection: keep-alive
Server: AliyunOSS

    • バージョン管理が有効なバケット内のオブジェクトの現在のバージョンのメタデータを照会する

      リクエストの例

      HEAD /example HTTP/1.1    
Host: versioning-test.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 06:27:12 GMT
Authorization: OSS qn6q**************:77Dv****************

      レスポンスの例 

      HTTP/1.1 200 OK
x-oss-versionId: CAEQMxiBgMCZov2D0BYiIDY4MDllOTc2YmY5MjQxMzdiOGI3OTlhNTU0ODIx****
x-oss-request-id: 5CAC3B40B7AEADE01700****
x-oss-object-type: Normal
x-oss-storage-class: Archive
Date: Fri, 7 Aug 2020 06:27:12 GMT
Last-Modified: Fri, 7 Aug 2020 06:27:12 GMT
ETag: "3663F7B0B9D3153F884C821E7CF4****"
Content-Length: 485859
Content-Type: text/html
Connection: keep-alive
Server: AliyunOSS

    • RestoreObjectリクエストが送信され、復元が進行中のオブジェクトのメタデータを照会します。

      リクエストの例

      HEAD /oss.jpg HTTP/1.1
Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 07:32:52 GMT
Authorization: OSS qn6q**************:77Dv****************

      レスポンスの例 

      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: Fri, 7 Aug 2020 07:32:52 GMT
Last-Modified: Fri, 7 Aug 2020 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

    • RestoreObjectリクエストが送信され、復元が完了したオブジェクトのメタデータを照会します。

      リクエストの例

      HEAD /oss.jpg HTTP/1.1
Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 09:35:51 GMT
Authorization: OSS qn6q**************:77Dv****************

      レスポンスの例 

      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: Fri, 7 Aug 2020 09:35:51 GMT
Last-Modified: Fri, 7 Aug 2020 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606

    • SSE-OSSを使用して暗号化されたオブジェクトのメタデータを照会する

      リクエストの例

      HEAD /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 07:32:52 GMT
Authorization: OSS qn6q**************:77Dv****************

      レスポンスの例

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Normal
x-oss-storage-class: Archive
x-oss-server-side-encryption: AES256
Date: Fri, 7 Aug 2020 07:32:52 GMT
Last-Modified: Fri, 7 Aug 2020 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

    • SSE-KMSを使用して暗号化されたオブジェクトのメタデータを照会する

      リクエストの例

      HEAD /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 07:32:52 GMT
Authorization: OSS qn6q**************:77Dv****************

      レスポンスの例

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
x-oss-object-type: Normal
x-oss-storage-class: Archive
x-oss-server-side-encryption: KMS
x-oss-server-side-encryption-key-id: 9468da86-3509-4f8d-a61e-6eab1eac****
Date: Fri, 7 Aug 2020 07:32:52 GMT
Last-Modified: Fri, 7 Aug 2020 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: 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値とは異なります。