Różnice między Apigee Edge i Apigee X

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
info

Z tego tematu dowiesz się, czym różni się Apigee X (czasami nazywany po prostu „Apigee”) od Apigee Edge. Te informacje są przeznaczone dla obecnych klientów Apigee Edge, którzy rozważają migrację do Apigee X.

Więcej informacji o funkcjach Apigee X znajdziesz w podsumowaniu funkcji Apigee X.

W tabeli poniżej znajdziesz usługi Apigee do zarządzania interfejsami API, które są porównywane w tym temacie:

Produkt Miejsce hostowania Zarządzane przez
Apigee Edge dla chmury publicznej Chmura Apigee Apigee
Apigee Edge dla Private Cloud Prywatne centrum danych klienta. Klient
Apigee X Google Cloud Apigee
Apigee hybrydowy Zarówno Google Cloud, jak i prywatne centrum danych klienta Apigee zarządza platformą zarządzania, a klient zarządza platformą uruchomienia.

Porównanie funkcji Apigee Edge i Apigee X

W kolejnych sekcjach porównujemy funkcje Apigee Edge Public Cloud/Private Cloud z ich dostępnością w Apigee X i hybrydowej usłudze Apigee.

Pamiętaj, że limity Apigee X różnią się od limitów Apigee Edge.

Podsumowanie różnic między obecnymi funkcjami

W tabeli poniżej opisano różnice na poziomie funkcji między Apigee X (i hybrydowym) a Apigee Edge na platformach chmur publicznych i prywatnych.

Funkcja Apigee Edge Wsparcie w Apigee X i hybrydowej usłudze Apigee
Wersje serwera proxy interfejsu API

Stała po wdrożeniu

Aktywne kontrole stanu Obsługiwane w przypadku zewnętrznych migracji (które korzystają z maszyn wirtualnych). Nieobsługiwane w przypadku korzystania z usługi Private Service Connect. Informacje o typach routingu znajdziesz w artykule o konfigurowaniu routingu.
Adapter Apigee dla Istio Nieaktualna: zalecamy użycie adaptera Apigee dla Envoy.
Firmy i deweloperzy

Dostępne jest podobne, ale nie identyczne rozwiązanie. Zobacz Organizowanie własności aplikacji za pomocą AppGroups.

CwC (kod z konfiguracją)

Planowane

Wdrożenia
  • Wdrożenia asynchroniczne
  • Pobieranie stanu wdrożenia odbywa się na podstawie ostatniego czasu, w którym platforma wykonawcza „zameldowała się” na platformie zarządzającej.
Środowiska
  • Obsługa grup środowisk
  • Samoobsługa za pomocą interfejsu Apigee i interfejsów API
  • większa elastyczność w topologii serwowania;
  • MP pod może obsługiwać tylko 1 środowisko

Więcej informacji znajdziesz w artykule Informacje o środowiskach i grupach środowisk.

Docelowe miejsca hostowane

Użyj Cloud Run lub Cloud Functions.

Obsługa nazwy pola nagłówka HTTP/1.1 konwertuje nazwy pól nagłówka HTTP/1.1 na małe litery podczas przekazywania do backendu; W Apigee Edge wielkość liter w nazwach pól nagłówka jest zachowana.
Role uprawnień umożliwiające szczegółową kontrolę dostępu opartą na rolach

Planowane

JSONPath z użyciem [@.length-x]

Korzystanie z wartości [@.length-x] w wyrażeniach JSONPath nie jest obsługiwane w usłudze Apigee X. Specyfikacja JSONPath określa, że wyrażenia zależą od języka skryptu. Konstrukcja length-x jest elementem JavaScriptu, a nie Javy, a konstrukcja [@.length-x] nie została zaimplementowana w ramach specyfikacji. W Apigee X wyrażenie [@.length-x] zostało zastąpione schematem indeksowania ([-x]).

W odniesieniu do naszego przykładu:

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

Wartość wejściowa: $.books[@.length-1] zwraca wartość {“name”: “B”} w Apigee Edge i zwraca [{“name”: “B”}] w Apigee X.

