すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetObjectMeta

    ドキュメントセンター

    Object Storage Service:GetObjectMeta

    最終更新日:Oct 30, 2024

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

    使用上の注意

    説明

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

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

    バージョン管理

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

    リクエストの構造

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

    リクエストヘッダー

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

    レスポンスパラメーター

    レスポンスヘッダー

    タイプ

    例

    説明

    Content-Length

    String

    344606

    オブジェクトのサイズ。 単位はバイトです。

    ETag

    String

    5B3C1A2E053D763E1B002CC607C5 ****

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

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

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

    x-oss-transition-time

    String

    4月2024日火曜日07:21:42 GMT

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

    説明

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

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

    x-oss-last-access-time

    String

    3月30日火曜日2021 06:07:48 GMT

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

    重要

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

    Last-Modified

    String

    2月24日金曜日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: OSS qn6q**************:77Dv****************

      正常に処理された場合のレスポンス例

      重要

      バケットの階層名前空間を有効にした後に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: OSS qn6q**************:77Dv****************

      正常に処理された場合のレスポンス例

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

        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

    SDK

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

    参考情報

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

    エラーコード

    エラーコード

    HTTPステータスコード

    説明

    Not Found

    404

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