创建存储桶
最近更新时间: 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 部分。
步骤说明
初始化客户端 cosclient。
执行 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);