Magazyny kluczy/usługodawcy weryfikujący

Obiekty wychodzące zarządzane jako obiekty tajne Kubernetes

KVM
  • W interfejsie Apigee możesz tworzyć zaszyfrowane KVM ograniczone do środowiska. KVM są zawsze szyfrowane. Nie możesz dodawać, aktualizować ani wyświetlać wpisów KVM w interfejsie.
  • Używaj atrybutu private. ze wszystkimi zmiennymi podczas uzyskiwania dostępu do KVM za pomocą polecenia GET, aby ukryć informacje o KVM w sesji debugowania (śledzenia). Jeśli atrybut private. nie jest używany, maszyna wirtualna jest nadal szyfrowana. Informacje KVM będą jednak widoczne w sesji debugowania) jako odszyfrowane i nie zostanie zgłoszony żaden wyjątek.
  • Za pomocą interfejsu keyvaluemaps.entries API lub zasady KeyValueMapOperations możesz zarządzać wpisami mapy klucz-wartość.
  • Zestawów właściwości możesz używać w niektórych przypadkach użycia z maszynami wirtualnymi. Zobacz Korzystanie z zestawów usług.
  • Element <MapName> umożliwia zasadom KeyValueMapOperations określanie, której mapy klucz-wartość używać dynamicznie w czasie wykonywania.

Więcej informacji o tworzeniu maszyn KVM w interfejsie znajdziesz w artykule o używaniu map klucz-wartość. Informacje o wybieraniu odpowiedniego mechanizmu trwałości danych znajdziesz też w artykule Dostęp do danych konfiguracji.

Microgateway Zamiast tego zalecamy użycie interfejsu Apigee Adapter for Envoy.
Zarabianie Zobacz Różnice w zarabianiu.
Node.js
  • Serwery proxy interfejsu Node.js API nie są obsługiwane.
  • Apigee zaleca hostowanie aplikacji Node.js jako oddzielnych kontenerów w Kubernetes (w tym samym lub innym klastrze).
mTLS w kierunku północnym Obsługiwane przez systemy równoważenia obciążenia Google Cloud. Zapoznaj się z artykułem Apigee X: northbound mutual TLS z użyciem zewnętrznego systemu równoważenia obciążenia aplikacji.
OAuth Nowa zasada RevokeOAuthv2 umożliwia odwoływanie uprawnień na podstawie identyfikatora użytkownika lub aplikacji albo obu tych identyfikatorów. Ta zasada zastępuje interfejs Apigee Edge API do unieważniania tokenów OAuth2.
Zasady
reasonPhrase Nieobsługiwane.
Materiały Nie można korzystać z zasobów na poziomie organizacji
Role i uprawnienia
  • Zarządzany za pomocą usługi IAM w konsoli Google Cloud
  • Dostępne są niektóre wstępnie skonfigurowane role
  • Możesz też tworzyć role niestandardowe, które mogą obejmować inne uprawnienia dotyczące Google Cloud.

Więcej informacji znajdziesz w artykule o użytkownikach i rolach.

Wyczuwanie Użyj zaawansowanych zabezpieczeń API.
Usługi SOAP w kreatorze tworzenia serwera proxy Nieobsługiwane. Zapoznaj się z  wsdl2apigee, projektem open source, który udostępnia narzędzia SOAP do użycia z Apigee.
Sesje śledzenia i debugowania Zobacz Różnice między logiem czasu a Trace.
Prowadzący wirtualne spotkania

Hybrydowe Apigee:

  • Dostęp jest realizowany za pomocą Anthos Service Mesh.
  • Klucze i certyfikaty są wdrażane bezpośrednio w Kubernetes.

W przypadku Apigee X:

  • Każda instancja udostępnia punkt końcowy HTTPS za pomocą podpisanego samodzielnie certyfikatu. Urząd certyfikacji dla certyfikatu można pobrać, wysyłając zapytanie do organizacji.

Różnice w sposobie działania usługi Trace

