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

127 lines
8.6 KiB
HTML

<a name="obs_03_0071"></a><a name="obs_03_0071"></a>
<h1 class="topictitle1">Request</h1>
<div id="body1442649345363"><div class="section" id="obs_03_0071__section42203044114811"><h4 class="sectiontitle">Method</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0071__table63003397114811" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Method description</caption><thead align="left"><tr id="obs_03_0071__row958610114811"><th align="left" class="cellrowborder" valign="top" width="13.969999999999999%" id="mcps1.3.1.2.2.4.1.1"><p id="obs_03_0071__p10538570114811">Method</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.7%" id="mcps1.3.1.2.2.4.1.2"><p id="obs_03_0071__p32207183114811"><strong id="obs_03_0071__b21429195114811">URI</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33%" id="mcps1.3.1.2.2.4.1.3"><p id="obs_03_0071__p58043236114811">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0071__row34935397114811"><td class="cellrowborder" valign="top" width="13.969999999999999%" headers="mcps1.3.1.2.2.4.1.1 "><p id="obs_03_0071__p11194907114811">HEAD</p>
</td>
<td class="cellrowborder" valign="top" width="52.7%" headers="mcps1.3.1.2.2.4.1.2 "><p id="obs_03_0071__p3700552617321">/v1/{account}/{container}/{object}{?temp_url_sig,temp_url_expires}</p>
</td>
<td class="cellrowborder" valign="top" width="33.33%" headers="mcps1.3.1.2.2.4.1.3 "><p id="obs_03_0071__p32688443114811">Shows object metadata.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="obs_03_0071__p14656170173237"><strong id="obs_03_0071__b36781194">{account}</strong> indicates the name of an account.</p>
<p id="obs_03_0071__p25760539114811"><strong id="obs_03_0071__b26486770">{container}</strong> indicates the name of a container.</p>
<p id="obs_03_0071__p30883341173324"><strong id="obs_03_0071__b65053610">{object}</strong> indicates the name of an object.</p>
<p id="obs_03_0071__p6228911114811">This operation does not involve a request body.</p>
</div>
<div class="section" id="obs_03_0071__section56060206114811"><h4 class="sectiontitle">Example Request</h4><p id="obs_03_0071__p44582858114811">Show object metadata:</p>
<pre class="codeblock" id="obs_03_0071__codeblock12114419173554">curl -i $publicURL/marktwain/goodbye -X HEAD -H "X-Auth-Token:$token"</pre>
</div>
<div class="section" id="obs_03_0071__section47707984114811"><h4 class="sectiontitle">Request Query Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0071__table39845527173423" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_03_0071__row7926438173423"><th align="left" class="cellrowborder" valign="top" width="22.68%" id="mcps1.3.3.2.1.4.1.1"><p id="obs_03_0071__p38061735173423">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.29%" id="mcps1.3.3.2.1.4.1.2"><p id="obs_03_0071__p31044029173423">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.029999999999994%" id="mcps1.3.3.2.1.4.1.3"><p id="obs_03_0071__p15410692173423">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0071__row42039985173423"><td class="cellrowborder" valign="top" width="22.68%" headers="mcps1.3.3.2.1.4.1.1 "><p id="obs_03_0071__p49795625173423">temp_url_sig</p>
</td>
<td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.2.1.4.1.2 "><p id="obs_03_0071__p6913838173423">String</p>
<p id="obs_03_0071__p56399519173444">(Optional)</p>
</td>
<td class="cellrowborder" valign="top" width="60.029999999999994%" headers="mcps1.3.3.2.1.4.1.3 "><p id="obs_03_0071__p23149991173423">Used with TempURL to sign the request.</p>
</td>
</tr>
<tr id="obs_03_0071__row32018918173423"><td class="cellrowborder" valign="top" width="22.68%" headers="mcps1.3.3.2.1.4.1.1 "><p id="obs_03_0071__p43395537173423">temp_url_expires</p>
</td>
<td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.2.1.4.1.2 "><p id="obs_03_0071__p25377613173423">String</p>
<p id="obs_03_0071__p61076842173454">(Optional)</p>
</td>
<td class="cellrowborder" valign="top" width="60.029999999999994%" headers="mcps1.3.3.2.1.4.1.3 "><p id="obs_03_0071__p42320769173423">Used with TempURL to specify the expiry time of the signature.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_03_0071__section16729309114811"><h4 class="sectiontitle">Request Headers</h4><p id="obs_03_0071__p53176556173112">Request URI parameters</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0071__table8826958173112" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_03_0071__row31050417173112"><th align="left" class="cellrowborder" valign="top" width="20.66%" id="mcps1.3.4.3.1.4.1.1"><p id="obs_03_0071__p32055862173112">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.399999999999999%" id="mcps1.3.4.3.1.4.1.2"><p id="obs_03_0071__p14838955173112">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.94%" id="mcps1.3.4.3.1.4.1.3"><p id="obs_03_0071__p13071263173112">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0071__row66601109173112"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.4.3.1.4.1.1 "><p id="obs_03_0071__p25980745173112">{account}</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.4.3.1.4.1.2 "><p id="obs_03_0071__p24065630173112">String</p>
<p id="obs_03_0071__p15264084173112">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.4.3.1.4.1.3 "><p id="obs_03_0071__p28431325173112">A unique account name. In the current version, it indicates a unique ID for the account.</p>
</td>
</tr>
<tr id="obs_03_0071__row54555338173112"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.4.3.1.4.1.1 "><p id="obs_03_0071__p56906224173112">{container}</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.4.3.1.4.1.2 "><p id="obs_03_0071__p46001431173112">String</p>
<p id="obs_03_0071__p11359698173112">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.4.3.1.4.1.3 "><p id="obs_03_0071__p47720349173112">A unique container name.</p>
<p id="obs_03_0071__p26829958173112">For details about container naming rules, see <a href="obs_03_0009.html">Naming Rules</a>.</p>
</td>
</tr>
<tr id="obs_03_0071__row25743007173112"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.4.3.1.4.1.1 "><p id="obs_03_0071__p4808792173112">{object}</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.4.3.1.4.1.2 "><p id="obs_03_0071__p53967833173112">String</p>
<p id="obs_03_0071__p15948452173112">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.4.3.1.4.1.3 "><p id="obs_03_0071__p16756261173112">An object name.</p>
<p id="obs_03_0071__p16588629173112">For details about object naming rules, see <a href="obs_03_0009.html#obs_03_0009__section23579102">Object Naming Rules</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0071__table1501728173112" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="obs_03_0071__row59829943173112"><th align="left" class="cellrowborder" valign="top" width="36.54%" id="mcps1.3.4.4.2.4.1.1"><p id="obs_03_0071__p14387195173112">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.939999999999998%" id="mcps1.3.4.4.2.4.1.2"><p id="obs_03_0071__p19282668173112">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.52%" id="mcps1.3.4.4.2.4.1.3"><p id="obs_03_0071__p31312818173112">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0071__row10031201173112"><td class="cellrowborder" valign="top" width="36.54%" headers="mcps1.3.4.4.2.4.1.1 "><p id="obs_03_0071__p7220937173112">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="16.939999999999998%" headers="mcps1.3.4.4.2.4.1.2 "><p id="obs_03_0071__p48025001173112">String</p>
<p id="obs_03_0071__p29571830173112">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="46.52%" headers="mcps1.3.4.4.2.4.1.3 "><p id="obs_03_0071__p46508030173112">Authentication token.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_03_0070.html">Show Object Metadata</a></div>
</div>
</div>