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

Object Storage Service:GetObjectMeta

最終更新日:Feb 23, 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
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue 

リクエストヘッダー

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

レスポンスヘッダー

レスポンスヘッダー

データ型

説明

Content-Length

String

344606

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

ETag

String

5B3C1A2E053D763E1B002CC607C5 ****

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

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

デフォルトでは、このパラメータは空のままです。

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時間である必要があります。

x-oss-version-id

String

CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk ****

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

この要求に対する応答は、共通の応答ヘッダを含む。 詳細については、「共通レスポンスヘッダー」をご参照ください。

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

    リクエストの例

    HEAD /oss.jpg?objectMeta HTTP/1.1
    ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
    日付: 4月29日水曜日05:21:12 GMT 2015
    承認: OSS qn6qrrqxo2oawuk53otf ****:CTkuxpLAi4XZ + WwIfNm0Fmgb **** 

    レスポンスの例

    重要

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

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

      HTTP/1.1 200 OK
      x-oss-request-id: 559CC9BDC755F95A6448 ****
      日付: 4月29日水曜日05:21:12 GMT 2015
      ETag: "5B3C1A2E053D763E1B002CC607C5 ****"
      最終変更: 2月24日金曜日2012 06:07:48 GMT
      コンテンツ-長さ: 344606
      接続: キープアライブ
      サーバー: AliyunOSS 
    • バケットのアクセス追跡が有効になっている場合

      HTTP/1.1 200 OK
      x-oss-request-id: 559CC9BDC755F95A6448 ****
      日付: 4月29日水曜日05:21:12 GMT 2015
      ETag: "5B3C1A2E053D763E1B002CC607C5 ****"
      x-oss-last-access-time: 10月14日木曜日2021時11:49:05 GMT
      最終変更: 2月24日金曜日2012 06:07:48 GMT
      コンテンツ-長さ: 344606
      接続: キープアライブ
      サーバー: AliyunOSS 
  • バージョン管理が有効なバケット内のオブジェクトのメタデータを照会する

    リクエストの例

    GET /example?objectMeta&versionId=CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk **** HTTP/1.1
    ホスト: versioning-test.oss-cn-hangzhou.aliyuncs.com
    日付: 4月2019日火曜日06:24:00 GMT
    承認: OSS 5n4nrhyqrcs ****:i/M/c36KzrOEA/bBSHLllIAt **** 

    レスポンスの例

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

      HTTP/1.1 200 OK
      x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk ****
      x-oss-request-id: 5CAC3A80B7AEADE0170005F6
      日付: 4月2019日火曜日06:24:00 GMT
      ETag: "1CF5A685959CA2ED8DE6E5F8ACC2 ****"
      最終変更: 4月2019日火曜日06:24:00 GMT
      コンテンツ-長さ: 119914
      接続: キープアライブ
      サーバー: AliyunOSS 
    • バケットのアクセス追跡が有効になっている場合

      HTTP/1.1 200 OK
      x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk ****
      x-oss-request-id: 5CAC3A80B7AEADE0170005F6
      日付: 4月2019日火曜日06:24:00 GMT
      ETag: "1CF5A685959CA2ED8DE6E5F8ACC2 ****"
      x-oss-last-access-time: 10月14日木曜日2021時11:49:05 GMT
      最終変更: 4月2019日火曜日06:24:00 GMT
      コンテンツ-長さ: 119914
      接続: キープアライブ
      サーバー: AliyunOSS 

OSS SDK

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

参考資料

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

エラーコード

エラーコード

HTTPステータスコード

説明

Not Found

404

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