# Dropbox

{% code fullWidth="true" %}

```
NAME:
   singularity storage update dropbox - Dropbox

USAGE:
   singularity storage update dropbox [命令选项] <名称|ID>

DESCRIPTION:
   --client-id
      OAuth 客户端 ID。
      
      通常留空。

   --client-secret
      OAuth 客户端密钥。
      
      通常留空。

   --token
      OAuth 访问令牌的 JSON 对象。

   --auth-url
      认证服务器 URL。
      
      如果留空，则使用提供者的默认设置。

   --token-url
      令牌服务器 URL。
      
      如果留空，则使用提供者的默认设置。

   --chunk-size
      上传分片大小（< 150Mi）。
      
      所有大于此大小的文件将被分片上传。
      
      请注意，分片会在内存中进行缓冲（每次只有一个），以便 rclone 可以进行重试。
      增大此值会稍微提高速度（在测试中对于 128 MiB 至多提高 10%），但会增加内存使用量。
      如果内存不足，可以减小此值。

   --impersonate
      在使用企业账户时冒名顶替此用户。
      
      请注意，如果要使用冒名顶替功能，应确保在运行 "rclone config" 时设置此标志，
      因为这将导致 rclone 请求 "members.read" 作用域，而这是通常不会请求的。
      这是为了将成员的电子邮件地址查找为 Dropbox 在 API 中使用的内部 ID。
      
      使用 "members.read" 作用域将需要 Dropbox 团队管理员在 OAuth 流程中进行批准。
      
      要使用此选项，您必须使用自己的应用程序（设置自己的 client_id 和 client_secret），
      因为 rclone 的默认权限集中不包括 "members.read"。
      一旦 everywhere 都在使用 v1.55 或更高版本后，可以添加此权限。

   --shared-files
      指示 rclone 处理单个共享文件。
      
      在此模式下，rclone 的功能非常有限 - 仅支持列表（ls，lsl 等）操作和读取操作（例如下载）。
      在此模式下，所有其他操作将被禁用。

   --shared-folders
      指示 rclone 处理共享文件夹。
      
      当此标志与无路径一起使用时，仅支持列表操作，并列出所有可用的共享文件夹。
      如果指定了路径，则第一部分将被解释为共享文件夹的名称。
      然后，rclone 将尝试将此共享文件夹挂载到根命名空间。
      如果成功，rclone 将继续正常进行。此时共享文件夹基本上就是普通文件夹，支持所有正常操作。
      
      请注意，我们不会在之后卸载共享文件夹，因此之后可以省略 --shared-folders 标志，
      除非使用特定共享文件夹的第一个用法。

   --batch-mode
      文件批处理上传的模式 sync|async|off。
      
      这设置了 rclone 使用的批处理模式。
      
      有 3 种可能的值：
      
      - off - 不使用批处理
      - sync - 批处理上传并检查完成（默认值）
      - async - 批处理上传并不检查完成
      
      当 rclone 退出时，它将关闭任何未完成的批处理，这可能会造成一些延迟。

   --batch-size
      上传批处理中的文件最大数量。
      
      这设置了要上传的文件的批处理大小。
      它必须小于 1000。
      
      默认值为 0，这意味着 rclone 会根据 batch_mode 的设置计算批处理大小。
      
      - batch_mode: async - 默认 batch_size 为 100
      - batch_mode: sync - 默认 batch_size 与 --transfers 相同
      - batch_mode: off - 不使用
      
      当您上传大量的小文件时，设置此值是个好主意，因为它会加快上传速度。
      您可以使用 --transfers 32 来最大化吞吐量。

   --batch-timeout
      允许一个空闲的上传批处理最长时间后再上传。
      
      如果一个上传批处理空闲时间超过此值，它将被上传。
      
      默认值为 0，这意味着 rclone 将根据所使用的 batch_mode 选择合适的默认值。
      
      - batch_mode: async - 默认 batch_timeout 为 500ms
      - batch_mode: sync - 默认 batch_timeout 为 10s
      - batch_mode: off - 不使用

   --batch-commit-timeout
      等待批处理完成提交的最长时间

   --encoding
      后端的编码方式。
      
      有关详细信息，请参见[概述中的编码部分](/overview/#encoding)。

OPTIONS:
   --client-id value      OAuth 客户端 ID。[$CLIENT_ID]
   --client-secret value  OAuth 客户端密钥。[$CLIENT_SECRET]
   --help, -h             显示帮助信息

   高级选项

   --auth-url value              认证服务器 URL。[$AUTH_URL]
   --batch-commit-timeout value  等待批处理完成提交的最长时间（默认值："10m0s"）[$BATCH_COMMIT_TIMEOUT]
   --batch-mode value            文件批处理上传的模式 sync|async|off（默认值："sync"）[$BATCH_MODE]
   --batch-size value            上传批处理中的文件最大数量（默认值：0）[$BATCH_SIZE]
   --batch-timeout value         允许一个空闲的上传批处理最长时间后再上传（默认值："0s"）[$BATCH_TIMEOUT]
   --chunk-size value            上传分片大小（< 150Mi）（默认值："48Mi"）[$CHUNK_SIZE]
   --encoding value              后端的编码方式（默认值："Slash,BackSlash,Del,RightSpace,InvalidUtf8,Dot"）[$ENCODING]
   --impersonate value           在使用企业账户时冒名顶替此用户。[$IMPERSONATE]
   --shared-files                指示 rclone 处理单个共享文件（默认值：false）[$SHARED_FILES]
   --shared-folders              指示 rclone 处理共享文件夹（默认值：false）[$SHARED_FOLDERS]
   --token value                 OAuth 访问令牌的 JSON 对象。[$TOKEN]
   --token-url value             令牌服务器 URL。[$TOKEN_URL]

```

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