访问控制

简介

本文档提供关于存储桶、对象的访问控制列表（ACL）的相关 API 概览以及 SDK 示例代码。

存储桶 ACL

对象 ACL

存储桶 ACL

设置存储桶 ACL

功能说明

PUT Bucket acl 接口用来设置指定存储桶访问权限控制列表（ACL）。

使用示例

设置存储桶公有读：

cos.putBucketAcl({
   Bucket: 'examplebucket-1250000000', /* 必须 */
   Region: 'COS_REGION',    /* 必须 */
   ACL: 'public-read'
}, function(err, data) {
   console.log(err || data);
});

为某个用户赋予存储桶所有权限：

cos.putBucketAcl({
   Bucket: 'examplebucket-1250000000', /* 必须 */
   Region: 'COS_REGION',    /* 必须 */
   GrantFullControl: 'id="qcs::cam::uin/100000000001:uin/100000000001",id="qcs::cam::uin/100000000011:uin/100000000011"' // 100000000001是 uin
}, function(err, data) {
   console.log(err || data);
});

通过 AccessControlPolicy 修改存储桶权限：

cos.putBucketAcl({
   Bucket: 'examplebucket-1250000000', /* 必须 */
   Region: 'COS_REGION',    /* 必须 */
   AccessControlPolicy: {
       "Owner": { // AccessControlPolicy 里必须有 owner
           "ID": 'qcs::cam::uin/100000000001:uin/100000000001' // 100000000001 是主账号 uin
       },
       "Grants": [{
           "Grantee": {
               "ID": "qcs::cam::uin/100000000011:uin/100000000011", // 100000000011 是主账号下的子账号 uin
           },
           "Permission": "WRITE"
       }]
   }
}, function(err, data) {
   console.log(err || data);
});

参数说明

回调函数说明

function(err, data) { ... }

查询存储桶 ACL

功能说明

GET Bucket acl 接口用来查询存储桶的访问控制列表（ACL）。该 API 的请求者需要对存储桶有写入 ACL 权限。

使用示例

cos.getBucketAcl({
   Bucket: 'examplebucket-1250000000', /* 必须 */
   Region: 'COS_REGION'     /* 必须 */
}, function(err, data) {
   console.log(err || data);
});

返回示例

{
  "GrantFullControl": "",
  "GrantWrite": "",
  "GrantRead": "",
  "GrantReadAcp": "id=\"qcs::cam::uin/100000000011:uin/100000000011\"",
  "GrantWriteAcp": "id=\"qcs::cam::uin/100000000011:uin/100000000011\"",
  "ACL": "private",
  "Owner": {
      "ID": "qcs::cam::uin/100000000001:uin/100000000001",
      "DisplayName": "qcs::cam::uin/100000000001:uin/100000000001"
  },
  "Grants": [{
      "Grantee": {
          "ID": "qcs::cam::uin/100000000011:uin/100000000011",
          "DisplayName": "qcs::cam::uin/100000000011:uin/100000000011"
      },
      "Permission": "READ"
  }],
  "statusCode": 200,
  "headers": {}
}

参数说明

回调函数说明

function(err, data) { ... }

对象 ACL

设置对象 ACL

功能说明

PUT Object acl 接口用来设置特定存储桶中某个对象的访问控制列表（ACL）。

注意：

每个主账号（即同一个 APPID），存储桶的 ACL、Policy 和 CAM 关联的策略数量总和最多为1000条，对象访问控制列表（ACL）规则数量不限制。如果您不需要进行对象访问控制列表（ACL）控制，请不要设置，默认继承存储桶权限。

使用示例

cos.putObjectAcl({
   Bucket: 'examplebucket-1250000000', /* 必须 */
   Region: 'COS_REGION',    /* 必须 */
   Key: 'exampleobject',              /* 必须 */
   ACL: 'public-read',        /* 非必须 */
}, function(err, data) {
   console.log(err || data);
});

为某个用户赋予对象的所有权限：

cos.putObjectAcl({
   Bucket: 'examplebucket-1250000000', /* 必须 */
   Region: 'COS_REGION',    /* 必须 */
   Key: 'exampleobject',              /* 必须 */
   GrantFullControl: 'id="100000000001"' // 100000000001是主账号 uin
}, function(err, data) {
   console.log(err || data);
});

通过 AccessControlPolicy 赋予对象写权限：

cos.putObjectAcl({
   Bucket: 'examplebucket-1250000000', /* 必须 */
   Region: 'COS_REGION',    /* 必须 */
   Key: 'exampleobject',              /* 必须 */
   AccessControlPolicy: {
       "Owner": { // AccessControlPolicy 里必须有 owner
           "ID": 'qcs::cam::uin/100000000001:uin/100000000001' // 100000000001 是主账号 uin
       },
       "Grants": [{
           "Grantee": {
               "ID": "qcs::cam::uin/100000000011:uin/100000000011", // 100000000011 是主账号下的子账号 uin
           },
           "Permission": "WRITE"
       }]
   }
}, function(err, data) {
   console.log(err || data);
});

参数说明

回调函数说明

function(err, data) { ... }

查询对象 ACL

功能说明

GET Object acl 接口用来查询某个存储桶下的某个对象的访问权限。只有存储桶的持有者才有权限操作。

使用示例

cos.getObjectAcl({
   Bucket: 'examplebucket-1250000000', /* 必须 */
   Region: 'COS_REGION',    /* 必须 */
   Key: 'exampleobject',              /* 必须 */
}, function(err, data) {
   console.log(err || data);
});

参数说明

回调函数说明

function(err, data) { ... }