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