Référence Pour: administrateurs

Erreurs de balises

Causes et solutions des codes d'erreur des catégories de balises, des balises et de leurs attributions.

error.tag.not_associable

Texte dans la console
Les balises de la catégorie {category} ne peuvent pas être attachées à un objet de type {kind}.
Signification pour les clients de l'API
Tags of the category cannot be attached to objects of that kind (the category's associable kinds).
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
categoryle nom de la catégorie.
kindle type de l'objet, par exemple host.

Cause. La catégorie de la balise indique les types d'objets auxquels ses balises peuvent être attachées, et l'objet est d'un autre type.

Solution.

  1. Attachez une balise d'une catégorie qui autorise ce type, ou
  2. Ajoutez le type à la catégorie : kyvernon inventory tag-categories update <id> --kind <kind> --kind <kind>, en indiquant les types actuels et le nouveau.

error.tag.cardinality

Texte dans la console
L'objet {object} porte déjà une balise de la catégorie {category}, qui n'autorise qu'une balise par objet.
Signification pour les clients de l'API
The object already carries another tag of a category that allows one tag per object.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentContenu
categoryle nom de la catégorie.
objectl'identifiant de l'objet.

Cause. La catégorie n'autorise qu'une balise par objet (cardinalité single), et l'objet porte déjà une autre balise de cette catégorie.

Solution.

  1. Détachez d'abord l'autre balise : kyvernon inventory tags detach <tag> <object>.
  2. Ou autorisez plusieurs balises par objet : kyvernon inventory tag-categories update <id> --cardinality multiple.

error.tag.provider_managed

Texte dans la console
Les balises de la catégorie {category} sont attachées et détachées par le fournisseur uniquement.
Signification pour les clients de l'API
Tags of a provider-managed category are attached and detached by the provider only.
Code
PERMISSION_DENIED, HTTP 403
ArgumentContenu
categoryle nom de la catégorie.

Cause. Les balises d'une catégorie gérée par le fournisseur décident des groupes de pare-feu du fournisseur dont un objet fait partie. Seul le fournisseur les attache et les détache ; un utilisateur de locataire ne le peut pas.

Solution.

  1. Demandez au fournisseur d'attacher ou de détacher la balise.
  2. Pour ses propres étiquettes, un locataire utilise une catégorie qui n'est pas gérée par le fournisseur.

error.tag.category_change

Texte dans la console
La valeur de catégorie {field} ne peut pas changer ainsi : la cardinalité passe uniquement d'unique à multiple, et les types associables peuvent seulement être ajoutés.
Signification pour les clients de l'API
A category's cardinality changes from single to multiple only, and associable kinds can only be added.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
fieldle champ de la requête, cardinality ou associableKinds.

Cause. Une modification de la catégorie rendrait des attributions existantes non valides. La cardinalité passe seulement de single à multiple, et des types associables peuvent seulement être ajoutés, jamais retirés.

Solution.

  1. Gardez les types actuels dans la liste et ajoutez les nouveaux.
  2. Pour restreindre une catégorie, créez une nouvelle catégorie avec les règles plus strictes, attachez ses balises, puis supprimez l'ancienne : kyvernon inventory tag-categories delete <id>.

Version 0.1. Dernière modification : 2026-11-13