存储空间（Bucket）是存储对象（Object）的容器。对象都隶属于存储空间。本文介绍如何创建存储空间。

注意事项

  • 本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见访问域名和数据中心。
  • 本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见新建OSSClient。
  • 要创建存储空间，您必须有oss:PutBucket权限。具体操作，请参见为RAM用户授权自定义的权限策略。

示例代码

以下代码用于创建名为examplebucket存储空间。

 // 创建OSSClient实例。
 OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

 // 创建存储空间并开启分层命名空间。
 CreateBucketRequest createBucketRequest = new CreateBucketRequest(bucketName).withHnsStatus(HnsStatus.Enabled);
 // 如果创建存储空间的同时需要指定存储类型、存储空间的读写权限、数据容灾类型, 请参考如下代码。
 // 此处以设置存储空间的存储类型为标准存储为例介绍。
 createBucketRequest.setStorageClass(StorageClass.Standard);
 // 数据容灾类型默认为本地冗余存储，即DataRedundancyType.LRS。
 createBucketRequest.setDataRedundancyType(DataRedundancyType.LRS);
 // 设置存储空间读写权限为公共读，默认为私有。
 createBucketRequest.setCannedACL(CannedAccessControlList.PublicRead);
 ossClient.createBucket(createBucketRequest);

 // 关闭OSSClient。
 ossClient.shutdown();

相关文档

  • 关于创建存储空间的完整示例代码，请参见GitHub示例。
  • 关于创建存储空间的API接口说明，请参见PutBucket。