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

272 lines
22 KiB
HTML
Raw Permalink Blame History

<a name="dns_api_62006"></a><a name="dns_api_62006"></a>
<h1 class="topictitle1">Modifying a Public Zone</h1>
<div id="body1508844683156"><div class="section" id="dns_api_62006__section2763065016101"><h4 class="sectiontitle">Function</h4><p id="dns_api_62006__p13295121172537">Modify a public zone.</p>
</div>
<div class="section" id="dns_api_62006__section53701671161015"><h4 class="sectiontitle">URI</h4><p id="dns_api_62006__p554371517266">PATCH /v2/zones/{zone_id}</p>
<div class="p" id="dns_api_62006__p454702216814">For details, see <a href="#dns_api_62006__table56746773172616">Table 1</a>.
<div class="tablenoborder"><a name="dns_api_62006__table56746773172616"></a><a name="table56746773172616"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_62006__table56746773172616" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter in the URI</caption><thead align="left"><tr id="dns_api_62006__row12848229172616"><th align="left" class="cellrowborder" valign="top" width="19.598040195980403%" id="mcps1.3.2.3.2.2.5.1.1"><p id="dns_api_62006__p44975878172616"><strong id="dns_api_62006__b162774213314533">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.537946205379463%" id="mcps1.3.2.3.2.2.5.1.2"><p id="dns_api_62006__p46443918172616"><strong id="dns_api_62006__b593421527191713">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.958604139586042%" id="mcps1.3.2.3.2.2.5.1.3"><p id="dns_api_62006__p1368350172616"><strong id="dns_api_62006__b84235270619112">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.9054094590541%" id="mcps1.3.2.3.2.2.5.1.4"><p id="dns_api_62006__p24157908172616"><strong id="dns_api_62006__b842352706112423">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_62006__row39993297172616"><td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_62006__p43071797172616">zone_id</p>
</td>
<td class="cellrowborder" valign="top" width="20.537946205379463%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_62006__p26647585172616">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="13.958604139586042%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_62006__p21075379172616">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.9054094590541%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_62006__p4976396172616">ID of the zone to be modified</p>
<p id="dns_api_62006__p1669018482183">You can obtain the value by calling the API in <a href="dns_api_62003.html">Querying Public Zones</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="dns_api_62006__section44958995161021"><h4 class="sectiontitle">Request</h4><ul id="dns_api_62006__ul5122522817716"><li id="dns_api_62006__li5604781117716">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_62006__table3720408817742" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the request</caption><thead align="left"><tr id="dns_api_62006__row6225671717742"><th align="left" class="cellrowborder" valign="top" width="18.208179182081793%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="dns_api_62006__p5153686617742"><strong id="dns_api_62006__b1050681160">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.948005199480054%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="dns_api_62006__p473035017742"><strong id="dns_api_62006__b516690007">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.108689131086889%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="dns_api_62006__p386753717742"><strong id="dns_api_62006__b1865986441">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="48.735126487351266%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="dns_api_62006__p5956810717742"><strong id="dns_api_62006__b968263453">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_62006__row1973909717742"><td class="cellrowborder" valign="top" width="18.208179182081793%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62006__p5474826717742">description</p>
</td>
<td class="cellrowborder" valign="top" width="19.948005199480054%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62006__p759162017742">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.108689131086889%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62006__p3220634117742">String</p>
</td>
<td class="cellrowborder" valign="top" width="48.735126487351266%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62006__p6675950017742">Description of the zone, which cannot exceed 255 characters</p>
<p id="dns_api_62006__p37540522006">If this parameter is left blank, the value will not be changed.</p>
<p id="dns_api_62006__p474692155919">The value is left blank by default.</p>
</td>
</tr>
<tr id="dns_api_62006__row4358988017742"><td class="cellrowborder" valign="top" width="18.208179182081793%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62006__p6536976617742">email</p>
</td>
<td class="cellrowborder" valign="top" width="19.948005199480054%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62006__p650279617742">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.108689131086889%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62006__p2054573717742">String</p>
</td>
<td class="cellrowborder" valign="top" width="48.735126487351266%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62006__p1997196517742">Email address of the administrator managing the zone</p>
<p id="dns_api_62006__p16253220614">If this parameter is left blank, the value will not be changed.</p>
<p id="dns_api_62006__p8877142595919">The value is left blank by default.</p>
</td>
</tr>
<tr id="dns_api_62006__row13489593141045"><td class="cellrowborder" valign="top" width="18.208179182081793%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62006__p18915273141045">ttl</p>
</td>
<td class="cellrowborder" valign="top" width="19.948005199480054%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62006__p55742162141045">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.108689131086889%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62006__p18821243141045">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="48.735126487351266%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62006__p3447255141334">Caching period of the SOA record set (in seconds)</p>
<p id="dns_api_62006__p11670607161834">The value range from <strong id="dns_api_62006__b113362247548">1</strong> to <strong id="dns_api_62006__b570532812548">2147483647</strong>.</p>
<p id="dns_api_62006__p52661425313">If this parameter is left blank, the value will not be changed.</p>
<p id="dns_api_62006__p61411742165919">The value is left blank by default.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="dns_api_62006__li3969179817718">Example request<p id="dns_api_62006__p6582341195416"><a name="dns_api_62006__li3969179817718"></a><a name="li3969179817718"></a>Modify the zone whose ID is 2c9eb155587194ec01587224c9f90149:</p>
<pre class="codeblock" id="dns_api_62006__codeblock97731434110">PATCH https://{DNS_Endpoint}/v2/zones/2c9eb155587194ec01587224c9f90149</pre>
<pre class="screen" id="dns_api_62006__screen1498810934119">{
"description": "This is an example zone.",
"email": "xx@example.org",
"ttl": 300
}</pre>
</li></ul>
</div>
<div class="section" id="dns_api_62006__section40090803161031"><h4 class="sectiontitle">Response</h4><ul id="dns_api_62006__ul23606531716"><li id="dns_api_62006__li629745117110">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_62006__table3873760215524" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameters in the response</caption><thead align="left"><tr id="dns_api_62006__rcb8f5a6dbdc841d5b61b57c9a7f3946c"><th align="left" class="cellrowborder" valign="top" width="17.990000000000002%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="dns_api_62006__a562463c38c994a46a5042605cbae16a2"><strong id="dns_api_62006__b842835012518">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.77%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="dns_api_62006__a037a944fa232408f9eb6d06f523458c3"><strong id="dns_api_62006__en-us_topic_0124033550_b241310583408">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.239999999999995%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="dns_api_62006__ab503838cab8b41b5aacf832f2abc24e4"><strong id="dns_api_62006__b844711541953">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_62006__r90f043c750eb4b4e8d242b7f8db14709"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a8bb1298f194542789a4889ca1ecb0500">id</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__ae7f12de3cd5143d9b7c81746c73de547">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__af2aa29bf11dc4ede8a83ffe698c6d015">Zone ID, which is a UUID used to identify the zone</p>
</td>
</tr>
<tr id="dns_api_62006__rd94a8eae3993428ba58b7935d38f2c42"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a5b7f90ac0e964a4e8d5c3b54801a0263">name</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__a7f54cec7482f402295ad3e3bbf884023">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__a84a47ec529944403bd51bd1a130bfa9a">Zone name</p>
</td>
</tr>
<tr id="dns_api_62006__r8a93c0d071624062b4332156e7c1afd3"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__ac8461d5571384d2f99735f4dd17f36e4">description</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__ac782ad392b6549dc9a55042f0e89e799">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__abf3153770d0a4cf8a9ee79c8455167d5">Zone description</p>
</td>
</tr>
<tr id="dns_api_62006__rd2df7eeb23d348c3825c57d44911c2c0"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a5228458b23264d239a4eee40c3001c4f">email</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__en-us_topic_0057310891_p336297171039">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__a72bf01280e51418ea295143d10e30fdb">Email address of the administrator managing the zone</p>
</td>
</tr>
<tr id="dns_api_62006__rf57ffed6121d407da625ad56b3b3741f"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__ac0b14f3593ff4331b7cd6056c8d36a44">zone_type</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__aab451733f1be44f8ac79d479ca1093f3">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__a57638dc3c92f4e10850d4d6ad42a846e">Zone type, which can be <strong id="dns_api_62006__b172671162061">public</strong> or <strong id="dns_api_62006__b1326818617617">private</strong></p>
</td>
</tr>
<tr id="dns_api_62006__ra6a15f87215c470e8c2fa6d2aa4a8ccc"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a2e889a776aeb42f59e288b92b372bd70">ttl</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__a292032dd82fe4a0dbf0ff69bfd93d876">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__ab96c3883e8424c3187881c9ea265794f">TTL value of the SOA record set in the zone</p>
<p id="dns_api_62006__p0662131993410">The value ranges from <strong id="dns_api_62006__dns_api_62001_b2613115265713">1</strong> to <strong id="dns_api_62006__dns_api_62001_b662035245714">2147483647</strong>.</p>
<p id="dns_api_62006__p7662111973418">The default value is <strong id="dns_api_62006__dns_api_62001_b19778105913578">300</strong>.</p>
</td>
</tr>
<tr id="dns_api_62006__r6f01d44c0047469b9ee578db3ae2e925"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__ac99c652f1d284ec496be4ad0b5364a1a">serial</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__ae5ee649ac6aa4bb4a20e678d9a24e19a">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__p201115484116">Serial number in the SOA record set in a zone, which identifies the change on the primary DNS server</p>
<p id="dns_api_62006__p7524749171039">This parameter is not used currently.</p>
</td>
</tr>
<tr id="dns_api_62006__r50c368b3aa0b46f38a4617b7f797786f"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a1d2ec6fad225464f9732756d33a337b2">status</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__a62bc066b1f5844588aa3d383f46fe71f">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__aa34a63cd4c824904be6636a6daaa09a9">Resource status</p>
<p id="dns_api_62006__a0a74025bb90644338ac11860b3ef9f42">For details, see <a href="dns_api_80005.html#dns_api_80005__section33673592114748">Resource Status</a>.</p>
</td>
</tr>
<tr id="dns_api_62006__r3d7c6c02e04d40c0bdd0ef0a8a6045f9"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a4873ee3d3c85419b9aba19243d2c84a7">record_num</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__a162e7c19e8be4764a2becf7706a46e6e">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__ab88a87d30e8e491f99661f9757711d6d">Number of record sets in the zone</p>
</td>
</tr>
<tr id="dns_api_62006__rfba699f600ef424cadbca2cd85b60887"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a2271452821c249cb9f3a445fcf60a03f">pool_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__a3fbd39a058f042e190756f9b4f941e56">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__a8caf365222c34b929a1501acd4493bd1">Pool ID of the zone, which is assigned by the system</p>
</td>
</tr>
<tr id="dns_api_62006__ra366d35afa104cab8a41e36b89ca0e82"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a3026f7c44fdc4ca887f0469710558f47">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__ac54288dbf5be47a98690cfeff1e25721">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__ad419bb0aafcd4bd2adf188dbd375f71e">Project ID of the zone</p>
</td>
</tr>
<tr id="dns_api_62006__r3bb52953237f4d90883feb17321b3754"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__aa1ed0627514440769d59691c0297bb20">created_at</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__a5131a3345de141acba4d51eceb924480">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__a4c5d9647086944e888608bc848e37e4c">Time when the zone was created</p>
<p id="dns_api_62006__p583516468316">The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.</p>
</td>
</tr>
<tr id="dns_api_62006__rf0e8562b23244c968c21c2f7ffc1e376"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a27068ff11a0443f9ad9964f4934f1be6">updated_at</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__a8d6c4b16bc5c4b42a86e2ea9ebdff263">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__a904e167e17d0450aa1f324b045fb7f4f">Time when the zone was updated</p>
<p id="dns_api_62006__en-us_topic_0057310891_p583516468316">The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.</p>
</td>
</tr>
<tr id="dns_api_62006__rc71d074f37b143968b8b33fb7d0887c8"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__en-us_topic_0057310891_p288749251572">links</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__en-us_topic_0057310891_p571676251572">Object</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__en-us_topic_0057310891_p660161572">Link to the current resource or other related resources. When a response is broken into pages, a <strong id="dns_api_62006__b111251359274">next</strong> link is provided to retrieve all results.</p>
<p id="dns_api_62006__p202920222455">For details, see <a href="#dns_api_62006__table0172144213344">Table 4</a>.</p>
</td>
</tr>
<tr id="dns_api_62006__r5a57c1dba2934130a772bfc188e27c7b"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62006__a414da27796154a8ea0f3f5d155266ce6">masters</p>
</td>
<td class="cellrowborder" valign="top" width="19.77%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_62006__ac58ddffcdd4b4db48b9da9a1aa4b94b8">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="62.239999999999995%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_62006__a67f94f4a1cee4d80ad3886d215def3de">Master DNS servers, from which the slave servers get DNS information</p>
<p id="dns_api_62006__en-us_topic_0057310891_p05918233215">This parameter is not used currently.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dns_api_62006__table0172144213344"></a><a name="table0172144213344"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_62006__table0172144213344" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Description of the <strong id="dns_api_62006__b20341920189">links</strong> field</caption><thead align="left"><tr id="dns_api_62006__row917304253418"><th align="left" class="cellrowborder" valign="top" width="18.099999999999998%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="dns_api_62006__p101731742153416"><strong id="dns_api_62006__b106461211483">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.88%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="dns_api_62006__p0174542163418"><strong id="dns_api_62006__b19371238817">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.019999999999996%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="dns_api_62006__p7174194243414"><strong id="dns_api_62006__b15855182410811">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="dns_api_62006__row1390694871216"><td class="cellrowborder" valign="top" width="18.099999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="dns_api_62006__p8907184881217">self</p>
</td>
<td class="cellrowborder" valign="top" width="19.88%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="dns_api_62006__p9907184891219">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.019999999999996%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="dns_api_62006__p1890754813127">Link to the current resource</p>
</td>
</tr>
<tr id="dns_api_62006__row15778204719370"><td class="cellrowborder" valign="top" width="18.099999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="dns_api_62006__p136561245153620">next</p>
</td>
<td class="cellrowborder" valign="top" width="19.88%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="dns_api_62006__p19656144517367">String</p>
</td>
<td class="cellrowborder" valign="top" width="62.019999999999996%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="dns_api_62006__p76567451365">Link to the next page</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="dns_api_62006__li448136901716">Example response<pre class="screen" id="dns_api_62006__screen6413204020223">{
"id": "2c9eb155587194ec01587224c9f90149",
"name": "example.com.",
"description": "This is an example zone.",
"email": "xx@example.com",
"ttl": 300,
"serial": 1,
"masters": [],
"status": "ACTIVE",
"links": {
"self": "https://<em id="dns_api_62006__i45374312141510">Endpoint</em>/v2/zones/2c9eb155587194ec01587224c9f90149"
},
"pool_id": "00000000570e54ee01570e9939b20019",
"project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
"zone_type": "public",
"created_at": "2016-11-17T11:56:03.439",
"updated_at": "2016-11-17T11:56:05.749",
"record_num": 2
}</pre>
</li></ul>
</div>
<div class="section" id="dns_api_62006__section9249181042119"><h4 class="sectiontitle">Returned Value</h4><p id="dns_api_62006__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_62006__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_62000.html">Public Zone Management</a></div>
</div>
</div>
View Git Blame Copy Permalink