You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

GetObjectACL

最近更新时间：2023.11.21 10:22:21

首次发布时间：2021.10.13 16:14:07

我的收藏

功能描述

此接口用于获取指定对象的访问控制权限（ACL）。
调用此接口要求具有 ACP（Access Control Policy）读权限。默认获取当前版本对象的 ACL，如果想要获取指定版本对象的 ACL，可以通过指定versionId获取。

请求消息样式

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

请求参数和消息头

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

名称

位置

参数类型

是否必选

示例值

说明

acl

Query

String

是

代表 GetObjectACL 请求的特殊标识。

versionId

Query

String

否

123

对象的版本号。标识获取指定版本的对象 ACL。

请求元素

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

响应消息头

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

名称

参数类型

说明

x-tos-version-id

String

对象的版本号。

响应元素

名称

参数类型

说明

Grants

Array

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

Grantee

Object

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

Type

String

用户类型。父节点为 Grantee。

Canned

String

当 Type 为 Group 时，返回该字段。取值说明如下：

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

父节点为 Grantee。

ID

String

当 Type 为 CanonicalUser 时，返回该字段，代表被授权的用户 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"
        }
    ]
}