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

HEAD Object の実行

共同作成者
PDF

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

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

「 PartNumber 」要求パラメータを使用すると、マルチパートオブジェクトまたはセグメント化されたオブジェクトの特定の部分のメタデータを取得できます。「 x-amz-mp-parts-count 」応答要素は、オブジェクトのパーツ数を示します。

セグメント化された / マルチパートオブジェクトとセグメント化されていない / 非マルチパートオブジェクトの両方に対して「 PartNumber 」を 1 に設定できますが、「 x-amz-mp-parts-count 」応答要素はセグメント化されたオブジェクトまたはマルチパートオブジェクトに対してのみ返されます。

ユーザ指定の暗号化キーによるサーバ側の暗号化（ 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 ダイジェストを指定します。

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

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

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

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

次の要求ヘッダーはサポートされていません。指定した場合は "XNotImplemented " が返されます。

  • 「 x-amz-website redirect-location 」

クラウドストレージプールオブジェクトの応答ヘッダー

オブジェクトがクラウドストレージプールに格納されている場合（情報ライフサイクル管理を使用してオブジェクトを管理する手順を参照）、次の応答ヘッダーが返されます。

  • x-amz-storage-class ： Glacier

  • x-amz-restore のように指定します

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

オブジェクトの状態 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 20203000:00:00:00GMT

オブジェクトが読み出し不可能な状態に移行されるまで、「 expiry-date 」の値は将来の日時に設定されます。移行の正確な時間は、 StorageGRID システムでは制御されません。

オブジェクトが読み出し不可能な状態に移行したが、少なくとも 1 つのコピーがグリッドに存在する

「 200 OK 」

x-amz-storage-class ： Glacier

x-amz-restore ： Ongoing - request="false" 、 expiry-date ="Sat 、 23 July 20 20203000:00:00:00GMT

「 expiry-date 」の値は、将来の日時に設定されます。

  • 注：グリッド上のコピーを取得できない場合（ストレージノードが停止している場合など）は、オブジェクトを読み出す前に、問題 a 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:00 ： 00 GMT

「 expiry-date 」は、クラウドストレージプール内のオブジェクトが読み出し不可能な状態に戻るタイミングを示します。

クラウドストレージプール内のマルチパートオブジェクトまたはセグメント化されたオブジェクト

マルチパートオブジェクトをアップロードした場合や StorageGRID が大きなオブジェクトをセグメントに分割した場合、 StorageGRID はオブジェクトのパーツまたはセグメントのサブセットをサンプリングすることでクラウドストレージプール内のオブジェクトが使用可能かどうかを判断します。オブジェクトの一部のパートがすでに読み出し不可能な状態に移行されている場合や、オブジェクトの一部のパートがまだリストアされていない場合は、 HEAD Object 要求が誤って「 x-amz-restore ： ongoing-request="false" 」を返すことがあります。

バージョン管理

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

関連情報

サーバ側の暗号化を使用します

ILM を使用してオブジェクトを管理する

POST Object restore の実行

監査ログで追跡される S3 処理