Job - List Preparation And Release Task Status

Riferimento

Servizio:: Batch Service

Versione API:: 2024-07-01.20.0

Elenca lo stato di esecuzione dell'attività Preparazione processo e rilascio processo per il processo specificato nei nodi di calcolo in cui è stato eseguito il processo.
Questa API restituisce lo stato dell'attività Preparazione processo e Rilascio processo in tutti i nodi di calcolo che hanno eseguito l'attività Preparazione processo o Rilascio processo. Sono inclusi i nodi di calcolo che sono stati rimossi dal pool. Se questa API viene richiamata in un processo senza attività di preparazione del processo o rilascio del processo, il servizio Batch restituisce il codice di stato HTTP 409 (conflitto) con un codice di errore JobPreparationTaskNotSpecified.

GET {batchUrl}/jobs/{jobId}/jobpreparationandreleasetaskstatus?api-version=2024-07-01.20.0

Con parametri facoltativi:

GET {batchUrl}/jobs/{jobId}/jobpreparationandreleasetaskstatus?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
batchUrl	path	True	string	URL di base per tutte le richieste del servizio Azure Batch.
jobId	path	True	string	ID del processo.
api-version	query	True	string	Versione dell'API client.
$filter	query		string	Clausola di $filter OData. Per altre informazioni sulla creazione di questo filtro, vedere https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-job-preparation-and-release-status.
$select	query		string	Clausola di $select OData.
maxresults	query		integer int32	Numero massimo di elementi da restituire nella risposta. È possibile restituire un massimo di 1000 attività.
timeout	query		integer int32	Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è maggiore di 30, verrà usato il valore predefinito.

Intestazione della richiesta

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

Nome	Tipo	Descrizione
client-request-id	string uuid	Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Indica se il server deve restituire l'ID richiesta client nella risposta.
ocp-date	string date-time-rfc1123	Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.

Risposte

Nome	Tipo	Descrizione
200 OK	CloudJobListPreparationAndReleaseTaskStatusResult	Risposta contenente un elenco di stati attività di preparazione del processo e rilascio del processo. Intestazioni client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Errore del servizio Batch. Se questa API viene richiamata in un processo che non dispone di alcuna attività di preparazione del processo o di rilascio del processo, il servizio Batch restituisce il codice di stato HTTP 409.

Nome

Tipo

Descrizione

200 OK

CloudJobListPreparationAndReleaseTaskStatusResult

Risposta contenente un elenco di stati attività di preparazione del processo e rilascio del processo.

Intestazioni

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

Other Status Codes

BatchError

Errore del servizio Batch. Se questa API viene richiamata in un processo che non dispone di alcuna attività di preparazione del processo o di rilascio del processo, il servizio Batch restituisce il codice di stato HTTP 409.

Sicurezza

azure_auth

Flusso del codice di autenticazione di Microsoft Entra OAuth 2.0

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	Rappresentare l'account utente

Authorization

Tipo: apiKey
In: header

Esempio

Job list preparation and release task status

Esempio di richiesta

HTTP

GET account.region.batch.azure.com/jobs/jobId/jobpreparationandreleasetaskstatus?api-version=2024-07-01.20.0

Risposta di esempio

Codice di stato:: 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=2024-07-01.20.0"
}

Definizioni

Nome	Descrizione
BatchError	Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail	Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
CloudJobListPreparationAndReleaseTaskStatusResult	Risultato dell'elenco dello stato delle attività di preparazione e rilascio del processo per un processo.
ErrorCategory	Categoria dell'errore.
ErrorMessage	Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
JobPreparationAndReleaseTaskExecutionInformation	Stato delle attività di preparazione e rilascio dei processi in un nodo di calcolo.
JobPreparationTaskExecutionInformation	Contiene informazioni sull'esecuzione di un'attività di preparazione del processo in un nodo di calcolo.
JobPreparationTaskState	Stato corrente dell'attività di preparazione del processo nel nodo di calcolo.
JobReleaseTaskExecutionInformation	Contiene informazioni sull'esecuzione di un'attività di rilascio del processo in un nodo di calcolo.
JobReleaseTaskState	Stato corrente dell'attività di rilascio del processo nel nodo di calcolo.
NameValuePair	Rappresenta una coppia nome-valore.
TaskContainerExecutionInformation	Contiene informazioni sul contenitore in cui è in esecuzione un'attività.
TaskExecutionResult	Risultato dell'esecuzione dell'attività.
TaskFailureInformation	Informazioni su un errore di attività.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message	ErrorMessage	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
values	BatchErrorDetail[]	Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
key	string	Identificatore che specifica il significato della proprietà Value.
value	string	Informazioni aggiuntive incluse nella risposta di errore.

CloudJobListPreparationAndReleaseTaskStatusResult

Risultato dell'elenco dello stato delle attività di preparazione e rilascio del processo per un processo.

Nome	Tipo	Descrizione
odata.nextLink	string	URL per ottenere il set di risultati successivo.
value	JobPreparationAndReleaseTaskExecutionInformation[]	Elenco di informazioni sull'esecuzione delle attività di preparazione e rilascio processo.

