Catalogo degli errori di runtime

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Errori in Apigee Edge

Quando le richieste API vengono effettuate tramite Apigee Edge, i componenti Router e Message Processor di Apigee Edge o i server di backend possono restituire errori alle applicazioni client.

Errori del processore di messaggi

Il processore di messaggi è il componente principale di Apigee Edge che elabora i criteri e interagisce con i server di backend. Può restituire errori se rileva problemi come:

  • Problemi di connettività di rete, errori di handshake TLS, mancata disponibilità del server di backend, mancanza di risposta durante la comunicazione con il server di backend
  • Errori durante l'esecuzione dei criteri
  • Intestazioni HTTP, codifica, percorso non validi, mancata conformità alle specifiche HTTP, superamento dei limiti del prodotto e così via:
    • Con la richiesta HTTP inviata dalle applicazioni client

      • OPPURE

    • Con la risposta HTTP inviata dal server di backend
  • E molti altri ancora

Esempio di errore del processore di messaggi

Il processore di messaggi restituisce sempre un codice di stato HTTP seguito da un messaggio di errore e da un codice di errore in formato JSON, come mostrato di seguito:

L'applicazione client riceve un codice di risposta come nell'esempio seguente: 

HTTP/1.1 414 Request-URI Too Long

Una risposta di errore del processore di messaggi appare nel seguente formato: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Descrizione dei campi nella risposta di errore:

Campo Descrizione
faultstring Contiene il messaggio di errore che descrive la possibile causa dell'errore
errorcode Codice di errore (chiamato anche codice di errore) associato all'errore

Catalogo degli errori di runtime

Questo catalogo degli errori fornisce tutte le informazioni necessarie sui codici di errore di runtime (per gli errori non relativi ai criteri) restituiti dal componente del processore di messaggi di Apigee Edge. Include le seguenti informazioni per ciascun codice di errore:

  • Codice di stato HTTP
  • Messaggio di errore
  • Possibili cause dell'errore
  • Eventuali specifiche HTTP e/o limiti di prodotto associati
  • Playbook e video che contengono istruzioni per diagnosticare la causa dell'errore e soluzioni efficaci che puoi applicare per risolverlo autonomamente (se disponibili)
  • Correzione che puoi applicare per risolvere autonomamente l'errore

Sono coperte le seguenti categorie di codici di errore:

Utilizza la casella Cerca di seguito per filtrare la tabella in modo da visualizzare le informazioni riportate sopra per uno specifico codice di errore. Puoi cercare il codice di stato o qualsiasi contenuto in qualsiasi campo della tabella.

Codice di errore Descrizione Correggi

flow.*

flow.APITimedOut
  • Codice di stato HTTP:
 504 Gateway Timeout
  • Messaggio di errore:
 API timed out
  • Possibile causa:

Questo errore si verifica se:

  • Il server di backend non risponde entro il periodo di timeout configurato dalla proprietà api.timeout per il proxy API specifico.
  • Un criterio richiede molto tempo a causa di operazioni ad alta intensità di calcolo, un carico elevato o prestazioni scadenti.

Nota: questo playbook fornisce istruzioni per risolvere il codice di errore messaging.adaptors.http.flow.GatewayTimeout; tuttavia, puoi usare lo stesso playbook per risolvere il codice di errore flow.APITimedOut.

PLAYBOOK

flow.SharedFlowNotFound
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Shared Flow {shared_flow_name} Not Found
  • Possibile causa:

Questo errore si verifica se il flusso condiviso specifico:

  • Non esiste

    • OPPURE

  • Esiste, ma non è implementata
GUIDA PRATICA

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • Codice di stato HTTP:
 404 Not Found
  • Messaggio di errore:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • Possibile causa:

