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í. |