Job - Enable
Abilita il processo specificato, consentendo l'esecuzione di nuove attività.
Quando si chiama questa API, il servizio Batch imposta un processo disabilitato sullo stato di abilitazione. Al termine dell'operazione, il processo passa allo stato attivo e la pianificazione delle nuove attività nel processo riprende. Il servizio Batch non consente a un'attività di rimanere nello stato attivo per più di 180 giorni. Pertanto, se si abilita un processo contenente attività attive aggiunte più di 180 giorni fa, tali attività non verranno eseguite.
POST {batchUrl}/jobs/{jobId}/enable?api-version=2024-07-01.20.0
POST {batchUrl}/jobs/{jobId}/enable?timeout={timeout}&api-version=2024-07-01.20.0
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
batch
|
path | True |
string |
URL di base per tutte le richieste del servizio Azure Batch. |
job
|
path | True |
string |
ID del processo da abilitare. |
api-version
|
query | True |
string |
Versione dell'API client. |
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 | Necessario | 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. |
|
If-Match |
string |
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client. |
|
If-None-Match |
string |
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client. |
|
If-Modified-Since |
string (date-time-rfc1123) |
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata. |
|
If-Unmodified-Since |
string (date-time-rfc1123) |
Timestamp che indica l'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
202 Accepted |
La richiesta al servizio Batch ha avuto esito positivo. Intestazioni
|
|
Other Status Codes |
Errore del servizio Batch. |
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 enable
Esempio di richiesta
POST account.region.batch.azure.com/jobs/jobId/enable?api-version=2024-07-01.20.0
Risposta di esempio
Definizioni
Nome | Descrizione |
---|---|
Batch |
Risposta di errore ricevuta dal servizio Azure Batch. |
Batch |
Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch. |
Error |
Messaggio di errore ricevuto in una risposta di errore di Azure Batch. |
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 |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
|
values |
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. |
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. |