すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetObjectMeta

    ドキュメントセンター

    Object Storage Service:GetObjectMeta

    最終更新日:May 20, 2025

    オブジェクトのメタデータ（ETag、サイズ、最終更新時刻など）をクエリします。オブジェクトのコンテンツは返されません。

    使用上の注意

    説明

    オブジェクトがシンボリックリンクの場合、シンボリックリンクの情報が返されます。

    バージョン管理されていないバケット内のオブジェクトのメタデータをクエリするには、oss:GetObject 権限が必要です。バージョン管理が有効なバケット内のオブジェクトの特定バージョンのメタデータをクエリするには、oss:GetObjectVersion 権限が必要です。オブジェクトのバージョンを指定するには、リクエストに x-oss-version-id ヘッダーを指定します。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

    バージョン管理

    デフォルトでは、GetObjectMeta 操作はオブジェクトの現在のバージョンのメタデータをクエリします。オブジェクトの現在のバージョンが削除マーカーの場合、Object Storage Service (OSS) は 404 Not Found を返します。リクエストでバージョン ID を指定すると、OSS は指定されたバージョンのオブジェクトのメタデータを返します。

    リクエスト構造

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

    リクエストヘッダー

    GetObjectMeta リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。

    レスポンスパラメーター

    レスポンスヘッダー

    タイプ

    例

    説明

    Content-Length

    String

    344606

    オブジェクトのサイズ。単位：バイト。

    ETag

    String

    5B3C1A2E053D763E1B002CC607C5****

    オブジェクトの作成時に生成される ETag。ETag は、オブジェクトのコンテンツを識別するために使用されます。

    PutObject 操作を呼び出すことによってオブジェクトが作成された場合、オブジェクトの ETag はオブジェクトコンテンツの MD5 ハッシュです。別のメソッドを使用してオブジェクトが作成された場合、オブジェクトの ETag はオブジェクトコンテンツの MD5 ハッシュではなく、特定のルールに基づいて計算された一意の値です。オブジェクトの ETag を使用して、オブジェクトコンテンツが変更されたかどうかを確認できます。ただし、データの整合性を検証するには、オブジェクトの ETag ではなく、オブジェクトの MD5 ハッシュを使用することをお勧めします。

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

    x-oss-transition-time

    String

    Tue, 23 Apr 2024 07:21:42 GMT

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

    説明

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

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

    x-oss-last-access-time

    String

    Tue, 30 Mar 2021 06:07:48 GMT

    オブジェクトに最後にアクセスされた時刻。時刻は、HTTP/1.1 で指定された GMT 時刻である必要があります。アクセス追跡が有効になっている場合、このヘッダーの値は、オブジェクトにアクセスされるたびに継続的に更新されます。アクセス追跡が無効になっている場合、このヘッダーの値は返されなくなります。

    重要

    オブジェクトの最終アクセス時刻は非同期に更新されます。OSS は、オブジェクトの最終アクセス時刻が 24 時間以内に更新されることを保証します。24 時間以内にオブジェクトに複数回アクセスした場合、オブジェクトの最終アクセス時刻は、その期間内に初めてオブジェクトにアクセスした時刻に更新されます。

    Last-Modified

    String

    Fri, 24 Feb 2012 06:07:48 GMT

    オブジェクトが最後に変更された時刻。時刻は、HTTP/1.1 で指定された GMT 時刻である必要があります。

    説明

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

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

    x-oss-version-id

    String

    CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****

    オブジェクトのバージョン ID。このヘッダーは、オブジェクトの特定バージョンのメタデータをクエリした場合にのみ返されます。

    このリクエストへのレスポンスには、共通のレスポンスヘッダーが含まれています。詳細については、「共通レスポンスヘッダー」をご参照ください。

    例

    • バージョン管理されていないバケット内のオブジェクトのメタデータをクエリする

      リクエスト例

      HEAD /oss.jpg?objectMeta HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 29 Apr 2015 05:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      成功レスポンスの例

      重要

      バケットに対して階層型名前空間を有効にした後、CreateDirectory 操作を呼び出すことによってディレクトリを作成した場合、GetObjectMeta 操作を呼び出してディレクトリ情報をクエリすると、ETag に null が返されます。

      • バケットに対してアクセス追跡が無効になっている場合

        HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
Date: Wed, 29 Apr 2015 05:21:12 GMT
ETag: "5B3C1A2E053D763E1B002CC607C5****"
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
Content-Length: 344606
Connection: keep-alive
Server: AliyunOSS

      • バケットに対してアクセス追跡が有効になっている場合

        HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
Date: Wed, 29 Apr 2015 05:21:12 GMT
ETag: "5B3C1A2E053D763E1B002CC607C5****"
x-oss-transition-time: Tue, 23 Apr 2024 07:21:42 GMT
x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
Content-Length: 344606
Connection: keep-alive
Server: AliyunOSS

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

      リクエスト例

      GET /example?objectMeta&versionId=CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** HTTP/1.1
Host: versioning-test.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 06:24:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      成功レスポンスの例

      • バケットに対してアクセス追跡が無効になっている場合

        HTTP/1.1 200 OK
x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****
x-oss-request-id: 5CAC3A80B7AEADE0170005F6
Date: Tue, 09 Apr 2019 06:24:00 GMT
ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****"
Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT
Content-Length: 119914
Connection: keep-alive
Server: AliyunOSS

      • バケットに対してアクセス追跡が有効になっている場合

        HTTP/1.1 200 OK
x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****
x-oss-request-id: 5CAC3A80B7AEADE0170005F6
Date: Tue, 09 Apr 2019 06:24:00 GMT
ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****"
x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT
Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT
Content-Length: 119914
Connection: keep-alive
Server: AliyunOSS

    OSS SDK

    次のプログラミング言語の OSS SDK を使用して、GetObjectMeta 操作を呼び出すことができます。

    関連情報

    オブジェクトメタデータの詳細については、「オブジェクトメタデータの管理」をご参照ください。

    エラーコード

    エラーコード

    HTTP ステータスコード

    説明

    Not Found

    404

    指定されたオブジェクトが存在しません。