Panoramica delle funzionalità tecniche di Apigee

Questa pagina si applica ad Apigee e Apigee hybrid.

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 che vengono confrontati in questo argomento:

Prodotto Dove è ospitato Gestito da
Apigee Google Cloud Apigee
Apigee hybrid Sia Google Cloud che il data center privato del cliente Apigee gestisce il piano di gestione, mentre 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 dei proxy API

Immutabile durante il deployment
Adattatore Apigee per Istio Deprecato: ti consigliamo di utilizzare invece Apigee Adapter for Envoy.
Organizzazione app Organizza le app utilizzando AppGroups o associazioni sviluppatore-app. Vedi Organizzazione della 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 l'interfaccia utente e le API di Apigee
  • Flessibilità nella topologia di pubblicazione
  • Un pod MP può gestire un solo 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 unari a un server di destinazione gRPC. Consulta la pagina relativa alla creazione di proxy API gRPC.
Maiuscole nel nome del campo dell'intestazione HTTP/1.1

Converte i nomi dei campi dell'intestazione HTTP/1.1 in lettere minuscole quando vengono inoltrati al backend. Questo comportamento potrebbe influire sulle applicazioni per cui è previsto che il caso venga conservato.

Keystore/truststore
  • Gestiti in direzione nord come secret di Kubernetes
KVM
  • Puoi creare KVM criptati con ambito a livello di ambiente nell'interfaccia utente 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 della KVM in una sessione di debug (Trace). Se l'attributo private. non viene utilizzato, il KVM è comunque criptato; tuttavia, le informazioni KVM appariranno decriptate nella sessione di Trace di debug e non verranno generate eccezioni.
  • Puoi gestire le voci KVM utilizzando l'API keyvaluemaps.entries o il criterio KeyValueMapOperations.
  • Puoi usare i set di proprietà per alcuni degli stessi casi d'uso dei KVM. Consulta Utilizzo dei set di proprietà.
  • L'elemento <MapName> consente al criterio KeyValueMapOperations di identificare quale KVM utilizzare in modo dinamico, in fase di runtime.

Per maggiori informazioni sulla creazione di KVM nell'interfaccia utente, consulta Utilizzo delle mappe chiave-valore. Vedi 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 stesso o diverso)
OAuth Il nuovo criterio RevocavOAuthv2 consente di revocare in base all'ID utente finale, all'ID app o a entrambi.
Norme Consulta la panoramica delle norme.
Risorse Impossibile utilizzare le risorse a livello di organizzazione
Ruoli e autorizzazioni
  • Funzionalità gestita tramite il servizio IAM della console Google Cloud
  • Sono disponibili alcuni ruoli predefiniti selezionati
  • Puoi creare ruoli personalizzati che possono includere altre autorizzazioni di Google Cloud

Per maggiori informazioni, consulta Utenti e ruoli.
Servizi SOAP nella procedura guidata per la creazione di un proxy Non supportati. Consulta wsdl2apigee, un progetto open source che fornisce utilità SOAP da utilizzare con Apigee.
Sessioni di traccia e debug Consulta l'assistenza Trace.
Host virtuali

Per il modello ibrido:

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

Per Apigee:

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

Supporto per Trace/Debug

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

Selezione delle Supporto Apigee e ibrido
Tempestività Leggero ritardo; asincrono
Nome/ID sessione Non accetta il nome della sessione da parte dell'utente
Filtri Supporto per logica di filtro complessa, incluse operazioni logiche AND e OR. Accesso a qualsiasi variabile di flusso menzionata nel riferimento per le variabili di flusso. La sintassi è la stessa utilizzata per le condizioni, come mostrato nel riferimento sulle condizioni.
Timeout sessione

Definisce solo la durata della sessione di debug. Il punto di partenza è il momento in cui 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 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 sincronizzatitori possono ignorare la richiesta di creazione della sessione. Assicurati di tenere sincronizzati gli orologi dei tuoi programmi di sincronizzazione, come descritto nella sezione Prerequisiti.
Numero richieste di traccia 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à Apigee.

Comportamento API Apigee
Dominio di base apigee.googleapis.com
Tipi di contenuti multimediali 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 ricerca preceduti dal trattino basso Non supportate (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 Elenco ed elimina. La cache L1 di breve durata viene creata automaticamente quando esegui il deployment di un proxy API. Per maggiori informazioni, consulta Dati interni della cache.

API per le metriche Apigee

Riepilogo delle API delle 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 è stata omessa dalla risposta. Vedi Metodo: organizations.environments.queries.list.
API dei 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 (Universal Data Collection Agent) per raccogliere dati e inviare i dati all'UAP (Unified Analytics Platform) nel piano di gestione.
Gateway proxy API Il Processore di messaggi (MP) elabora le richieste in arrivo. Gli MP sono implementati come una o più app containerizzate nel piano di runtime.
Persistenza Cassandra fornisce persistenza per le funzionalità KMS, KVM, quota e cache.
Deployment Il 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 passa le richieste all'app containerizzata Router/processore di messaggi (RMP) nel piano di runtime.
API È possibile accedere alle API Apigee tramite il server di gestione e MART. MART interagisce con il datastore locale Cassandra e funge da provider di API per le API Apigee di accedere e gestire le entità di dati di runtime.
Metriche Gestiti da un singolo server Prometheus per cluster per tutti i servizi.