Codes de statut HTTP

L'API MC utilise des codes de statut HTTP standard en réponse pour indiquer la réussite ou l'échec de la demande. Sauf indication contraire dans la description d'une opération, les interprétations générales suivantes des valeurs du code de statut s'appliquent.

Tableau 1. Codes de statut HTTP
Code de statut HTTP Message de statut HTTP Descriptif
200 bouton OK La demande a abouti. Un corps de réponse contenant les résultats de la demande est fourni.
204 Aucun contenu La demande a abouti et aucune information de réponse supplémentaire n'est fournie.
400 Demande incorrecte La demande ne contenait pas l'entrée requise, comportait des erreurs dans l'entrée fournie ou incluait une entrée superflue. Des informations supplémentaires concernant l'erreur sont fournies dans un corps de réponse d'erreur qui inclut un code anomalie avec des informations supplémentaires.
403 Interdit Plusieurs conditions d'erreur entraînent le code de statut suivant:
  • La demande requiert une authentification mais aucun en-tête X-API-Session n'a été fourni, ou un en-tête a été fourni mais l'ID de session n'est pas valide.
  • L'utilisateur sous lequel la demande d'API a été authentifiée n'est pas autorisé à effectuer l'opération demandée.
404 Introuvable Plusieurs conditions d'erreur entraînent le code de statut suivant:
  • L'URI ne désigne pas une ressource existante ou désigne une ressource pour laquelle l'utilisateur de l'API ne dispose pas de droits d'accès aux objets.
  • L'URI désigne une ressource ou une opération qui n'est pas prise en charge par la console de gestion car il s'agit actuellement de la console de gestion de remplacement.
405 Méthode non autorisée La demande spécifie une méthode HTTP qui n'est pas valide pour l'URI désigné.
409 Conflit L'état (statut) de la ressource gérée est incorrect pour l'exécution de l'opération demandée. Des informations supplémentaires concernant l'erreur sont fournies dans un corps de réponse d'erreur qui inclut un code anomalie avec des informations supplémentaires.
412 Ressource modifiée Echec de la précondition. Si l'étiquette ETag fournie par le client et l'étiquette ETag fournie par le serveur correspondent, passez à l'étape POST. Sinon, une erreur de modification de la ressource 412 est générée.
413 Corps de la demande trop grand La demande inclut un corps de demande trop grand.
415 Type de support non pris en charge L'en-tête Content-Type de la demande spécifie une représentation qui n'est pas prise en charge par l'API Web Services .
500 Erreur interne du serveur Une erreur de serveur s'est produite lors du traitement de la demande.
501 Non implémenté La demande spécifie une méthode HTTP qui n'est pas reconnue par le serveur (pour toute ressource).
503 Service non disponible La demande n'a pas pu être traitée par le MC en raison d'une condition temporaire.
505 Version HTTP non prise en charge La demande spécifie une version de protocole HTTP qui n'est pas prise en charge par l'API Web Services .