Questo errore si verifica in uno dei seguenti scenari:

  1. Il proxy API specifico è:
    1. NON configurato per accettare richieste sull'host virtuale specifico
    2. NON configurato per accettare richieste sul percorso specifico utilizzato nella richiesta
    3. NON di cui è stato eseguito il deployment nell'ambiente specifico in cui stai tentando di effettuare le richieste API
    4. NON di cui è stato eseguito il deployment su uno o più elaboratori di messaggi
  2. L'ambiente specifico in cui stai tentando di effettuare le richieste API non è caricato su uno o più processori di messaggi
 STRATEGIA
Questo errore può verificarsi anche se più host virtuali hanno lo stesso alias e lo stesso numero di porta. PLAYBOOK

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Decompression failure at request
  • Possibile causa:

Questo errore si verifica solo se:

  • La codifica specificata nell'intestazione della richiesta HTTP Content-Encoding è valida e supportata da Apigee Edge,

    • MA

  • Il formato del payload inviato dal client nell'ambito della richiesta HTTP non corrisponde al formato di codifica specificato nell'intestazione Content-Encoding
PLAYBOOK

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Decompression failure at response
  • Possibile causa:

Questo errore si verifica solo se:

  • La codifica specificata nell'intestazione di risposta HTTP Content-Encoding del server di backend/destinazione è valida e supportata da Apigee Edge.

    • MA

  • Il formato del payload inviato dal server di backend/destinazione come parte della risposta HTTP non corrisponde al formato di codifica specificato nell'Content-Encoding intestazione
PLAYBOOK

messaging.adaptors.http.flow.ErrorResponseCode
  • Codice di stato HTTP:
 500

STRATEGIA

VIDEO

  • Messaggio di errore:
 Il messaggio e il formato di errore possono variare a seconda dell'implementazione del server di backend.
  • Possibile causa:
 Questo errore si verifica se il server di backend risponde con il codice di stato 500 ad Apigee Edge.
  • Codice di stato HTTP:
 503

PLAYBOOK

VIDEO

  • Messaggio di errore:
 Il messaggio e il formato di errore possono variare a seconda dell'implementazione del server di backend.
  • Possibile causa:
 Questo errore si verifica se il server di backend risponde con il codice di stato 503 ad Apigee Edge.
  • Codice di stato HTTP:
 504 STRATEGIA
  • Messaggio di errore:
 Il messaggio e il formato di errore possono variare a seconda dell'implementazione del server di backend.
  • Possibile causa:
 Questo errore si verifica se il server di backend risponde con il codice di stato 504 ad Apigee Edge.

Nota: il codice di erroremessaging.adaptors.http.flow.ErrorResponseCode non viene restituito come parte del messaggio di errore inviato alle applicazioni client. Questo accade perché questo codice di errore viene impostato da Apigee Edge ogni volta che il server di backend risponde con un errore e uno dei codici di stato 4XX o 5XX. Puoi visualizzare questo codice di errore nel monitoraggio dell'API, nei log di accesso NGINX o nel database di analisi.

messaging.adaptors.http.flow.GatewayTimeout
  • Codice di stato HTTP:
 504 Gateway Timeout
  • Messaggio di errore:
 Gateway Timeout
  • Possibile causa:
 Questo errore si verifica se il server di backend non risponde al Message Processor di Apigee Edge entro il periodo di timeout I/O configurato nel Message Processor.
PLAYBOOK

messaging.adaptors.http.flow.LengthRequired
  • Codice di stato HTTP:
 411 Length Required
  • Messaggio di errore:
 'Content-Length' is missing
  • Possibile causa:

Questo errore si verifica se l'intestazione Content-Length non viene passata dall'applicazione client nell'ambito delle richieste HTTP POST e PUT inviate ad Apigee Edge.

Nota:le richieste che non vanno a buon fine con questo errore non possono essere acquisite nello strumento di monitoraggio, poiché il Message Processor esegue questa convalida in una fase molto precoce, molto prima dell'elaborazione della richiesta e dell'esecuzione di qualsiasi criterio nel proxy API.
  • Specifica HTTP:
 Sezione 3.3.2 del documento RFC: Content-Length

