Coscmd-使用指南

一、安装coscmd

如果你是使用python环境的开发者，那么可以通过pip命令来安装coscmd，如果你想使用源码安装coscmd，那么可以通过以下命令安装：

git clone https://github.com/tencentyun/coscmd.git

cd coscmd

python setup.py install

无论你采用哪种方式，只需几个简单的命令，即可完成coscmd的安装。

二、coscmd配置

在我们开始使用coscmd之前，需要先配置好coscmd，首先需要创建一个腾讯云账号，然后在控制台中找到您的COS Bucket，在该控制台中生成访问密钥和SecretKey，为了保证安全，请保存好调用凭证信息。

在coscmd中的配置文件存放在~/.cos.conf文件中，第一次使用Coscmd时需要配置您的密钥信息，通过以下命令进行Coscmd初始化：

coscmd config -a SecretId -s SecretKey -b BucketName -r BucketRegion

根据这个命令，您可以为Coscmd添加访问密钥、压缩包存放路径、分片大小等其他可选参数，这些参数可以在管理控制台中查找。安装后coscmd会在您的主目录中生成.cos.conf配置文件。

三、coscmd命令详解

1.coscmd list

coscmd list – 显示Cos桶中所有的文件。

coscmd list

2.coscmd upload

coscmd upload – 转存本地文件到指定的Cos桶中。

coscmd upload local_filePath cos://BucketName[/prefix] [-rsf] [-m x] [--rsa,key=value] [--headers,key=value]

其中，参数local_filePath表示本地文件路径；-rsf表示显示进度；-m参数表示上传文件的分块大小；–rsa、–headers表示可选参数。

3.coscmd download

coscmd download – 下载指定的Cos对象到本地机器上。

coscmd download cos://BucketName[/prefix]/file local_filePath [-rsf] [-m x]

其中，参数local_filePath表示本地文件路径；-rsf表示显示进度；-m参数表示下载文件的分块大小。

4.coscmd delete

coscmd delete – 删除指定的Cos对象。

coscmd delete cos://BucketName[/prefix]/file

5.coscmd create-bucket

coscmd create-bucket – 创建存储桶。

coscmd create-bucket BucketName [-r BucketRegion] [-a ACL]

您可以通过该命令创建新的存储桶并可选设置存储桶地区和存储桶访问权限。

6.coscmd update-bucket-acl

coscmd update-bucket-acl – 更改存储桶权限。

coscmd update-bucket-acl BucketName [-a ACL]

您可以使用以下命令来更改存储桶的ACL：

-F PRIVATE：无法通过除存储桶拥有者之外的任何其他人连接存储桶。

-F PUBLIC-READ：任何人都可以查看存储桶中的对象，但只有存储桶拥有者可以进行更改。

-F PUBLIC-DELETE：任何人都可以查看并删除存储桶中的对象，但是只有存储桶拥有者可以更改存储桶。

7.coscmd update-bucket-cors

coscmd update-bucket-cors – 更改存储桶跨域访问规则。

coscmd update-bucket-cors BucketName -c "CORS规则"

您可以使用以下命令来修改存储桶的CORS：

-c "CORS规则"

8.coscmd update-bucket-tagging

coscmd update-bucket-tagging – 给存储桶添加标签。

coscmd update-bucket-tagging BucketName [--tags,tags=[key=value]]

您可以使用以下命令来为存储桶添加标签：

--tags,tags=[key1=value1,key2=value2]