Initiate Multipart Upload

Initiate Multipart Upload処理は、オブジェクトのマルチパートアップロードを開始し、アップロードIDを返します。

x-amz-storage-class要求ヘッダーがサポートされています。x-amz-storage-classで送信される値はStorageGRIDが取り込み時にオブジェクトデータを保護する方法に影響し、StorageGRIDシステムに格納されるオブジェクトの永続的コピーの数（ILMで決定）には影響しません。

取り込まれたオブジェクトに一致するILMルールの取り込み動作がStrictオプションに指定されている場合、x-amz-storage-classヘッダーの値は無視されます。

x-amz-storage-classには次の値を使用できます。

STANDARD（デフォルト）
- Dual commit：ILMルールの取り込み動作がDual commitオプションに指定されている場合は、オブジェクトの取り込み直後にオブジェクトの2つ目のコピーが作成されて別のストレージノードに配置されます（デュアルコミット）。ILMが評価されると、この初期中間コピーがルールの配置手順を満たしているかどうかをStorageGRIDが判断します。満たしていない場合は、新しいオブジェクトコピーを別の場所に作成し、初期中間コピーを削除することが必要になる可能性があります。
- Balanced：ILMルールでBalancedオプションが指定されていて、ルールで指定されたすべてのコピーをStorageGRIDがただちに作成できない場合、StorageGRIDは2つの中間コピーを別々のストレージノードに作成します。
  
  ILMルールで指定されたすべてのオブジェクトコピーをStorageGRIDがただちに作成できる（同期配置）場合は、x-amz-storage-classヘッダーの値は無視されます。
REDUCED_REDUNDANCY
- Dual commit：ILMルールの取り込み動作がDual commitオプションに指定されている場合は、オブジェクトの取り込み時にStorageGRIDが中間コピーを1つ作成します（シングルコミット）。
- Balanced：ILMルールでBalancedオプションが指定されている場合、StorageGRIDは、ルールで指定されたすべてのコピーをただちに作成できない場合にのみ、中間コピーを1つ作成します。StorageGRIDで同期配置を実行できる場合、このヘッダーは無視されます。
オブジェクトに一致するILMルールが単一のレプリケートコピーを作成する場合は、REDUCED_REDUNDANCYオプションの使用を推奨します。REDUCED_REDUNDANCYを使用すると、取り込み処理のたびに追加のオブジェクトコピーを不必要に作成および削除する必要がなくなります。

それ以外の場合にREDUCED_REDUNDANCYオプションを使用することは推奨されません。REDUCED_REDUNDANCYを指定すると、取り込み中にオブジェクトデータが失われるリスクが高まります。たとえば、最初にストレージノードにコピーが1つだけ格納されていて、ILM評価の前にこのノードで障害が発生した場合、データが失われる可能性があります。

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

注:S3準拠バケットにオブジェクトを取り込む場合は、REDUCED_REDUNDANCYオプションは使用できません。これは、アクティブなILMポリシーによるオブジェクトの評価の前に、コンプライアンス要件を満たす（各オブジェクトのコピーが2つある）ようにするためです。StorageGRIDの管理手順を参照してください。

次の要求ヘッダーがサポートされています。

Content-Type
x-amz-meta-、ユーザ定義のメタデータを含む名前と値のペアが続く
ユーザ定義のメタデータの名前と値のペアを指定する場合、一般的な形式は次のとおりです。
```
x-amz-meta-name: value
```
ILMルールの参照時間に[User Defined Creation Time]オプションを使用する場合、オブジェクトの作成時間を記録するメタデータの名前には、creation-timeを使用する必要があります。次に例を示します。
```
x-amz-meta-creation-time: 1443399726
```
creation-timeの値は、1970年1月1日を起点とした秒数として評価されます。
注:S3準拠バケットにオブジェクトを追加する場合は、ユーザ定義のメタデータとしてcreation-timeを追加することはできません。エラーが返されます。

注:StorageGRIDでのUTF-8文字の処理については、PUT Objectに関するドキュメントを参照してください。

サーバ側の暗号化を行うための要求ヘッダー

マルチパートオブジェクトをサーバ側の暗号化で暗号化するには、次の要求ヘッダーを使用します。SSEオプションとSSE-Cオプションを同時に指定することはできません。

SSE：StorageGRIDで管理される一意のキーでオブジェクトを暗号化する場合は、Initiate Multipart Upload要求で次のヘッダーを使用します。Upload Part要求ではこのヘッダーを指定しないでください。
- x-amz-server-side-encryption
SSE-C：ユーザが指定および管理する一意のキーでオブジェクトを暗号化する場合は、Initiate Multipart Upload要求（および後続の各Upload Part要求）で、次の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ダイジェストを指定します。
注意:指定した暗号化キーがどこかに格納されることはありません。暗号化キーを紛失すると、対応するオブジェクトが失われます。ユーザ指定のキーを使用してオブジェクトデータを保護する場合は、事前に「サーバ側の暗号化の使用」に記載されている考慮事項を確認してください。

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

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

x-amz-website-redirect-location

バージョン管理

マルチパートアップロードは、アップロードの開始、アップロードのリストの表示、パートのアップロード、アップロードしたパートのアセンブル、およびアップロードの完了の個別の処理に分けられます。Complete Multipart Upload処理が実行されると、オブジェクトが作成されます（該当する場合はバージョン管理されます）。