Correggi

Per risolvere questo errore, svolgi i seguenti passaggi:

  1. Assicurati che l'applicazione client passi sempre l'intestazione Content-Length come parte delle richieste HTTP POST e PUT inviate ad Apigee Edge. Ad esempio:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. Anche se passi un payload vuoto con le richieste POST e PUT, assicurati che l'intestazione Content-Length: 0 venga passata. Ad esempio:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • Codice di stato HTTP:
 503 Service Unavailable
  • Messaggio di errore:
 The Service is temporarily unavailable
  • Possibile causa:

Questo errore si verifica in uno dei seguenti scenari, se utilizzi TargetServer in Apigee Edge:

  1. La risoluzione DNS errata dell'host del server di backend da parte del server di autorizzazione personalizzato ha generato indirizzi IP non validi che hanno causato errori di connessione.
  2. Errori di timeout della connessione dovuti a:
    1. La limitazione del firewall sul server di backend impedisce ad Apigee Edge di connettersi al server di backend.
    2. Problemi di connettività di rete tra Apigee Edge e il server di backend.
  3. L'host specificato in TargetServer non è corretto o contiene caratteri indesiderati (ad esempio uno spazio).

STRATEGIA

VIDEO
Questo errore può verificarsi anche se i controlli di integrità configurati per monitorare il controllo di integrità dei server di destinazione non riescono.

PLAYBOOK

VIDEO

messaging.adaptors.http.flow.RequestTimeOut
  • Codice di stato HTTP:
 408 Request Timeout
  • Messaggio di errore:
 Request timed out
  • Possibile causa:
 Questo errore si verifica se il processore di messaggi Apigee Edge non riceve il payload di richiesta dall'applicazione client per il periodo di timeout I/O configurato sul componente Processore di messaggi.

Correggi

Assicurati che l'applicazione client invii il payload della richiesta entro il periodo di timeout I/O configurato nel componente Message Processor di Apigee Edge.

messaging.adaptors.http.flow.ServiceUnavailable
  • Codice di stato HTTP:
 503 Service Unavailable
  • Messaggio di errore:
 The Service is temporarily unavailable
  • Possibile causa:

Questo errore si verifica in uno dei seguenti scenari:

  1. La risoluzione DNS errata dell'host del server di backend da parte del server di autorizzazione personalizzato ha generato indirizzi IP errati che hanno causato errori di connessione.
  2. Errori di timeout della connessione dovuti a:
    1. La limitazione del firewall sul server di backend impedisce ad Apigee Edge di connettersi al server di backend.
    2. Problemi di connettività di rete tra Apigee Edge e il server di backend.
  3. L'host del server di destinazione specificato nell'endpoint di destinazione è scorretto o contiene caratteri indesiderati (ad esempio uno spazio).

STRATEGIA

Errore DNS:

Connettività di rete:

VIDEO
Questo errore può verificarsi anche se il server di backend chiude prematuramente la connessione mentre il Message Processor sta ancora inviando il payload della richiesta al server di backend. GUIDA PRATICA

messaging.adaptors.http.flow.SslHandshakeFailed
  • Codice di stato HTTP:
 503 Service Unavailable
  • Messaggio di errore:
 SSL Handshake failed {error_message}
  • Possibile causa:

Questo errore si verifica durante il processo di handshake SSL tra il processore di messaggi di Apigee Edge e il server di backend se:

  1. Il truststore dell'elaborazione dei messaggi di Apigee Edge:
    • Contiene una catena di certificati che non corrisponde alla catena di certificati completa del server di backend

      • OPPURE

    • Non contiene la catena di certificati completa del server di backend
  2. La catena di certificati presentata dal server di backend:
    • Contiene un nome di dominio completo (FQDN) che non corrisponde al nome host specificato nell'endpoint di destinazione

      • OPPURE

    • Contiene una catena di certificati errata/incompleta

PLAYBOOK

