Codes d’état HTTP pour Azure Cosmos DB

Cet article fournit les codes d’état HTTP retournés par les opérations REST.

Code Description
200 OK Une des opérations REST suivantes a réussi :

- GET sur une ressource.
- PUT sur une ressource.
- POST sur une ressource.
- POST sur une ressource de procédure stockée pour exécuter la procédure stockée.
201 Créé Une opération POST pour créer une ressource a réussi.
204 Aucun contenu L'opération DELETE a réussi.
400 Demande incorrecte L'objet JSON, SQL ou JavaScript dans le corps de la demande n'est pas valide.

Ce code d'erreur peut également être envoyé si les propriétés requises d'une ressource sont absentes ou non définies dans le corps des opérations POST ou PUT sur la ressource.

Il peut enfin être renvoyé lorsque le niveau de cohérence pour une opération GET est remplacé par un niveau supérieur à celui défini pour le compte.

La valeur 400 est également retournée lorsqu’une requête qui nécessite une clé x-ms-documentdb-partitionkey ne l’inclut pas.
401 Non autorisé 401 est retourné lorsque l’en-tête Authorization n’est pas valide pour la ressource demandée.
403 Interdit Le jeton d’autorisation a expiré.

Le code 403 est également retourné lors d’une POST opération de création d’une ressource lorsque le quota de ressources a été atteint. Un exemple de ce scénario est lorsque vous essayez d’ajouter des documents à une collection qui a atteint son stockage provisionné.

Une erreur 403 peut également être retournée quand une procédure stockée, un déclencheur ou une fonction définie par l’utilisateur (UDF) utilise beaucoup de ressources et que son exécution est bloquée.

L'erreur d’interdiction 403 est retournée lorsque les règles de pare-feu configurées sur votre compte Azure Cosmos DB bloquent votre requête. Toutes les demandes provenant d’ordinateurs ne figurant pas sur cette liste autorisée recevront une réponse 403.

403.3 : ce code status est retourné pour les demandes d’écriture pendant l’opération de basculement manuel. Ce code status est utilisé comme code de redirection par les pilotes pour transférer les demandes d’écriture vers une nouvelle région d’écriture. Le client Direct REST doit exécuter une commande GET sur DatabaseAccount pour identifier la région d'écriture actuelle et transmettre la requête d'écriture à ce point de terminaison.
404 Introuvable L’opération tente d’agir sur une ressource qui n’existe plus. Par exemple, la ressource peut déjà avoir été supprimée.
408 Délai d’expiration de la demande L'opération ne s'est pas terminée dans le délai imparti. Ce code d'erreur est renvoyé quand une procédure stockée, un déclencheur ou un fichier UDF (dans une requête) n'est pas exécuté dans le délai d'exécution maximal imparti.
409 conflit L’ID fourni pour une ressource sur une opération PUT ou POST a été prise par une ressource existante. Pour résoudre ce problème, utilisez un autre ID pour la ressource. Pour les collections partitionnées, l’ID doit être unique dans tous les documents comprenant la même valeur de clé de partition.
412 Échec de la condition préalable L’opération spécifiait un eTag différent de la version disponible sur le serveur, c’est-à-dire une erreur d’accès concurrentiel optimiste. Effectuez une nouvelle tentative de requête après avoir lu la dernière version de la ressource et mis à jour l’eTag sur la requête.
413 Entité trop grande La taille du document dans la demande a dépassé la taille de document autorisée pour une demande. La taille maximale autorisée du document est de 2 Mo.
423 Verrouillé L’opération de mise à l’échelle du débit ne peut pas être effectuée, car une autre opération de mise à l’échelle est en cours.
424 Échec de la dépendance Lorsqu’une opération de document échoue dans l’étendue transactionnelle d’une opération TransactionalBatch, toutes les autres opérations du lot sont considérées comme des dépendances qui ont échoué. Ce code d’état indique que l’opération actuelle a été considérée comme ayant échoué en raison d’une autre défaillance dans la même étendue transactionnelle.
429 Demandes trop nombreuses La collection a dépassé la limite de débit provisionnée. Relancez la requête après expiration du délai de nouvelle tentative sur le serveur. Pour plus d’informations, consultez unités de demande.
449 Réessayer avec L’opération a rencontré une erreur temporaire. Ce code se produit uniquement lors des opérations d’écriture. Vous ne risquez pas de réessayer l’opération.
500 Erreur interne du serveur L’opération a échoué en raison d’une erreur de service inattendue. Contactez le support technique. Consultez Classement d’un problème de support Azure.
503 Service indisponible. L’opération n’a pas pu être terminée, car le service n’était pas disponible. Cette situation peut se produire en raison de problèmes de connectivité réseau ou de disponibilité des services. Vous ne risquez pas de réessayer l’opération. Si le problème persiste, contactez le support.

Codes de sous-état HTTP

Lors de l’utilisation de clés Customer-Managed (CMK) dans Azure Cosmos DB, en cas d’erreurs, Azure Cosmos DB retourne les détails de l’erreur ainsi qu’un code de sous-état HTTP dans la réponse. Vous pouvez utiliser ce code de sous-état pour déboguer la cause racine du problème. Actuellement, Azure Cosmos DB prend en charge les codes de sous-état suivants :

Codes de sous-état pour les problèmes côté serveur

Les codes de sous-état suivants sont pris en charge par Azure Cosmos DB pour les problèmes côté serveur :

