Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
Als aktueller Apigee Edge-Kunde können Sie Ihre Installation zu Apigee X migrieren, um neue Funktionen oder eine andere regionale Verfügbarkeit zu nutzen.
Auf dieser Seite werden Anti-Patterns in Ihrer Konfiguration beschrieben, die Sie vor der Migration zu Apigee X berücksichtigen müssen. Außerdem werden andere Verhaltensänderungen beschrieben, die Sie vor der Migration kennen sollten.
In der umfassenderen Liste der Apigee Edge-Anti-Patterns werden Anwendungspraktiken beschrieben, die in jedem Fall vermieden werden sollten. Auf dieser Seite werden die spezifischen, nicht empfohlenen Nutzungsverfahren beschrieben, die eine Migration blockieren. Beheben Sie diese jetzt, um Probleme bei der Migration zu Apigee X zu vermeiden.
Apps ohne API-Produkte | ||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Es gibt Apps ohne API-Produkt(e). Unterschied zwischen Apigee Edge und Apigee X:
|
Nein. |
Lösung: Apps ohne API-ProdukteWeisen Sie jede App-Anmeldedaten mindestens einem API-Produkt zu. Weitere Informationen dazu finden Sie unter Apps registrieren und API-Schlüssel verwalten. Am einfachsten ist es, jeder App Zugriff auf alle API-Produkte zuzuweisen. Das entspricht dem, was in Apigee Edge möglich ist. Die Herausforderung besteht darin, wenn Sie nach dem Prinzip der geringsten Berechtigung vorgehen möchten. Anschließend müssen Sie die Mindestliste der API-Produkte bestimmen, auf die die einzelnen App-Anmeldedaten Zugriff haben müssen. Sie können dies mit Apigee Edge Analytics-Berichten basierend auf der Client-ID analysieren. |
||||||||||||
Cache ohne Ablaufzeit | ||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Cache(s) haben keine Ablaufzeit. Unterschied zwischen Apigee Edge und Apigee X:
|
Nein |
Lösung: Cache ohne AblaufzeitLegen Sie eine Ablaufzeit für alle Caches fest. |
||||||||||||
JSONPath-Filterausdrücke für unbestimmte Pfade | ||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Bei nicht definierten Pfaden ist die Abfrage des Ergebnisses von Filterausdrücken nicht Teil der JSONPath-Spezifikation. Weitere Informationen finden Sie unter https://goessner.net/articles/JsonPath/. Unterschied zwischen Apigee Edge und Apigee X: Wenn Sie sich diese Beispielstruktur ansehen, { "books": [ { "name": "A", }, { "name": "B", } ] } Mit dem Ausdruck
Mit dem Ausdruck
|
Ja |
Lösung: JSONPath-Filterausdrücke für unbestimmte PfadeSuchen und ersetzen Sie betroffene Abfragen. |
||||||||||||
JSONPath-Ausdrücke für nicht vorhandene Indexe | ||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
JSONPath-Ausdrücke mit einem nicht vorhandenen Index verhalten sich in Apigee X anders als in Apigee Edge. Apigee X gibt den Fehler Unterschied zwischen Apigee Edge und Apigee X: Wenn Sie sich diese Beispielstruktur ansehen, { "books": [ { "name": "A", }, { "name": "B", } ] } Mit dem Ausdruck
|
Ja |
Lösung: JSONPath-Ausdrücke für nicht vorhandene IndexeSuchen und ersetzen Sie betroffene Abfragen. |
||||||||||||
JSONPath-Ausdrücke mit einem Arrayindex, der kein Arrayobjekt zurückgibt | ||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
JSONPath-Ausdrücke mit einem Arrayindex oder mit Segmenten geben ein Arrayobjekt in Apigee X zurück. Unterschied zwischen Apigee Edge und Apigee X: Wenn Sie sich diese Beispielstruktur ansehen, { "books": [ { "name": "A", }, { "name": "B", } ] } Mit dem Ausdruck
Mit dem Ausdruck
Mit dem Ausdruck
|
Ja |
Lösung: JSONPath-Ausdrücke mit einem Array-Index geben kein Array-Objekt zurückSuchen und ersetzen Sie Ausdrücke, die nach dem Upgrade möglicherweise andere Ergebnisse zurückgeben. |
||||||||||||
Einschränkungen für Schlüsselspeichernamen |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Apigee X-Schlüsselspeichernamen dürfen nur Buchstaben, Ziffern und Bindestriche enthalten. Für Edge-Schlüsselspeichernamen gelten diese Einschränkungen nicht. |
Nein |
Lösung: Namensbeschränkungen für den SchlüsselspeicherPrüfen Sie die Schlüsselspeichernamen und aktualisieren Sie die Namen bei Bedarf, um nicht unterstützte Zeichen zu entfernen. |
||||||||||||
Mehrere Basispfade für einen API-Proxy bereitgestellt |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
In einer Umgebung werden mehrere Versionen eines API-Proxys bereitgestellt und jede Überarbeitung hat einen anderen Basispfad. Unterschied zwischen Apigee Edge und Apigee X:
|
Nein |
Lösung: Mehrere Basispfade für einen API-Proxy bereitgestelltAktualisieren Sie alle Bundles, sodass unabhängig vom Basispfad nur eine Version eines Bundles in einer Umgebung bereitgestellt wird. |
||||||||||||
Nicht konforme HTTP-Nachrichten |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Clients oder der API-Proxy senden Nachrichten (Anfragen oder Antworten), die nicht dem HTTP-Standard entsprechen. Dazu gehören beispielsweise ungültige Header-Namen oder Duplikate in einigen eingeschränkten Headern. Eine Migration zu Apigee X ist nicht möglich, wenn Ihre API-Ausführung einen oder mehrere der folgenden Fehler aufweist:
|
Ja, möglicherweise. |
Lösung: Nicht konforme HTTP-MeldungenSie müssen alle Fehler in HTTP-Protokollen beheben, bevor Sie zu Apigee X migrieren. Wenn ein Fehler von einer Clientanwendung verursacht wird, müssen Sie den Entwickler der Clientanwendung bitten, das Problem zu beheben. |
||||||||||||
Ablaufzeit des OAuth 2.0-Tokens ungültig |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Die Ablauflimits für OAuth 2.0-Tokens liegen außerhalb des vorgeschriebenen Bereichs. Unterschied zwischen Apigee Edge und Apigee X:
|
Nein |
Lösung: Ablaufzeit des OAuth 2.0-Tokens ungültig
Verwende die OAuthV2-Richtlinie und gib die Ablaufzeit in |
||||||||||||
Produktlimits überschritten |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Die Konfiguration von Apigee Edge ist nicht mit den definierten Produktlimits konform. Einige Produkteinschränkungen, die in Apigee Edge dokumentiert, aber nicht erzwungen werden, werden bei Apigee X erzwungen. |
Nein |
Lösung: Produktlimits überschrittenKorrigieren Sie vor der Migration zu Apigee X jede Nutzung, die die Produktlimits überschreitet. |
||||||||||||
ServiceCallout-Richtlinien mit Spezifizierern für Endpunkt- und Pfadzielverbindungen |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
In der ServiceCallout-Richtlinie sollte das Element
Apigee Edge dokumentiert diese Anforderung, erzwingt sie aber nicht. Apigee X beendet die Verarbeitung, wenn ein |
Nein |
Lösung: ServiceCallout-Richtlinien mit Spezifizierern für Endpunkt- und Pfadzielverbindungen
Prüfen Sie die ServiceCallout-Richtlinienkonfigurationen und entfernen Sie alle |
||||||||||||
Einschränkungen für Zielservernamen |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Namen von Apigee X-Zielservern dürfen nur Buchstaben, Ziffern, Bindestriche und Punkte enthalten. Für Namen von Edge-Zielservern gelten diese Einschränkungen nicht. |
Nein |
Lösung: Einschränkungen für ZielservernamenPrüfen Sie die Namen der Zielserver und aktualisieren Sie gegebenenfalls die Namen, um nicht unterstützte Zeichen zu entfernen. |
||||||||||||
Testzertifikat in einem virtuellen Host |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Ein oder mehrere virtuelle Hosts verwenden das von Apigee bereitgestellte Zertifikat für die kostenlose Testversion. Dadurch antwortet der virtuelle Host auf Anfragen in Domains wie Unterschied zwischen Apigee Edge und Apigee X:
|
Ja |
Lösung: Testzertifikat in einem virtuellen HostSie müssen Ihre eigene Domain konfigurieren und Zertifikate entsprechend bereitstellen.
Jede Clientanwendung, die vom alten Domainnamen im Format |
||||||||||||
Nicht aufgelöstes DNS |
||||||||||||||
Zusammenfassung | Erfordert clientseitige Änderungen? | Lösung | ||||||||||||
Die Zielendpunkte haben nicht aufgelöste Domainnamen. Unterschied zwischen Apigee Edge und Apigee X:
|
Nein |
Lösung: DNS nicht aufgelöstAktualisieren Sie den Zielendpunkt mit einem gültigen Domainnamen. |