Import zone file data

POST /v1/dns/zones/{zone_name}/import

Takes a zone file and creates the zone with all its records.

Path Parameters

zone_name

The name of the zone.

Example: example.com

Body

text/plain

Body Sample

string

Body Description

Response

201 400 401 402 403 409

---

Created

resource created

{
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Bad Request

Multiple error variants are possible:

• DNS hostname contains too many labels (code: 2324)
• a label contains characters not in the allowed character set (code: 3284)
• a wildcard label must be the terminal label in a name (code: 3893)
• creating this RRset violates DNS rules (code: 2196)
• creating this Rdata violates DNS rules (code: 4130)
• invalid zone name (code: 4637)
• the parent of a wildcard cannot be an empty nonterminal node (code: 3624)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Unauthorized

unauthorized (code: 2465)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Payment Required

Multiple error variants are possible:

• DNS names are over limit; please contact support (code: 3354)
• RRset metadata over limit; please contact support (code: 4556)
• Rdata count is over limit; please contact support (code: 4428)
• dns name metadata over limit; please contact support (code: 2218)
• owned zones are over limit; please contact support (code: 4085)
• zone metadata over limit; please contact support (code: 4228)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Forbidden

Multiple error variants are possible:

• DNS name not allowed (code: 4297)
• DNS types disallowed (code: 2051)
• RRset TTL cannot be change (code: 4535)
• Rdata not allowed (code: 3627)
• creating Rdata in this zone is forbidden (code: 4635)
• creating a DNS name in this zone is forbidden (code: 3331)
• new names cannot be created in this zone (code: 2784)
• only auto-generated Rdata labels may start with an underscore (code: 4555)
• operation only available via the website (code: 4786)
• requested RRset TTL is too low (code: 3655)
• wildcards in labels are restricted (code: 4072)
• zone name not allowed (code: 3758)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Conflict

Multiple error variants are possible:

• DNS name is already owned (code: 3424)
• Rdata value already exists (code: 2722)
• zone already exists (codes: 3901, 3902)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}