Stav dávky a kódy chyb
Operace rozhraní REST API pro službu Batch vrací standardní stavové kódy HTTP, jak jsou definovány v definicích stavových kódů HTTP/1.1.
Operace rozhraní API můžou také vrátit další informace o chybě, aby vývojáři poskytly další informace o chybě. Například následující chybová odpověď indikuje, že parametr dotazu zadaný v identifikátoru URI požadavku byl neplatný, a poskytuje další informace o názvu a hodnotě neplatného parametru a důvodu chyby.
{
"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"
}]
}
Následující části obsahují seznam kódů chyb pro službu Batch:
Běžné kódy chyb rozhraní REST API
Kódy chyb uvedené v následující tabulce může vrátit operace ve službě Batch.
| Kód chyby | Stavový kód HTTP | Zpráva uživatele |
|---|---|---|
| PodmínkaNotMet | Beze změny (304) | Podmínka zadaná v podmíněných hlavičkách nebyla splněna pro operaci čtení. |
| MissingRequiredHeader | Chybný požadavek (400) | Nebyla zadána požadovaná hlavička PROTOKOLU HTTP. |
| MissingRequiredProperty | Chybný požadavek (400) | V textu požadavku nebyla zadána požadovaná vlastnost. |
| Nepodporovaná hlavička | Chybný požadavek (400) | Jedna z hlaviček HTTP zadaných v požadavku se nepodporuje. |
| Nepodporovaná vlastnost | Chybný požadavek (400) | Jedna z vlastností zadaných v textu požadavku není podporována. |
| InvalidHeaderValue | Chybný požadavek (400) | Hodnota zadaná pro jednu z hlaviček HTTP nebyla ve správném formátu. |
| InvalidPropertyValue | Chybný požadavek (400) | Hodnota zadaná pro jednu z vlastností v textu požadavku je neplatná. |
| MissingRequiredQueryParameter | Chybný požadavek (400) | Pro tento požadavek nebyl zadán požadovaný parametr dotazu. |
| UnsupportedQueryParameter | Chybný požadavek (400) | Jeden z parametrů dotazu zadaný v identifikátoru URI požadavku se nepodporuje. |
| InvalidQueryParameterValue | Chybný požadavek (400) | Pro jeden z parametrů dotazu v identifikátoru URI požadavku byla zadána neplatná hodnota. |
| OutOfRangeQueryParameterValue | Chybný požadavek (400) | Parametr dotazu zadaný v identifikátoru URI požadavku je mimo povolený rozsah. |
| RequestUrlFailedToParse | Chybný požadavek (400) | Adresu URL v požadavku nelze analyzovat. |
| Neplatný identifikátor | Chybný požadavek (400) | Požadovaný identifikátor URI nepředstavuje žádný prostředek na serveru. |
| NeplatnýhttpVerb | Chybný požadavek (400) | Server nerozpoznal zadaný příkaz HTTP. |
| EmptyMetadataKey | Chybný požadavek (400) | Klíč pro jeden z párů klíč-hodnota metadat je prázdný. |
| InvalidRequestBody | Chybný požadavek (400) | Zadaný text požadavku není syntakticky platný. |
| OutOfRangeInput | Chybný požadavek (400) | Jeden ze vstupů požadavku je mimo rozsah. |
| InvalidAuthenticationInfo | Chybný požadavek (400) | Ověřovací informace nebyly zadány ve správném formátu. Ověřte hodnotu hlavičky Authorization . |
| Neplatný přistup | Chybný požadavek (400) | Jeden ze vstupů požadavku není platný. |
| InvalidMetadata | Chybný požadavek (400) | Zadaná metadata jsou neplatná. Obsahuje nepovolené znaky. |
| MetadataTooLarge | Chybný požadavek (400) | Velikost zadaných metadat překračuje maximální povolenou velikost. |
| MultipleConditionHeadersNotSupported | Chybný požadavek (400) | Více hlaviček podmínek není podporováno. |
| AuthenticationFailed | Zakázáno (403) | Serveru se nepodařilo požadavek ověřit. Ověřte, že hodnota hlavičky Authorization je správně vytvořená a obsahuje podpis. |
| InsufficientAccountPermissions | Zakázáno (403) | Účet, ke kterým přistupujete, nemá dostatečná oprávnění k provedení této operace. |
| AccountIsDisabled | Zakázáno (403) | Zadaný účet je zakázaný. |
| ResourceNotFound | Nenalezena (404) | Zadaný prostředek neexistuje. |
| NepodporovanéHttpVerb | Metoda není povolena (405) | Prostředek nepodporuje zadaný příkaz HTTP. |
| MissingContentLengthHeader | Požadovaná délka (411) | Hlavička Content-Length nebyla zadána. |
| PodmínkaNotMet | Předběžná podmínka se nezdařila (412) | Podmínka zadaná v podmíněných hlavičkách nebyla splněna pro operaci zápisu. |
| RequestBodyTooLarge | Příliš velká entita požadavku (413) | Velikost textu požadavku překračuje maximální povolenou velikost. |
| Neplatná velikost | Požadovaný rozsah není uspokojitelný (416) | Zadaný rozsah není pro aktuální velikost prostředku platný. |
| InternalError | Vnitřní chyba serveru (500) | Na serveru došlo k vnitřní chybě. Zkuste požadavek zopakovat. |
| OperationTimedOut | Vnitřní chyba serveru (500) | Operaci nelze dokončit v povoleném čase. |
| ServerOvá sběrnice | Služba není k dispozici (503) | Server momentálně nemůže přijímat požadavky. Zkuste prosím žádost zopakovat. |
Kódy chyb služby Batch
Kódy chyb uvedené v následující tabulce může vrátit operace ve službě Batch.
| Kód chyby | Stavový kód HTTP | Zpráva uživatele |
|---|---|---|
| UnsupportedRequestVersion | BadRequest (400) | Zadaná verze požadavku není podporovaná. |
| InvalidAutoScalingSettings | BadRequest (400) | Zadané nastavení automatického škálování není platné. |
| AutoScalingFormulaSyntaxError | BadRequest (400) | Zadaný vzorec automatického škálování obsahuje chybu syntaxe. |
| AutoScalingFormulaTooLong | BadRequest (400) | Zadaný vzorec automatického škálování překračuje limit délek. |
| OSVersionNotFound | BadRequest (400) | Zadaná verze operačního systému neexistuje. |
| OSVersionDisabled | BadRequest (400) | Zadaná verze operačního systému je zakázaná. |
| OSVersionExpired | BadRequest (400) | Zadaná verze operačního systému vypršela. |
| PoolVersionEqualsUpgradeVersion | BadRequest (400) | Fond je již s danou verzí. |
| PoolNotEligibleForOSVersionUpgrade | BadRequest (400) | Zadaný fond nemá nárok na upgrade verze operačního systému. |
| PoolNotFound | Nenalezeno (404) | Zadaný fond neexistuje. |
| Uzel nenalezeno | Nenalezeno (404) | Zadaný uzel neexistuje. |
| ÚlohaScheduleNotFound | Nenalezeno (404) | Zadaný plán úloh neexistuje. |
| Úloha se nenalezla | Nenalezeno (404) | Zadaná úloha neexistuje. |
| TaskNotFound | Nenalezeno (404) | Zadaný úkol neexistuje. |
| Soubor se nenalezl | Nenalezeno (404) | Zadaný soubor neexistuje. |
| NodeUserNotFound | Nenalezeno (404) | Zadaný uživatel uzlu neexistuje. |
| Certifikát se nenalezl | Nenalezeno (404) | Zadaný certifikát neexistuje. |
| ÚlohaPreparationTaskNotRunOnNode | Nenalezeno (404) | Úkol přípravy úlohy nebyl spuštěn na zadaném uzlu. |
| JobReleaseTaskNotRunOnNode | Nenalezeno (404) | Úloha uvolnění úlohy nebyla spuštěna na zadaném uzlu. |
| NodeAgentSKUNotFound | Nenalezeno (404) | Zadaná skladová položka agenta uzlu neexistuje. |
| OperationInvalidForCurrentState | Konflikt (409) | Zadaná operace není platná pro aktuální stav prostředku. |
| PoolBeingDeleted | Konflikt (409) | Zadaný fond byl označen k odstranění a je uvolněn. |
| PoolBeingResized | Konflikt (409) | Probíhá změna velikosti zadaného fondu. |
| PoolBeingCreated | Konflikt (409) | Probíhá vytváření zadaného fondu. |
| NodeBeingCreated | Konflikt (409) | Probíhá vytváření zadaného uzlu. |
| NodeBeingStarted | Konflikt (409) | Zadaný uzel se spouští. |
| NodeBeingReimaged | Konflikt (409) | Probíhá obnovení image zadaného uzlu. |
| NodeBeingRebooted | Konflikt (409) | Zadaný uzel se restartuje. |
| NodeStateUnusable | Konflikt (409) | Stav zadaného uzlu je nepoužitelný. |
| ÚlohaScheduleBeingTerminated | Konflikt (409) | Zadaný plán úloh se ukončuje. |
| JobScheduleBeingDeleted | Konflikt (409) | Zadaný plán úloh byl označen k odstranění a je uvolněn. |
| CertificateBeingDeleted | Konflikt (409) | Zadaný certifikát byl označen k odstranění a právě se odstraňuje. |
| PoolExists | Konflikt (409) | Zadaný fond již existuje. |
| JobScheduleExists | Konflikt (409) | Zadaný plán úlohy již existuje. |
| NodeUserExists | Konflikt (409) | Zadaný uživatel uzlu již existuje. |
| JobExists | Konflikt (409) | Zadaná úloha již existuje. |
| NodeUserExists | Konflikt (409) | Zadaný uživatel uzlu již existuje. |
| CertificateExists | Konflikt (409) | Zadaný certifikát již existuje. |
| ÚlohaScheduleDisabled | Konflikt (409) | Zadaný plán úloh je zakázán. |
| ÚlohaScheduleCompleted | Konflikt (409) | Zadaný plán úloh je již v dokončeném stavu. |
| JobBeingTerminated | Konflikt (409) | Zadaná úloha se ukončuje. |
| JobBeingDeleted | Konflikt (409) | Zadaná úloha byla označena k odstranění a probíhá uvolňování paměti. |
| JobDisabled | Konflikt (409) | Zadaná úloha je zakázaná. |
| ÚlohaCompleted | Konflikt (409) | Zadaná úloha je již v dokončeném stavu. |
| ÚlohaNotActive | Konflikt (409) | Zadaná úloha není v aktivním stavu. |
| TaskExists | Konflikt (409) | Zadaný úkol již existuje. |
| TaskCompleted | Konflikt (409) | Zadaný úkol je již v dokončeném stavu. |
| TaskNotCompleted | Konflikt (409) | Zadaný úkol není v dokončeném stavu a požadovanou operaci lze provést pouze u dokončených úkolů. |
| ÚlohaSucceeded | Konflikt (409) | Zadaný úkol již byl úspěšně dokončen a požadovanou operaci nelze provést u úspěšných úloh. |
| TaskFilesUnavailable | Konflikt (409) | Soubory zadané úlohy nejsou k dispozici. |
| TaskFilesCleanedup | Konflikt (409) | Soubory zadané úlohy se vyčistí. |
| ActiveJobAndScheduleQuotaReached | Konflikt (409) | Došlo k dosažení aktivní kvóty úlohy a plánu pro účet. |
| BazénQuotaReached | Konflikt (409) | Došlo k dosažení kvóty fondu pro účet. |
| UpgradePoolVersionConflict | Konflikt (409) | Fond se už upgraduje na jinou verzi. |
| ÚlohaPreparationTaskNotSpecified | Konflikt (409) | Zadaná úloha nemá úkol přípravy úlohy. |
| ÚlohaReleaseTaskNotSpecified | Konflikt (409) | Zadaná úloha nemá úkol uvolnění úlohy. |
| TaskIdSameAsJobPreparationTask | Konflikt (409) | Zadané ID úkolu je stejné jako u úkolu přípravy úlohy. |
| TaskIdSameAsJobReleaseTask | Konflikt (409) | Zadané ID úlohy je stejné jako úloha uvolnění úlohy. |
| JobWithSameIdExists | Konflikt (409) | Úloha se zadaným ID plánu úlohy existuje. Úloha a plán úlohy nemohou mít stejné ID. |
| JobScheduleWithSameIdExists | Konflikt (409) | Plán úlohy se zadaným ID úlohy existuje. Úloha a plán úlohy nemohou mít stejné ID. |
| NodeAlreadyInTargetSchedulingState | Konflikt (409) | Zadaný uzel je již ve stavu cílového plánování. |
| OperationNotValidOnNode | Konflikt (409) | Zadaná operace není na uzlu platná. |
| OperationNotValidOnPool | Konflikt (409) | Zadaná operace není ve fondu platná. |
| IoError | Zakázáno (403) | Při přístupu k zadanému prostředku došlo k V/V chybě. |
| TooManyEnableAutoScaleRequests | ServiceUnavailable (503) | Na fond se vydává příliš mnoho žádostí o povolení automatického škálování fondu. |
| ApplicationNotFound | Nenalezena (404) | Zadaná aplikace neexistuje. |
| InvalidApplicationPackageReferences | Konflikt (409) | Některé odkazy na balíčky aplikací nebylo možné splnit. K tomu dochází, pokud ID nebo verze aplikace neexistuje nebo není aktivní, nebo pokud odkaz neurčil verzi a není nakonfigurována žádná výchozí verze. |
| TaskDependenciesNotSpecifiedOnJob | Chybný požadavek (400) | Úkol byl zadán jako v závislosti na jiných úkolech, ale úloha neurčila, že bude používat závislosti úkolů. |
| TaskDependencyListTooLong | Chybný požadavek (400) | Úkol byl zadán jako v závislosti na jiných úkolech, ale seznam závislostí byl příliš dlouhý a nelze ho uložit. Celková uložená délka je omezena na 64000 znaků; celková délka ID úloh musí být o něco menší, než je tato hodnota, aby se snížila režie interního úložiště. Pokud narazíte na tuto chybu, zvažte místo toho použití závislostí rozsahu úkolů. |
| TaskDependencyRangesTooLong | Chybný požadavek (400) | Úkol byl zadán jako v závislosti na několika oblastech ID úkolů a seznam oblastí byl příliš dlouhý, než aby se uložil. Všimněte si, že problém není s velikostí rozsahů, ale s počtem rozsahů. |
Kódy chyb plánování úloh nebo úkolů
Pokud služba Batch při spuštění úkolu na uzlu narazí na chybu, označí úkol jako dokončený. Informace o chybě se vrátí v rámci failureInfo elementu v textu odpovědi vypsat soubory přidružené k úkolu a Získat informace o rozhraníCH API úkolu.
Podobně platí, že pokud služba Batch při spuštění úlohy zaznamená chybu, označí úlohu jako dokončenou. Tyto informace o chybách plánování se vrátí v rámci schedulingError elementu v textu odpovědi v části Získání informací o úloze v rozhraních API služby Batch.
Následující tabulka obsahuje seznam kategorií chyb plánování úkolů.
| Kategorie | Popis |
|---|---|
| Chyba uživatele | Chyby ve specifikaci úlohy poskytnuté uživatelem |
| Chyba serveru | Chyby zjištěné službou Batch, které jí brání v plánování úlohy. |
Níže je ukázka chyby předběžného zpracování vrácená službou Batch.
{
"preProcessingError": {
"category": "UserError",
"code": "BlobNotFound",
"message": "The specified blob does not exist.",
"values": {
"name": "FilePath",
"value": "myfile.txt"
}
}
}
Následující tabulka obsahuje seznam kódů chyb plánování úloh, které může vrátit služba Batch.
| Kód chyby | Kategorie | Zpráva uživatele |
|---|---|---|
| InvalidCertificatesInAutoPool | Chyba uživatele | Zadané odkazy na certifikáty ve specifikaci automatického fondu nejsou platné. |
| AutoPoolCreationFailedWithQuotaReached | Chyba uživatele | Dosáhli jsme kvóty fondu pro účet. |
| InvalidApplicationPackageReferencesInAutoPool | Chyba uživatele | Jeden nebo více balíčků aplikací zadaných pro fond je neplatných. |
| InvalidAutoScaleFormulaInAutoPool | Chyba uživatele | Zadané nastavení automatického škálování není platné. |
| InvalidAutoPoolSettings | Chyba uživatele | Zadané nastavení automatického zařazování není platné. |
| JobBeingTerminated | Chyba uživatele | Úkol nelze spustit, protože se ukončuje přidružená úloha. |
| Neznámý | Chyba serveru | Došlo k neznámé chybě plánování. |
Následující tabulka obsahuje seznam kódů chyb plánování úkolů, které může vrátit služba Batch.
| Kód chyby | Kategorie | Zpráva uživatele |
|---|---|---|
| BlobNotFound | Chyba uživatele | Jeden ze zadaných objektů blob Azure se nenašel. |
| BlobAccessDenied | Chyba uživatele | Přístup k některému ze zadaných objektů blob Azure je odepřen. |
| BlobDownloadTimedOut | Chyba serveru | Došlo k vypršení časového limitu při stahování některého ze zadaných objektů blob Azure. |
| BlobDownloadMiscError | Chyba serveru | Při stahování jednoho ze zadaných objektů blob Azure došlo k různé chybě. |
| ResourceDirectoryCreateFailed | Chyba serveru | Při vytváření adresáře prostředků pro úlohu došlo k chybě. |
| ResourceFileCreateFailed | Chyba serveru | Při vytváření souboru prostředků došlo k chybě. |
| ResourceFileWriteFailed | Chyba serveru | Při zápisu souboru prostředků došlo k chybě. |
| CommandProgramNotFound | Chyba uživatele | Zadaný příkazový program nebyl nalezen. |
| CommandLaunchFailed | Chyba uživatele | Spuštění zadaného příkazového řádku se nezdařilo. |
| TaskEnded | Chyba uživatele | Úkol byl ukončen na žádost uživatele. |
| MaxInternalRetryCountReached | Chyba uživatele | Zadaný úkol dosáhl maximálního interního počtu opakování. |
| TaskSchedulingConstraintFailed | Chyba uživatele | Úkol nelze naplánovat ve fondu přidruženém k úloze. |
| DiskFull | Chyba serveru | Na uzlu vybraném ke spuštění úlohy není dostatek místa na disku. |
| Neznámý | Chyba serveru | Došlo k neznámé chybě plánování. |