You need to enable JavaScript to run this app.
导航
GetBucketACL
最近更新时间:2023.11.21 10:22:22首次发布时间:2023.04.17 15:20:18

功能描述

此接口用于获取指定桶的访问控制权限(ACL)。调用此接口要求具有 READ_ACP 权限。

请求消息样式

GET /?acl HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string

请求参数和消息头

该请求使用公共请求消息头,请参见公共参数

名称

位置

参数类型

是否必选

示例值

说明

acl

Query

String

代表 GetBucketAcl 请求的特殊标识。

请求元素

该请求不使用请求消息元素。

响应消息头

该请求返回的公共响应消息头,请参见公共参数

响应元素

名称

参数类型

说明

Grants

Array

对象的访问控制权限根节点。

Grantee

Object

被授权用户信息。父节点为 Grants。

Type

String

用户类型。父节点为 Grantee。

Canned

String

TypeGroup 时,返回该字段。取值说明如下:

  • AllUsers:所有用户。
  • AuthenticatedUsers:部分通过用户 ID 被授权的用户。

父节点为 Grantee。

ID

String

TypeCanonicalUser 时,返回该字段,代表被授权的用户 ID。父节点为 Grantee。

Permission

String

授权类型。父节点为 Grants。

Owner

Object

对象所有者。

ID

String

账号 ID。父节点为 Owner。

请求示例

GET /?acl HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 06:45:39 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
x-tos-id-2: f91b0c03a01300c1-a444ed0
x-tos-request-id: f91b0c03a01300c1-a444ed0
Date: Fri, 30 Jul 2021 06:45:39 GMT
server: TosServer
Content-Length: 340

{
    "Owner": {
        "ID": "AccountID"
    },
    "Grants": [
        {
            "Grantee": {
                "ID": "AccountID",
                "Type": "CanonicalUser"
            },
            "Permission": "FULL_CONTROL"
        }
    ]
}