Condividi tramite


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
batchUrl
path True

string

URL di base per tutte le richieste del servizio Azure Batch.

jobId
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

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

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
BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

BatchErrorDetail

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

ErrorMessage

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

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.

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.