再開可能なアップロード

C++

storage::Client の関数は、さまざまな動作を実行します。

• Client::WriteObject() は常に再開可能なアップロードを実行します。
• Client::InsertObject() は常に単純なアップロードまたはマルチパート アップロードを実行します。
• Client::UploadFile() は、再開可能なアップロード、単純なアップロード、マルチパート アップロードを実行できます。

デフォルトでは、オブジェクトが 20 MiB を超えると、UploadFile() は再開可能なアップロードを実行します。それ以外の場合は、単純なアップロードまたはマルチパート アップロードを実行します。このしきい値は、storage::Client の作成時に MaximumSimpleUploadsSizeOption を設定することで構成できます。

デフォルトのバッファサイズは 8 MiB です。これは、UploadBufferSizeOption オプションで変更できます。

C++ クライアント ライブラリは、チャンクサイズと同じバッファサイズを使用します。バッファサイズは 256 KiB（256 x 1,024 バイト）の倍数にする必要があります。WriteObject() と UploadFile() を使用する場合は、アップロード速度とメモリ使用量のトレードオフを考慮することをおすすめします。サイズの小さいバッファを使用して大きなオブジェクトをアップロードすると、アップロードに時間がかかる可能性があります。C++ のアップロード速度とバッファサイズの関係については、GitHub の詳細な分析をご覧ください。

C#

アップロード時に、C# クライアント ライブラリは常に再開可能なアップロードを実行します。CreateObjectUploader で再開可能なアップロードを開始できます。

C# クライアント ライブラリは、チャンクサイズと同じバッファサイズを使用します。デフォルトのバッファサイズは 10 MB です。この値は、UploadObjectOptions で ChunkSize を設定することで変更できます。バッファサイズは 256 KiB（256 x 1,024 バイト）の倍数にする必要があります。通常、バッファサイズを大きくするとアップロードが速くなりますが、速度とメモリ使用量の間にトレードオフがあることに注意してください。

Go

デフォルトでは、ファイルが 16 MiB を超えると、再開可能なアップロードが自動的に行われます。Writer.ChunkSize を使用して再開可能なアップロードを実行する場合のカットオフを変更します。Go クライアント ライブラリを使用すると、再開可能なアップロードは常にチャンク形式となります。

マルチパート アップロードでは、オブジェクトが Writer.ChunkSize より小さい場合、または Writer.ChunkSize が 0 に設定されている場合、チャンクが無効になります。ChunkSize が 0 に設定されている場合、Writer はリクエストを再試行できません。

Go クライアント ライブラリは、チャンクサイズと同じバッファサイズを使用します。バッファサイズは 256 KiB（256 x 1,024 バイト）の倍数にする必要があります。通常、バッファサイズを大きくするとアップロードが速くなりますが、速度とメモリ使用量の間にトレードオフがあることに注意してください。複数の再開可能なアップロードを同時に実行する場合は、メモリの肥大化を避けるため、Writer.ChunkSize を 16 MiB 未満の値に設定する必要があります。

Writer.Close() を呼び出して成功のレスポンスを受け取るまで、オブジェクトは Cloud Storage でファイナライズされません。リクエストが失敗した場合、Writer.Close はエラーを返します。

Java

Java クライアント ライブラリには、マルチパート アップロードと再開可能なアップロードに別々のメソッドがあります。次のメソッドでは、常に再開可能なアップロードを実行します。

• Storage#createFrom(BlobInfo, java.io.InputStream, Storage.BlobWriteOption...)
• Storage#createFrom(BlobInfo, java.io.InputStream, int, Storage.BlobWriteOption...)
• Storage#createFrom(BlobInfo, java.nio.file.Path, Storage.BlobWriteOption...)
• Storage#createFrom(BlobInfo, java.nio.file.Path, int, Storage.BlobWriteOption...)
• Storage#writer(BlobInfo, Storage.BlobWriteOption...)
• Storage#writer(java.net.URL)

デフォルトのバッファサイズは 15 MiB です。バッファサイズは、WriteChannel#setChunkSize(int) メソッドを使用するか、bufferSize パラメータを Storage#createFrom メソッドに渡すことで設定できます。バッファサイズの最小値は 256 KiB です。WriteChannel#setChunkSize(int) を内部で呼び出すと、バッファサイズは 256 KiB の倍数になります。

