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>
992
docs/obs/s3api/ALL_META.TXT.json
Normal file
893
docs/obs/s3api/CLASS.TXT.json
Normal file
3
docs/obs/s3api/PARAMETERS.txt
Normal file
@ -0,0 +1,3 @@
|
||||
version=""
|
||||
language="en-us"
|
||||
type=""
|
BIN
docs/obs/s3api/en-us_image_0125560271.png
Normal file
After Width: | Height: | Size: 170 KiB |
BIN
docs/obs/s3api/en-us_image_0125560298.png
Normal file
After Width: | Height: | Size: 55 KiB |
BIN
docs/obs/s3api/en-us_image_0125560341.png
Normal file
After Width: | Height: | Size: 11 KiB |
BIN
docs/obs/s3api/en-us_image_0125560380.png
Normal file
After Width: | Height: | Size: 18 KiB |
BIN
docs/obs/s3api/en-us_image_0125560429.png
Normal file
After Width: | Height: | Size: 17 KiB |
BIN
docs/obs/s3api/en-us_image_0125560434.png
Normal file
After Width: | Height: | Size: 74 KiB |
BIN
docs/obs/s3api/en-us_image_0125560437.png
Normal file
After Width: | Height: | Size: 18 KiB |
BIN
docs/obs/s3api/en-us_image_0125560454.png
Normal file
After Width: | Height: | Size: 164 KiB |
BIN
docs/obs/s3api/en-us_image_0125560469.png
Normal file
After Width: | Height: | Size: 17 KiB |
BIN
docs/obs/s3api/en-us_image_0125560488.png
Normal file
After Width: | Height: | Size: 19 KiB |
147
docs/obs/s3api/en-us_topic_0000001080550512.html
Normal file
181
docs/obs/s3api/en-us_topic_0000001080838596.html
Normal file
96
docs/obs/s3api/en-us_topic_0000001121228134.html
Normal file
@ -0,0 +1,96 @@
|
||||
<a name="EN-US_TOPIC_0000001121228134"></a><a name="EN-US_TOPIC_0000001121228134"></a>
|
||||
|
||||
<h1 class="topictitle1">DELETE Bucket Custom Domain</h1>
|
||||
<div id="body0000001121228134"><p id="EN-US_TOPIC_0000001121228134__p028114308563">OBS uses the DELETE method to delete the custom domain name of a bucket.</p>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section57518732"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001121228134__screen656246211548"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
|
||||
2
|
||||
3
|
||||
4
|
||||
5
|
||||
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE /?customdomain=domainname HTTP/1.1
|
||||
User-Agent: curl/7.29.0
|
||||
Host: bucketname.obs.region.example.com
|
||||
Accept: */*
|
||||
Date: date
|
||||
Authorization: authorization string
|
||||
</pre></div>
|
||||
</td></tr></table></div>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section47906541"><h4 class="sectiontitle">Request Parameters</h4>
|
||||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001121228134__table34931235193212" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001121228134__row195001352328"><th align="left" class="cellrowborder" valign="top" width="22.430000000000003%" id="mcps1.3.3.2.2.4.1.1"><p id="EN-US_TOPIC_0000001121228134__p750214358321">Parameter</p>
|
||||
</th>
|
||||
<th align="left" class="cellrowborder" valign="top" width="53.260000000000005%" id="mcps1.3.3.2.2.4.1.2"><p id="EN-US_TOPIC_0000001121228134__p95049355327">Description</p>
|
||||
</th>
|
||||
<th align="left" class="cellrowborder" valign="top" width="24.310000000000002%" id="mcps1.3.3.2.2.4.1.3"><p id="EN-US_TOPIC_0000001121228134__p185061235143215">Mandatory</p>
|
||||
</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody><tr id="EN-US_TOPIC_0000001121228134__row175081135133212"><td class="cellrowborder" valign="top" width="22.430000000000003%" headers="mcps1.3.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001121228134__p19510123510324">customdomain</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="53.260000000000005%" headers="mcps1.3.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001121228134__p16551024153319">Specifies the custom domain name to be deleted.</p>
|
||||
<p id="EN-US_TOPIC_0000001121228134__p3653204810576">Type: string, which must meet the naming convention of domain names.</p>
|
||||
<p id="EN-US_TOPIC_0000001121228134__p154809270334">Specifications: The value contains a maximum of 256 characters.</p>
|
||||
<p id="EN-US_TOPIC_0000001121228134__p163341526203219">No default value.</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="24.310000000000002%" headers="mcps1.3.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001121228134__p853293516321">Yes</p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section28505693"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="EN-US_TOPIC_0000001121228134__p30785969">This request uses common headers. For details about common request headers, see the section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section55224652"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="EN-US_TOPIC_0000001121228134__p10635570">This request involves no elements.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section46270551"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001121228134__screen065719411711"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
|
||||
2
|
||||
3
|
||||
4
|
||||
5</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 204 No Content
|
||||
Server: OBS
|
||||
x-amz-request-id: request id
|
||||
x-amz-id-2: id
|
||||
Date: date
|
||||
</pre></div>
|
||||
</td></tr></table></div>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section13781782"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="EN-US_TOPIC_0000001121228134__p4179377">This response uses common headers. For details about common response headers, see the section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section56927182"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="EN-US_TOPIC_0000001121228134__p2985227">This response involves no elements.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section42582590"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0000001121228134__p8258615">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_0000001121228134__section32323009"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001121228134__screen11617610142118"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
|
||||
2
|
||||
3
|
||||
4
|
||||
5
|
||||
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE /?customdomain=obs.ccc.com HTTP/1.1
|
||||
User-Agent: curl/7.29.0
|
||||
Host: examplebucket.obs.region.example.com
|
||||
Accept: */*
|
||||
Date: Mon, 14 Jan 2019 08:27:50 +0000
|
||||
Authorization: AWS UDSIAMSTUBTEST000094:ACgHHA1z+dqZhqS7D2SbU8ugluw=
|
||||
</pre></div>
|
||||
</td></tr></table></div>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001121228134__section22471632"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001121228134__screen8485113814"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
|
||||
2
|
||||
3
|
||||
4
|
||||
5</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 204 No Content
|
||||
Server: OBS
|
||||
x-amz-request-id: 000001697694073F80E9D3D43BB10B8F
|
||||
x-amz-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSyjWyXNRPSnFymJW0AI59GKpW0Qm9UJ
|
||||
Date: Wed, 13 Mar 2019 10:23:26 GMT
|
||||
</pre></div>
|
||||
</td></tr></table></div>
|
||||
</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>
|
||||
|
76
docs/obs/s3api/en-us_topic_0000001127815293.html
Normal file
@ -0,0 +1,76 @@
|
||||
<a name="EN-US_TOPIC_0000001127815293"></a><a name="EN-US_TOPIC_0000001127815293"></a>
|
||||
|
||||
<h1 class="topictitle1">DELETE Bucket Encryption</h1>
|
||||
<div id="body0000001127815293"><p id="EN-US_TOPIC_0000001127815293__p328123010563">OBS uses the DELETE method to delete the encryption configuration of a specified bucket.</p>
|
||||
<p id="EN-US_TOPIC_0000001127815293__p028114308563">To perform this operation, you must have the <strong id="EN-US_TOPIC_0000001127815293__b19156642205018">s3:PutEncryptionConfiguration</strong> permission. By default, only the bucket owner can delete the tags of a bucket. The bucket owner can allow other users to perform this operation by setting a bucket policy or granting them the permission.</p>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section57518732"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001127815293__screen19232727152544"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
|
||||
2
|
||||
3
|
||||
4
|
||||
5
|
||||
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE /?encryption HTTP/1.1
|
||||
User-Agent: curl/7.29.0
|
||||
Host: bucketname.obs.region.example.com
|
||||
Accept: */*
|
||||
Date: date
|
||||
Authorization: authorization string
|
||||
</pre></div>
|
||||
</td></tr></table></div>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section47906541"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0000001127815293__p1253411544512">This request contains no parameter.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section28505693"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="EN-US_TOPIC_0000001127815293__p30785969">This request uses common headers. For details about common request headers, see the section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section55224652"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="EN-US_TOPIC_0000001127815293__p10635570">This request involves no elements.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section46270551"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001127815293__screen1351602445911"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
|
||||
2
|
||||
3
|
||||
4
|
||||
5</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 status_code
|
||||
Server: OBS
|
||||
x-amz-request-id: request id
|
||||
x-amz-id-2: id
|
||||
Date: date
|
||||
</pre></div>
|
||||
</td></tr></table></div>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section13781782"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="EN-US_TOPIC_0000001127815293__p4179377">This response uses common headers. For details about common response headers, see the section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section56927182"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="EN-US_TOPIC_0000001127815293__p2985227">This response involves no elements.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section42582590"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0000001127815293__p8258615">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_0000001127815293__section32323009"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001127815293__screen5561411267"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
|
||||
2
|
||||
3
|
||||
4
|
||||
5
|
||||
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>DELETE /examplebucket?encryption HTTP/1.1
|
||||
User-Agent: curl/7.29.0
|
||||
Host: examplebucket.obs.region.example.com
|
||||
Accept: */*
|
||||
Date: Tue, 08 Jan 2019 13:18:35 +0000
|
||||
Authorization: OBS UDSIAMSTUBTEST000001:UT9F2YUgaFu9uFGMmxFj2CBgQHs=
|
||||
</pre></div>
|
||||
</td></tr></table></div>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0000001127815293__section22471632"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="EN-US_TOPIC_0000001127815293__screen1219123011919"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
|
||||
2
|
||||
3
|
||||
4
|
||||
5</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 204 No Content
|
||||
Server: OBS
|
||||
x-amz-request-id: 000001682D993B666808E265A3F6361D
|
||||
x-amz-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSyB46jGSQsu06m1nyIeKxTuJ+H27ooC
|
||||
Date: Tue, 08 Jan 2019 13:14:03 GMT
|
||||
</pre></div>
|
||||
</td></tr></table></div>
|
||||
</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>
|
||||
|
157
docs/obs/s3api/en-us_topic_0000001168027913.html
Normal file
106
docs/obs/s3api/en-us_topic_0000001168067883.html
Normal file
17
docs/obs/s3api/en-us_topic_0031665984.html
Normal file
@ -0,0 +1,17 @@
|
||||
<a name="en-us_topic_0031665984"></a><a name="en-us_topic_0031665984"></a>
|
||||
|
||||
<h1 class="topictitle1">Introduction</h1>
|
||||
<div id="body46439163"><p id="en-us_topic_0031665984__p3475872">This document describes the Representational State Transfer (REST) application programming interfaces (APIs) supported by Object Storage Service (compatible with Amazon S3), including request and response formats as well as parameters.</p>
|
||||
<p id="en-us_topic_0031665984__p19953103715913">You are advised to use OBS APIs to obtain comprehensive features with high compatibility. For details, see the <em id="en-us_topic_0031665984__i14917140121015">Object Storage Service API Reference (OBS)</em>.</p>
|
||||
</div>
|
||||
<div>
|
||||
<ul class="ullinks">
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560359.html">OBS</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560315.html">Compatibility of OBS REST APIs</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560365.html">Concurrent Operation Consistency</a></strong><br>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
413
docs/obs/s3api/en-us_topic_0125560237.html
Normal file
206
docs/obs/s3api/en-us_topic_0125560238.html
Normal file
14
docs/obs/s3api/en-us_topic_0125560240.html
Normal file
@ -0,0 +1,14 @@
|
||||
<a name="EN-US_TOPIC_0125560240"></a><a name="EN-US_TOPIC_0125560240"></a>
|
||||
|
||||
<h1 class="topictitle1">Common Headers</h1>
|
||||
<div id="body51788650"><p id="EN-US_TOPIC_0125560240__p34131082">This chapter describes common REST headers in OBS. The REST headers are classified as common request headers and common response headers.</p>
|
||||
</div>
|
||||
<div>
|
||||
<ul class="ullinks">
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560462.html">Common Request Headers</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560484.html">Common Response Headers</a></strong><br>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
170
docs/obs/s3api/en-us_topic_0125560243.html
Normal file
14
docs/obs/s3api/en-us_topic_0125560247.html
Normal file
@ -0,0 +1,14 @@
|
||||
<a name="EN-US_TOPIC_0125560247"></a><a name="EN-US_TOPIC_0125560247"></a>
|
||||
|
||||
<h1 class="topictitle1">Using ACL and Bucket Policy Simultaneously</h1>
|
||||
<div id="body56486210"><p id="EN-US_TOPIC_0125560247__p480656194610">If an ACL, roles, and a bucket policy are used at the same time and their authorization conflicts, the authorization priorities come as the bucket policy, roles, and the ACL.</p>
|
||||
<p id="EN-US_TOPIC_0125560247__p1180614614614">If a bucket policy and an IAM policy are applied to an account together, an explicit deny overrides allows, and an allow overrides default denies.</p>
|
||||
<p id="EN-US_TOPIC_0125560247__p54570172173137">Cross-tenant authorized access cannot be implemented for SSE-KMS-encrypted objects using the bucket ACL or policy.</p>
|
||||
<p id="EN-US_TOPIC_0125560247__p21369502173137"></p>
|
||||
</div>
|
||||
<div>
|
||||
<div class="familylinks">
|
||||
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560354.html">Access Control</a></div>
|
||||
</div>
|
||||
</div>
|
||||
|
240
docs/obs/s3api/en-us_topic_0125560248.html
Normal file
151
docs/obs/s3api/en-us_topic_0125560249.html
Normal file
375
docs/obs/s3api/en-us_topic_0125560255.html
Normal file
168
docs/obs/s3api/en-us_topic_0125560258.html
Normal file
193
docs/obs/s3api/en-us_topic_0125560261.html
Normal file
450
docs/obs/s3api/en-us_topic_0125560263.html
Normal file
297
docs/obs/s3api/en-us_topic_0125560266.html
Normal file
495
docs/obs/s3api/en-us_topic_0125560273.html
Normal file
150
docs/obs/s3api/en-us_topic_0125560276.html
Normal file
107
docs/obs/s3api/en-us_topic_0125560282.html
Normal file
324
docs/obs/s3api/en-us_topic_0125560285.html
Normal file
24
docs/obs/s3api/en-us_topic_0125560289.html
Normal file
@ -0,0 +1,24 @@
|
||||
<a name="EN-US_TOPIC_0125560289"></a><a name="EN-US_TOPIC_0125560289"></a>
|
||||
|
||||
<h1 class="topictitle1">OBS REST APIs</h1>
|
||||
<div id="body17871528"><p id="EN-US_TOPIC_0125560289__p38307653">This chapter explains how to use OBS REST APIs to access and operate the object storage service and introduces HTTP responses returned by OBS.</p>
|
||||
</div>
|
||||
<div>
|
||||
<ul class="ullinks">
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560479.html">Locating a Resource</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560363.html">Sending a Request</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560349.html">Naming a Bucket and Object</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560435.html">Authenticating a Request</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560478.html">Federal Authentication</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560255.html">Request Responses</a></strong><br>
|
||||
</li>
|
||||
<li class="ulchildlink"><strong><a href="en-us_topic_0125560343.html">Server-Side Encryption</a></strong><br>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
158
docs/obs/s3api/en-us_topic_0125560290.html
Normal file
215
docs/obs/s3api/en-us_topic_0125560291.html
Normal file
396
docs/obs/s3api/en-us_topic_0125560292.html
Normal file
62
docs/obs/s3api/en-us_topic_0125560293.html
Normal file
@ -0,0 +1,62 @@
|
||||
<a name="EN-US_TOPIC_0125560293"></a><a name="EN-US_TOPIC_0125560293"></a>
|
||||
|
||||
<h1 class="topictitle1">GET Bucket storage</h1>
|
||||
<div id="body60660131"><p id="EN-US_TOPIC_0125560293__p59183197">Using this operation, the bucket owner can obtain the bucket's storage information such as the bucket size and number of objects in the bucket. The bucket size is a nonnegative integer, expressed in bytes.</p>
|
||||
<div class="section" id="EN-US_TOPIC_0125560293__section2336166"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560293__screen16468485112539">GET /?storageinfo 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_0125560293__section21025500"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560293__p31872838">This request involves no parameters.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560293__section55011773"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560293__p31563057">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_0125560293__section25343916"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560293__p54375137">This request involves no elements.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560293__section1340439"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560293__screen1971776611261">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
|
||||
<Response Body></pre>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560293__section12063958"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560293__p25975146">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_0125560293__section41466763"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560293__p33532143">This response involves no elements.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560293__section37656551"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0125560293__p31749068">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_0125560293__section22366139"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560293__screen29663630112633">GET /?storageinfo HTTP/1.1
|
||||
User-Agent: Jakarta Commons-HttpClient/3.1
|
||||
Host: bucketname.obs.example.com
|
||||
Accept-Encoding: gzip,deflate
|
||||
Date: Sat, 20 Oct 2012 06:23:16 +0000
|
||||
Authorization: AWS 08350B985315591007AD:O4jTB/FzS3gXDouwRZgz1wiE2PE= </pre>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560293__section67077527"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560293__screen58094398112645">HTTP/1.1 200 OK
|
||||
Server: OBS
|
||||
x-amz-request-id: 001B21D48A580000013A7CD702AB0011
|
||||
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
|
||||
x-amz-id-2: 8NgBZD4YTt+Gi11OlhtdGE/zB1d/q6btnc+L3E5Iq0VU80pf+GtXUfZ9lVmrhU6J
|
||||
Content-Type: application/xml
|
||||
Date: Sat, 20 Oct 2012 06:23:16 GMT
|
||||
Content-Length: 209
|
||||
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
|
||||
<GetBucketStorageInfoResult xmlns="http://obs.example.com/doc/2015-06-30/">
|
||||
<Size>14960</Size>
|
||||
<ObjectNumber>11</ObjectNumber>
|
||||
</GetBucketStorageInfoResult></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>
|
||||
|
52
docs/obs/s3api/en-us_topic_0125560295.html
Normal file
@ -0,0 +1,52 @@
|
||||
<a name="EN-US_TOPIC_0125560295"></a><a name="EN-US_TOPIC_0125560295"></a>
|
||||
|
||||
<h1 class="topictitle1">DELETE Bucket website</h1>
|
||||
<div id="body55594619"><p class="msonormal" id="EN-US_TOPIC_0125560295__p2095077">You can use this operation to delete the website configuration of a bucket.</p>
|
||||
<p class="msonormal" id="EN-US_TOPIC_0125560295__p18855696">Only users granted the <strong id="EN-US_TOPIC_0125560295__b1812592711611">s3:DeleteBucketWebsite</strong> permission can delete the bucket website configuration. By default, only the bucket owner can delete the bucket website configuration. The bucket owner can allow other users to delete the bucket website configuration by granting them the permission.</p>
|
||||
<div class="section" id="EN-US_TOPIC_0125560295__section27556393"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560295__screen6538403612922"> DELETE /?website 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_0125560295__section46680953"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560295__p49509242">This request involves no parameters.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560295__section17475399"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560295__p50825680">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_0125560295__section23060868"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560295__p3345069">This request involves no elements.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560295__section46957633"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560295__screen4667246112935">HTTP/1.1 status_code
|
||||
Server: Server Name
|
||||
x-amz-request-id: request id
|
||||
x-amz-id-2: id
|
||||
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
|
||||
Date: date </pre>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560295__section19965518"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560295__p62595191">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_0125560295__section45471939"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560295__p47915191">This response involves no elements.</p>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560295__section6594274"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0125560295__p55925239">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_0125560295__section11442060"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560295__screen193515012949">DELETE /?website HTTP/1.1
|
||||
User-Agent: curl/7.29.0
|
||||
Host: bucketname.obs.example.com
|
||||
Accept: */*
|
||||
Date: Sat, 04 Jan 2014 06:55:26 +0000
|
||||
Authorization: AWS C6630CD15B645CB8A3BA:iWz49B3sO2HTFlcsKdEsSULl5GI=</pre>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560295__section35869679"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560295__screen1681098612957">HTTP/1.1 204 No Content
|
||||
Server: OBS
|
||||
x-amz-request-id: DCD2FC9CAB78000001435C08F1018EDD
|
||||
x-amz-id-2: QeEqZzxKPinUt9LmE9sFGcR+5xCpm2HoqFCqFFuFAB9Y84NcX6/MjhZqpN0+cE2P
|
||||
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
|
||||
Date: Sat, 04 Jan 2014 06:55:26 GMT</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>
|
||||
|
209
docs/obs/s3api/en-us_topic_0125560299.html
Normal file
197
docs/obs/s3api/en-us_topic_0125560305.html
Normal file
70
docs/obs/s3api/en-us_topic_0125560307.html
Normal file
@ -0,0 +1,70 @@
|
||||
<a name="EN-US_TOPIC_0125560307"></a><a name="EN-US_TOPIC_0125560307"></a>
|
||||
|
||||
<h1 class="topictitle1">Error Responses Syntax</h1>
|
||||
<div id="body29682946"><div class="section" id="EN-US_TOPIC_0125560307__section43457779"><h4 class="sectiontitle">Error Response Headers</h4><p id="EN-US_TOPIC_0125560307__p55508446">In an error response, header information contains:</p>
|
||||
<ul id="EN-US_TOPIC_0125560307__ul29813974"><li id="EN-US_TOPIC_0125560307__li66999175">Content-Type: application/xml</li><li id="EN-US_TOPIC_0125560307__li66121668">HTTP status code 3<em id="EN-US_TOPIC_0125560307__i58224100">xx</em>, 4<em id="EN-US_TOPIC_0125560307__i54254858">xx</em>, or 5<em id="EN-US_TOPIC_0125560307__i18531678">xx</em>. For details, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</li></ul>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560307__section55575695"><h4 class="sectiontitle">Error Response Body</h4><p id="EN-US_TOPIC_0125560307__p20711872">The response body contains several elements that provide error details. The following is an example error response containing all common elements in REST error responses:</p>
|
||||
<pre class="screen" id="EN-US_TOPIC_0125560307__screen2218761312193"><?xml version="1.0" encoding="UTF-8"?>
|
||||
<Error>
|
||||
<Code>NoSuchKey</Code>
|
||||
<Message>The resource you requested does not exist</Message>
|
||||
<Resource>/example-bucket/object</Resource>
|
||||
<RequestId>001B21A61C6C0000013402C4616D5285</RequestId>
|
||||
<HostId>RkRCRDJENDc5MzdGQkQ4OUY3MTI4NTQ3NDk2Mjg0M0FB
|
||||
QUFBQUFBYmJiYmJiYmJD</HostId>
|
||||
</Error> </pre>
|
||||
</div>
|
||||
<div class="section" id="EN-US_TOPIC_0125560307__section30419215"><h4 class="sectiontitle">Error Response Elements</h4><p id="EN-US_TOPIC_0125560307__p24863727"><a href="#EN-US_TOPIC_0125560307__table5435182">Table 1</a> describes REST response elements.</p>
|
||||
|
||||
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560307__table5435182"></a><a name="table5435182"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560307__table5435182" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Error response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560307__row3125665"><th align="left" class="cellrowborder" valign="top" width="24.25%" id="mcps1.3.3.3.2.3.1.1"><p id="EN-US_TOPIC_0125560307__p51852321">Element</p>
|
||||
</th>
|
||||
<th align="left" class="cellrowborder" valign="top" width="75.75%" id="mcps1.3.3.3.2.3.1.2"><p id="EN-US_TOPIC_0125560307__p39288453">Description</p>
|
||||
</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody><tr id="EN-US_TOPIC_0125560307__row28248118"><td class="cellrowborder" valign="top" width="24.25%" headers="mcps1.3.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560307__p6396187">Error</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="75.75%" headers="mcps1.3.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560307__p48329116">Container of all error elements.</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="EN-US_TOPIC_0125560307__row32308867"><td class="cellrowborder" valign="top" width="24.25%" headers="mcps1.3.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560307__p66881467">Code</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="75.75%" headers="mcps1.3.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560307__p48689731">A string that uniquely identifies an error. For details about error codes, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="EN-US_TOPIC_0125560307__row51554115"><td class="cellrowborder" valign="top" width="24.25%" headers="mcps1.3.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560307__p15133796">Message</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="75.75%" headers="mcps1.3.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560307__p17877965">Error details in the XML format. For details about error codes, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="EN-US_TOPIC_0125560307__row38829095"><td class="cellrowborder" valign="top" width="24.25%" headers="mcps1.3.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560307__p58149018">RequestId</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="75.75%" headers="mcps1.3.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560307__p12449997">ID of the request whose error response is returned. The ID is used for locating internal errors.</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="EN-US_TOPIC_0125560307__row44941110"><td class="cellrowborder" valign="top" width="24.25%" headers="mcps1.3.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560307__p16351276">HostId</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="75.75%" headers="mcps1.3.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560307__p49385016">ID of the server that returns an error response.</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr id="EN-US_TOPIC_0125560307__row41811960"><td class="cellrowborder" valign="top" width="24.25%" headers="mcps1.3.3.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560307__p31325629">Resource</p>
|
||||
</td>
|
||||
<td class="cellrowborder" valign="top" width="75.75%" headers="mcps1.3.3.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560307__p54348043">The requested resource such as a bucket or object.</p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<p id="EN-US_TOPIC_0125560307__p19370340"></p>
|
||||
<div class="note" id="EN-US_TOPIC_0125560307__note40115337"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0125560307__p25493713">Many error responses contain additional structured data, which can be easily read and understood during error diagnosis.</p>
|
||||
</div></div>
|
||||
<p id="EN-US_TOPIC_0125560307__p28116831"></p>
|
||||
</div>
|
||||
</div>
|
||||
<div>
|
||||
<div class="familylinks">
|
||||
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560387.html">Error Responses</a></div>
|
||||
</div>
|
||||
</div>
|
||||
|