Causes et solutions des codes d'erreur du point de terminaison de l'API NSX Policy qu'utilisent des outils comme le fournisseur Terraform NSX-T.
Ces erreurs proviennent du point de terminaison de l'API NSX Policy de Kyvernon, qui sert un sous-ensemble de cette API pour les outils existants. La réponse a la forme attendue par ces outils et contient aussi le code d'erreur.
error.nsx.unsupported
Texte dans la console
La requête NSX Policy utilise une fonction que ce serveur ne propose pas. Retirez le champ nommé dans le message, puis renvoyez-la.
Signification pour les clients de l'API
NSX Policy API facade: the request uses a feature outside the subset this server serves; the message names the field (DFW-HOSTBRIDGE.md §6.4).
Cause. La requête utilise une fonction hors du sous-ensemble servi par Kyvernon, par exemple une stratégie de passerelle, un segment, un profil de contexte ou un groupe d'identité. Le message indique le champ. Les groupes d'identité exigent un service d'annuaire et, dans chaque invité, un agent qui signale les connexions des utilisateurs ; Kyvernon n'a ni l'un ni l'autre, regroupez donc les machines virtuelles par étiquette.
Solution.
Retirez le champ ou la ressource indiqués de la requête ou de la configuration de l'outil.
Gérez le pare-feu distribué avec les objets du sous-ensemble : groupes, services, stratégies de sécurité et règles, et balises de machines virtuelles. Les pages du pare-feu dans la console affichent les mêmes objets.
error.nsx.invalid
Texte dans la console
Un champ de la requête NSX Policy n’est pas valide. Corrigez le champ nommé dans le message, puis renvoyez-la.
Signification pour les clients de l'API
NSX Policy API facade: a field of the request is not valid; the message names it.
Cause. Le chemin ne désigne aucun objet, ou un objet que votre compte ne peut pas voir. Les objets d'un autre locataire ne sont pas visibles.
Solution.
Vérifiez l'identifiant dans le chemin.
Vérifiez que votre compte a un accès en lecture à l'objet. Un utilisateur d'un locataire ne voit que les objets de son propre locataire et les objets du fournisseur qui s'y appliquent.
error.nsx.revision
Texte dans la console
L’objet a changé depuis votre lecture, sa révision est donc périmée. Relisez l’objet et appliquez votre modification à la nouvelle version.
Signification pour les clients de l'API
NSX Policy API facade: the _revision of the write is stale (412); read the object again.
Cause. La valeur _revision de l'écriture est plus ancienne que l'objet enregistré : quelqu'un a modifié l'objet après votre lecture.
Solution.
Relisez l'objet et refaites la modification sur la version actuelle. Des outils comme Terraform le font avec une actualisation suivie d'un nouveau plan.
error.nsx.read_only
Texte dans la console
L’objet est intégré, ou un utilisateur de locataire a écrit dans le périmètre du fournisseur. Modifiez plutôt un objet qui vous appartient.
Signification pour les clients de l'API
NSX Policy API facade: the object is built in, or a tenant user wrote into the provider scope.
Cause. L'objet est intégré, par exemple un service du catalogue intégré ou une règle de la plateforme, ou un utilisateur d'un locataire a tenté d'écrire dans la portée du fournisseur.
Solution.
Laissez l'objet intégré tel quel et créez votre propre objet à côté.
En tant qu'utilisateur d'un locataire, écrivez dans la portée de votre propre projet.
error.nsx.xsrf
Texte dans la console
Une écriture avec un cookie de session exige l’en-tête X-XSRF-TOKEN de la session. Envoyez l’en-tête, ou authentifiez chaque requête avec HTTP Basic au lieu du cookie.
Signification pour les clients de l'API
NSX Policy API facade: a write with a session cookie lacks the session's X-XSRF-TOKEN.
Cause. Une écriture utilisant un cookie de session est arrivée sans l'en-tête X-XSRF-TOKEN de cette session.
Solution.
Envoyez avec chaque écriture le jeton renvoyé par la connexion de session dans l'en-tête X-XSRF-TOKEN, ou authentifiez chaque requête avec l'authentification de base au lieu d'un cookie de session.