HEAD Object の実行
S3 HEAD Object 要求を使用すると、オブジェクト自体を返さずにオブジェクトからメタデータを読み出すことができます。オブジェクトがクラウドストレージプールに格納されている場合は、 HEAD Object を使用してオブジェクトの移行状態を特定できます。
ユーザ指定の暗号化キーによるサーバ側の暗号化( 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 によって評価されていないオブジェクト、または従来のストレージプールに格納されているオブジェクト、またはイレイジャーコーディングを使用しているオブジェクト |
|
クラウドストレージプール内にあるが、まだ読み出し不可能な状態に移行していない |
オブジェクトが読み出し不可能な状態に移行されるまでの間、の値 |
オブジェクトが読み出し不可能な状態に移行したが、少なくとも 1 つのコピーがグリッドに存在する |
の値
|
読み出し不可能な状態に移行しており、グリッドにコピーが存在しない |
|
読み出し不可能な状態からリストア中である |
|
クラウドストレージプールへのリストアが完了している |
。 |
クラウドストレージプール内のマルチパートオブジェクトまたはセグメント化されたオブジェクト
マルチパートオブジェクトをアップロードした場合や StorageGRID が大きなオブジェクトをセグメントに分割した場合、 StorageGRID はオブジェクトのパーツまたはセグメントのサブセットをサンプリングすることでクラウドストレージプール内のオブジェクトが使用可能かどうかを判断します。HEAD Object要求が誤って返されることがあります x-amz-restore: ongoing-request="false"
オブジェクトの一部のパートがすでに読み出し不可能な状態に移行されている場合や、オブジェクトの一部のパートがまだリストアされていない場合。
バージョン管理
の場合 versionId
サブリソースが指定されていません。バージョン管理されたバケット内のオブジェクトの最新バージョンが取得されます。オブジェクトの現在のバージョンが削除マーカーの場合は、「見つからない」ステータスがとともに返されます x-amz-delete-marker
応答ヘッダーをに設定しました true
。