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

91 lines
6.2 KiB
HTML

<a name="obs_03_0046"></a><a name="obs_03_0046"></a>
<h1 class="topictitle1">Request</h1>
<div id="body1442459864683"><div class="section" id="obs_03_0046__section42203044114811"><h4 class="sectiontitle">Method</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0046__table63003397114811" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Method description</caption><thead align="left"><tr id="obs_03_0046__row958610114811"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.1.2.2.4.1.1"><p id="obs_03_0046__p10538570114811">Method</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.1.2.2.4.1.2"><p id="obs_03_0046__p32207183114811"><strong id="obs_03_0046__b21429195114811">URI</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.1.2.2.4.1.3"><p id="obs_03_0046__p58043236114811">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0046__row34935397114811"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.1.2.2.4.1.1 "><p id="obs_03_0046__p11194907114811">HEAD</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.1.2.2.4.1.2 "><p id="obs_03_0046__p34372245114811">/v1/{account}/{container}</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.1.2.2.4.1.3 "><p id="obs_03_0046__p32688443114811">Shows container metadata, including the number of objects and the total bytes of all objects stored in the container.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="obs_03_0046__p12865387195953"><strong id="obs_03_0046__b47316833">{account}</strong> indicates the name of an account.</p>
<p id="obs_03_0046__p25760539114811"><strong id="obs_03_0046__b7458280">{container}</strong> indicates the name of a container.</p>
<p id="obs_03_0046__p6228911114811">This operation does not involve a request body.</p>
</div>
<div class="section" id="obs_03_0046__section56060206114811"><h4 class="sectiontitle">Example Request</h4><p id="obs_03_0046__p44582858114811">Show metadata of container <strong id="obs_03_0046__b11418772">marktwain</strong>:</p>
</div>
<pre class="screen" id="obs_03_0046__screen65701410114811">curl -i $publicURL/marktwain -X HEAD -H "X-Auth-Token:$token"</pre>
<div class="section" id="obs_03_0046__section47707984114811"><h4 class="sectiontitle">Request Query Parameters</h4><p id="obs_03_0046__p39141514114811">This request does not include query parameters.</p>
</div>
<div class="section" id="obs_03_0046__section16729309114811"><h4 class="sectiontitle">Request Headers</h4><p id="obs_03_0046__p36228014111612">Request URI parameters</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0046__table57616674111612" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_03_0046__row34860353111612"><th align="left" class="cellrowborder" valign="top" width="20.66%" id="mcps1.3.5.3.1.4.1.1"><p id="obs_03_0046__p5116378111612">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.399999999999999%" id="mcps1.3.5.3.1.4.1.2"><p id="obs_03_0046__p38852453111612">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.94%" id="mcps1.3.5.3.1.4.1.3"><p id="obs_03_0046__p3497983111612">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0046__row67002027111612"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.5.3.1.4.1.1 "><p id="obs_03_0046__p58455124111612">{account}</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.5.3.1.4.1.2 "><p id="obs_03_0046__p37244573111612">String</p>
<p id="obs_03_0046__p66765701111612">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.5.3.1.4.1.3 "><p id="obs_03_0046__p39312673111612">A unique account name. In the current version, it indicates a unique ID for the account.</p>
</td>
</tr>
<tr id="obs_03_0046__row18269744111612"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.5.3.1.4.1.1 "><p id="obs_03_0046__p3454282111612">{container}</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.5.3.1.4.1.2 "><p id="obs_03_0046__p11361445111612">String</p>
<p id="obs_03_0046__p35144146111612">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.5.3.1.4.1.3 "><p id="obs_03_0046__p28103601111612">A unique container name.</p>
<p id="obs_03_0046__p51605820111612">For details about container naming rules, see <a href="obs_03_0009.html">Naming Rules</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="obs_03_0046__p59446673111612">Request header parameters</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0046__table65258011111612" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_03_0046__row62776274111612"><th align="left" class="cellrowborder" valign="top" width="20.66%" id="mcps1.3.5.5.1.4.1.1"><p id="obs_03_0046__p51713465111612">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.399999999999999%" id="mcps1.3.5.5.1.4.1.2"><p id="obs_03_0046__p51043305111612">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.94%" id="mcps1.3.5.5.1.4.1.3"><p id="obs_03_0046__p32258838111612">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0046__row28590867111612"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.5.5.1.4.1.1 "><p id="obs_03_0046__p34158925111612">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.5.5.1.4.1.2 "><p id="obs_03_0046__p15409568111612">String</p>
<p id="obs_03_0046__p4468386111612">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.5.5.1.4.1.3 "><p id="obs_03_0046__p26394956111612">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_0045.html">Show Container Metadata</a></div>
</div>
</div>