股票代码: 836286    股票简称: 易云股份
官方微信

扫一扫关注易云捷讯官方微信

备案 |       管理控制台
API 手册
 

获取Bucket的访问控制权限

获取Bucket的访问控制列表,要求发起请求的用户是Bucket的所有者或者针对该Bucket具有 READ_ACP 权限。

请求消息

GET /?acl HTTP/1.1

Host: {BucketName}.eos.eayun.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}

请求消息头

公共请求消息头

请参考公共消息头

请求消息参数

该请求无请求消息参数

请求消息元素

该请求无请求消息元素

响应消息

响应格式

HTTP/1.1 {StatusCode}

Date: {Date}

Server: {Server}

Content-Type: application/xml

 

<?xml version="1.0" ?><AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><Owner><ID>{BucketOwnerID}</ID><DisplayName>{BucketOwnerDisplayName}</DisplayName></Owner><AccessControlList><Grant><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser"><ID>{GranteeID}</ID><DisplayName>{GranteeDisplayName}</DisplayName></Grantee><Permission>{Permission}</Permission></Grant>...</AccessControlList></AccessControlPolicy>

响应消息头

请参考公共响应消息头

响应消息元素

元素名称

描述

AccessControlList

ACL 配置的 XML 容器。

类型:XML 容器

上层数据结构:AccessControlPolicy

AccessControlPolicy

响应消息最上层的的 XML 容器。

类型:XML 容器

上层数据结构:无

DisplayName

Bucket所有者的显示名称。

类型:字符串

上层数据结构:AccessControlPolicy.Owner

Grant

响应消息元素 Grantee 和 Permission 的上层 XML 容器。

类型:字符串

上层数据结构:AccessControlPolicy.AccessControlList

Grantee

对应一个被赋予权限的用户,包含两个次一层的元素 DisplayName 和 ID (要赋予权限的用户的 DisplayName 和 ID )。

类型:XML 容器

上层数据结构:AccessControlPolicy.AccessControlList.Grant

ID

Bucket所有者的 ID 。

类型:字符串

上层数据结构:AccessControlPolicy.Owner

Owner

Bucket所有者相关信息的 XML 容器。

类型:字符串

上层数据结构:AccessControlPolicy

Permission

Grantee 指定用户对当前Bucket的所拥有的权限。

类型:字符串

有效值:FULL_CONTROL ,WRITE ,WRITE_ACP ,READ 以及 READ_ACP 

上层数据结构:AccessControlPolicy.AccessControlList.Grant

错误响应消息

请参考错误响应描述

示例

请求示例

GET /new-bucket?acl HTTP/1.1

Host: ceph

Accept-Encoding: gzip, deflate

Accept: */*

User-Agent: python-requests/2.8.1

Connection: keep-alive

date: Fri, 27 Nov 2015 07:54:52 GMT

Authorization: AWS 9FSTXQR54VKR7VEM7GAJ:kyZQ7ihshvLKwTc4IAXCTYmBRdE=

响应示例

HTTP/1.1 200

Transfer-Encoding: chunked

Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips

Cache-control: private

Date: Fri, 27 Nov 2015 07:54:48 GMT

Content-Type: application/xml

 

<?xml version="1.0" ?>

<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

    <Owner>

        <ID>zc-test-1</ID>

        <DisplayName>Testing User for ZhaoChao</DisplayName>

    </Owner>

    <AccessControlList>

        <Grant>

            <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">

                <ID>zc-test-1</ID>

                <DisplayName>Testing User for ZhaoChao</DisplayName>

            </Grantee>

            <Permission>FULL_CONTROL</Permission>

        </Grant>

    </AccessControlList>

</AccessControlPolicy>


© 2011-2017 易云捷讯科技(北京)股份有限公司, 版权所有 | © 2011-2017 Eayun,Inc. All rights reserved.

京公网安备 11010802022475号 | 京ICP备 11028869号

业务咨询:400-606-6396