Panoramica delle funzionalità tecniche di Apigee

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questo argomento riepiloga le funzionalità di Apigee e confronta le caratteristiche e le funzionalità di Apigee e Apigee hybrid.

La tabella seguente elenca i prodotti di gestione delle API Apigee confrontati in questo argomento:

Prodotto Dove è ospitato Gestito da
Apigee Google Cloud Apigee
Apigee hybrid Google Cloud e il data center privato del cliente Apigee gestisce il piano di gestione e il cliente gestisce il piano di runtime.

Riepilogo delle funzionalità di Apigee

La tabella seguente fornisce un riepilogo a livello di funzionalità di Apigee (e ibrido).

Funzionalità Supporto in Apigee e hybrid
Revisioni del proxy API

Immutabile dopo il deployment

Apigee Adapter for Istio Obsoleto: ti consigliamo di utilizzare Apigee Adapter for Envoy.
Organizzazione delle app Organizza le app utilizzando le associazioni di app AppGroup o per sviluppatori. Consulta Organizzare la proprietà delle app client.
Deployment
  • Deployment asincroni
  • Il recupero dello stato del deployment si basa sull'ultima volta 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
  • Flessibilità nella topologia di pubblicazione
  • Un pod MP può pubblicare solo un ambiente

Per maggiori informazioni, vedi Informazioni sugli ambienti e sui gruppi di ambienti.

Supporto del proxy basato su gRPC

Elabora le richieste API del protocollo gRPC unitario a un server di destinazione gRPC. Consulta Creazione di proxy API gRPC.

Case del nome del campo di intestazione HTTP/1.1

Converte i nomi dei campi di intestazione HTTP/1.1 in lettere minuscole quando vengono inoltrati al backend. Questo comportamento potrebbe influire sulle applicazioni che prevedono la conservazione delle maiuscole e minuscole.

Archivi chiavi/Archivi attendibili
  • Northbound gestito come secret Kubernetes
KVM
  • Puoi creare KVM criptate e con ambito ambiente nella UI di Apigee. I KVM sono sempre criptati. Non puoi aggiungere, aggiornare o visualizzare le voci KVM nella UI.
  • Utilizza l'attributo private. con tutte le variabili quando accedi a un KVM con il comando GET per nascondere le informazioni del KVM in una sessione di debug (trace). Se l'attributo private. non viene utilizzato, la KVM è comunque criptata; tuttavia, le informazioni della KVM verranno visualizzate decriptate nella sessione di debug Trace) e non verrà generata alcuna eccezione.
  • Puoi gestire le voci KVM utilizzando l'API keyvaluemaps.entries o la policy KeyValueMapOperations.
  • Puoi utilizzare i set di proprietà per alcuni degli stessi casi d'uso delle KVM. Consulta Utilizzo dei set di proprietà.
  • L'elemento <MapName> consente alla policy KeyValueMapOperations di identificare dinamicamente, in fase di runtime, quale KVM utilizzare.

Per saperne di più sulla creazione di KVM nella UI, consulta Utilizzo delle mappe chiave-valore. Consulta anche Accesso ai dati di configurazione per informazioni su come scegliere il meccanismo di persistenza dei dati corretto.

Monetizzazione Supportato in Apigee e Apigee hybrid. Consulta la panoramica della monetizzazione per le funzionalità.
Node.js
  • I proxy API Node.js non sono supportati.
  • Apigee consiglia di ospitare le applicazioni Node.js come container separati in Kubernetes (stesso cluster o cluster diversi)
OAuth Il nuovo criterio RevokeOAuthv2 revoca per ID utente finale, ID app o entrambi.
Norme Consulta la panoramica delle norme.
Risorse Impossibile utilizzare le risorse a livello di organizzazione
Ruoli e autorizzazioni
  • Gestiti tramite il servizio IAM della console Google Cloud
  • Sono disponibili alcuni ruoli predefiniti selezionati
  • Puoi creare ruoli personalizzati che possono includere altre autorizzazioni Google Cloud.

Per ulteriori informazioni, vedi Utenti e ruoli.

Servizi SOAP nella procedura guidata Crea un proxy Non supportati. Consulta wsdl2apigee, un progetto open source che fornisce utilità SOAP da utilizzare con Apigee.
Sessioni di tracciamento/debug Vedi Assistenza per la traccia.
Virtual Hosts

