Batchstatus en foutcodes
REST API-bewerkingen voor de Batch-service retourneren standaard HTTP-statuscodes, zoals gedefinieerd in de HTTP/1.1-statuscodedefinities.
API-bewerkingen kunnen ook aanvullende foutinformatie retourneren om de ontwikkelaar meer informatie over de fout te geven. Het volgende foutantwoord geeft bijvoorbeeld aan dat een queryparameter die is opgegeven op de aanvraag-URI ongeldig is en biedt aanvullende informatie over de naam en waarde van de ongeldige parameter en de reden voor de fout.
{
"code": "InvalidQueryParameterValue",
"message": {
"lang": "en-us",
"value": "Value for one of the query parameters specified in the request URI is invalid"
},
"values": [{
"key": "QueryParameterName",
"value": "state"
}, {
"key": "QueryParameterValue",
"value": "deleted"
}, {
"key": "Reason",
"value": "invalid state"
}]
}
De volgende secties bevatten lijsten met foutcodes voor de Batch-service:
Veelvoorkomende REST API-foutcodes
De foutcodes in de volgende tabel kunnen worden geretourneerd door een bewerking in de Batch-service.
| Foutcode | HTTP-statuscode | Gebruikersbericht |
|---|---|---|
| ConditionNotMet | Niet gewijzigd (304) | Er is niet voldaan aan de voorwaarde die is opgegeven in de voorwaardelijke header(s) voor een leesbewerking. |
| MissingRequiredHeader | Ongeldige aanvraag (400) | Er is geen vereiste HTTP-header opgegeven. |
| MissingRequiredProperty | Ongeldige aanvraag (400) | Er is geen vereiste eigenschap opgegeven in de aanvraagtekst. |
| Niet-ondersteundeheader | Ongeldige aanvraag (400) | Een van de HTTP-headers die in de aanvraag zijn opgegeven, wordt niet ondersteund. |
| UnsupportedProperty | Ongeldige aanvraag (400) | Een van de eigenschappen die zijn opgegeven in de aanvraagtekst, wordt niet ondersteund. |
| InvalidHeaderValue | Ongeldige aanvraag (400) | De opgegeven waarde voor een van de HTTP-headers heeft niet de juiste indeling. |
| InvalidPropertyValue | Ongeldige aanvraag (400) | De opgegeven waarde voor een van de eigenschap in de hoofdtekst van de aanvraag is ongeldig. |
| MissingRequiredQueryParameter | Ongeldige aanvraag (400) | Er is geen vereiste queryparameter opgegeven voor deze aanvraag. |
| Niet-ondersteundeQueryParameter | Ongeldige aanvraag (400) | Een van de queryparameters die zijn opgegeven in de aanvraag-URI wordt niet ondersteund. |
| InvalidQueryParameterValue | Ongeldige aanvraag (400) | Er is een ongeldige waarde opgegeven voor een van de queryparameters in de aanvraag-URI. |
| OutOfRangeQueryParameterValue | Ongeldige aanvraag (400) | Een queryparameter die is opgegeven in de aanvraag-URI, valt buiten het toegestane bereik. |
| RequestUrlFailedToParse | Ongeldige aanvraag (400) | De URL in de aanvraag kan niet worden geparseerd. |
| InvalidUri | Ongeldige aanvraag (400) | De aangevraagde URI vertegenwoordigt geen resource op de server. |
| OngeldigHttpVerb | Ongeldige aanvraag (400) | Het opgegeven HTTP-werkwoord wordt niet herkend door de server. |
| EmptyMetadataKey | Ongeldige aanvraag (400) | De sleutel voor een van de sleutel-waardeparen met metagegevens is leeg. |
| InvalidRequestBody | Ongeldige aanvraag (400) | De opgegeven aanvraagbody is niet syntactisch geldig. |
| OutOfRangeInput | Ongeldige aanvraag (400) | Een van de aanvraaginvoer valt buiten het bereik. |
| InvalidAuthenticationInfo | Ongeldige aanvraag (400) | De verificatiegegevens zijn niet in de juiste indeling opgegeven. Controleer de waarde van autorisatieheader . |
| InvalidInput | Ongeldige aanvraag (400) | Een van de aanvraaginvoer is ongeldig. |
| InvalidMetadata | Ongeldige aanvraag (400) | De opgegeven metagegevens zijn ongeldig. Het bevat tekens die niet zijn toegestaan. |
| MetadataTooLarge | Ongeldige aanvraag (400) | De grootte van de opgegeven metagegevens overschrijdt de maximaal toegestane grootte. |
| MultipleConditionHeadersNotSupported | Ongeldige aanvraag (400) | Meerdere voorwaardeheaders worden niet ondersteund. |
| AuthenticationFailed | 403 (verboden) | De server kan de aanvraag niet verifiëren. Controleer of de waarde van autorisatieheader correct is opgemaakt en de handtekening bevat. |
| InsufficientAccountPermissions | 403 (verboden) | Het account dat wordt geopend, heeft onvoldoende machtigingen om deze bewerking uit te voeren. |
| AccountIsDisabled | 403 (verboden) | Het opgegeven account is uitgeschakeld. |
| ResourceNotFound | Niet gevonden (404) | De opgegeven resource bestaat niet. |
| Niet-ondersteundHttpVerb | Methode niet toegestaan (405) | De resource biedt geen ondersteuning voor het opgegeven HTTP-werkwoord. |
| MissingContentLengthHeader | Vereiste lengte (411) | De header Content-Length is niet opgegeven. |
| ConditionNotMet | Voorwaarde mislukt (412) | Er is niet voldaan aan de voorwaarde die is opgegeven in de voorwaardelijke header(s) voor een schrijfbewerking. |
| RequestBodyTooLarge | Aanvraagentiteit is te groot (413) | De grootte van de aanvraagbody overschrijdt de maximaal toegestane grootte. |
| InvalidRange | Aangevraagd bereik niet bevredigend (416) | Het opgegeven bereik is ongeldig voor de huidige grootte van de resource. |
| InternalError | Interne serverfout (500) | Er is een interne fout opgetreden op de server. Probeer de aanvraag opnieuw. |
| OperationTimedOut | Interne serverfout (500) | De bewerking kan niet binnen de toegestane tijd worden voltooid. |
| ServerBusy | Service niet beschikbaar (503) | De server kan momenteel geen aanvragen ontvangen. Probeer uw aanvraag opnieuw. |
Batch-servicefoutcodes
De foutcodes in de volgende tabel kunnen worden geretourneerd door een bewerking in de Batch-service.
| Foutcode | HTTP-statuscode | Gebruikersbericht |
|---|---|---|
| UnsupportedRequestVersion | BadRequest (400) | De opgegeven aanvraagversie wordt niet ondersteund. |
| InvalidAutoScalingSettings | BadRequest (400) | De opgegeven instellingen voor automatisch schalen zijn ongeldig. |
| AutoScalingFormulaSyntaxError | BadRequest (400) | De opgegeven formule voor automatisch schalen heeft een syntaxisfout. |
| AutoScalingFormulaTooLong | BadRequest (400) | De opgegeven formule voor automatisch schalen overschrijdt de lengtelimiet. |
| OSVersionNotFound | BadRequest (400) | De opgegeven versie van het besturingssysteem bestaat niet. |
| OSVersionDisabled | BadRequest (400) | De opgegeven versie van het besturingssysteem is uitgeschakeld. |
| OSVersionExpired | BadRequest (400) | De opgegeven versie van het besturingssysteem is verlopen. |
| PoolVersionEqualsUpgradeVersion | BadRequest (400) | De pool is al met de opgegeven versie. |
| PoolNotEligibleForOSVersionUpgrade | BadRequest (400) | De opgegeven pool komt niet in aanmerking voor een upgrade van de versie van het besturingssysteem. |
| PoolNotFound | NotFound (404) | De opgegeven groep bestaat niet. |
| NodeNotFound | NotFound (404) | Het opgegeven knooppunt bestaat niet. |
| JobScheduleNotFound | NotFound (404) | Het opgegeven taakschema bestaat niet. |
| JobNotFound | NotFound (404) | De opgegeven taak bestaat niet. |
| TaskNotFound | NotFound (404) | De opgegeven taak bestaat niet. |
| FileNotFound | NotFound (404) | Het opgegeven bestand bestaat niet. |
| NodeUserNotFound | NotFound (404) | De opgegeven knooppuntgebruiker bestaat niet. |
| CertificateNotFound | NotFound (404) | Het opgegeven certificaat bestaat niet. |
| JobPreparationTaskNotRunOnNode | NotFound (404) | De taak voor het voorbereiden van de taak is niet uitgevoerd op het opgegeven knooppunt. |
| JobReleaseTaskNotRunOnNode | NotFound (404) | De taak voor het vrijgeven van de taak is niet uitgevoerd op het opgegeven knooppunt. |
| NodeAgentSKUNotFound | NotFound (404) | De opgegeven knooppuntagent-SKU bestaat niet. |
| OperationInvalidForCurrentState | Conflict (409) | De opgegeven bewerking is niet geldig voor de huidige status van de resource. |
| PoolBeingDeleted | Conflict (409) | De opgegeven pool is gemarkeerd voor verwijdering en wordt opnieuw gebruikt. |
| PoolBeingResized | Conflict (409) | Het formaat van de opgegeven pool wordt gewijzigd |
| PoolBeingCreated | Conflict (409) | De opgegeven pool wordt gemaakt. |
| NodeBeingCreated | Conflict (409) | Het opgegeven knooppunt wordt gemaakt |
| NodeBeingStarted | Conflict (409) | Het opgegeven knooppunt wordt gestart |
| NodeBeingReimaged | Conflict (409) | Er wordt een nieuwe installatiekopie van het opgegeven knooppunt gemaakt |
| NodeBeingRebooted | Conflict (409) | Het opgegeven knooppunt wordt opnieuw opgestart |
| NodeStateUnusable | Conflict (409) | De status van het opgegeven knooppunt is onbruikbaar |
| JobScheduleBeingTerminated | Conflict (409) | Het opgegeven taakschema wordt beëindigd. |
| JobScheduleBeingDeleted | Conflict (409) | Het opgegeven taakschema is gemarkeerd voor verwijdering en wordt teruggevorderd. |
| CertificateBeingDeleted | Conflict (409) | Het opgegeven certificaat is gemarkeerd voor verwijdering en wordt verwijderd. |
| PoolExists | Conflict (409) | De opgegeven pool bestaat al. |
| JobScheduleExists | Conflict (409) | Het opgegeven taakschema bestaat al. |
| NodeUserExists | Conflict (409) | De opgegeven knooppuntgebruiker bestaat al. |
| JobExists | Conflict (409) | De opgegeven taak bestaat al. |
| NodeUserExists | Conflict (409) | De opgegeven knooppuntgebruiker bestaat al. |
| CertificateExists | Conflict (409) | Het opgegeven certificaat bestaat al. |
| JobScheduleDisabled | Conflict (409) | Het opgegeven taakschema is uitgeschakeld. |
| JobScheduleCompleted | Conflict (409) | Het opgegeven taakschema heeft al de status Voltooid. |
| JobBeingTerminated | Conflict (409) | De opgegeven taak wordt beëindigd. |
| JobBeingDeleted | Conflict (409) | De opgegeven taak is gemarkeerd voor verwijdering en wordt verwijderd. |
| JobDisabled | Conflict (409) | De opgegeven taak is uitgeschakeld. |
| JobCompleted | Conflict (409) | De opgegeven taak heeft al een voltooide status. |
| JobNotActive | Conflict (409) | De opgegeven taak is niet actief. |
| TaskExists | Conflict (409) | De opgegeven taak bestaat al. |
| TaskCompleted | Conflict (409) | De opgegeven taak heeft al een voltooide status. |
| TaskNotCompleted | Conflict (409) | De opgegeven taak heeft geen voltooide status en de aangevraagde bewerking kan alleen worden uitgevoerd op voltooide taken. |
| TaakSucceeded | Conflict (409) | De opgegeven taak is al voltooid en de aangevraagde bewerking kan niet worden uitgevoerd voor geslaagde taken. |
| TaskFilesUnavailable | Conflict (409) | De bestanden van de opgegeven taak zijn niet beschikbaar. |
| TaskFilesCleanedup | Conflict (409) | De bestanden van de opgegeven taak worden opgeschoond. |
| ActiveJobAndScheduleQuotaReached | Conflict (409) | Het quotum voor actieve taken en schema's voor het account is bereikt. |
| PoolQuotaReached | Conflict (409) | Het poolquotum voor het account is bereikt. |
| UpgradePoolVersionConflict | Conflict (409) | De pool is al aan het upgraden naar een andere versie. |
| JobPreparationTaskNotSpecified | Conflict (409) | De opgegeven taak heeft geen taakvoorbereidingstaak. |
| JobReleaseTaskNotSpecified | Conflict (409) | De opgegeven taak heeft geen taakreleasetaak. |
| TaskIdSameAsJobPreparationTask | Conflict (409) | De opgegeven taak-id is hetzelfde als de taakvoorbereidingstaak. |
| TaskIdSameAsJobReleaseTask | Conflict (409) | De opgegeven taak-id is hetzelfde als de taakreleasetaak. |
| JobWithSameIdExists | Conflict (409) | Er bestaat een taak met de opgegeven taakplannings-id. Taak en taakplanning kunnen niet dezelfde id hebben. |
| JobScheduleWithSameIdExists | Conflict (409) | Er bestaat een taakplanning met de opgegeven taak-id. Taak en taakplanning kunnen niet dezelfde id hebben. |
| NodeAlreadyInTargetSchedulingState | Conflict (409) | Het opgegeven knooppunt bevindt zich al in de doelplanningsstatus. |
| OperationNotValidOnNode | Conflict (409) | De opgegeven bewerking is niet geldig op het knooppunt. |
| OperationNotValidOnPool | Conflict (409) | De opgegeven bewerking is niet geldig voor de groep. |
| IOError | 403 (verboden) | Er is een I/O-fout opgetreden bij het openen van de opgegeven resource. |
| TooManyEnableAutoScaleRequests | ServiceUnavailable (503) | Er worden te veel aanvragen voor Automatische schaalaanpassing van groepen inschakelen uitgegeven voor de groep. |
| ApplicationNotFound | Niet gevonden (404) | De opgegeven toepassing bestaat niet. |
| InvalidApplicationPackageReferences | Conflict (409) | Aan een of meer toepassingspakketverwijzingen kan niet worden voldaan. Dit gebeurt als de toepassings-id of -versie niet bestaat of niet actief is, of als de verwijzing geen versie heeft opgegeven en er geen standaardversie is geconfigureerd. |
| TaskDependenciesNotSpecifiedOnJob | Ongeldige aanvraag (400) | Een taak is opgegeven als afhankelijk van andere taken, maar de taak heeft niet opgegeven dat deze taakafhankelijkheden zou gebruiken. |
| TaskDependencyListTooLong | Ongeldige aanvraag (400) | Een taak is opgegeven als afhankelijk van andere taken, maar de lijst met afhankelijkheden was te lang om te worden opgeslagen. De totale opgeslagen lengte is beperkt tot 64000 tekens; de totale lengte van taak-id's moet iets kleiner zijn dan deze om interne opslagoverhead mogelijk te maken. Als deze fout optreedt, kunt u in plaats daarvan afhankelijkheden van taakbereiken gebruiken. |
| TaskDependencyRangesTooLong | Ongeldige aanvraag (400) | Een taak is opgegeven als afhankelijk van meerdere bereiken met taak-id's en de lijst met bereiken was te lang om te worden opgeslagen. Houd er rekening mee dat het probleem niet te maken heeft met de grootte van bereiken, maar met het aantal bereiken. |
Foutcodes voor taak-/taakplanning
Als er een fout optreedt in de Batch-service bij het starten van een taak op een knooppunt, wordt de taak gemarkeerd als voltooid. De foutinformatie wordt geretourneerd binnen een failureInfo element in de antwoordtekst van De bestanden weergeven die zijn gekoppeld aan een taak en Informatie over een taak-API's ophalen.
Als de Batch-service een fout tegenkomt tijdens het starten van de taak, wordt de taak ook gemarkeerd als voltooid. Deze planningsfoutgegevens worden geretourneerd binnen een schedulingError element in de antwoordtekst van Informatie over een taak ophalen in Batch-API's .
De volgende tabel bevat de lijst met categorieën voor taakplanningsfouten.
| Categorie | Beschrijving |
|---|---|
| UserError | Fouten in de taakspecificatie die door de gebruiker is opgegeven. |
| ServerError | Fouten die zijn aangetroffen door de Batch-service waardoor de taak niet kan worden gepland. |
Hieronder ziet u een voorbeeld van een voorverwerkingsfout die is geretourneerd door de Batch-service.
{
"preProcessingError": {
"category": "UserError",
"code": "BlobNotFound",
"message": "The specified blob does not exist.",
"values": {
"name": "FilePath",
"value": "myfile.txt"
}
}
}
De volgende tabel bevat de lijst met foutcodes voor taakplanning die kunnen worden geretourneerd door de Batch-service.
| Foutcode | Categorie | Gebruikersbericht |
|---|---|---|
| InvalidCertificatesInAutoPool | UserError | De opgegeven certificaatverwijzingen in de specificatie van de automatische groep zijn niet geldig. |
| AutoPoolCreationFailedWithQuotaReached | UserError | Het poolquotum voor het account is bereikt. |
| InvalidApplicationPackageReferencesInAutoPool | UserError | Een of meer toepassingspakketten die zijn opgegeven voor de groep, zijn ongeldig. |
| InvalidAutoScaleFormulaInAutoPool | UserError | De opgegeven instellingen voor automatisch schalen zijn ongeldig. |
| InvalidAutoPoolSettings | UserError | De opgegeven autopoolinstellingen zijn niet geldig. |
| JobBeingTerminated | UserError | De taak kan niet worden gestart omdat de bijbehorende taak wordt beëindigd. |
| Onbekend | ServerError | Er is een onbekende planningsfout opgetreden. |
De volgende tabel bevat de lijst met foutcodes voor taakplanning die kunnen worden geretourneerd door de Batch-service.
| Foutcode | Categorie | Gebruikersbericht |
|---|---|---|
| BlobNotFound | UserError | Een van de opgegeven Azure Blob(s) is niet gevonden. |
| BlobAccessDenied | UserError | Toegang voor een van de opgegeven Azure Blob(s) is geweigerd. |
| BlobDownloadTimedOut | ServerError | Er is een time-out opgetreden tijdens het downloaden van een van de opgegeven Azure Blob(s). |
| BlobDownloadMiscError | ServerError | Diverse fout opgetreden tijdens het downloaden van een van de opgegeven Azure Blob(s). |
| ResourceDirectoryCreateFailed | ServerError | Er is een fout opgetreden bij het maken van de resourcemap voor de taak. |
| ResourceFileCreateFailed | ServerError | Er is een fout opgetreden bij het maken van het resourcebestand. |
| ResourceFileWriteFailed | ServerError | Er is een fout opgetreden bij het schrijven van het resourcebestand. |
| CommandProgramNotFound | UserError | Het opgegeven opdrachtprogramma is niet gevonden. |
| CommandLaunchFailed | UserError | Kan de opgegeven opdrachtregel niet starten. |
| TaskEnded | UserError | De taak is beëindigd door een gebruikersaanvraag. |
| MaxInternalRetryCountReached | UserError | De opgegeven taak heeft het maximale aantal interne nieuwe pogingen bereikt. |
| TaskSchedulingConstraintFailed | UserError | De taak kan niet worden gepland voor de pool die aan de taak is gekoppeld |
| DiskFull | ServerError | Er is onvoldoende schijfruimte op het knooppunt dat is geselecteerd om de taak uit te voeren. |
| Onbekend | ServerError | Er is een onbekende planningsfout opgetreden. |