日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

HEAD Object の実行

05/18/2023 共同作成者

S3 HEAD Object 要求を使用すると、オブジェクト自体を返さずにオブジェクトからメタデータを読み出すことができます。オブジェクトがクラウドストレージプールに格納されている場合は、 HEAD Object を使用してオブジェクトの移行状態を特定できます。

HEAD オブジェクトおよびマルチパートオブジェクト

を使用できます partNumber マルチパートまたはセグメント化されたオブジェクトの特定の部分のメタデータを読み出す要求パラメータ。。 x-amz-mp-parts-count response要素は、オブジェクトに含まれるパーツの数を示します。

設定できます partNumber セグメント化されたオブジェクト/マルチパートオブジェクトとセグメント化されていないオブジェクト/マルチパート以外のオブジェクトの場合は1。ただし、 x-amz-mp-parts-count 応答要素は、セグメント化されたオブジェクトまたはマルチパートオブジェクトの場合にのみ返されます。

ユーザメタデータ内の UTF-8 文字

StorageGRID は、ユーザ定義メタデータ内のエスケープされた UTF-8 文字を解析も解釈もしません。ユーザ定義メタデータにエスケープされたUTF-8文字が含まれているオブジェクトに対するHEAD要求では、が返されません x-amz-missing-meta キーの名前または値に印刷できない文字が含まれている場合は、ヘッダーを指定します。

サポートされない要求ヘッダーです

次の要求ヘッダーはサポートされていません XNotImplemented：

x-amz-website-redirect-location

バージョン管理

の場合 versionId サブリソースが指定されていません。バージョン管理されたバケット内のオブジェクトの最新バージョンが取得されます。オブジェクトの現在のバージョンが削除マーカーの場合は、「見つからない」ステータスがとともに返されます x-amz-delete-marker 応答ヘッダーをに設定しました true。

ユーザ指定の暗号化キーによるサーバ側の暗号化（ SSE-C ）の要求ヘッダー

指定した一意のキーでオブジェクトが暗号化されている場合は、次の 3 つのヘッダーをすべて使用します。

x-amz-server-side-encryption-customer-algorithm:指定します AES256。
x-amz-server-side-encryption-customer-key:オブジェクトの暗号化キーを指定します
x-amz-server-side-encryption-customer-key-MD5:オブジェクトの暗号化キーのMD5ダイジェストを指定します。

指定した暗号化キーが格納されることはありません。暗号化キーを紛失すると、対応するオブジェクトが失われます。ユーザ指定のキーを使用してオブジェクトデータを保護する前に、の考慮事項を確認してください "サーバ側の暗号化を使用します"。

クラウドストレージプールオブジェクトに対するHEAD Object応答

オブジェクトがに格納されている場合 "クラウドストレージプール"を指定すると、次の応答ヘッダーが返されます。

x-amz-storage-class: GLACIER
x-amz-restore

応答ヘッダーは、オブジェクトがクラウドストレージプールに移動され、必要に応じて読み出し不可能な状態に移行されてリストアされるときの状態に関する情報を提供します。

オブジェクトの状態 HEAD Object への応答

オブジェクトの状態	HEAD Object への応答
StorageGRID に取り込まれているがまだ ILM によって評価されていないオブジェクト、または従来のストレージプールに格納されているオブジェクト、またはイレイジャーコーディングを使用しているオブジェクト	`200 OK` （特別な応答ヘッダーは返されません）。
クラウドストレージプール内にあるが、まだ読み出し不可能な状態に移行していない	`200 OK` `x-amz-storage-class: GLACIER` `x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2030 00:00:00 GMT"` オブジェクトが読み出し不可能な状態に移行されるまでの間、の値 `expiry-date` は、将来の特定の日時に設定されます。移行の正確な時間は、 StorageGRID システムでは制御されません。
オブジェクトが読み出し不可能な状態に移行したが、少なくとも 1 つのコピーがグリッドに存在する	`200 OK` `x-amz-storage-class: GLACIER` `x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2030 00:00:00 GMT"` の値 `expiry-date` は、将来の特定の日時に設定されます。注：グリッド上のコピーを使用できない場合（ストレージノードが停止している場合など）は、問題を実行する必要があります "POST Object restore の実行" オブジェクトを読み出す前にクラウドストレージプールからコピーをリストアする要求。
読み出し不可能な状態に移行しており、グリッドにコピーが存在しない	`200 OK` `x-amz-storage-class: GLACIER`
読み出し不可能な状態からリストア中である	`200 OK` `x-amz-storage-class: GLACIER` `x-amz-restore: ongoing-request="true"`
クラウドストレージプールへのリストアが完了している	`200 OK` `x-amz-storage-class: GLACIER` `x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2018 00:00:00 GMT"` 。 `expiry-date` クラウドストレージプール内のオブジェクトが読み出し不可能な状態に戻るタイミングを示します。

StorageGRID に取り込まれているがまだ ILM によって評価されていないオブジェクト、または従来のストレージプールに格納されているオブジェクト、またはイレイジャーコーディングを使用しているオブジェクト

200 OK （特別な応答ヘッダーは返されません）。

クラウドストレージプール内にあるが、まだ読み出し不可能な状態に移行していない

200 OK