存储空间(Bucket)是存储对象(Object)的容器。对象都隶属于存储空间。本文介绍如何获取存储空间的信息。
注意事项
使用本文示例前您需要先通过自定义域名、STS等方式新建OSSClient,具体请参见初始化。
说明所访问的存储空间的所属地域取决于初始化配置的endpoint地域信息。
示例代码
以下代码用于获取examplebucket存储空间的信息(Info),包括存储空间所在地域、创建日期、权限信息等。
OSSGetBucketInfoRequest *request = [OSSGetBucketInfoRequest new];
// 填写Bucket名称,例如examplebucket。
request.bucketName = @"examplebucket";
// 获取存储空间信息。
OSSTask * getBucketInfoTask = [client getBucketInfo:request];
[getBucketInfoTask continueWithBlock:^id(OSSTask *task) {
if (!task.error) {
OSSGetBucketInfoResult *result = task.result;
NSLog(@"创建时间:%@", result.creationDate);
NSLog(@"地域:%@", result.location);
NSLog(@"类型:%@", result.storageClass);
NSLog(@"拥有者信息:%@", result.owner.userName);
NSLog(@"权限:%@", result.acl.grant);
} else {
NSLog(@"get bucket info failed, error: %@", task.error);
}
return nil;
}];
// 实现同步阻塞等待任务完成。
// [getBucketInfoTask waitUntilFinished];
相关文档
关于获取存储空间信息的完整示例代码,请参见GitHub示例。
关于获取存储空间信息的API接口说明,请参见GetBucketInfo。
关于初始化OSSClient,请参见如何初始化OSSClient实例。