Oorzaken en oplossingen voor de foutcodes van het endpoint van de NSX Policy API dat tools zoals de Terraform NSX-T-provider gebruiken.
Deze fouten komen van het endpoint van de NSX Policy API van Kyvernon, dat een deel van die API aanbiedt voor bestaande tools. Het antwoord heeft de vorm die zulke tools verwachten; de foutcode staat er ook in.
error.nsx.unsupported
Tekst in de console
Het NSX Policy-verzoek gebruikt een functie die deze server niet aanbiedt. Verwijder het veld dat in het bericht staat en verstuur opnieuw.
Betekenis voor API-clients
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).
Oorzaak. Het verzoek gebruikt een functie buiten het deel dat Kyvernon aanbiedt, bijvoorbeeld een gatewaybeleid, een segment, een contextprofiel of een identiteitsgroep. De melding noemt het veld. Identiteitsgroepen vereisen een directoryservice en in elke gast een agent die gebruikersaanmeldingen meldt; Kyvernon heeft geen van beide, groepeer virtuele machines daarom op tag.
Oplossing.
Verwijder het genoemde veld of de genoemde resource uit het verzoek of uit de configuratie van de tool.
Beheer de gedistribueerde firewall met de objecten van het ondersteunde deel: groepen, services, beveiligingsbeleid en regels, en tags van virtuele machines. De firewallpagina's in de console tonen dezelfde objecten.
error.nsx.invalid
Tekst in de console
Een veld van het NSX Policy-verzoek is ongeldig. Corrigeer het veld dat in het bericht staat en verstuur opnieuw.
Betekenis voor API-clients
NSX Policy API facade: a field of the request is not valid; the message names it.
Oorzaak. Het pad wijst naar geen enkel object, of naar een object dat uw account niet kan zien. Objecten van een andere tenant zijn niet zichtbaar.
Oplossing.
Controleer de id in het pad.
Controleer of uw account leestoegang tot het object heeft. Een gebruiker van een tenant ziet alleen de objecten van de eigen tenant en de providerobjecten die erop van toepassing zijn.
error.nsx.revision
Tekst in de console
Het object is gewijzigd sinds u het las, dus de revisie is verouderd. Lees het object opnieuw en pas uw wijziging toe op de nieuwe versie.
Betekenis voor API-clients
NSX Policy API facade: the _revision of the write is stale (412); read the object again.
Oorzaak. De waarde _revision in de schrijfactie is ouder dan het opgeslagen object: iemand heeft het object gewijzigd nadat u het las.
Oplossing.
Lees het object opnieuw en voer de wijziging opnieuw uit op de huidige versie. Tools zoals Terraform doen dat met een refresh gevolgd door een nieuw plan.
error.nsx.read_only
Tekst in de console
Het object is ingebouwd, of een tenantgebruiker schreef in de providerscope. Wijzig in plaats daarvan een eigen object.
Betekenis voor API-clients
NSX Policy API facade: the object is built in, or a tenant user wrote into the provider scope.
Oorzaak. Het object is ingebouwd, bijvoorbeeld een service uit de ingebouwde catalogus of een platformregel, of een gebruiker van een tenant probeerde te schrijven in het bereik van de provider.
Oplossing.
Laat het ingebouwde object zoals het is en maak er een eigen object naast.
Schrijf als gebruiker van een tenant in het bereik van uw eigen project.
error.nsx.xsrf
Tekst in de console
Een schrijfactie met een sessiecookie vereist de header X-XSRF-TOKEN van de sessie. Stuur de header mee, of authenticeer elk verzoek met HTTP Basic in plaats van de cookie.
Betekenis voor API-clients
NSX Policy API facade: a write with a session cookie lacks the session's X-XSRF-TOKEN.
Oorzaak. Een schrijfactie met een sessiecookie kwam zonder de header X-XSRF-TOKEN van die sessie.
Oplossing.
Stuur bij elke schrijfactie het token dat de sessie-aanmelding teruggaf mee in de header X-XSRF-TOKEN, of authenticeer elk verzoek met basisauthenticatie in plaats van een sessiecookie.