16.08.17 – Versionshinweise zu Apigee Edge for Public Cloud

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen. info

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

Neue Features und Updates

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

JSON-Nutzlasten in „Assign Message“ und „Raise Fault“

Durch diese Verbesserung sind keine Workarounds mehr erforderlich, um eine korrekte Formatierung von JSON-Nachrichten zu gewährleisten. Variablen können mit geschweiften Klammern angegeben werden, ohne dass ungültiges JSON entsteht. 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 einen Workaround 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 in der Assign Message-Richtlinie und der Raise Fault-Richtlinie. (APIRT-1160)

Verbesserungen bei der „XML-to-JSON“-Richtlinie

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

• Einige XML-Elemente werden bei der Konvertierung als Arrays behandelt, wodurch die Werte im JSON-Dokument in eckige Klammern „[ ]“ gesetzt werden.
• Entfernen Sie Ebenen der XML-Dokumenthierarchie im endgültigen JSON-Dokument.

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

Mehrere Platzhalter in API-Produkt-Ressourcenpfaden

Wenn Sie Ressourcenpfade in einem API-Produkt definieren, 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/ möglich. Ein zulässiger URI für einen API-Aufruf wäre proxyBasePath/team/finance/invoices/company/a.

Wenn Ihre vorhandenen API-Produktressourcenpfade nach dieser Version nicht mehr wie erwartet funktionieren, legen Sie die folgende Eigenschaft 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 die folgenden Hash-Objekte erstellt, abgerufen und aktualisiert werden können: MD5, SHA-1, SHA256, SHA512. Mit dem crypto-Objekt können Sie das Datum auch in verschiedenen Formaten abrufen. Weitere Informationen finden Sie unter JavaScript-Objektmodell. (APIRT-2886)

Java-Callout-JAR-Version prüfen

Wenn Sie eine Java-JAR-Ressource in einen API-Proxy hochladen, wird der HTTP-Statuscode 400 (anstatt 500) zurückgegeben, 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)

Überprüfung von API-Proxy-Ressourcen

Wenn Sie API-Proxy-Ressourcendateien (z. B. JavaScript- oder Java-JARs) auf Umgebungsebene oder Organisationsebene gespeichert haben, müssen Sie diese Ressourcen nicht mehr auch auf API-Proxy-Ebene in ein Proxy-Bundle einfügen, damit der Import die Validierung besteht. Die Ressourcenvalidierung erfolgt jetzt bei der Bereitstellung und nicht beim Import. (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 ist für Private Cloud-Kunden, deren API-Proxys länger für die Ausführung benötigen. Angenommen, Sie benötigen bestimmte Proxy-Zeitüberschreitungen nach 3 Minuten. Sie können eine neue api.timeout-Property in der Konfiguration für einen API-Proxy verwenden. So gehts:

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“ den neuen, höheren Load-Balancer, Router und Nachrichtenprozessorzeitüberschreitungen verwenden. Konfigurieren Sie daher andere API-Proxys, die keine längeren Zeitüberschreitungen erfordern, um niedrigere Zeitüberschreitungen zu verwenden. Im folgenden Beispiel wird festgelegt, dass ein API-Proxy nach einer 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-Nachrichtenprozessor-Zeitlimit von 57 Sekunden ist.

Sie können den Wert nicht mit einer Variable festlegen. Dieses Attribut wird in der Referenz für Endpunktattribute beschrieben. (APIRT-1778)

TLS/SSL für die MessageLogging-Richtlinie

<KeyStore> und <TrustStore> können in der SSLInfo-Konfiguration der Richtlinie zum Nachrichtenlogging festgelegt werden, sodass unidirektionales und bidirektionales TLS/SSL mit einem Logging-Dienst möglich ist. Sie konfigurieren SSLInfo in der Message Logging-Richtlinie auf dieselbe Weise wie in einem TargetEndpoint des Proxys. Das TCP-Protokoll wird jedoch nur für TLS/SSL für das Nachrichten-Logging unterstützt. (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.