Состояние и коды ошибок пакетной службы

Операции REST API для пакетной службы возвращают стандартные коды состояния HTTP, как определено в определениях кода состояния HTTP/1.1.

Операции API могут также возвращать дополнительные сведения об ошибке, чтобы предоставить разработчику больше информации об ошибке. Например, следующий ответ со сведениями об ошибке сообщает, что параметр запроса, указанный в URI запроса, был недопустимым, и предоставляет дополнительные сведения о недопустимом имени и значении параметра и причине ошибки.

{
  "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"
  }]
}

В следующих разделах приведены списки кодов ошибок для пакетной службы.

Общие коды ошибок API-интерфейса REST

Коды ошибок, перечисленные в следующей таблице, могут быть возвращены операцией, выполненной в пакетной службе.

Код ошибки Код состояния HTTP Сообщение для пользователя
ConditionNotMet Не изменено (304) Условие, указанное в заголовках условий, не выполнено для считываемой операции.
MissingRequiredHeader Неправильный запрос (400) Не указан обязательный заголовок HTTP.
MissingRequiredProperty Неправильный запрос (400) В тексте запроса не указано обязательное свойство.
UnsupportedHeader Неправильный запрос (400) Не поддерживается один из указанных заголовков HTTP в запросе.
UnsupportedProperty Неправильный запрос (400) Одно из свойств, указанных в тексте запроса, не поддерживается.
InvalidHeaderValue Неправильный запрос (400) Значение одного из заголовков HTTP было указано в неверном формате.
InvalidPropertyValue Неправильный запрос (400) Недопустимое значение одного из свойств в тексте запроса.
MissingRequiredQueryParameter Неправильный запрос (400) Обязательный параметр запроса не был указан для этого запроса.
UnsupportedQueryParameter Неправильный запрос (400) Не поддерживается один из параметров запроса, указанных в URI запроса.
InvalidQueryParameterValue Неправильный запрос (400) У одного из параметров запроса в URI запроса было указано недопустимое значение.
OutOfRangeQueryParameterValue Неправильный запрос (400) Параметр запроса, указанный в URI запроса, находится за пределами допустимого диапазона.
RequestUrlFailedToParse Неправильный запрос (400) Не удалось выполнить синтаксический анализ URL-адреса в запросе.
InvalidUri Неправильный запрос (400) Запрошенный URI не представляет ни одного из ресурсов на сервере.
InvalidHttpVerb Неправильный запрос (400) Указанная HTTP-команда не была распознана сервером.
EmptyMetadataKey Неправильный запрос (400) Пустой ключ в одной из пар «ключ-значение» метаданных.
InvalidRequestBody Неправильный запрос (400) Указанный текст запроса имеет недопустимый синтаксис.
OutOfRangeInput Неправильный запрос (400) Некоторые из входных данных запроса выходят за пределы допустимого диапазона.
InvalidAuthenticationInfo Неправильный запрос (400) Сведения о проверке подлинности представлены в недопустимом формате. Проверьте значение заголовка авторизации .
InvalidInput Неправильный запрос (400) Недопустимые входные данные в запросе.
InvalidMetadata Неправильный запрос (400) Указанные метаданные являются недопустимыми. Они содержат запрещенные символы.
MetadataTooLarge Неправильный запрос (400) Размер указанных метаданных превышает максимально допустимый размер.
MultipleConditionHeadersNotSupported Неправильный запрос (400) Несколько из заголовков условий не поддерживаются.
AuthenticationFailed Запрещено (403) Серверу не удалось проверить подлинность запроса. Убедитесь, что значение заголовка авторизации правильно сформировано и содержит сигнатуру.
InsufficientAccountPermissions Запрещено (403) Учетная запись, к которой выполняется обращение, имеет недостаточно разрешений на выполнение этой операции.
AccountIsDisabled Запрещено (403) Учетная запись отключена.
ResourceNotFound Не найдено (404) Указанный ресурс не существует.
UnsupportedHttpVerb Метод не разрешен (405) Ресурс не поддерживает указанная HTTP-команда.
MissingContentLengthHeader Требуется длина (411) Заголовок Content-Length не указан.
ConditionNotMet Не выполняется обязательное условие (412) Условие, указанное в заголовках условий, не выполняется для операции записи.
RequestBodyTooLarge Слишком большая сущность запроса (413) Размер текста запроса превышает максимально допустимый размер.
InvalidRange Запрошенный диапазон невыполним (416) Указанный диапазон недопустим для текущего размера ресурса.
InternalError Внутренняя ошибка сервера (500) Сервер обнаружил внутреннюю ошибку. Повторите запрос.
OperationTimedOut Внутренняя ошибка сервера (500) Не удалось выполнить операцию за отведенное время.
ServerBusy Служба недоступна (503) Серверу не удается получить запросы. Повторите запрос.

