put-bucket

注意事项

• 同一阿里云账号在同一地域（Region）内最多支持创建100个Bucket。

• 每个地域都有对应的访问域名（Endpoint）。关于地域与访问域名对应关系的更多信息，请参见访问域名和数据中心。

• 北京时间2025年10月13日10:00:00起，OSS逐步调整所有地域通过API、SDK、ossutil创建Bucket时默认开启阻止公共访问。各个地域的生效变更时间，请参见公告说明。开启后，不允许创建公共访问权限，包括公共读或者公共读写ACL、以及公共访问语义的Bucket Policy。如果您的业务有公共访问需求，可在Bucket创建后关闭阻止公共访问。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

命令格式

ossutil api put-bucket --bucket value [flags]

--create-bucket-configuration

--create-bucket-configuration配置选项既支持XML语法也支持JSON语法：

• XML语法：

  <?xml version="1.0" encoding="UTF-8"?>
  <CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>
  </CreateBucketConfiguration>

• JSON语法：

  {
    "StorageClass": "Standard",
    "DataRedundancyType": "LRS"
  }

使用示例

• 创建名为examplebucket的存储空间。

  ossutil api put-bucket --bucket examplebucket

• 创建访问权限为私有，资源组ID为rg-123，名字为examplebucket，存储类型为Standard，数据容灾类型为LRS的存储空间。

  • 使用XML配置文件，create-bucket-configuration.xml内容如下：

    <?xml version="1.0" encoding="UTF-8"?>
    <CreateBucketConfiguration>
      <StorageClass>Standard</StorageClass>
      <DataRedundancyType>LRS</DataRedundancyType>
    </CreateBucketConfiguration>

    命令示例如下：

    ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration file://create-bucket-configuration.xml

  • 使用JSON配置文件，create-bucket-configuration.json内容如下：

    {
      "StorageClass": "Standard",
      "DataRedundancyType": "LRS"
    }

    命令示例如下：

    ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration file://create-bucket-configuration.json

  • 使用JSON配置参数，命令示例如下：

    ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration "{\"StorageClass\":\"Standard\",\"DataRedundancyType\":\"LRS\"}"