同步上传下载或拷贝文件 - sync

source_path

源文件路径。可以为本地路径或 COS 文件路径。COS 路径支持使用 配置参数 中的桶别名，或桶名称进行访问。如使用桶名称访问，需要额外携带 endpoint flag。

本地路径：~/example.txt

使用桶别名指定 COS 文件路径：cos://bucketalias/example.txt

使用桶名称指定 COS 文件路径：cos://examplebucket-1250000000/example.txt

destination_path

目的文件路径。可以为本地路径或 COS 文件路径。COS 路径支持使用 配置参数 中的桶别名，或桶名称进行访问。如使用桶名称访问，需要额外携带 endpoint flag。

本地路径：~/example.txt

使用桶别名指定 COS 文件路径：cos://bucketalias/example.txt

使用桶名称指定 COS 文件路径：cos://examplebucket-1250000000/example.txt

无

--include

包含特定模式的文件（v1.0.4之前的版本在上传时仅筛选传入路径下的本地文件路径，v1.0.4以及之后版本会筛选传入的全路径）

例如：需要上传./test 下的所有文件到 COS，./test下包含 aaa 文件夹，aaa 文件夹下包含1.txt文件

1.0.4之前的版本会匹配 aaa/1.txt

1.0.4及之后版本会匹配 ./test/aaa/1.txt

无

--exclude

排除特定模式的文件（v1.0.4之前的版本在上传时仅筛选传入路径下的本地文件路径，v1.0.4以及之后版本会筛选传入的全路径）

例如：需要上传./test 下的所有文件到 COS，./test下包含 aaa 文件夹，aaa 文件夹下包含1.txt文件

1.0.4之前的版本会匹配 aaa/1.txt

1.0.4及之后版本会匹配 ./test/aaa/1.txt

-r

--recursive

是否递归遍历文件夹下所有文件。

无

--storage-class

指定上传文件的存储类型（默认 STANDARD），更多存储类型，请参见 存储类型概述。

无

--part-size

文件的分块大小（默认32MB，最大支持5GB）。如果需要根据文件大小自适应分块大小，请设置为0。

无

--thread-num

文件分块并发线程数（默认并发5）。

无

--rate-limiting

单链接速率限制（0.1 - 100MB/s）。

无

--snapshot-path

指定保存上传或者下载文件时的快照信息所在的目录。在下一次上传或者下载文件时，coscli 会读取指定目录下的快照信息进行增量上传或者下载。本选项用来加速目录文件同步。

无

--meta

上传文件的元信息。包括部分 HTTP 标准属性（HTTP Header）以及以 x-cos-meta- 开头的用户自定义元数据（User Meta）。文件元信息格式为 header:value#header:value，示例为 Expires:2022-10-12T00:00:00.000Z#Cache-Control:no-cache#Content-Encoding:gzip#x-cos-meta-x:x

无

--routines

指定文件间并发上传或下载的线程数量，默认为3。

无

--fail-output

此选项决定是否启用上传或下载失败时文件的错误输出（默认为 true，开启）。如果启用，文件传输失败将被记录在指定目录内（如果没有指定，默认为./coscli_output）。如果禁用，只会将错误文件的数量输出到控制台。

无

--fail-output-path

此选项用于指定记录上传或下载失败文件的错误输出文件夹。通过提供自定义文件夹路径，您可以控制错误输出文件夹的位置和名称。如果未设置此选项，将使用默认的错误日志文件夹./coscli_output。

无

--retry-num

限频重试次数（默认为0，不重试）。可选1-10次。当多台机器同时在同一个COS目录上执行下载操作时，可以通过指定此参数进行重试来规避限频错误。

无

--err-retry-num

错误重试次数（默认为0）。指定1-10次，或者设置为0表示不进行重试。

无

--err-retry-interval

重试间隔（仅在指定--err-retry-num为1-10时可用）。指定1-10秒的重试间隔，如果不指定或设置为0，每次重试间隔将在1-10秒内的随机。

无

--only-current-dir

是否仅上传当前目录中的文件，忽略子目录及其内容（默认为 false，不忽略）。

无

--disable-all-symlink

