存储空间(Bucket)是存储对象(Object)的容器。对象都隶属于存储空间。本文介绍如何创建存储空间。
注意事项
使用本文示例前您需要先通过自定义域名、STS等方式新建OSSClient,具体请参见初始化(iOS SDK)。
说明所创建存储空间的所属地域取决于初始化配置的endpoint地域信息。
北京时间2025年10月13日10:00:00起,OSS逐步调整所有地域通过API、SDK、ossutil创建Bucket时默认开启阻止公共访问。各个地域的生效变更时间,请参见公告说明。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM Policy概述或Bucket Policy授予操作权限。
API | Action | 说明 |
PutBucket |
| 创建Bucket。 |
| 创建Bucket后,修改Bucket的ACL,需要此操作的权限。 |
示例代码
以下代码用于创建名为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实例。