vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/api-swift/obs_03_0011.html
zhangyue 894279c39a Object Storage Service API Reference Swift V1 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2023-02-02 08:50:48 +00:00

319 lines
28 KiB
HTML
Raw Blame History

<a name="obs_03_0011"></a><a name="obs_03_0011"></a>
<h1 class="topictitle1">Responses</h1>
<div id="body8662426"><p id="obs_03_0011__p33022149">OBS (compatible with OpenStack Swift) returns an HTTP response after receiving and processing a request.</p>
<div class="section" id="obs_03_0011__section37018344"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="obs_03_0011__screen57548404">Status Line: HTTP-Version Status-Code Reason-Phrase
Response Headers
&lt;Conditional Response Body&gt;</pre>
</div>
<div class="section" id="obs_03_0011__section48173595"><h4 class="sectiontitle">Status Line</h4><p id="obs_03_0011__p42522357">The first line of a response is the Status-Line, consisting of the protocol version, numeric status code, and textual phrases. The previous elements are separated by spaces. See <a href="obs_03_0011.html#obs_03_0011__table47156901">Table 1</a>.</p>
<div class="tablenoborder"><a name="obs_03_0011__table47156901"></a><a name="table47156901"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0011__table47156901" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Status line elements</caption><thead align="left"><tr id="obs_03_0011__row43952359"><th align="left" class="cellrowborder" valign="top" width="34.39%" id="mcps1.3.3.3.2.3.1.1"><p id="obs_03_0011__p3371364">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="65.61%" id="mcps1.3.3.3.2.3.1.2"><p id="obs_03_0011__p41805515">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0011__row8796476"><td class="cellrowborder" valign="top" width="34.39%" headers="mcps1.3.3.3.2.3.1.1 "><p id="obs_03_0011__p41425962">HTTP-Version</p>
</td>
<td class="cellrowborder" valign="top" width="65.61%" headers="mcps1.3.3.3.2.3.1.2 "><p id="obs_03_0011__p59801">HTTP version. OBS (compatible with OpenStack Swift) uses HTTP 1.1.</p>
</td>
</tr>
<tr id="obs_03_0011__row538217"><td class="cellrowborder" valign="top" width="34.39%" headers="mcps1.3.3.3.2.3.1.1 "><p id="obs_03_0011__p43595579">Status-Code</p>
</td>
<td class="cellrowborder" valign="top" width="65.61%" headers="mcps1.3.3.3.2.3.1.2 "><p id="obs_03_0011__p41581026">Status code, which describes the response type.</p>
</td>
</tr>
<tr id="obs_03_0011__row38684921"><td class="cellrowborder" valign="top" width="34.39%" headers="mcps1.3.3.3.2.3.1.1 "><p id="obs_03_0011__p46470906">Reason-Phrase</p>
</td>
<td class="cellrowborder" valign="top" width="65.61%" headers="mcps1.3.3.3.2.3.1.2 "><p id="obs_03_0011__p6047043">Reason phrase, which describes the status code in a short text.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="obs_03_0011__p20048509">The first digit of the status code defines the response type. The last two digits do not have this function. There are five types of status codes, categorized based on the first digit. The categories are described in <a href="#obs_03_0011__table46218860">Table 2</a>.</p>
<div class="tablenoborder"><a name="obs_03_0011__table46218860"></a><a name="table46218860"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0011__table46218860" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Status codes in OBS (compatible with OpenStack Swift)</caption><thead align="left"><tr id="obs_03_0011__row15005906"><th align="left" class="cellrowborder" valign="top" width="21.44%" id="mcps1.3.3.5.2.3.1.1"><p id="obs_03_0011__p7518910">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="78.56%" id="mcps1.3.3.5.2.3.1.2"><p id="obs_03_0011__p45467475">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0011__row62876022"><td class="cellrowborder" valign="top" width="21.44%" headers="mcps1.3.3.5.2.3.1.1 "><p id="obs_03_0011__p64059033">1xx</p>
</td>
<td class="cellrowborder" valign="top" width="78.56%" headers="mcps1.3.3.5.2.3.1.2 "><p id="obs_03_0011__p52338508">The server has received but is still processing the request.</p>
</td>
</tr>
<tr id="obs_03_0011__row61119882"><td class="cellrowborder" valign="top" width="21.44%" headers="mcps1.3.3.5.2.3.1.1 "><p id="obs_03_0011__p51763415">2xx</p>
</td>
<td class="cellrowborder" valign="top" width="78.56%" headers="mcps1.3.3.5.2.3.1.2 "><p id="obs_03_0011__p32087105">The request has been received, understood, and accepted.</p>
</td>
</tr>
<tr id="obs_03_0011__row20348492"><td class="cellrowborder" valign="top" width="21.44%" headers="mcps1.3.3.5.2.3.1.1 "><p id="obs_03_0011__p37615147">3xx</p>
</td>
<td class="cellrowborder" valign="top" width="78.56%" headers="mcps1.3.3.5.2.3.1.2 "><p id="obs_03_0011__p26928091">The client must take further actions to complete the request.</p>
</td>
</tr>
<tr id="obs_03_0011__row41026233"><td class="cellrowborder" valign="top" width="21.44%" headers="mcps1.3.3.5.2.3.1.1 "><p id="obs_03_0011__p34790565">4xx</p>
</td>
<td class="cellrowborder" valign="top" width="78.56%" headers="mcps1.3.3.5.2.3.1.2 "><p id="obs_03_0011__p66572341">There was an error on the client side. The request contains bad syntax or cannot be fulfilled.</p>
</td>
</tr>
<tr id="obs_03_0011__row62280158"><td class="cellrowborder" valign="top" width="21.44%" headers="mcps1.3.3.5.2.3.1.1 "><p id="obs_03_0011__p11528032">5xx</p>
</td>
<td class="cellrowborder" valign="top" width="78.56%" headers="mcps1.3.3.5.2.3.1.2 "><p id="obs_03_0011__p61355386">There was an error on the server side. The server failed to fulfill a valid request.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="obs_03_0011__ul3228060911225"><li id="obs_03_0011__li2209003211225">A 1xx status code is a provisional response. <a href="#obs_03_0011__table52995244111757">Table 3</a> describes the 1xx status code in OBS (compatible with OpenStack Swift).</li></ul>
<div class="tablenoborder"><a name="obs_03_0011__table52995244111757"></a><a name="table52995244111757"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0011__table52995244111757" frame="border" border="1" rules="all"><caption><b>Table 3 </b>1xx status code</caption><thead align="left"><tr id="obs_03_0011__row29855049111757"><th align="left" class="cellrowborder" valign="top" width="19.17%" id="mcps1.3.3.7.2.4.1.1"><p id="obs_03_0011__p7460031111835">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.690000000000005%" id="mcps1.3.3.7.2.4.1.2"><p id="obs_03_0011__p2544753111835">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="29.14%" id="mcps1.3.3.7.2.4.1.3"><p id="obs_03_0011__p43185690111835">Returned After</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0011__row58673429111757"><td class="cellrowborder" valign="top" width="19.17%" headers="mcps1.3.3.7.2.4.1.1 "><p id="obs_03_0011__p2095015111835">100 Continue</p>
</td>
<td class="cellrowborder" valign="top" width="51.690000000000005%" headers="mcps1.3.3.7.2.4.1.2 "><p id="obs_03_0011__p20943865112432">The initial part of the request has been received and has not yet been rejected by the server and the client should continue with its request.</p>
</td>
<td class="cellrowborder" valign="top" width="29.14%" headers="mcps1.3.3.7.2.4.1.3 "><ul id="obs_03_0011__ul55189990111835"><li id="obs_03_0011__li49203430111835">PUT Object</li><li id="obs_03_0011__li320019811233">POST Object</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="obs_03_0011__ul38345667112138"><li id="obs_03_0011__li9566689112138">A 2xx status code indicates that a request has been successfully processed by the server. <a href="obs_03_0011.html#obs_03_0011__table33573506">Table 4</a> describes all 2xx status codes in OBS (compatible with OpenStack Swift).</li></ul>
<div class="tablenoborder"><a name="obs_03_0011__table33573506"></a><a name="table33573506"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0011__table33573506" frame="border" border="1" rules="all"><caption><b>Table 4 </b>2xx status codes</caption><thead align="left"><tr id="obs_03_0011__row66704998"><th align="left" class="cellrowborder" valign="top" width="18.740000000000002%" id="mcps1.3.3.9.2.4.1.1"><p id="obs_03_0011__p34395739">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.89%" id="mcps1.3.3.9.2.4.1.2"><p id="obs_03_0011__p42887950">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="29.37%" id="mcps1.3.3.9.2.4.1.3"><p id="obs_03_0011__p59693950">Returned After</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0011__row30346328"><td class="cellrowborder" valign="top" width="18.740000000000002%" headers="mcps1.3.3.9.2.4.1.1 "><p id="obs_03_0011__p42133519">200 OK</p>
</td>
<td class="cellrowborder" valign="top" width="51.89%" headers="mcps1.3.3.9.2.4.1.2 "><p id="obs_03_0011__p57371907">The server has received and accepted the client's request.</p>
</td>
<td class="cellrowborder" valign="top" width="29.37%" headers="mcps1.3.3.9.2.4.1.3 "><ul id="obs_03_0011__ul4132170419915"><li id="obs_03_0011__li3635101819915">List Objects</li><li id="obs_03_0011__li5872371419915">GET Object</li><li id="obs_03_0011__li5875138419915">GET Object Metadata</li></ul>
</td>
</tr>
<tr id="obs_03_0011__row37559624"><td class="cellrowborder" valign="top" width="18.740000000000002%" headers="mcps1.3.3.9.2.4.1.1 "><p id="obs_03_0011__p22430675">201 Created</p>
</td>
<td class="cellrowborder" valign="top" width="51.89%" headers="mcps1.3.3.9.2.4.1.2 "><p id="obs_03_0011__p4945391">The response may contain an XML file. The XML file describes the response content.</p>
</td>
<td class="cellrowborder" valign="top" width="29.37%" headers="mcps1.3.3.9.2.4.1.3 "><ul id="obs_03_0011__ul809924219195"><li id="obs_03_0011__li578431919195">PUT Container</li><li id="obs_03_0011__li23720604191912">PUT Object</li></ul>
</td>
</tr>
<tr id="obs_03_0011__row48981207192048"><td class="cellrowborder" valign="top" width="18.740000000000002%" headers="mcps1.3.3.9.2.4.1.1 "><p id="obs_03_0011__p8054840192048">202 Accepted</p>
</td>
<td class="cellrowborder" valign="top" width="51.89%" headers="mcps1.3.3.9.2.4.1.2 "><p id="obs_03_0011__p48462305192048">The server has received the request.</p>
</td>
<td class="cellrowborder" valign="top" width="29.37%" headers="mcps1.3.3.9.2.4.1.3 "><ul id="obs_03_0011__ul55956597192116"><li id="obs_03_0011__li33847333192116">POST operations (Update object metadata)</li></ul>
</td>
</tr>
<tr id="obs_03_0011__row33132024"><td class="cellrowborder" valign="top" width="18.740000000000002%" headers="mcps1.3.3.9.2.4.1.1 "><p id="obs_03_0011__p66448310">204 No Content</p>
</td>
<td class="cellrowborder" valign="top" width="51.89%" headers="mcps1.3.3.9.2.4.1.2 "><p id="obs_03_0011__p13604004">The server has processed a request successfully, but no content was returned.</p>
</td>
<td class="cellrowborder" valign="top" width="29.37%" headers="mcps1.3.3.9.2.4.1.3 "><ul id="obs_03_0011__ul28182506"><li id="obs_03_0011__li159451021022">HEAD Container</li><li id="obs_03_0011__li1435059221022">POST operations on access control lists (ACLs)</li><li id="obs_03_0011__li6204647121022">DELETE Object</li><li id="obs_03_0011__li2154733121022">DELETE Container</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="obs_03_0011__ul15327568"><li id="obs_03_0011__li50270944">A 3xx status code indicates that a request can be successfully processed only after being redirected. <a href="obs_03_0011.html#obs_03_0011__table49785318">Table 5</a> describes all 3xx status codes in OBS (compatible with OpenStack Swift).</li></ul>
<div class="tablenoborder"><a name="obs_03_0011__table49785318"></a><a name="table49785318"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0011__table49785318" frame="border" border="1" rules="all"><caption><b>Table 5 </b>3xx status codes</caption><thead align="left"><tr id="obs_03_0011__row57477797"><th align="left" class="cellrowborder" valign="top" width="18.08180818081808%" id="mcps1.3.3.11.2.4.1.1"><p id="obs_03_0011__p25189967">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.55465546554656%" id="mcps1.3.3.11.2.4.1.2"><p id="obs_03_0011__p42766607">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="35.36353635363537%" id="mcps1.3.3.11.2.4.1.3"><p id="obs_03_0011__p38344177">Returned After</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0011__row35618305"><td class="cellrowborder" valign="top" width="18.08180818081808%" headers="mcps1.3.3.11.2.4.1.1 "><p id="obs_03_0011__p66510437">303 See Other</p>
</td>
<td class="cellrowborder" valign="top" width="46.55465546554656%" headers="mcps1.3.3.11.2.4.1.2 "><p id="obs_03_0011__p18636310">The client can use another URL to get a specific object.</p>
</td>
<td class="cellrowborder" valign="top" width="35.36353635363537%" headers="mcps1.3.3.11.2.4.1.3 "><p id="obs_03_0011__p33146107">POST operations (provided that redirection parameters in requests are valid.)</p>
</td>
</tr>
<tr id="obs_03_0011__row29879508"><td class="cellrowborder" valign="top" width="18.08180818081808%" headers="mcps1.3.3.11.2.4.1.1 "><p id="obs_03_0011__p4321123">304 Not Modified</p>
</td>
<td class="cellrowborder" valign="top" width="46.55465546554656%" headers="mcps1.3.3.11.2.4.1.2 "><p id="obs_03_0011__p14466715">After the client sent a GET request with the required modification time, access was allowed but the resource was not modified after the specified time.</p>
</td>
<td class="cellrowborder" valign="top" width="35.36353635363537%" headers="mcps1.3.3.11.2.4.1.3 "><p id="obs_03_0011__p30953251">The resource is obtained but the modification time condition is not met.</p>
</td>
</tr>
<tr id="obs_03_0011__row29907717"><td class="cellrowborder" valign="top" width="18.08180818081808%" headers="mcps1.3.3.11.2.4.1.1 "><p id="obs_03_0011__p36058933">307 Moved Temporarily</p>
</td>
<td class="cellrowborder" valign="top" width="46.55465546554656%" headers="mcps1.3.3.11.2.4.1.2 "><p id="obs_03_0011__p55363939">A request has been redirected.</p>
</td>
<td class="cellrowborder" valign="top" width="35.36353635363537%" headers="mcps1.3.3.11.2.4.1.3 "><p id="obs_03_0011__p41397110">A request is redirected after it fails to be processed by the server.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="obs_03_0011__ul2253724893631"><li id="obs_03_0011__li10143804">A 4xx status code indicates that a request failed to be processed due to a client error. A 4xx status code is returned together with a response body containing error details. 4xx status codes apply to all request methods except HEAD. For more details, see the definition of 4xx status codes.</li></ul>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0011__table19085693" frame="border" border="1" rules="all"><caption><b>Table 6 </b>4xx status codes</caption><thead align="left"><tr id="obs_03_0011__row38288479"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.13.2.4.1.1"><p id="obs_03_0011__p39544387">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.13.2.4.1.2"><p id="obs_03_0011__p9737746">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.13.2.4.1.3"><p id="obs_03_0011__p16489013">Returned After</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0011__row9908272"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.1 "><p id="obs_03_0011__p18654746">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.2 "><p id="obs_03_0011__p27090946">The syntax of a request was incorrect.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.3 "><p id="obs_03_0011__p6185012">A request in incorrect syntax or containing incorrect parameters is sent.</p>
</td>
</tr>
<tr id="obs_03_0011__row3245972720531"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.1 "><p id="obs_03_0011__p1199219720531">401 Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.2 "><p id="obs_03_0011__p3184390020531">The request could not be authenticated.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.3 "><p id="obs_03_0011__p2921909920531">The user does not exist or the authentication information in a sent request is incorrect.</p>
</td>
</tr>
<tr id="obs_03_0011__row62932594"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.1 "><p id="obs_03_0011__p7077171">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.2 "><p id="obs_03_0011__p20407581">The server refused the request.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.3 "><p id="obs_03_0011__p40427477">The user does not have sufficient permissions.</p>
</td>
</tr>
<tr id="obs_03_0011__row15964395"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.1 "><p id="obs_03_0011__p45635608">404 Not Found</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.2 "><p id="obs_03_0011__p988347">The requested resource does not exist.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.3 "><p id="obs_03_0011__p13737275">The requested resource (such as a container or object) does not exist.</p>
</td>
</tr>
<tr id="obs_03_0011__row61354196"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.1 "><p id="obs_03_0011__p27211468">411 Length Required</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.2 "><p id="obs_03_0011__p28625474">The request header did not contain the required <strong id="obs_03_0011__b37959091">Content-Length</strong> or <strong id="obs_03_0011__b8423527061012">Transfer-Encoding</strong> field.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.3 "><p id="obs_03_0011__p39963934">A request containing no <strong id="obs_03_0011__b23325828">Content-Length</strong> header is sent.</p>
</td>
</tr>
<tr id="obs_03_0011__row654012171047"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.1 "><p id="obs_03_0011__p1554061717414">412 Precondition Failed</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.2 "><p id="obs_03_0011__p11540417545">Conditions are not met.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.3 "><p id="obs_03_0011__p35404179416">Conditions are not met, if the object query request contains the <strong id="obs_03_0011__b84235270610253">If-Match</strong> or <strong id="obs_03_0011__b8423527061031">If-None-Match</strong> header.</p>
</td>
</tr>
<tr id="obs_03_0011__row531414131553"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.1 "><p id="obs_03_0011__p1031661315518">413 Request Entity Too Large</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.2 "><p id="obs_03_0011__p16316121311557">Insufficient user quota.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.13.2.4.1.3 "><p id="obs_03_0011__p19316161345517">User storage capacity exceeds user quota when uploading or replicating objects.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="obs_03_0011__ul5904128893618"><li id="obs_03_0011__li24185379">A 5xx status code means that the server encountered an error when processing the request or failed to process the request. Except for HEAD requests, a 5xx status code is returned together with a response body containing error details. <a href="obs_03_0011.html#obs_03_0011__table16341824">Table 7</a> describes all 5xx status codes in OBS (compatible with OpenStack Swift).</li></ul>
<div class="tablenoborder"><a name="obs_03_0011__table16341824"></a><a name="table16341824"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0011__table16341824" frame="border" border="1" rules="all"><caption><b>Table 7 </b>5xx status codes</caption><thead align="left"><tr id="obs_03_0011__row7897978"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.15.2.4.1.1"><p id="obs_03_0011__p35756461">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.15.2.4.1.2"><p id="obs_03_0011__p28220940">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.15.2.4.1.3"><p id="obs_03_0011__p37753560">Returned After</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0011__row7711627"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.15.2.4.1.1 "><p id="obs_03_0011__p20662084">500 Internal Error</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.15.2.4.1.2 "><p id="obs_03_0011__p63016113">An internal error occurred on the server.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.15.2.4.1.3 "><p id="obs_03_0011__p4031547">An internal error occurred on the server.</p>
</td>
</tr>
<tr id="obs_03_0011__row40894175"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.15.2.4.1.1 "><p id="obs_03_0011__p57491299">503 Service Unavailable</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.15.2.4.1.2 "><p id="obs_03_0011__p28819977">The server was overloaded.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.15.2.4.1.3 "><p id="obs_03_0011__p27310200">The server is processing too many requests.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_03_0011__section30909172"><h4 class="sectiontitle">Response Headers</h4><p id="obs_03_0011__p58119881">A response header is the information appended to a response, as described in <a href="obs_03_0011.html#obs_03_0011__table53316885">Table 8</a>. Response headers describe the server and contain further information about accessing the requested resource.</p>
<div class="tablenoborder"><a name="obs_03_0011__table53316885"></a><a name="table53316885"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0011__table53316885" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Response headers</caption><thead align="left"><tr id="obs_03_0011__row66949839"><th align="left" class="cellrowborder" valign="top" width="22.15%" id="mcps1.3.4.3.2.4.1.1"><p id="obs_03_0011__p54227851">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="39.01%" id="mcps1.3.4.3.2.4.1.2"><p id="obs_03_0011__p4983076">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="38.84%" id="mcps1.3.4.3.2.4.1.3"><p id="obs_03_0011__p8784284">Applicable To</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0011__row28401526"><td class="cellrowborder" valign="top" width="22.15%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_03_0011__p18822307">Content-Length</p>
</td>
<td class="cellrowborder" valign="top" width="39.01%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_03_0011__p48211888">Length of a response body</p>
</td>
<td class="cellrowborder" valign="top" width="38.84%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_03_0011__p12848837">All responses (except those responses whose transfer-encoding is chunked)</p>
</td>
</tr>
<tr id="obs_03_0011__row48530675"><td class="cellrowborder" valign="top" width="22.15%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_03_0011__p38670568">Date</p>
</td>
<td class="cellrowborder" valign="top" width="39.01%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_03_0011__p45308281">The date and time when a response was generated</p>
</td>
<td class="cellrowborder" valign="top" width="38.84%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_03_0011__p23205770">All responses</p>
</td>
</tr>
<tr id="obs_03_0011__row12176400"><td class="cellrowborder" valign="top" width="22.15%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_03_0011__p46764328">X-Trans-Id</p>
</td>
<td class="cellrowborder" valign="top" width="39.01%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_03_0011__p29814200">A unique identifier generated by OBS (compatible with OpenStack Swift) for a request</p>
</td>
<td class="cellrowborder" valign="top" width="38.84%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_03_0011__p27453078">All responses</p>
</td>
</tr>
<tr id="obs_03_0011__row37925019222057"><td class="cellrowborder" valign="top" width="22.15%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_03_0011__p30071130104918">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="39.01%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_03_0011__p45466191104918">The object type returned</p>
</td>
<td class="cellrowborder" valign="top" width="38.84%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_03_0011__p16837049104918">All responses</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="obs_03_0011__note6166340215199"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_03_0011__p1809971415199">OBS (compatible with OpenStack Swift) normalizes the content of the <strong id="obs_03_0011__b14797678">Content-Type</strong>. The content returned is different from that returned by OpenStack Swift in the following way:</p>
<ul id="obs_03_0011__ul1986635815214"><li id="obs_03_0011__li4967420615214"><strong id="obs_03_0011__b33984603217315">Content-Type</strong> content uses only <strong id="obs_03_0011__b213441406317315">charset=UTF-8</strong> (UTF in uppercase).</li></ul>
</div></div>
</div>
<div class="section" id="obs_03_0011__section9747098"><h4 class="sectiontitle">Response Body</h4><p id="obs_03_0011__p7450793">In OBS (compatible with OpenStack Swift), a response body is included in a request response under the following conditions:</p>
<ul id="obs_03_0011__ul49593175"><li id="obs_03_0011__li33089920">GET Object<p id="obs_03_0011__p39050926"><a name="obs_03_0011__li33089920"></a><a name="li33089920"></a>If the object is not blank, the response body is the object body.</p>
</li><li id="obs_03_0011__li64103799193042">GET Account or Container<p id="obs_03_0011__p37805661193042"><a name="obs_03_0011__li64103799193042"></a><a name="li64103799193042"></a>The response body is account or container information.</p>
</li></ul>
<ul id="obs_03_0011__ul47927018"><li id="obs_03_0011__li47215418">Client error<p id="obs_03_0011__p594810"><a name="obs_03_0011__li47215418"></a><a name="li47215418"></a>The response body describes the client error in detail in XML format so that the user can perform further operations. For details, see client error response codes.</p>
</li><li id="obs_03_0011__li2720678193152">Server error<p id="obs_03_0011__p48301855193152"><a name="obs_03_0011__li2720678193152"></a><a name="li2720678193152"></a>The response body describes the server error in detail in XML format so that the user can perform further operations.</p>
</li></ul>
</div>
<div class="section" id="obs_03_0011__section20615021"><h4 class="sectiontitle">Error Responses</h4><p id="obs_03_0011__p31366578">OBS (compatible with OpenStack Swift) returns an error response if a request is incorrect, the permission is incorrect, or the requested container or object is not found. An error response describes the error. When you upload an object, if permissions cannot be authenticated, the following information (in HTML format) is displayed:</p>
<pre class="screen" id="obs_03_0011__screen4832722105829">&lt;html&gt;&lt;h1&gt;Unauthorized&lt;/h1&gt;&lt;p&gt;This server could not verify that you are authorized to access the document you requested.&lt;/p&gt;&lt;/html&gt;</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0006.html">Methods of Calling APIs</a></div>
</div>
</div>
View Git Blame Copy Permalink