v1

latestOpenAPI 3.1.02026-07-244861122.7 KB

records

Create RRSets

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

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

Path parameters

zone_namestring required

The name of the zone.

Example:example.com

The name of the zone.

namestring required

The DNS name, not including the zone portion.

Example:dns-name

The DNS name, not including the zone portion.

Request body

dns_type'A' | 'AAAA' | 'CAA' | 'CNAME' | 'MX' | 'NS' | 'SRV' | 'TXT' | 'PTR' | '_URL' | 'ALIAS' required

DNS name type supported by API

ttlinteger nullable

Time to live (seconds)

metadataMetadata

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

Example request

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

Response

resource created