Create RRSets

POST /v1/dns/records/{zone_name}/{name}/rrsets

Create RRSets for a name, along with records, rrset options and metadata.

Path Parameters

zone_name

The name of the zone.

Example: example.com

name

The DNS name, not including the zone portion.

Example: dns-name

Body

application/json

Body Sample

[
  {
    "metadata": {
      "public property": "public value"
    },
    "dns_type": "A",
    "rdata": [
      {
        "label": "optional-label-1",
        "value": "192.0.2.1"
      },
      {
        "value": "192.0.2.1"
      }
    ],
    "ttl": 60
  }
]

Body Description

array[object]

metadata object

A collection of string key/value pairs that provide additional information or classification for an object.

*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
Labels are case-insensitive and may contain alphanumeric characters and dashes.
If a label is not set manually, it will be autogenerated, prefixed with an underscore _.

Example: a-label-123

*value string

Rdata value

Example: 192.0.2.1

ttl integer

Example: 60

Minimum: 0

Response

200 201 202 400 401 402 403 404 409