创建存储桶

最近更新时间: 2024-10-17 17:10:00

适用场景

在开始使用 COS 时,您需要先创建一个存储桶以便于对象的使用和管理。您可以通过控制台、API 或 SDK 的方式来创建存储桶。

当存储桶不存在时,您可以使用以下代码示例在指定地域创建存储桶,存储桶支持的参数为:

  • Bucket:用于指定您的完整存储桶名称,形如 testbuc-125235912

  • Region:选择您的云平台服务地域,一旦创建将不可移动或修改存储桶。

使用方法

使用 REST API

您可以直接使用 REST API 发起一个创建存储桶的请求,可参考 Put Bucket 文档说明。

使用 Java SDK

对象存储 COS 的 Java SDK 中提供了此方法,可参考 Java SDK 接口文档 Put Bucket 部分。

步骤说明

  1. 初始化客户端 cosclient。

  2. 执行 createBucket 创建 Bucket,创建 Bucket 时可指定 Bucket 的权限(公有读写或私有读)。

代码示例

调用 createBucket 创建 Bucket,代码示例如下所示:

// 1 初始化用户身份信息(appid, secretId, secretKey)
COSCredentials cred = new BasicCOSCredentials("AKIDXXXXXXXX", "1A2Z3YYYYYYYYYY");    
// 2 设置bucket的区域, COS地域的简称请参照 /document/product/436/6224
ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing-1"));  
// 3 生成cos客户端
COSClient cosclient = new COSClient(cred, clientConfig);
String bucketName = "publicreadbucket-1251668577";
CreateBucketRequest createBucketRequest = new CreateBucketRequest(bucketName);
// 设置bucket的权限为PublicRead(公有读私有写), 其他可选Private(私有读写), PublicReadWrite(公有读写)
createBucketRequest.setCannedAcl(CannedAccessControlList.PublicRead);
Bucket bucket = cosclient.createBucket(createBucketRequest);