Коды ошибок пакетной службы

Коды ошибок, перечисленные в следующей таблице, могут быть возвращены операцией, выполненной в пакетной службе.

Код ошибки Код состояния HTTP Сообщение для пользователя
UnsupportedRequestVersion BadRequest (400) Указанная версия запроса не поддерживается.
InvalidAutoScalingSettings BadRequest (400) Указаны недопустимые параметры автоматического масштабирования.
AutoScalingFormulaSyntaxError BadRequest (400) В указанной формуле автоматического масштабирования есть синтаксическая ошибка.
AutoScalingFormulaTooLong BadRequest (400) Указанная формула автоматического масштабирования превышает ограничение на длину.
OSVersionNotFound BadRequest (400) Указанная версия операционной системы не существует.
OSVersionDisabled BadRequest (400) Указанная версия операционной системы отключена.
OSVersionExpired BadRequest (400) Срок действия указанной версии операционной системы истек.
PoolVersionEqualsUpgradeVersion BadRequest (400) Пул уже имеет указанную версию.
PoolNotEligibleForOSVersionUpgrade BadRequest (400) Указанный пул не подходит для обновления версии ОС.
PoolNotFound NotFound (404) Указанный пул не существует.
NodeNotFound NotFound (404) Указанный узел не существует.
JobScheduleNotFound NotFound (404) Указанное расписание задания не существует.
JobNotFound NotFound (404) Указанное задание не существует.
TaskNotFound NotFound (404) Указанная задача не существует.
FileNotFound NotFound (404) Указанный файл не существует.
NodeUserNotFound NotFound (404) Указанный пользователь узла не существует.
CertificateNotFound NotFound (404) Указанный сертификат не существует.
JobPreparationTaskNotRunOnNode NotFound (404) Задача подготовки задания не выполнялась на указанном узле.
JobReleaseTaskNotRunOnNode NotFound (404) Задача выпуска задания не выполнялась на указанном узле.
NodeAgentSKUNotFound NotFound (404) Указанный номер SKU агента узла не существует.
OperationInvalidForCurrentState Конфликт (409) Указанная операция недопустима для текущего состояния ресурса.
PoolBeingDeleted Конфликт (409) Указанный пул была помечен для удаления и освобождается.
PoolBeingResized Конфликт (409) Размер указанного пула изменяется.
PoolBeingCreated Конфликт (409) Указанный пул создается.
NodeBeingCreated Конфликт (409) Создается указанный узел
NodeBeingStarted Конфликт (409) Запускается указанный узел
NodeBeingReimaged Конфликт (409) Переосмыслен указанный узел
NodeBeingRebooted Конфликт (409) Указанный узел перезагружается
NodeStateUnusable Конфликт (409) Состояние указанного узла непригодным для использования
JobScheduleBeingTerminated Конфликт (409) Указанное расписание задания завершается.
JobScheduleBeingDeleted Конфликт (409) Указанное расписание задания помечено для удаления и освобождается.
CertificateBeingDeleted Конфликт (409) Указанный сертификат был помечен для удаления и удаляется.
PoolExists Конфликт (409) Указанный пул уже существует.
JobScheduleExists Конфликт (409) Указанное расписание задания уже существует.
NodeUserExists Конфликт (409) Указанный пользователь узла уже существует.
JobExists Конфликт (409) Указанное задание уже существует.
NodeUserExists Конфликт (409) Указанный пользователь узла уже существует.
CertificateExists Конфликт (409) Указанный сертификат уже существует.
JobScheduleDisabled Конфликт (409) Указанное расписание задания отключено.
JobScheduleCompleted Конфликт (409) Указанное расписание задания уже находится в состоянии завершения.
JobBeingTerminated Конфликт (409) Указанное задание прекращается.
JobBeingDeleted Конфликт (409) Указанное задание было помечено для удаления и обрабатывается сборщиком мусора.
JobDisabled Конфликт (409) Указанное задание отключено.
JobCompleted Конфликт (409) Указанное задание уже завершено.
JobNotActive Конфликт (409) Указанное задание не находится в активном состоянии.
TaskExists Конфликт (409) Указанная задача уже существует.
TaskCompleted Конфликт (409) Указанная задача уже завершена.
TaskNotCompleted Конфликт (409) Указанная задача не находится в состоянии завершения, и запрошенная операция может быть выполнена только для завершенных задач.
TaskSucceeded Конфликт (409) Указанная задача уже успешно завершена, и запрошенная операция не может быть выполнена для успешных задач.
TaskFilesUnavailable Конфликт (409) Файлы указанной задачи недоступны.
TaskFilesCleanedup Конфликт (409) Файлы указанной задачи очищаются.
ActiveJobAndScheduleQuotaReached Конфликт (409) Достигнута квота активного задания и расписания для учетной записи.
PoolQuotaReached Конфликт (409) Достигнута квота пула для учетной записи.
UpgradePoolVersionConflict Конфликт (409) Пул уже обновляется до другой версии.
JobPreparationTaskNotSpecified Конфликт (409) Указанное задание не имеет задачи подготовки задания.
JobReleaseTaskNotSpecified Конфликт (409) Указанное задание не имеет задачи выпуска задания.
TaskIdSameAsJobPreparationTask Конфликт (409) Указанный идентификатор задачи совпадает с задачей подготовки задания.
TaskIdSameAsJobReleaseTask Конфликт (409) Указанный идентификатор задачи совпадает с задачей освобождения задания.
JobWithSameIdExists Конфликт (409) Задание с указанным идентификатором расписания задания существует. Задание и расписание заданий не могут иметь одинаковый идентификатор.
JobScheduleWithSameIdExists Конфликт (409) Существует расписание задания с указанным идентификатором задания. Задание и расписание заданий не могут иметь одинаковый идентификатор.
NodeAlreadyInTargetSchedulingState Конфликт (409) Указанный узел уже находится в целевом состоянии планирования.
OperationNotValidOnNode Конфликт (409) Указанная операция недопустима на узле.
OperationNotValidOnPool Конфликт (409) Указанная операция недопустима в пуле.
IOError Запрещено (403) Произошла ошибка ввода-вывода при доступе к указанному ресурсу.
TooManyEnableAutoScaleRequests ServiceUnavailable (503) В пуле отправляется слишком много запросов включить автомасштабирование пула.
ApplicationNotFound Не найдено (404) Указанное приложение не существует.
InvalidApplicationPackageReferences Конфликт (409) Не удалось выполнить одну или несколько ссылок на пакеты приложений. Это происходит, если идентификатор или версия приложения не существует или не активен, или если ссылка не указала версию и не настроена версия по умолчанию.
TaskDependenciesNotSpecifiedOnJob Неправильный запрос (400) Задача была указана как в зависимости от других задач, но задание не указало, что оно будет использовать зависимости задач.
TaskDependencyListTooLong Неправильный запрос (400) Задача была указана как в зависимости от других задач, но список зависимостей был слишком длинным для хранения. Общая хранимая длина ограничена 64000 символами; Общая длина идентификаторов задач должна быть немного меньше этой, чтобы обеспечить затраты на внутреннее хранилище. При возникновении этой ошибки рассмотрите возможность использования зависимостей диапазона задач.
TaskDependencyRangesTooLong Неправильный запрос (400) Задача была указана как в зависимости от нескольких диапазонов идентификаторов задач, а список диапазонов был слишком длинным для хранения. Обратите внимание, что проблема заключается не в размере диапазонов, а в количестве диапазонов.

