Codes status HTTP (Recherche Azure AI)
Cette page décrit les codes status HTTP qui sont fréquemment retournés lors de l’utilisation de l’API Recherche d’IA Azure.
Codes d'état HTTP courants
| Code | Description |
|---|---|
| 200 OK | Réussite d'une opération GET, PUT ou POST. Retourné pour une réponse réussie. Pendant l’indexation, ce code indique que tous les éléments ont été stockés durablement et vont commencer à être indexés. L’indexation s’exécute en arrière-plan et rend les nouveaux documents interrogeables et interrogeables quelques secondes après la fin de l’opération d’indexation. |
| 201 Créé | Réussite d'une opération PUT ou POST. Objet créé ou mis à jour avec succès. |
| 204 Accepté | Réussite d'une opération PUT ou POST. L'index ou les documents ont été correctement chargés. |
| 207 Multi-état | Réussite partielle d'une opération PUT ou POST. L'opération a réussi sur certains documents, mais a échoué sur au moins l'un deux. |
| 400 Demande incorrecte | Retourné en cas d’erreur dans l’URI, les en-têtes ou le corps de la requête. Le corps de la réponse contient un message d’erreur expliquant le problème spécifique. |
| 403 Interdit | Renvoyé si vous transmettez une clé api non valide. |
| 404 Introuvable | Retourné lorsqu’une ressource n’existe pas sur le serveur. Si vous gérez ou interrogez un index, case activée la syntaxe et vérifiez que le nom de l’index est spécifié correctement. |
| Méthode 405 non prise en charge | Retourné lorsque la requête spécifie une méthode reconnue, mais non prise en charge. Si vous interrogez un index, la formulation de cette requête inclut le point de terminaison, la collection d’index et l’index, ainsi que la collection docs et la méthode de recherche (par exemple, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30). |
| 409 Conflit | Retourné en cas de conflit d’opérations d’écriture. Cette erreur est retournée pour les mises à jour des ressources ou pendant l’indexation lorsque deux processus tentent de mettre à jour simultanément le même document. Azure AI Search fournit la gestion de l’accès concurrentiel pour les mises à jour des ressources. Pour plus d’informations, consultez Comment gérer l’accès concurrentiel dans Azure AI Search. |
| 412 Échec de la condition préalable | Retourné quand la condition d’un en-tête If-Match ou If-None-Match prend la valeur false. Associé à l’utilisation d’un contrôle d’accès concurrentiel optimiste lors de l’envoi de requêtes HTTP pour des définitions d’index, des indexeurs ou des sources de données. |
| 429 Trop de demandes | Si cette erreur se produit pendant que vous essayez de créer un index, cela signifie que vous disposez déjà du nombre maximal d’index autorisés pour votre niveau tarifaire. Le nombre d’index stockés dans Azure AI Search est visible dans le tableau de bord du service de recherche sur le Portail Azure. Pour afficher les index par nom, sélectionnez la vignette Index . Vous pouvez également obtenir une liste des index par nom à l’aide de l’opération Répertorier les index . Consultez la section List Indexes pour plus d'informations. Si cette erreur se produit pendant le chargement du document, cela indique que vous avez dépassé votre quota sur le nombre de documents par index. Vous devez créer un autre index ou effectuer une mise à niveau pour bénéficier de limites de capacité supérieures. |
| 499 Demande fermée du client | Cette erreur n’est jamais retournée dans une réponse, mais vous pouvez la voir dans les entrées de journal enregistrées par l’analyse du trafic de recherche et Azure Monitor. Elle indique qu’un client a fermé la connexion avant qu’une réponse ait été retournée par le service. Quand Azure AI Search détecte une annulation qui n’a pas été demandée par le code côté service ou que le client n’existe plus, une erreur 499 est enregistrée. |
| 502 Passerelle incorrecte | Cette erreur se produit quand vous entrez HTTP au lieu de HTTPS dans la connexion. |
| 503 Service indisponible | Cette erreur signifie que le système est surchargé et que votre requête ne peut pas être traitée pour le moment. Important: Dans ce cas, nous vous recommandons vivement de désactiver votre code client et d’attendre avant de réessayer. En laissant au système le temps de récupérer, vous aurez davantage de chance de voir vos futures requêtes aboutir. Si vous renouvelez rapidement vos tentatives de requête, vous ne ferez que prolonger la situation. Pour plus d’informations sur la limitation et sur la façon d’éviter cette condition, consultez Analyser les performances . |
| 504 : Délai d’expiration de la passerelle | Azure AI Search écoute sur le port HTTPS 443. Si l’URL de votre service de recherche contient HTTP au lieu de HTTPS, un code 504 status est retourné. |