Job - List Preparation And Release Task Status

Usługa:

Batch Service

Wersja interfejsu API:

2023-11-01.18.0

Wyświetla stan wykonywania zadania przygotowania zadania i zwolnienia zadania dla określonego zadania w węzłach obliczeniowych, w których zadanie zostało uruchomione.
Ten interfejs API zwraca stan zadania przygotowania i wydania zadania we wszystkich węzłach obliczeniowych, które uruchamiają zadanie przygotowania zadania lub wydania zadania. Obejmuje to węzły obliczeniowe, które zostały od tego czasu usunięte z puli. Jeśli ten interfejs API jest wywoływany w zadaniu, które nie ma zadania przygotowania zadania lub wydania zadania, usługa Batch zwraca kod stanu HTTP 409 (konflikt) z kodem błędu JobPreparationTaskNotSpecified.

GET {batchUrl}/jobs/{jobId}/jobpreparationandreleasetaskstatus?api-version=2023-11-01.18.0

Z parametrami opcjonalnymi:

GET {batchUrl}/jobs/{jobId}/jobpreparationandreleasetaskstatus?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
batchUrl	path	True	string	Podstawowy adres URL wszystkich żądań obsługi Azure Batch.
jobId	path	True	string	Identyfikator zadania.
api-version	query	True	string	Wersja interfejsu API klienta.
$filter	query		string	Klauzula $filter OData. Aby uzyskać więcej informacji na temat konstruowania tego filtru, zobacz https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-job-preparation-and-release-status.
$select	query		string	Klauzula $select OData.
maxresults	query		integer int32	Maksymalna liczba elementów do zwrócenia w odpowiedzi. Można zwrócić maksymalnie 1000 zadań.
timeout	query		integer int32	Maksymalny czas, który serwer może poświęcić na przetwarzanie żądania w sekundach. Wartość domyślna to 30 sekund.

Nagłówek żądania

Media Types: "application/json; odata=minimalmetadata"

Nazwa	Wymagane	Typ	Opis
client-request-id		string uuid	Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Czy serwer powinien zwrócić wartość client-request-id w odpowiedzi.
ocp-date		string date-time-rfc1123	Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CloudJobListPreparationAndReleaseTaskStatusResult	Odpowiedź zawierająca listę stanów zadania przygotowania zadania i wydania zadania. Nagłówki client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Błąd usługi Batch. Jeśli ten interfejs API jest wywoływany w zadaniu, które nie ma zadania przygotowania zadania lub zwolnienia zadania, usługa Batch zwraca kod stanu HTTP 409.

Zabezpieczenia

azure_auth

Microsoft Entra przepływ kodu uwierzytelniania OAuth 2.0

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	Personifikuj konto użytkownika

Authorization

Typ: apiKey
W: header

Przykłady

Job list preparation and release task status

Przykładowe żądanie

HTTP

GET account.region.batch.azure.com/jobs/jobId/jobpreparationandreleasetaskstatus?api-version=2023-11-01.18.0

Przykładowa odpowiedź

Kod stanu:

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=2023-11-01.18.0"
}

Definicje

Nazwa	Opis
BatchError	Odpowiedź o błędzie odebrana z usługi Azure Batch.
BatchErrorDetail	Element dodatkowych informacji zawartych w odpowiedzi Azure Batch błędu.
CloudJobListPreparationAndReleaseTaskStatusResult	Wynik wyświetlania stanu zadań przygotowania zadania i zadania wydania zadania dla zadania.
ErrorCategory	Kategoria błędu.
ErrorMessage	Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.
JobPreparationAndReleaseTaskExecutionInformation	Stan zadań przygotowywania i wydawania zadań w węźle obliczeniowym.
JobPreparationTaskExecutionInformation	Zawiera informacje o wykonywaniu zadania przygotowania zadania w węźle obliczeniowym.
JobPreparationTaskState	Bieżący stan zadania przygotowania zadania w węźle obliczeniowym.
JobReleaseTaskExecutionInformation	Zawiera informacje o wykonywaniu zadania wydania zadania w węźle obliczeniowym.
JobReleaseTaskState	Bieżący stan zadania wydania zadania w węźle obliczeniowym.
NameValuePair	Reprezentuje parę name-value.
TaskContainerExecutionInformation	Zawiera informacje o kontenerze, który wykonuje zadanie.
TaskExecutionResult	Wynik wykonania zadania.
TaskFailureInformation	Informacje o niepowodzeniu zadania.

BatchError

Odpowiedź o błędzie odebrana z usługi Azure Batch.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	ErrorMessage	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
values	BatchErrorDetail[]	Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi Azure Batch błędu.

Nazwa	Typ	Opis
key	string	Identyfikator określający znaczenie właściwości Value.
value	string	Dodatkowe informacje zawarte w odpowiedzi na błąd.

CloudJobListPreparationAndReleaseTaskStatusResult

