doc-exports/docs/obs/api-swift/obs_03_0031.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

147 lines
10 KiB
HTML

<a name="obs_03_0031"></a><a name="obs_03_0031"></a>
<h1 class="topictitle1">Response</h1>
<div id="body1442461140552"><div class="section" id="obs_03_0031__section30570743"><h4 class="sectiontitle">Response Headers</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0031__table59658522144238" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_03_0031__row55181501144238"><th align="left" class="cellrowborder" valign="top" width="38.279999999999994%" id="mcps1.3.1.2.1.4.1.1"><p id="obs_03_0031__p16639091195249">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.509999999999998%" id="mcps1.3.1.2.1.4.1.2"><p id="obs_03_0031__p7217399195249">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.21%" id="mcps1.3.1.2.1.4.1.3"><p id="obs_03_0031__p43692246195249">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0031__row13548066144238"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p23651575144238">Accept-Ranges</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p36729408144238">String</p>
<p id="obs_03_0031__p5978127319524">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p22292070144238">Type of ranges that the object accepts.</p>
</td>
</tr>
<tr id="obs_03_0031__row66410903144238"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p4540407515255">X-Container-Bytes-Used</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p51190430144238">Int</p>
<p id="obs_03_0031__p18583729195212">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p52784162144238">Total number of bytes that are stored in OBS for the container.</p>
</td>
</tr>
<tr id="obs_03_0031__row178807761556"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p390567281556">X-Container-Object-Count</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p94784091556">Int</p>
<p id="obs_03_0031__p1596410195214">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p295536661556">Number of objects in the container.</p>
</td>
</tr>
<tr id="obs_03_0031__row6423655915944"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p3577876015944">X-Container-Meta-name</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p1239840915944">String</p>
<p id="obs_03_0031__p23252487195217">(Optional)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p6474706715944">Custom container metadata item, where <strong id="obs_03_0031__b2615989">{name}</strong> is the name of the metadata item.</p>
</td>
</tr>
<tr id="obs_03_0031__row40213248195138"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p1948451195156">Content-Length</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p23606827195156">String</p>
<p id="obs_03_0031__p11134852195156">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p29507848195156">If the operation succeeds, the value is the length of the object list information.</p>
<p id="obs_03_0031__p64244044195156">If the operation fails, this value is the length of the error text in the response body.</p>
</td>
</tr>
<tr id="obs_03_0031__row12189558195139"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p59030245195156">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p16720526195156">String</p>
<p id="obs_03_0031__p16267010195156">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p42559413195156">MIME type of the text in the response body.</p>
</td>
</tr>
<tr id="obs_03_0031__row55397376195139"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p21517012195156">Date</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p65156448195156">Datetime</p>
<p id="obs_03_0031__p49537120195156">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p53083813195156">Transaction date and time.</p>
</td>
</tr>
<tr id="obs_03_0031__row64699794195139"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p43394572195156">X-Trans-Id</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p25299449195156">Uuid</p>
<p id="obs_03_0031__p26368455195156">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p55470110195156">A unique transaction identifier.</p>
</td>
</tr>
<tr id="obs_03_0031__row7304758203017"><td class="cellrowborder" valign="top" width="38.279999999999994%" headers="mcps1.3.1.2.1.4.1.1 "><p id="obs_03_0031__p18306458183016">X-Timestamp</p>
</td>
<td class="cellrowborder" valign="top" width="15.509999999999998%" headers="mcps1.3.1.2.1.4.1.2 "><p id="obs_03_0031__p45791557183114">Datetime</p>
<p id="obs_03_0031__p022164513314">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.21%" headers="mcps1.3.1.2.1.4.1.3 "><p id="obs_03_0031__p28471953216">The time when the container was created.</p>
<p id="obs_03_0031__p1784717919328">The format is a UNIX Epoch timestamp.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_03_0031__section29255058162616"><h4 class="sectiontitle">Response Body Parameters</h4><p id="obs_03_0031__p38537106162939">If the response format is json or xml, object details are shown. <a href="#obs_03_0031__table64595445162712">Table 1</a> describes the response body parameters:</p>
<div class="tablenoborder"><a name="obs_03_0031__table64595445162712"></a><a name="table64595445162712"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0031__table64595445162712" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Response body parameters</caption><thead align="left"><tr id="obs_03_0031__row9655044162712"><th align="left" class="cellrowborder" valign="top" width="19.38%" id="mcps1.3.2.3.2.4.1.1"><p id="obs_03_0031__p59205779162712">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.64%" id="mcps1.3.2.3.2.4.1.2"><p id="obs_03_0031__p30938800162712">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="67.97999999999999%" id="mcps1.3.2.3.2.4.1.3"><p id="obs_03_0031__p23014890162712">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0031__row5807421162712"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.2.3.2.4.1.1 "><p id="obs_03_0031__p639084162712">name</p>
</td>
<td class="cellrowborder" valign="top" width="12.64%" headers="mcps1.3.2.3.2.4.1.2 "><p id="obs_03_0031__p51765868162712">String</p>
</td>
<td class="cellrowborder" valign="top" width="67.97999999999999%" headers="mcps1.3.2.3.2.4.1.3 "><p id="obs_03_0031__p32285797162712">An object name.</p>
</td>
</tr>
<tr id="obs_03_0031__row22136718162712"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.2.3.2.4.1.1 "><p id="obs_03_0031__p48243694162712">hash</p>
</td>
<td class="cellrowborder" valign="top" width="12.64%" headers="mcps1.3.2.3.2.4.1.2 "><p id="obs_03_0031__p15425114162712">String</p>
</td>
<td class="cellrowborder" valign="top" width="67.97999999999999%" headers="mcps1.3.2.3.2.4.1.3 "><p id="obs_03_0031__p41474747162712">MD5 checksum value of the object content.</p>
</td>
</tr>
<tr id="obs_03_0031__row37728411162712"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.2.3.2.4.1.1 "><p id="obs_03_0031__p36102470162712">bytes</p>
</td>
<td class="cellrowborder" valign="top" width="12.64%" headers="mcps1.3.2.3.2.4.1.2 "><p id="obs_03_0031__p38618970162712">Int</p>
</td>
<td class="cellrowborder" valign="top" width="67.97999999999999%" headers="mcps1.3.2.3.2.4.1.3 "><p id="obs_03_0031__p41128829162712">Total number of bytes that are stored in OBS for the object.</p>
</td>
</tr>
<tr id="obs_03_0031__row5296068385733"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.2.3.2.4.1.1 "><p id="obs_03_0031__p6195689485733">content_type</p>
</td>
<td class="cellrowborder" valign="top" width="12.64%" headers="mcps1.3.2.3.2.4.1.2 "><p id="obs_03_0031__p5245255585733">String</p>
</td>
<td class="cellrowborder" valign="top" width="67.97999999999999%" headers="mcps1.3.2.3.2.4.1.3 "><p id="obs_03_0031__p2079855285733">Content type of the object.</p>
</td>
</tr>
<tr id="obs_03_0031__row6337366785858"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.2.3.2.4.1.1 "><p id="obs_03_0031__p3299339285858">last_modified</p>
</td>
<td class="cellrowborder" valign="top" width="12.64%" headers="mcps1.3.2.3.2.4.1.2 "><p id="obs_03_0031__p5521907785858">Datetime</p>
</td>
<td class="cellrowborder" valign="top" width="67.97999999999999%" headers="mcps1.3.2.3.2.4.1.3 "><p id="obs_03_0031__p4356026785858">Date and time when the object was last modified.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0029.html">Show Container Details and List Objects</a></div>
</div>
</div>