再開可能なアップロードのバッファリングは最小の埋め込みしきい値として機能し、バッファリングされた書き込みのバイト数がバッファサイズを超えるまで、バッファサイズより小さい書き込みはバッファリングされます。

アップロードするデータの量が少ない場合は、Storage#create(BlobInfo, byte[], Storage.BlobTargetOption...) または Storage#create(BlobInfo, byte[], int, int, Storage.BlobTargetOption...) の使用を検討してください。

Node.js

再開可能なアップロードは自動的に行われます。再開可能なアップロードをオフにするには、UploadOptions で resumable を false に設定します。createWriteStream メソッドを使用している場合、再開可能なアップロードは自動的に管理されます。

デフォルトのバッファサイズはありません。チャンク形式アップロードは、CreateResumableUploadOptions の chunkSize オプションを指定して手動で呼び出す必要があります。chunkSize を指定すると、データは個別の HTTP リクエストで送信されます。各リクエストには chunkSize サイズのペイロードが含まれます。chunkSize が指定されず、ライブラリが再開可能なアップロードを実行している場合、すべてのデータは単一の HTTP リクエストにストリーミングされます。

Node.js クライアント ライブラリは、チャンクサイズと同じバッファサイズを使用します。バッファサイズは 256 KiB（256 x 1,024 バイト）の倍数にする必要があります。通常、バッファサイズを大きくするとアップロードが速くなりますが、速度とメモリ使用量の間にトレードオフがあることに注意してください。

PHP

デフォルトでは、オブジェクト サイズが 5 MB を超えると、再開可能なアップロードが自動的に行われます。それ以外の場合は、マルチパート アップロードが行われます。このしきい値は変更できません。upload 関数で resumable オプションを設定すると、再開可能なアップロードを強制できます。

PHP クライアント ライブラリは、チャンクサイズと同じバッファサイズを使用します。再開可能なアップロードのデフォルトのバッファサイズは 256 KiB です。このバッファサイズは、chunkSize プロパティを設定することで変更できます。バッファサイズは 256 KiB（256 x 1,024 バイト）の倍数にする必要があります。通常、バッファサイズを大きくするとアップロードが速くなりますが、速度とメモリ使用量の間にトレードオフがあることに注意してください。

Python

再開可能なアップロードはオブジェクトが 8 MiB より大きい場合に行われ、マルチパート アップロードはオブジェクトが 8 MiB より小さい場合に行われます。このしきい値は変更できません。Python クライアント ライブラリは、チャンクサイズと同じバッファサイズを使用します。100 MiB は、再開可能なアップロードに使用されるデフォルトのバッファサイズです。バッファサイズは、blob.chunk_size プロパティを設定すると変更できます。

オブジェクトのサイズに関係なく、再開可能なアップロードを実行するには、クラス storage.BlobWriter またはメソッド storage.Blob.open(mode='w') を使用します。これらのメソッドの場合、デフォルトのバッファサイズは 40 MiB です。再開可能なメディアを使用して、再開可能なアップロードを管理することもできます。

チャンクサイズは 256 KiB（256 x 1,024 バイト）の倍数にする必要があります。通常、チャンクサイズが大きくなるとアップロードが速くなりますが、速度とメモリ使用量にはトレードオフがあります。

Ruby

Ruby クライアント ライブラリでは、すべてのアップロードがチャンク化されていない再開可能なアップロードとして処理されます。

JSON API

Cloud Storage JSON API は、クエリ パラメータ uploadType=resumable を含む POST Object リクエストを使用して再開可能なアップロードを開始します。このリクエストは、セッション URI として返され、その後 1 つ以上の PUT Object リクエストでオブジェクト データをアップロードするために使用します。再開可能なアップロード用の独自のロジックを作成する詳しい手順については、再開可能なアップロードの実行をご覧ください。

XML API

Cloud Storage XML API は、ヘッダー x-goog-resumable: start を含む POST Object リクエストを使用して再開可能なアップロードを開始します。このリクエストは、セッション URI として返され、その後 1 つ以上の PUT Object リクエストでオブジェクト データをアップロードするために使用します。再開可能なアップロード用の独自のロジックを作成する詳しい手順については、再開可能なアップロードの実行をご覧ください。