オブジェクトの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
参考資料
オブジェクトメタデータの詳細については、「オブジェクトメタデータの管理」をご参照ください。
エラーコード
エラーコード | HTTPステータスコード | 説明 |
Not Found | 404 | 指定されたオブジェクトは存在しません。 |