# B2

{% code fullWidth="true" %}

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

用法:
   singularity storage create b2 [命令选项] [参数...]

描述:
   --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](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]

   通用选项

   --name value  存储的名称（默认值：自动生成）
   --path value  存储的路径

```

{% 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/create/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.