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 undefined
* name string
The DNS name, not including the zone portion.
Example: "dns-name"
rrsets array[object]
[RRSet to create.]
Example: [{"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}]
metadata undefined
* 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
Example: [{"label":"optional-label-1","update_group":"grp1","value":"192.0.2.1"},{"value":"192.0.2.1"}]
label undefined
update_group undefined
* value string
Rdata value
Example: "192.0.2.1"
ttl integer,null
Example: 60
Minimum: 0
update_group string
Name of the update group
Example: "grp_1-2"