Documentación de Oracle Cloud Infrastructure

Solución de problemas de gateway de API

Descubra cómo solucionar problemas con el gateway de API y posibles soluciones a problemas comunes.

En este tema se tratan problemas comunes relacionados con el servicio de gateway de API y cómo puede abordarlos.

Los temas de este tema se organizan en las siguientes categorías generales:

Incidencias al crear gateways de API

Mensaje de error o descripción Más Información
La creación de un nuevo gateway de API se detiene en estado Creando, o es fallida. La creación de un nuevo gateway de API se detiene en estado Creando, o es fallida
VNIC attachment failed due to the limit for number of private IP addresses for this subnet La creación de un nuevo gateway de API devuelve un mensaje del siguiente tipo: "Error de asociación de VNIC debido al límite de número de direcciones IP privadas para esta subred"
The limit for number of private IP addresses for this subnet has been exceeded La creación de un nuevo gateway de API devuelve un mensaje del siguiente tipo: "Se ha superado el límite de número de direcciones IP privadas para esta subred"
The limit for number of public IP addresses for this compartment has been exceeded La creación de un nuevo gateway de API devuelve un mensaje del siguiente tipo: "Se ha superado el límite de número de direcciones IP públicas para este compartimento"
Work request was cancelled La creación de un nuevo gateway de API devuelve un mensaje del siguiente tipo: "Se ha cancelado la solicitud de trabajo"
An unexpected error occurred. Contact Oracle Support for assistance. La creación de un nuevo gateway de API devuelve un mensaje del siguiente tipo: "Se ha producido un error inesperado. Póngase en contacto con los Servicios de Soporte Oracle para obtener ayuda"
Unknown resource <subnet-ocid>, make sure subnet exists, the user can access the subnet and it is in the same region where the gateway will be created La creación de un nuevo gateway de API devuelve un mensaje del siguiente tipo: "Recurso desconocido <subnet-ocid>, asegúrese de que la subred existe,...", así como un error 400

Incidencias al crear despliegues de API

Errores relacionados con la detención de despliegues de API:

Mensaje de error o descripción Más Información
La creación de un nuevo despliegue de API se detiene en estado Creando, o falla. La creación de un nuevo despliegue de API se detiene en estado Creando, o falla

Errores HTTP-4xx de "solicitud incorrecta" relacionados con la configuración de mTLS:

Mensaje de error o descripción Más Información
Cannot enable mutual TLS because custom CA Bundles are not added to the Gateway. Please add a custom CA Bundle and try again. La creación de un nuevo despliegue de API falla con "No se puede activar TLS mutuo porque no se han agregado grupos de autoridades de certificación personalizados al gateway. Agregue un grupo de CA personalizado y vuelva a intentarlo." mensaje
Duplicate SAN or CN values passed in input. La creación de un nuevo despliegue de API falla con el mensaje "Duplicar valores de SAN o CN transferidos en la entrada"
Too many value, must not have more than 10 values. La creación de un nuevo despliegue de API falla con el mensaje "Demasiado valor, no debe tener más de 10 valores"
Length of SAN or CN string should be less than 256 characters. La creación de un nuevo despliegue de API falla con el mensaje "La longitud de la cadena SAN o CN debe tener menos de 256 caracteres"
Invalid format for SAN or CN. La creación de un nuevo despliegue de API falla con "Formato no válido para SAN o CN"

Problemas al llamar a las API

Utilice los logs de gateway de API para revisar la información de llamada. El servicio Oracle Cloud Infrastructure Logging es la opción por defecto y recomendada para acceder, buscar y almacenar logs de gateway de API. Para obtener más información, consulte Adición de Registro a Despliegues de API.

Utilice los mensajes de error de los logs y la siguiente información para resolver los problemas de llamada.

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

Mensaje de error o descripción Más Información
failed to parse pem cert chain, que se muestra en el log. 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
Client CA Bundle not present, que se muestra en el log. 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
Error in client certificate verification, que se muestra en el log. 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
503: Service Unavailable La llamada al despliegue de API falla con un mensaje "Service Unavailable" y un error 503

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

Mensaje de error o descripción Más Información
Client certificate is invalid for this gateway., que se muestra en el log. La llamada al despliegue de API falla con un error HTTP-4xx y se muestra un error "El certificado de cliente no es válido para este gateway" en el log
SAN validation failure, que se muestra en el log. La llamada al despliegue de API falla con un error HTTP-4xx y se muestra un error "Fallo de validación de SAN" en el log

Errores varios al llamar a las API

Mensaje de error o descripción Más Información
Base 64 Certificate Size greater than 8KB, que se muestra en el log. La llamada al despliegue de API se ha realizado correctamente, pero se muestra una advertencia "Base 64 Certificate Size than 8KB" en el log

Problemas que afectan a los gateways de API

Mensaje de error o descripción Más Información
La modificación de una etiqueta definida hace que un gateway de API entre en un estado de fallo. La modificación de una etiqueta definida hace que un gateway de API entre en un estado de fallo