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>
320 lines
25 KiB
HTML
320 lines
25 KiB
HTML
<a name="dns_api_62001"></a><a name="dns_api_62001"></a>
|
|
|
|
<h1 class="topictitle1">Creating a Public Zone</h1>
|
|
<div id="body1492847341093"><div class="section" id="dns_api_62001__section3569153217343"><h4 class="sectiontitle">Function</h4><p id="dns_api_62001__p2420228517348">Create a public zone.</p>
|
|
</div>
|
|
<div class="section" id="dns_api_62001__section6163262617350"><h4 class="sectiontitle">URI</h4><p id="dns_api_62001__p5527305017659">POST /v2/zones</p>
|
|
</div>
|
|
<div class="section" id="dns_api_62001__section4207148117353"><h4 class="sectiontitle">Request</h4><ul id="dns_api_62001__ul5122522817716"><li id="dns_api_62001__li5604781117716">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_62001__table3720408817742" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters in the request</caption><thead align="left"><tr id="dns_api_62001__row6225671717742"><th align="left" class="cellrowborder" valign="top" width="16.16%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="dns_api_62001__p5153686617742"><strong id="dns_api_62001__b162774213314533_1">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.459999999999997%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="dns_api_62001__p473035017742"><strong id="dns_api_62001__b593421527191713_1">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12.590000000000002%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="dns_api_62001__p386753717742"><strong id="dns_api_62001__b84235270619112_1">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="52.790000000000006%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="dns_api_62001__p5956810717742"><strong id="dns_api_62001__b842352706112423_1">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dns_api_62001__row1329410717742"><td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62001__p3414560317742">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62001__p6603174617742">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.590000000000002%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62001__p360216817742">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="52.790000000000006%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62001__p2651334817742">Domain name registered with the domain name registrar</p>
|
|
<ul id="dns_api_62001__ul1677295557"><li id="dns_api_62001__li167529125515">If a domain name is ended with a dot (.), it cannot exceed 254 characters.</li><li id="dns_api_62001__li86713293557">If a domain name is not ended with a dot (.), it cannot exceed 253 characters.</li><li id="dns_api_62001__li3672029115515">A domain name cannot exceed 63 characters. Multiple domain names are separated with dots (.).</li></ul>
|
|
<p id="dns_api_62001__p3680010615524">A domain name is case insensitive. Uppercase letters will also be converted into lowercase letters.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row1973909717742"><td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62001__p5474826717742">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62001__p759162017742">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.590000000000002%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62001__p3220634117742">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="52.790000000000006%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62001__p6675950017742">Description of the zone, which cannot exceed 255 characters</p>
|
|
<p id="dns_api_62001__p10578150184319">The value is left blank by default.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row3526956217742"><td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62001__p5656791917742">zone_type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62001__p2306625217742">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.590000000000002%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62001__p5927915117742">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="52.790000000000006%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62001__p1460824917742">Zone type, which can be <strong id="dns_api_62001__b842352706113548">public</strong> or <strong id="dns_api_62001__b842352706113551">private</strong></p>
|
|
<ul id="dns_api_62001__ul3411250511841"><li id="dns_api_62001__li3430935611841"><strong id="dns_api_62001__b84235270691511">public</strong>: public zones accessible to hosts on the Internet</li><li id="dns_api_62001__li2055999811841"><strong id="dns_api_62001__b8423527069166">private</strong>: private zones accessible only to hosts in specified VPCs</li></ul>
|
|
<p id="dns_api_62001__p5903182219130">If the value is left blank, a public zone will be created. For details about how to create a private zone, see <a href="dns_api_63002.html">Creating a Private Zone</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row4358988017742"><td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62001__p6536976617742">email</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62001__p650279617742">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.590000000000002%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62001__p2054573717742">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="52.790000000000006%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62001__p1997196517742">Email address of the administrator managing the zone</p>
|
|
<p id="dns_api_62001__p435013473818">The default value is the service email address.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row13489593141045"><td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62001__p18915273141045">ttl</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62001__p55742162141045">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.590000000000002%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62001__p18821243141045">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="52.790000000000006%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62001__p3447255141334">Caching period of the SOA record set (in seconds)</p>
|
|
<p id="dns_api_62001__p5335091141210">The value ranges from <strong id="dns_api_62001__b2613115265713">1</strong> to <strong id="dns_api_62001__b662035245714">2147483647</strong>.</p>
|
|
<p id="dns_api_62001__p9461175874917">The default value is <strong id="dns_api_62001__b19778105913578">300</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row964631312824"><td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_62001__p5754504312824">tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_62001__p3063693212824">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.590000000000002%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_62001__p6567246612824">Array of object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="52.790000000000006%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_62001__p1786954012824">Resource tag. For details, see <a href="#dns_api_62001__table619059185111">Table 2</a>.</p>
|
|
<p id="dns_api_62001__p391920411506">The value is left blank by default.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="dns_api_62001__table619059185111"></a><a name="table619059185111"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_62001__table619059185111" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Description of the <strong id="dns_api_62001__b152751649111611">tags</strong> field</caption><thead align="left"><tr id="dns_api_62001__row15361836112436"><th align="left" class="cellrowborder" valign="top" width="24.54%" id="mcps1.3.3.2.1.2.2.5.1.1"><p id="dns_api_62001__p58707511112436"><strong id="dns_api_62001__b1272512714015">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="14.64%" id="mcps1.3.3.2.1.2.2.5.1.2"><p id="dns_api_62001__p791763775720"><strong id="dns_api_62001__b1711073260">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.700000000000001%" id="mcps1.3.3.2.1.2.2.5.1.3"><p id="dns_api_62001__p42210623112436"><strong id="dns_api_62001__b60503934">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="47.12%" id="mcps1.3.3.2.1.2.2.5.1.4"><p id="dns_api_62001__p63617265112436"><strong id="dns_api_62001__b1951915416277">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dns_api_62001__row35684479112436"><td class="cellrowborder" valign="top" width="24.54%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="dns_api_62001__p13313439112530">key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.64%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="dns_api_62001__p89180372570">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.700000000000001%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="dns_api_62001__p35653193112436">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="47.12%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="dns_api_62001__p011410211144">Tag key</p>
|
|
<p id="dns_api_62001__p12621122816413">A key can contain up to 36 Unicode characters. <strong id="dns_api_62001__b55081744194212">key</strong> must be specified. It can contain only digits, letters, hyphens (-), underscores (_), and at signs (@).</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row20048002112436"><td class="cellrowborder" valign="top" width="24.54%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="dns_api_62001__p66095544112533">value</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.64%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="dns_api_62001__p13918103725715">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.700000000000001%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="dns_api_62001__p60123528112436">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="47.12%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="dns_api_62001__p592417401420">Tag value</p>
|
|
<p id="dns_api_62001__p3383124915419">Each value can contain up to 43 Unicode characters and can be an empty string. </p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dns_api_62001__li3969179817718">Example request<div class="p" id="dns_api_62001__p1878054762217"><a name="dns_api_62001__li3969179817718"></a><a name="li3969179817718"></a>Create a public zone named <strong id="dns_api_62001__b14881458569">example.com</strong>.<pre class="codeblock" id="dns_api_62001__codeblock284118443226">POST https://{DNS_Endpoint}/v2/zones</pre>
|
|
</div>
|
|
<div class="p" id="dns_api_62001__p12842144122216"><pre class="screen" id="dns_api_62001__screen20842144172212">{
|
|
"name": "example.com.",
|
|
"description": "This is an example zone.",
|
|
"zone_type": "public",
|
|
"email": "xx@example.org",
|
|
"ttl": 300,
|
|
"tags": [
|
|
{
|
|
"key": "key1",
|
|
"value": "value1"
|
|
}
|
|
]
|
|
}</pre>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dns_api_62001__section2142173017358"><h4 class="sectiontitle">Response</h4><ul id="dns_api_62001__ul24043226171010"><li id="dns_api_62001__li61921720171010">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_62001__table54601120171039" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameters in the response</caption><thead align="left"><tr id="dns_api_62001__row54125868171039"><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_62001__p46128019171039"><strong id="dns_api_62001__b162774213314533_5">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_62001__p61288737171039"><strong id="dns_api_62001__b84235270619112_5">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_62001__p39427830171039"><strong id="dns_api_62001__b842352706112423_5">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dns_api_62001__row3275315171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p13677558171039">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_62001__p31480160171039">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_62001__p55186322171039">Zone ID, which is a UUID used to identify the zone</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row62038903171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p21725743171039">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_62001__p55078653171039">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_62001__p65545475171039">Zone name</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row24663709171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p56112529171039">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_62001__p46656524171039">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_62001__p31778607171039">Zone description</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row34212800171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p51657401171039">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_62001__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_62001__p66322352171039">Email address of the administrator managing the zone</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row45341886171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p22374403171039">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_62001__p16323247171039">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_62001__p58527202171039">Zone type, which can be <strong id="dns_api_62001__b842352706115152">public</strong> or <strong id="dns_api_62001__b842352706115156">private</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row36905265171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p4888971171039">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_62001__p16027579171039">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_62001__p41240291171039">TTL value of the SOA record set in the zone</p>
|
|
<p id="dns_api_62001__p0662131993410">The value ranges from <strong id="dns_api_62001__dns_api_62001_b2613115265713">1</strong> to <strong id="dns_api_62001__dns_api_62001_b662035245714">2147483647</strong>.</p>
|
|
<p id="dns_api_62001__p7662111973418">The default value is <strong id="dns_api_62001__dns_api_62001_b19778105913578">300</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row29641334171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p63311148171039">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_62001__p26678057171039">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_62001__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_62001__p7524749171039">This parameter is not used currently.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row44990376171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p30244483171039">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_62001__p47406357171039">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_62001__p9822846171039">Resource status</p>
|
|
<p id="dns_api_62001__p1829154618238">For details, see <a href="dns_api_80005.html#dns_api_80005__section33673592114748">Resource Status</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row1454557171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p51202644171039">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_62001__p32016130171039">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_62001__p53878535171039">Number of record sets in the zone</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row48476716171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p54136527171039">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_62001__p48020249171039">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_62001__p63987755171039">Pool ID of the zone, which is assigned by the system</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row49967872171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p35791512171039">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_62001__p10454086171039">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_62001__p8704812171039">Project ID of the zone</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row27690345171039"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p48529730171039">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_62001__p59988242171039">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_62001__p9292793171039">Time when the zone was created</p>
|
|
<p id="dns_api_62001__p1283123217317">The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row4377608115654"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p5844041115654">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_62001__p3605288915654">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_62001__p3460290715654">Time when the zone was updated</p>
|
|
<p id="dns_api_62001__p583516468316">The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row384676871572"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__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_62001__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_62001__p660161572">Link to the current resource or other related resources. When a response is broken into pages, a <strong id="dns_api_62001__b84235270695245">next</strong> link is provided to retrieve all results.</p>
|
|
<p id="dns_api_62001__p134911211113714">For details, see <a href="#dns_api_62001__table0172144213344">Table 4</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row177328815945"><td class="cellrowborder" valign="top" width="17.990000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_62001__p1595959815945">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_62001__p1765902715945">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_62001__p2109506015945">Master DNS servers, from which the slave servers get DNS information</p>
|
|
<p id="dns_api_62001__p05918233215">This parameter is not used currently.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="dns_api_62001__table0172144213344"></a><a name="table0172144213344"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_62001__table0172144213344" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Description of the <strong id="dns_api_62001__b15568103614438">links</strong> field</caption><thead align="left"><tr id="dns_api_62001__row917304253418"><th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="dns_api_62001__p101731742153416"><strong id="dns_api_62001__b1515083904317">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.25%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="dns_api_62001__p0174542163418"><strong id="dns_api_62001__b1868366929">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="62.74999999999999%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="dns_api_62001__p7174194243414"><strong id="dns_api_62001__b998441194319">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dns_api_62001__row1390694871216"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="dns_api_62001__p8907184881217">self</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="dns_api_62001__p9907184891219">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.74999999999999%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="dns_api_62001__p1890754813127">Link to the current resource</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dns_api_62001__row19871743164619"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="dns_api_62001__p136561245153620">next</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="dns_api_62001__p19656144517367">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.74999999999999%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="dns_api_62001__p76567451365">Link to the next page</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dns_api_62001__li7863653171013">Example response<pre class="screen" id="dns_api_62001__screen6413204020223">{
|
|
"id": "2c9eb155587194ec01587224c9f90149",
|
|
"name": "example.com.",
|
|
"description": "This is an example zone.",
|
|
"email": "xx@example.com",
|
|
"ttl": 300,
|
|
"serial": 1,
|
|
"masters": [],
|
|
"status": "PENDING_CREATE",
|
|
"links": {
|
|
"self": "https://<em id="dns_api_62001__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": null,
|
|
"record_num": 0
|
|
}
|
|
</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dns_api_62001__section9249181042119"><h4 class="sectiontitle">Returned Value</h4><p id="dns_api_62001__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_62001__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>
|
|
|