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 porównane w tym artykule usługi Apigee do zarządzania interfejsami API:

Produkt Gdzie jest hostowany Zarządzane przez
Apigee Edge dla Public Cloud 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 następnych sekcjach porównujemy funkcje Apigee Edge Public Cloud/Private Cloud z funkcjami dostępnymi w Apigee X i w wersji hybrydowej.

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 proxy interfejsu API

Niezmienna 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 Private Service Connect. Informacje o typach routingu znajdziesz w artykule Konfigurowanie routingu.
Adapter Apigee dla Istio Zastąpiony: 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 (Code with Config)

Zaplanowano

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 w interfejsie Apigee i interfejsach API
  • Większa elastyczność w zakresie topologii serwowania
  • MP pod może obsługiwać tylko jedno środowisko

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

Docelowe wartości 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ń do szczegółowej kontroli dostępu opartej na rolach

Zaplanowano

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

Używanie [@.length-x] w wyrażeniach JSONPath nie jest obsługiwane w 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",
      }
    ]
}

Dane wejściowe: $.books[@.length-1] zwracają {“name”: “B”} w Apigee Edge i [{“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, klucz KVM jest nadal zaszyfrowany, ale informacje o kluczu KVM będą odszyfrowane w sesji debugowania (Trace) i nie zostanie rzucone żadne wyjątku.
  • Wpisami KVM możesz zarządzać za pomocą interfejsu keyvaluemaps.entries API lub zasady KeyValueMapOperations.
  • Z usług zbiorów usług możesz korzystać w przypadku niektórych tych samych zastosowań co w przypadku usług KVM. 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 map klucz-wartość w interfejsie użytkownika znajdziesz w artykule Korzystanie z map klucz-wartość. Informacje o wybieraniu odpowiedniego mechanizmu trwałości danych znajdziesz też w artykule Dostęp do danych konfiguracji.

Microgateway Zalecamy użycie adaptera Apigee dla 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).
Northbound mTLS Obsługiwane przez systemy równoważenia obciążenia Google Cloud. Zapoznaj się z artykułem Apigee X: wzajemne uwierzytelnianie TLS w kierunku północnym przy użyciu zewnętrznego systemu równoważenia obciążenia aplikacji.
OAuth Nowa zasada RevokeOAuthv2 umożliwia cofnięcie 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 używać 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 tworzyć role niestandardowe, które mogą obejmować inne uprawnienia Google Cloud.

Więcej informacji znajdziesz w artykule Użytkownicy i role.

Sense Użyj zaawansowanych zabezpieczeń API.
Usługi SOAP w kreatorze tworzenia usługi 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.
Wirtualni gospodarze

W przypadku hybrydowej usługi Apigee:

  • Wejście jest implementowane za pomocą bramy wejścia Apigee.
  • 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 w porównaniu z Trace

W tabeli porównano 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; asynchronicznie
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 „Przewodnik po zmiennych procesów”. 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 usługa MessageProcessor otrzymuje prośbę o uruchomienie w trybie debugowania.

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

Dane są przechowywane przez 24 godziny, zanim hybryda automatycznie je usunie.

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

W tej tabeli porównujemy główne funkcje 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 usługami interfejsu API (relacja jeden-do-jednego)
Plany stawek dla deweloperów aplikacji Deweloperzy aplikacji kupują usługi API
Limitami zarządza się na poziomie 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 cenowe mogą stracić ważność, zostać edytowane, przeniesione do wersji roboczej lub usunięte.
Konfiguracja złożona (bez kreatora ani narzędzia do podglądu) Uproszczona konfiguracja planów cenowych 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 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 ramach zasad 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 z abonamentem można skonfigurować 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 preiksem „X-Apigee-” nie są obsługiwane w usłudze Apigee X i są usuwane z żądań oraz odpowiedzi przed wysłaniem do celów i klientów.
  • Właściwość proxy_read_timeout w Apigee Edge nie jest obsługiwana w Apigee X. Aby dowiedzieć się więcej o powiązanych ustawieniach limitu czasu Apigee X, przeczytaj artykuł Ustawianie wartości io.timeout.millis i api.timeout.

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ź na prośbę o usunięcie z 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 serwera proxy interfejsu API. Więcej informacji znajdziesz w artykule Wewnętrzna architektura 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 tej tabeli 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ń asynchronicznych Pobieranie listy asynchronicznych zapytań Analytics Właściwość userId jest pomijana w odpowiedzi. Patrz Metoda: organizations.environments.queries.list.
Interfejsy API raportów niestandardowych Interfejs Reports API Z odpowiedzi zostały usunięte właściwości createdBylastModifiedBy. Zapoznaj się z interfejsem 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 Apigee Edge
Monitorowanie interfejsu API Brak obsługiwanych interfejsów API
Proxy interfejsów API
  • Wymuszanie anulowania wdrożenia proxy interfejsu API
  • Pobieranie 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 dewelopera 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 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.
Wirtualni hostowie Brak obsługiwanych interfejsów API

Apigee Edge for Private Cloud a Apigee Hybrid

W poniższej tabeli porównano Apigee Edge for Private Cloud i hybrydową usługę Apigee:

Usługa Usługa lub funkcja Apigee Obszar
Apigee Edge dla Private Cloud Apigee hybrydowy
Analytics serwery Qpid i Postgres. Podzbiór danych w planie wykonywania korzysta z fluentdUDCA (uniwersalny agent do zbierania danych), aby zbierać dane analityczne i przekazywać je do UAP (zjednoczona platforma analityczna) w planie zarządzania.
Brama proxy interfejsu API procesor komunikatów Procesor wiadomości (MP) przetwarza przychodzące żądania. MP są implementowane jako co najmniej 1 aplikacja w kontenerze w planie działania.
Trwałość węzeł lub pierścień Cassandra, 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 Management 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.