Jobs - List Job Preparation And Release Task Status

Служба:: Batch Service

Версия API:: 2025-06-01

Отображается статус выполнения задачи подготовки и выпуска задания для указанной задачи на вычислительных узлах, где она выполнялась.
Этот API возвращает статус Job Preparation и Job Release Task на всех вычислительных узлах, которые выполняли Job Preparation или Job Release Task. Это включает вычислительные узлы, которые впоследствии были удалены из пула. Если этот API вызывается на задании, в котором нет задач Job Preparation или Job Release Task, пакетный сервис возвращает HTTP-статус 409 (Conflict) с кодом ошибки JobPreparationTaskNotSpecified.

GET {endpoint}/jobs/{jobId}/jobpreparationandreleasetaskstatus?api-version=2025-06-01

С использованием необязательных параметров:

GET {endpoint}/jobs/{jobId}/jobpreparationandreleasetaskstatus?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&$select={$select}

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (uri)	Конечная точка учетной записи пакетной службы (например, https://batchaccount.eastus2.batch.azure.com).
jobId	path	True	string	Идентификация работы.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
$filter	query		string	Предложение OData $filter. Для получения дополнительной информации о построении этого фильтра см. https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-job-preparation-and-release-status.
$select	query		string[]	Предложение OData $select.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Максимальное количество элементов, возвращаемых в ответе. Максимум может быть возвращено 1000 заявок.
timeOut	query		integer (int32)	Максимальное время, которое сервер может тратить на обработку запроса в секундах. Значение по умолчанию — 30 секунд. Если значение превышает 30, вместо этого используется стандартное значение.".

Заголовок запроса

Имя	Тип	Описание
client-request-id	string	Удостоверение запроса, созданное вызывающим пользователем, в виде GUID без украшений, таких как фигурные скобки, например 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Должен ли сервер возвращать идентификатор client-request-id в ответе.
ocp-date	string (date-time-rfc7231)	Время выдачи запроса. Клиентские библиотеки обычно задают это в текущее время системных часов; задайте его явным образом, если вы вызываете REST API напрямую.

Ответы

Имя	Тип	Описание
200 OK	BatchJobPreparationAndReleaseTaskStatusListResult	Запрос выполнен успешно. Заголовки ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

BatchJobPreparationAndReleaseTaskStatusListResult

Запрос выполнен успешно.

Заголовки

ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Непредвиденное сообщение об ошибке.

Безопасность

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Области

Имя	Описание
https://batch.core.windows.net//.default

Примеры

Job list preparation and release task status

Образец запроса

HTTP

GET {endpoint}/jobs/jobId/jobpreparationandreleasetaskstatus?api-version=2025-06-01

Пример ответа

Код состояния:: 200

{
  "value": [
    {
      "poolId": "poolId",
      "nodeId": "tvm-2167304207_1-20140905t174658z",
      "nodeUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_1-20140905t174658z",
      "jobPreparationTaskExecutionInfo": {
        "state": "completed",
        "startTime": "2015-05-01T10:20:31Z",
        "endTime": "2015-05-02T20:12:42Z",
        "taskRootDirectory": "tasks/myjob/job-1/myjobpreptask",
        "taskRootDirectoryUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_1-20140905t174658z/files/tasks/myjob/job-1/myjobpreptask",
        "exitCode": 0,
        "retryCount": 0
      },
      "jobReleaseTaskExecutionInfo": {
        "state": "completed",
        "startTime": "2015-05-01T10:20:31Z",
        "endTime": "2015-05-02T20:12:42Z",
        "taskRootDirectory": "tasks/myjob/job-1/myjobreleasetask",
        "taskRootDirectoryUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_1-20140905t174658z/files/tasks/myjob/job-1/myjobreleasetask",
        "exitCode": 0
      }
    }
  ],
  "odata.nextLink": "https://account.region.batch.azure.com/jobs/myjob/jobpreparationandreleasestatus?$skipToken=tvm-2167304207_1-20140905t174658z&api-version=2025-06-01"
}

Определения

Имя	Описание
BatchError	Ответ об ошибке, полученный из пакетной службы Azure.
BatchErrorDetail	Элемент дополнительных сведений, включенных в ответ на ошибку пакетной службы Azure.
BatchErrorMessage	Сообщение об ошибке, полученное в ответе на ошибку пакетной службы Azure.
BatchErrorSourceCategory	Enums BatchErrorSourceCategory
BatchJobPreparationAndReleaseTaskStatus	Состояние задач подготовки задания и выпуска заданий на вычислительном узле.
BatchJobPreparationAndReleaseTaskStatusListResult	Результат перечисления состояния задач подготовки заданий и выпуска заданий для задания.
BatchJobPreparationTaskExecutionInfo	Содержит сведения о выполнении задачи подготовки заданий на вычислительном узле.
BatchJobPreparationTaskState	BatchJobPreparationTaskState enums
BatchJobReleaseTaskExecutionInfo	Содержит сведения о выполнении задачи выпуска задания на вычислительном узле.
BatchJobReleaseTaskState	BatchJobReleaseTaskState enums
BatchTaskContainerExecutionInfo	Содержит сведения о контейнере, который выполняет задача.
BatchTaskExecutionResult	BatchTaskExecutionResult enums
BatchTaskFailureInfo	Сведения о сбое задачи.
NameValuePair	Представляет пару "имя-значение".

BatchError

Объект

Ответ об ошибке, полученный из пакетной службы Azure.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
message	BatchErrorMessage	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
values	BatchErrorDetail[]	Коллекция пар "ключ-значение", содержащая дополнительные сведения об ошибке.

BatchErrorDetail

Объект

Элемент дополнительных сведений, включенных в ответ на ошибку пакетной службы Azure.

Имя	Тип	Описание
key	string	Идентификатор, указывающий значение свойства Value.
value	string	Дополнительные сведения, включенные в ответ на ошибку.

BatchErrorMessage

Объект

Сообщение об ошибке, полученное в ответе на ошибку пакетной службы Azure.

Имя	Тип	Описание
lang	string	Языковой код сообщения об ошибке.
value	string	Текст сообщения.

BatchErrorSourceCategory

Перечисление

Enums BatchErrorSourceCategory

Значение	Описание
usererror	Ошибка возникла из-за пользовательской проблемы, например, неправильной настройки.
servererror	Ошибка связана с внутренней проблемой сервера.

BatchJobPreparationAndReleaseTaskStatus

Объект

Состояние задач подготовки задания и выпуска заданий на вычислительном узле.

Имя	Тип	Описание
jobPreparationTaskExecutionInfo	BatchJobPreparationTaskExecutionInfo	Информация о статусе выполнения задачи подготовки задания на этом вычислительном узле.
jobReleaseTaskExecutionInfo	BatchJobReleaseTaskExecutionInfo	Информация о состоянии выполнения задачи освобождения задания на этом вычислительном узле. Это свойство задаётся только в том случае, если задача освобождения задания выполнена на вычислительном узле.
nodeId	string	ID вычислительного узла, к которому относится эта запись.
nodeUrl	string (uri)	URL вычислительного узла, к которому относится эта запись.
poolId	string	ID пула, содержащего вычислительный узел, к которому относится эта запись.

BatchJobPreparationAndReleaseTaskStatusListResult

Объект

Результат перечисления состояния задач подготовки заданий и выпуска заданий для задания.

Имя	Тип	Описание
odata.nextLink	string (uri)	URL-адрес для получения следующего набора результатов.
value	BatchJobPreparationAndReleaseTaskStatus[]	Список информации о подготовке и освобождении заданий.

BatchJobPreparationTaskExecutionInfo

Объект

Содержит сведения о выполнении задачи подготовки заданий на вычислительном узле.

Имя	Тип	Описание
containerInfo	BatchTaskContainerExecutionInfo	Информация о контейнере, в котором выполняется задача. Это свойство задаётся только если задача выполняется в контейнерном контексте.
endTime	string (date-time)	Время, когда завершён Задание по подготовке работы. Это свойство задаётся только если задача находится в состоянии Выполнено.
exitCode	integer (int32)	Код выхода программы, указанный в командной строке задачи. Этот параметр возвращается только если задача находится в состоянии выполнения. Выходной код процесса отражает конкретную конвенцию, реализованную разработчиком приложения для этого процесса. Если вы используете значение выходного кода для принятия решений в коде, убедитесь, что знаете конвенцию выходного кода, применяемую в процессе применения. Обратите внимание, что выходной код также может быть сгенерирован операционной системой Compute Node, например, когда процесс принудительно завершается.
failureInfo	BatchTaskFailureInfo	Информация, описывающая сбой задачи, если она есть. Это свойство устанавливается только если задача находится в состоянии завершения и столкнулась с ошибкой.
lastRetryTime	string (date-time)	Последний раз, когда началось повторное выполнение Задания подготовки к работе. Это свойство задаётся только если задача была повторна (то есть retryCount не равен нулю). Если она присутствует, это обычно то же самое, что и startTime, но может отличаться, если задача была перезапущена по причинам, отличным от повторной попытки; например, если Compute Node был перезапущен во время повторной попытки, то startTime обновляется, а lastRetryTime — нет.
result	BatchTaskExecutionResult	Результат выполнения задачи. Если значение «failed», детали отказа можно найти в свойстве failureInfo.
retryCount	integer (int32)	Количество повторных попыток Task сервисом Batch. Ошибки приложений задачи (ненулевой выходной код) повторяются, ошибки предварительной обработки (задача не удаётся выполнить) и ошибки загрузки файлов не повторяются. Пакетный сервис повторяет выполнение задачи до предела, указанного ограничениями. Ошибки приложений задачи (ненулевой выходной код) повторяются, ошибки предварительной обработки (задача не удаётся выполнить) и ошибки загрузки файлов не повторяются. Пакетный сервис повторяет выполнение задачи до предела, указанного ограничениями.
startTime	string (date-time)	Время, когда Задание начало работать. Если задача была перезапущена или попробована повторно, это самое недавнее начало запуска.
state	BatchJobPreparationTaskState	Текущее состояние задачи подготовки задачи на вычислительном узле.
taskRootDirectory	string	Корневой каталог задачи подготовки задания на вычислительном узле. Этот путь можно использовать для получения файлов, созданных задачей, таких как лог-файлы.
taskRootDirectoryUrl	string (uri)	URL корневого каталога задачи подготовки задания на вычислительном узле.

BatchJobPreparationTaskState

Перечисление

BatchJobPreparationTaskState enums

Значение	Описание
running	Задача сейчас работает (включая повторную попытку).
completed	Задача завершилась с кодом выхода 0, или задача исчерпала лимит повторных попыток, или пакетная служба не смогла запустить задачу из-за ошибок подготовки задачи (например, сбоя загрузки файла ресурсов).

BatchJobReleaseTaskExecutionInfo

Объект

Содержит сведения о выполнении задачи выпуска задания на вычислительном узле.

Имя	Тип	Описание
containerInfo	BatchTaskContainerExecutionInfo	Информация о контейнере, в котором выполняется задача. Это свойство задаётся только если задача выполняется в контейнерном контексте.
endTime	string (date-time)	Время завершения задачи на освобождение работы. Это свойство задаётся только если задача находится в состоянии Выполнено.
exitCode	integer (int32)	Код выхода программы, указанный в командной строке задачи. Этот параметр возвращается только если задача находится в состоянии выполнения. Выходной код процесса отражает конкретную конвенцию, реализованную разработчиком приложения для этого процесса. Если вы используете значение выходного кода для принятия решений в коде, убедитесь, что знаете конвенцию выходного кода, применяемую в процессе применения. Обратите внимание, что выходной код также может быть сгенерирован операционной системой Compute Node, например, когда процесс принудительно завершается.
failureInfo	BatchTaskFailureInfo	Информация, описывающая сбой задачи, если она есть. Это свойство устанавливается только если задача находится в состоянии завершения и столкнулась с ошибкой.
result	BatchTaskExecutionResult	Результат выполнения задачи. Если значение «failed», детали отказа можно найти в свойстве failureInfo.
startTime	string (date-time)	Время, когда Задание начало работать. Если задача была перезапущена или попробована повторно, это самое недавнее начало запуска.
state	BatchJobReleaseTaskState	Текущее состояние задачи освобождения заданий на вычислительном узле.
taskRootDirectory	string	Корневой каталог задачи выпуска заданий на вычислительном узле. Этот путь можно использовать для получения файлов, созданных задачей, таких как лог-файлы.
taskRootDirectoryUrl	string (uri)	URL корневой каталога задачи освобождения задания на вычислительном узле.

BatchJobReleaseTaskState

Перечисление

BatchJobReleaseTaskState enums

Значение	Описание
running	Задача сейчас работает (включая повторную попытку).
completed	Задача завершилась с кодом выхода 0, или задача исчерпала лимит повторных попыток, или пакетная служба не смогла запустить задачу из-за ошибок подготовки задачи (например, сбоя загрузки файла ресурсов).

BatchTaskContainerExecutionInfo

Объект

Содержит сведения о контейнере, который выполняет задача.

Имя	Тип	Описание
containerId	string	Идентификатор контейнера.
error	string	Подробная информация об ошибках контейнера. Это подробная строка ошибки из сервиса Docker, если она доступна. Он эквивалентен полю ошибки, возвращаемому «docker inspect».
state	string	Состояние контейнера. Это состояние контейнера согласно сервису Docker. Он эквивалентен статусному полю, возвращаемому «docker inspect».

BatchTaskExecutionResult

Перечисление

BatchTaskExecutionResult enums

Значение	Описание
success	Задача прошла успешно.
failure	Произошла ошибка во время обработки задачи. Сбой мог произойти до запуска процесса задачи, во время выполнения процесса задачи или после завершения процесса.

BatchTaskFailureInfo

Объект

Сведения о сбое задачи.

Имя	Тип	Описание
category	BatchErrorSourceCategory	Категория ошибки задачи.
code	string	Идентификатор ошибки задачи. Коды являются инвариантными и предназначены для программного использования.
details	NameValuePair[]	Список дополнительных деталей, связанных с ошибкой.
message	string	Сообщение, описывающее ошибку задачи, предназначенное для отображения в пользовательском интерфейсе.

NameValuePair

Объект

Представляет пару "имя-значение".

Имя	Тип	Описание
name	string	Имя в паре имя-значение.
value	string	Значение в паре имя-значение.