Naslag Voor: beheerders

Tagfouten

Oorzaken en oplossingen voor de foutcodes van tagcategorieën, tags en tagkoppelingen.

error.tag.not_associable

Tekst in de console
Tags van categorie {category} kunnen niet aan een {kind} worden gekoppeld.
Betekenis voor API-clients
Tags of the category cannot be attached to objects of that kind (the category's associable kinds).
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
categoryde naam van de categorie.
kindde soort van het object, bijvoorbeeld host.

Oorzaak. De categorie van de tag noemt de soorten objecten waaraan de tags mogen worden gekoppeld, en het object is van een andere soort.

Oplossing.

  1. Koppel een tag van een categorie die deze soort toestaat, of
  2. Voeg de soort toe aan de categorie: kyvernon inventory tag-categories update <id> --kind <kind> --kind <kind>, met de huidige soorten en de nieuwe.

error.tag.cardinality

Tekst in de console
Object {object} heeft al een tag van categorie {category}, die één tag per object toestaat.
Betekenis voor API-clients
The object already carries another tag of a category that allows one tag per object.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
categoryde naam van de categorie.
objectde id van het object.

Oorzaak. De categorie staat één tag per object toe (kardinaliteit single), en het object heeft al een andere tag van die categorie.

Oplossing.

  1. Ontkoppel eerst de andere tag: kyvernon inventory tags detach <tag> <object>.
  2. Of sta meerdere tags per object toe: kyvernon inventory tag-categories update <id> --cardinality multiple.

error.tag.provider_managed

Tekst in de console
Tags van categorie {category} worden alleen door de provider gekoppeld en ontkoppeld.
Betekenis voor API-clients
Tags of a provider-managed category are attached and detached by the provider only.
Code
PERMISSION_DENIED, HTTP 403
ArgumentInhoud
categoryde naam van de categorie.

Oorzaak. Tags van een categorie die de provider beheert, bepalen in welke firewallgroepen van de provider een object zit. Alleen de provider koppelt en ontkoppelt ze; een tenantgebruiker kan dat niet.

Oplossing.

  1. Vraag de provider de tag te koppelen of te ontkoppelen.
  2. Voor eigen labels gebruikt een tenant een categorie die de provider niet beheert.

error.tag.category_change

Tekst in de console
De categoriewaarde {field} kan niet zo worden gewijzigd: de kardinaliteit gaat alleen van enkel naar meervoudig, en koppelbare soorten kunnen alleen worden toegevoegd.
Betekenis voor API-clients
A category's cardinality changes from single to multiple only, and associable kinds can only be added.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
fieldhet veld van het verzoek, cardinality of associableKinds.

Oorzaak. Een wijziging van de categorie zou bestaande koppelingen ongeldig maken. De kardinaliteit gaat alleen van single naar multiple, en koppelbare soorten kunnen alleen worden toegevoegd, nooit weggehaald.

Oplossing.

  1. Houd de huidige soorten in de lijst en voeg de nieuwe toe.
  2. Om een categorie te beperken: maak een nieuwe categorie met de strengere regels, koppel de tags daarvan, en verwijder de oude: kyvernon inventory tag-categories delete <id>.

Versie 0.1. Laatst gewijzigd: 2026-11-13