Errores HTTP-5xx cuando el despliegue de API se crea correctamente pero las solicitudes fallan

Descubra cómo solucionar errores HTTP-5xx cuando un despliegue de API se crea correctamente con el servicio de gateway de API, pero las solicitudes fallan.

Una vez creado correctamente un despliegue de API, puede que encuentre errores HTTP-5xx al llamarlo.

La llamada al despliegue de API falla con un error HTTP-5xx y se muestra un error "failed to parse pem cert chain" en el log

Al llamar a un despliegue de API que tiene TLS mutuo activado, es posible que vea el fallo de la solicitud con un error HTTP-5xx y la siguiente salida de error en el log:
failed to parse pem cert chain

Este error se produce cuando el grupo de autoridades de certificación personalizadas del almacén de confianza del gateway de API que aloja el despliegue de API no tiene el formato correcto.

Para solucionar este problema, asegúrese de que el grupo de autoridades de certificación personalizadas del almacén de confianza del gateway de API tenga el formato correcto. Para obtener más información, consulte Adición de soporte de mTLS a despliegues de API.

La llamada al despliegue de API falla con un error HTTP-5xx y se muestra el error "Client CA Bundle not present" en el log

Al llamar a un despliegue de API que tiene TLS mutuo activado, es posible que vea el fallo de la solicitud con un error HTTP-5xx y la siguiente salida de error en el log:

Client CA Bundle not present.

Este error se produce cuando se despliega al menos un despliegue de API activado para mTLS en un gateway de API, pero no se ha agregado un grupo de autoridades de certificación personalizado al almacén de confianza del gateway de API.

Para solucionar este problema, realice una de las siguientes acciones:

  • Suprima todos los despliegues de API activados para mTLS del gateway de API.
  • Edite todos los despliegues de API activados para mTLS en el gateway de API para desactivar el soporte de mTLS.
  • Agregue un grupo de autoridades de certificación personalizado al almacén de confianza del gateway de API.

Para obtener más información, consulte Adición de soporte de mTLS a despliegues de API.

La llamada al despliegue de API falla con un error HTTP-5xx y se muestra el error "Error en la verificación del certificado del cliente" en el log

Al llamar a un despliegue de API que tiene TLS mutuo activado, es posible que vea el fallo de la solicitud con un error HTTP-5xx y la siguiente salida de error en el log:

Error in client certificate verification.

Este error se produce cuando el grupo de autoridades de certificación personalizado agregado al almacén de confianza del gateway de API tiene un formato no válido. El log contiene información adicional sobre la solicitud fallida.

Para solucionar este problema, asegúrese de que el grupo de autoridades de certificación personalizado agregado al almacén de confianza del gateway de API tenga el formato correcto. Utilice la información de rastreo del log para corregir este error. Para obtener más información, consulte Adición de soporte de mTLS a despliegues de API.

La llamada al despliegue de API falla con un mensaje "Service Unavailable" y un error 503

Al llamar a un despliegue de API, puede que la solicitud falle con un error HTTP-503 y el siguiente mensaje de error:

Service Unavailable.

El mensaje indica que el gateway de API no puede manejar la solicitud actualmente, posiblemente debido a una capacidad insuficiente.

Tenga en cuenta que:

  • Si sigue viendo este error, considere la posibilidad de configurar clientes de API para aumentar el intervalo de tiempo entre las llamadas de despliegue de API (quizás utilizando una técnica estándar como el retroceso exponencial de jittered para agregar un grado de aleatoriedad al intervalo).
  • Si el número de errores HTTP-503 está afectando negativamente al rendimiento de la solicitud/respuesta y es inaceptable desde el punto de vista operativo aumentar el intervalo de tiempo entre llamadas de API, póngase en contacto con nosotros y solicite un aumento de la capacidad de CPU asignada. Cuando se ponga en contacto con nosotros, proporcione el OCID del gateway de API, un período de tiempo durante el cual se ha manejado correctamente un ratio de rendimiento de solicitudes alto y el ratio de rendimiento de destino que desea lograr. Consideramos las consultas sobre el aumento de la capacidad de la CPU caso por caso.
  • Si el mensaje aparece cuando se llama a un despliegue de API como resultado de una acción disparada por un evento, los intentos adicionales de llamar al despliegue de API se volverán a intentar automáticamente hasta que se llame correctamente al despliegue de API. No es necesario que intervenga.
  • Si configura alarmas que se disparan mediante respuestas de error de despliegue de API que contienen códigos de error 503, es posible que vea varias notificaciones para las que no es necesaria ninguna intervención por su parte.
  • Si el mensaje continúa apareciendo después de un período prolongado, póngase en contacto con nosotros para obtener ayuda.