W tabeli porównujemy działanie funkcji śledzenia w Apigee X i w wersji hybrydowej w usłudze Apigee Edge Cloud:

Funkcja Apigee Edge Cloud Apigee X i hybrydowa
Terminowość Czas rzeczywisty; synchroniczne Niewielkie opóźnienie; asynchroniczny
Nazwa/identyfikator sesji Akceptuje nazwę sesji od użytkownika. Nie akceptuje nazwy sesji od użytkownika
Filtry podstawowa obsługa filtrów, np. filtrowanie nagłówków i parametrów zapytań; Obsługa złożonej logiki filtrowania, w tym operacji logicznych I i LUB. Dostęp do: dowolnej zmiennej procesu wymienionej w  dokumencie Informacje o zmiennych procesu. Składnia jest taka sama jak w przypadku warunków, jak pokazano w dokumentacji warunków.
Czas trwania sesji

Określa długość sesji debugowania oraz czas przechowywania danych.

Wartość domyślna to 20 minut w przypadku wywołań interfejsu API i 10 minut w przypadku wywołań w interfejsie użytkownika.

Określa tylko czas trwania sesji debugowania. Punkt początkowy to moment, w którym przetwarzacz wiadomości otrzyma prośbę o uruchomienie w trybie debugowania.

Wartość domyślna to 5 minut, jeśli sesja została zainicjowana za pomocą interfejsu API, lub 10 minut, jeśli została zainicjowana w interfejsie użytkownika.

Dane są przechowywane przez 24 godziny, po czym hybryda automatycznie je usuwa.

Ważność sesji

Czas, przez który żądanie utworzenia sesji jest ważne. Jeśli sesja debugowania nie rozpocznie się w tym czasie, synchronizatory mogą zignorować prośbę o utworzenie sesji. Pamiętaj, aby utrzymywać zegary synchronizatorów w zgodnym czasie, zgodnie z opisem w wymaganiach wstępnych.
Liczba żądań przechwytywania Maksymalnie 20 na procesor komunikatów Wartość domyślna to 10 na procesor wiadomości, a maksymalna to 15.
Interfejs API Apigee Edge Cloud Apigee X
Apigee X udostępnia interfejsy Debug Session API i Debug Session Data API, ale nie obsługuje tych interfejsów API Apigee X:
Zatrzymywanie sesji debugowania

Usuwanie konkretnych transakcji

Różnice w zarabianiu

Poniższa tabela zawiera porównanie najważniejszych funkcji Monetyzacji Apigee Edge i Monetyzacji Apigee X.

Monetyzacja Apigee Edge Monetyzacja hybrydowa lub Apigee X
Plany cenowe są powiązane z pakietami usług interfejsu API, które można dołączyć do wielu usług interfejsu API. Plany cenowe są powiązane z poszczególnymi usługami interfejsu API (relacja jeden-do-jednego)
Plany stawek deweloperów aplikacji Deweloperzy aplikacji kupują usługi API
Limitami zarządza się na poziomie serwera proxy interfejsu API Limitami zarządza się na poziomie produktu API (poziom biznesowy).
Opublikowane plany cenowe mogą wygasnąć, ale nie można ich edytować ani usuwać. Opublikowane plany stawek można wygasić, edytować, przenieść do wersji roboczej i usunąć.
Złożona konfiguracja (bez kreatora ani narzędzia podglądu) uproszczona konfiguracja planów taryf za pomocą kreatora i narzędzia do podglądu;
MonetizationLimitsCheck blokuje dostęp po przetworzeniu pierwszego wywołania interfejsu API, jeśli deweloper aplikacji nie kupił subskrypcji Zasada MonetizationLimitsCheck blokuje dostęp natychmiast, jeśli deweloper aplikacji nie kupił subskrypcji lub przekroczył limit
Dane o zarabianiu na transakcjach można rejestrować za pomocą zmiennych niestandardowych w zasadach dotyczących rejestrowania transakcji. Apigee automatycznie rejestruje dane o zarabianiu, a dane o zarabianiu w przypadku transakcji można zastąpić za pomocą zasady dotyczącej rejestrowania danych. Więcej informacji znajdziesz w artykule Zbieranie danych o generowaniu przychodów.
Konta przedpłacone i pobraniowe można konfigurować zarówno dla deweloperów, jak i taryf. Konta przedpłacone i abonamentowe można konfigurować tylko dla deweloperów.

