vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dns/api-ref/dns_api_66004.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

320 lines
28 KiB
HTML
Raw Permalink Blame History

<a name="dns_api_66004"></a><a name="dns_api_66004"></a>
<h1 class="topictitle1">Querying All PTR Records</h1>
<div id="body1479290255539"><div class="section" id="dns_api_66004__section29105235"><h4 class="sectiontitle">Function</h4><p id="dns_api_66004__p53453427">Query PTR records of EIPs.</p>
</div>
<div class="section" id="dns_api_66004__section60620523"><h4 class="sectiontitle">URI</h4><p id="dns_api_66004__p4858173516564">GET /v2/reverse/floatingips?limit={limit}&amp;marker={marker}&amp;offset={offset}&amp;tags={tags}&amp;status={status}</p>
<div class="p" id="dns_api_66004__p12285963013">For details, see <a href="#dns_api_66004__table1562846014112">Table 1</a>.
<div class="tablenoborder"><a name="dns_api_66004__table1562846014112"></a><a name="table1562846014112"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66004__table1562846014112" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters in the URI</caption><thead align="left"><tr id="dns_api_66004__r6ac32cd36c6440bd8ac6087ceb16d5cc"><th align="left" class="cellrowborder" valign="top" width="20.202020202020204%" id="mcps1.3.2.3.2.2.5.1.1"><p id="dns_api_66004__a4e323cd7393046cf818209af891ceb09"><strong id="dns_api_66004__b162774213314533">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.17171717171717%" id="mcps1.3.2.3.2.2.5.1.2"><p id="dns_api_66004__a8a575925321445698046900da989bc3f"><strong id="dns_api_66004__b593421527191713">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.14141414141414%" id="mcps1.3.2.3.2.2.5.1.3"><p id="dns_api_66004__a059da88b19b84eb8b75f8e366f39b709"><strong id="dns_api_66004__b84235270619112">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="48.484848484848484%" id="mcps1.3.2.3.2.2.5.1.4"><p id="dns_api_66004__a10e66b0b45c64f42a71a62a3052a263a"><strong id="dns_api_66004__b842352706112423">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_66004__r6efd36b450494483b222910e404b1e6a"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66004__a7f00431d42ae407e9b0e4d81c5938835">marker</p>
</td>
<td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_66004__ad6af330a24be43aa9721d334a5175266">No</p>
</td>
<td class="cellrowborder" valign="top" width="14.14141414141414%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_66004__a6a5ec28098714553b4b375b27253f5a3">String</p>
</td>
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_66004__p6505910417182">Start resource ID of pagination query</p>
<p id="dns_api_66004__a5e11749436c54f85807503bca7950ef0">If the parameter is left blank, only resources on the first page are queried.</p>
<p id="dns_api_66004__p64815261440">The value is left blank by default.</p>
</td>
</tr>
<tr id="dns_api_66004__r4be7a5418c324afd9a5d1bfaccccc5a2"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66004__a473baa503056414f89deaa313549266d">limit</p>
</td>
<td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_66004__a704b39f2d90b445b96e210fa5803b4be">No</p>
</td>
<td class="cellrowborder" valign="top" width="14.14141414141414%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_66004__a883425368cca4e889138f0f3a93c3850">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_66004__p230120311413">Number of resources on each page</p>
<p id="dns_api_66004__p147131447514">The value ranges from <strong id="dns_api_66004__b1995517551553">0</strong> to <strong id="dns_api_66004__b1996725511514">500</strong>.</p>
<p id="dns_api_66004__p1385813431412">Commonly used values are <strong id="dns_api_66004__b11600012114311">10</strong>, <strong id="dns_api_66004__b14601111294316">20</strong>, and <strong id="dns_api_66004__b2602181210431">50</strong>. The default value is <strong id="dns_api_66004__b13626201344312">500</strong>.</p>
</td>
</tr>
<tr id="dns_api_66004__row58150604195642"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66004__p11536930195644">offset</p>
</td>
<td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_66004__p62076162195644">No</p>
</td>
<td class="cellrowborder" valign="top" width="14.14141414141414%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_66004__p62113243195644">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_66004__p35951433204916">Start offset of pagination query. The query will start from the next resource of the offset value.</p>
<p id="dns_api_66004__p18898143914915">The value ranges from <strong id="dns_api_66004__b6946144955717">0</strong> to <strong id="dns_api_66004__b3958174975715">2147483647</strong>.</p>
<p id="dns_api_66004__p13209172234718">The default value is 0.</p>
<p id="dns_api_66004__p167712216335">If <strong id="dns_api_66004__b16159132144319">marker</strong> is not left blank, the query starts from the resource specified by <strong id="dns_api_66004__b19160172174310">marker</strong>.</p>
</td>
</tr>
<tr id="dns_api_66004__row6180858115857"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66004__p6537624212219">tags</p>
</td>
<td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_66004__p6098421112219">No</p>
</td>
<td class="cellrowborder" valign="top" width="14.14141414141414%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_66004__p4077405312219">String</p>
</td>
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_66004__p1436398312219">Resource tag</p>
<p id="dns_api_66004__p6216698912219">The format is as follows: <strong id="dns_api_66004__b8423527069140">key1,value1|key2,value2</strong>.</p>
<p id="dns_api_66004__p64141841114123">Multiple tags are separated by vertical bar (|). The key and value of each tag are separated by comma (,).</p>
<p id="dns_api_66004__p2263199412219">The tags are in AND relationship.</p>
<p id="dns_api_66004__p65263192115146">For details, see <a href="dns_api_67001.html">Adding Resource Tags</a>.</p>
<p id="dns_api_66004__p1770514714203">Exact matching will work. If the value starts with an asterisk (*), fuzzy matching will work for the string following the asterisk.</p>
<p id="dns_api_66004__p71284149127">The value is left blank by default.</p>
</td>
</tr>
<tr id="dns_api_66004__row2017310361177"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_66004__p6738102411167">status</p>
</td>
<td class="cellrowborder" valign="top" width="17.17171717171717%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_66004__p973842401614">No</p>
</td>
<td class="cellrowborder" valign="top" width="14.14141414141414%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_66004__p1173872481613">String</p>
</td>
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_66004__p08895418160">Resource status</p>
<p id="dns_api_66004__p168892041161615">For details, see <a href="dns_api_80005.html#dns_api_80005__section33673592114748">Resource Status</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="dns_api_66004__section8713795"><h4 class="sectiontitle">Request</h4><ul id="dns_api_66004__ul35351571269"><li id="dns_api_66004__li1053565782615">Request parameters<p id="dns_api_66004__p1815201642711"><a name="dns_api_66004__li1053565782615"></a><a name="li1053565782615"></a>None</p>
</li><li id="dns_api_66004__li4109190182715">Example request<p id="dns_api_66004__p1651121054613"><a name="dns_api_66004__li4109190182715"></a><a name="li4109190182715"></a>List required PTR records.</p>
<pre class="codeblock" id="dns_api_66004__codeblock582435120187">GET https://{DNS_Endpoint}/v2/reverse/floatingips</pre>
</li></ul>
</div>
<div class="section" id="dns_api_66004__section11315292"><h4 class="sectiontitle">Response</h4><ul id="dns_api_66004__ul58401041181216"><li id="dns_api_66004__li51555853181216">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66004__table13410777181232" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the response</caption><thead align="left"><tr id="dns_api_66004__row8598877181232"><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_66004__p25420464181232"><strong id="dns_api_66004__b809642556">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.43%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="dns_api_66004__p45791683181232"><strong id="dns_api_66004__b1250139517">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="66.39%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="dns_api_66004__p18138814181232"><strong id="dns_api_66004__b1514120109">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_66004__row59957834181232"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66004__p24746382181232">links</p>
</td>
<td class="cellrowborder" valign="top" width="15.43%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66004__p58299955181232">Object</p>
</td>
<td class="cellrowborder" valign="top" width="66.39%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66004__p5040034717923">Link to the current resource or other related resources.</p>
<p id="dns_api_66004__p5094994217923">When a response is broken into pages, a <strong id="dns_api_66004__b84235270695245">next</strong> link is provided to retrieve all results. For details, see <a href="#dns_api_66004__table354521744216">Table 5</a>.</p>
</td>
</tr>
<tr id="dns_api_66004__row17649295181232"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66004__p20306794181232">metadata</p>
</td>
<td class="cellrowborder" valign="top" width="15.43%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66004__p34237593181232">Object</p>
</td>
<td class="cellrowborder" valign="top" width="66.39%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66004__p21781637181232">Number of resources that meet the filter condition. For details, see <a href="#dns_api_66004__table16355953155210">Table 4</a>.</p>
</td>
</tr>
<tr id="dns_api_66004__row61817005181232"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_66004__p41121470181232">floatingips</p>
</td>
<td class="cellrowborder" valign="top" width="15.43%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_66004__p1974516569913">Array of object</p>
</td>
<td class="cellrowborder" valign="top" width="66.39%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_66004__p20334170181232">PTR record object list. For details, see <a href="#dns_api_66004__table43740677113542">Table 3</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="p" id="dns_api_66004__p43749884165817">
<div class="tablenoborder"><a name="dns_api_66004__table43740677113542"></a><a name="table43740677113542"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66004__table43740677113542" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Description of the <strong id="dns_api_66004__b902497492152915">floatingips</strong> field</caption><thead align="left"><tr id="dns_api_66004__rc433fa5ceea44999bda6baae10282bed"><th align="left" class="cellrowborder" valign="top" width="18.18%" id="mcps1.3.4.2.1.2.1.2.4.1.1"><p id="dns_api_66004__en-us_topic_0042318613_p690539418456"><strong id="dns_api_66004__b1913579592">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.189999999999998%" id="mcps1.3.4.2.1.2.1.2.4.1.2"><p id="dns_api_66004__aec3926ab378e4c9fafd96942ae9c2f24"><strong id="dns_api_66004__b224366952">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.629999999999995%" id="mcps1.3.4.2.1.2.1.2.4.1.3"><p id="dns_api_66004__en-us_topic_0042318613_p781187018456"><strong id="dns_api_66004__b1935777472">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_66004__rf59c1308b662423d9e5c5eb972f057a1"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__af1202b164f13422d896f91d34faf7c44">id</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__p27591010151011">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__a48e534dd79ef418ab79ff1303a8ff149">PTR record ID, which is in <strong id="dns_api_66004__b842352706151833">{region}:{floatingip_id}</strong> format</p>
</td>
</tr>
<tr id="dns_api_66004__r8de792b7f9bb42a5bbd359fd67c55802"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__affabc5d973dd43ef8f81431cfbba2e4d">ptrdname</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__p598126105">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__a695a30773b7b4545a348899428360b0c">Domain name of the PTR record</p>
</td>
</tr>
<tr id="dns_api_66004__r07959df68aa640f7b2550a4ec13bd321"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__a58edc66abfd94b8d88234ccc87f993ef">description</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__p183479136108">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__a26cda8d7c28c484a8555271f1b7c9c18">PTR record description</p>
</td>
</tr>
<tr id="dns_api_66004__rc07302b7ba7748e2bd3ba03f66d4d046"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__ac280dc3e9e514cb4bb61dc356b75c265">ttl</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__a2faf54e82d504a619ab8183ab083c6f4">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__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_66004__p1837175484310">If your service address is frequently changed, set TTL to a smaller value.</p>
<p id="dns_api_66004__a3c9384952a064d6da121077d6f1faf0a">The value ranges from <strong id="dns_api_66004__b8281195615920">1</strong> to <strong id="dns_api_66004__b132595593591">2147483647</strong>.</p>
<p id="dns_api_66004__p0873451124411">The default value is <strong id="dns_api_66004__b144341610194811">300</strong>.</p>
</td>
</tr>
<tr id="dns_api_66004__rb0577738b87a4dafb23d0a1ef4cac7ed"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__a6c80427db35e48689eb4ae318fc8fa30">address</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__p1922131461018">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__a01a51f050f414b669b4a08478ede886e">EIP</p>
</td>
</tr>
<tr id="dns_api_66004__r9d3448295e68459db0bade4562e211a5"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__a29ee325b52134a3f847bbee5c91b1da3">status</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__p86891651016">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__a133beb6a97ed42bdac622271072840e6">Resource status</p>
<p id="dns_api_66004__p4158416129">For details, see <a href="dns_api_80005.html#dns_api_80005__section33673592114748">Resource Status</a>.</p>
</td>
</tr>
<tr id="dns_api_66004__rb4683cb844214f51ae468943568b4cde"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__a1d911558e18444b3896ace2ed6ccbaec">action</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__ae39f64d2c5af4dae91b509416f77d31d">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__en-us_topic_0042318613_p507362318456">Requested operation on the resource</p>
<p id="dns_api_66004__p3570202615112">The value can be <strong id="dns_api_66004__b175801201481">CREATE</strong>, <strong id="dns_api_66004__b7581132012489">UPDATE</strong>, <strong id="dns_api_66004__b18582192074819">DELETE</strong>, or <strong id="dns_api_66004__b7583520194812">NONE</strong>.</p>
<p id="dns_api_66004__p1959511502122"><strong id="dns_api_66004__b185013231484">NONE</strong> indicates that no operation will be performed.</p>
</td>
</tr>
<tr id="dns_api_66004__re6d739b3d80f4bcda0e2ad834dc1d66f"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__en-us_topic_0042318613_p204899518456">links</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__ad894d21cefa74634a62f6964f84019f6">Object</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__ab163171b57cd4600a059890e5f4373ce">Link to the current resource or other related resources.</p>
<p id="dns_api_66004__a4dc7ac60268d4291a27544e93c236e22">When a response is broken into pages, a <strong id="dns_api_66004__b2670674215521">next</strong> link is provided to retrieve all results. For details, see <a href="#dns_api_66004__table354521744216">Table 5</a>.</p>
</td>
</tr>
<tr id="dns_api_66004__row1356514291481"><td class="cellrowborder" valign="top" width="18.18%" headers="mcps1.3.4.2.1.2.1.2.4.1.1 "><p id="dns_api_66004__p145019941317">tags</p>
</td>
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.4.2.1.2.1.2.4.1.2 "><p id="dns_api_66004__p75011918138">Array of <a href="#dns_api_66004__table8387205213225">tag</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.4.2.1.2.1.2.4.1.3 "><p id="dns_api_66004__p1350114961316">Resource tag.</p>
<p id="dns_api_66004__p111349461418">The format is as follows: <strong id="dns_api_66004__b484540272">key1,value1|key2,value2</strong>.</p>
<p id="dns_api_66004__p18134744140">Multiple tags are separated by vertical bar (|). The key and value of each tag are separated by comma (,).</p>
<p id="dns_api_66004__p18134204181420">The tags are in AND relationship.</p>
<p id="dns_api_66004__p8134749148">For details, see <a href="#dns_api_66004__table8387205213225">Table 6</a>.</p>
<p id="dns_api_66004__p61341740143">Exact matching will work. If the value starts with an asterisk (*), fuzzy matching will work for the string following the asterisk.</p>
<p id="dns_api_66004__p1713404141413">The value is left blank by default.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="p" id="dns_api_66004__p8495103015187">
<div class="tablenoborder"><a name="dns_api_66004__table16355953155210"></a><a name="table16355953155210"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66004__table16355953155210" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Description of the <strong id="dns_api_66004__b422033284820">metadata</strong> field</caption><thead align="left"><tr id="dns_api_66004__r1ee98e923a7c4bfcaa89e708d3fca79e"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.3.1.2.4.1.1"><p id="dns_api_66004__af493c2fde22f44069c2b5ea0467dfe89"><strong id="dns_api_66004__b118035117498">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.3.1.2.4.1.2"><p id="dns_api_66004__a581940a484df4c8294e51f11391a23c8"><strong id="dns_api_66004__b1712134722">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.3.1.2.4.1.3"><p id="dns_api_66004__a0301bbf5a1234ea3a88a104e1b4cff92"><strong id="dns_api_66004__b4633937490">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_66004__r7cc02a0ecbd24482bca90faa98114b18"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.3.1.2.4.1.1 "><p id="dns_api_66004__a9234858cb2f447539b4b85a307884322">total_count</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.3.1.2.4.1.2 "><p id="dns_api_66004__af14a2a2c8f0345f4811bb21dd2a9b667">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.3.1.2.4.1.3 "><p id="dns_api_66004__a39058f9901c84eb9a776ca5cd44ede29">Number of resources that meet the filter criteria. The number is irrelevant to <strong id="dns_api_66004__b1331875204910">limit</strong> or <strong id="dns_api_66004__b83191459497">offset</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="tablenoborder"><a name="dns_api_66004__table354521744216"></a><a name="table354521744216"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66004__table354521744216" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Parameters in the <strong id="dns_api_66004__b98946611494">links</strong> field</caption><thead align="left"><tr id="dns_api_66004__row954518179427"><th align="left" class="cellrowborder" valign="top" width="18.3018301830183%" id="mcps1.3.4.2.1.4.2.4.1.1"><p id="dns_api_66004__p654513173424"><strong id="dns_api_66004__b1972147154914">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.591959195919593%" id="mcps1.3.4.2.1.4.2.4.1.2"><p id="dns_api_66004__p654551714212"><strong id="dns_api_66004__b1648784907">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.10621062106211%" id="mcps1.3.4.2.1.4.2.4.1.3"><p id="dns_api_66004__p1545141717427"><strong id="dns_api_66004__b3949788499">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_66004__row3545101710429"><td class="cellrowborder" valign="top" width="18.3018301830183%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="dns_api_66004__p115467171428">self</p>
</td>
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="dns_api_66004__p254611713427">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.10621062106211%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="dns_api_66004__p5546171744214">Link to the current resource</p>
</td>
</tr>
<tr id="dns_api_66004__row20182104310515"><td class="cellrowborder" valign="top" width="18.3018301830183%" headers="mcps1.3.4.2.1.4.2.4.1.1 "><p id="dns_api_66004__p136561245153620">next</p>
</td>
<td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.3.4.2.1.4.2.4.1.2 "><p id="dns_api_66004__p19656144517367">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.10621062106211%" headers="mcps1.3.4.2.1.4.2.4.1.3 "><p id="dns_api_66004__p76567451365">Link to the next page</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dns_api_66004__table8387205213225"></a><a name="table8387205213225"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_66004__table8387205213225" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Description of the <strong id="dns_api_66004__dns_api_80006_b410310455010">tag</strong> field</caption><thead align="left"><tr id="dns_api_66004__dns_api_80006_row15361836112436"><th align="left" class="cellrowborder" valign="top" width="18.011801180118013%" id="mcps1.3.4.2.1.5.2.4.1.1"><p id="dns_api_66004__dns_api_80006_p58707511112436"><strong id="dns_api_66004__dns_api_80006_b129171645401">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.28192819281928%" id="mcps1.3.4.2.1.5.2.4.1.2"><p id="dns_api_66004__dns_api_80006_p42210623112436"><strong id="dns_api_66004__dns_api_80006_b117891464017">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.70627062706271%" id="mcps1.3.4.2.1.5.2.4.1.3"><p id="dns_api_66004__dns_api_80006_p63617265112436"><strong id="dns_api_66004__dns_api_80006_b15591647504">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_66004__dns_api_80006_row35684479112436"><td class="cellrowborder" valign="top" width="18.011801180118013%" headers="mcps1.3.4.2.1.5.2.4.1.1 "><p id="dns_api_66004__dns_api_80006_p13313439112530">key</p>
</td>
<td class="cellrowborder" valign="top" width="19.28192819281928%" headers="mcps1.3.4.2.1.5.2.4.1.2 "><p id="dns_api_66004__dns_api_80006_p35653193112436">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.70627062706271%" headers="mcps1.3.4.2.1.5.2.4.1.3 "><p id="dns_api_66004__dns_api_80006_p011410211144">Tag key</p>
<p id="dns_api_66004__dns_api_80006_p12621122816413">A key can contain up to 36 Unicode characters. The key cannot be empty. </p>
</td>
</tr>
<tr id="dns_api_66004__dns_api_80006_row20048002112436"><td class="cellrowborder" valign="top" width="18.011801180118013%" headers="mcps1.3.4.2.1.5.2.4.1.1 "><p id="dns_api_66004__dns_api_80006_p66095544112533">value</p>
</td>
<td class="cellrowborder" valign="top" width="19.28192819281928%" headers="mcps1.3.4.2.1.5.2.4.1.2 "><p id="dns_api_66004__dns_api_80006_p60123528112436">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.70627062706271%" headers="mcps1.3.4.2.1.5.2.4.1.3 "><p id="dns_api_66004__dns_api_80006_p592417401420">Tag value</p>
<p id="dns_api_66004__dns_api_80006_p3383124915419">Each value can contain up to 43 Unicode characters and can be an empty string. </p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="dns_api_66004__ul47260332"><li id="dns_api_66004__li22689808">Example response<pre class="screen" id="dns_api_66004__screen35851767194741">{
"links": {
"self": "https://<em id="dns_api_66004__i25323571142155">Endpoint</em>/v2/reverse/floatingips",
"next": "https://<em id="dns_api_66004__i19982811117">Endpoint</em>/v2/zones?id=&amp;limit=1&amp;marker=<em id="dns_api_66004__i187836371243">region_id</em>:c5504932-bf23-4171-b655-b87a6bc59334"
},
"metadata": {
"total_count": 1
},
"floatingips": [
{
"id": "<em id="dns_api_66004__i25497014143134">region_id</em>:c5504932-bf23-4171-b655-b87a6bc59334",
"ptrdname": "www.example.com.",
"description": "Description for this PTR record",
"address": "10.154.52.138",
"action": "NONE",
"ttl": 300,
"status": "ACTIVE",
"links": {
"self": "https://<em id="dns_api_66004__i12436408142224">Endpoint</em>/v2/reverse/floatingips/<em id="dns_api_66004__i6626007614322">region_id</em>:c5504932-bf23-4171-b655-b87a6bc59334"
}
}
]
}</pre>
</li></ul>
</div>
<div class="section" id="dns_api_66004__section9249181042119"><h4 class="sectiontitle">Returned Value</h4><p id="dns_api_66004__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_66004__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>
View Git Blame Copy Permalink