Drive
名称:
singularity storage update drive - Google Drive
用法:
singularity storage update drive [命令选项] <名称|id>
说明:
--client-id
Google应用程序客户端ID
强烈建议您设置自己的客户端ID。
有关如何创建自己的ID，请参见https://rclone.org/drive/#making-your-own-client-id。
如果留空，将使用内部密钥，性能较低。
--client-secret
OAuth客户端秘钥。
通常留空即可。
--token
OAuth访问令牌（作为JSON blob）。
--auth-url
授权服务器URL。
若要使用提供程序的默认设置，请留空。
--token-url
令牌服务器URL。
若要使用提供程序的默认设置，请留空。
--scope
rclone在请求访问Drive时应使用的范围。
示例：
| drive | 完全访问所有文件，不包括应用数据文件夹。
| drive.readonly | 只读访问文件元数据和文件内容。
| drive.file | 仅访问由rclone创建的文件。
| | 这些文件在Drive网站上可见。
| | 当用户取消对应用的授权时，文件授权将被撤销。
| drive.appfolder | 允许对应用数据文件夹进行读写操作。
| | 这在Drive网站上不可见。
| drive.metadata.readonly | 仅允许对文件元数据进行只读访问，
| | 不允许交互式阅读或下载文件内容。
--root-folder-id
根文件夹的ID。
通常留空。
若要访问“计算机”文件夹（请参见文档），或者要使rclone使用
非根文件夹作为起始点，请填写此字段。
--service-account-file
服务账号凭据JSON文件路径。
通常留空。
只有在希望使用服务账号而不是交互式登录时才需要。
--service-account-credentials
服务账号凭据JSON blob。
通常留空。
只有在希望使用服务账号而不是交互式登录时才需要。
--team-drive
共享Drive的ID。
--auth-owner-only
仅考虑归您拥有的文件。
--use-trash
将文件发送到回收站而非永久删除。
默认为true，即将文件发送到回收站。
使用`--drive-use-trash=false`可永久删除文件。
--copy-shortcut-content
服务器端复制快捷方式的内容，而不是复制快捷方式本身。
在进行服务器端复制时，rclone通常会将快捷方式复制为快捷方式。
如果使用此标志，则在进行服务器端复制时，rclone将复制快捷方式的内容
而不是快捷方式本身。
--skip-gdocs
在所有列表中跳过Google文档。
如果提供此标志，则rclone实际上无法看到gdocs。
--skip-checksum-gphotos
仅在Google照片和视频上跳过MD5校验和。
如果在传输Google照片或视频时出现校验和错误，请使用此选项。
设置此标志将导致Google照片和视频返回空白的MD5校验和。
Google照片通过位于“照片”空间中。
损坏的校验和是由于Google对图像/视频进行修改，
但未更新校验和而导致的。
--shared-with-me
仅显示与我共享的文件。
指示rclone操作您的“与我共享”文件夹（Google Drive上允许您访问其他人与您共享的文件和文件夹的位置）。
这适用于“list”（lsd、lsl等）和“copy”命令（copy、sync等），
以及所有其他命令。
--trashed-only
仅显示处于回收站中的文件。
这将显示回收站中文件的原始目录结构。
--starred-only
仅显示标记为星标的文件。
--formats
已弃用：请参见export_formats。
--export-formats
逗号分隔的首选格式列表，用于下载Google文档。
--import-formats
逗号分隔的首选格式列表，用于上传Google文档。
--allow-import-name-change
允许上传Google文档时更改文件类型。
例如，将file.doc更改为file.docx。每次同步，都会产生混乱并重新上传。
--use-created-date
使用文件的创建日期，而不是修改日期。
在下载数据且希望使用创建日期代替最后修改日期时有用。
**警告**：此标志可能会产生一些意外后果。
当上传到您的Drive时，除非文件自创建以来未被修改，否则将覆盖所有文件。
下载时将发生相反的情况。通过使用"--checksum"标志可以避免这种副作用。
此功能用于保留由Google照片记录的照片捕获日期。
首先，您需要在google drive设置中选中“创建一个Google照片文件夹”选项。
然后，您可以在本地复制或移动照片，并将图片拍摄日期（创建日期）设置为修改日期。
--use-shared-date
使用文件共享日期而不是修改日期。
请注意，与"--drive-use-created-date"一样，此标志可能会产生意外后果
上传/下载文件时。
如果同时设置此标志和"--drive-use-created-date"，则使用创建日期。
--list-chunk
列表块的大小，100-1000，0表示禁用。
--impersonate
使用服务账号时，模拟此用户。
--alternate-export
已弃用：不再需要。
--upload-cutoff
切换到分块上传的阈值。
--chunk-size
上传块的大小。
必须是大于等于256 KB的2的幂。
增加此值将改善性能，但请注意，每个块都会在内存中缓冲一次。
减小此值将减少内存使用，但会降低性能。
--acknowledge-abuse
设置为允许下载返回"cannotDownloadAbusiveFile"错误的文件。
如果下载文件返回错误消息"This file has been identified
as malware or spam and cannot be downloaded"，错误代码为
"cannotDownloadAbusiveFile"，请使用此标志告知rclone你意识到
下载该文件的风险，rclone将继续下载该文件。
请注意，如果您使用的是服务账号，则需要Manager
权限（而不是Content Manager）才能使此标志起作用。如果SA
没有正确的权限，Google将忽略此标志。
--keep-revision-forever
永久保留每个文件的新版副本。
--size-as-quota
将大小显示为存储配额使用情况，而不是实际大小。
将文件的大小显示为已使用的存储配额。这是
当前版本和已设置为永久保留的任何旧版本。
**警告**：此标志可能会产生一些意外后果。
不建议在配置文件中设置此标志-建议仅在进行rclone ls/lsl/lsf/lsjson等操作时使用
`--drive-size-as-quota`标志。
如果要对同步操作使用此标志（不建议），您将需要使用--ignore大小字符串。
--v2-download-min-size
如果对象较大，则使用drive v2 API进行下载。
--pacer-min-sleep
API调用之间的最小休眠时间。
--pacer-burst
允许的API调用次数而无需休眠。
--server-side-across-configs
允许服务器端操作（例如复制）在不同的drive配置之间工作。
如果希望在两个不同的Google Drive之间进行服务器端复制，
则此选项非常有效。请注意，此选项默认情况下是未启用的，
因为无法轻松判断它是否适用于任何两个配置。
--disable-http2
禁止使用http2进行drive。
目前，Google Drive的后端存在无法解决的问题与HTTP/2。
因此，默认情况下禁用了Drive后端的HTTP/2，但可以在此处重新启用。
解决此问题后，将删除此标志。
参见：https://github.com/rclone/rclone/issues/3631
--stop-on-upload-limit
使上传限制错误成为致命错误。
在撰写本文时，每天仅能上传750 GiB的数据到Google Drive（这是一个未记录的限制）。
达到此限制后，Google Drive会生成稍有不同的错误消息。
当设置此标志时，将导致这些错误变成致命错误。
这些错误会停止进行中的同步。
请注意，此检测依赖于Google未记录的错误消息字符串，
因此可能会在将来发生错误。
参见：https://github.com/rclone/rclone/issues/3857
--stop-on-download-limit
使下载限制错误成为致命错误。
在撰写本文时，每天只能从Google Drive下载10 TiB的数据（这是一个未记录的限制）。
达到此限制后，Google Drive会生成稍有不同的错误消息。
当设置此标志时，将导致这些错误变成致命错误。
这些错误会停止进行中的同步。
请注意，此检测依赖于Google未记录的错误消息字符串，
因此可能会在将来发生错误。
--skip-shortcuts
如果设置，跳过快捷方式文件。
通常情况下，rclone会解引用快捷方式文件，使其看起来像原始文件（请参阅[快捷方式部分](#shortcuts)）。
如果设置此标志，则rclone完全会忽略快捷方式文件。
--skip-dangling-shortcuts
如果设置，请跳过挂起的快捷方式文件。
如果设置此标志，则rclone不会在列表中显示任何挂起的快捷方式。
--resource-key
访问共享链接文件的资源密钥。
如果您需要访问通过链接共享的文件，请使用以下一部分作为“root_folder_id”的值
https://drive.google.com/drive/folders/XXX?resourcekey=YYY&usp=sharing
然后，您将需要使用第一部分“XXX”作为“root_folder_id”，使用第二部分“YYY”作为“resource_key”。
否则，当尝试访问目录时，您将收到404错误。
参见：https://developers.google.com/drive/api/guides/resource-keys
此资源密钥要求仅适用于旧文件的子集。
还要注意，只需在Web界面中打开该文件夹一次（使用已通过rclone进行身份验证的用户），
看起来就足够，无需添加资源密钥。
--encoding
后端的编码方式。
有关更多信息，请参见[概览中的编码部分](/overview/#encoding)。
选项:
--alternate-export 已弃用：不再需要。（默认：false）[$ALTERNATE_EXPORT]
--client-id value Google应用程序客户端ID[$CLIENT_ID]
--client-secret value OAuth客户端秘钥[$CLIENT_SECRET]
--help, -h 显示帮助
--scope value rclone在请求Drive访问权限时应使用的范围[$SCOPE]
--service-account-file value 服务账号凭据JSON文件路径[$SERVICE_ACCOUNT_FILE]
高级选项
--acknowledge-abuse 设置为允许下载返回cannotDownloadAbusiveFile的文件。（默认：false）[$ACKNOWLEDGE_ABUSE]
--allow-import-name-change 允许上传Google文档时更改文件类型。（默认：false）[$ALLOW_IMPORT_NAME_CHANGE]
--auth-owner-only 仅考虑归您拥有的文件。（默认：false）[$AUTH_OWNER_ONLY]
--auth-url value 授权服务器URL[$AUTH_URL]
--chunk-size value 上传块的大小。（默认："8Mi"）[$CHUNK_SIZE]
--copy-shortcut-content 服务器端复制快捷方式的内容，而不是复制快捷方式本身。（默认：false）[$COPY_SHORTCUT_CONTENT]
--disable-http2 禁止使用http2进行drive。（默认：true）[$DISABLE_HTTP2]
--encoding value 后端的编码方式。（默认："InvalidUtf8"）[$ENCODING]
--export-formats value 逗号分隔的首选格式列表，用于下载Google文档。（默认："docx,xlsx,pptx,svg"）[$EXPORT_FORMATS]
--formats value 已弃用：请参见export_formats。[$FORMATS]
--impersonate value 使用服务账号时，模拟此用户[$IMPERSONATE]
--import-formats value 逗号分隔的首选格式列表，用于上传Google文档[$IMPORT_FORMATS]
--keep-revision-forever 永久保留每个文件的新版副本。（默认：false）[$KEEP_REVISION_FOREVER]
--list-chunk value 列表块的大小，100-1000，0表示禁用。（默认：1000）[$LIST_CHUNK]
--pacer-burst value 允许的API调用次数而无需休眠。（默认：100）[$PACER_BURST]
--pacer-min-sleep value API调用之间的最小休眠时间。（默认："100ms"）[$PACER_MIN_SLEEP]
--resource-key value 访问通过链接共享的文件的资源密钥[$RESOURCE_KEY]
--root-folder-id value 根文件夹的ID[$ROOT_FOLDER_ID]
--server-side-across-configs 允许服务器端操作（例如复制）在不同的drive配置之间工作。（默认：false）[$SERVER_SIDE_ACROSS_CONFIGS]
--service-account-credentials value 服务账号凭据JSON blob[$SERVICE_ACCOUNT_CREDENTIALS]
--shared-with-me 仅显示与我共享的文件。（默认：false）[$SHARED_WITH_ME]
--size-as-quota 将大小显示为存储配额使用情况，而不是实际大小。（默认：false）[$SIZE_AS_QUOTA]
--skip-checksum-gphotos 仅在Google照片和视频上跳过MD5校验和。（默认：false）[$SKIP_CHECKSUM_GPHOTOS]
--skip-dangling-shortcuts 如果设置，请跳过挂起的快捷方式文件。（默认：false）[$SKIP_DANGLING_SHORTCUTS]
--skip-gdocs 在所有列表中跳过Google文档。（默认：false）[$SKIP_GDOCS]
--skip-shortcuts 如果设置，请跳过快捷方式文件。（默认：false）[$SKIP_SHORTCUTS]
--starred-only 仅显示标记为星标的文件。（默认：false）[$STARRED_ONLY]
--stop-on-download-limit 使下载限制错误成为致命错误。（默认：false）[$STOP_ON_DOWNLOAD_LIMIT]
--stop-on-upload-limit 使上传限制错误成为致命错误。（默认：false）[$STOP_ON_UPLOAD_LIMIT]
--team-drive value 共享Drive的ID[$TEAM_DRIVE]
--token value OAuth访问令牌（作为JSON blob）[$TOKEN]
--token-url value 令牌服务器URL[$TOKEN_URL]
--trashed-only 仅显示处于回收站中的文件。（默认：false）[$TRASHED_ONLY]
--upload-cutoff value 切换到分块上传的阈值。（默认："8Mi"）[$UPLOAD_CUTOFF]
--use-created-date 使用文件的创建日期，而不是修改日期。（默认：false）[$USE_CREATED_DATE]
--use-shared-date 使用文件共享日期而不是修改日期。（默认：false）[$USE_SHARED_DATE]
--use-trash 将文件发送到回收站而非永久删除。（默认：true）[$USE_TRASH]
--v2-download-min-size value 如果对象较大，则使用drive v2 API进行下载。（默认："off"）[$V2_DOWNLOAD_MIN_SIZE]
Last updated