赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 权限控制(ACL)
  8. GetBucketAcl

GetBucketAcl

  • 权限控制(ACL)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

GetBucketAcl接口用于获取某个存储空间(Bucket)的访问权限(ACL)。

注意事项

获取某个存储空间(Bucket)的访问权限(ACL),您必须拥有oss:GetBucketAcl权限。具体操作,请参见为RAM用户授权自定义的权限策略。

请求语法

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

当您在OSS ON云盒中调用该接口时,您需要将Host替换为云盒Endpoint。更多信息,请参见云盒Endpoint。

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。

响应元素

名称

类型

描述

AccessControlList

容器

存储ACL信息的容器类。

父节点:AccessControlPolicy

AccessControlPolicy

容器

保存GetBucketACL结果的容器

父节点:None

DisplayName

字符串

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

父节点:AccessControlPolicy.Owner

Grant

枚举字符串

Bucket的ACL权限。

有效值:private、public-read、public-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 qn6q**************:77Dv****************
                

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
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>0022012****</ID>
        <DisplayName>user_example</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>public-read</Grant>
    </AccessControlList>
</AccessControlPolicy>

SDK

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

  • Java

  • Python

  • PHP

  • Go V2

  • C

  • .NET

  • Android

  • Node.js

  • Ruby

命令行工具ossutil

GetBucketAcl接口所对应的ossutil命令,请参见get-bucket-acl。

错误码

错误码

HTTP 状态码

描述

NoSuchBucket

404

目标Bucket不存在。

AccessDenied

403

没有操作权限。只有Bucket的拥有者才能获取Bucket的访问权限。

相关文章

PutBucketAcl 2025-04-21 18:15

PutBucketAcl接口用于设置或修改存储空间(Bucket)的访问权限(ACL)。

GetBucketAcl 2025-04-21 18:15

GetBucketAcl接口用于获取某个存储空间(Bucket)的访问权限(ACL)。 注意事项 获取某个存储空间(Bucket)的访问权限(ACL),您必须拥有oss:GetBucketAcl

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号