Code de sous-état Description
4000 (Impossible d’obtenir/d’accéder au jeton Azure AD) Cette erreur se produit si Azure Cosmos DB ne peut pas obtenir le jeton d’accès Azure Active Directory (Azure AD). Ce jeton est requis pour qu’Azure Cosmos DB accède au Key Vault. L’erreur peut se produire en raison d’un problème de mise en réseau ou d’un problème de centre de données et l’utilisateur ne peut pas effectuer d’action. Créez une demande de support pour joindre l’équipe Azure Cosmos DB afin de résoudre le problème.
4001 (le service Azure AD n’est pas disponible) Cette erreur se produit si le service Azure AD est en panne ou présente des problèmes. Vous pouvez case activée le tableau de bord de panne Azure pour vérifier s’il existe une panne existante. Ces pannes sont généralement résolues en quelques heures. Il est préférable que vous puissiez contacter l’équipe Azure AD et lui faire savoir le problème que vous rencontrez. Si l’équipe Azure AD constate qu’il n’y a aucun problème, créez une demande de support pour joindre l’équipe Azure Cosmos DB pour la résolution.
4004 (Key Vault service n’est pas disponible) Cette erreur se produit si Azure Cosmos DB tente d’accéder au Key Vault, mais que le service n’est pas disponible. Cela peut être dû à un problème de mise en réseau pour atteindre Key Vault ou au service lui-même peut être en panne. Vous pouvez case activée le tableau de bord de panne Azure pour vérifier s’il existe une panne existante. Ces pannes sont généralement résolues en quelques heures. Il est préférable que vous puissiez contacter l’équipe Key Vault et lui faire savoir le problème que vous voyez. Si l’équipe Key Vault constate qu’il n’y a aucun problème, créez une demande de support pour joindre l’équipe Azure Cosmos DB pour la résolution.
4007 (Erreur interne du serveur) Il s’agit d’une erreur de serveur interne qui se produit si les octets d’entrée ne sont pas au format base64.
4008 (Key Vault erreurs de service interne) Cette erreur se produit si Azure Cosmos DB ne peut pas accéder au Key Vault. Cela peut être dû à un problème de mise en réseau ou si le service Key Vault lui-même est en panne. Vous pouvez case activée le tableau de bord de panne Azure pour vérifier s’il existe une panne existante. Ces pannes sont généralement résolues en quelques heures. Il est préférable que vous puissiez contacter l’équipe Key Vault et lui faire savoir le problème que vous voyez. Si l’équipe Key Vault trouve qu’il n’y a pas de problème, contactez l’équipe Azure Cosmos DB pour la résolution.
1013 (l’opération de création de collection est en cours) Si vous rencontrez une exception de délai d’expiration lors de la création d’une collection, effectuez une opération de lecture pour valider si la collection a été créée avec succès. L’opération de lecture lève une exception jusqu’à ce que l’opération de création de la collection aboutisse. Si l’opération de lecture lève une exception avec status code 404 et sous-status code 1013, cela signifie que l’opération de création de collection est toujours en cours. Réessayez l’opération de lecture jusqu’à ce que vous obteniez 200 ou 201 codes status, ces codes vous informent que la collection a été créée avec succès.

Codes de sous-état pour les problèmes de l’utilisateur final

Les codes de sous-état suivants sont pris en charge par Azure Cosmos DB pour les problèmes causés par l’utilisateur final :

Code de sous-état Description
4002 (Key Vault n’accorde pas d’autorisation à Azure AD, ou la clé est désactivée) Ce problème se produit si vous avez supprimé l’identité Azure Cosmos DB des stratégies d’accès Key Vault ou si vous avez désactivé la clé. Ce problème est généralement dû à l’utilisateur final. Si cette erreur se produit, assurez-vous qu’Azure Cosmos DB a accès au Key Vault et que la clé est activée.
4003 (Clé introuvable) Ce problème se produit si la clé est supprimée du Key Vault. Ce problème est généralement dû à l’utilisateur final. L’une des conditions préalables à l’utilisation d’Azure Cosmos DB avec des clés gérées par le client est que la suppression réversible et la protection contre le vidage sont activées pour le Key Vault. Cela signifie que vous pouvez récupérer la clé supprimée et restaurer l’accès à Azure Cosmos DB.
4005 (Impossible d’encapsuler ou de désencapsuler la clé) Cette erreur se produit si le Key Vault ne parvient pas à encapsuler ou à désencapsuler la clé. Ce problème est généralement dû à l’utilisateur final. L’une des causes possibles de cette erreur est que le Key Vault n’a pas pu décoder l’objet blob chiffré à l’aide de la dernière clé, car vous avez fait pivoter la clé. Pour résoudre cette erreur, activez toutes les clés récemment désactivées et elle sera résolue dans environ une heure. Si le problème n’est pas résolu après plus de 2 heures, transmettez le problème à Azure Cosmos DB.
4006 (l’URL de la clé n’est pas valide) Cette erreur se produit lors de l’approvisionnement si vous avez inclus la version de clé dans l’URL Key Vault. Cette erreur est souvent due à l’utilisateur final. Pour résoudre cette erreur, supprimez la version et réessayez. Par exemple, si vous avez utilisé l’URL au format https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/<KeyVersion>, mettez-la à jour vers https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/
4009 (Key Vault nom DNS ne peut pas être résolu) Cette erreur se produit si le nom DNS Key Vault n’a pas pu être résolu, car vous avez utilisé le nom de Key Vault incorrect. Cette erreur est due à l’utilisateur final. Pour le résoudre, corrigez le nom Key Vault et réessayez.

Voir aussi