可续传上传

C++

storage::Client 中的函数具有不同的行为：

• Client::WriteObject() 始终执行可续传上传。
• Client::InsertObject() 始终执行简单或分段上传。
• Client::UploadFile() 可以执行可续传上传、简单上传或分段上传。

默认情况下，当对象大于 20 MiB 时，UploadFile() 会执行可续传上传。否则，它会执行简单上传或分段上传。您可以在创建 storage::Client 时设置 MaximumSimpleUploadsSizeOption 来配置此阈值。

8 MiB 是默认缓冲区大小，您可以使用 UploadBufferSizeOption 选项进行修改。

C++ 客户端库使用的缓冲区大小等于数据块大小。缓冲区大小必须是 256 KiB（256 x 1024 字节）的倍数。使用 WriteObject() 和 UploadFile() 时，您可能需要考虑上传速度和内存用量之间的权衡。使用小缓冲区上传大型对象可能会导致上传速度变慢。如需详细了解 C++ 的上传速度和缓冲区大小之间的关系，请参阅 GitHub 中的详细分析。

C#

上传时，C# 客户端库始终会执行可续传上传。您可以使用 CreateObjectUploader 启动可续传上传。

C# 客户端库使用的缓冲区大小等于数据块大小。默认缓冲区大小为 10 MB，您可以通过在 UploadObjectOptions 上设置 ChunkSize 更改此值。缓冲区大小必须是 256 KiB（256 x 1024 字节）的倍数。较大的缓冲区大小通常有助于加快上传速度，但请注意，速度和内存用量之间存在权衡。

Go

默认情况下，当文件大于 16 MiB 时，系统会自动进行可续传上传。您可以使用 Writer.ChunkSize 更改执行可续传上传的截止时间。使用 Go 客户端库时，可续传上传始终会进行分块。

当对象小于 Writer.ChunkSize 或 Writer.ChunkSize 设置为 0（停用分块）时，系统会执行分段上传。如果 ChunkSize 设置为 0，则 Writer 无法重试请求。

Go 客户端库使用的缓冲区大小等于数据块大小。缓冲区大小必须是 256 KiB（256 x 1024 字节）的倍数。较大的缓冲区大小通常有助于加快上传速度，但请注意，速度和内存用量之间存在权衡。如果您要同时运行多个可续传上传，则应将 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 方法。缓冲区大小的硬性最小值为 256KiB。在内部调用 WriteChannel#setChunkSize(int) 时，缓冲区大小将调整为 256 KiB 的倍数。

可续传上传的缓冲用作最小 flush 阈值，其中小于缓冲区大小的写入操作会被缓冲，直到写入操作使缓冲字节数超过缓冲区大小为止。

如果上传的数据量较少，请考虑使用 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 1024 字节）的倍数。较大的缓冲区大小通常有助于加快上传速度，但请注意，速度和内存用量之间存在权衡。

PHP

默认情况下，当对象大小超过 5 MB 时，系统会自动进行可续传上传。否则，将进行分段上传。此阈值无法更改。您可以通过在 upload 函数中设置 resumable 选项来强制进行可续传上传。

PHP 客户端库使用的缓冲区大小等于数据块大小。256 KiB 是可续传上传的默认缓冲区大小，您可以通过设置 chunkSize 属性来更改缓冲区大小。缓冲区大小必须是 256 KiB（256 x 1024 字节）的倍数。较大的缓冲区大小通常有助于加快上传速度，但请注意，速度和内存用量之间存在权衡。

Python

当对象大于 8 MiB 时，系统会执行可续传上传；当对象小于 8 MiB 时，系统会执行分段上传。此阈值无法更改。Python 客户端库使用的缓冲区大小等于数据块大小。100 MiB 是可续传上传的默认缓冲区大小，您可以通过设置 blob.chunk_size 属性来更改缓冲区大小。

如需始终执行可续传上传，而不论对象大小如何，请使用 storage.BlobWriter 类或 storage.Blob.open(mode='w') 方法。对于这些方法，默认缓冲区大小为 40 MiB。您还可以使用 Resumable Media 来管理可续传上传。

数据块大小必须是 256 KiB（256 x 1024 字节）的倍数。较大的数据块大小通常可使上传速度更快，但请注意，速度和内存用量之间存在权衡。

Ruby

Ruby 客户端库将所有上传视为未分块的可续传上传。

JSON API

Cloud Storage JSON API 使用包含查询参数 uploadType=resumable 的 POST Object 请求来启动可续传上传。此请求会返回一个会话 URI，您随后可以在一个或多个 PUT Object 请求中使用该 URI 上传对象数据。如需查看有关构建您自己的可续传上传逻辑的分步指南，请参阅执行可续传上传。

XML API

Cloud Storage XML API 使用包含标头 x-goog-resumable: start 的 POST Object 请求来启动可续传上传。此请求会返回一个会话 URI，您随后可以在一个或多个 PUT Object 请求中使用该 URI 上传对象数据。如需查看有关构建您自己的可续传上传逻辑的分步指南，请参阅执行可续传上传。