Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di
Apigee Edge.
I seguenti concetti sono idee comuni che hanno un significato unico in Apigee.
A
- Percorso di base dell'API e risorse
- Un'API è costituita da un percorso base e da un insieme di risorse (noto anche come percorsi risorse). Per ogni API, definisci un singolo URL principale (chiamato anche percorso di base) e più percorsi delle risorse. Puoi considerare un'API semplicemente come un insieme di URI, che condividono tutti un percorso di base comune. Per semplificare la gestione delle API, Apigee integra questi URI non elaborati con nomi visualizzati e descrizioni.
- Consumer API
- Sinonimi di sviluppatore di app, che utilizza le API create da un fornitore di API.
- Sviluppatore di API
- Uno sviluppatore software in un'organizzazione di provider di API che crea API. Queste API vengono utilizzate dagli sviluppatori di app (consumatori di API) per creare app.
- Prodotto API
- Una raccolta di risorse API (URI) combinate con un piano di servizio e presentata agli sviluppatori come un pacchetto. Il prodotto API può includere anche alcuni metadati specifici per la tua attività per il monitoraggio o le analisi. Una o più risorse possono essere monetizzate includendole in un prodotto API, che può poi essere raggruppato in un pacchetto API per la monetizzazione.
- Fornitore di API
- Un fornitore di API crea API (utilizzando Apigee) per i consumatori di API (sviluppatori di app).
- Proxy API
- Un proxy che funge da facade per la tua API esistente. Anziché chiamare la tua API esistente, gli sviluppatori iniziano a chiamare la nuova API generata da Apigee. Questa facciata disaccoppia l'interfaccia pubblica dall'API di backend, proteggendo gli sviluppatori dalle modifiche al backend, ma consente al contempo di innovare all'edge senza influire sui team di sviluppo interni. Mentre apporti modifiche al backend, gli sviluppatori continuano a chiamare la stessa API senza interruzioni. In scenari più avanzati, Apigee ti consente di esporre più interfacce alla stessa API, liberandoti di personalizzare la firma di un'API per soddisfare contemporaneamente le esigenze di varie nicchie di sviluppatori.
- API Apigee
- Gli endpoint che puoi utilizzare per configurare ambienti, organizzazioni, proxy API e altri servizi ibridi.
- sviluppatore di app
- Gli sviluppatori di app registrano le loro app con un fornitore di API, in modo da ottenere le chiavi API necessarie per chiamare i proxy API del fornitore.
- app
- Gli sviluppatori utilizzano le app per accedere alle risorse dei tuoi prodotti API. Quando crei un'app, selezioni il prodotto API da includere e Apigee genera una chiave. Ogni app ha una singola chiave che fornisce l'accesso a più prodotti API. Le app ti consentono di controllare chi può accedere alle tue risorse. Puoi controllare chi ha accesso ai tuoi prodotti API revocando e aggiornando la chiave di un'app. Inoltre, puoi controllare l'accesso a pacchetti di risorse revocando o eliminando l'accesso ai prodotti in un'app.
B
- dettagli del saldo
- Per uno sviluppatore con pagamento anticipato, il saldo dell'account dello sviluppatore.
C
- Cassandra
(Solo Apigee Hybrid) Il repository dei dati di runtime che archivia le configurazioni delle applicazioni, i contatori delle quote distribuite, le chiavi API e i token OAuth per le applicazioni in esecuzione sul gateway.
Si tratta di un StatefulSet che richiede molte risorse e deve trovarsi su un nodo worker distinto da quello del processore di messaggi.
Per ulteriori informazioni, consulta Informazioni sul piano di runtime.
- Infrastruttura (o piano) di gestione centralizzata
- Consulta la sezione Piano di gestione.
- immagine containerizzata
- Guarda l'immagine.
- Control plane
- Consulta la sezione Piano di gestione.
D
- deploy
In Apigee, deploy di un proxy API in un ambiente per renderlo accessibile ai client di applicazioni su internet, in modo pubblico o privato, a seconda della configurazione della rete.
- sviluppatore
- Uno sviluppatore si riferisce a un ruolo che un utente Apigee potrebbe svolgere.
In Apigee esistono due tipi di sviluppatori:
- Sviluppatori di proxy API: creano i proxy API e applicano le norme.
- Sviluppatori di applicazioni: crea applicazioni che utilizzano i proxy API.
- piano tariffario per categoria di sviluppatore
- Un piano tariffario che si applica a tutti gli sviluppatori di una categoria specifica ed è disponibile per l'acquisto da parte di tutti gli sviluppatori di quella categoria.
- piano tariffario per gli sviluppatori
- Un piano tariffario che si applica a uno sviluppatore specifico ed è disponibile per l'acquisto solo da parte di quel determinato sviluppatore.
E
- ambiente
Un ambiente Apigee è un ambiente software isolato all'interno di un'organizzazione in cui deploy di proxy API. L'ambiente può essere scalato per soddisfare le esigenze dei proxy di cui è stato eseguito il deployment. Puoi creare più ambienti in un'organizzazione.
- gruppo di ambienti
-
Un gruppo di ambienti è un gruppo di ambienti Apigee con uno o più nomi host. Il nome host fa parte dell'URL utilizzato per chiamare i proxy API di cui è stato eseguito il deployment in qualsiasi ambiente del gruppo di ambienti.
- limite esplicito
- Vedi limite personalizzato.
V
- GCR
- Google Container Repository.
- GKE
- Google Kubernetes Engine. Un ambiente gestito da Google e pronto per la produzione per il deployment di applicazioni containerizzate in Kubernetes. GKE ti consente di raggiungere uno stato di completa operatività con Kubernetes in pochissimo tempo, eliminando completamente la necessità di installare, gestire e utilizzare i tuoi cluster Kubernetes.
I
- repository di immagini
- Un gruppo di immagini container condivise.
- limite implicito
- Un limite (ad esempio un limite di saldo prepagato dello sviluppatore) impostato dalla monetizzazione.
- Ingress/controller Ingress
- Un'app containerizzata che instrada il traffico dall'esterno del cluster ai servizi all'interno del cluster.
K
- KMS
- Key Management Service. Memorizza, gestisce e presenta chiavi e token OAuth per criptare e decriptare il traffico. KMS di Apigee gestisce le chiavi per app, sviluppatori e prodotti API.
- KVM
- Mappa chiave-valore. Una raccolta personalizzata di coppie di stringhe chiave/valore criptate o non criptate. Per ulteriori informazioni, consulta Utilizzare le mappe chiave-valore.
- Macchina di amministrazione Kubernetes
- La tua macchina locale che utilizzi per eseguire comandi sul cluster Kubernetes. Questa macchina è in genere un computer che ha accesso alle tue VM Kubernetes.
M
- piano di gestione
- I servizi centrali ospitati da Google che comunicano con il piano di runtime tramite gli account di servizio.
- MART
L'API per i dati di runtime interagisce con il datastore di runtime locale (Cassandra). Funge da provider di API per l'API Apigee pubblica per accedere e gestire i dati di runtime.
MART è un'applicazione stateless, proprio come i Message Processor. Si tratta di un'app containerizzata Kubernetes.
Per ulteriori informazioni, consulta Informazioni sul piano di runtime.
- Nodo master
- Un termine Kubernetes per un nodo che include apiserver, cloud-controller-manager (CCM), scheduler e kube-controller-manager.
- processore di messaggi
-
(Solo Apigee hybrid) Il Message Processor valuta una richiesta in arrivo, esegue eventuali criteri Apigee e chiama i sistemi di backend e altri sistemi per recuperare i dati. Una volta ricevute queste risposte, il processore di messaggi formatta una risposta e la restituisce al client.
L'MP è un deployment Kubernetes. È configurato per un singolo ambiente Apigee e rimanda a una sottodirectory basata sugli ambiti all'interno del file system condiviso a cui il sincronizzatore fornisce i dati.
Un MP richiede molte risorse e deve trovarsi su un nodo worker distinto da Cassandra.
Per ulteriori informazioni, consulta Informazioni sul piano di runtime.
- monetization
- Un componente di Apigee che offre un modo semplice e flessibile per monetizzare i prodotti API.
- importo mensile utilizzato
- L'utilizzo totale di uno sviluppatore per un determinato mese, che include la commissione di configurazione + la commissione di transazione + la commissione ricorrente.
- pagamenti mensili
- I pagamenti ricorrenti effettuati da uno sviluppatore in base ai piani acquistati. I piani tariffari possono avere una commissione ricorrente addebitata a uno sviluppatore ogni mese, indipendentemente dall'utilizzo.
N
- spazio dei nomi
- Cluster virtuali utilizzati per suddividere le risorse del cluster. Gli spazi dei nomi sono destinati a cluster più grandi con molti utenti; in genere, i cluster più piccoli con solo alcune decine di utenti non richiedono spazi dei nomi.
O
- apri aggiustamento
- Un aggiustamento che non è stato ancora applicato nei documenti di fatturazione pubblicati.
- open billing month
- Un mese di calendario completo per il quale non sono stati pubblicati i documenti di fatturazione definitivi.
- Kubernetes open source
- L'implementazione di riferimento di Kubernetes. Consulta Kubernetes. Il runtime Apigee hybrid viene eseguito su Kubernetes open source e su versioni di Kubernetes basate su open source conformi a CNCF.
- organizzazione
Un contenitore per tutte le entità di un account Apigee, inclusi proxy API, prodotti API, pacchetti API, app e sviluppatori. Questo documento utilizza i termini organizzazione Apigee o organizzazione abilitata all'uso ibrido in modo intercambiabile.
Per installare e utilizzare Apigee o Apigee hybrid, devi disporre di un'organizzazione Apigee associata a un progetto Google Cloud. Questo avviene quando crei l'organizzazione in un processo noto come provisioning.
Un'organizzazione Apigee non è uguale a un'organizzazione Google Cloud. Se esiste la possibilità di ambiguità, questo documento deve specificare che l'organizzazione è un'organizzazione Apigee.
Per saperne di più, consulta Tipi di organizzazioni.
P
- pod
- Un pod è l'elemento di base di Kubernetes: l'unità più piccola e semplice nel modello a oggetti di Kubernetes che puoi creare o di cui puoi eseguire il deployment. Un pod rappresenta un processo in esecuzione sul tuo cluster.
- saldo prepagato
- Un importo di denaro disponibile per uno sviluppatore prepagato da pagare in anticipo per i pacchetti di API.
- sviluppatore con abbonamento prepagato
- Uno sviluppatore che paga in anticipo per l'utilizzo di un prodotto API. I fondi vengono detratti dal saldo di uno sviluppatore con abbonamento prepagato quando viene utilizzato il prodotto API. Lo sviluppatore deve mantenere un saldo prepagato sufficiente per acquistare il prodotto API. Gli sviluppatori vengono assegnati allo stato prepagato o postpaid dal fornitore dell'API.
- norme
- Un passaggio di elaborazione che viene eseguito come unità di logica atomica e riutilizzabile all'interno di un flusso dell'API. I criteri tipici includono l'indirizzamento delle richieste all'endpoint appropriato, la trasformazione di un formato di messaggio, l'applicazione del controllo dell'accesso, la chiamata di servizi remoti per ulteriori informazioni, il mascheramento di dati sensibili da utenti esterni, l'esame dei contenuti dei messaggi per potenziali minacce, la memorizzazione nella cache delle risposte comuni per migliorare le prestazioni e così via. I criteri possono essere eseguiti in modo condizionale in base ai contenuti o al contesto di una richiesta o di un messaggio di risposta. Ad esempio, è possibile eseguire un criterio di trasformazione per personalizzare un formato di risposta se il messaggio di richiesta è stato inviato da uno smartphone.
- sviluppatore postpaid
- Uno sviluppatore a cui viene addebitato mensilmente l'utilizzo dei prodotti API. Lo sviluppatore paga l'utilizzo dei prodotti API in base ai termini di pagamento stabiliti dai piani tariffari. Gli sviluppatori vengono assegnati allo stato postpaid o prepagato dal fornitore di API.
- proxy
- Vedi anche proxy API. Un proxy API è un livello di astrazione che rappresenta le API dei tuoi servizio di backend e fornisce funzionalità con valore aggiunto come sicurezza, limitazione di frequenza, quote, analisi e altro ancora.
- endpoint proxy
- Un endpoint proxy definisce il modo in cui il proxy API interagisce con le applicazioni client. Configura l'endpoint del proxy con un percorso di base
che fa parte dell'URL a cui risponde il proxy API.
L'URL ha il formato
https://hostname/basepath/pathsuffixes. Consulta Creare un proxy API.
R
- piano tariffario
- Una specifica delle commissioni, di altri addebiti e della quota di condivisione delle entrate per l'utilizzo dei prodotti basati su API offerti in un pacchetto API monetizzato.
- controller di replica
- Riprogramma i pod e gestisce la riparazione automatica per i pod.
- resource, resource path
- Un concetto RESTful, un percorso della risorsa è un URI (Uniform Resource Identifier) che identifica il percorso di rete di una determinata risorsa.
- revisione
- Un pacchetto numerato e controllato dalla versione di configurazione e criteri raggruppati in un proxy API. Questo termine è distinto da versione, che è l'interfaccia API rivolta agli sviluppatori. Vedi "version" di seguito.
- Piano di runtime
I servizi Apigee hybrid che gestisci sul tuo cluster Kubernetes esistono nel piano di runtime. Questi servizi comunicano tramite account di servizio con il piano di gestione.
Sono inclusi MART, Synchronizer, Message Processors, Cassandra e altri componenti.
Per ulteriori informazioni, consulta Informazioni sul piano di runtime.
- istanza di runtime
- Apigee può essere configurato con più istanze di runtime, una per regione geografica. Uno o più ambienti possono essere collegati a un'istanza di runtime, in modo da garantire una disponibilità elevata per i proxy API nelle varie regioni.
- servizio
Un termine generale per le app containerizzate in esecuzione sul tuo cluster Kubernetes nel piano di runtime. Questi servizi includono MART, Synchronizer, Message Processors e Cassandra.
Per ulteriori informazioni, consulta Informazioni sul piano di runtime.
- Nodo stateful
- Un nodo del cluster che richiede uno spazio di archiviazione permanente per mantenere lo stato. Consulta Configurare i pool di nodi dedicati.
- Nodo stateless
- Un nodo cluster che non richiede archiviazione permanente. Consulta Configurare i pool di nodi dedicati.
- Sincronizzatore
Un servizio del piano di runtime che esegue il polling del piano di gestione per la configurazione del deployment e gli eventi per ogni ambiente. Scarica i metadati richiesti sui proxy di cui è stato eseguito il deployment, i file di configurazione dei proxy e altro ancora nel piano di runtime.
Il Sincronizzatore memorizza le proprie informazioni in un file system condiviso letto da processore di messaggi. Verrà eseguito come applicazione DaemonSet; non ha traffico API di runtime e può sincronizzare i dati per più ambienti da un singolo processo/pod Kubernetes.
Per ulteriori informazioni, consulta Informazioni sul piano di runtime.
- endpoint target
Un endpoint di destinazione definisce il modo in cui il proxy API interagisce con i tuoi servizi di backend. Configura l'endpoint di destinazione in modo da inoltrare le richieste al servizio di backend corretto, inclusa la definizione delle impostazioni di sicurezza, del protocollo HTTP o HTTPS e di altre informazioni di connessione. Consulta Modificare l'endpoint di destinazione.
- ricarica
- L'azione intrapresa da uno sviluppatore prepagato per aggiungere fondi al saldo prepagato.
- transaction_success_def" id="transaction_success_def">transaction success La variabile di monetizzazione
- , se utilizzata, indica se una transazione API è monetizzata o meno. Questa variabile può essere utilizzata per sostituire il comportamento predefinito, che si basa sul codice di stato HTTP. Vedi Variabili di monetizzazione.
- UAP
Unified Analytics Platform. Un servizio Apigee nel piano di gestione che elabora i dati di analisi, debug e stato di deployment in entrata e li rende disponibili tramite l'interfaccia utente ibrida di Apigee o le API Apigee.
Per ulteriori informazioni, consulta la sezione Raccolta di dati di debug, analisi e stato di implementazione.
- UDCA
Universal Data Collection Agent. Un servizio in esecuzione nel pod di raccolta dei dati nel piano di runtime che estrae i dati di analisi, debug e stato di implementazione e li invia all'UAP.
Per ulteriori informazioni, consulta la sezione Raccolta di dati di debug, analisi e stato di implementazione.
- versione
- La versione dell'interfaccia API rivolta agli sviluppatori. Ad esempio,
pivotaltracker.com/services/v3, or api.enterprise.apigee.com/v1. Questo termine è diverso darevision, che è il pacchetto numerato e controllato dalla versione di configurazione e dei criteri raggruppati in un proxy API. In breve, le interfacce API hanno versioni, mentre i proxy API hanno revisioni. - volume
- Spazio di archiviazione condiviso che può essere utilizzato da tutte le applicazioni conteggiate in un pod.