VIDEO

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Unexpected EOF at target
  • Possibile causa:

Questo errore si verifica in uno dei seguenti scenari:

  1. TargetServer non è configurato correttamente per supportare le connessioni TLS/SSL in Apigee Edge.
  2. Il server di backend potrebbe chiudere la connessione bruscamente, mentre Apigee Edge è in attesa di una risposta dal server di backend.
  3. Mantieni i timeout attivi configurati in modo errato su Apigee e sul server di backend.
GUIDA PRATICA

messaging.runtime.*

messaging.runtime.RouteFailed
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Unable to route the message to a TargetEndpoint
  • Possibile causa:

Questo errore si verifica se Apigee Edge non riesce a instradare la richiesta a nessuno degli endpoint di destinazione perché:

  • Non esiste una condizione della regola di instradamento (<RouteRule>) che corrisponda alla richiesta in un proxy

    • E

  • Non è stata definita alcuna regola di route predefinita in ProxyEndpoint (ad es. <RouteRule> senza alcuna condizione)

Correggi

Per risolvere questo errore, segui queste istruzioni:

  1. Esamina le regole di route definite in ProxyEndpoint e modificale per assicurarti che esista almeno una condizione della regola di route che corrisponda alla tua richiesta.
  2. È buona norma definire una regola di route predefinita senza condizioni quando sono presenti più routeRules.
  3. Assicurati che la regola di route predefinita sia sempre definita per ultima nell'elenco di route condizionali, in quanto le regole vengono valutate dall'alto verso il basso in ProxyEndpoint.

Per scoprire di più sulla definizione delle condizioni <RouteRule> in un ProxyEndpoint, consulta Target agevolati.

messaging.runtime.SenseRaiseFault
  • Codice di stato HTTP:
 403 Forbidden
  • Messaggio di errore:
 Sense Fault
  • Possibile causa:
 Questo errore si verifica se una richiesta API viene effettuata da un determinato indirizzo IP del client bloccato nell'ambito delle regole di Apigee Sense.

Correggi

Per correggere questo errore:

  1. Verifica di aver bloccato l'indirizzo IP del client specifico controllando le regole configurate in Apigee Sense. Se è bloccato, significa che funziona come previsto.
  2. Se l'indirizzo IP del client specifico non è bloccato, ma continui a ricevere questo errore, contatta l'assistenza Apigee Edge.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Bad Form Data
  • Possibile causa:

Questo errore si verifica solo se vengono soddisfatte tutte le seguenti condizioni:

  1. La richiesta HTTP inviata dal client ad Apigee Edge contiene:
    • Content-Type: application/x-www-form-urlencoded e
    • Dati del modulo con il segno percentuale (%) o il segno percentuale (%) seguito da caratteri esadecimali non validi non consentiti come da Moduli - Sezione 17.13.4.1.
  2. Il proxy API in Apigee Edge legge i parametri del modulo specifici contenenti caratteri non consentiti utilizzando il criterio ExtractVariables o AssignMessage nel flusso di richiesta.
PLAYBOOK

protocol.http.DuplicateHeader
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Duplicate Header "{header_name}"
  • Possibile causa:
 Questo errore si verifica se un'intestazione HTTP specifica che non è consentita in Apigee Edge appare più di una volta con valori uguali o diversi all'interno della richiesta HTTP inviata dall'applicazione client ad Apigee Edge.
  • Specifica HTTP:
 RFC 7230, sezione 3.2.2: Ordine dei campi
GUIDA PRATICA

protocol.http.EmptyHeaderName
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Header name cannot be empty
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato nell'ambito della richiesta HTTP dall'applicazione client ad Apigee Edge è vuoto.
  • Specifica HTTP:
 RFC 7230, sezione 3.2: campi dell'intestazione

Correggi

Assicurati che la richiesta HTTP inviata dall'applicazione client ad Apigee Edge contenga sempre un nome di intestazione valido come da RFC 7230, sezione 3.2: campi di intestazione.

