Docs DNS Códigos de error Los estados HTTP y códigos de error que devuelve la API para zonas, registros, comprobaciones de delegación, lotes, fusiones y la comprobación del correo.
En esta página Los errores llegan como JSON con un code estable, un message legible y, en los errores de validación, el campo erróneo en field:
{"error" : {"code" : "invalid" , "message" : "must be between 60 and 86400 seconds" , "field" : "ttl" }}Programa contra code, no contra message. La CLI termina con 1 ante errores, 2 ante errores de uso y 3 ante un conflicto de versión.
# Errores de petición y de permisosEstado Código Cuándo 400 bad_requestJSON mal formado, campos desconocidos, valores de If-Match o dry_run no válidos 401 unauthorizedFalta el token, o no es válido, ha caducado o se ha revocado 403 forbiddenEl rol o el alcance no permiten la acción (por ejemplo un token readonly que escribe registros, o un token limitado a un dominio que da de alta zonas) 403 token_scopeUn token que solo purga ha llamado a algo distinto de la purga de caché 404 not_foundLa zona, el registro o el recurso no existe o está fuera de tu alcance 413 too_largeUn fichero de zona BIND de más de 1 MiB
# ValidaciónEstado Código Cuándo 422 invalidUn campo no es válido: mira field y message. Ejemplos: un tipo de registro no admitido, un TTL fuera de 60–86 400, una prioridad en un registro A, un comodín con proxy, una regla de convivencia , un sufijo público como nombre de zona, más de 500 operaciones en un lote (field indica la operación, como create[2].content) 422 reason_requiredUn cambio de configuración sin X-Change-Reason (de 1 a 500 caracteres)
# ZonasEstado Código Cuándo 403 zone_limitLa organización ha llegado a su límite de dominios. Borra los que no uses o pide a soporte que lo amplíe 409 zone_existsEl dominio ya está dado de alta en OpenWAF 409 zone_overlapsEl dominio es padre o subdominio de un dominio que gestiona otra organización u otro cliente 409 zone_not_externalUna operación solo para zonas externas (como GET …/hosts) sobre una zona delegada 409 conflictLa zona está desactivada, la operación no vale para una zona externa (por ejemplo importar registros) o un nombre ya está ocupado 409 zone_mergedLa zona se fusionó en otra y está en solo lectura 409 merge_not_equivalentUna fusión cambiaría lo que sirve algún nombre, o no se puede expresar; mira plan.problems 409 merge_not_reversibleLa zona padre cambió después de la fusión 409 missing_certsEl cambio dejaría un sitio sin certificado válido; hostnames los enumera 412 version_conflictIf-Match (o expected_version) no coincide con la versión actual de la zona; current_version la indica428 if_match_requiredUna vuelta atrás sin If-Match
# Servicios y disponibilidadEstado Código Cuándo 502 dns_backendLos servidores DNS rechazaron el cambio; no se ha aplicado nada. Reinténtalo y escribe a soporte si persiste 502 dns_out_of_syncEl cambio se ha deshecho porque no se pudo publicar; escribe a soporte 502 dns_unavailableLa comprobación del correo no ha obtenido respuesta del DNS público 503 busyHay demasiadas comprobaciones de correo en marcha; reinténtalo en unos segundos 503 unavailableLa función no está disponible temporalmente
# Clientes y marca blancaEstado Código Cuándo 409 client_has_zonesBorrar un cliente que todavía tiene dominios 409 host_takenEl dominio del panel o el nombre del servidor de nombres pertenece a otra organización 409 conflictQuitar o degradar al último propietario, o un nombre de cliente que ya existe
Tipos de registro y validación Siguiente No se detecta la delegación