forked from docs/doc-exports
Qin Ying, Fan
cf1007c84e
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>
172 lines
15 KiB
HTML
172 lines
15 KiB
HTML
<a name="dns_api_66003"></a><a name="dns_api_66003"></a>
|
|
|
|
<h1 class="topictitle1">Querying a PTR Record</h1>
|
|
<div id="body1479290255535"><div class="section" id="dns_api_66003__section18389930"><h4 class="sectiontitle">Function</h4><p id="dns_api_66003__p1235925018716">Query the PTR record of an EIP.</p>
|
|
</div>
|
|
<div class="section" id="dns_api_66003__section31291646"><h4 class="sectiontitle">URI</h4><p id="dns_api_66003__p144831613564">GET /v2/reverse/floatingips/{region}:{floatingip_id}</p>
|
|
<div class="p" id="dns_api_66003__p8184753132618">For details, see <a href="#dns_api_66003__table21421675">Table 1</a>.
|
|
<div class="tablenoborder"><a name="dns_api_66003__table21421675"></a><a name="table21421675"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66003__table21421675" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters in the URI</caption><thead align="left"><tr id="dns_api_66003__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_66003__a3c7e1e08fe294e3e82e1797588253df5"><strong id="dns_api_66003__b914220471716">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_66003__adc5414917a3c400cb8857a02b29eb94d"><strong id="dns_api_66003__b9914164191720">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_66003__a9ce61a6198d44964bdc496d82601e141"><strong id="dns_api_66003__b319416051713">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_66003__en-us_topic_0042318613_p517246718149"><strong id="dns_api_66003__b1928418721720">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dns_api_66003__rfa1eb070d71448a9b2fbaa5917068657"><td class="cellrowborder" valign="top" width="22.64%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66003__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_66003__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_66003__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_66003__a939d47bc868d44c290326fb1df4c5e00">Region of the tenant</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__r0588e91c222b4483b97fe5b2e56f79bb"><td class="cellrowborder" valign="top" width="22.64%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66003__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_66003__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_66003__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_66003__ad2fce4accef8431b86dcaca0bd572a60">EIP ID</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dns_api_66003__section13189358"><h4 class="sectiontitle">Request</h4><ul id="dns_api_66003__ul35351571269"><li id="dns_api_66003__li1053565782615">Request parameters<p id="dns_api_66003__p1815201642711"><a name="dns_api_66003__li1053565782615"></a><a name="li1053565782615"></a>None</p>
|
|
</li><li id="dns_api_66003__li4109190182715">Example request<p id="dns_api_66003__p1651121054613"><a name="dns_api_66003__li4109190182715"></a><a name="li4109190182715"></a>Query the PTR record whose EIP ID is <strong id="dns_api_66003__b198691649175712">c5504932-bf23-4171-b655-b87a6bc59334</strong>:</p>
|
|
<pre class="codeblock" id="dns_api_66003__codeblock1385835131614">GET https://{DNS_Endpoint}/v2/reverse/floatingips/<em id="dns_api_66003__i08611954166">region_id</em>:c5504932-bf23-4171-b655-b87a6bc59334</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dns_api_66003__section51595365"><h4 class="sectiontitle">Response</h4><ul id="dns_api_66003__ul16090703"><li id="dns_api_66003__li10598606">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66003__table28278595" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the response</caption><thead align="left"><tr id="dns_api_66003__rc433fa5ceea44999bda6baae10282bed"><th align="left" class="cellrowborder" valign="top" width="18.18%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="dns_api_66003__en-us_topic_0042318613_p690539418456"><strong id="dns_api_66003__b1634154610184">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.189999999999998%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="dns_api_66003__aec3926ab378e4c9fafd96942ae9c2f24"><strong id="dns_api_66003__b16403947181816">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="62.629999999999995%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="dns_api_66003__en-us_topic_0042318613_p781187018456"><strong id="dns_api_66003__b13447164812185">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dns_api_66003__rf59c1308b662423d9e5c5eb972f057a1"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66003__af1202b164f13422d896f91d34faf7c44">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66003__aa0e1ad68e67146a3a89bc538709063e9">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66003__a48e534dd79ef418ab79ff1303a8ff149">PTR record ID, which is in <strong id="dns_api_66003__b842352706151833">{region}:{floatingip_id}</strong> format</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__r8de792b7f9bb42a5bbd359fd67c55802"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66003__affabc5d973dd43ef8f81431cfbba2e4d">ptrdname</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66003__a8d449d79abdf400cacc28050075effe9">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66003__a695a30773b7b4545a348899428360b0c">Domain name of the PTR record</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__r07959df68aa640f7b2550a4ec13bd321"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66003__a58edc66abfd94b8d88234ccc87f993ef">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66003__a585f5fc28a9746e0ae2a07ca866d0979">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66003__a26cda8d7c28c484a8555271f1b7c9c18">PTR record description</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__rc07302b7ba7748e2bd3ba03f66d4d046"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66003__ac280dc3e9e514cb4bb61dc356b75c265">ttl</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66003__a2faf54e82d504a619ab8183ab083c6f4">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66003__p73714549431">PTR record cache duration (in seconds) on a local DNS server. The longer the duration is, the slower the update takes effect.</p>
|
|
<p id="dns_api_66003__p1837175484310">If your service address is frequently changed, set TTL to a smaller value.</p>
|
|
<p id="dns_api_66003__a23cf8b6abe1245a294fde1b3cdc68e76">The value ranges from <strong id="dns_api_66003__b889532785313">1</strong> to <strong id="dns_api_66003__b13975153019534">2147483647</strong>.</p>
|
|
<p id="dns_api_66003__p1859919134417">The default value is <strong id="dns_api_66003__b9900125442910">300</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__rb0577738b87a4dafb23d0a1ef4cac7ed"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66003__a6c80427db35e48689eb4ae318fc8fa30">address</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66003__aa917e102919f4ac98c625e33f516baee">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66003__a01a51f050f414b669b4a08478ede886e">EIP</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__r9d3448295e68459db0bade4562e211a5"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66003__a29ee325b52134a3f847bbee5c91b1da3">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66003__a0db39a1fe84849a5b1a1e8b334e41e5b">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66003__a133beb6a97ed42bdac622271072840e6">Resource status</p>
|
|
<p id="dns_api_66003__en-us_topic_0042318613_p55966391353">For details, see <a href="dns_api_80005.html#dns_api_80005__section33673592114748">Resource Status</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__rb4683cb844214f51ae468943568b4cde"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66003__a1d911558e18444b3896ace2ed6ccbaec">action</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66003__ae39f64d2c5af4dae91b509416f77d31d">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66003__en-us_topic_0042318613_p507362318456">Requested operation on the resource</p>
|
|
<p id="dns_api_66003__a7560251cd28e4dd9b678da457820ee30">The value can be <strong id="dns_api_66003__b11242856203611">CREATE</strong>, <strong id="dns_api_66003__b18243756153616">UPDATE</strong>, <strong id="dns_api_66003__b1244115619362">DELETE</strong>, or <strong id="dns_api_66003__b19246456143618">NONE</strong>.</p>
|
|
<p id="dns_api_66003__en-us_topic_0042318613_p178601911399"><strong id="dns_api_66003__b19298145863616">NONE</strong> indicates that no operation will be performed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__re6d739b3d80f4bcda0e2ad834dc1d66f"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66003__en-us_topic_0042318613_p204899518456">links</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66003__ad894d21cefa74634a62f6964f84019f6">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66003__ab163171b57cd4600a059890e5f4373ce">Link to the current resource or other related resources</p>
|
|
<p id="dns_api_66003__a4dc7ac60268d4291a27544e93c236e22">When a response is broken into pages, a <strong id="dns_api_66003__b84235270695245">next</strong> link is provided to retrieve all results. For details, see <a href="#dns_api_66003__table354521744216">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="dns_api_66003__table354521744216"></a><a name="table354521744216"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66003__table354521744216" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameters in the <strong id="dns_api_66003__b7707101815402">links</strong> field</caption><thead align="left"><tr id="dns_api_66003__row954518179427"><th align="left" class="cellrowborder" valign="top" width="18.3018301830183%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="dns_api_66003__p654513173424"><strong id="dns_api_66003__b466251913401">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.591959195919593%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="dns_api_66003__p654551714212"><strong id="dns_api_66003__b8699320184011">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="62.10621062106211%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="dns_api_66003__p1545141717427"><strong id="dns_api_66003__b5483192112404">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dns_api_66003__row3545101710429"><td class="cellrowborder" valign="top" width="18.3018301830183%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="dns_api_66003__p115467171428">self</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="dns_api_66003__p254611713427">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.10621062106211%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="dns_api_66003__p5546171744214">Link to the current resource</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_66003__row2458163435118"><td class="cellrowborder" valign="top" width="18.3018301830183%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="dns_api_66003__p136561245153620">next</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="dns_api_66003__p19656144517367">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.10621062106211%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="dns_api_66003__p76567451365">Link to the next page</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="dns_api_66003__ul41462866"><li id="dns_api_66003__li37621475">Example response<pre class="screen" id="dns_api_66003__screen3559069817546">{
|
|
"id": "<em id="dns_api_66003__i1091990614305">region_id</em>:c5504932-bf23-4171-b655-b87a6bc59334",
|
|
"ptrdname": "www.example.com.",
|
|
"description": "Description for this PTR record",
|
|
"address": "10.154.52.138",
|
|
"action": "CREATE",
|
|
"ttl": 300,
|
|
"status": "ACTIVE",
|
|
"links": {
|
|
"self": "https://<em id="dns_api_66003__i33524646142136">Endpoint</em>/v2/reverse/floatingips/<em id="dns_api_66003__i2887849914319">region_id</em>:c5504932-bf23-4171-b655-b87a6bc59334"
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dns_api_66003__section9249181042119"><h4 class="sectiontitle">Returned Value</h4><p id="dns_api_66003__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_66003__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>
|
|
|