オブジェクトメタデータを照会します。 この操作を呼び出すと、オブジェクトの内容は応答で返されません。
バージョン管理
既定では、HeadObject操作を呼び出してオブジェクトのメタデータを照会し、リクエストにバージョンIDを指定しない場合、オブジェクトの現在のバージョンのメタデータが返されます。 オブジェクトの現在のバージョンが削除マーカーである場合、object Storage Service (OSS) はHTTPステータスコード404とNoSuchKeyエラーコードを返します。
HeadObject操作を呼び出してオブジェクトのメタデータを照会し、リクエストにバージョンIDを指定すると、指定したバージョンのオブジェクトのメタデータが返されます。 HeadObjectリクエストで削除マーカーのバージョンIDを指定すると、OSSはHTTPステータスコード405とMethodNotAllowedエラーコードを返します。
リクエスト構文
HEAD /ObjectName HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue
リクエストヘッダー
ヘッダー | データ型 | 必須 | 説明 |
If-Modified-Since | String | 任意 | 情報の戻り条件。 指定された時刻がオブジェクトの最後に変更された時刻より前の場合、OSSはオブジェクトのメタデータを返し、OKを200します。 それ以外の場合、OSSはHTTPステータスコード304とNotModifiedエラーコードを返します。 デフォルトでは、このヘッダーは空のままです。 |
If-Unmodified-Since | String | 任意 | 情報の戻り条件。 指定された時間がオブジェクトの最終変更時刻以降の場合、OSSはオブジェクトのメタデータを返し、OKを200します。 それ以外の場合、OSSはHTTPステータスコード412とPreconditionFailedエラーコードを返します。 デフォルトでは、このヘッダーは空のままです。 |
If-Match | String | 任意 | 情報の戻り条件。 入力ETag値がオブジェクトのETag値と一致する場合、OSSはオブジェクトのメタデータを返し、OKを200します。 それ以外の場合、OSSはHTTPステータスコード412とPreconditionFailedエラーコードを返します。 デフォルトでは、このヘッダーは空のままです。 |
If-None-マッチ | String | 任意 | 情報の戻り条件。 入力ETag値がオブジェクトのETag値と一致しない場合、OSSはオブジェクトのメタデータを返し、OKを200します。 それ以外の場合、OSSはHTTPステータスコード304とNotModifiedエラーコードを返します。 デフォルトでは、このヘッダーは空のままです。 |
HeadObjectリクエストの一般的なリクエストヘッダー (ホストや日付など) の詳細については、「一般的なリクエストヘッダー」をご参照ください。
レスポンスヘッダー
リクエストされたオブジェクトがシンボリックリンクの場合は、レスポンスの次のヘッダーに注意してください。
Content-Length、ETag、x-oss-storage-class、およびContent-Md5ヘッダーは、シンボリックリンクが指すオブジェクトのメタデータです。
Last-Modifiedヘッダーの戻り値は、シンボリックリンクの最終変更時刻またはシンボリックリンクが指すオブジェクトの最終変更時刻のいずれか遅い方を使用します。
その他のレスポンスヘッダーは、シンボリックリンクのメタデータです。
ヘッダー | データ型 | 説明 |
x-oss-meta-* | String | プレフィックスがx-oss-meta-のカスタムヘッダー。 これらのヘッダーはユーザーメタデータを記述します。 PutObjectリクエストの先頭にx-oss-meta-が付いたヘッダーを指定すると、オブジェクトのユーザーメタデータがレスポンスに含まれます。 |
x-oss-meta-が付いていないカスタムヘッダー | String | PutObjectリクエストの先頭にx-oss-metaが付いていないヘッダーを指定した場合、ヘッダーはレスポンスに含まれます。 例: x-oss-persistent-headers: key1:base64_encode(value1),key2:base64_encode(value2).... |
x-oss-server-side-encryption | String | サーバー側でオブジェクトを暗号化するために使用されるアルゴリズム。 このヘッダは、エントロピー符号化に基づくサーバ側暗号化アルゴリズムを使用することによってオブジェクトが暗号化される場合、応答に含まれる。 |
x-oss-server-side-encryption-key-id | String | オブジェクトの暗号化に使用される顧客マスターキー (CMK) のID。 このヘッダーは、サーバー側でキー管理サービス (KMS) を使用してオブジェクトが暗号化されている場合、レスポンスに含まれます。 |
x-oss-storage-class | String | オブジェクトのストレージクラス。 有効な値: Standard、IA、Archive、ColdArchive、およびDeepColdArchive。 ストレージクラスの詳細については、「概要」をご参照ください。 |
x-oss-object-type | String | オブジェクトのタイプです。 有効な値:
|
x-oss-next-append-position | String | 次の追加操作の位置。The position for the next append operation. オブジェクトのタイプがAppendableの場合、このヘッダーはレスポンスに含まれます。 |
x-oss-hash-crc64ecma | String | オブジェクトの64ビットCRC値。 この値は、ECMA-182 標準に基づいて計算されます。 OSSがCRC-64をサポートする前にオブジェクトが作成された場合、HeadObject操作を呼び出してオブジェクトのメタデータを照会するときに、このヘッダーがレスポンスに含まれないことがあります。 |
x-oss-expiration | String | ライフサイクルルールが設定されているバケット内のオブジェクトの有効期限。
|
x-oss-restore | String | オブジェクトを復元するときのオブジェクトのステータス。 RestoreObjectリクエストがアーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトに対して送信された場合、このヘッダーがレスポンスに含まれます。
|
x-oss-process-status | String | オブジェクトに対してトリガーされたイベント通知の結果。 Message Service (MNS) を使用してOSSイベント通知ルールを作成し、オブジェクトに対して実行された操作がルールをトリガーする場合、このヘッダーがレスポンスに含まれます。 このヘッダーの戻り値はJSON形式でBase64-encodedされます。 |
x-oss-request-charged | String | リクエスタ。 このヘッダーは、pay-by-requesterモードがバケットに対して有効であり、要求者がバケット所有者でない場合に、応答に含まれます。 このヘッダーの値はrequesterです。 |
コンテンツ-Md5 | String |
|
Last-Modified | String | オブジェクトが最後に変更された時刻。 時刻はHTTP/1.1で指定されたGMTです。 |
アクセス制御-許可-オリジン | String | オリジンは、クロスオリジンリソース共有 (CORS) に許可されています。 オブジェクトを格納するバケットにCORSルールが設定されており、リクエストのOriginヘッダーがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。 |
アクセス制御-許可-メソッド | String | CORSに許可された方法。 オブジェクトを格納するバケットに対してCORSルールが設定されており、リクエスト内のAccess-Control-Request-MethodヘッダーがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。 |
アクセス制御-Max-Age | String | CORSの最大キャッシュ期間。 オブジェクトを格納するバケットにCORSルールが設定されており、リクエストがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。 |
アクセス制御-許可ヘッダー | String | CORSに許可されているヘッダー。 オブジェクトを格納するバケットにCORSルールが設定されており、リクエストがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。 |
アクセス制御-公開ヘッダー | String | クライアント上のJavaScriptアプリケーションがアクセスできるヘッダー。 オブジェクトを格納するバケットにCORSルールが設定されており、リクエストがCORSルールを満たしている場合、このヘッダーはレスポンスに含まれます。 |
x-oss-tagging-count | String | オブジェクトに追加されたタグの数。 このヘッダーは、タグの読み取り権限がある場合にのみレスポンスに含まれます。 |
HeadObjectリクエストへのレスポンスのETagやx-oss-request-idなどの一般的なレスポンスヘッダーの詳細については、「一般的なレスポンスヘッダー」をご参照ください。
例
バージョン化されていないバケット内のオブジェクトのメタデータの照会
リクエストの例
HEAD /oss.jpg HTTP/1.1 ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com 日付: 8月7日金曜日2020 07:32:52 GMT 権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:JbzF2LxZUtanlJ5dLA092wpD ****
オブジェクトのサンプル応答
HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A6448 **** x-oss-object-type: Normal x-oss-storage-class: アーカイブ 日付: 8月7日金曜日2020 07:32:52 GMT 最終変更: 2月24日金曜日2012 06:07:48 GMT ETag: "fba9dede5f27731c9771645a3986 ****" コンテンツ-長さ: 344606 コンテンツタイプ: image/jpg 接続: キープアライブ サーバー: AliyunOSS
ディレクトリのサンプル応答
HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A6448 **** x-oss-object-type: Normal x-oss-storage-class: 標準 日付: 3月31日水2021 07:32:52 GMT 最終変更: 3月30日2021日火曜日06:07:48 GMT ETag: "null" コンテンツ長: 0 Content-Type: application/x-directory 接続: キープアライブ サーバー: AliyunOSS
バージョン管理が有効なバケット内のオブジェクトの特定のバージョンのメタデータを照会する
リクエストの例
HEAD /example?versionId=CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYy **** ホスト: versioning-test.oss-cn-hangzhou.aliyuncs.com 日付: 8月7日金曜日2020 06:27:12 GMT 承認: OSS ryghu9rp3mqp1ya:RvyjGvKxaUhdF0ibyEwX5mOM ****
レスポンスの例
HTTP/1.1 200 OK x-oss-versionId: CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYy **** x-oss-request-id: 5CAC3B40B7AEADE01700 **** x-oss-object-type: Normal x-oss-storage-class: アーカイブ 日付: 8月7日金曜日2020 06:27:12 GMT 最終変更: 8月7日金曜日2020 06:27:12 GMT ETag: "A082B659EF78733A5A042FA253B1 ****" コンテンツ-長さ: 481827 コンテンツタイプ: text/html 接続: キープアライブ サーバー: AliyunOSS
バージョン管理が有効なバケット内のオブジェクトの現在のバージョンのメタデータを照会する
リクエストの例
HEAD /例HTTP/1.1 ホスト: versioning-test.oss-cn-hangzhou.aliyuncs.com 日付: 8月7日金曜日2020 06:27:12 GMT 承認: OSS ryghu9rp3mqp1ya:RvyjGvKxaUhdF0ibyEwX5mOM ****
レスポンスの例
HTTP/1.1 200 OK x-oss-versionId: CAEQMxiBgMCZov2D0BYiIDY4MDllOTc2YmY5MjQxMzdiOGI3OTlhNTU0ODIx **** x-oss-request-id: 5CAC3B40B7AEADE01700 **** x-oss-object-type: Normal x-oss-storage-class: アーカイブ 日付: 8月7日金曜日2020 06:27:12 GMT 最終変更: 8月7日金曜日2020 06:27:12 GMT ETag: "3663F7B0B9D3153F884C821E7CF4 ****" コンテンツ-長さ: 485859 コンテンツタイプ: text/html 接続: キープアライブ サーバー: AliyunOSS
RestoreObjectリクエストが送信され、復元が進行中のオブジェクトのメタデータを照会します。
リクエストの例
HEAD /oss.jpg HTTP/1.1 ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com 日付: 8月7日金曜日2020 07:32:52 GMT 権限付与: OSS e1Unnbm1rgdnpI:KKxkdNrUBu2t1kqlDh0MLbDb ****
レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 58F71A164529F18D7F00 **** x-oss-object-type: Normal x-oss-storage-class: アーカイブ x-oss-restore: 継続的-要求="true" 日付: 8月7日金曜日2020 07:32:52 GMT 最終変更: 8月7日金曜日2020 06:07:48 GMT ETag: "fba9dede5f27731c9771645a3986 ****" コンテンツ-長さ: 344606 コンテンツタイプ: image/jpg 接続: キープアライブ サーバー: AliyunOSS
RestoreObjectリクエストが送信され、復元が完了したオブジェクトのメタデータを照会します。
リクエストの例
HEAD /oss.jpg HTTP/1.1 ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com 日付: 8月7日金曜日2020 09:35:51 GMT 承認: OSS e1Unnbm1rgdnpI:21qtGJ + ykDVmdu6O6FMJnn + W ****
レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 58F725344529F18D7F00 **** x-oss-object-type: Normal x-oss-storage-class: アーカイブ x-oss-restore: 継続的な要求="false" 、有効期限="Sun、4月16日08:12:33 GMT" 2017 日付: 8月7日金曜日2020 09:35:51 GMT 最終変更: 8月7日金曜日2020 06:07:48 GMT ETag: "fba9dede5f27731c9771645a3986 ****" コンテンツ-長さ: 344606
SSE-OSSを使用して暗号化されたオブジェクトのメタデータを照会する
リクエストの例
HEAD /oss.jpg HTTP/1.1 ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com 日付: 8月7日金曜日2020 07:32:52 GMT 権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:JbzF2LxZUtanlJ5dLA092wpD ****
レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A6448 **** x-oss-object-type: Normal x-oss-storage-class: アーカイブ x-oss-server-side-encryption: AES256 日付: 8月7日金曜日2020 07:32:52 GMT 最終変更: 8月7日金曜日2020 06:07:48 GMT ETag: "fba9dede5f27731c9771645a3986 ****" コンテンツ-長さ: 344606 コンテンツタイプ: image/jpg 接続: キープアライブ サーバー: AliyunOSS
SSE-KMSを使用して暗号化されたオブジェクトのメタデータを照会する
リクエストの例
HEAD /oss.jpg HTTP/1.1 ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com 日付: 8月7日金曜日2020 07:32:52 GMT 権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:JbzF2LxZUtanlJ5dLA092wpD ****
レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A64485981 x-oss-object-type: Normal x-oss-storage-class: アーカイブ x-oss-server-side-encryption: KMS x-oss-server-side-encryption-key-id: 9468da86-3509-4f8d-a61e-6eab1eac **** 日付: 8月7日金曜日2020 07:32:52 GMT 最終変更: 8月7日金曜日2020 06:07:48 GMT ETag: "fba9dede5f27731c9771645a3986 ****" コンテンツ-長さ: 344606 コンテンツタイプ: image/jpg 接続: キープアライブ サーバー: AliyunOSS
エラーコード
エラーコード | HTTPステータスコード | 説明 |
NoSuchKey | 404 | リクエストされたオブジェクトは存在しません。 |
SymlinkTargetNotExist | 404 | 要求されたオブジェクトはシンボリックリンクです。 |
InvalidTargetType | 400 | 要求されたオブジェクトは、別のシンボリックリンクを指すシンボリックリンクである。 |
NotModified | 304 | 考えられる原因:
|
PreconditionFailed | 412 | 考えられる原因:
|