Kody stanu i błędów wsadowych
Operacje interfejsu API REST dla usługi Batch zwracają standardowe kody stanu HTTP zdefiniowane w definicjach kodu stanu HTTP/1.1.
Operacje interfejsu API mogą również zwracać dodatkowe informacje o błędach, aby dostarczyć deweloperowi więcej informacji o błędzie. Na przykład następująca odpowiedź o błędzie wskazuje, że parametr zapytania określony w identyfikatorze URI żądania jest nieprawidłowy i zawiera dodatkowe informacje o nazwie i wartości nieprawidłowego parametru oraz przyczynie błędu.
{
"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"
}]
}
W poniższych sekcjach przedstawiono listę kodów błędów dla usługi Batch:
Typowe kody błędów interfejsu API REST
Kody błędów wymienione w poniższej tabeli mogą być zwracane przez operację w usłudze Batch.
| Kod błędu | Kod stanu HTTP | Komunikat użytkownika |
|---|---|---|
| ConditionNotMet | Nie zmodyfikowano (304) | Warunek określony w nagłówkach warunkowych nie został spełniony dla operacji odczytu. |
| MissingRequiredHeader | Nieprawidłowe żądanie (400) | Nie określono wymaganego nagłówka HTTP. |
| MissingRequiredProperty | Nieprawidłowe żądanie (400) | Wymagana właściwość nie została określona w treści żądania. |
| Nieobsługiwany nagłówek | Nieprawidłowe żądanie (400) | Jeden z nagłówków HTTP określonych w żądaniu nie jest obsługiwany. |
| Nieobsługiwana właściwość | Nieprawidłowe żądanie (400) | Jedna z właściwości określonych w treści żądania nie jest obsługiwana. |
| InvalidHeaderValue | Nieprawidłowe żądanie (400) | Wartość podana dla jednego z nagłówków HTTP nie ma poprawnego formatu. |
| InvalidPropertyValue | Nieprawidłowe żądanie (400) | Wartość podana dla jednej z właściwości w treści żądania jest nieprawidłowa. |
| MissingRequiredQueryParameter | Nieprawidłowe żądanie (400) | Dla tego żądania nie określono wymaganego parametru zapytania. |
| Nieobsługiwaneparametryquery | Nieprawidłowe żądanie (400) | Jeden z parametrów zapytania określonych w identyfikatorze URI żądania nie jest obsługiwany. |
| InvalidQueryParameterValue | Nieprawidłowe żądanie (400) | Określono nieprawidłową wartość dla jednego z parametrów zapytania w identyfikatorze URI żądania. |
| OutOfRangeQueryParameterValue | Nieprawidłowe żądanie (400) | Parametr zapytania określony w identyfikatorze URI żądania znajduje się poza dopuszczalnym zakresem. |
| RequestUrlFailedToParse | Nieprawidłowe żądanie (400) | Nie można przeanalizować adresu URL w żądaniu. |
| InvalidUri | Nieprawidłowe żądanie (400) | Żądany identyfikator URI nie reprezentuje żadnego zasobu na serwerze. |
| InvalidHttpVerb | Nieprawidłowe żądanie (400) | Określony czasownik HTTP nie został rozpoznany przez serwer. |
| EmptyMetadataKey | Nieprawidłowe żądanie (400) | Klucz jednej z par klucz-wartość metadanych jest pusty. |
| InvalidRequestBody | Nieprawidłowe żądanie (400) | Określona treść żądania nie jest prawidłowa składniowo. |
| OutOfRangeInput | Nieprawidłowe żądanie (400) | Jedno z danych wejściowych żądania jest poza zakresem. |
| InvalidAuthenticationInfo | Nieprawidłowe żądanie (400) | Informacje o uwierzytelnianiu nie zostały podane w poprawnym formacie. Sprawdź wartość nagłówka autoryzacji . |
| InvalidInput | Nieprawidłowe żądanie (400) | Jedno z danych wejściowych żądania jest nieprawidłowe. |
| InvalidMetadata | Nieprawidłowe żądanie (400) | Określone metadane są nieprawidłowe. Zawiera ona niedozwolone znaki. |
| MetadataTooLarge | Nieprawidłowe żądanie (400) | Rozmiar określonych metadanych przekracza dozwolony maksymalny rozmiar. |
| MultipleConditionHeadersNotSupported | Nieprawidłowe żądanie (400) | Wiele nagłówków warunku nie jest obsługiwanych. |
| AuthenticationFailed | Zabronione (403) | Serwer nie może uwierzytelnić żądania. Sprawdź, czy wartość nagłówka autoryzacji jest poprawnie sformułowana i zawiera podpis. |
| InsufficientAccountPermissions | Zabronione (403) | Dostęp do konta nie ma wystarczających uprawnień do wykonania tej operacji. |
| AccountIsDisabled | Zabronione (403) | Określone konto jest wyłączone. |
| ResourceNotFound | Nie znaleziono (404) | Określony zasób nie istnieje. |
| NieobsługiwaneHttpVerb | Niedozwolona metoda (405) | Zasób nie obsługuje określonego zlecenia HTTP. |
| MissingContentLengthHeader | Wymagana długość (411) | Nie określono nagłówka Content-Length . |
| ConditionNotMet | Warunek wstępny nie powiódł się (412) | Warunek określony w nagłówkach warunkowych nie został spełniony dla operacji zapisu. |
| RequestBodyTooLarge | Zbyt duża jednostka żądania (413) | Rozmiar treści żądania przekracza dozwolony maksymalny rozmiar. |
| InvalidRange | Żądany zakres nie jest satyfiable (416) | Określony zakres jest nieprawidłowy dla bieżącego rozmiaru zasobu. |
| InternalError | Wewnętrzny błąd serwera (500) | Serwer napotkał błąd wewnętrzny. Ponów próbę żądania. |
| OperationTimedOut | Wewnętrzny błąd serwera (500) | Nie można ukończyć operacji w dozwolonym czasie. |
| ServerBusy | Usługa niedostępna (503) | Serwer nie może obecnie odbierać żądań. Ponów próbę żądania. |
Kody błędów usługi Batch
Kody błędów wymienione w poniższej tabeli mogą być zwracane przez operację w usłudze Batch.
| Kod błędu | Kod stanu HTTP | Komunikat użytkownika |
|---|---|---|
| Nieobsługiwana wersjaRequestVersion | BadRequest (400) | Określona wersja żądania nie jest obsługiwana. |
| InvalidAutoScalingSettings | BadRequest (400) | Określone ustawienia automatycznego skalowania są nieprawidłowe. |
| AutoScalingFormulaSyntaxError | BadRequest (400) | Określona formuła automatycznego skalowania ma błąd składniowy. |
| AutoSkalowanieFormulaTooLong | BadRequest (400) | Określona formuła automatycznego skalowania przekracza limit długości. |
| OSVersionNotFound | BadRequest (400) | Określona wersja systemu operacyjnego nie istnieje. |
| OSVersionDisabled | BadRequest (400) | Określona wersja systemu operacyjnego jest wyłączona. |
| OSVersionExpired | BadRequest (400) | Określona wersja systemu operacyjnego wygasła. |
| PoolVersionEqualsUpgradeVersion | BadRequest (400) | Pula jest już w danej wersji. |
| PoolNotEligibleForOSVersionUpgrade | BadRequest (400) | Określona pula nie kwalifikuje się do uaktualnienia wersji systemu operacyjnego. |
| PoolNotFound | NotFound (404) | Określona pula nie istnieje. |
| NodeNotFound | NotFound (404) | Określony węzeł nie istnieje. |
| JobScheduleNotFound | NotFound (404) | Określony harmonogram zadań nie istnieje. |
| JobNotFound | NotFound (404) | Określone zadanie nie istnieje. |
| TaskNotFound | NotFound (404) | Określone zadanie nie istnieje. |
| FileNotFound | NotFound (404) | Określony plik nie istnieje. |
| NodeUserNotFound | NotFound (404) | Określony użytkownik węzła nie istnieje. |
| CertificateNotFound | NotFound (404) | Określony certyfikat nie istnieje. |
| JobPreparationTaskNotRunOnNode | NotFound (404) | Zadanie przygotowania zadania nie zostało uruchomione w określonym węźle. |
| JobReleaseTaskNotRunOnNode | NotFound (404) | Zadanie wydania zadania nie zostało uruchomione w określonym węźle. |
| NodeAgentSKUNotFound | NotFound (404) | Określona jednostka SKU agenta węzła nie istnieje. |
| OperationInvalidForCurrentState | Konflikt (409) | Określona operacja jest nieprawidłowa dla bieżącego stanu zasobu. |
| PoolBeingDeleted | Konflikt (409) | Określona pula została oznaczona do usunięcia i jest odzyskiwana. |
| PulaBeingResized | Konflikt (409) | Rozmiar określonej puli jest zmieniany |
| PoolBeingCreated | Konflikt (409) | Tworzona jest określona pula. |
| NodeBeingCreated | Konflikt (409) | Tworzony jest określony węzeł |
| NodeBeingStarted | Konflikt (409) | Trwa uruchamianie określonego węzła |
| NodeBeingReimaged | Konflikt (409) | Określony węzeł jest odtwarzany z obrazu |
| NodeBeingRebooted | Konflikt (409) | Określony węzeł jest ponownie uruchamiany |
| NodeStateUnusable | Konflikt (409) | Stan określonego węzła jest bezużyteczny |
| ZadanieScheduleBeingTerminated | Konflikt (409) | Określony harmonogram zadań jest przerywany. |
| ZadanieScheduleBeingDeleted | Konflikt (409) | Określony harmonogram zadań został oznaczony do usunięcia i jest odzyskiwany. |
| CertificateBeingDeleted | Konflikt (409) | Określony certyfikat został oznaczony do usunięcia i jest usuwany. |
| PoolExists | Konflikt (409) | Określona pula już istnieje. |
| JobScheduleExists | Konflikt (409) | Określony harmonogram zadań już istnieje. |
| NodeUserExists | Konflikt (409) | Określony użytkownik węzła już istnieje. |
| JobExists | Konflikt (409) | Określone zadanie już istnieje. |
| NodeUserExists | Konflikt (409) | Określony użytkownik węzła już istnieje. |
| CertificateExists | Konflikt (409) | Określony certyfikat już istnieje. |
| JobScheduleDisabled | Konflikt (409) | Określony harmonogram zadań jest wyłączony. |
| JobScheduleCompleted | Konflikt (409) | Określony harmonogram zadań jest już w stanie ukończonym. |
| JobBeingTerminated | Konflikt (409) | Określone zadanie jest przerywane. |
| ZadanieBeingDeleted | Konflikt (409) | Określone zadanie zostało oznaczone do usunięcia i jest wyrzucane śmieci. |
| JobDisabled | Konflikt (409) | Określone zadanie jest wyłączone. |
| Zadanie zapełnione | Konflikt (409) | Określone zadanie jest już w stanie ukończonym. |
| JobNotActive | Konflikt (409) | Określone zadanie nie jest w stanie aktywnym. |
| TaskExists | Konflikt (409) | Określone zadanie już istnieje. |
| Zadanie uzupełnianie | Konflikt (409) | Określone zadanie jest już w stanie ukończonym. |
| TaskNotCompleted | Konflikt (409) | Określone zadanie nie jest w stanie ukończonym, a żądana operacja może być wykonywana tylko na ukończonych zadaniach. |
| Zadanieoocceeded | Konflikt (409) | Określone zadanie zostało już ukończone pomyślnie i nie można wykonać żądanej operacji na pomyślnych zadaniach. |
| TaskFilesUnavailable | Konflikt (409) | Pliki określonego zadania są niedostępne. |
| TaskFilesCleanedup | Konflikt (409) | Pliki określonego zadania są czyszczone. |
| ActiveJobAndScheduleQuotaReached | Konflikt (409) | Osiągnięto aktywny przydział zadań i harmonogramu dla konta. |
| PoolQuotaReached | Konflikt (409) | Osiągnięto limit przydziału puli dla konta. |
| UpgradePoolVersionConflict | Konflikt (409) | Pula jest już uaktualniona do innej wersji. |
| JobPreparationTaskNotSpecified | Konflikt (409) | Określone zadanie nie ma zadania podrzędnego przygotowania zadania. |
| JobReleaseTaskNotSpecified | Konflikt (409) | Określone zadanie nie ma zadania zwolnienia zadania. |
| TaskIdSameAsJobPreparationTask | Konflikt (409) | Określony identyfikator zadania jest taki sam jak zadanie podrzędne przygotowania zadania. |
| TaskIdSameAsJobReleaseTask | Konflikt (409) | Określony identyfikator zadania jest taki sam jak zadanie wydania zadania. |
| JobWithSameIdExists | Konflikt (409) | Istnieje zadanie o określonym identyfikatorze harmonogramu zadań. Harmonogram zadań i zadań nie może mieć tego samego identyfikatora. |
| JobScheduleWithSameIdExists | Konflikt (409) | Istnieje harmonogram zadań o określonym identyfikatorze zadania. Harmonogram zadań i zadań nie może mieć tego samego identyfikatora. |
| NodeAlreadyInTargetSchedulingState | Konflikt (409) | Określony węzeł jest już w stanie planowania docelowego. |
| OperationNotValidOnNode | Konflikt (409) | Określona operacja jest nieprawidłowa w węźle. |
| OperationNotValidOnPool | Konflikt (409) | Określona operacja jest nieprawidłowa w puli. |
| Ioerror | Zabronione (403) | Wystąpił błąd we/wy podczas uzyskiwania dostępu do określonego zasobu. |
| TooManyEnableAutoScaleRequests | ServiceUnavailable (503) | Zbyt wiele żądań włączania automatycznego skalowania puli jest wystawianych w puli. |
| ApplicationNotFound | Nie znaleziono (404) | Określona aplikacja nie istnieje. |
| InvalidApplicationPackageReferences | Konflikt (409) | Nie można spełnić co najmniej jednego odwołania do pakietu aplikacji. Dzieje się tak, jeśli identyfikator lub wersja aplikacji nie istnieje lub nie jest aktywna lub jeśli odwołanie nie określiło wersji i nie skonfigurowano wersji domyślnej. |
| TaskDependenciesNotSpecifiedOnJob | Nieprawidłowe żądanie (400) | Zadanie zostało określone w zależności od innych zadań, ale zadanie nie określiło, że będzie używać zależności zadań. |
| TaskDependencyListTooLong | Nieprawidłowe żądanie (400) | Zadanie zostało określone w zależności od innych zadań, ale lista zależności była zbyt długa, aby być przechowywana. Łączna długość składowana jest ograniczona do 64000 znaków; łączna długość identyfikatorów zadań musi być nieco mniejsza, aby umożliwić obciążenie magazynu wewnętrznego. Jeśli wystąpi ten błąd, rozważ użycie zależności zakresu zadań. |
| TaskDependencyRangesTooLong | Nieprawidłowe żądanie (400) | Zadanie zostało określone w zależności od wielu zakresów identyfikatorów zadań, a lista zakresów była zbyt długa, aby być przechowywana. Należy pamiętać, że problem nie dotyczy rozmiaru zakresów, ale z liczbą zakresów. |
Kody błędów planowania zadań/zadań
Jeśli usługa Batch napotka błąd podczas uruchamiania zadania w węźle, oznacza to zadanie jako ukończone. Informacje o błędzie są zwracane w obrębie failureInfo elementu w treści odpowiedzi Listy plików skojarzonych z zadaniem i Uzyskiwanie informacji o interfejsach API zadań .
Podobnie jeśli usługa Batch napotka błąd podczas uruchamiania zadania, oznacza to zadanie jako ukończone. Te informacje o błędach planowania są zwracane w obrębie schedulingError elementu w treści odpowiedzi w sekcji Pobieranie informacji o zadaniu w interfejsach API usługi Batch.
Poniższa tabela zawiera listę kategorii błędów planowania zadań.
| Kategoria | Opis |
|---|---|
| UserError | Błędy w specyfikacji zadania udostępnionej przez użytkownika. |
| Błąd serwera | Błędy napotkane przez usługę Batch, które uniemożliwiają zaplanowanie zadania. |
Poniżej przedstawiono przykładowy błąd przetwarzania wstępnego zwrócony przez usługę Batch.
{
"preProcessingError": {
"category": "UserError",
"code": "BlobNotFound",
"message": "The specified blob does not exist.",
"values": {
"name": "FilePath",
"value": "myfile.txt"
}
}
}
Poniższa tabela zawiera listę kodów błędów planowania zadań, które mogą być zwracane przez usługę Batch.
| Kod błędu | Kategoria | Komunikat użytkownika |
|---|---|---|
| InvalidCertificatesInAutoPool | UserError | Określone odwołania do certyfikatu w specyfikacji puli automatycznej są nieprawidłowe. |
| AutoPoolCreationFailedWithQuotaReached | UserError | Osiągnięto limit przydziału puli dla konta. |
| InvalidApplicationPackageReferencesInAutoPool | UserError | Co najmniej jeden pakiet aplikacji określony dla puli jest nieprawidłowy. |
| InvalidAutoScaleFormulaInAutoPool | UserError | Określone ustawienia automatycznego skalowania są nieprawidłowe. |
| InvalidAutoPoolSettings | UserError | Określone ustawienia puli automatycznej są nieprawidłowe. |
| JobBeingTerminated | UserError | Nie można uruchomić zadania, ponieważ skojarzone zadanie jest przerywane. |
| Nieznane | Błąd serwera | Wystąpił nieznany błąd planowania. |
Poniższa tabela zawiera listę kodów błędów planowania zadań, które mogą być zwracane przez usługę Batch.
| Kod błędu | Kategoria | Komunikat użytkownika |
|---|---|---|
| BlobNotFound | UserError | Nie można odnaleźć jednego z określonych obiektów blob platformy Azure. |
| BlobAccessDenied | UserError | Odmowa dostępu do jednego z określonych obiektów blob platformy Azure. |
| BlobDownloadTimedOut | Błąd serwera | Napotkano limit czasu podczas pobierania jednego z określonych obiektów blob platformy Azure. |
| BlobDownloadMiscError | Błąd serwera | Wystąpił inny błąd podczas pobierania jednego z określonych obiektów blob platformy Azure. |
| ResourceDirectoryCreateFailed | Błąd serwera | Wystąpił błąd podczas tworzenia katalogu zasobów dla zadania. |
| ResourceFileCreateFailed | Błąd serwera | Napotkano błąd podczas tworzenia pliku zasobu. |
| ResourceFileWriteFailed | Błąd serwera | Napotkano błąd podczas zapisywania pliku zasobów. |
| CommandProgramNotFound | Błąd użytkownika | Nie można odnaleźć określonego programu poleceń. |
| CommandLaunchFailed | Błąd użytkownika | Nie można uruchomić określonego wiersza polecenia. |
| Zadanieended | Błąd użytkownika | Zadanie zostało zakończone przez żądanie użytkownika. |
| MaxInternalRetryCountReached | Błąd użytkownika | Określone zadanie osiągnęło maksymalną wewnętrzną liczbę ponownych prób. |
| TaskSchedulingConstraintFailed | Błąd użytkownika | Nie można zaplanować zadania w puli skojarzonej z zadaniem |
| DiskFull | Błąd serwera | Za mało miejsca na dysku w węźle, który został wybrany do uruchomienia zadania. |
| Nieznane | Błąd serwera | Wystąpił nieznany błąd planowania. |