Create a new name
POST /v1/dns/records/{zone_name}
Create a new name, with records and metadata.
Path Parameters
zone_name
The name of the zone.
Example: example.com
Body
application/json
Body Sample
{ "metadata": { "public property": "public value" }, "name": "dns-name", "rrsets": [ { "dns_type": "A", "metadata": { "key": "value" }, "rdata": [ { "label": "optional-label-1", "update_group": "grp1", "value": "192.0.2.1" }, { "value": "192.0.2.2" } ], "ttl": 60 }, { "dns_type": "AAAA", "rdata": [ { "label": "optional-label-2", "update_group": "grp2", "value": "2001:db8::1" } ], "ttl": 60 } ], "update_group": "grp_1-2"}
Body Description
metadata object
A collection of string key/value pairs that provide additional information or classification for an object.
* name string
The DNS name, not including the zone portion.
Example: dns-name
rrsets array[object]
[RRSet to create.]
* dns_type string
enum
DNS name type supported by API
Example: A
Possible Values |
---|
A |
AAAA |
CAA |
CNAME |
MX |
NS |
SRV |
TXT |
PTR |
_URL |
rdata array[object]
List of Rdata for this RRset
label string
Label for an Rdata that uniquely identifies it within its RRSet
Example: a-label-123
update_group string
Name of the update group
Example: grp_1-2
* value string
Rdata value
Example: 192.0.2.1
ttl integer
Example: 60
Minimum: 0
update_group string
Name of the update group
Example: grp_1-2