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 AppGroups o le associazioni di app 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 runtime "ha eseguito il check-in" con il control plane
Ambienti
  • Supporto per i gruppi di ambienti
  • Self-service tramite l'interfaccia utente e le API Apigee
  • Flessibilità nella topologia di pubblicazione
  • Un pod MP può pubblicare solo un ambiente

Per saperne di più, consulta Informazioni su ambienti e 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 di ambiente nell'interfaccia utente di Apigee. Le KVM sono sempre criptate. Non puoi aggiungere, aggiornare o visualizzare le voci KVM nella UI.
  • 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 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 i criteri 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 la mappa KVM da utilizzare in fase di runtime.

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
  • Gestione 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 maggiori 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 traccia/debug Vedi Assistenza per Trace.
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 logica di filtraggio complessa, 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 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 Hybrid 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 di mantenere sincronizzati gli orologi dei sincronizzatori, come descritto in Prerequisiti.
Conteggio richieste di traccia 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 sono 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 ulteriori informazioni, consulta la sezione Cache interna.

API delle metriche Apigee

Riepilogo delle API delle metriche Apigee:

Funzionalità API Apigee
Endpoint API apigee.googleapis.com
Email giornaliere con i dati di analisi 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. Vedi API Reports.

Funzionalità di Apigee hybrid

La tabella seguente riepiloga le funzionalità ibride:

Servizio Area ibrida
Analytics Un pod di raccolta dati nel piano di runtime utilizza fluentd e UDCA (Universal Data Collection Agent) per raccogliere i dati di analisi 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 Il sincronizzatore 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 in container Router/processore di messaggi (RMP) nel piano di runtime.
API Si accede alle API Apigee tramite il Management Server 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 singolo server Prometheus per cluster per tutti i servizi.