全部產品
Search
文件中心

:GetBucketAcl

更新時間:Jun 19, 2024

GetBucketAcl介面用於擷取某個儲存空間(Bucket)的存取權限(ACL)。只有Bucket的擁有者才能擷取Bucket的存取權限。

請求文法

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

要求標頭

此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)

響應元素

名稱

類型

描述

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 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如下:

錯誤碼

錯誤碼

HTTP 狀態代碼

描述

NoSuchBucket

404

目標Bucket不存在。

AccessDenied

403

沒有操作許可權。只有Bucket的擁有者才能擷取Bucket的存取權限。