GetBucketAcl

GetBucketAcl接口用于获取某个存储空间(Bucket)的访问权限(ACL)。只有Bucket的拥有者才能获取Bucket的访问权限。

请求语法

GET /?acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

响应元素

名称 类型 描述
AccessControlList 容器

存储ACL信息的容器类

父节点:AccessControlPolicy

AccessControlPolicy 容器

保存GetBucketACL结果的容器

父节点:None

DisplayName 字符串

Bucket拥有者的名称(目前和用户ID一致)

父节点:AccessControlPolicy.Owner

Grant 枚举字符串

Bucket的ACL权限

有效值:privatepublic-readpublic-read-write

父节点:AccessControlPolicy.AccessControlList

ID 字符串

Bucket拥有者的用户ID

父节点:AccessControlPolicy.Owner

Owner 容器

保存Bucket拥有者信息的容器

父节点:AccessControlPolicy

示例

请求示例

GET /?acl HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 04:11:23 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ+WwIfNm0FmgbrQ0=

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906008B
Date: Fri, 24 Feb 2012 04:11:23 GMT 
Content-Length: 253
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS

<?xml version="1.0" ?>
<AccessControlPolicy>
    <Owner>
        <ID>00220120222</ID>
        <DisplayName>user_example</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>public-read</Grant>
    </AccessControlList>
</AccessControlPolicy>

SDK

此接口所对应的各语言SDK如下:

  • Java
  • Python
  • PHP
  • Go
  • C
  • .NET
  • Android
  • Node.js
  • Ruby

错误码

错误码 HTTP 状态码 描述
NoSuchBucket 404 目标Bucket不存在。
AccessDenied 403 没有操作权限。只有Bucket的拥有者才能获取Bucket的访问权限。

发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/3070.html

发表评论

邮箱地址不会被公开。 必填项已用*标注