Compartir a través de

Códigos de estado HTTP (Azure AI Search)

En esta página se describen los códigos de estado HTTP que se devuelven con frecuencia al usar azure AI Search API.

Códigos de estado HTTP comunes

Código Descripción
200 Ok Correcto en GET, PUT o POST. Se devuelve para obtener una respuesta correcta.
201 creado Correcto en PUT o POST. Objeto creado correctamente.
202 Aceptado Correcto en PUT o POST. Este código de estado se devuelve para las solicitudes de indexador de ejecución.
204 No Content Correcto en PUT o POST. Una actualización se realizó correctamente, pero no hay información que devolver en la respuesta.
207 Multi-Status Éxito parcial para PUT o POST. Algunos documentos se realizaron correctamente, pero al menos se produjo un error.
400 Solicitud incorrecta Se devuelve cuando se produce un error en el URI de solicitud, los encabezados o el cuerpo de la solicitud. El cuerpo de la respuesta contiene un mensaje de error que explica cuál es el problema específico.
401 No autorizado Se devuelve cuando faltan credenciales. Si usa el control de acceso basado en rol, o el servicio de búsqueda falta una asignación de roles. Para problemas de acceso a Azure AI Search, consulte Conexión a Azure AI Search mediante roles. Para obtener más información sobre las conexiones de búsqueda a otros recursos, consulte Configuración de un servicio de búsqueda para conectarse mediante una identidad administrada.
403 Prohibido Se devuelve cuando se produce un error en la autorización.
404 No encontrado Se devuelve cuando un recurso no existe en el servidor.
Método 405 no admitido Se devuelve cuando el servicio reconoce un método no admitido. Si está consultando un índice, la formulación de esa solicitud incluye el punto de conexión, la colección de índices y el índice, y la colección docs y el método de búsqueda (por ejemplo, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01).
409 Conflicto Se devuelve cuando entran en conflicto las operaciones de escritura. Este código de estado se devuelve para las actualizaciones de recursos o durante la indexación cuando dos procesos intentan actualizar el mismo documento simultáneamente. Azure AI Search proporciona administración de simultaneidad para las actualizaciones de recursos. Para más información, consulte Administración de la simultaneidad en Azure AI Search.
412 Error de condición previa Se devuelve cuando una If-Match o If-None-Match condición del encabezado se evalúa como false. Asociado al uso del control de simultaneidad optimista al enviar solicitudes HTTP para definiciones de índice, indexadores, conjuntos de aptitudes o orígenes de datos.
429 Demasiadas solicitudes Si obtiene este código de estado durante la creación de objetos, significa que tiene el número máximo de objetos permitidos para el nivel de servicio. Si obtiene este código de error en un índice activo, normalmente significa que se está ejecutando poco en el almacenamiento. A medida que se acercan a los límites de almacenamiento, el servicio puede especificar un estado en el que no se puede agregar ni actualizar hasta que se eliminen algunos documentos. Para obtener más información, consulte Planeamiento y administración de la capacidad si desea más almacenamiento o Actualizar contenido si desea liberar espacio eliminando documentos.
499 Solicitud cerrada de cliente Este código de estado nunca se devuelve en una respuesta, pero es posible que lo vea en entradas de registro registradas por análisis de tráfico de búsqueda y Azure Monitor. Indica que un cliente cerró la conexión antes de que el servicio devolva una respuesta. Cuando Azure AI Search detecta una cancelación que no ha solicitado el código del lado del servicio o que el cliente ya no existe, se registra un 499.
Puerta de enlace incorrecta 502 Este código de estado se produce cuando se escribe HTTP en lugar de HTTPS en la conexión.
503 Servicio no disponible Este código de estado significa que el sistema está bajo mucha carga y la solicitud no se puede procesar. Las mitigaciones incluyen agregar tiempos de espera a cualquier lógica de reintento o aumentar la capacidad. Los servicios más recientes incluyen más capacidad de almacenamiento y computación automáticamente. Para más información sobre el ajuste del rendimiento, consulte Análisis del rendimiento en Azure AI Search.
504: Tiempo de espera de puerta de enlace Azure AI Search escucha en el puerto HTTPS 443. Si la dirección URL del servicio de búsqueda contiene HTTP en lugar de HTTPS, se devuelve un código de estado 504.

Consulte también