16.08.17 – informacje o wersji Apigee Edge dla Public Cloud

Wyświetlasz dokumentację Apigee Edge.
Zapoznaj się z dokumentacją Apigee X. info

We wtorek 30 sierpnia 2016 r. udostępniliśmy nową wersję Apigee Edge na chmurę publiczną.

Nowe funkcje i aktualizacje

Oto nowe funkcje i aktualizacje wprowadzone w tej wersji.

Ładunki JSON w komunikatach przypisywania i zgłaszania błędu

Dzięki temu ulepszeniu nie są potrzebne żadne obejścia, 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ć zmiennych variablePrefix i variableSuffix, aby wskazywać zmienne.

Zobacz element <Set><Payload> w dokumentacji referencyjnej zasad przypisywania wiadomości i zasad zgłaszania błędu. (APIRT-1160)

Ulepszenia zasad XML do JSON

Zasady XML do JSON zostały rozszerzone o te funkcje: Możesz skonfigurować zasady w ten sposób:

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

Więcej informacji znajdziesz w artykule Zasady dotyczące konwersji XML na JSON. (APIRT-1144)

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

Podczas definiowania ścieżek zasobów w produkcie API możesz uwzględnić symbole wieloznaczne w wielu miejscach ścieżki zasobu. Na przykład /team/*/invoices/** zezwala na wywołania interfejsu API z dowolną wartością po /team i dowolnymi ścieżkami zasobów po invoices/. Dozwolony identyfikator URI w wywołaniu interfejsu API to 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 funkcji JavaScriptu o wysokiej wydajności crypto do tworzenia, pobierania i aktualizowania tych obiektów skrótu: MD5, SHA-1, SHA256, SHA512. Obiekt crypto umożliwia też uzyskanie daty w różnych formatach. Więcej informacji znajdziesz w modelu obiektu JavaScript. (APIRT-2886)

Sprawdzanie wersji pliku JAR wywołania Javy

Podczas przesyłania zasobu JAR w języku Java do serwera proxy interfejsu API zwracany jest kod stanu HTTP 400 (zamiast 500), jeśli wersja zasobu Java jest niezgodna z obsługiwaną przez Edge wersją języka Java, która jest wymieniona w sekcji Obsługiwane oprogramowanie i obsługiwane wersje. (MGMT-3420)

Weryfikacja zasobów proxy interfejsu API

Jeśli pliki zasobów serwera proxy interfejsu API (takie jak pliki JAR w JavaScript lub Java) są przechowywane w zakresie środowiska lub organizacji, platforma weryfikacyjna nie wymaga już, aby te zasoby były też uwzględniane na poziomie serwera proxy interfejsu API w pakiecie serwera proxy na potrzeby importu, aby przejść weryfikację. Weryfikacja zasobów odbywa się teraz w momencie wdrażania, a nie importowania. (MGMT-1430)

Konfigurowanie limitu czasu dla poszczególnych proxy interfejsu API

Możesz skonfigurować proxy interfejsu API tak, aby po określonym czasie wygasł (ze stanem 504 – przekroczenie limitu czasu bramy). Głównym przypadkiem użycia jest sytuacja, w której klienci chmury prywatnej mają serwery proxy interfejsu API, których wykonanie trwa dłużej. Załóżmy na przykład, że chcesz, aby określone serwery proxy osiągały limit czasu po 3 minutach. W konfiguracji serwera proxy API możesz użyć nowej właściwości api.timeout. Oto jak to zrobić na przykładzie 3-minutowego filmu:

1. Najpierw skonfiguruj system równoważenia obciążenia, router i procesor wiadomości tak, aby po 3 minutach przekraczały limit czasu.
2. Następnie skonfiguruj odpowiednie serwery proxy, aby przekraczały limit czasu po 3 minutach. Podaj 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 serwery proxy bez ustawienia api.timeout używają nowych, wyższych limitów czasu modułu równoważenia obciążenia, routera i procesora wiadomości. Skonfiguruj inne proxy interfejsów API, które nie wymagają dłuższych limitów czasu oczekiwania, tak aby korzystały z krótszych limitów. Na przykład ten kod ustawia limit czasu dla serwera proxy interfejsu API na 1 minutę:
   <Property name="api.timeout">60000</Property>

Klienci Cloud, którzy nie mogą modyfikować limitów czasu Edge, mogą też skonfigurować limit czasu serwera 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 właściwości punktu końcowego. (APIRT-1778)

Zasady TLS/SSL dotyczące rejestrowania wiadomości

<KeyStore> i <TrustStore> można ustawić w konfiguracji SSLInfo w zasadach rejestrowania wiadomości, co umożliwia dwukierunkowe i jednokierunkowe połączenia TLS/SSL z usługą rejestrowania. Element SSLInfo w zasadach logowania wiadomości konfiguruje się tak samo jak w  TargetEndpoint serwera proxy. Jednak TLS/SSL rejestrowania wiadomości obsługuje tylko protokół TCP. (APIRT-1858)

Usunięte błędy

W tej wersji naprawiliśmy 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 jest on przeznaczony do dostarczania szczegółowych informacji wszystkim użytkownikom.