Коды ошибок планирования задания или задачи

Если пакетная служба обнаруживает ошибку при запуске задачи на узле, она помечает задачу как завершенную. Сведения об ошибке возвращаются в элементе failureInfo в тексте ответа в разделе Перечисление файлов, связанных с задачей и Получение сведений об API задачи .

Аналогично, если пакетная служба обнаруживает ошибку во время запуска задания, она помечает это задание как завершенное. Эти сведения об ошибке планирования возвращаются в schedulingError элементе в тексте ответа элемента Получение сведений о задании в API пакетной службы .

В следующей таблице предоставлен список категорий для ошибок планирования задач.

Категория Описание
UserError Ошибки в спецификации задачи, предоставленной пользователем.
ServerError Ошибки, обнаруженные пакетной службой, которые препятствуют планированию задачи.

Ниже приведен пример ошибки предварительной обработки, возвращаемой пакетной службой.

{
  "preProcessingError": {
    "category": "UserError",
    "code": "BlobNotFound",
    "message": "The specified blob does not exist.",
    "values": {
      "name": "FilePath",
      "value": "myfile.txt"
    }
  }
}

В следующей таблице приведен список кодов ошибок планирования заданий, которые могут быть возвращены пакетной службой.

Код ошибки Категория Сообщение для пользователя
InvalidCertificatesInAutoPool UserError Недопустимые ссылки на сертификат в спецификации автоматического пула.
AutoPoolCreationFailedWithQuotaReached UserError Достигнута квота пула для учетной записи.
InvalidApplicationPackageReferencesInAutoPool UserError Один или несколько пакетов приложений, указанных для пула, являются недопустимыми.
InvalidAutoScaleFormulaInAutoPool UserError Указаны недопустимые параметры автоматического масштабирования.
InvalidAutoPoolSettings UserError Указанные параметры автопополя являются недопустимыми.
JobBeingTerminated UserError Не удается запустить задачу, так как связанное задание завершается.
Неизвестно ServerError Произошла неизвестная ошибка планирования.

