2
0
mirror of https://github.com/VinylDNS/vinyldns synced 2025-09-05 08:45:11 +00:00
Files
vinyldns/api/create-batchchange.html
2019-02-25 11:38:49 -05:00

296 lines
32 KiB
HTML

<html><head><title>VinylDNS: Create Batch Change</title><meta charset="utf-8" /><meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" /><meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="VinylDNS" /><meta name="description" content="DNS Management Platform" /><meta name="og:image" content="/img/poster.png" /><meta name="og:title" content="VinylDNS: Create Batch Change" /><meta name="og:site_name" content="VinylDNS" /><meta name="og:url" content="http://vinyldns.io" /><meta name="og:type" content="website" /><meta name="og:description" content="DNS Management Platform" /><link rel="icon" type="image/png" href="/img/favicon.png" /><meta name="twitter:title" content="VinylDNS: Create Batch Change" /><meta name="twitter:image" content="http://vinyldns.ioimg/poster.png" /><meta name="twitter:description" content="DNS Management Platform" /><meta name="twitter:card" content="summary_large_image" /><link rel="icon" type="image/png" sizes="16x16" href="/img/favicon16x16.png" /><link rel="icon" type="image/png" sizes="24x24" href="/img/favicon24x24.png" /><link rel="icon" type="image/png" sizes="32x32" href="/img/favicon32x32.png" /><link rel="icon" type="image/png" sizes="48x48" href="/img/favicon48x48.png" /><link rel="icon" type="image/png" sizes="57x57" href="/img/favicon57x57.png" /><link rel="icon" type="image/png" sizes="60x60" href="/img/favicon60x60.png" /><link rel="icon" type="image/png" sizes="64x64" href="/img/favicon64x64.png" /><link rel="icon" type="image/png" sizes="70x70" href="/img/favicon70x70.png" /><link rel="icon" type="image/png" sizes="72x72" href="/img/favicon72x72.png" /><link rel="icon" type="image/png" sizes="76x76" href="/img/favicon76x76.png" /><link rel="icon" type="image/png" sizes="96x96" href="/img/favicon96x96.png" /><link rel="icon" type="image/png" sizes="114x114" href="/img/favicon114x114.png" /><link rel="icon" type="image/png" sizes="120x120" href="/img/favicon120x120.png" /><link rel="icon" type="image/png" sizes="128x128" href="/img/favicon128x128.png" /><link rel="icon" type="image/png" sizes="144x144" href="/img/favicon144x144.png" /><link rel="icon" type="image/png" sizes="150x150" href="/img/favicon150x150.png" /><link rel="icon" type="image/png" sizes="152x152" href="/img/favicon152x152.png" /><link rel="icon" type="image/png" sizes="196x196" href="/img/favicon196x196.png" /><link rel="icon" type="image/png" sizes="310x310" href="/img/favicon310x310.png" /><link rel="icon" type="image/png" sizes="310x150" href="/img/favicon310x150.png" /><link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" /><link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css" /><link rel="stylesheet" href="/highlight/styles/default.css" /><link rel="stylesheet" href="/css/style.css" /><link rel="stylesheet" href="/css/palette.css" /><link rel="stylesheet" href="/css/codemirror.css" /><link rel="stylesheet" href="/css/custom.css" /></head><body class="docs"><div id="wrapper"><div id="sidebar-wrapper"><ul id="sidebar" class="sidebar-nav"><li class="sidebar-brand"><a href="/" class="brand"><div class="brand-wrapper"><span>VinylDNS</span></div></a></li> <li><a href="/api/index" class="">API documentation</a></li> <li><a href="/api/auth-mechanism.html" class="">Authentication</a></li> <li><a href="/api/zone-model.html" class="">Zone</a> <ul class="sub_section"> <li><a href="/api/zone-model.html" class="">Zone Model</a></li> <li><a href="/api/create-zone.html" class="">Create Zone</a></li> <li><a href="/api/update-zone.html" class="">Update Zone</a></li> <li><a href="/api/delete-zone.html" class="">Delete Zone</a></li> <li><a href="/api/get-zone.html" class="">Get Zone</a></li> <li><a href="/api/list-zones.html" class="">List / Search Zone</a></li> <li><a href="/api/sync-zone.html" class="">Sync Zone</a></li> <li><a href="/api/list-zone-changes.html" class="">List Zone Changes</a></li></ul></li> <li><a href="/api/recordset-model.html" class="">RecordSet</a> <ul class="sub_section"> <li><a href="/api/recordset-model.html" class="">RecordSet Model</a></li> <li><a href="/api/create-recordset.html" class="">Create RecordSet</a></li> <li><a href="/api/update-recordset.html" class="">Update RecordSet</a></li> <li><a href="/api/delete-recordset.html" class="">Delete RecordSet</a></li> <li><a href="/api/get-recordset.html" class="">Get RecordSet</a></li> <li><a href="/api/list-recordsets.html" class="">List / Search RecordSets</a></li> <li><a href="/api/get-recordset-change.html" class="">Get RecordSet Change</a></li> <li><a href="/api/list-recordset-changes.html" class="">List RecordSet Changes</a></li></ul></li> <li><a href="/api/batchchange-model.html" class="">Batch Change</a> <ul class="sub_section"> <li><a href="/api/batchchange-model.html" class="">Batch Change Model</a></li> <li><a href="/api/create-batchchange.html" class=" active ">Create Batch Change</a></li> <li><a href="/api/get-batchchange.html" class="">Get Batch Change</a></li> <li><a href="/api/list-batchchanges.html" class="">List Batch Changes</a></li> <li><a href="/api/batchchange-errors.html" class="">Batch Change Errors</a></li></ul></li> <li><a href="/api/membership-model.html" class="">Membership</a> <ul class="sub_section"> <li><a href="/api/membership-model.html" class="">Membership Model</a></li> <li><a href="/api/create-group.html" class="">Create Group</a></li> <li><a href="/api/update-group.html" class="">Update Group</a></li> <li><a href="/api/delete-group.html" class="">Delete Group</a></li> <li><a href="/api/get-group.html" class="">Get Group</a></li> <li><a href="/api/list-groups.html" class="">List Groups</a></li> <li><a href="/api/list-group-admins.html" class="">List Group Admins</a></li> <li><a href="/api/list-group-members.html" class="">List Group Members</a></li> <li><a href="/api/list-group-activity.html" class="">List Group Activity</a></li></ul></li></ul></div><div id="page-content-wrapper"><div class="nav"><div class="container-fluid"><div class="row"><div class="col-lg-12"><div class="action-menu pull-left clearfix"><a href="#menu-toggle" id="menu-toggle"><i class="fa fa-bars" aria-hidden="true"></i></a></div><ul class="pull-right"><li id="gh-eyes-item" class="hidden-xs"><a href="https://github.com/VinylDNS/vinyldns"><i class="fa fa-eye"></i><span>WATCH<span id="eyes" class="label label-default">--</span></span></a></li><li id="gh-stars-item" class="hidden-xs"><a href="https://github.com/VinylDNS/vinyldns"><i class="fa fa-star-o"></i><span>STARS<span id="stars" class="label label-default">--</span></span></a></li></ul></div></div></div></div><div id="content" data-github-owner="VinylDNS" data-github-repo="vinyldns"><div class="content-wrapper"><section><h1 id="create-batch-change">Create Batch Change</h1>
<p>Creates a batch change with <a href="../api/batchchange-model/#singleaddchange-attributes">SingleAddChanges</a> and/or <a href="../api/batchchange-model/#singledeletechange-attributes">SingleDeleteChanges</a> across different zones. A delete and add of the same record will be treated as an update on that record set. Regardless of the input order in the batch change, all deletes for the same recordset will be logically applied before the adds.</p>
<p>Current supported record types for creating a batch change are: <strong>A</strong>, <strong>AAAA</strong>, <strong>CNAME</strong>, and <strong>PTR</strong>. A batch must contain at least one change and no more than 20 changes.</p>
<h4 id="http-request">HTTP REQUEST</h4>
<blockquote>
<p>POST /zones/batchrecordchanges</p>
</blockquote>
<p>Note that the batch change request inputs are a subset of the full <a href="../api/batchchange-model/#batchchange-attributes">batch change model</a>.</p>
<h4 id="http-request-params">HTTP REQUEST PARAMS</h4>
<table>
<thead>
<tr>
<th>name</th>
<th style="text-align: left">type</th>
<th>required?</th>
<th style="text-align: left">description</th>
</tr>
</thead>
<tbody>
<tr>
<td>comments</td>
<td style="text-align: left">string</td>
<td>no</td>
<td style="text-align: left">Optional comments about the batch change.</td>
</tr>
<tr>
<td>changes</td>
<td style="text-align: left">Array of ChangeInput</td>
<td>yes</td>
<td style="text-align: left">Set of <em>ChangeInput</em>s in the batch change. A <em>ChangeInput</em> is an <a href="#addchangeinput-attributes">AddChangeInput</a> or <a href="#deletechangeinput-attributes">DeleteChangeInput</a>. Type is inferred from specified <em>changeType</em>.</td>
</tr>
</tbody>
</table>
<h5 id="addchangeinput-">AddChangeInput <a id="addchangeinput-attributes"></a></h5>
<table>
<thead>
<tr>
<th>name</th>
<th style="text-align: left">type</th>
<th>required?</th>
<th style="text-align: left">description</th>
</tr>
</thead>
<tbody>
<tr>
<td>changeType</td>
<td style="text-align: left">ChangeInputType</td>
<td>yes</td>
<td style="text-align: left">Type of change input. Must be set to <strong>Add</strong> for <em>AddChangeInput</em>.</td>
</tr>
<tr>
<td>inputName</td>
<td style="text-align: left">string</td>
<td>yes</td>
<td style="text-align: left">The fully qualified domain name of the record being added. For <strong>PTR</strong>, the input name is a valid IPv4 or IPv6 address.</td>
</tr>
<tr>
<td>type</td>
<td style="text-align: left">RecordType</td>
<td>yes</td>
<td style="text-align: left">Type of DNS record. Supported records for batch changes are currently: <strong>A</strong>, <strong>AAAA</strong>, <strong>CNAME</strong>, and <strong>PTR</strong>.</td>
</tr>
<tr>
<td>ttl</td>
<td style="text-align: left">long</td>
<td>yes</td>
<td style="text-align: left">The time-to-live in seconds. The minimum and maximum values are 30 and 2147483647, respectively.</td>
</tr>
<tr>
<td>record</td>
<td style="text-align: left"><a href="../api/recordset-model/#record-data">RecordData</a></td>
<td>yes</td>
<td style="text-align: left">The data for the record.</td>
</tr>
</tbody>
</table>
<h5 id="deletechangeinput-">DeleteChangeInput <a id="deletechangeinput-attributes"></a></h5>
<table>
<thead>
<tr>
<th>name</th>
<th style="text-align: left">type</th>
<th>required?</th>
<th style="text-align: left">description</th>
</tr>
</thead>
<tbody>
<tr>
<td>changeType</td>
<td style="text-align: left">ChangeInputType</td>
<td>yes</td>
<td style="text-align: left">Type of change input. Must be <strong>DeleteRecordSet</strong> for <em>DeleteChangeInput</em>.</td>
</tr>
<tr>
<td>inputName</td>
<td style="text-align: left">string</td>
<td>yes</td>
<td style="text-align: left">The fully qualified domain name of the record being deleted.</td>
</tr>
<tr>
<td>type</td>
<td style="text-align: left">RecordType</td>
<td>yes</td>
<td style="text-align: left">Type of DNS record. Supported records for batch changes are currently: <strong>A</strong>, <strong>AAAA</strong>, <strong>CNAME</strong>, and <strong>PTR</strong>.</td>
</tr>
</tbody>
</table>
<h4 id="example-http-request">EXAMPLE HTTP REQUEST</h4>
<div class="highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="nt">"comments"</span><span class="p">:</span><span class="w"> </span><span class="s2">"this is optional"</span><span class="p">,</span><span class="w">
</span><span class="nt">"changes"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Add"</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A"</span><span class="p">,</span><span class="w">
</span><span class="nt">"ttl"</span><span class="p">:</span><span class="w"> </span><span class="mi">3600</span><span class="p">,</span><span class="w">
</span><span class="nt">"record"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1.1.1.1"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.195"</span><span class="p">,</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Add"</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"PTR"</span><span class="p">,</span><span class="w">
</span><span class="nt">"ttl"</span><span class="p">:</span><span class="w"> </span><span class="mi">3600</span><span class="p">,</span><span class="w">
</span><span class="nt">"record"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="nt">"ptrdname"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ptrdata.data."</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"cname.example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"DeleteRecordSet"</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"CNAME"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"update.another.example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"DeleteRecordSet"</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"AAAA"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"update.another.example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Add"</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"AAAA"</span><span class="p">,</span><span class="w">
</span><span class="nt">"ttl"</span><span class="p">:</span><span class="w"> </span><span class="mi">4000</span><span class="p">,</span><span class="w">
</span><span class="nt">"record"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1:2:3:4:5:6:7:8"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre>
</div>
<p>The first two items in the changes list are SingleAddChanges of an <strong>A</strong> record and a <strong>PTR</strong> record. Note that for the <strong>PTR</strong> record, the <em>inputName</em> is a valid IP address. The third item is a delete of a <strong>CNAME</strong> record. The last two items represent an update (delete &amp; add) of an <strong>AAAA</strong> record with the fully qualified domain name “update.another.example.com.”.</p>
<h4 id="http-response-types">HTTP RESPONSE TYPES</h4>
<table>
<thead>
<tr>
<th>Code</th>
<th style="text-align: left">description</th>
</tr>
</thead>
<tbody>
<tr>
<td>202</td>
<td style="text-align: left"><strong>Accepted</strong> - The batch change is queued and is returned in the response body.</td>
</tr>
<tr>
<td>400</td>
<td style="text-align: left"><strong>Bad Request</strong> - Error in the batch change. See <a href="../api/batchchange-errors">Batch Change Errors</a> page.</td>
</tr>
<tr>
<td>403</td>
<td style="text-align: left"><strong>Forbidden</strong> - The user does not have the access required to perform the action.</td>
</tr>
<tr>
<td>413</td>
<td style="text-align: left"><strong>Request Entity Too Large</strong> - Cannot request more than 20 changes in a single batch change request.</td>
</tr>
<tr>
<td>422</td>
<td style="text-align: left"><strong>Unprocessable Entity</strong> - the batch does not contain any changes, thus cannot be processed.</td>
</tr>
</tbody>
</table>
<p>A batch change goes through numerous validations before it is processed. This results in corresponding BadRequest or error responses. View the full list of batch change errors <a href="../api/batchchange-errors">here</a>.</p>
<h4 id="http-response-attributes">HTTP RESPONSE ATTRIBUTES</h4>
<p>On success, the response from create batch change includes the fields the user input, as well as some additional information provided by the system. This response is the same as that of <a href="../api/get-batchchange/#http-response-attributes">get batch change</a>.</p>
<h4 id="example-response">EXAMPLE RESPONSE</h4>
<div class="highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="nt">"userId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"vinyl"</span><span class="p">,</span><span class="w">
</span><span class="nt">"userName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"vinyl201"</span><span class="p">,</span><span class="w">
</span><span class="nt">"comments"</span><span class="p">:</span><span class="w"> </span><span class="s2">"this is optional"</span><span class="p">,</span><span class="w">
</span><span class="nt">"createdTimestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2018-05-09T14:19:34Z"</span><span class="p">,</span><span class="w">
</span><span class="nt">"changes"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Add"</span><span class="p">,</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A"</span><span class="p">,</span><span class="w">
</span><span class="nt">"ttl"</span><span class="p">:</span><span class="w"> </span><span class="mi">3600</span><span class="p">,</span><span class="w">
</span><span class="nt">"record"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1.1.1.1"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Pending"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"74e93bfc-7296-4b86-83d3-1ffcb0eb3d13"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordChangeId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"255063ce-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordSetId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25506676-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"7573ca11-3e30-45a8-9ba5-791f7d6ae7a7"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Add"</span><span class="p">,</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.195"</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"PTR"</span><span class="p">,</span><span class="w">
</span><span class="nt">"ttl"</span><span class="p">:</span><span class="w"> </span><span class="mi">3600</span><span class="p">,</span><span class="w">
</span><span class="nt">"record"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="nt">"ptrdname"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ptrdata.data."</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Pending"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"195"</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2.0.192.in-addr.arpa."</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"7fd52634-5a0c-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordChangeId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25506a9a-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordSetId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25506c84-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bece5338-5a0c-11e8-9c2d-fa7ae01bbebc"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"DeleteRecordSet"</span><span class="p">,</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"cname.example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"CNAME"</span><span class="p">,</span><span class="w">
</span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Pending"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"cname"</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"74e93bfc-7296-4b86-83d3-1ffcb0eb3d13"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordChangeId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25506ee6-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordSetId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25506676-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"02048500-5a0d-11e8-a10f-fa7ae01bbebc"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"DeleteRecordSet"</span><span class="p">,</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"update.example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"AAAA"</span><span class="p">,</span><span class="w">
</span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Pending"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"update"</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"74e93bfc-7296-4b86-83d3-1ffcb0eb3d13"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordChangeId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25507238-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordSetId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25506676-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1cee1c78-5a0d-11e8-9c2d-fa7ae01bbebc"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"changeType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Add"</span><span class="p">,</span><span class="w">
</span><span class="nt">"inputName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"update.another.example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"AAAA"</span><span class="p">,</span><span class="w">
</span><span class="nt">"ttl"</span><span class="p">:</span><span class="w"> </span><span class="mi">3600</span><span class="p">,</span><span class="w">
</span><span class="nt">"record"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1:2:3:4:5:6:7:8"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Pending"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"update"</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"another.example.com."</span><span class="p">,</span><span class="w">
</span><span class="nt">"zoneId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"7fd52634-5a0c-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordChangeId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25507490-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"recordSetId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"25506842-5f82-11e8-9c2d-fa7ae01bbebc"</span><span class="p">,</span><span class="w">
</span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"43dd1226-5a0d-11e8-9c2d-fa7ae01bbebc"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">],</span><span class="w">
</span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Pending"</span><span class="p">,</span><span class="w">
</span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"02bd95f4-a32c-443b-82eb-54dbaa55b31a"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre>
</div>
</section><div class="edit-button"><a href="https://github.com/VinylDNS/vinyldns/edit/master/modules/docs/src/main/tut/api/create-batchchange.md" class="btn-sm btn-info">Improve this page</a></div></div></div></div></div><script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js"></script><script src="/highlight/highlight.pack.js"></script><script>hljs.configure({languages:['scala','java','bash']});
hljs.initHighlighting();
</script><script>((window.gitter = {}).chat = {}).options = {
room: 'vinyldns/Lobby'};</script><script src="https://sidecar.gitter.im/dist/sidecar.v1.js"></script><script src="/js/main.js"></script></body></html>