Documentazione di Oracle Cloud Infrastructure

Risoluzione dei problemi relativi al gateway API

Scopri come risolvere i problemi con API Gateway e le possibili soluzioni ai problemi più comuni.

In questo argomento vengono descritti i problemi comuni correlati al servizio API Gateway e le modalità per risolverli.

I problemi in questo argomento sono organizzati nelle seguenti categorie generali:

Problemi durante la creazione di gateway API

Messaggio di errore o descrizione Ulteriori informazioni
La creazione di un nuovo gateway API blocca lo stato di creazione o non riesce. Creazione di un nuovo gateway API con stato di creazione o errore
VNIC attachment failed due to the limit for number of private IP addresses for this subnet La creazione di un nuovo gateway API restituisce un messaggio "Collegamento VNIC non riuscito a causa del limite per il numero di indirizzi IP privati per questa subnet"
The limit for number of private IP addresses for this subnet has been exceeded La creazione di un nuovo gateway API restituisce il messaggio "Il limite per il numero di indirizzi IP privati per questa subnet è stato superato"
The limit for number of public IP addresses for this compartment has been exceeded La creazione di un nuovo gateway API pubblico restituisce il messaggio "Il limite per il numero di indirizzi IP pubblici per questo compartimento è stato superato"
Work request was cancelled La creazione di un nuovo gateway API restituisce un messaggio "Richiesta di lavoro annullata"
An unexpected error occurred. Contact Oracle Support for assistance. La creazione di un nuovo gateway API restituisce "Si è verificato un errore imprevisto. Contattare il Supporto Oracle per assistenza"
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 creazione di un nuovo gateway API restituisce un messaggio "Risorsa sconosciuta <subnet-ocid>, assicurarsi che la subnet esista,..." e un errore 400

Problemi durante la creazione di distribuzioni API

Errori correlati allo stallo delle distribuzioni API:

Messaggio di errore o descrizione Ulteriori informazioni
La creazione di una nuova distribuzione API si blocca con lo stato di creazione o non riesce. Creazione di un nuovo database di distribuzione API con stato di creazione o errore

Errori HTTP-4xx "Richiesta non valida" relativi alla configurazione mTLS:

Messaggio di errore o descrizione Ulteriori informazioni
Cannot enable mutual TLS because custom CA Bundles are not added to the Gateway. Please add a custom CA Bundle and try again. Creazione di una nuova distribuzione API non riuscita con "Impossibile abilitare TLS reciproco perché i bundle CA personalizzati non vengono aggiunti al gateway. Aggiungere un bundle CA personalizzato e riprovare."
Duplicate SAN or CN values passed in input. Creazione di una nuova distribuzione API non riuscita con il messaggio "Duplica valori SAN o CN passati nell'input"
Too many value, must not have more than 10 values. Creazione di una nuova distribuzione API non riuscita con il messaggio "Troppi valori, non deve contenere più di 10 valori"
Length of SAN or CN string should be less than 256 characters. Creazione di una nuova distribuzione API non riuscita con il messaggio "La lunghezza della stringa SAN o CN deve essere inferiore a 256 caratteri"
Invalid format for SAN or CN. Creazione di una nuova distribuzione API non riuscita con "Formato non valido per SAN o CN"

Problemi durante la chiamata delle API

Utilizzare i log del gateway API per rivedere le informazioni di richiamo. Il servizio Oracle Cloud Infrastructure Logging è l'opzione predefinita e consigliata per accedere, cercare e memorizzare i log del gateway API. Per ulteriori informazioni, vedere Aggiunta di log alle distribuzioni API.

Utilizzare i messaggi di errore dei log e le informazioni riportate di seguito per risolvere i problemi di richiamo.

Errori HTTP-5xx quando la distribuzione dell'API viene creata correttamente ma le richieste non riescono:

Messaggio di errore o descrizione Ulteriori informazioni
failed to parse pem cert chain, visualizzata nel log. Il richiamo della distribuzione API non riesce con un errore HTTP-5xx e nel log viene restituito un errore di "analisi della catena di certificati pem non riuscita".
Client CA Bundle not present, visualizzata nel log. Il richiamo della distribuzione API non riesce con un errore HTTP-5xx e nel log viene restituito un errore "Bundle CA client non presente".
Error in client certificate verification, visualizzata nel log. Il richiamo della distribuzione API non riesce con un errore HTTP-5xx e nel log viene restituito un errore "Errore nella verifica del certificato client".
503: Service Unavailable Il richiamo della distribuzione API non riesce con un messaggio "Servizio non disponibile" e un errore 503

Errori HTTP-4xx quando la distribuzione dell'API è stata creata correttamente ma le richieste non riescono:

Messaggio di errore o descrizione Ulteriori informazioni
Client certificate is invalid for this gateway., visualizzata nel log. Il richiamo della distribuzione API non riesce con un errore HTTP-4xx e un errore "Certificato client non valido per questo gateway" viene restituito al log
SAN validation failure, visualizzata nel log. Il richiamo della distribuzione API non riesce con un errore HTTP-4xx e nel log viene restituito un errore di "errore di convalida SAN"

Errori vari durante la chiamata delle API

Messaggio di errore o descrizione Ulteriori informazioni
Base 64 Certificate Size greater than 8KB, visualizzata nel log. Richiamo della distribuzione dell'API riuscito, ma nel log viene generata un'avvertenza "Dimensione certificato base 64 maggiore di 8 KB"

Problemi che interessano i gateway API

Messaggio di errore o descrizione Ulteriori informazioni
La modifica di una tag definita comporta l'immissione di uno stato non riuscito da parte di un gateway API. La modifica di una tag definita fa sì che un gateway API immetta uno stato non riuscito