Wynik wyświetlania stanu zadań przygotowania zadania i zadania wydania zadania dla zadania.

Nazwa	Typ	Opis
odata.nextLink	string	Adres URL umożliwiający uzyskanie następnego zestawu wyników.
value	JobPreparationAndReleaseTaskExecutionInformation[]	Lista informacji o przygotowaniu zadania i wykonaniu zadania wydania zadania.

ErrorCategory

Kategoria błędu.

Nazwa	Typ	Opis
servererror	string	Błąd jest spowodowany wewnętrznym problemem z serwerem.
usererror	string	Błąd jest spowodowany problemem użytkownika, takim jak błędna konfiguracja.

ErrorMessage

Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.

Nazwa	Typ	Opis
lang	string	Kod języka komunikatu o błędzie
value	string	Tekst wiadomości.

JobPreparationAndReleaseTaskExecutionInformation

Stan zadań przygotowywania i wydawania zadań w węźle obliczeniowym.

Nazwa	Typ	Opis
jobPreparationTaskExecutionInfo	JobPreparationTaskExecutionInformation	Informacje o stanie wykonywania zadania przygotowania zadania w tym węźle obliczeniowym.
jobReleaseTaskExecutionInfo	JobReleaseTaskExecutionInformation	Informacje o stanie wykonywania zadania wydania zadania w tym węźle obliczeniowym. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie wydania zadania zostało uruchomione w węźle obliczeniowym.
nodeId	string	Identyfikator węzła obliczeniowego, do którego odwołuje się ten wpis.
nodeUrl	string	Adres URL węzła obliczeniowego, do którego odwołuje się ten wpis.
poolId	string	Identyfikator puli zawierającej węzeł obliczeniowy, do którego odwołuje się ten wpis.

JobPreparationTaskExecutionInformation

Zawiera informacje o wykonywaniu zadania przygotowania zadania w węźle obliczeniowym.

Nazwa	Typ	Opis
containerInfo	TaskContainerExecutionInformation	Informacje o kontenerze, w którym jest wykonywane zadanie. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie jest uruchamiane w kontekście kontenera.
endTime	string	Czas ukończenia zadania przygotowania zadania. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie jest w stanie Ukończono.
exitCode	integer	Kod zakończenia programu określony w wierszu polecenia Zadania. Ten parametr jest zwracany tylko wtedy, gdy zadanie jest w stanie ukończonym. Kod zakończenia procesu odzwierciedla konkretną konwencję zaimplementowaną przez dewelopera aplikacji dla tego procesu. Jeśli używasz wartości kodu zakończenia do podejmowania decyzji w kodzie, upewnij się, że znasz konwencję kodu zakończenia używaną przez proces aplikacji. Należy pamiętać, że kod zakończenia może być również generowany przez system operacyjny węzła obliczeniowego, na przykład w przypadku wymuszonego zakończenia procesu.
failureInfo	TaskFailureInformation	Informacje opisujące błąd zadania, jeśli istnieje. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie jest w stanie ukończonym i napotkało błąd.
lastRetryTime	string	Ostatni raz, w którym rozpoczęto ponawianie zadania przygotowania zadania. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie zostało ponowione (tj. retryCount jest niezerowe). Jeśli istnieje, jest to zwykle takie samo jak startTime, ale może się różnić, jeśli zadanie zostało ponownie uruchomione z powodów innych niż ponawianie próby; jeśli na przykład węzeł obliczeniowy został ponownie uruchomiony podczas ponawiania próby, czas rozpoczęcia jest aktualizowany, ale czas ostatniego czasu nie jest.
result	TaskExecutionResult	Wynik wykonania zadania. Jeśli wartość to "failed", szczegóły błędu można znaleźć we właściwości failureInfo.
retryCount	integer	Liczba ponownych prób wykonania zadania przez usługę Batch. Błędy aplikacji zadań (kod zakończenia niezerowy) są ponawiane, błędy przetwarzania wstępnego (nie można uruchomić zadania) i błędy przekazywania plików nie są ponawiane. Usługa Batch ponowi próbę wykonania zadania do limitu określonego przez ograniczenia. Błędy aplikacji zadań (kod zakończenia niezerowy) są ponawiane, błędy przetwarzania wstępnego (nie można uruchomić zadania) i błędy przekazywania plików nie są ponawiane. Usługa Batch ponowi próbę wykonania zadania do limitu określonego przez ograniczenia.
startTime	string	Czas, w którym zadanie zaczęło działać. Jeśli zadanie zostało uruchomione ponownie lub ponowione, jest to ostatni raz, w którym zadanie zostało uruchomione.
state	JobPreparationTaskState	Bieżący stan zadania przygotowania zadania w węźle obliczeniowym.
taskRootDirectory	string	Katalog główny zadania przygotowania zadania w węźle obliczeniowym. Ta ścieżka służy do pobierania plików utworzonych przez zadanie, takich jak pliki dziennika.
taskRootDirectoryUrl	string	Adres URL katalogu głównego zadania przygotowania zadania w węźle obliczeniowym.

