16.08.17 – Versionshinweise zu Apigee Edge for Public Cloud

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zuApigee X wechseln. info

Am Dienstag, 30. August 2016, haben wir eine neue Version von Apigee Edge für die Public Cloud veröffentlicht.

Neue Features und Updates

Im Folgenden sind die neuen Features und Aktualisierungen in diesem Release aufgeführt:

JSON-Nutzlasten in „Nachricht zuweisen“ und „Fehler auslösen“

Mit dieser Verbesserung sind keine Problemumgehungen mehr erforderlich, um eine ordnungsgemäße JSON-Nachrichtenformatierung zu gewährleisten. Variablen können mit geschweiften Klammern angegeben werden, ohne ungültiges JSON zu erstellen. Im folgenden Beispiel wird der Wert von „message.content“ in die JSON-Nachricht eingefügt:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

Wenn Sie eine Problemumgehung verwendet haben, funktioniert Ihr Code weiterhin wie bisher. Sie können auch „variablePrefix“ und „variableSuffix“ anstelle von geschweiften Klammern verwenden, um Variablen anzugeben.

Weitere Informationen finden Sie im Element <Set><Payload> in den Referenzdokumenten zur Richtlinie „Nachricht zuweisen“ und zur Richtlinie „Fehler auslösen“. (APIRT-1160)

Verbesserungen der Richtlinie „XML-zu-JSON“

Die Richtlinie „XML-zu-JSON“ wurde um die folgenden Funktionen erweitert. Sie können die Richtlinie so konfigurieren, dass:

• einige XML-Elemente während der Konvertierung als Arrays behandelt werden, wodurch die Werte im JSON-Dokument in eckige Klammern „[ ]“ gesetzt werden.
• Ebenen der XML-Dokumenthierarchie im endgültigen JSON-Dokument entfernt oder gelöscht werden.

Weitere Informationen finden Sie unter XML zu JSON-Richtlinie. (APIRT-1144)

Mehrere Platzhalter in Ressourcenpfaden von API-Produkten

Beim Definieren von Ressourcenpfaden in API-Produkten können Sie Platzhalter an mehreren Stellen in einem Ressourcenpfad einfügen. Mit /team/*/invoices/** sind beispielsweise API-Aufrufe mit einem beliebigen Wert nach /team und beliebigen Ressourcenpfaden nach invoices/ zulässig. Ein zulässiger URI für einen API-Aufruf wäre proxyBasePath/team/finance/invoices/company/a.

Wenn Ihre vorhandenen Ressourcenpfade für API-Produkte nach diesem Release nicht mehr wie erwartet funktionieren, legen Sie die folgende Property für Ihre Organisation fest, um zum vorherigen Verhalten zurückzukehren: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Kryptofunktionen in JavaScript

Es ist eine neue Reihe von leistungsstarken JavaScript-crypto-Funktionen verfügbar, mit denen Sie die folgenden Hash-Objekte erstellen, abrufen und aktualisieren können: MD5, SHA-1, SHA256, SHA512. Mit dem Krypto-Objekt können Sie auch das Datum in verschiedenen Formaten abrufen. Weitere Informationen finden Sie unter JavaScript-Objektmodell. (APIRT-2886)

Überprüfung der JAR-Version für Java-Callouts

Wenn Sie eine Java-JAR-Ressource in einen API-Proxy hochladen, wird der HTTP-Statuscode 400 zurückgegeben (anstelle von 500), wenn die Version der Java-Ressource nicht mit der von Edge unterstützten Java-Version kompatibel ist, die unter Unterstützte Software und unterstützte Versionen aufgeführt ist. (MGMT-3420)

Validierung von API-Proxy-Ressourcen

Wenn Sie API-Proxy-Ressourcendateien (z. B. JavaScript- oder Java-JARs) auf der Umgebungsebene oder Organisationsebene gespeichert haben, müssen Sie diese Ressourcen nicht mehr auf API-Proxy-Ebene in ein Proxy-Bundle aufnehmen, damit die Validierung beim Import erfolgreich ist. Die Ressourcenvalidierung erfolgt jetzt zur Bereitstellungszeit und nicht zur Importzeit. (MGMT-1430)

Zeitlimit für einzelne API-Proxys konfigurieren

Sie können API-Proxys so konfigurieren, dass nach einer bestimmten Zeit eine Zeitüberschreitung auftritt (mit dem Status „504 Gateway Timeout“ ). Der primäre Anwendungsfall sind Private Cloud-Kunden, deren API-Proxys länger ausgeführt werden. Angenommen, Sie benötigen bestimmte Proxy-Zeitüberschreitungen nach 3 Minuten. Sie können in der Konfiguration für einen API-Proxy die neue api.timeout Property verwenden. So geht das mit dem 3-Minuten-Beispiel:

1. Konfigurieren Sie zuerst den Load-Balancer, den Router und den Nachrichtenprozessor so, dass nach 3 Minuten eine Zeitüberschreitung auftritt.
2. Konfigurieren Sie anschließend die relevanten Proxy-Zeitüberschreitungen nach 3 Minuten. Geben Sie den Wert in Millisekunden an. Beispiel:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. Beachten Sie jedoch, dass das Erhöhen der Systemzeitüberschreitungen zu Leistungsproblemen führen kann, da alle Proxys ohne die Einstellung „api.timeout“ die neuen, höheren Zeitüberschreitungen für Load-Balancer, Router und Nachrichtenprozessoren verwenden. Konfigurieren Sie daher andere API-Proxys, für die keine längeren Zeitüberschreitungen erforderlich sind, so, dass sie niedrigere Zeitüberschreitungen verwenden. Im folgenden Beispiel wird festgelegt, dass ein API-Proxy nach 1 Minute mit einer Zeitüberschreitung abläuft:
   <Property name="api.timeout">60000</Property>

Cloud-Kunden, die die Edge-Zeitüberschreitungen nicht ändern können, können auch ein API-Proxy-Zeitlimit konfigurieren, solange das Zeitlimit kürzer als das standardmäßige Edge-Zeitlimit für Nachrichtenprozessoren von 57 Sekunden ist.

Sie können den Wert nicht mit einer Variablen festlegen. Diese Property wird in der Referenz für Endpunktattribute behandelt. (APIRT-1778)

TLS/SSL für die Richtlinie „Nachrichtenprotokollierung“

<KeyStore> und <TrustStore> können in der SSLInfo-Konfiguration für die Richtlinie „Nachrichtenprotokollierung“ festgelegt werden, wodurch unidirektionales und bidirektionales TLS/SSL mit einem Protokollierungsdienst möglich ist. Sie konfigurieren SSLInfo für die Richtlinie „Nachrichtenprotokollierung“ genauso wie für einen TargetEndpoint eines Proxys TargetEndpoint. TLS/SSL für die Nachrichtenprotokollierung unterstützt jedoch nur das TCP-Protokoll. (APIRT-1858)

Fehlerkorrekturen

Folgende Fehler wurden in diesem Release behoben. Diese Liste ist hauptsächlich für Nutzer gedacht, die prüfen möchten, ob ihre Support-Tickets erfolgreich bearbeitet wurden. Sie enthält keine detaillierten Informationen für allgemeine Nutzer.