mb命令用于创建存储空间(Bucket)。

说明 本文命令均以Linux系统为例,实际使用时,请将命令名称改为您实际可执行程序文件的名称。例如Windows 32位系统的帮助命令为ossutil32.exe help

命令格式

./ossutil mb oss://bucketname [--acl=ACL][--storage-class sc][-c file][--redundancy-type type]

使用示例

  • 创建Bucket
    ./ossutil mb oss://bucket1
    注意 Bucket名称唯一,若创建的Bucket名称已存在,会出现Bucket已存在的报错信息。
  • 创建Bucket时指定访问权限
    ./ossutil mb oss://bucket1 --acl public-read-write
    --acl:用来指定存储空间访问权限,默认为私有(private)。
    • private:私有
    • public-read:公共读
    • public-read-write:公共读写
    ACL详情请参见基于读写权限ACL的权限控制
  • 创建Bucket时指定存储类型
    ./ossutil mb oss://bucket1 --storage-class IA
    --storage-class:用来指定Bucket的默认存储类型。默认存储类型为标准存储类型(Standard)。
    • Standard:标准存储
    • IA:低频访问
    • Archive:归档存储
    • ColdArchive:冷归档存储

    存储类型详情请参见存储类型介绍

  • 在指定地域创建Bucket
    ./ossutil mb oss://bucket1 -e oss-cn-beijing.aliyuncs.com
  • 使用指定的配置文件创建Bucket
    ./ossutil mb oss://bucket1 -c your_config_file_path
  • 创建Bucket并开启同城冗余存储
    ./ossutil mb oss://bucket1 --redundancy-type ZRS
    --redundancy-type:设置Bucket的数据冗余类型,可选值为LRS(本地冗余存储)和ZRS(同城冗余存储),默认为LRS
    说明 目前仅在华南 1(深圳)、华北 2(北京)、华东 2(上海)地域支持同城冗余存储,如果您在创建Bucket时设置该参数的值为ZRS,请注意您的Endpoint配置。关于同城冗余存储的更多信息请参见同城冗余存储

常用选项

您可以在使用mb命令时,指定如下选项来指定Bucket属性:
选项名称 描述
--acl 用来指定存储空间访问权限,默认为私有(private)。取值范围:
  • private:私有
  • public-read:公共读
  • public-read-write:公共读写
ACL详情请参见基于读写权限ACL的权限控制
--storage-class 用来指定Bucket的默认存储类型。默认存储类型为标准存储类型(Standard)。 取值范围:
  • Standard:标准存储
  • IA:低频访问
  • Archive:归档存储
  • ColdArchive:冷归档存储

存储类型详情请参见存储类型介绍

-c,--config-file 使用指定的config文件来创建Bucket。未附加该参数则表示使用默认配置文件创建Bucket。config配置请参见config
-e,--endpoint 用来指定Bucket的地域(Region)。未附加该参数则表示使用默认配置文件中的Endpoint来指定Bucket的地域。
-L,--language 设置ossutil工具的语言,默认值:CH,取值范围:CH/EN,若设置成“CH”,请确保您的系统编码为UTF-8。
--loglevel 设置日志级别,默认为空,表示不输出日志文件。可选值为:
  • info:输出提示信息日志。
  • debug:输出详细信息日志(包括http请求和响应信息)。
--retry-times 当错误发生时的重试次数,默认值:10,取值范围:1-500。
--proxy-host 网络代理服务器的url地址,支持http、https、socks5。例如http://120.79.**.**:3128、 socks5://120.79.**.**:1080。
--proxy-user 网络代理服务器的用户名,默认为空。
--proxy-pwd 网络代理服务器的密码,默认为空。
--redundancy-type 设置Bucket的数据冗余类型,可选值为LRS(本地冗余存储)和ZRS(同城冗余存储),默认为LRS
说明 更多通用选项请参见查看选项