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

GetObject

共同作成者
PDF

S3 GetObject要求を使用すると、S3バケットからオブジェクトを読み出すことができます。

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

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

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

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

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

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

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

  • x-amz-website-redirect-location

バージョン管理

の場合 versionId サブリソースが指定されていません。バージョン管理されたバケット内のオブジェクトの最新バージョンが取得されます。オブジェクトの現在のバージョンが削除マーカーの場合は、「Not Found」ステータスが 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ダイジェストを指定します。

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

クラウドストレージプールオブジェクトに対するGetObjectの動作

オブジェクトがに格納されている場合 "クラウドストレージプール"の場合、GetObject要求の動作はオブジェクトの状態によって異なります。を参照してください "HeadObject （ヘッドオブジェクト）" 詳細：

メモ オブジェクトがクラウドストレージプールに格納されていて、そのオブジェクトのコピーがグリッドに1つ以上存在する場合、GetObject要求はクラウドストレージプールからデータを読み出す前にグリッドからデータを読み出そうとします。
オブジェクトの状態 GetObjectの動作

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

200 OK

オブジェクトのコピーが読み出されます。

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

200 OK

オブジェクトのコピーが読み出されます。

オブジェクトを読み出し不可能な状態に移行した

403 Forbidden、 InvalidObjectState

を使用します "RestoreObject" 読み出し可能な状態へのオブジェクトのリストア要求。

読み出し不可能な状態からリストア中である

403 Forbidden、 InvalidObjectState

RestoreObject要求が完了するまで待ちます。

クラウドストレージプールへのリストアが完了している

200 OK

オブジェクトのコピーが読み出されます。

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

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

このような場合は、次のよう

  • GetObject要求から一部のデータが返される場合がありますが、転送の途中で停止することがあります。

  • 後続のGetObject要求で次のように返されることがある 403 Forbidden。

GetObjectとグリッド間レプリケーション

使用するポート "グリッドフェデレーション" および "グリッド間レプリケーション" バケットで有効になっている場合、S3クライアントはGetObject要求を発行してオブジェクトのレプリケーションステータスを確認できます。応答にはStorageGRID固有の情報が含まれます x-ntap-sg-cgr-replication-status 応答ヘッダー。次のいずれかの値が設定されます。

グリッド（ Grid ） レプリケーションのステータス

ソース

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

  • * pending*：オブジェクトはまだレプリケートされていません。

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

宛先

replica:オブジェクトはソースグリッドからレプリケートされました。
メモ StorageGRID ではがサポートされません x-amz-replication-status ヘッダー。