doc-exports/docs/dns/api-ref/dns_api_66005.html
Qin Ying, Fan cf1007c84e DNS API 20240223 version
Reviewed-by: Hajba, László Antal <laszlo-antal.hajba@t-systems.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
2024-05-16 13:48:49 +00:00

86 lines
7.3 KiB
HTML

<a name="dns_api_66005"></a><a name="dns_api_66005"></a>
<h1 class="topictitle1">Unsetting a PTR Record</h1>
<div id="body1479290255544"><div class="section" id="dns_api_66005__section8391370"><h4 class="sectiontitle">Function</h4><p id="dns_api_66005__p18710936">Delete a PTR record for an EIP by unsetting it to the default value.</p>
<div class="note" id="dns_api_66005__note136403120211"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dns_api_66005__dns_api_66002_p206573119217">The same <a href="dns_api_66002.html#dns_api_66002__section53701671161015">URI</a> is used to <a href="dns_api_66002.html">create</a>, <a href="dns_api_66006.html">modify</a>, and <a href="dns_api_66005.html">delete</a> PTR records. Different request bodies are used to implement different functions.</p>
</div></div>
</div>
<div class="section" id="dns_api_66005__section8413469"><h4 class="sectiontitle">URI</h4><p id="dns_api_66005__p419815595714">PATCH /v2/reverse/floatingips/{region}:{floatingip_id}</p>
<div class="p" id="dns_api_66005__p189371615144314">For details, see <a href="#dns_api_66005__table48883615">Table 1</a>.
<div class="tablenoborder"><a name="dns_api_66005__table48883615"></a><a name="table48883615"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66005__table48883615" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters in the URI</caption><thead align="left"><tr id="dns_api_66005__rf5eb1b4b32f8403bb0acf9d017b51ee5"><th align="left" class="cellrowborder" valign="top" width="22.64%" id="mcps1.3.2.3.2.2.5.1.1"><p id="dns_api_66005__a3c7e1e08fe294e3e82e1797588253df5"><strong id="dns_api_66005__b128535511507">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.37%" id="mcps1.3.2.3.2.2.5.1.2"><p id="dns_api_66005__adc5414917a3c400cb8857a02b29eb94d"><strong id="dns_api_66005__b593421527191713">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.349999999999998%" id="mcps1.3.2.3.2.2.5.1.3"><p id="dns_api_66005__a9ce61a6198d44964bdc496d82601e141"><strong id="dns_api_66005__b84235270619112">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="42.64%" id="mcps1.3.2.3.2.2.5.1.4"><p id="dns_api_66005__en-us_topic_0042318613_p517246718149"><strong id="dns_api_66005__b1323156175018">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_66005__rfa1eb070d71448a9b2fbaa5917068657"><td class="cellrowborder" valign="top" width="22.64%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66005__ae661ce94166a4825a0aad48ed9e3a0e3">region</p>
</td>
<td class="cellrowborder" valign="top" width="17.37%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_66005__ac4b80f38e0ef4382be487f39931804d3">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="17.349999999999998%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_66005__a0a1bf1099829467e967689705fc84fe5">String</p>
</td>
<td class="cellrowborder" valign="top" width="42.64%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_66005__a939d47bc868d44c290326fb1df4c5e00">Region of the tenant.</p>
</td>
</tr>
<tr id="dns_api_66005__r0588e91c222b4483b97fe5b2e56f79bb"><td class="cellrowborder" valign="top" width="22.64%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66005__ac3563e9e05cc422ab54a9d288aa5810c">floatingip_id</p>
</td>
<td class="cellrowborder" valign="top" width="17.37%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_66005__af475fd33d3fc4310b7f5a1f14e1fa9c9">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="17.349999999999998%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_66005__a2fe0b089a6a14db1a241b4d93dc9fd5a">String</p>
</td>
<td class="cellrowborder" valign="top" width="42.64%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_66005__ad2fce4accef8431b86dcaca0bd572a60">EIP ID</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="dns_api_66005__section8612359"><h4 class="sectiontitle">Request</h4><ul id="dns_api_66005__ul18370535173152"><li id="dns_api_66005__li51947106173152">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66005__table239794161830" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter in the request</caption><thead align="left"><tr id="dns_api_66005__row654560711830"><th align="left" class="cellrowborder" valign="top" width="20.757924207579244%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="dns_api_66005__p3415211830"><strong id="dns_api_66005__b162774213314533">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.987801219878016%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="dns_api_66005__p276632601830"><strong id="dns_api_66005__b1160859039">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.71852814718528%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="dns_api_66005__p261316001830"><strong id="dns_api_66005__b435873514">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="42.53574642535746%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="dns_api_66005__p362848191830"><strong id="dns_api_66005__b842352706112423">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_66005__row533892641830"><td class="cellrowborder" valign="top" width="20.757924207579244%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_66005__p295631171830">ptrdname</p>
</td>
<td class="cellrowborder" valign="top" width="21.987801219878016%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_66005__p458022581830">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="14.71852814718528%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_66005__p189954321830">String</p>
</td>
<td class="cellrowborder" valign="top" width="42.53574642535746%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_66005__p26704373161818">Domain name of the PTR record</p>
<p id="dns_api_66005__p622350301830">Set it to <strong id="dns_api_66005__b842352706172057">null</strong> in the request.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="dns_api_66005__li60905904173155">Example request<div class="p" id="dns_api_66005__p780111225117"><a name="dns_api_66005__li60905904173155"></a><a name="li60905904173155"></a>Unset the PTR record whose EIP ID is <strong id="dns_api_66005__b2292731115918">c5504932-bf23-4171-b655-b87a6bc59334</strong> to the default value:<pre class="codeblock" id="dns_api_66005__codeblock638351105117">PATCH https://{DNS_Endpoint}/v2/reverse/floatingips/<em id="dns_api_66005__i6383719518">region_id</em>:c5504932-bf23-4171-b655-b87a6bc59334</pre>
<pre class="screen" id="dns_api_66005__screen9383111115111">{
"ptrdname": null
}</pre>
</div>
</li></ul>
</div>
<div class="section" id="dns_api_66005__section10402369"><h4 class="sectiontitle">Response</h4><p id="dns_api_66005__p4047200691446">None</p>
</div>
<div class="section" id="dns_api_66005__section9249181042119"><h4 class="sectiontitle">Returned Value</h4><p id="dns_api_66005__dns_api_61001_p711102924515">If a 2xx status code is returned, for example, 200, 202, or 204, the request is successful.</p>
<p id="dns_api_66005__dns_api_61001_p18506102624518">For details, see <a href="dns_api_80002.html">Status Code</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dns_api_66000.html">PTR Record Management</a></div>
</div>
</div>