tencent cloud

文档反馈

上传下载或拷贝文件 - cp

最后更新时间:2024-01-06 15:54:24
    cp 命令用于上传、下载或拷贝文件。

    命令格式

    ./coscli cp <source_path> <destination_path> [flags]
    cp 命令包含以下参数:
    参数格式
    参数用途
    示例
    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
    cp 命令包含以下可选 flag:
    flag 简写
    flag 全称
    flag 用途
    --include
    包含特定模式的文件
    --exclude
    排除特定模式的文件
    -r
    --recursive
    是否递归遍历文件夹下所有文件
    --storage-class
    指定上传文件的存储类型(默认 STANDARD),更多存储类型,请参见 存储类型概述
    --part-size
    文件分块大小(默认32MB),单位MB
    --thread-num
    并发线程数(默认并发5)
    --rate-limiting
    单链接速率限制(0.1~100MB/s),单位MB/s
    --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
    说明
    cp 命令在上传和下载大文件时会自动启用并发上传/下载。
    当文件大于 --part-size 时,COSCLI 会先将文件按 --part-size 进行切块,之后用 --thread-num 个线程并发地执行上传/下载任务。
    每个线程都会维护一个链接,对于每个链接,您可以使用 --rate-limiting 参数对单链接进行限速,当启用并发上传/下载时,总速率为 --thread-num * --rate-limiting
    当以分块形式上传/下载文件时,会默认开启断点续传。
    --include--exclude 支持标准正则表达式的语法,您可以使用它来过滤出符合特定条件的文件。
    使用 zsh 时,您可能需要在 pattern 串的两端加上双引号。``plaintext ./coscli cp ~/test/ cos://bucket1/example/ -r --include ".*.txt" --meta=x-cos-meta-a:a#ContentType:text#Expires:2022-10-12T00:00:00.000Z``> - 关于此命令的其他通用选项(例如切换存储桶、切换用户账号等),请参见 通用选项 文档。

    操作示例

    上传操作

    上传单文件

    ./coscli cp ~/example.txt cos://bucket1/example.txt

    将本地 test 文件夹下的所有文件上传至 bucket1 桶中的 example 文件夹下

    ./coscli cp ~/test/ cos://bucket1/example/ -r

    将本地 test 文件夹下的所有 .mp4 类型文件上传至 bucket1 桶中的 example 文件夹下

    ./coscli cp ~/test/ cos://bucket1/example/ -r --include .*.mp4

    将本地 test 文件夹下的所有非 .md 类型文件上传至 bucket1 桶中的 example 文件夹下

    ./coscli cp ~/test/ cos://bucket1/example/ -r --exclude .*.md

    将本地 dir 文件夹下有 dirA、dirB、dirC、dirD 四个文件夹,将 dir 文件夹下除 dirD 文件夹之外的所有内容上传

    ./coscli cp dir/ cos://bucket1/example/ -r --exclude dirD/.*

    将本地 test 文件夹下的所有文件上传至 bucket1 桶中的 example 文件夹下,并以归档类型文件存储

    ./coscli cp ~/test/ cos://bucket1/example/ -r --storage-class ARCHIVE

    将本地的 file.txt 文件上传至 bucket1 桶并设置单链接速率限制为1.3MB/s

    ./coscli cp ~/file.txt cos://bucket1/file.txt --rate-limiting 1.3

    下载操作

    下载单文件

    ./coscli cp cos://bucket1/example.txt ~/example.txt

    将 bucket1 桶中的 example 文件夹下的所有文件下载到本地 test 文件夹下

    ./coscli cp cos://bucket1/example/ ~/test/ -r

    将 bucket1 桶中的 example 文件夹下所有 .mp4 类型文件下载至本地 test 文件夹下

    ./coscli cp cos://bucket1/example/ ~/test/ -r --include .*.mp4

    将 bucket1 桶中的 example 文件夹下所有非 .md 类型文件下载至本地 test 文件夹

    ./coscli cp cos://bucket1/example/ ~/test/ -r --exclude .*.md

    拷贝操作

    桶内拷贝单文件

    ./coscli cp cos://bucket1/example.txt cos://bucket1/example_copy.txt

    跨桶拷贝单文件

    ./coscli cp cos://bucket1/example.txt cos://bucket2/example_copy.txt

    将 bucket1 桶中 example1 文件夹下的所有文件拷贝至 bucket2 桶中 example2 文件夹下

    ./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r

    将 bucket1 桶中 example1 文件夹下的所有 .mp4 类型文件拷贝至 bucket2 桶中 example2 文件夹下

    ./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r --include .*.mp4

    将 bucket1 桶中的 example1 文件夹下所有非 .md 类型文件拷贝至 bucket2 桶中 example2 文件夹下

    ./coscli cp cos://bucket1/example1/ cos://bucket2/example2/ -r --exclude .*.md
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持