Elencare le revisioni della configurazione

GET /v1/config-revisions · permesso config:read

Ogni applicazione di un piano riuscita salva una revisione: lo stato delle risorse che ha modificato, così come era subito prima dell'applicazione. Questa richiesta elenca le revisioni dell'ambiente, dalla più recente (order=asc inverte l'ordine). Un ambiente conserva le sue 50 revisioni più recenti, ciascuna per al massimo 90 giorni. Per tornare a una revisione, ripristinala.

Gli elementi contengono solo metadati. Le specifiche delle risorse memorizzate non vengono restituite e le revisioni non contengono mai valori segreti (i segreti compaiono solo come segnaposto secret_ref).

Richiesta

Parametro In Descrizione
limit query Dimensione della pagina, 1–100.
after query Cursore della pagina successiva (list_metadata.after).
before query Cursore della pagina precedente (list_metadata.before).
order query desc (predefinito, dalla più recente) o asc.

Risposta

200 OK con Cache-Control: no-store.

Campo Descrizione
id L'id della revisione, cfgr_….
plan_id Il piano la cui applicazione ha salvato la revisione; null dopo l'eliminazione del piano (7 giorni dopo la sua scadenza).
created_by La credenziale che ha applicato il piano.
created_at Quando il piano è stato applicato.
kinds I tipi coperti dal piano.
summary I conteggi create, update, delete e no_op dell'applicazione. 
{
  "data": [
    {
      "id": "cfgr_01m4qpqtywfs7930tb6kqn5rc5",
      "plan_id": "cfgp_01m4qpqtywfs7930tb6kqn5rc5",
      "created_by": "key_01m4qpqtywfs7930tb6kqn5rc5",
      "created_at": "2026-10-19T10:00:00Z",
      "kinds": ["connection"],
      "summary": {"create": 1, "update": 1, "delete": 0, "no_op": 1}
    }
  ],
  "list_metadata": {"before": null, "after": null}
}

Errori

HTTP code Quando
400 invalid_cursor Il cursore è malformato o appartiene a un'altra richiesta.
401 unauthenticated La credenziale è mancante, non valida o revocata.
403 insufficient_permissions La credenziale non ha config:read.
422 validation_failed Un parametro di query non è valido (per esempio limit fuori da 1–100).
429 rate_limited È stato superato il limite di frequenza; riprova dopo il periodo indicato in Retry-After.

Esempio

curl "https://api.eu.keenauth.com/v1/config-revisions?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth config revisions list --limit 20