存储空间(Bucket)是存储对象(Object)的容器。对象都隶属于存储空间。本文介绍如何获取存储空间读写权限(ACL)。
注意事项
使用本文示例前您需要先通过自定义域名、STS等方式新建OSSClient,具体请参见初始化。
说明所访问的存储空间的所属地域取决于初始化配置的endpoint地域信息。
存储空间读写权限
存储空间的读写权限(ACL)包括如下三种:
访问权限 | 描述 | 访问权限值 |
私有 | 存储空间的拥有者和授权用户有该存储空间内的文件的读写权限,其他用户没有权限操作该存储空间内的文件。 | private |
公共读 | 存储空间的拥有者和授权用户有该存储空间内的文件的读写权限,其他用户只有该存储空间内的文件的读权限。请谨慎使用该权限。 | public-read |
公共读写 | 所有用户都有该存储空间内的文件的读写权限。请谨慎使用该权限。 | public-read-write |
示例代码
以下代码用于获取examplebucket存储空间的读写权限。
OSSGetBucketACLRequest *request = [OSSGetBucketACLRequest new];
// 填写Bucket名称,例如examplebucket。
request.bucketName = @"examplebucket";
// 获取存储空间的读写权限。
OSSTask * getBucketACLTask = [client getBucketACL:request];
[getBucketACLTask continueWithBlock:^id(OSSTask *task) {
if (!task.error) {
OSSGetBucketACLResult *result = task.result;
NSLog(@"权限:%@", result.aclGranted);
} else {
NSLog(@"get bucket ACL failed, error: %@", task.error);
}
return nil;
}];
// 实现同步阻塞等待任务完成。
// [getBucketACLTask waitUntilFinished];
相关文档
关于获取存储空间读写权限的完整示例代码,请参见GitHub示例。
关于获取存储空间读写权限的API接口说明,请参见GetBucketAcl。
关于初始化OSSClient,请参见如何初始化OSSClient实例。
文档内容是否对您有帮助?