doc-exports/docs/vbs/api-ref/en-us_topic_0020237256.html
Wei, Hongmin 63123ef1be VBS API initial version
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Wei, Hongmin <weihongmin1@huawei.com>
Co-committed-by: Wei, Hongmin <weihongmin1@huawei.com>
2022-10-25 07:47:39 +00:00

175 lines
14 KiB
HTML

<a name="EN-US_TOPIC_0020237256"></a><a name="EN-US_TOPIC_0020237256"></a>
<h1 class="topictitle1">Deleting a VBS Backup (Deprecated)</h1>
<div id="body35905280"><div class="section" id="EN-US_TOPIC_0020237256__section11854613"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0020237256__p22646572">This API is used to delete a VBS backup. This API is deprecated. You are advised to use the API described in <a href="en-us_topic_0049453221.html">Deleting a VBS Backup (Native OpenStack API)</a> to delete a backup.</p>
</div>
<div class="section" id="EN-US_TOPIC_0020237256__section39582655"><h4 class="sectiontitle">URI</h4><ul id="EN-US_TOPIC_0020237256__ul22433040"><li id="EN-US_TOPIC_0020237256__li570775">URI format<p id="EN-US_TOPIC_0020237256__p46232835"><a name="EN-US_TOPIC_0020237256__li570775"></a><a name="li570775"></a>POST /v2/{project_id}/cloudbackups/{backup_id}</p>
</li><li id="EN-US_TOPIC_0020237256__li13442339">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020237256__table53872188" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0020237256__row40420929"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.2.1.1.4.1.1"><p id="EN-US_TOPIC_0020237256__p52869820">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.2.1.1.4.1.2"><p id="EN-US_TOPIC_0020237256__p54597003">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.2.1.1.4.1.3"><p id="EN-US_TOPIC_0020237256__p60281111">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0020237256__row50931783"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="EN-US_TOPIC_0020237256__p31833731">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.2 "><p id="EN-US_TOPIC_0020237256__p28395444">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.3 "><p id="EN-US_TOPIC_0020237256__p64170449">Project ID</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row30749271"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="EN-US_TOPIC_0020237256__p7663035">backup_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.2 "><p id="EN-US_TOPIC_0020237256__p16726062">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.3 "><p id="EN-US_TOPIC_0020237256__p12633819">ID of the backup to be deleted</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0020237256__section20699582"><h4 class="sectiontitle">Request</h4><p id="EN-US_TOPIC_0020237256__p16706408">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0020237256__section52078514"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0020237256__ul11041789"><li id="EN-US_TOPIC_0020237256__li57872974202521">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020237256__table268079921728" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0020237256__row423693971728"><th align="left" class="cellrowborder" valign="top" width="14.87%" id="mcps1.3.4.2.1.1.1.4.1.1"><p id="EN-US_TOPIC_0020237256__p61804813">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.189999999999998%" id="mcps1.3.4.2.1.1.1.4.1.2"><p id="EN-US_TOPIC_0020237256__p14225104112">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="68.94%" id="mcps1.3.4.2.1.1.1.4.1.3"><p id="EN-US_TOPIC_0020237256__p29622330">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0020237256__row462910891728"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="EN-US_TOPIC_0020237256__p585907101728">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="16.189999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="EN-US_TOPIC_0020237256__p140797381728">string</p>
</td>
<td class="cellrowborder" valign="top" width="68.94%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="EN-US_TOPIC_0020237256__p667170331728">Job ID</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row635823931728"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="EN-US_TOPIC_0020237256__p499001711728">message</p>
</td>
<td class="cellrowborder" valign="top" width="16.189999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="EN-US_TOPIC_0020237256__p379878621728">string</p>
</td>
<td class="cellrowborder" valign="top" width="68.94%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="EN-US_TOPIC_0020237256__p571179821728">Error message returned after an error occurs</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row442997951728"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="EN-US_TOPIC_0020237256__p315136771728">code</p>
</td>
<td class="cellrowborder" valign="top" width="16.189999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="EN-US_TOPIC_0020237256__p659391231728">string</p>
</td>
<td class="cellrowborder" valign="top" width="68.94%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="EN-US_TOPIC_0020237256__p394687181728">Error code returned after an error occurs</p>
<p id="EN-US_TOPIC_0020237256__p196741461728">For details about error codes, see <a href="en-us_topic_0022472083.html">Error Codes</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0020237256__li32267243">Example response<pre class="screen" id="EN-US_TOPIC_0020237256__screen3847140810123">{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}</pre>
<p id="EN-US_TOPIC_0020237256__p44024689">or</p>
<pre class="screen" id="EN-US_TOPIC_0020237256__screen2411634810128">{
"error": {
"message": "XXXX",
"code": "XXX"
}
}</pre>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0020237256__section66053444"><h4 class="sectiontitle">Status Codes</h4><ul id="EN-US_TOPIC_0020237256__ul43299552"><li id="EN-US_TOPIC_0020237256__li54151655">Normal<p id="EN-US_TOPIC_0020237256__p17602849"><a name="EN-US_TOPIC_0020237256__li54151655"></a><a name="li54151655"></a>200</p>
</li><li id="EN-US_TOPIC_0020237256__li24207921">Abnormal
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0020237256__table17411442203238" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0020237256__row20469972203238"><th align="left" class="cellrowborder" valign="top" width="43.419999999999995%" id="mcps1.3.5.2.2.1.1.3.1.1"><p id="EN-US_TOPIC_0020237256__p47455040203238">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.58%" id="mcps1.3.5.2.2.1.1.3.1.2"><p id="EN-US_TOPIC_0020237256__p18653028203238">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0020237256__row34500329203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p43063287203238">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p65574197203238">The server failed to process the request.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row53296861203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p22078503203238">401 Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p43528309203238">You must enter the username and password to access the requested page.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row56210465203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p56753841203238">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p33658426203238">You are forbidden to access the requested page.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row34490379203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p42257275203238">404 Not Found</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p287223203238">The server could not find the requested page.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row2585014203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p8059568203238">405 Method Not Allowed</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p48845291203238">You are not allowed to use the method specified in the request.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row36954440203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p40519687203238">406 Not Acceptable</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p60869210203238">The response generated by the server could not be accepted by the client.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row10951983203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p14695420203238">407 Proxy Authentication Required</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p49478353203238">You must use the proxy server for authentication so that the request can be processed.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row42651999203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p32259860203238">408 Request Timeout</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p62911845203238">The request timed out.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row29335700203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p27381532203238">409 Conflict</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p3311604203238">The request could not be processed due to a conflict.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row29804437203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p65349225203238">500 Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p58795873203238">Failed to complete the request because of an internal service error.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row59400814203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p46736664203238">501 Not Implemented</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p27573467203238">Failed to complete the request because the server does not support the requested function.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row46834613203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p35507279203238">502 Bad Gateway</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p57517333203238">Failed to complete the request because the request is invalid.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row47893957203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p54205305203238">503 Service Unavailable</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p28553614203238">Failed to complete the request because the service is unavailable.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0020237256__row55655940203238"><td class="cellrowborder" valign="top" width="43.419999999999995%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0020237256__p11837325203238">504 Gateway Timeout</p>
</td>
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0020237256__p19299274203238">A gateway timeout error occurred.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0020237256__section1362310255432"><h4 class="sectiontitle">Error Codes</h4><p id="EN-US_TOPIC_0020237256__p129821455154315">For details, see <a href="en-us_topic_0022472083.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0020237254.html">VBS Backups</a></div>
</div>
</div>