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 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 Sia Google Cloud che 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 hybrid).

Funzionalità Supporto in Apigee e in hybrid
Revisioni del proxy API

Immutabile dopo il deployment

Apigee Adapter for Istio Ritirato: ti consigliamo di utilizzare invece l'adattatore Apigee per Envoy.
Organizzazione delle app Organizza le app utilizzando AppGroups o associazioni sviluppatore-app. Consulta Organizzare la proprietà delle app client.
Deployment
  • Deployment asincroni
  • Il recupero dello stato di deployment si basa sull'ultima volta che il piano di runtime è stato "check-in" con il piano di gestione
Ambienti
  • Supporto per i gruppi di ambienti
  • Self-service tramite le API e l'interfaccia utente di Apigee
  • Flessibilità nella topologia di pubblicazione
  • Un pod MP può servire solo un ambiente

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

Supporto dei proxy basati su gRPC

Elabora richieste API di protocollo gRPC univoche a un server di destinazione gRPC. Consulta Creare proxy API gRPC.

Maiuscole/minuscole dei nomi dei campi dell'intestazione HTTP/1.1

Converte i nomi dei campi delle intestazioni HTTP/1.1 in minuscolo quando vengono inoltrati al backend. Questo comportamento potrebbe influire sulle applicazioni che prevedono la conservazione della maiuscola.

Archivi chiavi/archivi attendibili
  • Connessioni in uscita gestite come secret Kubernetes
KVM
  • Puoi creare KVM criptate basate sull'ambiente nell'interfaccia utente 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 della KVM in una sessione di debug (Trace). Se non viene utilizzato l'attributo private., il KVM è ancora criptato; tuttavia, le informazioni KVM verranno decriptate nella sessione di Trace di debug) e non verrà lanciata alcuna eccezione.
  • 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 i set di proprietà.
  • L'elemento <MapName> consente al criterio KeyValueMapOperations di identificare quale KVM utilizzare in modo dinamico in fase di esecuzione.

Per ulteriori informazioni sulla creazione di mappe chiave-valore nell'interfaccia utente, consulta Utilizzare le mappe chiave-valore. Consulta anche Accedere ai dati di configurazione per informazioni su come scegliere il meccanismo di persistenza dei dati corretto.

Monetizzazione Consulta la 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 uguale o diverso)
OAuth Il nuovo criterio di revoca OAuth v2 esegue la revoca 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
  • Gestito 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, consulta 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 Consulta Assistenza per Trace.
Host virtuali

Per l'ibrido:

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

Per Apigee:

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

Supporto per Trace/il debug

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

Funzionalità Assistenza Apigee e ibrida
Puntualità Ritardo lieve; asincrono
Nome/ID sessione Non accetta il nome della sessione dall'utente
Filtri Supporto per la logica di filtro complessa, incluse le operazioni logiche AND e OR. Accesso a qualsiasi variabile di flusso indicata nel riferimento alle variabili di flusso. La sintassi è la stessa utilizzata con i condizionali, come mostrato nella documentazione di riferimento sulle 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 mantenuti per 24 ore prima che la modalità ibrida li elimini automaticamente.

Validità della sessione Periodo di tempo in cui 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.
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' Debug Session Data API

Panoramica dell'API

Di seguito sono riportate 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 sottotraccia 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 Solo Elenca e Elimina. La cache L1 di breve durata viene creata automaticamente quando esegui il deployment di un proxy API. Per ulteriori informazioni, consulta Informazioni interne sulla cache.

API di misurazione di Apigee

Riepilogo delle API di metriche Apigee:

Funzionalità API Apigee
endpoint API apigee.googleapis.com
Email di analisi giornaliere Nessuna API supportata
API Async Query List La proprietà userId viene omessa dalla risposta. Vedi Metodo: organizations.environments.queries.list.
API di report personalizzati Le proprietà createdBy e lastModifiedBy sono state rimosse dalla risposta. Vedi 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 inviarli alla UAP (Unified Analytics Platform) nel piano di gestione.
API Proxy Gateway Il Processore di messaggi (MP) elabora le richieste in arrivo. Gli MP 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 piano di gestione e il piano di runtime.
Interfaccia utente amministrativa L'interfaccia utente di Apigee è un'app containerizzata ospitata nel piano di gestione.
Bilanciamento del carico Un controller Istio Ingress inoltra le richieste all'app containerizzata Router/processore di messaggi (RMP) nel piano di runtime.
API Per accedere alle API Apigee è necessario utilizzare il server di gestione e MART. MART interagisce con il datastore Cassandra locale e funge da provider 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.