Overview

设置存储桶（Bucket） 的访问权限（Access Control List, ACL)的方法.

功能描述

ACL 权限包括读、写、读写权限. 写入 Bucket 的 ACL 可以通过 header头部："x-cos-acl"， “x-cos-grant-read"，"x-cos-grant-write"， "x-cos-grant-full-control” 传入 ACL 信息 ，或者通过 Body 以 XML 格式传入 ACL 信息.这两种方式只 能选择其中一种，否则引起冲突.

传入新的 ACL 将覆盖原有 ACL信息. 私有 Bucket 可以下可以给某个文件夹设置成公有，那么该文件夹下的文件都是公有； 但是把文件夹设置成私有后，在该文件夹下的文件设置 的公有属性，不会生效.

关于设置 Bucket 的ACL接口的具体描述，请查看 https://cloud.tencent.com/document/product/436/7737.

示例

@code

QCloudPutBucketACLRequest* putACL = [QCloudPutBucketACLRequest new];

// 授予权限的账号 ID
NSString* uin = @"100000000001";
NSString *ownerIdentifier = [NSString stringWithFormat:@"qcs::cam::uin/%@:uin/%@"
                             , uin,uin];
NSString *grantString = [NSString stringWithFormat:@"id=\"%@\"",ownerIdentifier];

// 赋予被授权者读写权限
putACL.grantFullControl = grantString;

// 赋予被授权者读权限
putACL.grantRead = grantString;

// 赋予被授权者写权限
putACL.grantWrite = grantString;

// 存储桶名称，格式为 BucketName-APPID
putACL.bucket = @"examplebucket-1250000000";

[putACL setFinishBlock:^(id outputObject, NSError *error) {
    // 可以从 outputObject 中获取服务器返回的 header 信息
    NSDictionary * result = (NSDictionary *)outputObject;

}];
// 设置acl
[[QCloudCOSXMLService defaultCOSXML] PutBucketACL:putACL];