Panoramica delle funzionalità tecniche di Apigee

Questa pagina si applica a Apigee e Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

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

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

Prodotto Dove ospitata Gestito da
Apigee 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.

Riepilogo delle funzionalità di Apigee

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

Selezione delle Supporto in Apigee e ibrido
Revisioni proxy API

Immutabile al momento del deployment
Adattatore Apigee per Istio Deprecato: ti consigliamo di utilizzare invece Apigee Adapter for Envoy.
Organizzazione app Organizzare le app utilizzando AppGroups o associazioni tra app sviluppatore. Consulta la pagina Organizzare la proprietà dell'app client.
Deployment
  • Deployment asincroni
  • Il recupero dello stato del deployment si basa sull'ultima volta che 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ò gestire solo un ambiente

Per saperne di più, vedi Informazioni sugli ambienti e sui gruppi di ambienti.
Supporto per proxy basato su gRPC

Elabora le richieste API con protocollo gRPC unario a un server di destinazione gRPC. Consulta la pagina relativa alla creazione di proxy API gRPC.
Maiuscole per il 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 che il caso venga conservato.

Keystore/truststore
  • Collegamento a nord gestito come secret di Kubernetes
KVM
  • Puoi creare KVM criptate con ambito di ambiente nella UI di Apigee. Le KVM sono sempre criptate. 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 KVM in una sessione di debug (Trace). Se l'attributo private. non viene utilizzato, la KVM è comunque criptata; tuttavia, le informazioni KVM verranno decriptate nella sessione Trace di debug e non verranno generate eccezioni.
  • Puoi gestire le voci KVM utilizzando l'API keyvaluemaps.entries o il criterio KeyValueMapOperations.
  • Puoi utilizzare i set di proprietà per alcuni degli stessi casi d'uso delle KVM. Consulta Utilizzare gli insiemi di proprietà.
  • L'elemento <MapName> consente al criterio KeyValueMapOperations di identificare quale KVM utilizzare in modo dinamico, in fase di runtime.

Per ulteriori informazioni 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 Consulta la pagina Panoramica della 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 uguali o diversi)
OAuth Il nuovo criterio RevocaOAuthv2 viene revocato in base all'ID utente finale, all'ID app o a entrambi.
Norme Consulta la Panoramica delle norme.
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 maggiori informazioni, consulta Utenti e ruoli.
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 Vedi Assistenza di Trace.
Host virtuali

Per il modello ibrido:

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

Per Apigee:

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

Supporto di Trace/Debug

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

Selezione delle Apigee e supporto ibrido
Tempestività Leggero ritardo; asincrono
Nome/ID sessione Non accetta il nome della sessione dall'utente
Filtri Supporto per logiche di filtro complesse, incluse operazioni logiche AND e OR. Accesso a qualsiasi variabile di flusso menzionata nel riferimento sulle variabili di flusso. La sintassi è la stessa utilizzata per le condizionali, 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 nella UI.

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 non viene avviata 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.
Numero di richieste di tracciamento Il valore predefinito è 10 per processore di messaggi; il massimo è 15.
API Apigee espone l' API Debug Session e l' API Debug Session Data

Panoramica dell'API

Di seguito sono riepilogate 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 preceduti da un trattino basso Non supportati (optimal=true)
Proprietà nei payload:
  • created_by
  • modified_by
  • self
 Funzionalità non supportata
Valori predefiniti nei payload Non inclusa
Struttura della gestione degli errori 
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Risposta di eliminazione della cache Resi: 204 No Content
Operazioni API cache Solo Elenco ed elimina. La cache L1 di breve durata viene creata automaticamente quando esegui il deployment di un proxy API. Per maggiori informazioni, consulta Informazioni interne della cache.

API delle metriche Apigee

Riepilogo delle API per le metriche Apigee:

Selezione delle API Apigee
endpoint API apigee.googleapis.com
Email di analisi giornaliere Nessuna API supportata
API Async Query List La proprietà userId è omessa dalla risposta. Vedi Metodo: organization.environments.queries.list.
API per report personalizzati Le proprietà createdBy e lastModifiedBy sono state rimosse dalla risposta. Consulta API Reports.

Funzionalità ibride di Apigee

La seguente tabella riassume le funzionalità ibride:

Servizio area ibrida
Analytics Un pod di raccolta dati nel piano di runtime utilizza fluentd e UDCA (agente di raccolta dati universale) per raccogliere dati analitici e inviare i dati alla piattaforma UAP (Unified Analytics Platform) nel piano di gestione.
Gateway proxy API Il Processore di messaggi (MP) elabora le richieste in entrata. I file MP vengono implementati come una o più app containerizzate nel piano di runtime.
Persistenza Cassandra fornisce persistenza per le funzionalità KMS, KVM, quota e cache.
Deployment Lo strumento Sincronizzatore garantisce che le configurazioni del proxy API, le informazioni sull'ambiente e altri dati siano sempre aggiornati tra il piano di gestione e il piano di runtime.
Interfaccia utente amministrativa L'UI di Apigee è un'app containerizzata ospitata sul piano di gestione.
Bilanciamento del carico Un controller Istio Ingress invia le richieste all'app containerizzata Router/processore di messaggi (RMP) nel piano di runtime.
API Le API Apigee sono accessibili tramite il server di gestione e MART. MART interagisce con il datastore locale Cassandra e funge da provider di API per consentire alle API Apigee di accedere e gestire le entità di dati di runtime.
Metriche Gestito da un singolo server Prometheus per cluster per tutti i servizi.