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).
manitu_domain_dns_zone_check on https://mcp.manitu.de/mcpAnnotations as tools/list sends them
Description for the model
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.
Arguments
name (required)stringThe domain name, with international characters or in ASCII.
zone_datastringOptional: 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.
record_textstringOptional, 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.
Result structuredContent, checked against the schema
namestringThe domain, with international characters.
sourcestringWhat was checked.
refusal_countintegerFindings that would keep the text from being stored - errors not stored so already.
finding_listarray of objectWhat was found, by line; findings without line last.
finding_list[].levelstringfinding_list[].reasonstringWhat was found, lower_snake_case - e.g. ipv4_address_invalid, record_duplicate.
finding_list[].rr_typestring | nullThe record type; null: not tied to a record (a parse error).
finding_list[].ownerstring | nullThe name of the record, absolute.
finding_list[].lineinteger | nullThe line in the text checked; null: none.
finding_list[].paramsobjectThe values found - e.g. address, target, value, min, max.
finding_list[].is_storedbooleanThe record is stored exactly so already.
Authentication
One of X-API-Key, Authorization: Bearer … - never more than one in a request. More
Request body JSON; unknown fields are refused
name (required)stringThe domain name, with international characters or in ASCII.
zone_datastringOptional: 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.
record_textstringOptional, 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.
Response in data; the rest of the body as on every call
namestringThe domain, with international characters.
sourcestringWhat was checked.
refusal_countintegerFindings that would keep the text from being stored - errors not stored so already.
finding_listarray of objectWhat was found, by line; findings without line last.
finding_list[].levelstringfinding_list[].reasonstringWhat was found, lower_snake_case - e.g. ipv4_address_invalid, record_duplicate.
finding_list[].rr_typestring | nullThe record type; null: not tied to a record (a parse error).
finding_list[].ownerstring | nullThe name of the record, absolute.
finding_list[].lineinteger | nullThe line in the text checked; null: none.
finding_list[].paramsobjectThe values found - e.g. address, target, value, min, max.
finding_list[].is_storedbooleanThe record is stored exactly so already.
Statuses
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.Errors reasons it is known to fail with - all of them
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