Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
In qualità di attuale cliente di Apigee Edge, potresti scegliere di eseguire la migrazione della tua installazione ad Apigee X per sfruttare nuove funzionalità o diverse disponibilità a livello regionale.
Questa pagina descrive gli anti-pattern della configurazione che dovrai risolvere prima di eseguire la migrazione ad Apigee X, nonché altre modifiche di comportamento di cui dovresti essere a conoscenza prima della migrazione.
L'elenco più ampio di antipattern Apigee Edge descrive le pratiche di utilizzo che dovrebbero essere evitate in ogni caso. Questa pagina descrive le pratiche di utilizzo specifiche non consigliate che bloccheranno una migrazione. Risolvi ora questi problemi per evitare problemi durante la migrazione ad Apigee X.
App senza prodotti API | ||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Sono presenti app senza prodotto o prodotti API. Differenza tra Apigee Edge e Apigee X:
|
N. |
Risoluzione: app senza prodotti APIAssocia ogni credenziale dell'app ad almeno un prodotto API. Per maggiori informazioni su come eseguire questa operazione, consulta Registrare app e gestire le chiavi API. Un percorso semplice è assegnare a ogni app l'accesso a tutti i prodotti API. Sarà l'equivalente di quanto possibile in Apigee Edge. La sfida consiste nell'adottare un approccio basato sul "privilegio minimo", quindi determinare l'elenco minimo di prodotti API a cui ogni credenziale dell'app deve avere accesso. Puoi analizzare questi dati con i report di analisi di Apigee Edge, basati sull'ID client. |
||||||||||||
Cache senza scadenza | ||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Le cache non hanno una scadenza. Differenza tra Apigee Edge e Apigee X:
|
No |
Soluzione: cache senza scadenzaImposta una scadenza per tutte le cache. |
||||||||||||
JSONPath filtra le espressioni su percorsi non definiti | ||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Per i percorsi non definitivi, eseguire query sul risultato di un'espressione di filtro non fa parte delle specifiche JSONPath. Vedi https://goessner.net/articles/JsonPath/. Differenza tra Apigee Edge e Apigee X: Quando esplori questa struttura di esempio, { "books": [ { "name": "A", }, { "name": "B", } ] } Con l'espressione
Con l'espressione
|
Sì |
Soluzione: JSONPath filtra le espressioni su percorsi non definitiTrova e sostituisci le query interessate. |
||||||||||||
Espressioni JSONPath per indici non presenti | ||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Le espressioni JSONPath con un indice non presente hanno comportamenti diversi in Apigee X
rispetto ad Apigee Edge. Apigee X restituisce un errore Differenza tra Apigee Edge e Apigee X: Quando esplori questa struttura di esempio, { "books": [ { "name": "A", }, { "name": "B", } ] } Con l'espressione
|
Sì |
Soluzione: espressioni JSONPath per indici non presentiTrova e sostituisci le query interessate. |
||||||||||||
Espressioni JSONPath con un indice array che non restituiscono un oggetto array | ||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Le espressioni JSONPath con sezioni o indice array restituiscono un oggetto array in Apigee X. Differenza tra Apigee Edge e Apigee X: Quando esplori questa struttura di esempio, { "books": [ { "name": "A", }, { "name": "B", } ] } Con l'espressione
Con l'espressione
Con l'espressione
|
Sì |
Soluzione: le espressioni JSONPath con un indice array non restituiscono un oggetto arrayTrova e sostituisci espressioni che potrebbero restituire risultati diversi dopo l'upgrade. |
||||||||||||
Limitazioni per i nomi dell'archivio chiavi |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
I nomi degli archivi chiavi Apigee X possono contenere solo lettere, numeri e trattini. I nomi degli archivi chiavi perimetrali non imponeno queste limitazioni. |
No |
Risoluzione: limitazioni relative ai nomi dell'archivio chiaviControlla i nomi degli archivi chiavi e aggiornali per rimuovere i caratteri non supportati, se necessario. |
||||||||||||
Più percorsi di base di cui è stato eseguito il deployment per un proxy API |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Il deployment di più revisioni di un proxy API viene eseguito in un ambiente e ogni revisione ha un percorso di base diverso. Differenza tra Apigee Edge e Apigee X:
|
No |
Soluzione: più percorsi di base di cui è stato eseguito il deployment per un proxy APIAggiorna tutti i bundle in modo che in un ambiente venga eseguito il deployment di una sola revisione di un bundle, indipendentemente dal percorso base. |
||||||||||||
Messaggi HTTP non conformi |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
I client o il proxy API inviano messaggi (richieste o risposte) non conformi allo standard HTTP. Ad esempio, nomi di intestazioni non validi, duplicati in alcune intestazioni limitate e così via. Non puoi eseguire la migrazione ad Apigee X se l'esecuzione dell'API presenta uno o più dei seguenti errori:
|
Sì, probabilmente. |
Soluzione: messaggi HTTP non conformiDevi correggere eventuali errori nei protocolli HTTP prima di eseguire la migrazione ad Apigee X. Se un errore ha origine da un'applicazione client, devi chiedere allo sviluppatore dell'app client di correggere il problema. |
||||||||||||
Ora di scadenza del token OAuth 2.0 non valida |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
I limiti di scadenza del token OAuth 2.0 non rientrano nell'intervallo prescritto. Differenza tra Apigee Edge e Apigee X:
|
No |
Soluzione: data di scadenza del token OAuth 2.0 non valida
Utilizza il criterio OAuthV2 e specifica la data di scadenza in
|
||||||||||||
Limiti prodotti superati |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
La configurazione di Apigee Edge non è conforme ai limiti di prodotto definiti. Alcuni limiti di prodotto documentati ma non applicati su Apigee Edge vengono applicati su Apigee X. |
No |
Soluzione: limiti di prodotti superatiCorreggi l'utilizzo che supera i limiti del prodotto prima di eseguire la migrazione ad Apigee X. |
||||||||||||
Criteri ServiceCallout con identificatori di connessione sia dell'endpoint che della destinazione del percorso |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Nelle norme di ServiceCallout, l'elemento
Apigee Edge documenta questo requisito ma non lo applica. Apigee X interrompe
l'elaborazione se rileva un |
No |
Soluzione: i criteri ServiceCallout con identificatori di connessione sia dell'endpoint che della destinazione del percorso
Controlla le configurazioni dei criteri di ServiceCallout ed elimina tutte le configurazioni |
||||||||||||
Limitazioni relative ai nomi dei server di destinazione |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
I nomi dei server di destinazione Apigee X possono contenere solo lettere, numeri, trattini e punti. I nomi dei server di destinazione perimetrale non imporranno queste limitazioni. |
No |
Risoluzione: limitazioni relative ai nomi dei server di destinazioneControlla i nomi dei server di destinazione e, se necessario, aggiornali per rimuovere i caratteri non supportati. |
||||||||||||
Certificato di prova in un host virtuale |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Uno o più host virtuali utilizzano il certificato di "prova senza costi" fornito da Apigee. In questo modo
l'host virtuale risponde alle richieste sui domini come Differenza tra Apigee Edge e Apigee X:
|
Sì |
Soluzione: certificato di prova in un host virtualeDevi configurare il tuo dominio ed eseguire il provisioning dei certificati in modo appropriato.
Qualsiasi applicazione client che dipende dal nome di dominio legacy nel modulo |
||||||||||||
DNS non risolto |
||||||||||||||
Riepilogo | Sono necessarie modifiche lato client? | Risoluzione | ||||||||||||
Gli endpoint di destinazione hanno nomi di dominio non risolti. Differenza tra Apigee Edge e Apigee X:
|
No |
Soluzione: DNS non risoltoAggiorna l'endpoint di destinazione con un nome di dominio valido. |