protocol.http.HeaderNameWithNonAsciiChar
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Header {header_name} contains non ascii character {character}
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato nell'ambito della richiesta HTTP dall'applicazione client ad Apigee Edge contiene caratteri non ASCII.
  • Specifica HTTP:

RFC 7230, sezione 3.2: campi intestazione e RFC 7230, sezione 3.2.6: componenti valore campo

Correggi

Assicurati che la richiesta HTTP del client inviata ad Apigee Edge non contenga caratteri non ASCII nei nomi delle intestazioni come da RFC 7230, sezione 3.2.6: Componenti del valore del campo.

protocol.http.HeaderWithInvalidChar
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Header {header_name} contains invalid character {character}
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato nell'ambito della richiesta HTTP dall'applicazione client ad Apigee Edge contiene caratteri non validi come uguale (=), virgola (,), punto e virgola (;), tabulazione, CRLF e carattere di a capo.
  • Specifica HTTP:

RFC 7230, sezione 3.2: campi intestazione e RFC 7230, sezione 3.2.6: componenti valore campo

Correggi

Assicurati che la richiesta HTTP inviata dall'applicazione client ad Apigee Edge non contenga caratteri non validi nei nomi delle intestazioni come da RFC 7230, sezione 3.2.6: Componenti del valore del campo

protocol.http.InvalidPath
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Invalid path {path}
  • Possibile causa:
 Questo errore si verifica se il percorso dell'URL della richiesta HTTP inviato dall'applicazione client ad Apigee Edge contiene caratteri non consentiti in base alla specifica RFC 3986, sezione 3.3: Percorso.
  • Specifica HTTP:

RFC 3986, sezione 3: Componenti della sintassi e RFC 3986, sezione 3.3: Percorso

Correggi

Assicurati che il percorso nell'URL della richiesta HTTP inviato dall'applicazione client ad Apigee Edge non contenga caratteri non consentiti come indicato nella sezione 3.3 della specifica RFC 3986: Percorso.

protocol.http.TooBigBody
  • Codice di stato HTTP:
 413 Request Entity Too Large
  • Messaggio di errore:
 Body buffer overflow
  • Possibile causa:
 Questo errore si verifica se la dimensione del payload inviata dall'applicazione client come parte della richiesta HTTP ad Apigee Edge è superiore al limite consentito in Apigee Edge.
  • Limiti:
 Limiti di Apigee Edge
PLAYBOOK

protocol.http.TooBigHeaders
  • Codice di stato HTTP:
 431 Request Header Fields Too Large
  • Messaggio di errore:
 request headers size exceeding {limit}
  • Possibile causa:
 Le dimensioni totali di tutte le intestazioni di richiesta inviate dall'applicazione client nell'ambito della richiesta HTTP ad Apigee Edge sono superiori al limite consentito in Apigee Edge.
  • Specifica HTTP:
 RFC 6585, sezione 5: 431 Request Header Fields Too Large
  • Limiti:
 Limiti di Apigee Edge
PLAYBOOK

protocol.http.TooBigLine
  • Codice di stato HTTP:
 414 Request-URI Too Long
  • Messaggio di errore:
 request line size exceeding {limit}
  • Possibile causa:
 Questo errore si verifica se le dimensioni della riga di richiesta inviata dall'applicazione client nell'ambito della richiesta HTTP ad Apigee Edge sono superiori al limite consentito in Apigee Edge.
  • Limiti:
 Limiti di Apigee Edge
PLAYBOOK

protocol.http.UnsupportedEncoding
  • Codice di stato HTTP:
 415 Unsupported Media
  • Messaggio di errore:
 Unsupported Encoding "{encoding}"
  • Possibile causa:
 Questo errore si verifica se l'intestazione Content-Encoding inviata dal client nell'ambito della risposta HTTP contiene un formato di codifica/payload non supportato da Apigee Edge.
  • Specifica HTTP:
 RFC 7231, sezione 6.5.13: 415 Unsupported Media Type