ErrorCategory

Categoria dell'errore.

Nome	Tipo	Descrizione
servererror	string	L'errore è dovuto a un problema interno del server.
usererror	string	L'errore è dovuto a un problema dell'utente, ad esempio la configurazione errata.

ErrorMessage

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
lang	string	Codice linguistico del messaggio di errore
value	string	Testo del messaggio.

JobPreparationAndReleaseTaskExecutionInformation

Stato delle attività di preparazione e rilascio dei processi in un nodo di calcolo.

Nome	Tipo	Descrizione
jobPreparationTaskExecutionInfo	JobPreparationTaskExecutionInformation	Informazioni sullo stato di esecuzione dell'attività di preparazione del processo in questo nodo di calcolo.
jobReleaseTaskExecutionInfo	JobReleaseTaskExecutionInformation	Informazioni sullo stato di esecuzione dell'attività di rilascio del processo in questo nodo di calcolo. Questa proprietà viene impostata solo se l'attività di rilascio del processo è stata eseguita nel nodo di calcolo.
nodeId	string	ID del nodo di calcolo a cui fa riferimento questa voce.
nodeUrl	string	URL del nodo di calcolo a cui fa riferimento questa voce.
poolId	string	ID del pool contenente il nodo di calcolo a cui fa riferimento questa voce.

JobPreparationTaskExecutionInformation

Contiene informazioni sull'esecuzione di un'attività di preparazione del processo in un nodo di calcolo.

Nome	Tipo	Descrizione
containerInfo	TaskContainerExecutionInformation	Informazioni sul contenitore in cui è in esecuzione l'attività. Questa proprietà viene impostata solo se l'attività viene eseguita in un contesto contenitore.
endTime	string	Ora di completamento dell'attività di preparazione del processo. Questa proprietà viene impostata solo se l'oggetto Task è nello stato Completato.
exitCode	integer	Codice di uscita del programma specificato nella riga di comando Task. Questo parametro viene restituito solo se l'oggetto Task è nello stato completato. Il codice di uscita per un processo riflette la convenzione specifica implementata dallo sviluppatore dell'applicazione per tale processo. Se si usa il valore del codice di uscita per prendere decisioni nel codice, assicurarsi di conoscere la convenzione di codice di uscita usata dal processo dell'applicazione. Si noti che il codice di uscita può anche essere generato dal sistema operativo del nodo di calcolo, ad esempio quando un processo viene terminato forzatamente.
failureInfo	TaskFailureInformation	Informazioni che descrivono l'errore dell'attività, se presenti. Questa proprietà viene impostata solo se l'oggetto Task è nello stato completato e si è verificato un errore.
lastRetryTime	string	Ora più recente in cui è stata avviata l'esecuzione di un nuovo tentativo dell'attività di preparazione del processo. Questa proprietà viene impostata solo se l'attività è stata ritentata (ad esempio, retryCount è diverso da zero). Se presente, si tratta in genere dello stesso valore di startTime, ma può essere diverso se l'attività è stata riavviata per motivi diversi dai tentativi; Ad esempio, se il nodo di calcolo è stato riavviato durante un nuovo tentativo, startTime viene aggiornato ma lastRetryTime non è.
result	TaskExecutionResult	Risultato dell'esecuzione dell'attività. Se il valore è "failed", i dettagli dell'errore sono disponibili nella proprietà failureInfo.
retryCount	integer	Numero di tentativi di esecuzione dell'attività da parte del servizio Batch. Gli errori dell'applicazione attività (codice di uscita diverso da zero) vengono ritentati, vengono eseguiti errori di pre-elaborazione (non è stato possibile eseguire l'attività) e gli errori di caricamento dei file non vengono ritentati. Il servizio Batch ritenta l'attività fino al limite specificato dai vincoli. Gli errori dell'applicazione attività (codice di uscita diverso da zero) vengono ritentati, vengono eseguiti errori di pre-elaborazione (non è stato possibile eseguire l'attività) e gli errori di caricamento dei file non vengono ritentati. Il servizio Batch ritenta l'attività fino al limite specificato dai vincoli.
startTime	string	Ora in cui è stata avviata l'esecuzione dell'attività. Se l'attività è stata riavviata o ritentata, si tratta dell'ora più recente in cui l'attività è stata avviata l'esecuzione.
state	JobPreparationTaskState	Stato corrente dell'attività di preparazione del processo nel nodo di calcolo.
taskRootDirectory	string	Directory radice dell'attività di preparazione del processo nel nodo di calcolo. È possibile usare questo percorso per recuperare i file creati dall'attività, ad esempio i file di log.
taskRootDirectoryUrl	string	URL della directory radice dell'attività di preparazione del processo nel nodo di calcolo.

JobPreparationTaskState

Stato corrente dell'attività di preparazione del processo nel nodo di calcolo.

