La auditoría es el registro de cambios de la organización, del más reciente al más antiguo. Las versiones de una zona cubren la configuración de esa zona; la auditoría lo cubre todo: cada versión de cada zona y también los cambios que no se versionan, como miembros, tokens de API, clientes, marca, purgas de caché y certificados de origen.
Qué contiene una entrada
| Campo | Significado |
|---|---|
id | Número creciente de la entrada; sirve para paginar. |
at | Cuándo ocurrió. |
actor | Quién lo hizo: user:<id>, token:<id> o system:<nombre> (cambios automáticos, como la emisión de certificados por system:acme). |
action | Qué pasó, como record.create, zone.cache.purge o token.create. |
target | El objeto afectado: normalmente el id de una zona, un registro, un cliente o un token. |
data | Los detalles del cambio. |
Si el cambio creó una versión de una zona, data lleva además version, from_version y reason, y restored_from en una vuelta atrás. Las escrituras que no cambiaron nada llevan "unchanged": true. Los cambios hechos por el servidor MCP llevan "channel": "mcp".
Quién puede leerla
| Credencial | Qué ve |
|---|---|
| Propietario o administrador de toda la organización | Todas las entradas de la organización. |
| Miembro o token técnico limitado a un cliente | Las entradas sobre las zonas de ese cliente. |
| Cualquier otro rol o ámbito | Nada: la API responde 403. |
Auditoría e historial de una zona
Cada versión de una zona se escribe en la auditoría en la misma transacción, con el mismo autor, la misma acción y el mismo motivo: no hay versión sin su entrada de auditoría. Un cambio que escribe varios registros a la vez (un lote o una importación) crea una versión y una entrada de auditoría por registro. El historial de la zona es el sitio para comparar configuraciones y volver atrás; la auditoría, el sitio para ver todo lo que ha pasado en la organización, en orden.
Cómo leerla y paginarla: Leer la auditoría.