PLAYBOOK

protocol.http.* - Caused by target

protocol.http.BadPath
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Invalid request path
  • Possibile causa:
 Questo errore si verifica se l'URL richiesta del server di backend, rappresentato dalla variabile di flusso target.url, contiene un percorso che inizia con un punto interrogativo (?) anziché una barra (/), che è non valido.
  • Specifica HTTP:

RFC 3986, sezione 3: componenti di sintassi e RFC 3986, sezione 3.3: Percorso
PLAYBOOK

protocol.http.DuplicateHeader
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Duplicate Header "{header_name}"
  • Possibile causa:
 Questo errore si verifica se l'intestazione HTTP specifica che non è autorizzata ad avere duplicati in Apigee Edge appare più di una volta con valori uguali o diversi come parte della risposta HTTP inviata dal server di backend ad Apigee Edge.
  • Specifica HTTP:
 RFC 7230, sezione 3.2.2: Ordine dei campi
PLAYBOOK

protocol.http.EmptyHeaderName
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Header name cannot be empty
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato dal server di backend nell'ambito della risposta HTTP ad Apigee Edge è vuoto.
  • Specifica HTTP:
 RFC 7230, sezione 3.2: campi dell'intestazione

Correggi

Assicurati che la risposta HTTP inviata dal server di backend ad Apigee Edge contenga sempre un nome di intestazione valido come da RFC 7230, sezione 3.2: campi di intestazione.

protocol.http.EmptyPath
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Request path cannot be empty
  • Possibile causa:
 Questo errore si verifica se l'URL della richiesta HTTP del server di backend, rappresentato dalla variabile di flusso target.url, contiene un percorso vuoto.
  • Specifica HTTP:

RFC 3986, sezione 3: Componenti della sintassi e RFC 3986, sezione 3.3: Percorso
PLAYBOOK

protocol.http.HeaderNameWithNonAsciiChar
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Header {header_name} contains non ascii character {character}
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato dal server di backend nell'ambito della risposta HTTP ad Apigee Edge contiene caratteri non ASCII.
  • Specifica HTTP:

RFC 7230, sezione 3.2: campi di intestazione e RFC 7230, sezione 3.2.6: componenti del valore del campo

Correggi

Assicurati che la risposta HTTP del server di backend inviata ad Apigee Edge non contenga caratteri non ASCII nei nomi delle intestazioni come da RFC 7230, sezione 3.2.6: Componenti del valore del campo.

protocol.http.HeaderWithInvalidChar
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Header {header_name} contains invalid character {character}
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato dal server di backend nell'ambito della risposta HTTP contiene caratteri non validi come il segno di uguale (=), la virgola (,), il punto e virgola (;), la tabulazione, il CRLF e il carattere di a capo.
  • Specifica HTTP:

RFC 7230, sezione 3.2: campi intestazione e RFC 7230, sezione 3.2.6: componenti valore campo

Correggi

Assicurati che la risposta HTTP del server di backend inviata ad Apigee Edge non contenga caratteri non validi nei nomi delle intestazioni come da RFC 7230, sezione 3.2.6: Componenti del valore del campo

protocol.http.ProxyTunnelCreationFailed
  • Codice di stato HTTP:
 503 Service Unavailable
  • Messaggio di errore:
 Proxy refused to create tunnel with response status {status code}
  • Possibile causa:

