État du lot et codes d’erreur
Les opérations d’API REST pour le service Batch retournent des codes status HTTP standard, tels que définis dans les définitions de code d’état HTTP/1.1.
Les opérations d'API peuvent également renvoyer des informations d'erreur supplémentaires pour fournir aux développeurs plus de détails sur l'erreur. Par exemple, la réponse d'erreur suivante indique qu'un paramètre de requête spécifié dans l'URI de demande n'est pas valide, et fournit des informations supplémentaires sur le nom et la de ce paramètre, ainsi que sur la raison de l'erreur.
{
"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"
}]
}
Les sections suivantes contiennent des listes de codes d'erreur pour le service de traitement par lots :
Codes d'erreur d'API REST courants
Les codes d'erreur répertoriés dans le tableau suivant peuvent être renvoyés par une opération sur le service de traitement par lots.
| Code d'erreur | Code d'état HTTP | Message utilisateur |
|---|---|---|
| ConditionNotMet | Non modifié (304) | La condition spécifiée dans les en-têtes conditionnels n'a pas été remplie pour une opération de lecture. |
| MissingRequiredHeader | Demande incorrecte (400) | Un en-tête HTTP requis n'a pas été spécifié. |
| MissingRequiredProperty | Demande incorrecte (400) | Une propriété requise n'a pas été spécifiée dans le corps de la demande. |
| UnsupportedHeader | Demande incorrecte (400) | Un des en-têtes HTTP spécifiés dans la demande n'est pas pris en charge. |
| UnsupportedProperty | Demande incorrecte (400) | L'une des propriétés spécifiées dans le corps de la demande n'est pas prise en charge. |
| InvalidHeaderValue | Demande incorrecte (400) | La valeur fournie pour un des en-têtes HTTP n'était pas au format correct. |
| InvalidPropertyValue | Demande incorrecte (400) | La valeur fournie pour l'une des propriétés dans le corps de la demande n'est pas valide. |
| MissingRequiredQueryParameter | Demande incorrecte (400) | Un paramètre de requête requis n'a pas été spécifié pour cette demande. |
| UnsupportedQueryParameter | Demande incorrecte (400) | Un des paramètres de requête spécifiés dans l'URI de la demande n'est pas pris en charge. |
| InvalidQueryParameterValue | Demande incorrecte (400) | Une valeur non valide a été spécifiée pour l'un des paramètres de la requête dans l'URI de la demande. |
| OutOfRangeQueryParameterValue | Demande incorrecte (400) | Un paramètre de requête spécifié dans l'URI de la demande est en dehors de la plage autorisée. |
| RequestUrlFailedToParse | Demande incorrecte (400) | L'URL dans la demande n'a pas pu être analysée. |
| InvalidUri | Demande incorrecte (400) | L'URI demandé ne représente aucune ressource sur le serveur. |
| InvalidHttpVerb | Demande incorrecte (400) | Le verbe HTTP spécifié n'a pas été identifié par le serveur. |
| EmptyMetadataKey | Demande incorrecte (400) | La clé pour l'une des paires clé-valeur de métadonnées est vide. |
| InvalidRequestBody | Demande incorrecte (400) | La syntaxe du code de la demande n'est pas correcte. |
| OutOfRangeInput | Demande incorrecte (400) | Une des entrées de demande est hors limites. |
| InvalidAuthenticationInfo | Demande incorrecte (400) | Les informations d'authentification n'ont pas été fournies au format correct. Vérifiez la valeur de l’en-tête d’autorisation . |
| InvalidInput | Demande incorrecte (400) | Une des requêtes d’entrées n’est pas valide. |
| InvalidMetadata | Demande incorrecte (400) | Les métadonnées spécifiées ne sont pas valides. Elles comprennent des caractères non autorisés. |
| MetadataTooLarge | Demande incorrecte (400) | La taille des métadonnées spécifiée dépasse la taille maximale autorisée. |
| MultipleConditionHeadersNotSupported | Demande incorrecte (400) | Plusieurs en-têtes de condition ne sont pas pris en charge. |
| AuthenticationFailed | Interdit (403) | Le serveur n'a pas pu authentifier la demande. Vérifiez que la valeur de l’en-tête d’autorisation est formée correctement et inclut la signature. |
| InsufficientAccountPermissions | Interdit (403) | Ce compte n'a pas d'autorisations suffisantes pour effectuer cette opération. |
| AccountIsDisabled | Interdit (403) | Le compte spécifié est désactivé. |
| ResourceNotFound | Introuvable (404) | La ressource spécifiée n'existe pas. |
| UnsupportedHttpVerb | Méthode non autorisée (405) | La ressource ne prend pas en charge le verbe HTTP spécifié. |
| MissingContentLengthHeader | Longueur requise (411) | L’en-tête Content-Length n’a pas été spécifié. |
| ConditionNotMet | Échec de la précondition (412) | La condition spécifiée dans les en-têtes conditionnels n'a pas été remplie pour une opération d'écriture. |
| RequestBodyTooLarge | Entité de demande trop grande (413) | La taille du corps de la demande dépasse la taille maximale autorisée. |
| InvalidRange | Plage demandée non satisfaisante (416) | La plage spécifiée n'est pas valide pour la taille actuelle de la ressource. |
| InternalError | Erreur interne au serveur (500) | Le serveur a rencontré une erreur interne. Relancez la requête. |
| OperationTimedOut | Erreur interne au serveur (500) | Impossible d'exécuter l'opération dans le temps imparti. |
| ServerBusy | Service non disponible (503) | Le serveur est actuellement incapable de recevoir des demandes. Relancez la requête. |
Codes d'erreur du service de traitement par lots
Les codes d'erreur répertoriés dans le tableau suivant peuvent être renvoyés par une opération sur le service de traitement par lots.
| Code d'erreur | Code d'état HTTP | Message utilisateur |
|---|---|---|
| UnsupportedRequestVersion | Demande incorrecte (400) | La version de demande spécifiée n'est pas prise en charge. |
| InvalidAutoScalingSettings | Demande incorrecte (400) | Les paramètres spécifiés de mise à l'échelle automatique ne sont pas valides. |
| AutoScalingFormulaSyntaxError | Demande incorrecte (400) | La formule de mise à l'échelle automatique spécifiée comporte une erreur de syntaxe. |
| AutoScalingFormulaTooLong | Demande incorrecte (400) | La formule de mise à l'échelle automatique spécifiée dépasse la limite de longueur. |
| OSVersionNotFound | Demande incorrecte (400) | La version de système d'exploitation spécifiée n'existe pas. |
| OSVersionDisabled | Demande incorrecte (400) | La version de système d'exploitation spécifiée est désactivée. |
| OSVersionExpired | Demande incorrecte (400) | La version de système d'exploitation spécifiée a expiré. |
| PoolVersionEqualsUpgradeVersion | Demande incorrecte (400) | Le pool est déjà de la version indiquée. |
| PoolNotEligibleForOSVersionUpgrade | Demande incorrecte (400) | Le pool spécifié n'est pas éligible pour la mise à niveau de la version du système d'exploitation. |
| PoolNotFound | NotFound (404) | Le pool spécifié n'existe pas. |
| NodeNotFound | NotFound (404) | Le nœud spécifié n’existe pas. |
| JobScheduleNotFound | NotFound (404) | La planification de travail spécifiée n’existe pas. |
| JobNotFound | NotFound (404) | Le travail spécifié n'existe pas. |
| TaskNotFound | NotFound (404) | La tâche spécifiée n'existe pas. |
| FileNotFound | NotFound (404) | Le fichier spécifié n'existe pas. |
| NodeUserNotFound | NotFound (404) | L’utilisateur de nœud spécifié n’existe pas. |
| CertificateNotFound | NotFound (404) | Le certificat spécifié n'existe pas. |
| JobPreparationTaskNotRunOnNode | NotFound (404) | La tâche de préparation du travail n’a pas été exécutée sur le nœud spécifié. |
| JobReleaseTaskNotRunOnNode | NotFound (404) | La tâche de mise en production du travail n’a pas été exécutée sur le nœud spécifié. |
| NodeAgentSKUNotFound | NotFound (404) | La référence SKU de l’agent de nœud spécifiée n’existe pas. |
| OperationInvalidForCurrentState | Conflit (409) | L'opération spécifiée n'est pas valide pour l'état actuel de la ressource. |
| PoolBeingDeleted | Conflit (409) | Le pool spécifié a été marqué pour suppression et est revendiqué. |
| PoolBeingResized | Conflit (409) | Le pool spécifié est en cours de redimensionnement. |
| PoolBeingCreated | Conflit (409) | Le pool spécifié est en cours de création. |
| NodeBeingCreated | Conflit (409) | Le nœud spécifié est en cours de création |
| NodeBeingStarted | Conflit (409) | Le nœud spécifié est en cours de démarrage |
| NodeBeingReimaged | Conflit (409) | Le nœud spécifié est en cours de réimage |
| NodeBeingRebooted | Conflit (409) | Le nœud spécifié est en cours de redémarrage |
| NodeStateUnusable | Conflit (409) | L’état du nœud spécifié est inutilisable |
| JobScheduleBeingTerminated | Conflit (409) | La planification de travail spécifiée est en cours d’arrêt. |
| JobScheduleBeingDeleted | Conflit (409) | La planification de travail spécifiée a été marquée pour suppression et est en cours de récupération. |
| CertificateBeingDeleted | Conflit (409) | Le certificat spécifié a été marqué pour suppression et est en cours de suppression. |
| PoolExists | Conflit (409) | L'objet blob spécifié existe déjà. |
| JobScheduleExists | Conflit (409) | La planification de travail spécifiée existe déjà. |
| NodeUserExists | Conflit (409) | L’utilisateur de nœud spécifié existe déjà. |
| JobExists | Conflit (409) | Le travail spécifié existe déjà. |
| NodeUserExists | Conflit (409) | L’utilisateur de nœud spécifié existe déjà. |
| CertificateExists | Conflit (409) | Le certificat spécifié existe déjà. |
| JobScheduleDisabled | Conflit (409) | La planification de travail spécifiée est désactivée. |
| JobScheduleCompleted | Conflit (409) | La planification du travail spécifiée est déjà à l’état terminé. |
| JobBeingTerminated | Conflit (409) | Le travail spécifié est en cours d'achèvement. |
| JobBeingDeleted | Conflit (409) | Le travail spécifié a été marqué pour suppression et le nettoyage de la mémoire est en cours. |
| JobDisabled | Conflit (409) | Le travail spécifié est désactivé. |
| JobCompleted | Conflit (409) | Le travail spécifié est déjà en état terminé. |
| JobNotActive | Conflit (409) | Le travail spécifié n'est pas en état actif. |
| TaskExists | Conflit (409) | La tâche spécifiée existe déjà. |
| TaskCompleted | Conflit (409) | La tâche spécifiée est déjà en état terminé. |
| TaskNotCompleted | Conflit (409) | La tâche spécifiée n’est pas dans un état terminé et l’opération demandée ne peut être effectuée que sur les tâches terminées. |
| TaskSucceeded | Conflit (409) | La tâche spécifiée s’est déjà terminée correctement et l’opération demandée ne peut pas être effectuée sur les tâches réussies. |
| TaskFilesUnavailable | Conflit (409) | Les fichiers de la tâche spécifiée ne sont pas disponibles. |
| TaskFilesCleanedup | Conflit (409) | Les fichiers de la tâche spécifiée sont nettoyés. |
| ActiveJobAndScheduleQuotaReached | Conflit (409) | Le quota de travail et de planification actif pour le compte a été atteint. |
| PoolQuotaReached | Conflit (409) | Le quota de pool pour le compte a été atteint. |
| UpgradePoolVersionConflict | Conflit (409) | La mise à niveau du pool vers une autre version est déjà en cours. |
| JobPreparationTaskNotSpecified | Conflit (409) | Le travail spécifié n’a pas de tâche de préparation du travail. |
| JobReleaseTaskNotSpecified | Conflit (409) | Le travail spécifié n’a pas de tâche de mise en production de travail. |
| TaskIdSameAsJobPreparationTask | Conflit (409) | L’ID de tâche spécifié est identique à la tâche de préparation du travail. |
| TaskIdSameAsJobReleaseTask | Conflit (409) | L’ID de tâche spécifié est identique à la tâche de mise en production du travail. |
| JobWithSameIdExists | Conflit (409) | Il existe un travail avec l’ID de planification de travail spécifié. Le travail et la planification du travail ne peuvent pas avoir le même ID. |
| JobScheduleWithSameIdExists | Conflit (409) | Une planification de travail avec l’ID de travail spécifié existe. Le travail et la planification du travail ne peuvent pas avoir le même ID. |
| NodeAlreadyInTargetSchedulingState | Conflit (409) | Le nœud spécifié est déjà dans l’état de planification cible. |
| OperationNotValidOnNode | Conflit (409) | L’opération spécifiée n’est pas valide sur le nœud. |
| OperationNotValidOnPool | Conflit (409) | L’opération spécifiée n’est pas valide sur le pool. |
| IOError | Interdit (403) | Une erreur d'E/S s'est produite lors de l'accès à la ressource spécifiée. |
| TooManyEnableAutoScaleRequests | ServiceUnavailable (503) | Trop de demandes Activer la mise à l’échelle automatique du pool sont émises sur le pool. |
| ApplicationNotFound | Introuvable (404) | L’application spécifiée n’existe pas. |
| InvalidApplicationPackageReferences | Conflit (409) | Une ou plusieurs références de package d’application n’ont pas pu être satisfaites. Cela se produit si l’ID ou la version de l’application n’existe pas ou n’est pas actif, ou si la référence n’a pas spécifié de version et qu’aucune version par défaut n’est configurée. |
| TaskDependenciesNotSpecifiedOnJob | Demande incorrecte (400) | Une tâche a été spécifiée en fonction d’autres tâches, mais la tâche n’a pas spécifié qu’elle utiliserait des dépendances de tâche. |
| TaskDependencyListTooLong | Demande incorrecte (400) | Une tâche a été spécifiée en fonction d’autres tâches, mais la liste des dépendances était trop longue pour être stockée. La longueur totale stockée est limitée à 64 000 caractères ; la longueur totale des ID de tâche doit être légèrement inférieure à celle-ci pour permettre une surcharge de stockage interne. Si vous rencontrez cette erreur, envisagez d’utiliser des dépendances de plage de tâches à la place. |
| TaskDependencyRangesTooLong | Demande incorrecte (400) | Une tâche a été spécifiée en fonction de plusieurs plages d’ID de tâche, et la liste des plages était trop longue pour être stockée. Notez que le problème ne concerne pas la taille des plages, mais le nombre de plages. |
Codes d'erreur de planification de travail/tâche
Si le service Batch rencontre une erreur lors du démarrage d’une tâche sur un nœud, il marque la tâche comme terminée. Les informations d’erreur sont retournées dans un failureInfo élément dans le corps de la réponse de Répertorier les fichiers associés à une tâche et Obtenir des informations sur les API d’une tâche .
De même, si le service de traitement par lots rencontre une erreur lors du démarrage du travail, il marque celui-ci comme achevé. Ces informations d’erreur de planification sont retournées dans un schedulingError élément dans le corps de la réponse de Obtenir des informations sur un travail dans les API Batch.
Le tableau suivant présente la liste des catégories pour les erreurs de planification de tâches.
| Category | Description |
|---|---|
| UserError | Erreurs dans la spécification de tâche fournie par l'utilisateur. |
| ServerError | Erreurs rencontrées par le service de traitement par lots, qui empêchent celui-ci de planifier la tâche. |
Voici un exemple d’erreur de prétraitement retourné par le service Batch.
{
"preProcessingError": {
"category": "UserError",
"code": "BlobNotFound",
"message": "The specified blob does not exist.",
"values": {
"name": "FilePath",
"value": "myfile.txt"
}
}
}
Le tableau suivant fournit la liste des codes d’erreur de planification des travaux qui peuvent être retournés par le service Batch.
| Code d'erreur | Category | Message utilisateur |
|---|---|---|
| InvalidCertificatesInAutoPool | UserError | Les références de certificat spécifiées dans la spécification du pool automatique ne sont pas valides. |
| AutoPoolCreationFailedWithQuotaReached | UserError | Le quota de pools pour le compte est atteint. |
| InvalidApplicationPackageReferencesInAutoPool | UserError | Un ou plusieurs packages d’application spécifiés pour le pool ne sont pas valides. |
| InvalidAutoScaleFormulaInAutoPool | UserError | Les paramètres spécifiés de mise à l'échelle automatique ne sont pas valides. |
| InvalidAutoPoolSettings | UserError | Les paramètres de pool automatique spécifiés ne sont pas valides. |
| JobBeingTerminated | UserError | Impossible de démarrer la tâche, car le travail associé est en cours d’arrêt. |
| Unknown | ServerError | Une erreur de planification inconnue s’est produite. |
Le tableau suivant fournit la liste des codes d’erreur de planification des tâches qui peuvent être retournés par le service Batch.
| Code d'erreur | Category | Message utilisateur |
|---|---|---|
| BlobNotFound | UserError | L’un des objets blob Azure spécifiés est introuvable. |
| BlobAccessDenied | UserError | L’accès à l’un des objets blob Azure spécifiés est refusé. |
| BlobDownloadTimedOut | ServerError | Délai d’expiration rencontré lors du téléchargement de l’un des objets blob Azure spécifiés. |
| BlobDownloadMiscError | ServerError | Erreur diverses rencontrée lors du téléchargement de l’un des objets blob Azure spécifiés. |
| ResourceDirectoryCreateFailed | ServerError | Échec rencontré lors de la création du répertoire de ressources pour la tâche. |
| ResourceFileCreateFailed | ServerError | Échec de la création du fichier de ressources. |
| ResourceFileWriteFailed | ServerError | Échec de l’écriture du fichier de ressources. |
| CommandProgramNotFound | UserError | Le programme de commandes spécifié est introuvable. |
| CommandLaunchFailed | UserError | Échec du lancement de la ligne de commande spécifiée. |
| TaskEnded | UserError | La tâche a été terminée par la demande de l’utilisateur. |
| MaxInternalRetryCountReached | UserError | La tâche spécifiée a atteint le nombre maximal de nouvelles tentatives internes. |
| TaskSchedulingConstraintFailed | UserError | Impossible de planifier la tâche sur le pool associé au travail |
| DiskFull | ServerError | Il n’y a pas suffisamment d’espace disque sur le nœud qui a été sélectionné pour exécuter la tâche. |
| Unknown | ServerError | Une erreur de planification inconnue s’est produite. |