Batchstatus och felkoder
REST API-åtgärder för Batch-tjänsten returnerar standard-HTTP-statuskoder, enligt definitionen i HTTP/1.1-statuskoddefinitionerna.
API-åtgärder kan också returnera ytterligare felinformation för att ge utvecklaren mer information om felet. Följande felsvar anger till exempel att en frågeparameter som angetts på begärande-URI:n var ogiltig och innehåller ytterligare information om den ogiltiga parameterns namn och värde samt orsaken till felet.
{
"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"
}]
}
Följande avsnitt innehåller en lista över felkoder för Batch-tjänsten:
Vanliga REST API-felkoder
Felkoderna som anges i följande tabell kan returneras av en åtgärd i Batch-tjänsten.
| Felkod | HTTP-statuskod | Användarmeddelande |
|---|---|---|
| ConditionNotMet | Inte ändrad (304) | Villkoret som angavs i villkorsrubrikerna uppfylldes inte för en läsåtgärd. |
| MissingRequiredHeader | Felaktig begäran (400) | Ett obligatoriskt HTTP-huvud angavs inte. |
| MissingRequiredProperty | Felaktig begäran (400) | En obligatorisk egenskap angavs inte i begärandetexten. |
| Header stöds inte | Felaktig begäran (400) | Ett av DE HTTP-huvuden som anges i begäran stöds inte. |
| Property stöds inte | Felaktig begäran (400) | En av egenskaperna som anges i begärandetexten stöds inte. |
| InvalidHeaderValue | Felaktig begäran (400) | Värdet som angavs för en av HTTP-huvudena var inte i rätt format. |
| InvalidPropertyValue | Felaktig begäran (400) | Värdet för en av egenskapen i begärandetexten är ogiltigt. |
| MissingRequiredQueryParameter | Felaktig begäran (400) | En obligatorisk frågeparameter angavs inte för den här begäran. |
| QueryParameter stöds inte | Felaktig begäran (400) | En av frågeparametrarna som anges i begärande-URI:n stöds inte. |
| InvalidQueryParameterValue | Felaktig begäran (400) | Ett ogiltigt värde angavs för en av frågeparametrarna i begärande-URI:n. |
| OutOfRangeQueryParameterValue | Felaktig begäran (400) | En frågeparameter som anges i begärande-URI:n ligger utanför det tillåtna intervallet. |
| RequestUrlFailedToParse | Felaktig begäran (400) | Det gick inte att parsa URL:en i begäran. |
| InvalidUri | Felaktig begäran (400) | Den begärda URI:n representerar inte någon resurs på servern. |
| InvalidHttpVerb | Felaktig begäran (400) | Det angivna HTTP-verbet kändes inte igen av servern. |
| EmptyMetadataKey | Felaktig begäran (400) | Nyckeln för ett av nyckel/värde-paren för metadata är tom. |
| InvalidRequestBody | Felaktig begäran (400) | Den angivna begärandetexten är inte syntaktiskt giltig. |
| OutOfRangeInput | Felaktig begäran (400) | En av begärandeindata ligger inom intervallet. |
| InvalidAuthenticationInfo | Felaktig begäran (400) | Autentiseringsinformationen angavs inte i rätt format. Kontrollera värdet för auktoriseringshuvud . |
| InvalidInput | Felaktig begäran (400) | En av begärandeindata är inte giltig. |
| InvalidMetadata | Felaktig begäran (400) | Angivna metadata är ogiltiga. Den innehåller tecken som inte är tillåtna. |
| MetadataTooLarge | Felaktig begäran (400) | Storleken på angivna metadata överskrider den maximala tillåtna storleken. |
| MultipleConditionHeadersNotSupported | Felaktig begäran (400) | Flera villkorsrubriker stöds inte. |
| AuthenticationFailed | Förbjudet (403) | Servern kunde inte autentisera begäran. Kontrollera att värdet för auktoriseringshuvudet har formats korrekt och innehåller signaturen. |
| InsufficientAccountPermissions | Förbjudet (403) | Kontot som används har inte tillräcklig behörighet för att köra den här åtgärden. |
| AccountIsDisabled | Förbjudet (403) | Det angivna kontot är inaktiverat. |
| ResourceNotFound | Hittades inte (404) | Den angivna resursen finns inte. |
| HttpVerb stöds inte | Metoden tillåts inte (405) | Resursen stöder inte det angivna HTTP-verbet. |
| MissingContentLengthHeader | Längd krävs (411) | Rubriken Innehållslängd har inte angetts. |
| ConditionNotMet | Villkoret misslyckades (412) | Villkoret som angavs i villkorsrubrikerna uppfylldes inte för en skrivåtgärd. |
| RequestBodyTooLarge | Begärandeentiteten är för stor (413) | Storleken på begärandetexten överskrider den maximala tillåtna storleken. |
| InvalidRange | Begärt intervall kan inte uppfyllas (416) | Det angivna intervallet är ogiltigt för resursens aktuella storlek. |
| InternalError | Internt serverfel (500) | Servern påträffade ett internt fel. Försök igen. |
| OperationTimedOut | Internt serverfel (500) | Det gick inte att slutföra åtgärden inom den tillåtna tiden. |
| ServerBusy | Tjänsten är inte tillgänglig (503) | Servern kan för närvarande inte ta emot begäranden. Försök igen. |
Batch Service-felkoder
Felkoderna som anges i följande tabell kan returneras av en åtgärd i Batch-tjänsten.
| Felkod | HTTP-statuskod | Användarmeddelande |
|---|---|---|
| UnsupportedRequestVersion | BadRequest (400) | Den angivna versionen av begäran stöds inte. |
| InvalidAutoScalingSettings | BadRequest (400) | De angivna inställningarna för automatisk skalning är inte giltiga. |
| AutoScalingFormulaSyntaxError | BadRequest (400) | Den angivna formeln för automatisk skalning har ett syntaxfel. |
| AutoSkalningFormulaTooLong | BadRequest (400) | Den angivna formeln för automatisk skalning överskrider längdgränsen. |
| OSVersionNotFound | BadRequest (400) | Den angivna operativsystemversionen finns inte. |
| OSVersionDisabled | BadRequest (400) | Den angivna operativsystemversionen är inaktiverad. |
| OSVersionExpired | BadRequest (400) | Den angivna operativsystemversionen har upphört att gälla. |
| PoolVersionEqualsUpgradeVersion | BadRequest (400) | Poolen är redan med den angivna versionen. |
| PoolNotEligibleForOSVersionUpgrade | BadRequest (400) | Den angivna poolen är inte berättigad till uppgradering av operativsystemversion. |
| PoolNotFound | NotFound (404) | Den angivna poolen finns inte. |
| NodeNotFound | NotFound (404) | Den angivna noden finns inte. |
| JobScheduleNotFound | NotFound (404) | Det angivna jobbschemat finns inte. |
| JobNotFound | NotFound (404) | Det angivna jobbet finns inte. |
| TaskNotFound | NotFound (404) | Den angivna aktiviteten finns inte. |
| FileNotFound | NotFound (404) | Den angivna filen finns inte. |
| NodeUserNotFound | NotFound (404) | Den angivna nodanvändaren finns inte. |
| CertificateNotFound | NotFound (404) | Det angivna certifikatet finns inte. |
| JobPreparationTaskNotRunOnNode | NotFound (404) | Jobbförberedelseaktiviteten kördes inte på den angivna noden. |
| JobReleaseTaskNotRunOnNode | NotFound (404) | Jobblanseringsaktiviteten kördes inte på den angivna noden. |
| NodeAgentSKUNotFound | NotFound (404) | Den angivna Node Agent-SKU:n finns inte. |
| OperationInvalidForCurrentState | Konflikt (409) | Den angivna åtgärden är inte giltig för resursens aktuella tillstånd. |
| PoolBeingDeleted | Konflikt (409) | Den angivna poolen har markerats för borttagning och håller på att återtas. |
| PoolBeingResized | Konflikt (409) | Den angivna poolen ändras |
| PoolBeingSkapad | Konflikt (409) | Den angivna poolen skapas. |
| NodeBeingSkapad | Konflikt (409) | Den angivna noden skapas |
| NodeBeingStarted | Konflikt (409) | Den angivna noden startas |
| NodeBeingReimaged | Konflikt (409) | Den angivna noden återskapas |
| NodeBeingRebooted | Konflikt (409) | Den angivna noden startas om |
| NodeStateUnusable | Konflikt (409) | Den angivna nodens tillstånd är oanvändbart |
| JobScheduleBeingTerminated | Konflikt (409) | Det angivna jobbschemat avslutas. |
| JobScheduleBeingDeleted | Konflikt (409) | Det angivna jobbschemat har markerats för borttagning och håller på att återtas. |
| CertificateBeingDeleted | Konflikt (409) | Det angivna certifikatet har markerats för borttagning och tas bort. |
| PoolExists | Konflikt (409) | Den angivna poolen finns redan. |
| JobScheduleExists | Konflikt (409) | Det angivna jobbschemat finns redan. |
| NodeUserExists | Konflikt (409) | Den angivna nodanvändaren finns redan. |
| JobExists | Konflikt (409) | Det angivna jobbet finns redan. |
| NodeUserExists | Konflikt (409) | Den angivna nodanvändaren finns redan. |
| CertificateExists | Konflikt (409) | Det angivna certifikatet finns redan. |
| JobScheduleDisabled | Konflikt (409) | Det angivna jobbschemat är inaktiverat. |
| JobScheduleCompleted | Konflikt (409) | Det angivna jobbschemat är redan i slutfört tillstånd. |
| JobBeingTerminated | Konflikt (409) | Det angivna jobbet avslutas. |
| JobBeingDeleted | Konflikt (409) | Det angivna jobbet har markerats för borttagning och skräp samlas in. |
| JobDisabled | Konflikt (409) | Det angivna jobbet är inaktiverat. |
| JobCompleted | Konflikt (409) | Det angivna jobbet är redan i ett slutfört tillstånd. |
| JobNotActive | Konflikt (409) | Det angivna jobbet är inte i aktivt tillstånd. |
| TaskExists | Konflikt (409) | Den angivna aktiviteten finns redan. |
| TaskCompleted | Konflikt (409) | Den angivna aktiviteten är redan i ett slutfört tillstånd. |
| TaskNotCompleted | Konflikt (409) | Den angivna aktiviteten är inte i slutfört tillstånd och den begärda åtgärden kan endast utföras på slutförda aktiviteter. |
| TaskSucceeded | Konflikt (409) | Den angivna aktiviteten har redan slutförts och den begärda åtgärden kan inte utföras för lyckade aktiviteter. |
| TaskFilesUnavailable | Konflikt (409) | Filerna för den angivna aktiviteten är inte tillgängliga. |
| TaskFilesCleanedup | Konflikt (409) | Filerna för den angivna aktiviteten rensas. |
| ActiveJobAndScheduleQuotaReached | Konflikt (409) | Aktivt jobb och schemakvot för kontot har uppnåtts. |
| PoolQuotaReached | Konflikt (409) | Poolkvoten för kontot har uppnåtts. |
| UpgradePoolVersionConflict | Konflikt (409) | Poolen uppgraderar redan till en annan version. |
| JobPreparationTaskNotSpecified | Konflikt (409) | Det angivna jobbet har ingen jobbförberedelseaktivitet. |
| JobReleaseTaskNotSpecified | Konflikt (409) | Det angivna jobbet har ingen jobbpubliceringsaktivitet. |
| TaskIdSameAsJobPreparationTask | Konflikt (409) | Det angivna aktivitets-ID:t är samma som jobbförberedelseaktiviteten. |
| TaskIdSameAsJobReleaseTask | Konflikt (409) | Det angivna aktivitets-ID:t är samma som jobbpubliceringsaktiviteten. |
| JobWithSameIdExists | Konflikt (409) | Det finns ett jobb med det angivna jobbschema-ID:t. Jobb- och jobbschemat kan inte ha samma ID. |
| JobScheduleWithSameIdExists | Konflikt (409) | Det finns ett jobbschema med det angivna jobb-ID:t. Jobb- och jobbschemat kan inte ha samma ID. |
| NodeAlreadyInTargetSchedulingState | Konflikt (409) | Den angivna noden är redan i målschemaläggningstillståndet. |
| OperationNotValidOnNode | Konflikt (409) | Den angivna åtgärden är inte giltig på noden. |
| OperationNotValidOnPool | Konflikt (409) | Den angivna åtgärden är inte giltig i poolen. |
| IOError | Förbjudet (403) | Ett I/O-fel uppstod vid åtkomst till den angivna resursen. |
| TooManyEnableAutoScaleRequests | ServiceUnavailable (503) | För många Begäranden om automatisk skalning av pooler utfärdas i poolen. |
| ApplicationNotFound | Hittades inte (404) | Det angivna programmet finns inte. |
| InvalidApplicationPackageReferences | Konflikt (409) | Det gick inte att uppfylla en eller flera programpaketreferenser. Detta inträffar om program-ID:t eller versionen inte finns eller inte är aktiv, eller om referensen inte har angett någon version och ingen standardversion har konfigurerats. |
| TaskDependenciesNotSpecifiedOnJob | Felaktig begäran (400) | En aktivitet angavs som beroende på andra aktiviteter, men jobbet angav inte att den skulle använda aktivitetsberoenden. |
| TaskDependencyListTooLong | Felaktig begäran (400) | En aktivitet angavs som beroende av andra aktiviteter, men listan över beroenden var för lång för att lagras. Den totala lagrade längden är begränsad till 64 000 tecken. Den totala längden på aktivitets-ID:t måste vara något mindre än så för att det ska gå att hantera interna lagringskostnader. Om det här felet uppstår bör du överväga att använda beroenden för aktivitetsintervall i stället. |
| TaskDependencyRangesTooLong | Felaktig begäran (400) | En aktivitet angavs som beroende på flera intervall av aktivitets-ID:t och listan över intervall var för lång för att lagras. Observera att problemet inte gäller storleken på intervallen, utan med antalet intervall. |
Felkoder för jobb/aktivitetsschemaläggning
Om Batch-tjänsten får ett fel när en aktivitet startas på en nod markeras uppgiften som slutförd. Felinformationen returneras i ett failureInfo element i svarstexten i Lista de filer som är associerade med en uppgift och Hämta information om en uppgifts-API :er.
Om Batch-tjänsten påträffar ett fel när jobbet startas markeras jobbet som slutfört. Den här informationen om schemaläggningsfel returneras i ett schedulingError element i svarstexten i Hämta information om ett jobb i Batch-API :er.
Följande tabell innehåller en lista över kategorier för aktivitetsschemaläggningsfel.
| Kategori | Beskrivning |
|---|---|
| UserError | Fel i uppgiftsspecifikationen som tillhandahålls av användaren. |
| ServerError | Fel som påträffas av Batch-tjänsten som hindrar den från att schemalägga aktiviteten. |
Nedan visas ett exempel på ett förbearbetningsfel som returneras av Batch-tjänsten.
{
"preProcessingError": {
"category": "UserError",
"code": "BlobNotFound",
"message": "The specified blob does not exist.",
"values": {
"name": "FilePath",
"value": "myfile.txt"
}
}
}
Följande tabell innehåller en lista över felkoder för jobbschemaläggning som kan returneras av Batch-tjänsten.
| Felkod | Kategori | Användarmeddelande |
|---|---|---|
| InvalidCertificatesInAutoPool | UserError | De angivna certifikatreferenserna i specifikationen för den automatiska poolen är inte giltiga. |
| AutoPoolCreationFailedWithQuotaReached | UserError | Poolkvoten för kontot har uppnåtts. |
| InvalidApplicationPackageReferencesInAutoPool | UserError | Ett eller flera programpaket som har angetts för poolen är ogiltiga. |
| InvalidAutoScaleFormulaInAutoPool | UserError | De angivna inställningarna för automatisk skalning är ogiltiga. |
| InvalidAutoPoolSettings | UserError | De angivna inställningarna för automatisk pool är inte giltiga. |
| JobBeingTerminated | UserError | Det går inte att starta aktiviteten eftersom det associerade jobbet avslutas. |
| Okänt | ServerError | Ett okänt schemaläggningsfel har inträffat. |
Följande tabell innehåller en lista över felkoder för aktivitetsschemaläggning som kan returneras av Batch-tjänsten.
| Felkod | Kategori | Användarmeddelande |
|---|---|---|
| BlobNotFound | UserError | En av de angivna Azure-blobarna hittades inte. |
| BlobAccessDenied | UserError | Åtkomst för någon av de angivna Azure-blobarna nekas. |
| BlobDownloadTimedOut | ServerError | Timeout påträffades vid nedladdning av en av de angivna Azure-blobarna. |
| BlobDownloadMiscError | ServerError | Ett diverse fel påträffades vid nedladdning av en av de angivna Azure-blobarna. |
| ResourceDirectoryCreateFailed | ServerError | Det gick inte att skapa resurskatalogen för aktiviteten. |
| ResourceFileCreateFailed | ServerError | Det gick inte att skapa resursfilen. |
| ResourceFileWriteFailed | ServerError | Det gick inte att skriva resursfilen. |
| CommandProgramNotFound | UserError | Det angivna kommandoprogrammet hittades inte. |
| CommandLaunchFailed | UserError | Det gick inte att starta den angivna kommandoraden. |
| Aktivitet tillagd | UserError | Uppgiften avslutades av användarbegäran. |
| MaxInternalRetryCountReached | UserError | Den angivna aktiviteten har nått maximalt antal interna återförsök. |
| TaskSchedulingConstraintFailed | UserError | Det går inte att schemalägga aktiviteten i poolen som är associerad med jobbet |
| DiskFull | ServerError | Det finns inte tillräckligt med diskutrymme på noden som har valts för att köra aktiviteten. |
| Okänt | ServerError | Ett okänt schemaläggningsfel har inträffat. |