Nome	Tipo	Descrizione
completed	string	L'attività è stata chiusa con codice di uscita 0 oppure l'attività ha esaurito il limite di tentativi oppure il servizio Batch non è riuscito ad avviare l'attività a causa di errori di preparazione dell'attività ,ad esempio errori di download del file di risorse.
running	string	L'attività è attualmente in esecuzione (inclusa la ripetizione dei tentativi).

JobReleaseTaskExecutionInformation

Contiene informazioni sull'esecuzione di un'attività di rilascio del processo in un nodo di calcolo.

Nome	Tipo	Descrizione
containerInfo	TaskContainerExecutionInformation	Informazioni sul contenitore in cui è in esecuzione l'attività. Questa proprietà viene impostata solo se l'attività viene eseguita in un contesto contenitore.
endTime	string	Ora di completamento dell'attività di rilascio del processo. Questa proprietà viene impostata solo se l'oggetto Task è nello stato Completato.
exitCode	integer	Codice di uscita del programma specificato nella riga di comando Task. Questo parametro viene restituito solo se l'oggetto Task è nello stato completato. Il codice di uscita per un processo riflette la convenzione specifica implementata dallo sviluppatore dell'applicazione per tale processo. Se si usa il valore del codice di uscita per prendere decisioni nel codice, assicurarsi di conoscere la convenzione di codice di uscita usata dal processo dell'applicazione. Si noti che il codice di uscita può anche essere generato dal sistema operativo del nodo di calcolo, ad esempio quando un processo viene terminato forzatamente.
failureInfo	TaskFailureInformation	Informazioni che descrivono l'errore dell'attività, se presenti. Questa proprietà viene impostata solo se l'oggetto Task è nello stato completato e si è verificato un errore.
result	TaskExecutionResult	Risultato dell'esecuzione dell'attività. Se il valore è "failed", i dettagli dell'errore sono disponibili nella proprietà failureInfo.
startTime	string	Ora in cui è stata avviata l'esecuzione dell'attività. Se l'attività è stata riavviata o ritentata, si tratta dell'ora più recente in cui l'attività è stata avviata l'esecuzione.
state	JobReleaseTaskState	Stato corrente dell'attività di rilascio del processo nel nodo di calcolo.
taskRootDirectory	string	Directory radice dell'attività Di rilascio processo nel nodo di calcolo. È possibile usare questo percorso per recuperare i file creati dall'attività, ad esempio i file di log.
taskRootDirectoryUrl	string	URL della directory radice dell'attività Di rilascio processo nel nodo di calcolo.

JobReleaseTaskState

Stato corrente dell'attività di rilascio del processo nel nodo di calcolo.

Nome	Tipo	Descrizione
completed	string	L'attività è stata chiusa con codice di uscita 0 oppure l'attività ha esaurito il limite di tentativi oppure il servizio Batch non è riuscito ad avviare l'attività a causa di errori di preparazione dell'attività ,ad esempio errori di download del file di risorse.
running	string	L'attività è attualmente in esecuzione (inclusa la ripetizione dei tentativi).

NameValuePair

Rappresenta una coppia nome-valore.

Nome	Tipo	Descrizione
name	string	Nome nella coppia nome-valore.
value	string	Valore nella coppia nome-valore.

TaskContainerExecutionInformation

Contiene informazioni sul contenitore in cui è in esecuzione un'attività.

Nome	Tipo	Descrizione
containerId	string	ID del contenitore.
error	string	Informazioni dettagliate sull'errore sul contenitore. Questa è la stringa di errore dettagliata del servizio Docker, se disponibile. Equivale al campo di errore restituito da "docker inspect".
state	string	Stato del contenitore. Questo è lo stato del contenitore in base al servizio Docker. Equivale al campo di stato restituito da "docker inspect".

TaskExecutionResult

Risultato dell'esecuzione dell'attività.

Nome	Tipo	Descrizione
failure	string	Si è verificato un errore durante l'elaborazione dell'attività. L'errore potrebbe essersi verificato prima dell'avvio del processo attività, durante l'esecuzione del processo attività o dopo l'uscita del processo Attività.
success	string	L'attività è stata eseguita correttamente.

TaskFailureInformation

Informazioni su un errore di attività.

Nome	Tipo	Descrizione
category	ErrorCategory	Categoria dell'errore Attività.
code	string	Identificatore per l'errore task. I codici sono invarianti e devono essere utilizzati a livello di codice.
details	NameValuePair[]	Elenco di dettagli aggiuntivi relativi all'errore.
message	string	Messaggio che descrive l'errore dell'attività, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

Condividi tramite

Job - List Preparation And Release Task Status

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Authorization

Esempio

Job list preparation and release task status

Esempio di richiesta

Risposta di esempio

Definizioni

BatchError

BatchErrorDetail

CloudJobListPreparationAndReleaseTaskStatusResult

ErrorCategory

ErrorMessage

JobPreparationAndReleaseTaskExecutionInformation

JobPreparationTaskExecutionInformation

JobPreparationTaskState

JobReleaseTaskExecutionInformation

JobReleaseTaskState

NameValuePair

TaskContainerExecutionInformation

TaskExecutionResult

TaskFailureInformation

Risorse aggiuntive