Które funkcje Apigee Edge nie są obsługiwane w Apigee X?

Google nie planuje obsługiwać tych funkcji:

  • Rozszerzenia Apigee Edge
  • Sklep ze specyfikacją OpenAPI
  • interfejsy API do wyszukiwania i unieważniania tokenów dostępu OAuth (ponieważ tokeny są szyfrowane);
  • zasada OAuth w wersji 1 lub OAuth w wersji 1.0a,
  • Trireme (EOL 10/10/2019)
  • Nagłówki z prefiksem „X-Apigee-” nie są obsługiwane w usłudze Apigee X i są usuwane z żądań oraz odpowiedzi przed wysłaniem do odbiorców i klientów.

Porównanie interfejsów API

Ogólnie większość interfejsów API Apigee Edge ma swoje odpowiedniki w interfejsach API Apigee. W tej sekcji znajdziesz:

Podsumowanie zmian za pomocą interfejsu API

Poniżej wymieniono zmiany zachowania wszystkich interfejsów API Apigee X w porównaniu z interfejsami API Apigee Edge.

Zachowanie Interfejsy API Apigee Edge Interfejsy API Apigee X
Domena podstawowa api.enterprise.apigee.com apigee.googleapis.com
Typy multimediów application/json
application/xml
application/json
Uwierzytelnianie OAuth2, SAML, Basic OAuth2
Sygnatury czasowe w kluczach Format: int64
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
Format: String
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Struktura parametru zapytania expand=false
[
        "helloworld",
        "weather"
      ]
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Parametry zapytania z preiksem podkreślenia Obsługiwane (_optimal=true) Nieobsługiwane (optimal=true)
Właściwości w plikach danych:
  • created_by
  • modified_by
  • self
Obsługiwane Nieobsługiwane
Wartości domyślne w ładunkach Uwzględniono Nie uwzględniono
Struktura obsługi błędów
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Odpowiedź dotycząca usunięcia pamięci podręcznej Zwroty: 200 OK i szczegóły pamięci podręcznej Zwroty: 204 No Content
Operacje interfejsu Cache API List, create, get, update, delete, clear all, oraz clear. Lista i usuń. Krótkotrwała pamięć podręczna L1 jest tworzona automatycznie podczas wdrażania interfejsu API proxy. Więcej informacji znajdziesz w artykule Cache internals (Wnętrze pamięci podręcznej).

Różnice między interfejsami API danych Apigee Edge i Apigee X

Podsumowanie zmian w interfejsie API zawiera ogólne różnice między interfejsem API Apigee Edge a interfejsem API Apigee X. W tabeli poniżej znajdziesz szczegółowe informacje o różnicach między interfejsami API danych:

Funkcja Interfejsy API Apigee Edge Interfejsy API Apigee X
punkt końcowy API api.enterprise.apigee.com apigee.googleapis.com
Codzienne e-maile z statystykami Brak obsługiwanych interfejsów API
Interfejs API listy zapytań synchronicznych Pobieranie listy zapytań analitycznych asynchronicznych Właściwość userId jest pomijana w odpowiedzi. Zobacz Metoda: organizations.environments.queries.list.
Interfejsy API raportów niestandardowych Interfejs Reports API Właściwości createdBylastModifiedBy zostały usunięte z odpowiedzi. Zobacz interfejs Reports API.

Nieobsługiwane interfejsy Apigee Edge

W tabeli poniżej znajdziesz nieobsługiwane interfejsy API Apigee Edge (które nie mają odpowiedników w interfejsach API Apigee X).

