存储空间(Bucket)是存储对象(Object)的容器。对象都隶属于存储空间。本文介绍如何获取存储空间访问权限(ACL)。
存储空间的读写权限(ACL)有以下三类:
访问权限 | 描述 | 访问权限值 |
私有 | 存储空间的拥有者和授权用户有该存储空间内的文件的读写权限,其他用户没有权限操作该存储空间内的文件。 | private |
公共读 | 存储空间的拥有者和授权用户有该存储空间内的文件的读写权限,其他用户只有该存储空间内的文件的读权限。请谨慎使用该权限。 | public-read |
公共读写 | 所有用户都有该存储空间内的文件的读写权限。请谨慎使用该权限。 | public-read-write |
注意事项
使用本文示例前您需要先通过自定义域名、STS等方式新建OSSClient,具体请参见如何初始化Android端OSSClient实例。
示例代码
以下代码用于获取存储空间的读写权限:
GetBucketACLRequest getBucketACLRequest = new GetBucketACLRequest("bucketName");
// 获取存储空间访问权限。
OSSAsyncTask getBucketAclTask = oss.asyncGetBucketACL(getBucketACLRequest, new OSSCompletedCallback<GetBucketACLRequest, GetBucketACLResult>() {
@Override
public void onSuccess(GetBucketACLRequest request, GetBucketACLResult result) {
Log.d("asyncGetBucketACL", "Success!");
Log.d("BucketAcl", result.getBucketACL());
Log.d("Owner", result.getBucketOwner());
Log.d("ID", result.getBucketOwnerID());
}
@Override
public void onFailure(GetBucketACLRequest request, ClientException clientException, ServiceException serviceException) {
// 请求异常。
if (clientException != null) {
// 本地异常,如网络异常等。
clientException.printStackTrace();
}
if (serviceException != null) {
// 服务异常。
Log.e("ErrorCode", serviceException.getErrorCode());
Log.e("RequestId", serviceException.getRequestId());
Log.e("HostId", serviceException.getHostId());
Log.e("RawMessage", serviceException.getRawMessage());
}
}
});
相关文档
关于获取存储空间读写权限的完整示例代码,请参见GitHub示例。
关于获取存储空间读写权限的API接口说明,请参见GetBucketAcl。
关于初始化OSSClient,请参见如何初始化Android端OSSClient实例。