Differenze tra Apigee Edge e Apigee X

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X.
Informazioni

Questo argomento descrive in che modo Apigee X (a volte chiamato anche semplicemente "Apigee") differisce da Apigee Edge Queste informazioni sono rivolte ai clienti Apigee Edge esistenti che stanno prendendo in considerazione la migrazione a Apigee X.

Per ulteriori informazioni sulle funzionalità di Apigee X, consulta il riepilogo delle funzionalità di Apigee X.

Nella tabella seguente sono elencati i prodotti di gestione delle API Apigee confrontati in questo argomento:

Prodotto Dove ospitata Gestito da
Apigee Edge per il cloud pubblico Il cloud di Apigee Apigee
Apigee Edge per il cloud privato Il data center privato del cliente. Cliente
Apigee X Google Cloud Apigee
Apigee hybrid Sia Google Cloud sia il data center privato del cliente Apigee gestisce il piano di gestione e il cliente gestisce il piano di runtime.

Confronto delle funzionalità da Apigee Edge ad Apigee X

Le sezioni seguenti confrontano le funzionalità del cloud pubblico/privato di Apigee Edge con la funzionalità in Apigee X e ibrido.

Tieni presente che i limiti di Apigee X si differenziano anche dai limiti di Apigee Edge.

Riepilogo delle differenze di funzionalità attuali

La tabella seguente descrive le differenze a livello di funzionalità tra Apigee X (e modello ibrido) e Apigee Edge per piattaforme cloud pubbliche e private.

Funzionalità Apigee Edge Supporto in Apigee X e ibrido
Revisioni proxy API

Immutabile al momento del deployment

Controlli di integrità attivi Supportata per i gruppi di istanze gestite esterni (che utilizzano le VM). Non supportata quando si utilizza Private Service Connettiti. Per informazioni sui tipi di routing, consulta Configurare il routing.
Adattatore Apigee per Istio Obsoleta: ti consigliamo di utilizzare . Apigee Adapter per Envoy.
Aziende e sviluppatori

È disponibile una soluzione simile, ma non identica. Consulta Utilizzare AppGroups per organizzare la proprietà delle app.

CwC (codice con configurazione)

Pianificata

Deployment
  • Deployment asincroni
  • Il recupero dello stato del deployment si basa sull'ultima tempo in cui il piano di runtime ha eseguito il "check-in" con il piano di gestione
Ambienti
  • Supporto per i gruppi di ambienti
  • Self-service tramite la UI e le API Apigee
  • Maggiore flessibilità nella topologia di pubblicazione
  • Un pod MP può gestire solo un ambiente

Per saperne di più, vedi Informazioni sugli ambienti e sui gruppi di ambienti.

Destinazioni ospitate

Utilizza Cloud Run oppure Cloud Functions

Gestione del nome del campo dell'intestazione HTTP/1.1 Converte in lettere minuscole i nomi dei campi di intestazione HTTP/1.1 quando inoltrati alla di un backend cloud. In Apigee Edge, i nomi dei campi di intestazione vengono conservati.
Ruoli IAM per un controllo dell'accesso granulare basato sui ruoli

Pianificata

JSONPath utilizzando [@.length-x]

L'utilizzo di [@.length-x] nelle espressioni JSONPath non è supportato in Apigee X. La specifica JSONPath indica che le espressioni dipendono dallo scripting sottostante lingua. length-x è un costrutto JavaScript, non Java, e [@.length-x] non è stato implementato nell'ambito della specifica. In Apigee X l'espressione [@.length-x] è sostituita dallo schema di indicizzazione ([-x]).

Per questo esempio:

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

L'input: $.books[@.length-1] restituisce {“name”: “B”} in Apigee Edge e restituisce [{“name”: “B”}] in Apigee X.

Keystore/truststore

Collegamento a nord gestito come secret di Kubernetes

KVM
  • Puoi creare KVM criptate con ambito di ambiente nella UI di Apigee. KVM sono sempre crittografati. Non puoi aggiungere, aggiornare o visualizzare le voci KVM nell'interfaccia utente.
  • Utilizza l'attributo private. con tutte le variabili quando accedi a una KVM con il comando GET per nascondere le informazioni della KVM in una sessione di debug (Trace). Se l'attributo private. non è utilizzato, la KVM è ancora criptato; tuttavia, le informazioni KVM appariranno decriptate nella Trace di debug sessione e non verranno presentate eccezioni.
  • Puoi gestire le voci KVM utilizzando API keyvaluemaps.entries o il . criterio KeyValueMapOperations.
  • Puoi utilizzare i set di proprietà per alcuni degli stessi casi d'uso delle KVM. Consulta Utilizzo degli insiemi di proprietà.
  • L'elemento <MapName> abilita il criterio KeyValueMapOperations per identificare la KVM da usare in modo dinamico in fase di runtime.

