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

HeadObject

PDF

S3 HeadObject リクエストを使用すると、オブジェクト自体を返さずにオブジェクトからメタデータを取得できます。オブジェクトが Cloud Storage プールに保存されている場合は、HeadObject を使用してオブジェクトの遷移状態を判別できます。

HeadObjectとマルチパートオブジェクト

使用することができます `partNumber`マルチパートまたはセグメント化されたオブジェクトの特定の部分のメタデータを取得するためのリクエスト パラメータ。その `x-amz-mp-parts-count`レスポンス要素は、オブジェクトに含まれるパーツの数を示します。

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

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

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

サポートされているリクエストヘッダー

次のリクエスト ヘッダーがサポートされています。

  • x-amz-checksum-mode

    その `partNumber`パラメータと `Range`ヘッダーはサポートされていません `x-amz-checksum-mode`HeadObject 用。リクエストにそれらを含めると `x-amz-checksum-mode`有効にすると、 StorageGRID は応答でチェックサム値を返しません。

サポートされていないリクエストヘッダー

次のリクエストヘッダーはサポートされていないため、 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 ダイジェストを指定します。

注意 提供された暗号化キーは保存されません。暗号化キーを紛失すると、対応するオブジェクトも失われます。顧客提供のキーを使用してオブジェクトデータを保護する前に、以下の考慮事項を確認してください。"サーバー側の暗号化を使用する" 。

Cloud Storage Pool オブジェクトの HeadObject 応答

オブジェクトが"クラウド ストレージ プール"、次の応答ヘッダーが返されます。

  • x-amz-storage-class: GLACIER

  • x-amz-restore

レスポンス ヘッダーには、オブジェクトが Cloud Storage プールに移動され、オプションで取得不可能な状態に移行され、復元される際のオブジェクトの状態に関する情報が提供されます。

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

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

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

Cloud Storage Pool 内のオブジェクトですが、まだ取得不可の状態に移行していません

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`遠い将来のある時点に設定されています。

注意: グリッド上のコピーが利用できない場合（たとえば、ストレージノードがダウンしている場合）、"オブジェクトの復元"オブジェクトを正常に取得するには、クラウド ストレージ プールからコピーを復元するようにリクエストする必要があります。

オブジェクトは取得不可能な状態に移行し、グリッド上にコピーが存在しません

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 が大きなオブジェクトをセグメントに分割した場合、 StorageGRID はオブジェクトのパートまたはセグメントのサブセットをサンプリングして、オブジェクトが Cloud Storage Pool で使用可能かどうかを判断します。場合によっては、HeadObjectリクエストが誤って返されることがあります。 `x-amz-restore: ongoing-request="false"`オブジェクトの一部がすでに回復不可能な状態に移行している場合、またはオブジェクトの一部がまだ復元されていない場合。

HeadObjectとクロスグリッドレプリケーション

使用している場合"グリッドフェデレーション"そして"クロスグリッドレプリケーション"バケットに対して有効になっている場合、S3 クライアントは HeadObject リクエストを発行してオブジェクトのレプリケーション ステータスを確認できます。応答にはStorageGRID固有の `x-ntap-sg-cgr-replication-status`レスポンス ヘッダーは次のいずれかの値を持ちます。

Grid レプリケーションステータス

ソース

  • 完了: レプリケーションは成功しました。

  • 保留中: オブジェクトはまだ複製されていません。

  • 失敗: レプリケーションは永続的な障害により失敗しました。ユーザーはエラーを解決する必要があります。

デスティネーション

REPLICA: オブジェクトはソース グリッドから複製されました。
メモ StorageGRIDはサポートしていません `x-amz-replication-status`ヘッダ。