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>
390 lines
29 KiB
HTML
390 lines
29 KiB
HTML
<a name="dns_api_64006"></a><a name="dns_api_64006"></a>
|
||
|
||
<h1 class="topictitle1">Modifying a Record Set</h1>
|
||
<div id="body1505823352345"><div class="section" id="dns_api_64006__section49332166"><h4 class="sectiontitle">Function</h4><p id="dns_api_64006__p36031167">Modify a record set.</p>
|
||
</div>
|
||
<div class="section" id="dns_api_64006__section41336317"><h4 class="sectiontitle">URI</h4><p id="dns_api_64006__p2028928120727">PUT /v2/zones/{zone_id}/recordsets/{recordset_id}</p>
|
||
<div class="p" id="dns_api_64006__p1067012183142">For details, see <a href="#dns_api_64006__table52104579">Table 1</a>.
|
||
<div class="tablenoborder"><a name="dns_api_64006__table52104579"></a><a name="table52104579"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_64006__table52104579" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters in the URI</caption><thead align="left"><tr id="dns_api_64006__row50570707"><th align="left" class="cellrowborder" valign="top" width="22.240000000000002%" id="mcps1.3.2.3.2.2.5.1.1"><p id="dns_api_64006__p2586631"><strong id="dns_api_64006__b162774213314533">Parameter</strong></p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="16.840000000000003%" id="mcps1.3.2.3.2.2.5.1.2"><p id="dns_api_64006__p8190559"><strong id="dns_api_64006__b593421527191713">Mandatory</strong></p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="21.48%" id="mcps1.3.2.3.2.2.5.1.3"><p id="dns_api_64006__p21461417487"><strong id="dns_api_64006__b84235270619112">Type</strong></p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="39.440000000000005%" id="mcps1.3.2.3.2.2.5.1.4"><p id="dns_api_64006__p59455556"><strong id="dns_api_64006__b842352706112423">Description</strong></p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="dns_api_64006__row51170717"><td class="cellrowborder" valign="top" width="22.240000000000002%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_64006__p51187411">zone_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="16.840000000000003%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_64006__p52539597">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="21.48%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_64006__p714101419486">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="39.440000000000005%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_64006__p27848947">Zone ID</p>
|
||
<p id="dns_api_64006__p2171125516411">Obtain the public zone ID according to <a href="dns_api_62003.html">Querying Public Zones</a>.</p>
|
||
<p id="dns_api_64006__p22777371252">Obtain the private zone ID according to <a href="dns_api_63006.html">Querying Private Zones</a>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__row49313939"><td class="cellrowborder" valign="top" width="22.240000000000002%" headers="mcps1.3.2.3.2.2.5.1.1 "><p id="dns_api_64006__p35006119">recordset_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="16.840000000000003%" headers="mcps1.3.2.3.2.2.5.1.2 "><p id="dns_api_64006__p16923420">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="21.48%" headers="mcps1.3.2.3.2.2.5.1.3 "><p id="dns_api_64006__p414121454818">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="39.440000000000005%" headers="mcps1.3.2.3.2.2.5.1.4 "><p id="dns_api_64006__p28619802">ID of the record set to be modified</p>
|
||
<p id="dns_api_64006__p12406443193011">You can obtain the value by calling the API in <a href="dns_api_64004.html">Querying Record Sets in a Zone</a>.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="section" id="dns_api_64006__section36482533"><h4 class="sectiontitle">Request</h4><ul id="dns_api_64006__ul18370535173152"><li id="dns_api_64006__li51947106173152">Parameter description
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_64006__table9470531173211" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the request</caption><thead align="left"><tr id="dns_api_64006__row60397351173211"><th align="left" class="cellrowborder" valign="top" width="22.45%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="dns_api_64006__p65819295173211"><strong id="dns_api_64006__b1068262314">Parameter</strong></p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="21.29%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="dns_api_64006__p42278174173211"><strong id="dns_api_64006__b1999455490">Mandatory</strong></p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="15.45%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="dns_api_64006__p26309572173211"><strong id="dns_api_64006__b7063090">Type</strong></p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="40.81%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="dns_api_64006__p67071922173211"><strong id="dns_api_64006__b1118018191">Description</strong></p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="dns_api_64006__row2428104916113"><td class="cellrowborder" valign="top" width="22.45%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_64006__p21415905173211">name</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="21.29%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_64006__p58188388173211">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="15.45%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_64006__p45293229173211">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40.81%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_64006__p5054941173211">Fully qualified domain name (FQDN) suffixed with a zone name, which is a complete host name ended with a dot</p>
|
||
<p id="dns_api_64006__p4141499817341">If it is a record set in a public zone, you can add five labels at most.</p>
|
||
<p id="dns_api_64006__p27471407151355">A domain name is case insensitive. Uppercase letters will also be converted into lowercase letters.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__row34337486173211"><td class="cellrowborder" valign="top" width="22.45%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_64006__p33154613173211">description</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="21.29%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_64006__p28540882173211">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="15.45%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_64006__p37402311173211">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40.81%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_64006__p43441715173211">(Optional) Description of the domain name</p>
|
||
<p id="dns_api_64006__p9966775173211">The value cannot exceed 255 characters.</p>
|
||
<p id="dns_api_64006__p513811402423">If this parameter is left blank, the value will not be changed.</p>
|
||
<p id="dns_api_64006__p86941318184212">The value is left blank by default.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__row1640071516215"><td class="cellrowborder" valign="top" width="22.45%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_64006__p4265712173211">type</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="21.29%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_64006__p43588224173211">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="15.45%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_64006__p44233480173211">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40.81%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_64006__p29114279173211">Record set type</p>
|
||
<p id="dns_api_64006__p160041663916">The value can be <strong id="dns_api_64006__dns_api_64001_b84235270693731">A</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693735">AAAA</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693738">MX</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693741">CNAME</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693746">TXT</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693755">NS</strong> (only in public zones), <strong id="dns_api_64006__dns_api_64001_b8423527069382">SRV</strong>, <strong id="dns_api_64006__dns_api_64001_b44467248426">CAA</strong> (only in public zones), and <strong id="dns_api_64006__dns_api_64001_b8423527069385">PTR</strong> (only in private zones).</p>
|
||
<p id="dns_api_64006__p1656255110557">For details, see <a href="dns_api_80005.html#dns_api_80005__section1188113824413">Record Set Type</a>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__row44235645173211"><td class="cellrowborder" valign="top" width="22.45%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_64006__p56753577173211">ttl</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="21.29%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_64006__p44923213173211">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="15.45%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_64006__p45055368173211">Integer</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40.81%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_64006__p123031523174010">Record set 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_64006__p1030317233408">If your service address is frequently changed, set TTL to a smaller value.</p>
|
||
<p id="dns_api_64006__p20437753173211">Value range: </p>
|
||
<ul id="dns_api_64006__ul12272931135310"><li id="dns_api_64006__li1127393145317">Public zone: <strong id="dns_api_64006__b6113401145">1</strong>–<strong id="dns_api_64006__b215403143">2147483647</strong></li><li id="dns_api_64006__li1925240145319">Private zone: <strong id="dns_api_64006__b11421114115144">1</strong>–<strong id="dns_api_64006__b1422124111148">2147483647</strong></li></ul>
|
||
<p id="dns_api_64006__p16253220614">If this parameter is left blank, the value will not be changed.</p>
|
||
<p id="dns_api_64006__p8877142595919">The value is left blank by default.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__row59750658173211"><td class="cellrowborder" valign="top" width="22.45%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="dns_api_64006__p62596825173211">records</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="21.29%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="dns_api_64006__p32296167173211">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="15.45%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="dns_api_64006__p5792332173211">Array of strings</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="40.81%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="dns_api_64006__p8321575173211">Value of the record set. The value format varies depending on record set types.</p>
|
||
<p id="dns_api_64006__p813988173211">For example, the value of an AAAA record set is the IPv6 address list mapped to the domain name.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li><li id="dns_api_64006__li60905904173155">Example request<p id="dns_api_64006__p14300440115411"><a name="dns_api_64006__li60905904173155"></a><a name="li60905904173155"></a>Modify the record set whose ID is 2c9eb155587228570158722b6ac30007 in the zone whose ID is 2c9eb155587194ec01587224c9f90149:</p>
|
||
<pre class="codeblock" id="dns_api_64006__codeblock3951205755514">PUT https://{DNS_Endpoint}/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007</pre>
|
||
<ul id="dns_api_64006__ul1997715376719"><li id="dns_api_64006__li659072810719">A type<pre class="screen" id="dns_api_64006__screen1973261915450">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "A",
|
||
"ttl": 3600,
|
||
"records": [
|
||
"192.168.10.1",
|
||
"192.168.10.2"
|
||
]
|
||
}</pre>
|
||
</li><li id="dns_api_64006__li17483441876">AAAA type<pre class="screen" id="dns_api_64006__screen873331934516">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "AAAA",
|
||
"ttl": 3600,
|
||
"records": [
|
||
"fe80:0:0:0:202:b3ff:fe1e:8329",
|
||
"ff03:0db8:85a3:0:0:8a2e:0370:7334"
|
||
]
|
||
}</pre>
|
||
</li><li id="dns_api_64006__li149105481671">MX type<pre class="screen" id="dns_api_64006__screen5134104410715">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "MX",
|
||
"ttl": 3600,
|
||
"records": [
|
||
"1 mail.example.com"
|
||
]
|
||
}</pre>
|
||
</li><li id="dns_api_64006__li1090120523718">CNAME type<pre class="screen" id="dns_api_64006__screen2099594813710">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "CNAME",
|
||
"ttl": 3600,
|
||
"records": [
|
||
"server1.example.com"
|
||
]
|
||
}</pre>
|
||
</li><li id="dns_api_64006__li6454156874">TXT type<pre class="screen" id="dns_api_64006__screen11960115220716">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "TXT",
|
||
"ttl": 300,
|
||
"records": [
|
||
"\"This host is used for sale.\""
|
||
]
|
||
}</pre>
|
||
</li><li id="dns_api_64006__li185431501384">NS type<pre class="screen" id="dns_api_64006__screen10494756371">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "NS",
|
||
"ttl": 300,
|
||
"records": [
|
||
"node1.example.com.",
|
||
"node2.example.com."
|
||
]
|
||
}</pre>
|
||
</li><li id="dns_api_64006__li1710941887">SRV type<pre class="screen" id="dns_api_64006__screen15821601382">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "SRV",
|
||
"ttl": 3600,
|
||
"records": [
|
||
"3 60 2176 sipserver.example.com.",
|
||
"10 100 2176 sipserver.example.com."
|
||
]
|
||
}</pre>
|
||
</li><li id="dns_api_64006__li162821813819">PTR type<pre class="screen" id="dns_api_64006__screen173194887">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "PTR",
|
||
"ttl": 3600,
|
||
"records": [
|
||
"host.example.com."
|
||
|
||
]
|
||
}
|
||
</pre>
|
||
</li><li id="dns_api_64006__li72678121487">CAA type<pre class="screen" id="dns_api_64006__screen1929678185">{
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "CAA",
|
||
"ttl": 300,
|
||
"records": [
|
||
"0 issue \"example.com\"",
|
||
"0 issuewild \"www.certinomis.com\"",
|
||
"0 iodef \"mailto:xx@example.org\"",
|
||
"0 iodef \"http://iodef.example.com\""
|
||
]
|
||
}</pre>
|
||
</li></ul>
|
||
</li></ul>
|
||
</div>
|
||
<div class="section" id="dns_api_64006__section40090803161031"><h4 class="sectiontitle">Response</h4><ul id="dns_api_64006__ul56136690175237"><li id="dns_api_64006__li4367003175237">Parameter description
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dns_api_64006__table44131970191032" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameters in the response</caption><thead align="left"><tr id="dns_api_64006__rf63e3f73474e4c278a069c18f2cbda2e"><th align="left" class="cellrowborder" valign="top" width="27.889999999999997%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="dns_api_64006__a6ef51227cb264b32bebfc986d3e637d9"><strong id="dns_api_64006__b33951333699">Parameter</strong></p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="23.810000000000002%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="dns_api_64006__ae4f0a65aa76a4fb1957074bb69d5dbdd"><strong id="dns_api_64006__b18403834799">Type</strong></p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="48.3%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="dns_api_64006__a47bf2f8c9f504cc9bee2e5ec1257eb3f"><strong id="dns_api_64006__b1633663518918">Description</strong></p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="dns_api_64006__rc4ac2a5267624f239ad9b1cd01768435"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__aed4e16cb934a49af80a35a677f91d92e">id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a5fe96ba32d0f47149f32f3ea7d4f05e6">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__a0b0a5c0cd1f24b55a29ecdb6066b3705">Record set ID</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__ra9e885d12b4d43428831752336a0d4c0"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__a32fb714b039b4a978222179f61a0f076">name</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a83b8bc6a22eb48f087f3b842f1a177be">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__a3a0582b25e7f4c9c9028a0a082553e63">Record set name</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r8a5cb7251c6e4ad2aac8e92c1fc1c825"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__a2ba0b3a7490e4f8c9f2d001abc31b5fc">description</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a590b27e6f7304033beb416c2615febf4">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__a6566187b31744bdfbfd273d05ada45cc">Record set description</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r6ff9dc233cc64b6eb856a2f2d4ecdfea"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__adb2e4a3dc5264bd194c9fdbb52d738f0">zone_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a9a32df9951ea4e63a36979ffe7839125">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__a69a040838e314d9992462ec5cb23db6f">Zone ID of the record set</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r82492d1a4b134373ba3e3fb657f19346"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__ade468dd7e4d24dc2bc83795202c2e618">zone_name</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__ae9bad680780945638499d66748a089ee">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__af6bb9568887946fd83f837a9f67c9d35">Zone name of the record set</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r58a2d0249a9d46608dceb58752487962"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__a6812a6c96d0b4f08ad96cd4aa92c29ef">type</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a0cacd81f8e7247ed9b3e4b4a0d5a1c1a">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__a3db4aa6f5f604faeb111cc5b98a05bf9">Record set type</p>
|
||
<p id="dns_api_64006__p941142431517">The value can be <strong id="dns_api_64006__dns_api_64001_b84235270693731_1">A</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693735_1">AAAA</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693738_1">MX</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693741_1">CNAME</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693746_1">TXT</strong>, <strong id="dns_api_64006__dns_api_64001_b84235270693755_1">NS</strong> (only in public zones), <strong id="dns_api_64006__dns_api_64001_b8423527069382_1">SRV</strong>, <strong id="dns_api_64006__dns_api_64001_b44467248426_1">CAA</strong> (only in public zones), and <strong id="dns_api_64006__dns_api_64001_b8423527069385_1">PTR</strong> (only in private zones).</p>
|
||
<p id="dns_api_64006__en-us_topic_0037134404_p15442435577">For details, see <a href="dns_api_80005.html#dns_api_80005__section1188113824413">Record Set Type</a>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r06be1132e6b544eaac47c6b6cae4af1d"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__abe5c52a6e2154f6391976aa80857198f">ttl</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a57fe1965995b4f99a67c1c84d927f3b6">Integer</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__p7539104316419">Record set 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_64006__p11539174314415">If your service address is frequently changed, set TTL to a smaller value.</p>
|
||
<p id="dns_api_64006__p1042612588514">Value range: </p>
|
||
<ul id="dns_api_64006__ul1526514741611"><li id="dns_api_64006__dns_api_64001_li1127393145317">Public zone: <strong id="dns_api_64006__dns_api_64001_b148234231295">1</strong>–<strong id="dns_api_64006__dns_api_64001_b13824323152912">2147483647</strong></li><li id="dns_api_64006__dns_api_64001_li1925240145319">Private zone: <strong id="dns_api_64006__dns_api_64001_b6567113632918">1</strong>–<strong id="dns_api_64006__dns_api_64001_b9567173652918">2147483647</strong></li></ul>
|
||
<p id="dns_api_64006__p10651531171611">The default value is <strong id="dns_api_64006__dns_api_64001_b103151601234">300</strong>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r8cb1518cb4b84bf0b8115a7f4a8835c4"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__ae57bbd14742845c2aced32f030bc6a80">records</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a5a480487a4fc42fa987d5ba2c6d920b9">Array of strings</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__a7ff6973b19f84ee5aa83b0967e0c2434">Record set value</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r93b32291d1e64da39452a8997fcda248"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__a9bc903f33fd54c9aa3b1f9d07ed6a31a">create_at</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a55f1491f864c456eae0b254526eaf1f8">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__ab802d00a14d74a5abe323755a0c1a9c3">Time when the record set was created</p>
|
||
<p id="dns_api_64006__en-us_topic_0037134404_p91253279589">The value format is yyyy-MM-dd'T'HH:mm:ss.SSS.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__rececad4599034fec9010552d92c3b3d1"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__ae3d53158cf0e4b0c81f9aeafbbf377a2">update_at</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a1b01ca3627dc49c986c67d231de5c85f">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__acbcc47bca305436b8fb99d10b0de8765">Time when the record set was updated</p>
|
||
<p id="dns_api_64006__ab3462c7056cd417e81ff267a3ea46443">The value format is yyyy-MM-dd'T'HH:mm:ss.SSS.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r18fd03e795cb427a953b0efb798cdc64"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__afe9aea31aae443be91d0a1ea8db8806d">status</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a7f0d877c3b134d3bbaaa813571ef16fb">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__a9a68c20d53b843ed98875ccfce9781f4">Resource status</p>
|
||
<p id="dns_api_64006__a6083e4f4301a476da8c39b9587e46bb9">For details, see <a href="dns_api_80005.html#dns_api_80005__section33673592114748">Resource Status</a>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__rf566452075b04b41ac618d76387832ab"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__aad28018162974cd3ab00f6e7b50a0d40">default</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a4d66625c999244ffa5a6dcfa967cc6d2">Boolean</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__aa87419f5ec904492968127f0424e88dd">Whether the record set is created by default. A default record set cannot be deleted.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r327b7fd09445440cb72ab3cd7fd54f76"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__a4b770fd18dd948aea76499724a625eca">project_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__a319fefa4c28b48ee9c5918b78a8746d8">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__p4619625201026">Project ID of the record set</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__r63b97c55056a4b32a3895d2af40c74a0"><td class="cellrowborder" valign="top" width="27.889999999999997%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="dns_api_64006__a94878242f50449aaae37b65105b3d867">links</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="23.810000000000002%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="dns_api_64006__af62c9f365b1f4d9b8743da27e6085818">Object</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="48.3%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="dns_api_64006__ad757db1edea54d3cacac51db1def8abf">Link to the current resource or other related resources. When a response is broken into pages, a <strong id="dns_api_64006__b9935352162812">next</strong> link is provided to retrieve all results.</p>
|
||
<p id="dns_api_64006__p1230417511478">For details, see <a href="#dns_api_64006__table354521744216">Table 4</a>.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<div class="tablenoborder"><a name="dns_api_64006__table354521744216"></a><a name="table354521744216"></a><table cellpadding="4" cellspacing="0" summary="" id="dns_api_64006__table354521744216" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Parameters in the <strong id="dns_api_64006__b11202707299">links</strong> field</caption><thead align="left"><tr id="dns_api_64006__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_64006__p654513173424"><strong id="dns_api_64006__b1447711152910">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_64006__p654551714212"><strong id="dns_api_64006__b341152122918">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_64006__p1545141717427"><strong id="dns_api_64006__b131943362911">Description</strong></p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="dns_api_64006__row3545101710429"><td class="cellrowborder" valign="top" width="18.3018301830183%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="dns_api_64006__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_64006__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_64006__p5546171744214">Link to the current resource</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="dns_api_64006__row125151707508"><td class="cellrowborder" valign="top" width="18.3018301830183%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="dns_api_64006__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_64006__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_64006__p76567451365">Link to the next page</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li><li id="dns_api_64006__li19426394175241">Example response<pre class="screen" id="dns_api_64006__screen1086592620914">{
|
||
"id": "2c9eb155587228570158722b6ac30007",
|
||
"name": "www.example.com.",
|
||
"description": "This is an example record set.",
|
||
"type": "A",
|
||
"ttl": 3600,
|
||
"records": [
|
||
"192.168.10.1",
|
||
"192.168.10.2"
|
||
],
|
||
"status": "PENDING_UPDATE",
|
||
"links": {
|
||
"self": "https://<em id="dns_api_64006__i46588245141657">Endpoint</em>/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
|
||
},
|
||
"zone_id": "2c9eb155587194ec01587224c9f90149",
|
||
"zone_name": "example.com.",
|
||
"create_at": "2016-11-17T12:03:17.827",
|
||
"update_at": "2016-11-17T12:56:03.827",
|
||
"default": false,
|
||
"project_id": "e55c6f3dc4e34c9f86353b664ae0e70c"
|
||
}</pre>
|
||
</li></ul>
|
||
</div>
|
||
<div class="section" id="dns_api_64006__section9249181042119"><h4 class="sectiontitle">Returned Value</h4><p id="dns_api_64006__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_64006__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_64000.html">Record Set Management</a></div>
|
||
</div>
|
||
</div>
|
||
|