是否上传时忽略所有软链接子文件和软链接子目录（默认为 true，不上传）。目前仅支持在 Linux 和 macOS 系统上使用。

无

--enable-symlink-dir

是否上传软链接的子目录（默认为 false，不上传）。目前仅支持在 Linux 和 macOS 系统上使用。

无

--disable-crc64

是否关闭 CRC64数据验证（默认为 false，启用验证）。

无

--delete

删除指定目标路径中的任何其他文件，仅保留此次同步的文件（默认为 false，不删除）。建议在使用--delete选项之前启用版本控制，以防止意外删除数据。

无

--backup-dir

同步已删除文件的备份，用于保存目标端已删除但源端不存在的文件(仅下载时生效，且在--delete=true 时必传)。上传及桶拷贝请使用版本控制来恢复意外删除数据。

无

--force

强制操作，不提示确认。（默认为 false）

无

--disable-checksum

默认为 true ，仅校验分片 crc64。当设置为 false，将校验整个文件的 crc64。（coscli V1.0.6以及之前版本默认为 false）

无

--process-log

是否开启进程日志，默认为 true，开启

无

--process-log-path

此选项用于指定一个专用的输出文件夹来存储进程日志。日志将记录与文件上传或下载相关的信息，包括错误日志，正常执行日志，重试等详情。通过提供一个自定义的文件夹路径，您可以控制日志输出文件夹的位置和名称。如果未设置此选项，则将使用默认的日志文件夹（coscli_output）。

无

--update

仅传输修改时间较新的文件

无

--ignore-existing

仅传输不存在的文件

无

--skip-dir

默认为 false，当设置为 true 时传输跳过文件夹。

无

--acl

设置文件的 ACL，例如 private，public-read

无

--grant-read

赋予被授权者读取对象的权限，格式为 id="[OwnerUin]"，例如 id="100000000001"，可使用半角逗号（,）分隔多组被授权者，例如 id="100000000001",id="100000000002"。

无

--grant-read-acp

赋予被授权者读取对象的访问控制列表（ACL）的权限，格式为 id="[OwnerUin]"，例如 id="100000000001"，可使用半角逗号（,）分隔多组被授权者，例如 id="100000000001",id="100000000002"。

无

--grant-write-acp

赋予被授权者写入对象的访问控制列表（ACL）的权限，格式为 id="[OwnerUin]"，例如 id="100000000001"，可使用半角逗号（,）分隔多组被授权者，例如 id="100000000001",id="100000000002"。

无

--grant-full-control

赋予被授权者操作对象的所有权限，格式为 id="[OwnerUin]"，例如 id="100000000001"，可使用半角逗号（,）分隔多组被授权者，例如 id="100000000001",id="100000000002"。

无

--tags

对象的标签集合，最多可设置10个标签（例如，--tags="Key1=Value1&Key2=Value2"）

无

--forbid-overwrite

针对未开启版本控制的存储桶，上传文件时，用于指定上传操作时是否禁止覆盖同名对象：

指定为 false 时，默认覆盖同名 Object。

指定为 true 时，表示禁止覆盖同名 Object。

当存储桶处于已开启或已暂停的版本控制状态时，x-cos-forbid-overwrite 请求头部设置无效，即允许覆盖同名对象。

无

--encryption-type

服务端加密方式（SSE-COS/SSE-C）。

无

--server-side-encryption

服务端加密算法，支持 AES256、cos/kms。

使用 SSE-COS 或 SSE-KMS 时，此字段为必选项

无

--sse-customer-algo

服务端加密算法，支持 AES256。

使用 SSE-C 时，此字段为必选项。

无

--sse-customer-key

服务端加密密钥的 Base64编码。

例如 MDEyMzQ1Njc4OUFCQ0RFRjAxMjM0NTY3ODlBQkNERUY=。

使用 SSE-C 时，此字段为必选项。

无

--sse-customer-key-md5

服务端加密密钥的 MD5哈希值，使用 Base64编码。

例如 U5L61r7jcwdNvT7frmUG8g==。

使用 SSE-C 时，此字段为必选项

无

--check-point

是否开启断点续传，默认为 true，开启断点续传