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 | Proceso completado correctamente en GET, PUT o POST. Se devuelve para una respuesta correcta. Durante la indexación, este código indica que todos los elementos se han almacenado de forma duradera y comenzarán a indexarse. La indexación se ejecuta en segundo plano y hace que los nuevos documentos se puedan consultar y buscar unos segundos después de que se complete la operación de indexación. |
| 201 Creado | Proceso completado correctamente en PUT o POST. Objeto creado o actualizado correctamente. |
| 204 Accepted | Proceso completado correctamente en PUT o POST. Índice o documentos cargados correctamente. |
| 207 Multi-Status | Proceso completado correctamente de manera parcial para PUT o POST. Algunos documentos se completaron correctamente, pero se produjo un error en al menos uno. |
| 400 - Solicitud incorrecta | Se devuelve cuando se produce un error en el URI de solicitud, los encabezados o el cuerpo. El cuerpo de la respuesta contiene un mensaje de error que explica cuál es el problema específico. |
| 403 Prohibido | Se devuelve cuando se pasa una clave de API no válida. |
| 404 No encontrado | Se devuelve cuando un recurso no existe en el servidor. Si va a administrar o consultar un índice, compruebe la sintaxis y compruebe que el nombre del índice se ha especificado correctamente. |
| No se admite el método 405 | Se devuelve cuando la solicitud especifica un método reconocido, pero 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=2020-06-30). |
| 409 Conflicto | Se devuelve cuando entran en conflicto las operaciones de escritura. Este error 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 la condición del encabezado If-None-Match se evalúa como false. Asociado con el uso del control de simultaneidad optimista al enviar solicitudes HTTP para definiciones de índice, indexadores o orígenes de datos. |
| 429 Demasiadas solicitudes | Si se produce este error mientras intenta crear un índice, significa que ya tiene el número máximo de índices permitidos para el plan de tarifa. Un recuento de los índices almacenados en Azure AI Search es visible en el panel del servicio de búsqueda en el Azure Portal. Para ver los índices por nombre, seleccione el icono Índice . Como alternativa, también puede obtener una lista de los índices por su nombre mediante la operación List Indexes . Consulte Índices de la lista para obtener más información.
Si este error se produce durante la carga de documentos, indica que ha superado la cuota en el número de documentos por índice. Debe crear un nuevo índice o actualizar para obtener límites de capacidad superiores. |
| 499 Solicitud cerrada de cliente | Este error nunca se devuelve en una respuesta, pero es posible que lo vea en las entradas de registro registradas por el 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 solicitó el código del lado del servicio o que el cliente ya no existe, se registra un error 499. |
| Puerta de enlace incorrecta 502 | Este error se produce cuando escribe HTTP en lugar de HTTPS en la conexión. |
| Servicio no disponible 503 | Este error significa que el sistema está sobrecargado y no se puede procesar la solicitud en este momento. Importante: En este caso, se recomienda encarecidamente que el código de cliente vuelva a desactivarse y espere antes de volver a intentarlo. Esto le dará al sistema un tiempo para recuperarse, lo cual hará aumentar las posibilidades de que las solicitudes futuras se realicen correctamente. Si lo vuelve a intentar demasiado pronto solo logrará prolongar la situación. Consulte Análisis del rendimiento para obtener más información sobre la limitación y cómo evitar esta condición. |
| 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. |