Naslag Voor: beheerders, gebruikers, tenants, ontwikkelaars

Algemene fouten

Oorzaken en oplossingen voor foutcodes die elke bewerking kan geven: ontbrekende objecten, conflicten, aanmelden en bevoegdheden.

error.not_found

Tekst in de console
Het object is niet gevonden. Het is mogelijk verwijderd. Vernieuw de inventaris.
Betekenis voor API-clients
The object does not exist (or is not visible to the caller).
Code
NOT_FOUND, HTTP 404

Oorzaak. Het object bestaat niet, of is niet zichtbaar voor de aanroeper. Kyvernon geeft voor beide hetzelfde antwoord, zodat een aanroeper zonder toegang niet kan achterhalen of een object bestaat. Het object is mogelijk verwijderd, of de identificatie is onjuist.

Oplossing.

  1. Vernieuw de inventaris in de console, of toon de objecten opnieuw: kyvernon inventory search <name>.
  2. Controleer de identificatie die u gebruikte. Identificaties hebben de vorm <kind>-<number>.
  3. Moet het object bestaan, vraag dan een beheerder of uw rol toegang tot het object geeft: kyvernon privileges check <entity> <privilege>.

error.already_exists

Tekst in de console
Er bestaat al een object met die naam of dat id. Kies een andere naam.
Betekenis voor API-clients
An object with that name or id exists.
Code
ALREADY_EXISTS, HTTP 409

Oorzaak. Er bestaat al een object met die naam of identificatie, in dezelfde map of hetzelfde bereik.

Oplossing.

  1. Kies een andere naam.
  2. Om het bestaande object te wijzigen, leest u het en werkt u het bij in plaats van het opnieuw aan te maken.

error.conflict

Tekst in de console
Het object is gewijzigd terwijl u het bewerkte. Laad de pagina opnieuw en voer uw wijziging nogmaals door.
Betekenis voor API-clients
Compare-and-set failed: expectedVersion is stale.
Code
CONFLICT, HTTP 409

Oorzaak. Het object is gewijzigd tussen het moment waarop u het las en het moment waarop u het opsloeg. Elke wijziging noemt de versie waarop ze is gebaseerd (expectedVersion in de API, If-Match voor de firewall), en die versie is niet meer actueel.

Oplossing.

  1. Laad het object opnieuw in de console, of lees het opnieuw: kyvernon inventory get <id>.
  2. Pas uw wijziging opnieuw toe op de versie die u las. Geef met de CLI de nieuwe versie mee: kyvernon inventory update <id> --expected-version <version> --body-file <file>.

error.unauthenticated

Tekst in de console
U bent niet aangemeld. Meld u aan en probeer het opnieuw.
Betekenis voor API-clients
No or invalid bearer token.
Code
UNAUTHENTICATED, HTTP 401

Oorzaak. Het verzoek bevat geen bearer-token, of het token is niet geldig: het is verlopen, ingetrokken of hoort bij een sessie die is beëindigd.

Oplossing.

  1. Meld u opnieuw aan: kyvernon login <username> --save. Gebruik in de console Aanmelden.
  2. API-clients controleren of de header Authorization: Bearer <token> wordt verstuurd en of het API-token niet is verlopen: kyvernon auth api-tokens list.

error.permission_denied

Tekst in de console
Het verzoek is geweigerd. Uw rol omvat de vereiste bevoegdheid niet. Vraag een beheerder om toegang.
Betekenis voor API-clients
The caller lacks a privilege on the entity.
Code
PERMISSION_DENIED, HTTP 403
ArgumentInhoud
privilegede bevoegdheid die de bewerking nodig heeft.

Oorzaak. De gebruiker of het token heeft een rol zonder de bevoegdheid die de bewerking op dat object nodig heeft. De bevoegdheid staat in het argument privilege van het API-antwoord.

Oplossing.

  1. Controleer de bevoegdheid in het antwoord en controleer wat uw rol bevat: kyvernon privileges check <entity> <privilege>.
  2. Vraag een beheerder om een rol die de bevoegdheid op dat object bevat. De beheerder kent die toe met kyvernon permissions set <entity> <principal> --role <role>.
  3. Geef de bericht-id, de naam van de bevoegdheid en het tijdstip door.

error.audit_record_immutable

Tekst in de console
Auditrecords kunnen niet worden verwijderd.
Betekenis voor API-clients
Audit records cannot be deleted.
Code
PERMISSION_DENIED, HTTP 403

Oorzaak. Een verzoek probeerde een auditrecord te verwijderen. Auditrecords kunnen alleen worden toegevoegd, en geen enkele rol kan ze verwijderen.

Oplossing.

  1. Verwijder geen auditrecords. Haal het verzoek uit het script of de tool die het verstuurt.
  2. Om te beperken hoe lang auditrecords worden bewaard, stelt een beheerder audit_age in de sectie [retention] van de controllerconfiguratie in. Kyvernon verwijdert records die ouder zijn dan die termijn zelf.

Versie 0.1. Laatst gewijzigd: 2026-11-13