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

110 lines
7.3 KiB
HTML

<a name="obs_03_0038"></a><a name="obs_03_0038"></a>
<h1 class="topictitle1">Request</h1>
<div id="body1442461140563"><div class="section" id="obs_03_0038__section39869956112928"><h4 class="sectiontitle">Method</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0038__table36630378113016" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Method description</caption><thead align="left"><tr id="obs_03_0038__row48730343113016"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.1.2.2.4.1.1"><p id="obs_03_0038__p5336715811413">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_0038__p51296332113016"><strong id="obs_03_0038__b39273688114629">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_0038__p61362190113016">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0038__row15388804113016"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.1.2.2.4.1.1 "><p id="obs_03_0038__p38533588113016">DELETE</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.1.2.2.4.1.2 "><p id="obs_03_0038__p52757727113245">/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_0038__p19784190113016">Deletes a container in a specified account. Only empty containers can be deleted.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="obs_03_0038__p423531921048"><strong id="obs_03_0038__b50811173">{account}</strong> indicates the name of an account. <strong id="obs_03_0038__b54647379">{container}</strong> indicates the name of a container.</p>
<p id="obs_03_0038__p41688322113723">This operation does not involve a request body.</p>
</div>
<div class="section" id="obs_03_0038__section16623225"><h4 class="sectiontitle">Example Request</h4><p id="obs_03_0038__p4713936114329">Delete the empty containers from the specified account:</p>
</div>
<pre class="screen" id="obs_03_0038__screen21590153">curl -i $publicURL/steven -X DELETE -H "X-Auth-Token:$token"</pre>
<div class="section" id="obs_03_0038__section5103708"><h4 class="sectiontitle">Request Query Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0038__table3465011514345" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_03_0038__row2112728814345"><th align="left" class="cellrowborder" valign="top" width="20.66%" id="mcps1.3.4.2.1.4.1.1"><p id="obs_03_0038__p3358873314345">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.399999999999999%" id="mcps1.3.4.2.1.4.1.2"><p id="obs_03_0038__p5856002114345">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.94%" id="mcps1.3.4.2.1.4.1.3"><p id="obs_03_0038__p901845514345">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0038__row6489438914345"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_03_0038__p2195416614345">bulk-delete</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_03_0038__p37892681143424">String</p>
<p id="obs_03_0038__p5489809143424">(Optional)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_03_0038__p2965280814345">Bulk-deletes objects. This parameter is used with the deletion list file.</p>
<p id="obs_03_0038__p3129015814377">A maximum of 10,000 objects can be deleted at once.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_03_0038__section2186955"><h4 class="sectiontitle">Request Headers</h4><p id="obs_03_0038__p35153104104315">Request URI parameters</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0038__table47942484104315" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_03_0038__row50384064104315"><th align="left" class="cellrowborder" valign="top" width="20.66%" id="mcps1.3.5.3.1.4.1.1"><p id="obs_03_0038__p54577389104315">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_0038__p58469618104315">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_0038__p10223168104315">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0038__row3605706104315"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.5.3.1.4.1.1 "><p id="obs_03_0038__p23626739104315">{account}</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.5.3.1.4.1.2 "><p id="obs_03_0038__p34717668104315">String</p>
<p id="obs_03_0038__p44023559104315">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.5.3.1.4.1.3 "><p id="obs_03_0038__p9138552104315">A unique account name. In the current version, it indicates a unique ID for the account.</p>
</td>
</tr>
<tr id="obs_03_0038__row15138112104315"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.5.3.1.4.1.1 "><p id="obs_03_0038__p18227579104315">{container}</p>
</td>
<td class="cellrowborder" valign="top" width="14.399999999999999%" headers="mcps1.3.5.3.1.4.1.2 "><p id="obs_03_0038__p38943104315">String</p>
<p id="obs_03_0038__p350487104315">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.5.3.1.4.1.3 "><p id="obs_03_0038__p28389482104315">A unique container name.</p>
<p id="obs_03_0038__p54178751104315">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_0038__p6825516104315">Request header parameters</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_03_0038__table61429650104315" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_03_0038__row54025279104315"><th align="left" class="cellrowborder" valign="top" width="20.66%" id="mcps1.3.5.5.1.4.1.1"><p id="obs_03_0038__p13971441104315">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_0038__p51742527104315">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_0038__p5121060104315">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_03_0038__row42265699104315"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.3.5.5.1.4.1.1 "><p id="obs_03_0038__p969622104315">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_0038__p11430537104315">String</p>
<p id="obs_03_0038__p35765970104315">(Required)</p>
</td>
<td class="cellrowborder" valign="top" width="64.94%" headers="mcps1.3.5.5.1.4.1.3 "><p id="obs_03_0038__p11362440104315">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_0037.html">Delete Container</a></div>
</div>
</div>