Per l'ibrido:

  • L'ingresso viene implementato tramite Anthos Service Mesh.
  • Le chiavi e i certificati vengono implementati direttamente in Kubernetes.

Per Apigee:

  • Ogni istanza espone un endpoint HTTPS tramite un certificato autofirmato. La CA per il certificato può essere scaricata eseguendo una query sull'organizzazione.

Supporto per Trace/debug

La tabella seguente mostra il supporto di Apigee e di Trace ibrido:

Funzionalità Supporto di Apigee e hybrid
Tempestività Leggero ritardo; asincrono
Nome/ID sessione Non accetta il nome della sessione dall'utente
Filtri Supporto per logiche di filtraggio complesse, incluse le operazioni logiche AND e OR. Accesso a qualsiasi variabile di flusso menzionata nel riferimento alle variabili di flusso. La sintassi è la stessa utilizzata con le condizioni, come mostrato nel riferimento alle condizioni.
Timeout della sessione

Definisce solo la durata della sessione di debug. Il punto di partenza è quando il processore di messaggi 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 è stata avviata nell'interfaccia utente.

I dati vengono conservati per 24 ore prima che ibrido li elimini automaticamente.

Validità della sessione Il periodo di tempo in cui la richiesta di creazione della sessione è valida. Se la sessione di debug non inizia entro questo periodo di tempo, i sincronizzatori possono ignorare la richiesta di creazione della sessione. Assicurati che gli orologi dei sincronizzatori siano sincronizzati, come descritto in Prerequisiti.
Conteggio richieste di tracciamento Il valore predefinito è 10 per processore di messaggi; il valore massimo è 15.
API Apigee espone l' API Debug Session e l' API Debug Session Data

Panoramica dell'API

Di seguito vengono riassunte le API e le funzionalità di Apigee.

Comportamento API Apigee
Dominio di base apigee.googleapis.com
Tipi di media application/json
Autenticazione OAuth2
Timestamp nelle chiavi Formato String
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Struttura del parametro di query expand=false
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Parametri di query con prefisso di sottolineatura Non supportato (optimal=true)
Proprietà nei payload:
  • created_by
  • modified_by
  • self
Non supportata
Valori predefiniti nei payload Non inclusa
Struttura di gestione degli errori
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Risposta all'eliminazione della cache Resi: 204 No Content
Operazioni dell'API Cache Elenco ed eliminazione. La cache L1 di breve durata viene creata automaticamente quando esegui il deployment di un proxy API. Per saperne di più, consulta Elementi interni della cache.

API delle metriche Apigee

Riepilogo delle API delle metriche Apigee:

Funzionalità API Apigee
Endpoint API apigee.googleapis.com
Email con i dati di analisi giornalieri Nessuna API supportata
API Async Query List La proprietà userId viene omessa dalla risposta. Vedi Metodo: organizations.environments.queries.list.
API per i report personalizzati Le proprietà createdBy e lastModifiedBy sono state rimosse dalla risposta. Consulta l'API Reports.

Funzionalità di Apigee hybrid

La tabella seguente riassume le funzionalità ibride:

Servizio Area ibrida
Analytics Un pod di raccolta dei dati nel piano di runtime utilizza fluentd e UDCA (Universal Data Collection Agent) per raccogliere i dati e trasferirli alla UAP (Unified Analytics Platform) nel piano di gestione.
Gateway proxy API Il processore di messaggi (MP) elabora le richieste in entrata. I microservizi vengono implementati come una o più app containerizzate nel piano di runtime.
Persistenza Cassandra fornisce la persistenza per le funzionalità KMS, KVM, quota e cache.
Deployment Synchronizer garantisce che le configurazioni dei proxy API, le informazioni sull'ambiente e altri dati vengano mantenuti aggiornati tra il management plane e il runtime plane.
Interfaccia utente amministrativa La UI Apigee è un'app containerizzata ospitata sul piano di gestione.
Bilanciamento del carico Un controller Istio Ingress passa le richieste all'app containerizzata Router/processore di messaggi (RMP) nel piano di runtime.
API Si accede alle API Apigee tramite il server di gestione e MART. MART interagisce con il datastore Cassandra locale e funge da fornitore di API per le API Apigee per accedere e gestire le entità di dati di runtime.
Metriche Gestito da un unico server Prometheus per cluster per tutti i servizi.