doc-exports/docs/obs/s3api/en-us_topic_0125560378.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

89 lines
6.4 KiB
HTML

<a name="EN-US_TOPIC_0125560378"></a><a name="EN-US_TOPIC_0125560378"></a>
<h1 class="topictitle1">GET Bucket storage class</h1>
<div id="body1510627911016"><p id="EN-US_TOPIC_0125560378__p102118329517">You can use this operation to obtain the default storage class of a bucket.</p>
<p id="EN-US_TOPIC_0125560378__p121133285116">Only users granted the <strong id="EN-US_TOPIC_0125560378__b1021113214514">s3:GetBucketStoragePolicy</strong> permission can perform this operation. By default, only the bucket owner can perform this operation. The bucket owner can allow other users to perform this operation by granting them the permission or setting a bucket policy.</p>
<div class="section" id="EN-US_TOPIC_0125560378__section8474400"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560378__screen56688146">GET /?storagePolicy 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_0125560378__section28412381"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560378__p6124542">This request involves no parameters.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560378__section49412770"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560378__p1176762217528">This request uses common headers. For details about common request headers, see <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560378__section16756923"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560378__p1323922">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560378__section29441461"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560378__screen41173987">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;StoragePolicy xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;DefaultStorageClass&gt;STANDARD&lt;/DefaultStorageClass&gt;
&lt;/StoragePolicy&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560378__section12865091"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560378__p88561392533">This response uses common headers. For details about common response headers, see <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560378__section7655917"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560378__p23660402">This response contains elements to specify the default bucket storage class. <a href="#EN-US_TOPIC_0125560378__table40100219">Table 1</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560378__table40100219"></a><a name="table40100219"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560378__table40100219" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560378__row34562362"><th align="left" class="cellrowborder" valign="top" width="39.44%" id="mcps1.3.9.3.2.3.1.1"><p id="EN-US_TOPIC_0125560378__p93814525510">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.56%" id="mcps1.3.9.3.2.3.1.2"><p id="EN-US_TOPIC_0125560378__p193815105519">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560378__row16883390"><td class="cellrowborder" valign="top" width="39.44%" headers="mcps1.3.9.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560378__p62034596165412">StoragePolicy</p>
</td>
<td class="cellrowborder" valign="top" width="60.56%" headers="mcps1.3.9.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560378__p143502104551">Indicates the bucket storage specification, including the default bucket storage class.</p>
<p id="EN-US_TOPIC_0125560378__p635013103555">Type: XML</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560378__row35218150"><td class="cellrowborder" valign="top" width="39.44%" headers="mcps1.3.9.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560378__p16334111">DefaultStorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="60.56%" headers="mcps1.3.9.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560378__p10246132219559">Indicates the default bucket storage class.</p>
<p id="EN-US_TOPIC_0125560378__p624692219554">Type: It is a character string. <a href="en-us_topic_0125560403.html#EN-US_TOPIC_0125560403__table63485364">Table 1</a> provides the possible values.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560378__section59410009"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0125560378__p167791717560">No special error responses 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_0125560378__section22641308"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560378__screen48089588">GET /?storagePolicy HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Sun, 26 Sep 2017 08:24:46 GMT
Authorization: AWS 08350B985315591007AD:UpIi7+loQpsAFUpKCYvmIuZyFP0=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560378__section22735078"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560378__screen2942560">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 3CEF0000015D0B5293440F668629A2C9
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: Dbn8aLu3MP7QA692G1pQdYZTf3Xa7vVGikDMbX+VfLFhat/ML3I/YkW8fwvWQSNr
Content-Type: application/xml
Date: Sun, 26 Sep 2017 08:24:47 GMT
Content-Length: 187
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;StoragePolicy xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;DefaultStorageClass&gt;STANDARD&lt;/DefaultStorageClass&gt;
&lt;/StoragePolicy&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>