Codici di errore e stato batch
Le operazioni api REST per il servizio Batch restituiscono codici di stato HTTP standard, come definito nelle definizioni di codice di stato HTTP/1.1.
Le operazioni API possono restituire anche informazioni aggiuntive sull'errore per fornire altri dati allo sviluppatore. Ad esempio, l'errore seguente indica che un parametro di query specificato nell'URI richiesta non è valido e fornisce altre informazioni sul nome e il valore del parametro non valido e il motivo dell'errore stesso.
{
"code": "InvalidQueryParameterValue",
"message": {
"lang": "en-us",
"value": "Value for one of the query parameters specified in the request URI is invalid"
},
"values": [{
"key": "QueryParameterName",
"value": "state"
}, {
"key": "QueryParameterValue",
"value": "deleted"
}, {
"key": "Reason",
"value": "invalid state"
}]
}
Le sezioni seguenti contengono gli elenchi dei codici di errore per il servizio Batch:
Codici di errore comuni dell'API REST
I codici di errore elencati nella tabella seguente possono essere restituiti da un'operazione eseguita nel servizio Batch.
| Codice di errore | Codice di stato HTTP | Messaggio utente |
|---|---|---|
| ConditionNotMet | Non modificato (304) | La condizione specificata nell'intestazione e nelle intestazioni condizionali non è stata soddisfatta per un'operazione di lettura. |
| MissingRequiredHeader | Richiesta non valida (400) | Intestazione HTTP obbligatoria non specificata. |
| MissingRequiredProperty | Richiesta non valida (400) | Una proprietà obbligatoria non è stata specificata nel corpo della richiesta. |
| UnsupportedHeader | Richiesta non valida (400) | Una delle intestazioni HTTP specificate nella richiesta non è supportata. |
| UnsupportedProperty | Richiesta non valida (400) | Una delle proprietà specificate nel corpo della richiesta non è supportata. |
| InvalidHeaderValue | Richiesta non valida (400) | Il valore specificato per una delle intestazioni HTTP non presenta il formato corretto. |
| InvalidPropertyValue | Richiesta non valida (400) | Il valore specificato per una delle proprietà nel corpo della richiesta non è valido. |
| MissingRequiredQueryParameter | Richiesta non valida (400) | Parametro di query obbligatorio non specificato per questa richiesta. |
| UnsupportedQueryParameter | Richiesta non valida (400) | Uno dei parametri di query specificati nell'URI della richiesta non è supportato. |
| InvalidQueryParameterValue | Richiesta non valida (400) | Valore non valido specificato per uno dei parametri di query nell'URI di richiesta. |
| OutOfRangeQueryParameterValue | Richiesta non valida (400) | Un parametro di query specificato nell'URI della richiesta non è compreso nell'intervallo consentito. |
| RequestUrlFailedToParse | Richiesta non valida (400) | Impossibile analizzare l'URL nella richiesta. |
| InvalidUri | Richiesta non valida (400) | L'URI richiesto non rappresenta risorse nel server. |
| InvalidHttpVerb | Richiesta non valida (400) | Il verbo HTTP specificato non è stato riconosciuto dal server. |
| EmptyMetadataKey | Richiesta non valida (400) | La chiave per una delle coppie chiave-valore dei metadati è vuota. |
| InvalidRequestBody | Richiesta non valida (400) | Il corpo della richiesta specificato non è sintatticamente valido. |
| OutOfRangeInput | Richiesta non valida (400) | Uno degli input della richiesta non è compreso nell'intervallo. |
| InvalidAuthenticationInfo | Richiesta non valida (400) | Le informazioni di autenticazione non sono state fornite nel formato corretto. Verificare il valore dell'intestazione Di autorizzazione . |
| InvalidInput | Richiesta non valida (400) | Uno degli input della richiesta non è valido. |
| InvalidMetadata | Richiesta non valida (400) | I metadati specificati non sono validi. Include caratteri non consentiti. |
| MetadataTooLarge | Richiesta non valida (400) | Le dimensioni dei metadati specificati superano le dimensioni massime consentite. |
| MultipleConditionHeadersNotSupported | Richiesta non valida (400) | Non sono supportate più intestazioni di condizione. |
| AuthenticationFailed | Non consentito (403) | Impossibile autenticare la richiesta. Verificare che il valore dell'intestazione di autorizzazione sia formato correttamente e includa la firma. |
| InsufficientAccountPermissions | Non consentito (403) | L'account a cui viene eseguito l'accesso non dispone di autorizzazioni sufficienti per eseguire questa operazione. |
| AccountIsDisabled | Non consentito (403) | L'account specificato è disabilitato. |
| ResourceNotFound | Non trovato (404) | La risorsa specificata non esiste. |
| UnsupportedHttpVerb | Metodo non consentito (405) | La risorsa non supporta il verbo HTTP specificato. |
| MissingContentLengthHeader | Lunghezza obbligatoria (411) | L'intestazione Content-Length non è stata specificata. |
| ConditionNotMet | Condizione preliminare non riuscita (412) | La condizione specificata nell'intestazione e nelle intestazioni condizionali non è stata soddisfatta per un'operazione di scrittura. |
| RequestBodyTooLarge | Entità della richiesta troppo grande (413) | Le dimensioni del corpo della richiesta superano le dimensioni massime consentite. |
| InvalidRange | Impossibile attenersi all'intervallo richiesto (416) | L'intervallo specificato non è valido per le dimensioni correnti della risorsa. |
| InternalError | Errore interno del server (500) | errore interno del server. Si prega di ripetere la richiesta. |
| OperationTimedOut | Errore interno del server (500) | L'operazione non è stata completata nel tempo consentito. |
| ServerBusy | Servizio non disponibile (503) | Il server non è attualmente in grado di ricevere richieste. Si prega di ripetere la richiesta. |
Codici di errore del servizio Batch
I codici di errore elencati nella tabella seguente possono essere restituiti da un'operazione eseguita nel servizio Batch.
| Codice di errore | Codice di stato HTTP | Messaggio utente |
|---|---|---|
| UnsupportedRequestVersion | Richiesta non valida (400) | La versione della richiesta specificata non è supportata. |
| InvalidAutoScalingSettings | Richiesta non valida (400) | Le impostazioni di scalabilità automatica specificate non sono valide. |
| AutoScalingFormulaSyntaxError | Richiesta non valida (400) | La formula di scalabilità automatica specificata contiene un errore di sintassi. |
| AutoScalingFormulaTooLong | Richiesta non valida (400) | La formula di scalabilità automatica specificata supera il limite di lunghezza. |
| OSVersionNotFound | Richiesta non valida (400) | La versione del sistema operativo specificata non esiste. |
| OSVersionDisabled | Richiesta non valida (400) | La versione del sistema operativo specificata è disabilitata. |
| OSVersionExpired | Richiesta non valida (400) | La versione del sistema operativo specificata è scaduta. |
| PoolVersionEqualsUpgradeVersion | Richiesta non valida (400) | Il pool è già nella versione specificata. |
| PoolNotEligibleForOSVersionUpgrade | Richiesta non valida (400) | Il pool specificato non è idoneo per l'aggiornamento della versione del sistema operativo. |
| PoolNotFound | Non trovato (404) | Il pool specificato non esiste. |
| NodeNotFound | Non trovato (404) | Il nodo specificato non esiste. |
| JobScheduleNotFound | Non trovato (404) | La pianificazione del processo specificata non esiste. |
| JobNotFound | Non trovato (404) | Il processo specificato non esiste. |
| TaskNotFound | Non trovato (404) | L'attività specificata non esiste. |
| FileNotFound | Non trovato (404) | Il file specificato non esiste. |
| NodeUserNotFound | Non trovato (404) | L'utente del nodo specificato non esiste. |
| CertificateNotFound | Non trovato (404) | Certificato specificato inesistente. |
| JobPreparationTaskNotRunOnNode | Non trovato (404) | L'attività di preparazione del processo non è stata eseguita nel nodo specificato. |
| JobReleaseTaskNotRunOnNode | Non trovato (404) | L'attività di rilascio del processo non è stata eseguita nel nodo specificato. |
| NodeAgentSKUNotFound | Non trovato (404) | Lo SKU dell'agente del nodo specificato non esiste. |
| OperationInvalidForCurrentState | Conflitto (409) | L'operazione specificata non è valida per lo stato corrente della risorsa. |
| PoolBeingDeleted | Conflitto (409) | Il pool specificato è stato contrassegnato per l'eliminazione ed è in corso il suo recupero. |
| PoolBeingResized | Conflitto (409) | È in corso il ridimensionamento del pool specificato. |
| PoolBeingCreated | Conflitto (409) | È in corso la creazione del pool specificato. |
| NodeBeingCreated | Conflitto (409) | Viene creato il nodo specificato |
| NodeBeingStarted | Conflitto (409) | Il nodo specificato viene avviato |
| NodeBeingReimaged | Conflitto (409) | Viene ricreata l'immagine del nodo specificato |
| NodeBeingRebooted | Conflitto (409) | Il nodo specificato viene riavviato |
| NodeStateUnusable | Conflitto (409) | Lo stato del nodo specificato non è utilizzabile |
| JobScheduleBeingTerminated | Conflitto (409) | La pianificazione del processo specificata viene terminata. |
| JobScheduleBeingDeleted | Conflitto (409) | La pianificazione del processo specificata è stata contrassegnata per l'eliminazione e viene recuperata. |
| CertificateBeingDeleted | Conflitto (409) | Il certificato specificato è stato contrassegnato per l'eliminazione ed è in corso la sua eliminazione. |
| PoolExists | Conflitto (409) | Il pool specificato esiste già. |
| JobScheduleExists | Conflitto (409) | La pianificazione del processo specificata esiste già. |
| NodeUserExists | Conflitto (409) | L'utente del nodo specificato esiste già. |
| JobExists | Conflitto (409) | Il processo specificato esiste già. |
| NodeUserExists | Conflitto (409) | L'utente del nodo specificato esiste già. |
| CertificateExists | Conflitto (409) | Il certificato specificato esiste già. |
| JobScheduleDisabled | Conflitto (409) | La pianificazione del processo specificata è disabilitata. |
| JobScheduleCompleted | Conflitto (409) | La pianificazione del processo specificata è già in stato completato. |
| JobBeingTerminated | Conflitto (409) | È in corso la terminazione del processo specificato. |
| JobBeingDeleted | Conflitto (409) | Il processo specificato è stato contrassegnato per l'eliminazione ed è in corso la Garbage Collection. |
| JobDisabled | Conflitto (409) | Il processo specificato è disabilitato. |
| JobCompleted | Conflitto (409) | Il processo specificato è già in stato completato. |
| JobNotActive | Conflitto (409) | Il processo specificato non è in stato attivo. |
| TaskExists | Conflitto (409) | L'attività specificata esiste già. |
| TaskCompleted | Conflitto (409) | L'attività specificata è già in stato completato. |
| TaskNotCompleted | Conflitto (409) | L'attività specificata non è in uno stato completato e l'operazione richiesta può essere eseguita solo sulle attività completate. |
| TaskSucceeded | Conflitto (409) | L'attività specificata è già stata completata correttamente e l'operazione richiesta non può essere eseguita sulle attività riuscite. |
| TaskFilesUnavailable | Conflitto (409) | I file dell'attività specificata non sono disponibili. |
| TaskFilesCleanedup | Conflitto (409) | È stata eseguita la pulizia dei file dell'attività specificata. |
| ActiveJobAndScheduleQuotaReached | Conflitto (409) | È stata raggiunta la quota di processo e pianificazione attiva per l'account. |
| PoolQuotaReached | Conflitto (409) | È stata raggiunta la quota di pool per l'account. |
| UpgradePoolVersionConflict | Conflitto (409) | Il pool sta già eseguendo l'aggiornamento a una versione diversa. |
| JobPreparationTaskNotSpecified | Conflitto (409) | Il processo specificato non dispone dell'attività di preparazione del processo. |
| JobReleaseTaskNotSpecified | Conflitto (409) | Il processo specificato non dispone di un'attività di rilascio del processo. |
| TaskIdSameAsJobPreparationTask | Conflitto (409) | L'ID attività specificato corrisponde all'attività di preparazione del processo. |
| TaskIdSameAsJobReleaseTask | Conflitto (409) | L'ID attività specificato è uguale all'attività di rilascio del processo. |
| JobWithSameIdExists | Conflitto (409) | Esiste un processo con l'ID pianificazione del processo specificato. La pianificazione del processo e del processo non può avere lo stesso ID. |
| JobScheduleWithSameIdExists | Conflitto (409) | Esiste una pianificazione del processo con l'ID processo specificato. La pianificazione del processo e del processo non può avere lo stesso ID. |
| NodeAlreadyInTargetSchedulingState | Conflitto (409) | Il nodo specificato è già nello stato di pianificazione di destinazione. |
| OperationNotValidOnNode | Conflitto (409) | L'operazione specificata non è valida nel nodo. |
| OperationNotValidOnPool | Conflitto (409) | L'operazione specificata non è valida nel pool. |
| IOError | Non consentito (403) | Si è verificato un errore di I/O durante l'accesso alla risorsa specificata. |
| TooManyEnableAutoScaleRequests | ServiceUnavailable (503) | Troppe richieste abilita scalabilità automatica del pool vengono inviate nel pool. |
| ApplicationNotFound | Non trovato (404) | L'applicazione specificata non esiste. |
| InvalidApplicationPackageReferences | Conflitto (409) | Non è stato possibile soddisfare uno o più riferimenti al pacchetto dell'applicazione. Ciò si verifica se l'ID applicazione o la versione non esiste o non è attiva oppure se il riferimento non ha specificato una versione e non è configurata alcuna versione predefinita. |
| TaskDependenciesNotSpecifiedOnJob | Richiesta non valida (400) | Un'attività è stata specificata in base ad altre attività, ma il processo non ha specificato che userebbe le dipendenze delle attività. |
| TaskDependencyListTooLong | Richiesta non valida (400) | Un'attività è stata specificata in base ad altre attività, ma l'elenco delle dipendenze era troppo lungo da archiviare. La lunghezza totale archiviata è limitata a 64000 caratteri; la lunghezza totale degli ID attività deve essere leggermente inferiore a questa per consentire un sovraccarico interno dell'archiviazione. Se si verifica questo errore, è consigliabile usare le dipendenze dell'intervallo di attività. |
| TaskDependencyRangesTooLong | Richiesta non valida (400) | Un'attività è stata specificata in base a più intervalli di ID attività e l'elenco di intervalli è troppo lungo da archiviare. Si noti che il problema non è con le dimensioni degli intervalli, ma con il numero di intervalli. |
Codici di errore di pianificazione di processi/attività
Se il servizio Batch rileva un errore durante l'avvio di un'attività in un nodo, contrassegna l'attività come completata. Le informazioni sull'errore vengono restituite all'interno di un failureInfo elemento nel corpo della risposta di Elencare i file associati a un'attività e Ottenere informazioni sulle API di un'attività .
Analogamente, se il servizio Batch rileva un errore durante l'avvio del processo, contrassegna il processo come completato. Queste informazioni sull'errore di pianificazione vengono restituite all'interno di un schedulingError elemento nel corpo della risposta di Ottenere informazioni su un processo nelle API batch .
La tabella seguente contiene l'elenco delle categorie per gli errori di pianificazione delle attività.
| Category | Descrizione |
|---|---|
| UserError | Errori nella specifica dell'attività fornita dall'utente. |
| ServerError | Errori rilevati dal servizio Batch che impediscono la pianificazione dell'attività. |
Di seguito è riportato un errore di pre-elaborazione di esempio restituito dal servizio Batch.
{
"preProcessingError": {
"category": "UserError",
"code": "BlobNotFound",
"message": "The specified blob does not exist.",
"values": {
"name": "FilePath",
"value": "myfile.txt"
}
}
}
Nella tabella seguente viene fornito l'elenco dei codici di errore di pianificazione dei processi che possono essere restituiti dal servizio Batch.
| Codice di errore | Category | Messaggio utente |
|---|---|---|
| InvalidCertificatesInAutoPool | UserError | I riferimenti ai certificati indicati nella specifica automatica del pool non sono validi. |
| AutoPoolCreationFailedWithQuotaReached | UserError | È stata raggiunta la quota di pool per l'account. |
| InvalidApplicationPackageReferencesInAutoPool | UserError | Uno o più pacchetti dell'applicazione specificati per il pool non sono validi. |
| InvalidAutoScaleFormulaInAutoPool | UserError | Le impostazioni di scalabilità automatica specificate non sono valide. |
| InvalidAutoPoolSettings | UserError | Le impostazioni del pool automatico specificato non sono valide. |
| JobBeingTerminated | UserError | Impossibile avviare l'attività perché il processo associato viene terminato. |
| Sconosciuto | ServerError | Si è verificato un errore di pianificazione sconosciuto. |
Nella tabella seguente viene fornito l'elenco dei codici di errore di pianificazione delle attività che possono essere restituiti dal servizio Batch.
| Codice di errore | Category | Messaggio utente |
|---|---|---|
| BlobNotFound | UserError | Uno o più BLOB di Azure specificati non sono stati trovati. |
| BlobAccessDenied | UserError | L'accesso per uno o più BLOB di Azure specificati viene negato. |
| BlobDownloadTimedOut | ServerError | Timeout rilevato durante il download di uno o più BLOB di Azure specificati. |
| BlobDownloadMiscError | ServerError | Si è verificato un errore vario durante il download di uno o più BLOB di Azure specificati. |
| ResourceDirectoryCreateFailed | ServerError | Errore durante la creazione della directory delle risorse per l'attività. |
| ResourceFileCreateFailed | ServerError | Errore durante la creazione del file di risorse. |
| ResourceFileWriteFailed | ServerError | Errore durante la scrittura del file di risorse. |
| CommandProgramNotFound | UserError | Il programma di comando specificato non viene trovato. |
| CommandLaunchFailed | UserError | Impossibile avviare la riga di comando specificata. |
| TaskEnded | UserError | L'attività è stata terminata dalla richiesta utente. |
| MaxInternalRetryCountReached | UserError | L'attività specificata ha raggiunto il numero massimo di tentativi interni. |
| TaskSchedulingConstraintFailed | UserError | Impossibile pianificare l'attività nel pool associato al processo |
| DiskFull | ServerError | Spazio su disco sufficiente nel nodo selezionato per eseguire l'attività. |
| Sconosciuto | ServerError | Si è verificato un errore di pianificazione sconosciuto. |