Check DNS zone of a domain

What is wrong or worth knowing in the DNS zone of one domain, in zone text sent or in records to add - nothing is changed.

Checks the DNS zone of a domain at manitu, by its name, and lists what is wrong or worth knowing, without changing anything: the zone as stored, the zone text zone_data before manitu_domain_dns_zone_setPOST /v1/domain/dns/zone/set, or the records record_text before they are added - one of the two at most (mutually_exclusive). Each finding has a level (error: would be refused; warning, info), a reason, the record (type, owner, line) and params; is_stored says the record is stored so already. refusal_count is the number of findings that would keep the text from being stored. Refused for a zone manitu does not hold as primary (zone_not_hosted_here) or cannot read as stored (zone_stored_not_readable).

RReadIdempotentNeeds service_domain
Tool
manitu_domain_dns_zone_checkon https://mcp.manitu.de/mcp
POST
/v1/domain/dns/zone/checkon https://api.manitu.de
Try it
readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Checks the DNS zone of a domain at manitu, by its name, and lists what is wrong or worth knowing - without changing anything. Pass zone_data to check zone text before manitu_domain_dns_zone_setPOST /v1/domain/dns/zone/set, record_text to check records before adding them, or neither to check the zone as stored. Each finding has a level (error: would be refused; warning, info: a hint), a reason, the record (type, owner, line) and params; is_stored says the record is stored so already - such an error is kept by zone/set, not refused, but should be repaired. refusal_count is how many findings would keep zone/set from storing the text. Only for a zone manitu holds as primary (zone_not_hosted_here otherwise). Read-only.

Reasons it may answer: resource_not_found, permission_missing, zone_not_hosted_here, zone_stored_not_readable.

name (required)string

The domain name, with international characters or in ASCII.

min length 1max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
zone_datastring

Optional: the whole zone as BIND zone file text, as manitu_domain_dns_zone_setPOST /v1/domain/dns/zone/set takes it. Left out (and no record_text): the zone as stored is checked.

min length 1max length 524288
record_textstring

Optional, instead of zone_data: records to add, in zone file form, one per line - e.g. "www IN A 192.0.2.1"; names relative to the domain. Checked as if added to the zone as stored.

min length 1max length 65536
namestring

The domain, with international characters.

max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
sourcestring

What was checked.

One of zone_data record_text stored
refusal_countinteger

Findings that would keep the text from being stored - errors not stored so already.

min 0
finding_listarray of object

What was found, by line; findings without line last.

finding_list[].levelstring
One of error warning info
finding_list[].reasonstring

What was found, lower_snake_case - e.g. ipv4_address_invalid, record_duplicate.

pattern ^[^\x00-\x1F\x7F]*$
finding_list[].rr_typestring | null

The record type; null: not tied to a record (a parse error).

pattern ^[^\x00-\x1F\x7F]*$
finding_list[].ownerstring | null

The name of the record, absolute.

pattern ^[^\x00-\x1F\x7F]*$
finding_list[].lineinteger | null

The line in the text checked; null: none.

finding_list[].paramsobject

The values found - e.g. address, target, value, min, max.

finding_list[].is_storedboolean

The record is stored exactly so already.

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

name (required)string

The domain name, with international characters or in ASCII.

min length 1max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
zone_datastring

Optional: the whole zone as BIND zone file text, as manitu_domain_dns_zone_setPOST /v1/domain/dns/zone/set takes it. Left out (and no record_text): the zone as stored is checked.

min length 1max length 524288
record_textstring

Optional, instead of zone_data: records to add, in zone file form, one per line - e.g. "www IN A 192.0.2.1"; names relative to the domain. Checked as if added to the zone as stored.

min length 1max length 65536
namestring

The domain, with international characters.

max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
sourcestring

What was checked.

One of zone_data record_text stored
refusal_countinteger

Findings that would keep the text from being stored - errors not stored so already.

min 0
finding_listarray of object

What was found, by line; findings without line last.

finding_list[].levelstring
One of error warning info
finding_list[].reasonstring

What was found, lower_snake_case - e.g. ipv4_address_invalid, record_duplicate.

pattern ^[^\x00-\x1F\x7F]*$
finding_list[].rr_typestring | null

The record type; null: not tied to a record (a parse error).

pattern ^[^\x00-\x1F\x7F]*$
finding_list[].ownerstring | null

The name of the record, absolute.

pattern ^[^\x00-\x1F\x7F]*$
finding_list[].lineinteger | null

The line in the text checked; null: none.

finding_list[].paramsobject

The values found - e.g. address, target, value, min, max.

finding_list[].is_storedboolean

The record is stored exactly so already.

200Success.400The input is wrong, or the request itself (INVALID_INPUT). Each entry names its field and its reason - correct the input and call again.401No credential was presented, or it was not recognised (UNAUTHENTICATED).403The credential is valid, but may not do this (PERMISSION_DENIED). The reason says why - another credential is the way, not a repeat.404What the call names does not exist, or not for this caller (NOT_FOUND). Look it up again - do not guess another.409Not possible in the current state (PRECONDITION_FAILED). The reason says what stands in the way; the same call may succeed once it has changed.429Too many calls. The Retry-After header says when to try again.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.
resource_not_foundWhat the call names does not exist in the account, or not for this access.NOT_FOUNDpermission_missingThis access lacks a permission the call needs; the main access of the account can grant it.PERMISSION_DENIEDzone_not_hosted_hereThe zone of the domain is not a primary zone held here - its name servers are elsewhere.PRECONDITION_FAILEDzone_stored_not_readableThe zone as stored cannot be read; the provider has to repair it.PRECONDITION_FAILEDmutually_exclusivezone_data and record_text are one or the other.INVALID_INPUT
Example