В следующей таблице приведен список кодов ошибок планирования задач, которые могут быть возвращены пакетной службой.

Код ошибки Категория Сообщение для пользователя
BlobNotFound UserError Один из указанных BLOB-объектов Azure не найден.
BlobAccessDenied UserError Доступ к одному из указанных BLOB-объектов Azure запрещен.
BlobDownloadTimedOut ServerError Истекло время ожидания при скачивании одного из указанных BLOB-объектов Azure.
BlobDownloadMiscError ServerError При скачивании одного из указанных BLOB-объектов Azure возникла другая ошибка.
ResourceDirectoryCreateFailed ServerError Произошла ошибка при создании каталога ресурсов для задачи.
ResourceFileCreateFailed ServerError Произошла ошибка при создании файла ресурсов.
ResourceFileWriteFailed ServerError Произошла ошибка при записи файла ресурсов.
CommandProgramNotFound UserError Указанная командная программа не найдена.
CommandLaunchFailed UserError Не удалось запустить указанную командную строку.
TaskEnded UserError Задача была завершена запросом пользователя.
MaxInternalRetryCountReached UserError Для указанной задачи достигнуто максимальное число внутренних повторных попыток.
TaskSchedulingConstraintFailed UserError Невозможно запланировать задачу в пуле, связанном с заданием
DiskFull ServerError На узле, выбранном для выполнения задачи, недостаточно места на диске.
Неизвестно ServerError Произошла неизвестная ошибка планирования.
  • Last updated on