forked from docs/doc-exports
zhangyue
7d2a7ec198
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
78 lines
6.4 KiB
HTML
78 lines
6.4 KiB
HTML
<a name="obs_04_0013"></a><a name="obs_04_0013"></a>
|
|
|
|
<h1 class="topictitle1">Returned Values</h1>
|
|
<div id="body1559725268739"><p id="obs_04_0013__p91929371531">After sending a request, you will receive a response, including the status code, response header, and response body.</p>
|
|
<div class="section" id="obs_04_0013__section9372312739"><h4 class="sectiontitle">Status Codes</h4><p id="obs_04_0013__p127892023034">A status code is a group of digits ranging from 2<em id="obs_04_0013__i3412193934115">xx</em> (indicating successes) to 4<em id="obs_04_0013__i1841363918414">xx</em> or 5<em id="obs_04_0013__i1386995015421">xx</em> (indicating errors). It indicates the status of a response. For more information, see <a href="obs_04_0114.html">Status Codes</a>.</p>
|
|
</div>
|
|
<div class="section" id="obs_04_0013__section7804143005810"><h4 class="sectiontitle">Response Headers</h4><p id="obs_04_0013__p8893366518">Responses have some headers matching their corresponding requests, for example, <strong id="obs_04_0013__b15542134973313">Content-Length</strong>.</p>
|
|
<div class="p" id="obs_04_0013__p186593415539">For details about common response headers, see <a href="#obs_04_0013__d0e686">Table 1</a>.
|
|
<div class="tablenoborder"><a name="obs_04_0013__d0e686"></a><a name="d0e686"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0013__d0e686" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Common response headers</caption><thead align="left"><tr id="obs_04_0013__row58885148"><th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.3.3.2.2.3.1.1"><p id="obs_04_0013__p4967702">Header</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="77%" id="mcps1.3.3.3.2.2.3.1.2"><p id="obs_04_0013__p66839572">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0013__row45296255"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p45118014">Content-Length</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p30680506">The length (in bytes) of the response body.</p>
|
|
<p id="obs_04_0013__p7689098">Type: string</p>
|
|
<p id="obs_04_0013__p2093018">Default value: none</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0013__row18837163"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p49415229">Connection</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p43210599">Indicates whether the connection to the server is a long connection or a short connection.</p>
|
|
<p id="obs_04_0013__p53351077">Type: string</p>
|
|
<p id="obs_04_0013__p10397650">Value options: <strong id="obs_04_0013__b11372729122511">keep-alive</strong>, <strong id="obs_04_0013__b14661328256">close</strong></p>
|
|
<p id="obs_04_0013__p26469991">Default value: none</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0013__row36903334"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p36380041">Date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p61102246">The date and time at which OBS responds to the request.</p>
|
|
<p id="obs_04_0013__p13049305">Type: string</p>
|
|
<p id="obs_04_0013__p50334883">Default value: none</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0013__row50360765"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p52690158">ETag</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p40044371">128-bit MD5 digest of the Base64 code of an object. ETag is the unique identifier of the object content. It can be used to determine whether the object content is changed. For example, if ETag value is <strong id="obs_04_0013__b1729195513584">A</strong> when an object is uploaded and the ETag value has changed to <strong id="obs_04_0013__b773055585819">B</strong> when the object is downloaded, it indicates that the object content is changed. The actual ETag is the hash value of the object, which only reflects the changed content rather than the metadata. An uploaded object or copied object has a unique ETag after being encrypted using MD5. If an object is uploaded in the multipart mode, the MD5 splits ETag regardless of the encryption method. In this case, the ETag is not an MD5 digest.</p>
|
|
<p id="obs_04_0013__p24855020">Type: string</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0013__row22368596"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p67025883">x-obs-id-2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p60387405">A special symbol that helps troubleshoot faults.</p>
|
|
<p id="obs_04_0013__p6615739">Type: string</p>
|
|
<p id="obs_04_0013__p59541652">Default value: none</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0013__row41295227390"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p8684623103914">x-reserved-indicator</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p4684123183911">A special symbol that helps troubleshoot faults.</p>
|
|
<p id="obs_04_0013__p8684182343912">Type: string</p>
|
|
<p id="obs_04_0013__p4684142383916">Default value: none</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0013__row66112827"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.3.2.2.3.1.1 "><p id="obs_04_0013__p53538780">x-obs-request-id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.3.3.2.2.3.1.2 "><p id="obs_04_0013__p41673925">The value created by OBS to uniquely identify the request. OBS uses this value to troubleshoot faults.</p>
|
|
<p id="obs_04_0013__p39521013">Type: string</p>
|
|
<p id="obs_04_0013__p20144799">Default value: none</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0013__section034615592583"><h4 class="sectiontitle">(Optional) Response Body</h4><p id="obs_04_0013__p133921631940">A response body is generally returned in a structured format (for example, JSON or XML), corresponding to <strong id="obs_04_0013__b842352706144729">Content-Type</strong> in the response header, and is used to transfer content other than the response header.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0006.html">Calling APIs</a></div>
|
|
</div>
|
|
</div>
|
|
|