Questo errore si verifica durante la creazione del tunnel tra Apigee Edge e il server di backend da parte del server proxy a causa di problemi di firewall, ACL (elenco di controllo dell'accesso), DNS, disponibilità del server di backend e così via.

Nota: il codice di stato nel messaggio di errore (faultstring) fornisce la causa generale del problema.
PLAYBOOK

protocol.http.Response306Reserved
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Response Status code 306 is reserved, so can't be used.
  • Possibile causa:

Questo errore si verifica se il server di backend risponde con il codice di stato 306 ad Apigee Edge.

Il codice di stato 306 è stato definito in una versione precedente della specifica HTTP. In base alla specifica HTTP corrente, questo codice è riservato e non deve essere utilizzato.
  • Specifica HTTP:
 RFC 7231, sezione 6.3.5: 306 riservato

Correggi

Poiché il codice di stato 306 è riservato, assicurati che il tuo server di backend non utilizzi questo codice di stato durante l'invio di una risposta ad Apigee Edge.

protocol.http.Response405WithoutAllowHeader
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Received 405 Response without Allow Header
  • Possibile causa:
 Il server di backend risponde con un codice di stato 405 Method Not Allowed senza l'intestazione "Allow".
  • Specifica HTTP:

RFC 7231, sezione 6.5.5: 405 Method Not Allowed e RFC 7231, sezione 7.4.1: Allow
PLAYBOOK

protocol.http.ResponseWithBody
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Received {status_code} Response with message body
  • Possibile causa:

Questo errore si verifica se la risposta HTTP dal server di backend ad Apigee Edge è 204 No Content o 205 Reset Content, ma contiene il corpo della risposta e/o una o più delle seguenti intestazioni:

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • Specifica HTTP:

RFC 7231, sezione 6.3.5: 204 Nessun contenuto e RFC 7231, sezione 6.3.6: 205 Reimposta contenuto
PLAYBOOK

protocol.http.TooBigBody
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Body buffer overflow
  • Possibile causa:
 Questo errore si verifica se la dimensione del payload inviata dall'applicazione client come parte della richiesta HTTP ad Apigee Edge è superiore al limite consentito in Apigee Edge.
  • Limiti:
 Limiti di Apigee Edge
PLAYBOOK

protocol.http.TooBigHeaders
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 response headers size exceeding {limit}
  • Possibile causa:
 Questo errore si verifica se le dimensioni totali di tutte le intestazioni di risposta inviate dal server di backend nell'ambito della risposta HTTP ad Apigee Edge sono superiori al limite consentito in Apigee Edge.
  • Limiti:
 Limiti di Apigee Edge
GUIDA PRATICA

protocol.http.TooBigLine
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 response line size exceeding {limit}
  • Possibile causa:
 Questo errore si verifica se la dimensione della riga di risposta inviata dal server di backend come parte della risposta HTTP ad Apigee Edge è superiore al limite consentito in Apigee Edge.
  • Limiti:
 Limiti di Apigee Edge
GUIDA PRATICA

protocol.http.UnsupportedEncoding
  • Codice di stato HTTP:
 415 Unsupported Media
  • Messaggio di errore:
 Unsupported Encoding "{encoding}"
  • Possibile causa:
 Questo errore si verifica se l'intestazione Content-Encoding inviata dal server di backend nell'ambito della risposta HTTP contiene il formato di codifica/payload non supportato da Apigee Edge.
  • Specifica HTTP:
 RFC 7231, sezione 6.5.13: 415 Unsupported Media Type
GUIDA PRATICA

security.util.*

security.util.KeyAliasNotFound
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • Possibile causa:

Questo errore si verifica se il KeyAlias specifico a cui viene fatto riferimento in TargetEndpoint o TargetServer non viene trovato nel Keystore specifico.

Correggi

Assicurati che la chiave KeyAlias specificata in TargetEndpoint o TargetServer esista e che sia parte dell'archivio chiavi specifico.

security.util.TrustStoreWithNoCertificates
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 TrustStore {truststore_name} has no certificates
  • Possibile causa:

Questo errore si verifica se l'archivio di attendibilità specifico a cui viene fatto riferimento nel TargetEndpoint o nel TargetServer non contiene certificati.

Correggi

Se vuoi convalidare il certificato del server di backend e vuoi utilizzare il Truststore in un TargetEndpoint o TargetServer, assicurati che il Truststore contenga i certificati validi del server di backend.