Per ulteriori informazioni sulla creazione di KVM nell'interfaccia utente, vedi Utilizzo delle mappe chiave-valore. Vedi anche Accesso configurazione per informazioni su come scegliere la giusta persistenza dei dati meccanismo di attenzione.

Microgateway È consigliabile utilizzare Adattatore Apigee per Envoy.
Monetizzazione Vedi Differenze rispetto alla monetizzazione
Node.js
  • I proxy API Node.js non sono supportati.
  • Apigee consiglia di ospitare le applicazioni Node.js come container separati in Kubernetes (cluster stesso o diverso)
mTLS relativo al nord Pianificata
OAuth Nuovo Revoca criterio OAuthv2 viene revocato in base all'ID utente finale, all'ID app o a entrambi. Queste norme sostituisce l'API Apigee Edge per revocare i token OAuth2.
Norme
  • Nuove norme:
      .
    • criterio AssertCondition: valuta un'istruzione condizionale in fase di runtime nel nei flussi di richiesta o risposta.
    • Criterio CORS: consente le chiamate JavaScript XMLHttpRequest (XHR) eseguite in un ambiente web per interagire con le risorse di domini non di origine.
    • Criterio Data Capture: sostituisce il criterio StatisticsCollector.
    • Criterio di callout esterno: invia le richieste gRPC al server gRPC per l'implementazione un comportamento personalizzato non supportato dai criteri di Apigee.
    • Criterio GraphQL: analizza i payload di GraphQL in variabili di flusso dei messaggi, verifica Richieste GraphQL in base a uno schema, o entrambi.
    • Criteri PubblicaMessaggi: pubblica le informazioni sul flusso del proxy API in un di Google Cloud Pub/Sub.
    • Revoca criterio OAuthv2: revoca per ID utente, ID app o entrambi.
    • Criterio Trace Capture: aggiunge ulteriori variabili alla traccia del runtime Apigee e i dati di Google Cloud.
  • Criterio non supportato:
      .
    • Criterio StatisticsCollector (sostituito dal nuovo criterio Data Capture)
  • Norme modificate:
reasonPhrase Non supportati.
Risorse Impossibile utilizzare risorse a livello di organizzazione
Ruoli e autorizzazioni
  • Funzionalità gestita tramite il servizio IAM della console Google Cloud
  • Sono disponibili alcuni ruoli predefiniti pronti all'uso
  • Puoi creare ruoli personalizzati che possono includere altre autorizzazioni Google Cloud

Per ulteriori informazioni, vedi Utenti e ruoli.

Sense Utilizzare Advanced API Security.
Servizi SOAP nella procedura guidata Crea un proxy Non supportati. Vedi wsdl2apigee, un progetto open source che fornisce utilità SOAP da utilizzare con Apigee.
Sessioni di tracciamento/debug Consulta Differenze con Trace.
Host virtuali

Per Apigee hybrid:

  • Il traffico in entrata viene implementato tramite Anthos Service Mesh.
  • Il deployment delle chiavi e dei certificati viene eseguito direttamente in Kubernetes.

Per Apigee X:

  • Ogni istanza espone un endpoint HTTPS tramite certificato autofirmato. La CA per puoi scaricare il certificato inviando una query all'organizzazione.

Differenze con Trace

La tabella seguente confronta le differenze nel funzionamento di Trace in Apigee X e modello ibrido rispetto ad Apigee Edge Cloud:

Funzionalità Apigee Edge Cloud Apigee X e modello ibrido
Tempestività In tempo reale; sincrono Leggero ritardo; asincrono
Nome/ID sessione Accetta il nome della sessione dall'utente Non accetta il nome della sessione dall'utente
Filtri Supporto di base per i filtri, ad esempio filtri di intestazioni e parametri di query Supporto per logiche di filtro complesse, incluse operazioni logiche AND e OR. Accedi a qualsiasi variabile di flusso menzionata nel riferimento sulle variabili di flusso. La sintassi è la stessa utilizzata per le condizionali, come mostrato in riferimento alle condizioni.
Timeout sessione

Definisce la durata della sessione di debug e per quanto tempo vengono conservati i dati.

Il valore predefinito è 20 minuti se avviato tramite chiamate API e 10 minuti se avviato nel l'interfaccia utente.

