Sign in

v1

latestOpenAPI 3.1.02026-07-244861122.7 KB
records

Create a new name

Create a new name, with records and metadata.

post/v1/dns/records/{zone_name}

Path parameters

zone_namestring required

The name of the zone.

Example:example.com

The name of the zone.

Request body

namestring required

The DNS name, not including the zone portion.

is_offlineboolean nullable

Is the DNS name offline?

metadataMetadata

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

Example request

{
  "name": "dns-name",
  "rrsets": [
    {
      "dns_type": "A",
      "rdata": [
        {
          "value": "192.0.2.1",
          "label": "optional-label-1"
        },
        {
          "value": "192.0.2.2"
        }
      ],
      "ttl": 60,
      "metadata": {
        "key": "value"
      }
    },
    {
      "dns_type": "AAAA",
      "rdata": [
        {
          "value": "2001:db8::1",
          "label": "optional-label-2"
        }
      ],
      "ttl": 60
    }
  ],
  "metadata": {
    "property": "value"
  }
}

Response

resource created