Errors
A failure names its class (code) and its reason; a warning, its reason. The class says what to do - correct the input, ask a person, wait, check the state; the reason says what happened, and its params the values. A client that does not know a reason acts on the class.
INVALID_INPUT
The input is wrong. Correct it and call again; the same call fails again.
| Reason | Meaning |
|---|---|
already_exists | The value names something that exists already, and there is only one of it - an address, a name.Reserved |
apex_ns_not_allowed | The NS records of the domain itself are the provider's - neither added nor removed. |
approval_token_invalid | The approval_token is none this call can use: unknown, expired, used already, or given for another call or other input. Nothing was done. Call again without it, to be asked for the approval anew - never with the arguments changed to fit the token. Its pointer is /approval_token.Reserved |
batch_not_accepted | More than one message in one request; one message per request is taken.Reserved |
body_not_json | The body of the request is not a JSON document.Reserved |
body_too_large | The body of the request is larger than the server takes.Reserved |
caa_invalid | A CAA record is not flags, a tag and a value. |
class_unsupported | The zone text cannot be read at the line named; the message says why. |
cname_at_apex | A CNAME cannot stand at the domain itself, beside its SOA and NS. |
cname_not_alone | A CNAME stands alone at its name - no other record beside it. |
cname_single_value | A CNAME has one value. |
credential_ambiguous | More than one credential arrived; exactly one is taken.Reserved |
directive_invalid | The zone text cannot be read at the line named; the message says why. |
directive_not_allowed | The zone text cannot be read at the line named; the message says why. |
ds_digest_invalid | The zone text cannot be read at the line named; the message says why. |
ds_digest_type_unknown | The zone text cannot be read at the line named; the message says why. |
ds_invalid | The zone text cannot be read at the line named; the message says why. |
duplicate | The list has a value more than once; the pointer is at its second place.Reserved |
escape_invalid | The zone text cannot be read at the line named; the message says why. |
fields_invalid | Fields of the input are wrong - each, with its reason, in violations.Reserved |
header_repeated | A header that is taken once arrived with more than one value.Reserved |
host_invalid | The host is no DNS name. |
invalid | The value is not of the type or form the field takes.Reserved |
ipv4_address_invalid | An A record holds no IPv4 address. |
ipv6_address_invalid | An AAAA record holds no IPv6 address. |
job_token_malformed | The job_token is none - pass it as the starting tool answered it. |
media_type_not_accepted | The body is sent in a media type the server does not take.Reserved |
method_not_allowed | The address does not take this method.Reserved |
mutually_exclusive | The field cannot stand together with another field of the input - one of them, not both.Reserved |
name_needs_final_dot | A name written with the domain at its end needs a final dot - or none of the domain. |
not_allowed | The value is none of those the field takes.Reserved |
not_for_type | The field does not apply to the type of what the call is about.Reserved |
not_found | The value names something that does not exist - what the input refers to. What the call itself is about, when it does not exist, is the class NOT_FOUND with a reason of the backend's own.Reserved |
ns_target_is_provider | A subdomain delegated to manitu's own name servers, which hold the zone already. |
origin_invalid | The zone text cannot be read at the line named; the message says why. |
origin_unsupported_for_type | The zone text cannot be read at the line named; the message says why. |
owner_invalid | The zone text cannot be read at the line named; the message says why. |
owner_missing | The zone text cannot be read at the line named; the message says why. |
owner_outside_zone | The zone text cannot be read at the line named; the message says why. |
parameter_conflict | A parameter arrived in a header and in the body, with two different values.Reserved |
parenthesis_unbalanced | The zone text cannot be read at the line named; the message says why. |
port_out_of_range | A port is outside 0 to 65535. |
priority_out_of_range | A priority is outside 0 to 65535. |
rdata_missing | The zone text cannot be read at the line named; the message says why. |
record_invalid | The zone text cannot be read at the line named; the message says why. |
required | A value is required here and is missing.Reserved |
self_reference | The value refers to the very thing the call is about - a forward to its own address, a record that points to itself.Reserved |
soa_invalid | The zone text cannot be read at the line named; the message says why. |
soa_missing | The zone text cannot be read at the line named; the message says why. |
string_unterminated | The zone text cannot be read at the line named; the message says why. |
svcb_params_invalid | The parameters of an HTTPS or SVCB record are not valid. |
target_hostname_invalid | A target is no host name - no URL, no port, no path. |
tlsa_invalid | A TLSA record is not usage, selector, matching type and a digest of the right length. |
too_few | The list has fewer entries than the field allows.Reserved |
too_large | The number is larger than the field allows.Reserved |
too_long | The text is longer than the field allows.Reserved |
too_many | The list has more entries than the field allows.Reserved |
too_short | The text is shorter than the field allows.Reserved |
too_small | The number is smaller than the field allows.Reserved |
ttl_invalid | The zone text cannot be read at the line named; the message says why. |
txt_too_long | The zone text cannot be read at the line named; the message says why. |
type_invalid | The zone text cannot be read at the line named; the message says why. |
type_unknown | A record type no zone can hold. |
unknown_field | The input has a field the operation does not take.Reserved |
unknown_invalid | The zone text cannot be read at the line named; the message says why. |
value_invalid | The value is not one of the type. |
weight_out_of_range | A weight is outside 0 to 65535. |
wildcard_ns_not_allowed | NS records delegate one name, never a wildcard. |
zone_not_loadable | The name server would not load the zone; the old zone stays. |
zone_text_unreadable | The zone text cannot be read at the line named; the message says why. |
PERMISSION_DENIED
The credential is valid, but may not do this. Another credential, or a wider one, is the way - not a repeat.
| Reason | Meaning |
|---|---|
approval_unavailable | The call needs a level of approval this backend cannot get for this caller - it has no way open for it: no user interface of its own, no kept calls, or not for this credential. Nothing was done, and calling again does not change that: a person does it in the backend's own user interface, or with another credential.Reserved |
credential_type_not_allowed | This kind of credential is not taken for this call, or not this way.Reserved |
insufficient_scope | The credential does not carry the scopes the call needs.Reserved |
permission_missing | This access lacks a permission the call needs; the main access of the account can grant it. |
primary_access_required | Only the main access of the account may see this job. |
NOT_FOUND
What the call names does not exist, or not for this caller.
| Reason | Meaning |
|---|---|
operation_unknown | No operation answers at this address.Reserved |
resource_not_found | What the call names does not exist in the account, or not for this access. |
PRECONDITION_FAILED
The current state rules the call out. It may work once the state has changed; at once, the same call fails again.
| Reason | Meaning |
|---|---|
approval_not_pending | It no longer waits for an approval - it was decided, carried out or has expired. |
approval_required | The call needs an approval it does not have yet, said in params.approval. Without pending_action nothing was done: show every element as it is, and give the approval the way params.approval.ways says - with call_again, the same call again with the token, after an explicit yes of the person. With pending_action the backend has kept the call and carries it out once a person approves it in its own user interface, which the model cannot reach; the operation that follows a kept call says how it ended.Reserved |
approval_stale | The approval was given for a state that has changed since: what the call is about was changed in between, so the call was not carried out. Nothing was done. Do not call again with corrected arguments - look at the state again, and where the call is still wanted, have it approved anew.Reserved |
consent_required | Deprecated: a consent of the person is needed before the call can go through - show every entry of consent_list as it is, and call again with consent_token after an explicit yes. Superseded by approval_required: still read, for a backend that has not moved yet, and removed in a later release; a backend sends approval_required.Reserved |
limit_reached | A limit is reached: no more of something until there are fewer, the window has passed, or the limit is raised.Reserved |
no_change | The call would change nothing: what it sets is so already.Reserved |
no_webhosting_package | The defaults of a web hosting package need the domain in one. |
not_in_plan | What the call needs is not part of the plan - another plan has it. Something the plan counts is a limit_reached with count_max 0.Reserved |
resource_busy | Something is still running for what the call is about; the call works once it has finished.Reserved |
zone_changed | The zone changed since it was read: read it again and apply the change again. |
zone_not_editable | The domain is not active, so its zone cannot be changed. |
zone_not_hosted_here | The zone of the domain is not a primary zone held here - its name servers are elsewhere. |
zone_stored_not_readable | The zone as stored cannot be read; the provider has to repair it. |
UPSTREAM_UNAVAILABLE
A system the call depends on did not answer. Nothing was done; calling again later may work.
| Reason | Meaning |
|---|---|
credential_unverifiable | The system that verifies credentials did not answer; the credential itself was not judged.Reserved |
OPERATION_FAILED
The call failed on the server's side, and whether something took effect is not known. Check the state before calling again.
| Reason | Meaning |
|---|---|
internal_error | Something unexpected went wrong on the server's side; the log has it under the request id.Reserved |
outcome_unknown | The call was sent and broke off before an answer to go by came back - a timeout, a connection that broke, an answer that could not be trusted or read. It may have taken effect: check the state before calling again. Said by the application, for a call that changes something; a read that broke off is UPSTREAM_UNAVAILABLE.Reserved |
Warnings
A warning never blocks the call: it comes with a success, a dry run or a failure, and says what probably does not work as meant, or what was changed on the way.
| Reason | Meaning |
|---|---|
apex_ns_kept | NS records of the domain itself sent were not taken - the provider's stay. |
comments_removed | Comments in the zone text are not kept. |
invalid_record_kept | A record is not valid (code), but stored so already - kept, not refused. Tell the user; it should be repaired or removed. |
ipv4_address_not_global | An IPv4 address that is not reachable on the internet (private, loopback ...). |
ipv4_address_not_in_account | An IPv4 address that is not one of the account's. |
ipv6_address_not_global | An IPv6 address that is not reachable on the internet (link-local, unique local ...). |
ipv6_address_not_in_account | An IPv6 address that is not one of the account's. |
mx_missing | No MX record - no mail for the domain is taken. |
mx_target_is_mail_client_host | An MX record names the host for mail programs, which takes no mail from other servers - suggested_target does. |
mx_target_without_address | An MX target within the zone has no A, AAAA or CNAME record. |
record_duplicate | A record is there twice. |
soa_kept | The SOA name server or contact sent were not taken - the provider's stay. |