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.

Nella tabella seguente sono elencati 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 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 hybrid).

Funzionalità Supporto in Apigee e in hybrid
Revisioni proxy API

Immutabile dopo il deployment
Adattatore Apigee per 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 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ò 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 si aspettano che le maiuscole vengano conservate.

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 l'attributo private. non è utilizzato, la KVM è ancora criptato; tuttavia, le informazioni KVM appariranno decriptate nella Trace di debug) sessione e non verranno presentate eccezioni.
  • Puoi gestire le voci KVM utilizzando API keyvaluemaps.entries o il criterio KeyValueMapOperations.
  • Puoi utilizzare i set di proprietà per alcuni degli stessi casi d'uso delle KVM. Consulta: Utilizzo degli insiemi 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 KVM nell'interfaccia utente, consulta Utilizzo delle 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 stesso 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 risorse a livello di organizzazione
Ruoli e autorizzazioni
  • Gestito 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 ulteriori informazioni, vedi 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.
  • 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 di Trace/Debug

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

Funzionalità Apigee e supporto ibrido
Tempestività Leggero ritardo; 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. Accedi a qualsiasi variabile di flusso menzionata nel riferimento alle variabili di flusso. La sintassi è la stessa utilizzata con i condizionali, come mostrato nel riferimento alle condizioni.
Timeout sessione

Definisce solo la durata della sessione di debug. Il punto di partenza è quando l'oggetto Il processore 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 la sessione è stata avviata è 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 elaboratore di messaggi; il valore massimo è 15.
API Apigee espone API Debug Session e API Debug Session Data

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 di eliminazione della cache Resi: 204 No Content
Operazioni dell'API Cache Elenco 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: 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 (Universal Data Collection Agent) per raccogliere dati e analisi e invia i dati alla UAP (Unified Analytics Platform) nella aereo.
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 Lo strumento Sincronizzatore garantisce che l'ambiente e le configurazioni del proxy API e altri dati vengono mantenuti aggiornati tra il piano di gestione e il aereo.
Interfaccia utente amministrativa L'interfaccia utente di Apigee è un'app containerizzata ospitata nel piano di gestione.
Bilanciamento del carico Un controller Istio Ingress invia le richieste alla 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 locale Cassandra e funge da provider di API per consentire alle API Apigee di accedere e per gestire le entità dati di runtime.
Metriche Gestito da un singolo server Prometheus per cluster per tutti i servizi.