# B2

{% code fullWidth="true" %}

```
名称:
   singularity storage update b2 - Backblaze B2

用法:
   singularity storage update b2 [命令选项] <名称|ID>

描述:
   --account
      账户ID或应用密钥ID。

   --key
      应用密钥。

   --endpoint
      服务的终端点。
      
      通常为空。

   --test-mode
      用于调试的X-Bz-Test-Mode头部的标志字符串。
      
      仅用于调试目的。将其设置为以下字符串之一将导致b2返回特定错误:
      
        * "fail_some_uploads"
        * "expire_some_account_authorization_tokens"
        * "force_cap_exceeded"
      
      这些将在“X-Bz-Test-Mode”头部中设置，该头部在[B2集成检查列表](https://www.backblaze.com/b2/docs/integration_checklist.html)中有文档。

   --versions
      在目录列表中包括旧版本。
      
      请注意，当使用此选项时，不允许进行文件写入操作，因此无法上传文件或删除文件。

   --version-at
      显示指定时间点的文件版本。
      
      请注意，当使用此选项时，不允许进行文件写入操作，因此无法上传文件或删除文件。

   --hard-delete
      在远程删除时永久删除文件，否则隐藏文件。

   --upload-cutoff
      切换到分块上传的大小。
      
      超过此大小的文件将以“--b2-chunk-size”的大小分块上传。
      
      此值不应大于4.657 GiB（== 5 GB）。

   --copy-cutoff
      切换到分段复制的大小。
      
      需要进行的大于此大小的服务器端复制的文件将被分块复制。
      
      最小值为0，最大值为4.6 GiB。

   --chunk-size
      上传块的大小。
      
      当上传大文件时，将文件分成这个大小的块。
      
      必须适应内存。这些块存储在内存中进行缓冲，同时可能有最多“--transfers”个块正在进行中。
      
      5000000字节是最小大小。

   --disable-checksum
      禁用大文件（>上传切换的大小）的校验和。
      
      通常，rclone会在上传之前计算输入的SHA1校验和，以便将其添加到对象的元数据中。这对于数据完整性检查非常有用，但对于大文件的开始上传可能会导致长时间的延迟。

   --download-url
      自定义的下载端点。
      
      这通常设置为Cloudflare CDN URL，因为Backblaze提供通过Cloudflare网络下载数据的免费引流。Rclone与私有存储桶配合使用，通过发送“Authorization”头部进行身份验证。如果自定义的端点对身份验证请求进行了重写，例如在Cloudflare Workers中，需要正确处理此头部。如果要使用Backblaze提供的端点，请保留为空。
      
      此处提供的URL应该具有协议，并且不应该有尾随斜杠或指定/file/bucket子路径，因为rclone将使用“{download_url}/file/{bucket_name}/{path}”请求文件。
      
      示例:
      > https://mysubdomain.mydomain.tld
      (没有尾随斜杠、"file"或"bucket")

   --download-auth-duration
      授权令牌到期前的时间，单位为秒或后缀ms|s|m|h|d。
      
      下载授权令牌到期之前的持续时间。
      最小值为1秒。最大值为一周。

   --memory-pool-flush-time
      内部内存缓冲池刷新的频率。
      需要额外缓冲区的上传（例如多部分）将使用内存池进行分配。
      此选项控制多久未使用的缓冲区将从池中删除。

   --memory-pool-use-mmap
      是否在内部内存池中使用mmap缓冲区。

   --encoding
      后端的编码。
      
      有关更多信息，请参见[总览中的编码部分](/overview/#encoding)。

选项:
   --account value  账户ID或应用密钥ID。[$ACCOUNT]
   --hard-delete    在远程删除时永久删除文件，否则隐藏文件。 (默认: false) [$HARD_DELETE]
   --help, -h       显示帮助
   --key value      应用密钥。[$KEY]

   高级选项

   --chunk-size value              上传块的大小。 (默认: "96Mi") [$CHUNK_SIZE]
   --copy-cutoff value             切换到分段复制的大小。 (默认: "4Gi") [$COPY_CUTOFF]
   --disable-checksum              禁用大文件（>上传切换的大小）的校验和。 (默认: false) [$DISABLE_CHECKSUM]
   --download-auth-duration value  授权令牌到期前的时间，单位为秒或后缀ms|s|m|h|d。 (默认: "1w") [$DOWNLOAD_AUTH_DURATION]
   --download-url value            自定义的下载端点。 [$DOWNLOAD_URL]
   --encoding value                后端的编码。 (默认: "Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot") [$ENCODING]
   --endpoint value                服务的终端点。[$ENDPOINT]
   --memory-pool-flush-time value  内部内存缓冲池刷新的频率。 (默认: "1m0s") [$MEMORY_POOL_FLUSH_TIME]
   --memory-pool-use-mmap          是否在内部内存池中使用mmap缓冲区。 (默认: false) [$MEMORY_POOL_USE_MMAP]
   --test-mode value               用于调试的X-Bz-Test-Mode头部的标志字符串。[$TEST_MODE]
   --upload-cutoff value           切换到分块上传的大小。 (默认: "200Mi") [$UPLOAD_CUTOFF]
   --version-at value              显示指定时间点的文件版本。 (默认: "off") [$VERSION_AT]
   --versions                      在目录列表中包括旧版本。 (默认: false) [$VERSIONS]

```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://data-programs.gitbook.io/singularity/zh/cli-reference/storage/update/b2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.