vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/s3api/en-us_topic_0125560314.html
Jawei, Li 1a4c1a720a OBS s3api 2.0.38.SP5 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Jawei, Li <lijiawei5@huawei.com>
Co-committed-by: Jawei, Li <lijiawei5@huawei.com>
2022-11-16 14:51:13 +00:00

141 lines
8.9 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0125560314"></a><a name="EN-US_TOPIC_0125560314"></a>
<h1 class="topictitle1">GET Bucket acl</h1>
<div id="body5766865"><p class="msonormal" id="EN-US_TOPIC_0125560314__p18787345">After being granted <strong id="EN-US_TOPIC_0125560314__b51901789">READ_ACP</strong> or <strong id="EN-US_TOPIC_0125560314__b3692816704">FULL_CONTROL</strong> permission for a bucket, you can obtain its ACL.</p>
<div class="section" id="EN-US_TOPIC_0125560314__section14898996"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560314__screen22405814">GET /?acl HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: authorization</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section66982100"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560314__p56805778">This request involves no parameters.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section65967991"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560314__p37865337">This request uses common headers. For details about common request headers, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section56841015"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560314__p64570610">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section33178753"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560314__screen33094191113126">HTTP/1.1 status_code
Server: Server Name
x-amz-request-id: request id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: id
Content-Type: type
Date: date
Content-Length: length
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;AccessControlPolicy xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Owner&gt;
&lt;ID&gt;id&lt;/ID&gt;
&lt;DisplayName&gt;name&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;AccessControlList&gt;
&lt;Grant&gt;
&lt;Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser"&gt;
&lt;ID&gt;id&lt;/ID&gt;
&lt;DisplayName&gt;name&lt;/DisplayName&gt;
&lt;/Grantee&gt;
&lt;Permission&gt;permission&lt;/Permission&gt;
&lt;/Grant&gt;
&lt;/AccessControlList&gt;
&lt;/AccessControlPolicy&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section30173329"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560314__p29193512">This response uses common headers. For details about common response headers, see section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section3124510"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560314__p9935003">This response contains elements to provide details about a bucket ACL. <a href="#EN-US_TOPIC_0125560314__table46938871">Table 1</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560314__table46938871"></a><a name="table46938871"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560314__table46938871" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560314__row9451173"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.8.3.2.3.1.1"><p id="EN-US_TOPIC_0125560314__p27347573">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.8.3.2.3.1.2"><p id="EN-US_TOPIC_0125560314__p560958">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560314__row45437607"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560314__p56567512">Owner</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560314__p18565754">Indicates the bucket owner.</p>
<p id="EN-US_TOPIC_0125560314__p32874060">Type: XML</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560314__row27431092"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560314__p7325999">ID</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560314__p56535059">DomainId of the user.</p>
<p id="EN-US_TOPIC_0125560314__p39053483">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560314__row15937030"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560314__p15831091">DisplayName</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560314__p7249984">Indicates the user name.</p>
<p id="EN-US_TOPIC_0125560314__p65249858">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560314__row50377813"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560314__p54071067">AccessControlList</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560314__p17680313">Indicates the ACL that records all users who have permission to access the bucket and permission granted to the users.</p>
<p id="EN-US_TOPIC_0125560314__p24905097">Type: XML</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560314__row22819288"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560314__p36423072">Grant</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560314__p64587704">Container for the grantee and its permission.</p>
<p id="EN-US_TOPIC_0125560314__p44418425">Type: XML</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560314__row64221512"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560314__p34559993">Grantee</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560314__p47896050">Container for the details about the grantee.</p>
<p id="EN-US_TOPIC_0125560314__p28411274">Type: XML</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560314__row54374876"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560314__p42288863">Permission</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560314__p2845858">Indicates the grantee's permission for a bucket.</p>
<p id="EN-US_TOPIC_0125560314__p25612723">Type: String</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section28120593"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0125560314__p15411081">No special errors are returned. For details about error responses, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section11432386"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560314__screen26038236113156">GET /?acl HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept-Encoding: gzip,deflate
Date: Mon, 27 Sep 2010 01:22:05 GMT
Authorization: AWS 04RZT432N80TGDF2Y2G2:FAcC4bDx0izVL9lEH521v01in/Y= </pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560314__section35782611"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560314__screen61203389113211">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 7B6DFC9BC71DD58B061285550689635
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: N0I2REZDOUJDNzFERDU4QjA2MTI4NTU1MDY4OTYzNUFBQUFBQUFBYmJiYmJiYmJD
Content-Type: application/xml
Date: Mon, 27 Sep 2010 01:24:47 GMT
Content-Length: 560
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;AccessControlPolicy xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Owner&gt;
&lt;ID&gt;bcaf1ffd86f41caff1a493dc2ad8c2c281e37522a640e161ca5fb16fd081034f&lt;/ID&gt;
&lt;DisplayName&gt;apple&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;AccessControlList&gt;
&lt;Grant&gt;
&lt;Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser"&gt; &lt;ID&gt;bcaf1ffd86f41caff1a493dc2ad881e37540e161ca5fb16fd081034f&lt;/ID&gt;
&lt;DisplayName&gt;apple&lt;/DisplayName&gt;
&lt;/Grantee&gt;
&lt;Permission&gt;FULL_CONTROL&lt;/Permission&gt;
&lt;/Grant&gt;
&lt;/AccessControlList&gt;
&lt;/AccessControlPolicy&gt;</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560493.html">Operations on Buckets</a></div>
</div>
</div>
View Git Blame Copy Permalink