GetObjectMeta を呼び出してオブジェクトのメタデータを取得する - Object Storage Service

GetObjectMeta 操作を呼び出して、オブジェクトのメタデータを取得します。メタデータには、オブジェクトの ETag、サイズ、最終更新時刻が含まれます。オブジェクトのコンテンツは返されません。

注意事項

説明

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

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

バージョン管理

デフォルトでは、GetObjectMeta 操作はオブジェクトのカレントバージョンのメタデータを取得します。オブジェクトのカレントバージョンが削除マーカーの場合、404 Not Found エラーが返されます。リクエストで versionId を指定すると、指定したバージョンのメタデータが返されます。

リクエスト構文

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 (エンティティタグ) が生成されます。 PutObject リクエストによって作成されたオブジェクトの場合、ETag はそのコンテンツの MD5 ハッシュです。他のメソッドで作成されたオブジェクトの場合、ETag は一意の値ですが、コンテンツの MD5 ハッシュではありません。ETag を使用して、オブジェクトのコンテンツが変更されたかどうかを確認できます。データ整合性を検証するために MD5 検証に ETag を使用しないでください。デフォルト値: なし
x-oss-transition-time	String	Tue, 23 Apr 2024 07:21:42 GMT	ライフサイクルルールによってオブジェクトが Cold Archive または Deep Cold Archive ストレージクラスに変換された時刻。説明変換後 180 日を超えて Cold Archive または Deep Cold Archive オブジェクトを削除した場合、早期削除料金は請求されません。変換後 180 日以内にオブジェクトを削除した場合、早期削除料金が請求されます。このフィールドは、ライフサイクルルールによってオブジェクトが低頻度アクセス (IA) またはアーカイブストレージクラスに変換された時刻を判断するために使用することはできません。低頻度アクセス (IA) またはアーカイブオブジェクトが最短ストレージ期間の要件を満たすかどうかは、`Last-Modified` 時刻によって決まります。
x-oss-last-access-time	String	Tue, 30 Mar 2021 06:07:48 GMT	オブジェクトの最終アクセス時刻。時刻は HTTP 1.1 で指定されている GMT 形式です。アクセス追跡が有効な場合、オブジェクトがアクセスされるとこのフィールドの値が更新されます。アクセス追跡が無効な場合、このフィールドは返されません。重要オブジェクトの最終アクセス時刻は非同期で更新されます。OSS は通常、24 時間以内にオブジェクトの最終アクセス時刻を更新します。24 時間以内にオブジェクトが複数回アクセスされた場合、OSS は最も早いアクセス時刻のみを更新します。
Last-Modified	String	Fri, 24 Feb 2012 06:07:48 GMT	オブジェクトが最後に変更された時刻。時刻は HTTP 1.1 で指定されている GMT 形式です。説明低頻度アクセスストレージクラスのオブジェクトの最短ストレージ期間は 30 日です。期間はオブジェクトの Last-Modified 時刻から計算されます。Last-Modified 時刻から 30 日を超えてオブジェクトを削除した場合、早期削除料金は請求されません。アーカイブストレージクラスのオブジェクトの最短ストレージ期間は 60 日です。期間はオブジェクトの Last-Modified 時刻から計算されます。Last-Modified 時刻から 60 日を超えてオブジェクトを削除した場合、早期削除料金は請求されません。
x-oss-version-id	String	CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****	オブジェクトのバージョン ID。このフィールドは、オブジェクトの特定のバージョンのメタデータを取得する場合にのみ返されます。
x-oss-sealed-time	String	Sat, 11 Oct 2025 06:41:42 GMT	シール状態の追加可能オブジェクトに対してシール操作が実行された時刻。時刻は HTTP 1.1 で指定されている GMT 形式です。このフィールドは、シールされた追加可能オブジェクトにアクセスする場合にのみ返されます。

この操作では、共通レスポンスヘッダーも使用します。詳細については、「共通レスポンスヘッダー」をご参照ください。

例

バージョン管理が無効

リクエスト例

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

SDK

この操作は、次のソフトウェア開発キット (SDK) を使用して呼び出すことができます:

コマンドラインインターフェイス ossutil

GetObjectMeta 操作に対応する ossutil コマンドについては、「get-object-meta」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
Not Found	404	指定されたオブジェクトは存在しません。

Object Storage Service:GetObjectMeta