Delen via

Algemene uitzonderingen en fouten bij het werken met de FabricClient-API's

  • Artikel

Met de FabricClient-API's kunnen cluster- en toepassingsbeheerders beheertaken uitvoeren op een Service Fabric-toepassing, -service of -cluster. Bijvoorbeeld toepassingsimplementatie, upgrade en verwijdering, het controleren van de status van een cluster of het testen van een service. Toepassingsontwikkelaars en clusterbeheerders kunnen de FabricClient-API's gebruiken om hulpprogramma's te ontwikkelen voor het beheren van het Service Fabric-cluster en -toepassingen.

Er zijn veel verschillende typen bewerkingen die kunnen worden uitgevoerd met FabricClient. Elke methode kan uitzonderingen genereren voor fouten vanwege onjuiste invoer, runtimefouten of tijdelijke infrastructuurproblemen. Raadpleeg de API-referentiedocumentatie om te zien welke uitzonderingen worden gegenereerd door een specifieke methode. Er zijn echter enkele uitzonderingen die kunnen worden gegenereerd door veel verschillende FabricClient-API's . De volgende tabel bevat de uitzonderingen die gebruikelijk zijn voor de FabricClient-API's.

Uitzondering Gegenereerd wanneer
System.Fabric.FabricObjectClosedException Het FabricClient-object heeft een gesloten status. Verwijder het FabricClient-object dat u gebruikt en instantieer een nieuw FabricClient-object .
System.TimeoutException Er is een time-out opgetreden voor de bewerking. OperationTimedOut wordt geretourneerd wanneer de bewerking meer dan MaxOperationTimeout nodig heeft om te voltooien.
System.UnauthorizedAccessException De toegangscontrole voor de bewerking is mislukt. E_ACCESSDENIED wordt geretourneerd.
System.Fabric.FabricException Er is een runtimefout opgetreden tijdens het uitvoeren van de bewerking. Een van de FabricClient-methoden kan FabricException mogelijk genereren. De eigenschap ErrorCode geeft de exacte oorzaak van de uitzondering aan. Foutcodes worden gedefinieerd in de opsomming FabricErrorCode .
System.Fabric.FabricTransientException De bewerking is mislukt vanwege een tijdelijke foutvoorwaarde van een bepaald type. Een bewerking kan bijvoorbeeld mislukken omdat een quorum met replica's tijdelijk niet bereikbaar is. Tijdelijke uitzonderingen komen overeen met mislukte bewerkingen die opnieuw kunnen worden geprobeerd.

Enkele veelvoorkomende FabricErrorCode-fouten die kunnen worden geretourneerd in een FabricException:

Error Conditie
CommunicationError Er is een communicatiefout opgetreden waardoor de bewerking is mislukt. Voer de bewerking opnieuw uit.
InvalidCredentialType Het referentietype is ongeldig.
InvalidX509FindType Het X509FindType is ongeldig.
InvalidX509StoreLocation De X509-winkellocatie is ongeldig.
InvalidX509StoreName De X509-winkelnaam is ongeldig.
InvalidX509Thumbprint De X509-certificaatvingerafdruktekenreeks is ongeldig.
InvalidProtectionLevel Het beveiligingsniveau is ongeldig.
InvalidX509Store Het X509-certificaatarchief kan niet worden geopend.
InvalidSubjectName De onderwerpnaam is ongeldig.
InvalidAllowedCommonNameList De indeling van de algemene naamlijsttekenreeks is ongeldig. Dit moet een door komma's gescheiden lijst zijn.