腾讯云对象存储访问控制

简介

本文档提供关于存储桶、对象的访问控制列表（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) { ... }



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