对象存储BOS

    配置BOSCLI

    通用配置

    配置支持中文显示的CLI环境

    如需要配置支持中文显示的CLI环境,请执行如下命令配置:

    $ export LANG=en_US.UTF-8

    说明:可先执行$ locale命令查看当前环境的语言支持情况,若不是LANG=en_US.UTF-8,可执行上述命令进行修改。

    配置AK/SK、Region、Host信息

    使用BOS CLI工具之前,推荐先设置Access Key、Secure Key、Region和Host。可以通过-c/--configure来设置AK、SK、Region和Host信息。

    $ bce -c  [<conf-path>]
    $ BOS Access Key ID [None]: Enter Your AK
    $ BOS Secret Access Key [None]: Enter Your SK
    $ BCE Security Token [None]: Enter Your Security Token
    $ Default region name [bj]: Enter Your region
    $ Default domain [bj.bcebos.com]: Enter Your host

    说明:

    • <conf-path>为本地文件目录,当用户有多个百度智能云账户时,通过指定<conf-path>将不同账号的配置文件写到不同目录下,执行命令时可以指定目录选择对应账户的配置。
    • 不指定<conf-path>时,CLI在配置完成后将配置文件自动写到当前用户主目录~/.bce;指定<conf-path>时,将配置文件自动写到指定目录。
    • 即使不设置AK/SK,您也可以通过BOS CLI访问public权限的bucket。
    • 当且仅当您使用临时授权访问提供的AK/SK访问BOS时,才需要您提供 Security Token。
    • 指定Region之后您可以不指定Host,BOS CLI可自动拼接Host为Region.bcebos.com。
    • 如果您指定了Host,那么BOS CLI不再自动拼接Host,而是访问您指定的Host。
    • 可以填写None将AK/SK/Region以及Domain设置为空。当Region设置为空时默认值为bj;当Domain设置为空时默认使用Region拼接,当两个同时为空时默认访问bj.bcebos.com

    注意:

    • 如果您使用的AK/SK是直接从百度智能云控制台的安全认证中获取的,请将Security Token设置为空或者none。

    BOS相关配置

    bce -c命令除了可以进行通用设置,还支持设置自动切换域名,另还支持设置BOS上传的相关属性,如断点续传有效期、是否使用HTTPS协议及分块上传的多线程数。

    设置自动切换域名

    BOS拥有多个Region,如果您需要在不同Region下面进行操作,CLI的“自动切换域名”功能可以根据您当前操作的Bucket所在Region,来自动切换域名。为了方便您的使用,CLI会默认开启此功能。

    如果您想让您所以的操作请求都发送到您指定的域名或者Host(通过bce -c配置的domain),你可以通过bce -c命令关闭“自动切换域名”功能, 设置为no表示关闭此功能。

    $ bce -c [<conf-path>]
    $ Default use auto switch domain [yes]:

    说明:取值可以是yes和no,yes代表开启根据Bucket所在Region自动切换域名,no表示关闭。缺省情况下为开启。

    设置断点续传有效期

    CLI支持文件上传的断点续传。当某次上传因为意外中断,您可以重新执行命令,继续上一次的上传。断点续传功能需要设置有效期,有效期是指在该时间内,如出现中断,重新上传时可续传断点之后的部分;如超过该有效期,则会开始一次新的上传。

    $ bce -c [<conf-path>]
    $ Default breakpoint_file_expiration [7] days: Enter the period of keep breakpoint file

    说明:续传有效期应设置为大于等于0的整数,设为为“-1”表示永久保留。缺省续传有效期为7天。

    设置HTTPS协议上传

    为了保证用户数据的安全性,建议用户使用HTTPS协议上传。是否使用HTTPS可以通过bce -c命令进行设置,设置为no代表使用HTTP协议上传。

    $ bce -c [<conf-path>]
    $ Default use https protocol [no]:

    说明:取值可以是yes和no,缺省情况下使用HTTP协议上传。

    设置分块并行上传线程数

    大文件分块上传时,可以通过bce -c命令设置并行上传的线程数。

    $ bce -c [<conf-path>]
    $ Default multi upload thread num [10]:

    说明:并行上传的线程数应设置为大于等于1的整数,缺省为10。

    上一篇
    安装BOSCLI
    下一篇
    通过CLI使用BOS服务