Definisce solo la durata della sessione di debug. Il punto di partenza è quando l'oggetto Il processore riceve la richiesta di esecuzione in modalità di debug.

Il valore predefinito è 5 minuti se la sessione è stata avviata con l'API e 10 minuti se la sessione è stata avviata è stata avviata nell'interfaccia utente.

I dati rimangono persistenti per 24 ore prima che il sistema ibrido li elimini automaticamente.

Validità della sessione

Periodo di tempo durante il quale la richiesta di creazione della sessione è valida. Se la sessione di debug entro questo lasso di tempo, i sincronizzatori possono ignorare la creazione della sessione richiesta. Assicurati di tenere i sincronizzatori orologi sincronizzati, come descritto in Prerequisiti.
Numero di richieste di tracciamento Massimo 20 per processore di messaggi Il valore predefinito è 10 per processore di messaggi. è 15.
API Apigee Edge Cloud Apigee X
Apigee X espone API Debug Session e Debug dell'API Session Data, ma non supporta quanto segue tramite le API Apigee X:
Interrompi sessione di debug

Eliminare transazioni specifiche

Differenze rispetto alla monetizzazione

La tabella seguente mette a confronto le funzionalità chiave della monetizzazione di Apigee Edge e Monetizzazione Apigee X.

Monetizzazione Apigee Edge Apigee X/Monetizzazione ibrida
I piani tariffari sono associati a pacchetti di prodotti API che possono essere associati a più prodotti API I piani tariffari sono associati ai prodotti API (relazione one-to-one)
Piani del tasso di acquisto degli sviluppatori di app Gli sviluppatori di app acquistano prodotti basati su API
Le quote sono gestite a livello di proxy API Le quote vengono gestite a livello di prodotto API (livello aziendale)
I piani tariffari pubblicati possono solo essere scaduti. non possono essere modificate o eliminate I piani tariffari pubblicati possono essere scaduti, modificati, spostati in bozza o eliminati
Configurazione complessa (nessuna procedura guidata o strumento di anteprima) Configurazione semplificata dei piani tariffari tramite la procedura guidata e lo strumento anteprima
Il criterio MonetizationLimitsCheck blocca l'accesso dopo l'elaborazione della prima chiamata API se lo sviluppatore di app non ha acquistato un abbonamento Il criterio MonetizationLimitsCheck blocca immediatamente l'accesso se lo sviluppatore di app non ha acquistato un abbonamento o supera la quota
I dati sulla monetizzazione relativi alle transazioni possono essere acquisiti utilizzando le variabili personalizzate nelle norme di registrazione delle transazioni. Apigee acquisisce automaticamente i dati sulla monetizzazione e i dati sulla monetizzazione per le transazioni possono essere sostituiti utilizzando il criterio Data Capture. Consulta Acquisire i dati sulla monetizzazione per informazioni.
Gli account prepagati e con pagamento posticipato possono essere configurati sia per gli sviluppatori sia per i piani tariffari. Gli account prepagati e con pagamento posticipato possono essere configurati solo per gli sviluppatori.

Quali funzionalità di Apigee Edge non sono supportate in Apigee X?

Google non prevede di supportare le seguenti funzionalità:

  • Estensioni Apigee Edge
  • Archivio delle specifiche OpenAPI
  • API per cercare o revocare i token di accesso OAuth (perché i token sono con hash)
  • Criterio OAuth v1 o OAuth v1.0a
  • Trireme (EOL il 10/10/2019)
  • Intestazioni con prefisso "X-Apigee-" non sono supportati in Apigee X e vengono rimossi richieste e risposte prima dell'invio a target e client.

Confronto API

In generale, la maggior parte delle API Apigee Edge ha equivalenti API Apigee. Questa sezione fornisce:

Riepilogo delle modifiche con l'API

Di seguito sono elencati i cambiamenti nel comportamento di tutte le API Apigee X rispetto alla piattaforma Apigee API Edge.

Comportamento API Apigee Edge API Apigee X
Dominio di base api.enterprise.apigee.com apigee.googleapis.com
Tipi di media application/json
application/xml
application/json
Autenticazione OAuth2, SAML, base OAuth2
Timestamp nelle chiavi Formato int64
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
Formato String
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Struttura del parametro di query expand=false
[
        "helloworld",
        "weather"
      ]
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Parametri di query preceduti da un trattino basso Supportate (_optimal=true) Non supportati (optimal=true)
Proprietà nei payload:
  • created_by
  • modified_by
  • self
