iOS-SDK之如何实现 管理Bucket?

创建bucket

1. OSSCreateBucketRequest * create = [OSSCreateBucketRequest new];
2. create.bucketName = @"<bucketName>";
3. create.xOssACL = @"public-read";
4. create.location = @"oss-cn-hangzhou";
6. OSSTask * createTask = [client createBucket:create];
8. [createTask continueWithBlock:^id(OSSTask *task) {
9.     if (!task.error) {
10.         NSLog(@"create bucket success!");
11.     } else {
12.         NSLog(@"create bucket failed, error: %@", task.error);
13.     }
14.     return nil;
15. }];

• 每个用户的Bucket数量不能超过30个。
• 每个Bucket的名字全局唯一，也就是说创建的Bucket不能和其他用户已经在使用的Bucket同名，否则会创建失败。
• 创建的时候可以选择Bucket ACL权限，如果不设置ACL，默认是private。
• 创建成功结果返回Bucket所在数据中心。

1. OSSGetServiceRequest * getService = [OSSGetServiceRequest new];
2. OSSTask * getServiceTask = [client getService:getService];
3. [getServiceTask continueWithBlock:^id(OSSTask *task) {
4.     if (!task.error) {
5.         OSSGetServiceResult * result = task.result;
6.         NSLog(@"buckets: %@", result.buckets);
7.         NSLog(@"owner: %@, %@", result.ownerId, result.ownerDispName);
8.         [result.buckets enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
9.             NSDictionary * bucketInfo = obj;
10.             NSLog(@"BucketName: %@", [bucketInfo objectForKey:@"Name"]);
11.             NSLog(@"CreationDate: %@", [bucketInfo objectForKey:@"CreationDate"]);
12.             NSLog(@"Location: %@", [bucketInfo objectForKey:@"Location"]);
13.         }];
14.     }
15.     return nil;
16. }];

• 匿名访问不支持该操作。

1. OSSGetBucketRequest * getBucket = [OSSGetBucketRequest new];
2. getBucket.bucketName = @"<bucketName>";
3. // getBucket.marker = @"";
4. // getBucket.prefix = @"";
5. // getBucket.delimiter = @"";
7. OSSTask * getBucketTask = [client getBucket:getBucket];
9. [getBucketTask continueWithBlock:^id(OSSTask *task) {
10.     if (!task.error) {
11.         OSSGetBucketResult * result = task.result;
12.         NSLog(@"get bucket success!");
13.         for (NSDictionary * objectInfo in result.contents) {
14.             NSLog(@"list object: %@", objectInfo);
15.         }
16.     } else {
17.         NSLog(@"get bucket failed, error: %@", task.error);
18.     }
19.     return nil;
20. }];

• 罗列操作必须具备访问该Bukcet的权限。
• 罗列时，可以通过prefix，marker，delimiter和max-keys对list做限定，返回部分结果。

1. OSSDeleteBucketRequest * delete = [OSSDeleteBucketRequest new];
2. delete.bucketName = @"<bucketName>";
4. OSSTask * deleteTask = [client deleteBucket:delete];
6. [deleteTask continueWithBlock:^id(OSSTask *task) {
7.     if (!task.error) {
8.         NSLog(@"delete bucket success!");
9.     } else {
10.         NSLog(@"delete bucket failed, error: %@", task.error);
11.     }
12.     return nil;
13. }];

• 只有Bucket的拥有者才能删除这个Bucket。
• 为了防止误删除的发生，OSS不允许用户删除一个非空的Bucket。