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",
          "value": "192.0.2.1"
        },
        {
          "value": "192.0.2.2"
        }
      ],
      "ttl": 60
    },
    {
      "dns_type": "AAAA",
      "rdata": [
        {
          "label": "optional-label-2",
          "value": "2001:db8::1"
        }
      ],
      "ttl": 60
    }
  ]
}

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`
`CDNSKEY`
`CDS`
`CERT`
`CSYNC`
`DHCID`
`DNAME`
`DNSKEY`
`DNSSEC`
`DS`
`IPSECKEY`
`KX`
`LOC`
`NAPTR`
`PTR`
`RP`
`SSHFP`
`TLSA`
`_URL`

rdata array[object]

List of Rdata for this RRset

label object

Label for an Rdata that uniquely identifies it within its RRSet

Example: a-label-123

* value string

Rdata value

Example: 192.0.2.1

ttl integer

Example: 60

Minimum: 0

Response

201 400 401 402 403 404 409