Kategoria interfejsu API Nieobsługiwane interfejsy API Apigee Edge
Monitorowanie interfejsu API Brak obsługiwanych interfejsów API
Proxy interfejsów API
  • Wymuszanie anulowania wdrożenia proxy interfejsu API
  • Pobranie zależności npm
  • Zarządzanie modułami npm
Audyty Korzystanie z Stackdriver Logging API
Logi w pamięci podręcznej Brak obsługiwanych interfejsów API
Firmy Brak obsługiwanych interfejsów API
Aplikacje firmowe Brak obsługiwanych interfejsów API
Rodzina aplikacji firmowych Brak obsługiwanych interfejsów API
Klucze aplikacji firmowej Brak obsługiwanych interfejsów API
Sesje debugowania
  • Nie można zatrzymać sesji śledzenia
  • Nie można usuwać poszczególnych transakcji

Więcej informacji znajdziesz w artykule Różnice w porównaniu z Trace.

Aplikacja dewelopera Pobieranie liczby zasobów interfejsu API
Rodzina aplikacji deweloperskich Brak obsługiwanych interfejsów API
Rozszerzenia Brak obsługiwanych interfejsów API
Magazyn kluczy: magazyn zaufania Testowanie repozytorium kluczy lub repozytorium zaufania
LDAP Brak obsługiwanych interfejsów API
Zarabianie Brak obsługiwanych interfejsów API
OAuth V2 Brak obsługiwanych interfejsów API
Zasady Brak obsługiwanych interfejsów API
Pliki zasobów
  • Zakres wersji serwera proxy interfejsu API
  • Zakres organizacji
Sense Brak obsługiwanych interfejsów API
Użytkownicy i ich role Korzystaj z interfejsów API związanych z usługą Google Cloud Identity & Access Management (IAM) zgodnie z opisem w artykule Zarządzanie użytkownikami, rolami i uprawnieniami za pomocą interfejsów API.
Hosty wirtualne Brak obsługiwanych interfejsów API

Apigee Edge for Private Cloud a Apigee Hybrid

W tej tabeli porównano Apigee Edge dla Private Cloud i hybrydowy Apigee:

Usługa Produkt lub funkcja Apigee Obszar
Apigee Edge dla Private Cloud Apigee hybrydowy
Analytics serwery Qpid i Postgres, Pod służący do zbierania danych w środowisku wykonawczym używa usług fluentd i UDCA (Universal Data Collection Agent) do zbierania statystyk i przesyłania danych do UAP (Unified Analytics Platform) w płaszczyźnie zarządzania.
bramę API Proxy, procesor komunikatów Procesor wiadomości (MP) przetwarza żądania przychodzące. Pliki MP są zaimplementowane jako co najmniej 1 aplikacja skonteneryzowana na poziomie środowiska wykonawczego.
Wytrwałość węzeł Cassandra lub pierścień; Cassandra zapewnia trwałość funkcji KMS, KVM, limitu i pamięci podręcznej.
Wdrożenie ZooKeeper Synchronizer zapewnia, że konfiguracje serwera proxy interfejsu API, informacje o środowisku i inne dane są aktualizowane na bieżąco na poziomie zarządzania i uruchomienia.
Interfejs administracyjny Interfejs Apigee Edge jest hostowany na serwerze zarządzania. Interfejs Apigee jest hostowany na platformie zarządzania.
Równoważenie obciążenia Router Kontroler Istio Ingress przekazuje żądania do kontenerowej aplikacji Message Processor (MP) w środowisku uruchomieniowym.
Interfejsy API Serwer zarządzania Do interfejsów API Apigee X można uzyskać dostęp za pomocą serwera zarządzania i MART. MART współpracuje z lokalnym magazynem danych Cassandra i pełni funkcję dostawcy interfejsu API dla interfejsów Apigee X, aby uzyskiwać dostęp do jednostek danych w czasie wykonywania i nimi zarządzać.
Wskaźniki Każdy komponent skonfigurowany za pomocą JMX Zarządzany przez jeden serwer Prometheus na klaster dla wszystkich usług.