Supportato Non supportata
Valori predefiniti nei payload Incluso Non inclusa
Struttura della gestione degli errori
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Risposta di eliminazione della cache Restituisce: 200 OK e dettagli della cache Resi: 204 No Content
Operazioni API cache Elenco, . creare, get, aggiorna, elimina, cancella tutto, e opzioni chiare. Elenco e . Elimina. La cache L1 di breve durata viene creata automaticamente quando esegui il deployment proxy API. Per ulteriori informazioni, vedi Interni della cache.

Differenze tra le API delle metriche Apigee Edge e Apigee X

Riepilogo delle modifiche con l'API elenca le differenze generali tra l'API Apigee Edge e l'API Apigee X. Nella tabella seguente sono elencati i differenze specifiche per le API delle metriche:

Funzionalità API Apigee Edge API Apigee X
endpoint API api.enterprise.apigee.com apigee.googleapis.com
Email di analisi giornaliere Nessuna API supportata
API Async Query List Visualizzare un elenco di query di analisi asincrone La proprietà userId è omessa dalla risposta. Vedi Metodo: organization.environments.queries.list.
API per report personalizzati API Reports Le proprietà createdBy e lastModifiedBy sono state rimosse dalla risposta. Consulta API Reports.

API Apigee Edge non supportate

Nella tabella seguente sono elencate le API Apigee Edge non supportate (che non hanno API Apigee X) equivalenti).

Categoria API API Apigee Edge non supportate
Monitoraggio delle API Nessuna API supportata
Proxy API
  • Forza l'annullamento del deployment del proxy API
  • Ottieni dipendenze npm
  • Gestisci moduli npm
Controlli Utilizza l'API Stackdriver Logging
Log memorizzati nella cache Nessuna API supportata
Aziende Nessuna API supportata
App aziendali Nessuna API supportata
Famiglia di app aziendali Nessuna API supportata
Chiavi dell'app aziendale Nessuna API supportata
Sessioni di debug
  • Impossibile interrompere le sessioni di traccia
  • Impossibile eliminare singole transazioni

Per ulteriori informazioni, consulta Differenze con Trace.

App sviluppatore Recupera il conteggio delle risorse API
Famiglia di app sviluppatore Nessuna API supportata
Estensioni Nessuna API supportata
Archivio chiavi: archivio attendibili Testa un archivio chiavi o un archivio attendibili
LDAP Nessuna API supportata
Monetizzazione Nessuna API supportata
OAuth V2 Nessuna API supportata
Norme Nessuna API supportata
File di risorse
  • Ambito della revisione del proxy API
  • Ambito dell'organizzazione
Sense Nessuna API supportata
Utenti e ruoli utente Utilizzare le API relative a Google Identity and Access Management (IAM) come descritto in Gestione degli utenti, ruoli e autorizzazioni usando le API
Host virtuali Nessuna API supportata

Apigee Edge per il cloud privato e Apigee hybrid

La tabella seguente mette a confronto Apigee Edge per il cloud privato e Apigee hybrid:

Servizio Prodotto o funzionalità Apigee Settore
Apigee Edge per Private Cloud Apigee hybrid
Analytics Server Qpid e Postgres Un pod di raccolta dati nel piano di runtime utilizza fluentd e UDCA (Universal Data Collection Agent) per raccogliere dati e analisi e invia i dati alla UAP (Unified Analytics Platform) nella aereo.
Gateway proxy API processore di messaggi Il processore di messaggi (MP) elabora le richieste in entrata. MP implementati come una o più app containerizzate nel piano di runtime.
Persistenza Nodo o anello Cassandra Cassandra fornisce persistenza per le funzionalità KMS, KVM, quota e cache.
Deployment ZooKeeper Lo strumento Syncr assicura che le configurazioni del proxy API, l'ambiente e altri dati vengono mantenuti aggiornati tra il piano di gestione e il aereo.
Interfaccia utente amministrativa La UI di Apigee Edge è ospitata sul server di gestione La UI di Apigee è ospitata sul piano di gestione.
Bilanciamento del carico Router Un controller Istio Ingress invia le richieste alla App containerizzata Message Processor (MP) nel piano di runtime.
API Server di gestione Le API Apigee X sono accessibili tramite il server di gestione e MART. MART interagisce con locale Cassandra e funge da provider di API per consentire alle API Apigee X di accedere e per gestire le entità dati di runtime.
Metriche Ogni componente configurato con JMX Gestito da un singolo server Prometheus per cluster per tutti i servizi.