16.08.17 – informacje o wersji Apigee Edge dla Public Cloud

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

We wtorek 30 sierpnia 2016 r. udostępniliśmy nową wersję Apigee Edge dla chmury publicznej.

Nowe funkcje i aktualizacje

Poniżej znajdziesz nowe funkcje i aktualizacje w tej wersji.

Ładunki JSON w zasadach Assign Message i Raise Fault

Dzięki temu ulepszeniu nie trzeba stosować żadnych obejść, aby zapewnić prawidłowe formatowanie wiadomości JSON, a zmienne można określać za pomocą nawiasów klamrowych bez tworzenia nieprawidłowego kodu JSON. Na przykład poniższy kod wstawia wartość message.content do wiadomości JSON:

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

Jeśli używasz obejścia, Twój kod będzie nadal działać bez zmian. Zamiast nawiasów klamrowych możesz też używać wartości variablePrefix i variableSuffix, aby wskazywać zmienne.

Więcej informacji znajdziesz w dokumentacji referencyjnej dotyczącej elementu <Set><Payload> w zasadzie Assign Message i Raise Fault. (APIRT-1160)

Ulepszenia zasady XML to JSON

Zasada XML to JSON została ulepszona o te funkcje: Możesz skonfigurować zasadę tak, aby:

• traktować niektóre elementy XML jako tablice podczas konwersji, co powoduje umieszczenie wartości w nawiasach kwadratowych „[ ]” w dokumencie JSON;
• usuwać poziomy hierarchii dokumentu XML w końcowym dokumencie JSON.

Więcej informacji znajdziesz w artykule XML to JSON policy. (APIRT-1144)

Wiele symboli wieloznacznych w ścieżkach zasobów produktu API

Podczas definiowania ścieżek zasobów w produkcie API możesz umieszczać symbole wieloznaczne w wielu miejscach a ścieżki zasobu. Na przykład /team/*/invoices/** umożliwia wywoływanie interfejsu API z dowolną wartością po /team i dowolnymi ścieżkami zasobów po invoices/. Dozwolony URI w wywołaniu interfejsu API byłby proxyBasePath/team/finance/invoices/company/a.

Jeśli po tej wersji ścieżki zasobów istniejącego produktu API przestaną działać zgodnie z oczekiwaniami, ustaw w organizacji tę właściwość, aby przywrócić poprzednie działanie: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Funkcje kryptograficzne w JavaScript

Dostępny jest nowy zestaw wydajnych funkcji JavaScriptu crypto do tworzenia, pobierania i aktualizowania tych obiektów skrótu: MD5, SHA-1, SHA256, SHA512. Obiekt crypto umożliwia też pobieranie daty w różnych formatach. Więcej informacji znajdziesz w artykule Model obiektów JavaScript. (APIRT-2886)

Sprawdzanie wersji pliku JAR wywołania Java

Jeśli wersja zasobu Java jest niezgodna z obsługiwaną przez Edge wersją Javy, która jest wymieniona w artykule Obsługiwane oprogramowanie i obsługiwane wersje, podczas przesyłania zasobu JAR Java do proxy interfejsu API zwracany jest kod stanu HTTP 400 (zamiast 500). (MGMT-3420)

Weryfikacja zasobów proxy interfejsu API

Jeśli masz pliki zasobów proxy interfejsu API (np. pliki JAR JavaScriptu lub Javy) przechowywane w zakresie środowiska lub organizacji, framework weryfikacji nie wymaga już, aby te zasoby były też uwzględniane na poziomie proxy interfejsu API w pakiecie proxy, aby import przeszedł weryfikację. Weryfikacja zasobów odbywa się teraz w czasie wdrażania, a nie importu. (MGMT-1430)

Konfigurowanie limitu czasu dla poszczególnych proxy interfejsu API

Możesz skonfigurować proxy interfejsu API tak, aby po określonym czasie przekraczały limit czasu (ze stanem 504 Gateway Timeout ). Głównym przypadkiem użycia jest sytuacja, gdy klienci Private Cloud mają proxy interfejsu API, których wykonanie trwa dłużej. Załóżmy na przykład, że chcesz, aby określone proxy przekraczały limit czasu po 3 minutach. W konfiguracji proxy interfejsu API możesz użyć nowej właściwości api.timeout. Oto jak to zrobić w przypadku 3-minutowego limitu czasu:

1. Najpierw skonfiguruj moduł równoważenia obciążenia, router i procesor wiadomości tak, aby przekraczały limit czasu po 3 minutach.
2. Następnie skonfiguruj odpowiednie proxy tak, aby przekraczały limit czasu po 3 minutach. Określ wartość w milisekundach. Na przykład:

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

3. Pamiętaj jednak, że zwiększenie limitów czasu systemu może spowodować problemy z wydajnością, ponieważ wszystkie proxy bez ustawienia api.timeout będą używać nowych, dłuższych limitów czasu modułu równoważenia obciążenia, routera i procesora wiadomości. Skonfiguruj więc inne proxy interfejsu API, które nie wymagają dłuższych limitów czasu tak aby używały krótszych limitów czasu. Na przykład ten kod ustawia limit czasu proxy interfejsu API na 1 minutę:
   <Property name="api.timeout">60000</Property>

Klienci korzystający z chmury, którzy nie mogą modyfikować limitów czasu Edge, mogą też skonfigurować limit czasu proxy interfejsu API, o ile jest on krótszy niż standardowy limit czasu procesora wiadomości Edge wynoszący 57 sekund.

Nie możesz wypełnić wartości zmienną. Ta właściwość jest opisana w dokumentacji referencyjnej właściwości punktu końcowego. (APIRT-1778)

TLS/SSL w zasadzie Message Logging

<KeyStore> i <TrustStore> można ustawić w konfiguracji SSLInfo w zasadzie Message Logging policy, co umożliwia jednokierunkowe i dwukierunkowe połączenie TLS/SSL z usługą logowania. SSLInfo w zasadzie Message Logging konfiguruje się tak samo jak w przypadku TargetEndpoint proxy. Jednak TLS/SSL w zasadzie Message Logging obsługuje tylko protokół TCP. (APIRT-1858)

Naprawione błędy

W tej wersji naprawiono te błędy. Ta lista jest przeznaczona głównie dla użytkowników, którzy chcą sprawdzić, czy ich zgłoszenia zostały rozwiązane. Nie zawiera ona szczegółowych informacji dla wszystkich użytkowników.