Kötegelt állapot és hibakódok
A Batch szolgáltatás REST API-műveletei a HTTP/1.1 állapotkód-definíciókban meghatározott szabványos HTTP-állapotkódokat ad vissza.
Az API-műveletek további hibainformációkat is visszaadhatnak, hogy a fejlesztő további információkat tudjon meg a hibáról. A következő hibaválasz például azt jelzi, hogy a kérelem URI-ján megadott lekérdezési paraméter érvénytelen volt, és további információt nyújt az érvénytelen paraméter nevéről és értékéről, valamint a hiba okáról.
{
"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"
}]
}
A következő szakaszok a Batch szolgáltatás hibakódjainak listáját ismertetik:
Gyakori REST API-hibakódok
Az alábbi táblázatban felsorolt hibakódokat a Batch szolgáltatás egy művelete adhatja vissza.
| Hibakód | HTTP-állapotkód | Felhasználói üzenet |
|---|---|---|
| ConditionNotMet | Nincs módosítva (304) | A feltételes fejléc(ek)ben megadott feltétel nem teljesült olvasási művelet esetén. |
| MissingRequiredHeader | Hibás kérés (400) | Nincs megadva egy szükséges HTTP-fejléc. |
| MissingRequiredProperty | Hibás kérés (400) | A kérelem törzsében nincs megadva egy kötelező tulajdonság. |
| Nem támogatottheader | Hibás kérés (400) | A kérelemben megadott HTTP-fejlécek egyike nem támogatott. |
| Nem támogatottTulajdonság | Hibás kérés (400) | A kérelem törzsében megadott tulajdonságok egyike nem támogatott. |
| InvalidHeaderValue | Hibás kérés (400) | Az egyik HTTP-fejléchez megadott érték nem a megfelelő formátumban volt. |
| InvalidPropertyValue | Hibás kérés (400) | A kérelemtörzs egyik tulajdonságához megadott érték érvénytelen. |
| MissingRequiredQueryParameter | Hibás kérés (400) | Ehhez a kéréshez nincs megadva egy kötelező lekérdezési paraméter. |
| Nem támogatottQueryParameter | Hibás kérés (400) | A kérelem URI-jában megadott lekérdezési paraméterek egyike nem támogatott. |
| InvalidQueryParameterValue | Hibás kérés (400) | Érvénytelen érték lett megadva a kérelem URI-jában szereplő lekérdezési paraméterek egyikéhez. |
| OutOfRangeQueryParameterValue | Hibás kérés (400) | A kérelem URI-jában megadott lekérdezési paraméter kívül esik a megengedett tartományon. |
| RequestUrlFailedToParse | Hibás kérés (400) | A kérelem url-címe nem elemezhető. |
| InvalidUri | Hibás kérés (400) | A kért URI nem jelöl erőforrást a kiszolgálón. |
| ÉrvénytelenHttpVerb | Hibás kérés (400) | A kiszolgáló nem ismerte fel a megadott HTTP-parancsot. |
| EmptyMetadataKey | Hibás kérés (400) | Az egyik metaadatkulcs-érték pár kulcsa üres. |
| InvalidRequestBody | Hibás kérés (400) | A megadott kérelemtörzs nem szintaktikailag érvényes. |
| OutOfRangeInput | Hibás kérés (400) | Az egyik kérelembemenet kívül esik a tartományon. |
| InvalidAuthenticationInfo | Hibás kérés (400) | A hitelesítési adatok nem a megfelelő formátumban adták meg. Ellenőrizze az Engedélyezési fejléc értékét. |
| InvalidInput | Hibás kérés (400) | Az egyik kérelembemenet érvénytelen. |
| InvalidMetadata | Hibás kérés (400) | A megadott metaadatok érvénytelenek. Olyan karaktereket tartalmaz, amelyek nem engedélyezettek. |
| MetadataTooLarge | Hibás kérés (400) | A megadott metaadatok mérete meghaladja a megengedett maximális méretet. |
| MultipleConditionHeadersNotSupported | Hibás kérés (400) | Több feltételfejléc nem támogatott. |
| AuthenticationFailed | Tiltott (403) | A kiszolgáló nem tudta hitelesíteni a kérést. Ellenőrizze, hogy az Engedélyezési fejléc helyesen van-e formázva, és tartalmazza-e az aláírást. |
| InsufficientAccountPermissions | Tiltott (403) | A hozzáférés alatt álló fiók nem rendelkezik a művelet végrehajtásához szükséges engedélyekkel. |
| AccountIsDisabled | Tiltott (403) | A megadott fiók le van tiltva. |
| ResourceNotFound | Nem található (404) | A megadott erőforrás nem létezik. |
| Nem támogatottHttpVerb | Metódus nem engedélyezett (405) | Az erőforrás nem támogatja a megadott HTTP-parancsot. |
| MissingContentLengthHeader | Szükséges hossz (411) | A Content-Length fejléc nincs megadva. |
| ConditionNotMet | Az előfeltétel nem sikerült (412) | A feltételes fejléc(ek)ben megadott feltétel nem teljesült írási művelet esetén. |
| RequestBodyTooLarge | Túl nagy kérelementitás (413) | A kérelemtörzs mérete meghaladja a megengedett maximális méretet. |
| InvalidRange | A kért tartomány nem alkalmas (416) | A megadott tartomány érvénytelen az erőforrás aktuális méretéhez. |
| InternalError | Belső kiszolgálóhiba (500) | A kiszolgáló belső hibát észlelt. Próbálkozzon újra a kéréssel. |
| OperationTimedOut | Belső kiszolgálóhiba (500) | A művelet nem hajtható végre a megengedett időn belül. |
| ServerBusy | A szolgáltatás nem érhető el (503) | A kiszolgáló jelenleg nem tud kéréseket fogadni. Próbálkozzon újra a kéréssel. |
Batch-szolgáltatás hibakódjai
Az alábbi táblázatban felsorolt hibakódokat a Batch szolgáltatás egy művelete adhatja vissza.
| Hibakód | HTTP-állapotkód | Felhasználói üzenet |
|---|---|---|
| Nem támogatottRequestVersion | BadRequest (400) | A megadott kérelemverzió nem támogatott. |
| InvalidAutoScalingSettings | BadRequest (400) | A megadott automatikus skálázási beállítások érvénytelenek. |
| AutoScalingFormulaSyntaxError | BadRequest (400) | A megadott automatikus skálázási képlet szintaktikai hibát jelez. |
| AutoScalingFormulaTooLong | BadRequest (400) | A megadott automatikus méretezési képlet túllépi a hosszkorlátot. |
| OSVersionNotFound | BadRequest (400) | A megadott operációsrendszer-verzió nem létezik. |
| OSVersionDisabled | BadRequest (400) | A megadott operációsrendszer-verzió le van tiltva. |
| OSVersionExpired | BadRequest (400) | A megadott operációsrendszer-verzió lejárt. |
| PoolVersionEqualsUpgradeVersion | BadRequest (400) | A készlet már rendelkezik a megadott verzióval. |
| PoolNotEligibleForOSVersionUpgrade | BadRequest (400) | A megadott készlet nem jogosult az operációs rendszer verziófrissítésére. |
| PoolNotFound | NotFound (404) | A megadott készlet nem létezik. |
| NodeNotFound | NotFound (404) | A megadott csomópont nem létezik. |
| JobScheduleNotFound | NotFound (404) | A megadott feladatütemezés nem létezik. |
| JobNotFound | NotFound (404) | A megadott feladat nem létezik. |
| TaskNotFound | NotFound (404) | A megadott tevékenység nem létezik. |
| FileNotFound | NotFound (404) | A megadott fájl nem létezik. |
| NodeUserNotFound | NotFound (404) | A megadott csomópontfelhasználó nem létezik. |
| CertificateNotFound | NotFound (404) | A megadott tanúsítvány nem létezik. |
| JobPreparationTaskNotRunOnNode | NotFound (404) | A feladat-előkészítési feladat nem futott a megadott csomóponton. |
| JobReleaseTaskNotRunOnNode | NotFound (404) | A feladatkiadási feladat nem futott a megadott csomóponton. |
| NodeAgentSKUNotFound | NotFound (404) | A csomópontügynök megadott termékváltozata nem létezik. |
| OperationInvalidForCurrentState | Ütközés (409) | A megadott művelet nem érvényes az erőforrás aktuális állapotára. |
| PoolBeingDeleted | Ütközés (409) | A megadott készlet törlésre lett megjelölve, és a rendszer visszavesz. |
| PoolBeingResized | Ütközés (409) | A megadott készlet átméretezése folyamatban van |
| PoolBeingCreated | Ütközés (409) | A megadott készlet létrehozása folyamatban van. |
| NodeBeingCreated | Ütközés (409) | A megadott csomópont létrehozása folyamatban van |
| NodeBeingStarted | Ütközés (409) | A megadott csomópont indítása folyamatban van |
| NodeBeingReimaged | Ütközés (409) | A megadott csomópont újra van formázva |
| NodeBeingRebooted | Ütközés (409) | A megadott csomópont újraindul |
| NodeStateUnusable | Ütközés (409) | A megadott csomópont állapota nem használható |
| JobScheduleBeingTerminated | Ütközés (409) | A megadott feladatütemezés leáll. |
| JobScheduleBeingDeleted | Ütközés (409) | A megadott feladatütemezés törlésre lett megjelölve, és a rendszer visszaigényeli. |
| CertificateBeingDeleted | Ütközés (409) | A megadott tanúsítvány törlésre lett megjelölve, és törlés alatt áll. |
| PoolExists | Ütközés (409) | A megadott készlet már létezik. |
| JobScheduleExists | Ütközés (409) | A megadott feladatütemezés már létezik. |
| NodeUserExists | Ütközés (409) | A megadott csomópontfelhasználó már létezik. |
| JobExists | Ütközés (409) | A megadott feladat már létezik. |
| NodeUserExists | Ütközés (409) | A megadott csomópontfelhasználó már létezik. |
| CertificateExists | Ütközés (409) | A megadott tanúsítvány már létezik. |
| JobScheduleDisabled | Ütközés (409) | A megadott feladatütemezés le van tiltva. |
| JobScheduleCompleted | Ütközés (409) | A megadott feladatütemezés már befejeződött állapotban van. |
| JobBeingTerminated | Ütközés (409) | A megadott feladat leáll. |
| JobBeingDeleted | Ütközés (409) | A megadott feladat törlésre lett megjelölve, és a rendszer szemétgyűjtés alatt áll. |
| JobDisabled | Ütközés (409) | A megadott feladat le van tiltva. |
| Feladatkiegészítés | Ütközés (409) | A megadott feladat már befejezett állapotban van. |
| JobNotActive | Ütközés (409) | A megadott feladat nincs aktív állapotban. |
| TaskExists | Ütközés (409) | A megadott tevékenység már létezik. |
| Feladatkiegészítés | Ütközés (409) | A megadott tevékenység már befejezett állapotban van. |
| TaskNotCompleted | Ütközés (409) | A megadott tevékenység nincs befejezve állapotban, és a kért művelet csak befejezett tevékenységeken hajtható végre. |
| TaskSucceeded | Ütközés (409) | A megadott feladat már sikeresen befejeződött, és a kért művelet nem hajtható végre a sikeres tevékenységeken. |
| TaskFilesUnavailable | Ütközés (409) | A megadott feladat fájljai nem érhetők el. |
| TaskFilesCleanedup | Ütközés (409) | A megadott feladat fájljai törlődnek. |
| ActiveJobAndScheduleQuotaReached | Ütközés (409) | Elérte a fiók aktív feladat- és ütemezési kvótáját. |
| PoolQuotaReached | Ütközés (409) | A fiók készletkvótája el lett érve. |
| UpgradePoolVersionConflict | Ütközés (409) | A készlet már egy másik verzióra frissít. |
| JobPreparationTaskNotSpecified | Ütközés (409) | A megadott feladat nem rendelkezik feladat-előkészítési tevékenységsel. |
| JobReleaseTaskNotSpecified | Ütközés (409) | A megadott feladathoz nincs feladatkiadási feladat. |
| TaskIdSameAsJobPreparationTask | Ütközés (409) | A megadott tevékenységazonosító megegyezik a feladat-előkészítési tevékenység azonosítójával. |
| TaskIdSameAsJobReleaseTask | Ütközés (409) | A megadott tevékenységazonosító megegyezik a feladat kiadási feladatával. |
| JobWithSameIdExists | Ütközés (409) | Létezik egy feladat a megadott feladatütemezési azonosítóval. A feladat- és feladatütemezés nem rendelkezhet ugyanazzal az azonosítóval. |
| JobScheduleWithSameIdExists | Ütközés (409) | Létezik egy feladatütemezés a megadott feladatazonosítóval. A feladat- és feladatütemezés nem rendelkezhet ugyanazzal az azonosítóval. |
| NodeAlreadyInTargetSchedulingState | Ütközés (409) | A megadott csomópont már a célütemezési állapotban van. |
| OperationNotValidOnNode | Ütközés (409) | A megadott művelet nem érvényes a csomóponton. |
| OperationNotValidOnPool | Ütközés (409) | A megadott művelet nem érvényes a készleten. |
| IOError | Tiltott (403) | I/O-hiba történt a megadott erőforrás elérésekor. |
| TooManyEnableAutoScaleRequests | ServiceUnavailable (503) | Túl sok automatikus skálázási kérelem van kiadva a készleten. |
| ApplicationNotFound | Nem található (404) | A megadott alkalmazás nem létezik. |
| InvalidApplicationPackageReferences | Ütközés (409) | Egy vagy több alkalmazáscsomag-referenciát nem sikerült kielégíteni. Ez akkor fordul elő, ha az alkalmazás azonosítója vagy verziója nem létezik, vagy nem aktív, vagy ha a hivatkozás nem adott meg verziót, és nincs alapértelmezett verzió konfigurálva. |
| TaskDependenciesNotSpecifiedOnJob | Hibás kérés (400) | A tevékenység más tevékenységektől függően lett megadva, de a feladat nem adta meg, hogy tevékenységfüggőségeket használna. |
| TaskDependencyListTooLong | Hibás kérés (400) | A tevékenység más tevékenységektől függően lett megadva, de a függőségek listája túl hosszú volt a tároláshoz. A teljes tárolt hossz legfeljebb 64000 karakter lehet; a tevékenységazonosítók teljes hosszának ennél valamivel kisebbnek kell lennie a belső tárterület többletterhelésének lehetővé tétele érdekében. Ha ezt a hibát tapasztalja, fontolja meg inkább a tevékenységtartomány-függőségek használatát. |
| TaskDependencyRangesTooLong | Hibás kérés (400) | Egy tevékenység a tevékenységazonosítók több tartományától függően lett megadva, és a tartományok listája túl hosszú volt a tároláshoz. Vegye figyelembe, hogy a probléma nem a tartományok méretével, hanem a tartományok számával kapcsolatos. |
Feladat-/tevékenységütemezési hibakódok
Ha a Batch szolgáltatás hibát tapasztal egy tevékenység csomóponton való indításakor, befejezettként jelöli meg a tevékenységet. A hibainformációkat a rendszer a feladathoz társított fájlok listázása és a tevékenység API-kkal kapcsolatos információk lekérése című szakasz választörzsében adja visszafailureInfo.
Hasonlóképpen, ha a Batch szolgáltatás hibát tapasztal a feladat indításakor, befejezettként jelöli meg a feladatot. Ez az ütemezési hibainformáció a Batch API-kban lévő feladatokkal kapcsolatos információk lekérése válasz törzsének egyik schedulingError elemében jelenik meg.
Az alábbi táblázat a tevékenységütemezési hibák kategóriáinak listáját tartalmazza.
| Kategória | Leírás |
|---|---|
| UserError | A felhasználó által megadott feladatspecifikáció hibái. |
| ServerError | A Batch szolgáltatás által észlelt hibák, amelyek megakadályozzák a feladat ütemezését. |
Az alábbiakban egy, a Batch szolgáltatás által visszaadott előfeldolgozási hibát talál.
{
"preProcessingError": {
"category": "UserError",
"code": "BlobNotFound",
"message": "The specified blob does not exist.",
"values": {
"name": "FilePath",
"value": "myfile.txt"
}
}
}
Az alábbi táblázat a Batch szolgáltatás által visszaadott feladatütemezési hibakódok listáját tartalmazza.
| Hibakód | Kategória | Felhasználói üzenet |
|---|---|---|
| InvalidCertificatesInAutoPool | UserError | Az automatikus készlet specifikációjában megadott tanúsítványhivatkozások érvénytelenek. |
| AutoPoolCreationFailedWithQuotaReached | UserError | A fiók készletkvótája el van érve. |
| InvalidApplicationPackageReferencesInAutoPool | UserError | A készlethez megadott egy vagy több alkalmazáscsomag érvénytelen. |
| InvalidAutoScaleFormulaInAutoPool | UserError | A megadott automatikus skálázási beállítások érvénytelenek. |
| InvalidAutoPoolSettings | UserError | A megadott automatikus készletbeállítások érvénytelenek. |
| JobBeingTermed | UserError | A tevékenység nem indítható el, mert a társított feladat leáll. |
| Ismeretlen | ServerError | Ismeretlen ütemezési hiba történt. |
Az alábbi táblázat a Batch szolgáltatás által visszaadott feladatütemezési hibakódok listáját tartalmazza.
| Hibakód | Kategória | Felhasználói üzenet |
|---|---|---|
| BlobNotFound | UserError | A megadott Azure Blob(ok) egyike nem található. |
| BlobAccessDenied | UserError | A megadott Azure Blob(ok) egyikéhez való hozzáférés megtagadva. |
| BlobDownloadTimedOut | ServerError | Időtúllépés történt a megadott Azure Blob(ok) egyikének letöltésekor. |
| BlobDownloadMiscError | ServerError | A megadott Azure Blob(ok) egyikének letöltése során egyéb hiba lépett fel. |
| ResourceDirectoryCreateFailed | ServerError | Hiba történt a tevékenység erőforráskönyvtárának létrehozásakor. |
| ResourceFileCreateFailed | ServerError | Hiba történt az erőforrásfájl létrehozásakor. |
| ResourceFileWriteFailed | ServerError | Hiba történt az erőforrásfájl írása közben. |
| CommandProgramNotFound | UserError | A megadott parancsprogram nem található. |
| CommandLaunchFailed | UserError | Nem sikerült elindítani a megadott parancssort. |
| TaskEnded | UserError | A feladatot felhasználói kéréssel fejezték be. |
| MaxInternalRetryCountReached | UserError | A megadott tevékenység elérte a belső újrapróbálkozás maximális számát. |
| TaskSchedulingConstraintFailed | UserError | A tevékenység nem ütemezhető a feladathoz társított készleten |
| DiskFull | ServerError | Nincs elegendő lemezterület a feladat futtatásához kijelölt csomóponton. |
| Ismeretlen | ServerError | Ismeretlen ütemezési hiba történt. |