存储空间(Bucket)是存储对象(Object)的容器。对象都隶属于存储空间。本文介绍如何创建存储空间。
注意事项
使用本文示例前您需要先通过自定义域名、STS等方式新建OSSClient,具体请参见初始化。
说明所创建存储空间的所属地域取决于初始化配置的endpoint地域信息。
要创建存储空间,您必须有
oss:PutBucket
权限。具体操作,请参见为RAM用户授权自定义的权限策略。
示例代码
以下代码用于创建名为examplebucket的存储空间:
// 构建创建Bucket的请求。
OSSCreateBucketRequest * create = [OSSCreateBucketRequest new];
// 设置存储空间名称为examplebucket。
create.bucketName = @"examplebucket";
// 设置访问权限为私有。
create.xOssACL = @"private";
// 设置存储类型为低频访问类型IA。
create.storageClass = OSSBucketStorageClassIA;
OSSTask * createTask = [client createBucket:create];
[createTask continueWithBlock:^id(OSSTask *task) {
if (!task.error) {
NSLog(@"create bucket success!");
} else {
NSLog(@"create bucket failed, error: %@", task.error);
}
return nil;
}];
// 实现同步阻塞等待任务完成。
// [createTask waitUntilFinished];
相关文档
关于创建存储空间的完整示例代码,请参见GitHub示例。
关于创建存储空间的API接口说明,请参见PutBucket。
关于初始化OSSClient,请参见如何初始化OSSClient实例。