Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette page décrit les codes d’état 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 sur GET, PUT ou POST. Retourné pour une réponse réussie. |
| 201 Créée | Réussite sur PUT ou POST. Objet créé avec succès. |
| 202 Accepté | Réussite sur PUT ou POST. Ce code d’état est retourné pour les demandes d’indexeur d’exécution. |
| 204 Pas de contenu | Réussite sur PUT ou POST. Une mise à jour a réussi, mais aucune information n’est renvoyée dans la réponse. |
| État multiple 207 | Réussite partielle pour PUT ou POST. Certains documents ont réussi, mais au moins un échec. |
| 400 Demande incorrecte | Retourné lorsqu’il y a une erreur dans l’URI de requête, les en-têtes ou le corps. Le corps de la réponse contient un message d’erreur expliquant le problème spécifique. |
| 401 Non autorisé | Retourné lorsque les informations d’identification sont manquantes. Si vous utilisez le contrôle d’accès en fonction du rôle, vous ou le service de recherche ne disposez pas d’une attribution de rôle. Pour connaître les problèmes d’accès à Azure AI Search, consultez Se connecter à Recherche Azure AI à l’aide de rôles. Pour plus d’informations sur les connexions de recherche à d’autres ressources, consultez Configurer un service de recherche pour se connecter à l’aide d’une identité managée. |
| 403 Interdit | Retourné en cas d’échec de l’autorisation. |
| 404 Introuvable | Retourné lorsqu’une ressource n’existe pas sur le serveur. |
| Méthode 405 non prise en charge | Retourné lorsque le service reconnaît une méthode 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=2024-07-01 |
| Conflit 409 | Retourné lors du conflit d’opérations d’écriture. Ce code d’état est retourné pour les mises à jour des ressources ou pendant l’indexation lorsque deux processus essaient de mettre à jour le même document simultanément. Azure AI Search fournit une gestion de l’accès concurrentiel pour les mises à jour des ressources. Pour plus d’informations, consultez Comment gérer la concurrence dans Recherche IA Azure. |
| 412 Échec de la condition préalable | Retourné lorsqu’un If-Match ou si-None-Match condition de l’en-tête prend la valeur false. Associé à l’utilisation du contrôle d’accès concurrentiel optimiste lors de l’envoi de requêtes HTTP pour les définitions d’index, les indexeurs, les ensembles de compétences ou les sources de données. |
| 429 Trop de demandes | Si vous obtenez ce code d’état lors de la création d’objets, cela signifie que vous disposez du nombre maximal d’objets autorisés pour votre niveau de service. Si vous obtenez ce code d’erreur sur un index actif, cela signifie généralement que vous êtes en cours d’exécution faible sur le stockage. À mesure que vous approchez des limites de stockage, le service peut entrer un état dans lequel vous ne pouvez pas ajouter ou mettre à jour tant que vous n’avez pas supprimé certains documents. Pour plus d’informations, consultez Planifier et gérer la capacité si vous souhaitez davantage de stockage ou mettre à jour du contenu si vous souhaitez libérer de l’espace en supprimant des documents. |
| Demande fermée du client 499 | Ce code d’état n’est jamais retourné dans une réponse, mais vous pouvez le voir dans les entrées de journal enregistrées par l’analyse du trafic de recherche et Azure Monitor. Il 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, un 499 est journalisé. |
| 502 Passerelle incorrecte | Ce code d’état se produit lorsque vous entrez HTTP au lieu de HTTPS dans la connexion. |
| 503 Service indisponible | Ce code d’état signifie que le système est soumis à une charge importante et que votre demande ne peut pas être traitée. Les atténuations incluent l’ajout de temps d’attente à toute logique de nouvelle tentative ou l’augmentation de la capacité. Les services plus récents sont fournis automatiquement avec davantage de puissance de stockage et de calcul. Pour plus d’informations sur le réglage des performances, consultez Analyser les performances dans Recherche IA Azure. |
| 504 : Délai d’expiration de la passerelle | Recherche Azure AI écoute sur le port HTTPS 443. Si votre URL de service de recherche contient HTTP au lieu de HTTPS, un code d’état 504 est retourné. |