Skip to main content
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

オブジェクトの処理

共同作成者
PDF

オブジェクトに対して実行する Swift API 処理を次に示します。これらの処理はで追跡できます "StorageGRID 監査ログ"。

オブジェクトを削除します

この処理は、オブジェクトのコンテンツとメタデータを StorageGRID システムから削除します。

次の要求パラメータが必要です。

  • Account

  • Container

  • Object

次の要求ヘッダーが必要です。

  • X-Auth-Token

実行が成功すると、が指定された次の応答ヘッダーが返されます HTTP/1.1 204 No Content 対応：

  • Content-Length

  • Content-Type

  • Date

  • X-Trans-Id

StorageGRID は、 DELETE Object 要求を処理する際に、オブジェクトのすべてのコピーをすべての格納場所からただちに削除しようとします。成功すると、 StorageGRID はただちにクライアントに応答を返します。30秒以内にすべてのコピーを削除できない場合（場所が一時的に使用できない場合など）、StorageGRID は削除対象のコピーをキューに登録し、クライアントに成功を通知します。

詳細については、を参照してください "オブジェクトの削除方法"。

GET オブジェクト

この処理は、 StorageGRID から、オブジェクトのコンテンツを読み出し、オブジェクトメタデータを取得します。

次の要求パラメータが必要です。

  • Account

  • Container

  • Object

次の要求ヘッダーが必要です。

  • X-Auth-Token

次の要求ヘッダーはオプションです。

  • Accept-Encoding

  • If-Match

  • If-Modified-Since

  • If-None-Match

  • If-Unmodified-Since

  • Range

実行が成功すると、が指定された次のヘッダーが返されます HTTP/1.1 200 OK 対応：

  • Accept-Ranges

  • Content-Disposition`の場合にのみ返されます `Content-Disposition メタデータが設定されました

  • Content-Encoding`の場合にのみ返されます `Content-Encoding メタデータが設定されました

  • Content-Length

  • Content-Type

  • Date

  • ETag

  • Last-Modified

  • X-Timestamp

  • X-Trans-Id

HEAD オブジェクト

この処理は、取り込まれたオブジェクトのメタデータとプロパティを StorageGRID システムから読み出します。

次の要求パラメータが必要です。

  • Account

  • Container

  • Object

次の要求ヘッダーが必要です。

  • X-Auth-Token

実行が成功すると、「 HTTP/1.1 200 OK 」の応答とともに次のヘッダーが返されます。

  • Accept-Ranges

  • Content-Disposition`の場合にのみ返されます `Content-Disposition メタデータが設定されました

  • Content-Encoding`の場合にのみ返されます `Content-Encoding メタデータが設定されました

  • Content-Length

  • Content-Type

  • Date

  • ETag

  • Last-Modified

  • X-Timestamp

  • X-Trans-Id

PUT オブジェクト

この処理は、 StorageGRID システムで、データとメタデータを含む新しいオブジェクトを作成するか、データとメタデータを含む既存のオブジェクトを置換します。

StorageGRID では、サイズが 5TiB （ 5 、 497 、 558 、 138 、 880 バイト）までのオブジェクトがサポートされます。

重要 同じキーに書き込む 2 つのクライアントなど、競合するクライアント要求は、「 latest-wins 」ベースで解決されます。「 latest-wins 」評価は、 Swift クライアントが処理を開始するタイミングではなく、 StorageGRID システムが特定の要求を完了したタイミングで行われます。

次の要求パラメータが必要です。

  • Account

  • Container

  • Object

次の要求ヘッダーが必要です。

  • X-Auth-Token

次の要求ヘッダーはオプションです。

  • Content-Disposition

  • Content-Encoding

    chunkedは使用しないでください Content-Encoding 環境 オブジェクトがサイズに基づいてオブジェクトをフィルタリングし、取り込み時に同期配置を使用するILMルール（取り込み動作にBalancedオプションまたはStrictオプション）の場合。

  • Transfer-Encoding

    圧縮やチャンクは使用しないでください Transfer-Encoding 環境 オブジェクトがサイズに基づいてオブジェクトをフィルタリングし、取り込み時に同期配置を使用するILMルール（取り込み動作にBalancedオプションまたはStrictオプション）の場合。

  • Content-Length

    ILMルールで、オブジェクトがサイズでフィルタリングされ、取り込み時に同期配置が使用される場合は、を指定する必要があります Content-Length。

    メモ のこれらのガイドラインに従わない場合 Content-Encoding、 `Transfer-Encoding`および `Content-Length`ではStorageGRID 、オブジェクトのサイズを確認してILMルールを適用する前に、オブジェクトを保存しておく必要があります。つまり、 StorageGRID で取り込み時にデフォルトでオブジェクトの中間コピーを作成する必要があります。つまり、 StorageGRID での取り込み動作には Dual Commit オプションを使用する必要があります。

    同期配置とILMルールの詳細については、を参照してください "取り込みのデータ保護オプション"。

  • Content-Type

  • ETag

  • X-Object-Meta-<name\> （オブジェクト関連のメタデータ）

    ILMルールの参照時間として* User defined creation time *オプションを使用する場合は、というユーザ定義のヘッダーに値を格納する必要があります X-Object-Meta-Creation-Time。例：

    X-Object-Meta-Creation-Time: 1443399726

    このフィールドの値は、 1970 年 1 月 1 日からの秒数となります。

  • X-Storage-Class: reduced_redundancy

    このヘッダーは、取り込まれたオブジェクトに一致する ILM ルールで取り込み動作に Dual Commit または Balanced が指定されている場合に StorageGRID で作成されるオブジェクトコピーの数に影響します。

    • * Dual commit * ： ILM ルールの取り込み動作が Dual commit オプションに指定されている場合は、オブジェクトの取り込み時に StorageGRID が中間コピーを 1 つ作成します（シングルコミット）。

    • * Balanced *：ILMルールでBalancedオプションが指定されている場合、StorageGRID は、ルールで指定されたすべてのコピーをただちに作成できない場合にのみ中間コピーを1つ作成します。StorageGRID で同期配置を実行できる場合、このヘッダーは効果がありません。

      。 reduced_redundancy ヘッダーは、オブジェクトに一致するILMルールで単一のレプリケートコピーが作成される場合に最も適しています。この場合は、を使用します reduced_redundancy 取り込み処理のたびに追加のオブジェクトコピーを不要に作成および削除する必要がなくなります。

      を使用する reduced_redundancy 取り込み中にオブジェクトデータが失われるリスクが高まるため、他の状況ではヘッダーを使用することは推奨されません。たとえば、 ILM 評価の前にコピーが 1 つだけ格納されていたストレージノードに障害が発生すると、データが失われる可能性があります。

      重要 レプリケートコピーを一定期間に 1 つだけ作成すると、データが永続的に失われるリスクがあります。オブジェクトのレプリケートコピーが 1 つしかない場合、ストレージノードに障害が発生したり、重大なエラーが発生すると、そのオブジェクトは失われます。また、アップグレードなどのメンテナンス作業中は、オブジェクトへのアクセスが一時的に失われます。

    を指定することに注意してください reduced_redundancy オブジェクトの初回取り込み時に作成されるコピー数のみに影響します。オブジェクトがアクティブな ILM ポリシーで評価される際に作成されるオブジェクトのコピー数には影響せず、 StorageGRID システムでデータが格納されるときの冗長性レベルが低下することもありません。

実行が成功すると、「 HTTP/1.1 201 Created 」の応答とともに次のヘッダーが返されます。

  • Content-Length

  • Content-Type

  • Date

  • ETag

  • Last-Modified

  • X-Trans-Id