JobPreparationTaskState

Bieżący stan zadania przygotowania zadania w węźle obliczeniowym.

Nazwa	Typ	Opis
completed	string	Zadanie zakończyło działanie z kodem zakończenia 0 lub zadanie wyczerpało limit ponawiania prób lub usługa Batch nie mogła uruchomić zadania z powodu błędów przygotowania zadania (takich jak błędy pobierania plików zasobów).
running	string	Zadanie jest obecnie uruchomione (w tym ponawianie próby).

JobReleaseTaskExecutionInformation

Zawiera informacje o wykonywaniu zadania wydania zadania w węźle obliczeniowym.

Nazwa	Typ	Opis
containerInfo	TaskContainerExecutionInformation	Informacje o kontenerze, w którym jest wykonywane zadanie. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie jest uruchamiane w kontekście kontenera.
endTime	string	Czas ukończenia zadania wydania zadania. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie jest w stanie Ukończono.
exitCode	integer	Kod zakończenia programu określony w wierszu polecenia Zadania. Ten parametr jest zwracany tylko wtedy, gdy zadanie jest w stanie ukończonym. Kod zakończenia procesu odzwierciedla konkretną konwencję zaimplementowaną przez dewelopera aplikacji dla tego procesu. Jeśli używasz wartości kodu zakończenia do podejmowania decyzji w kodzie, upewnij się, że znasz konwencję kodu zakończenia używaną przez proces aplikacji. Należy pamiętać, że kod zakończenia może być również generowany przez system operacyjny węzła obliczeniowego, na przykład w przypadku wymuszonego zakończenia procesu.
failureInfo	TaskFailureInformation	Informacje opisujące błąd zadania, jeśli istnieje. Ta właściwość jest ustawiana tylko wtedy, gdy zadanie jest w stanie ukończonym i napotkało błąd.
result	TaskExecutionResult	Wynik wykonania zadania. Jeśli wartość to "failed", szczegóły błędu można znaleźć we właściwości failureInfo.
startTime	string	Czas, w którym zadanie zaczęło działać. Jeśli zadanie zostało uruchomione ponownie lub ponowione, jest to ostatni raz, w którym zadanie zostało uruchomione.
state	JobReleaseTaskState	Bieżący stan zadania wydania zadania w węźle obliczeniowym.
taskRootDirectory	string	Katalog główny zadania wydania zadania w węźle obliczeniowym. Ta ścieżka służy do pobierania plików utworzonych przez zadanie, takich jak pliki dziennika.
taskRootDirectoryUrl	string	Adres URL katalogu głównego zadania wydania zadania w węźle obliczeniowym.

JobReleaseTaskState

Bieżący stan zadania wydania zadania w węźle obliczeniowym.

Nazwa	Typ	Opis
completed	string	Zadanie zakończyło działanie z kodem zakończenia 0 lub zadanie wyczerpało limit ponawiania prób lub usługa Batch nie mogła uruchomić zadania z powodu błędów przygotowania zadania (takich jak błędy pobierania plików zasobów).
running	string	Zadanie jest obecnie uruchomione (w tym ponawianie próby).

NameValuePair

Reprezentuje parę name-value.

Nazwa	Typ	Opis
name	string	Nazwa w parze name-value.
value	string	Wartość w parze name-value.

TaskContainerExecutionInformation

Zawiera informacje o kontenerze, który wykonuje zadanie.

Nazwa	Typ	Opis
containerId	string	Identyfikator kontenera.
error	string	Szczegółowe informacje o błędzie dotyczące kontenera. Jest to szczegółowy ciąg błędu z usługi Docker, jeśli jest dostępny. Jest to odpowiednik pola błędu zwróconego przez "docker inspect".
state	string	Stan kontenera. Jest to stan kontenera zgodnie z usługą Docker. Jest to odpowiednik pola stanu zwróconego przez "docker inspect".

TaskExecutionResult

Wynik wykonania zadania.

Nazwa	Typ	Opis
failure	string	Wystąpił błąd podczas przetwarzania zadania. Błąd mógł wystąpić przed uruchomieniem procesu zadania, podczas gdy proces zadania był wykonywany lub po zakończeniu procesu zadania.
success	string	Zadanie uruchomiono pomyślnie.

TaskFailureInformation

Informacje o niepowodzeniu zadania.

Nazwa	Typ	Opis
category	ErrorCategory	Kategoria błędu zadania.
code	string	Identyfikator błędu zadania. Kody są niezmienne i mają być używane programowo.
details	NameValuePair[]	Lista dodatkowych szczegółów związanych z błędem.
message	string	Komunikat opisujący błąd zadania, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.