Glossario

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza 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 è composta da un percorso di base e da un insieme di risorse (chiamato anche percorsi delle risorse). Per ogni API devi definire un singolo URL principale (chiamato anche il percorso di base e più dei percorsi delle risorse. Un'API può essere considerata semplicemente come un insieme di URI, che condividono tutti di base comune. Per semplificare la gestione delle API, Apigee integra questi URI non elaborati con nomi visualizzati e descrizioni.
Consumer dell'API
Sinonimi di sviluppatore di app, che utilizza le API create da un fornitore di API.
Sviluppatore di API
Uno sviluppatore di software in un'organizzazione di provider di API che crea API. Queste API vengono utilizzate dagli sviluppatori di app (consumer di API) per creare app.
Prodotto API
Una raccolta di risorse API (URI) combinata con un piano di servizio e presentata a per gli sviluppatori in un pacchetto. Il prodotto API può anche includere alcuni metadati specifici del tuo attività di monitoraggio o analisi. Una o più risorse possono essere monetizzate includendo in un prodotto API, che possono poi essere raggruppate 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 facciata per l'API esistente. Invece di chiamare i tuoi dati gli sviluppatori iniziano a chiamare la nuova API generata da Apigee. Questa facciata disaccoppia a un'interfaccia pubblica dall'API di backend, proteggendo gli sviluppatori dalle modifiche al backend, consentendoti di innovare a livello perimetrale senza influire sui team di sviluppo interni. Come se apporti modifiche al backend, gli sviluppatori continuano a chiamare la stessa API senza interruzioni. In più scenari avanzati, Apigee ti consente di esporre più interfacce alla stessa API, liberandoti personalizzare la firma di un'API per soddisfare le esigenze di varie nicchie di sviluppatori contemporaneamente.
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 aggiornare 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
Nel caso di uno sviluppatore con pagamento anticipato, il saldo nell'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 uno StatefulSet che richiede molte risorse e dovrebbe essere in separato dal nodo worker dal processore di messaggi.

Per ulteriori informazioni, consulta Informazioni sul piano di runtime.

infrastruttura di gestione centrale (o piano)
Vedi Piano di gestione.
immagine container[ized]
Guarda l'immagine.
piano di controllo
Vedi Piano di gestione.

D

deploy

In Apigee, esegui il deployment 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: creare i proxy API e applicare criteri.
  • Sviluppatori di applicazioni: creano 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 applicabile a uno sviluppatore specifico e disponibile per l'acquisto solo da parte di lo sviluppatore.

E

ambiente

Un ambiente Apigee è un ambiente software isolato all'interno di un'organizzazione in cui esegui il deployment 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 proxy API di chiamata in qualsiasi ambiente del gruppo.

limite esplicito
Vedi limite personalizzato.

V

GCR
Repository dei container Google.
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 al saldo prepagato dello sviluppatore) impostato dalla monetizzazione.
Ingress/controller Ingress
Un'app containerizzata che instrada il traffico dall'esterno ai servizi al suo interno.

K

KMS
Key Management Service. Archivia, gestisce e presenta le chiavi e OAuth per criptare e decriptare il traffico. KMS di Apigee gestisce le chiavi per app, sviluppatori e prodotti API.
KVM
Mappa dei valori chiave. Una raccolta personalizzata di coppie chiave/valore di stringa criptato o non criptato. Per ulteriori informazioni, consulta Utilizzare le mappe chiave-valore.
Macchina di amministrazione Kubernetes
La macchina locale che utilizzi per eseguire i comandi sul tuo cluster Kubernetes. Questo è in genere una macchina desktop che ha accesso alle 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 l'ambiente datastore di runtime (Cassandra). Funge da provider di API per l'API Apigee pubblica per accedere e gestire i dati di runtime.

MART è un'applicazione stateless come i processori di messaggi. Si tratta di un'app containerizzata Kubernetes.

Per ulteriori informazioni, consulta la sezione Informazioni sul piano di runtime.

Nodo master
Un termine Kubernetes per un nodo che include apiserver, cloud-controller-manager (CCM), scheduler e o 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 Message Processor 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.

monetizzazione
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 ricevuti i documenti di fatturazione finali pubblicato.
Kubernetes open source
L'implementazione di riferimento di Kubernetes. Consulta Kubernetes. Il runtime di Apigee hybrid viene eseguito su Kubernetes open source e su versioni di Kubernetes basate su open source conformi a CNCF.
organizzazione

Un container per tutte le entità in un account Apigee, inclusi proxy API, prodotti API, app, sviluppatori e pacchetti API. Questo documento utilizza termini organizzazione Apigee o organizzazione abilitata ibrida in modo intercambiabile.

Per installare e utilizzare Apigee o Apigee hybrid, devi avere un'organizzazione Apigee associato a un progetto Google Cloud. Ciò avviene quando crei l'organizzazione in un processo noto come il provisioning.

Un'organizzazione Apigee non è uguale a un'organizzazione Google Cloud. In caso di ambiguità, il documento deve specificare che organizzazione è un'organizzazione Apigee.

Per ulteriori informazioni, consulta la sezione Tipi di organizzazione.

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 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 il routing delle richieste all'endpoint corretto, formato dei messaggi, applicazione del controllo dell'accesso, chiamata a servizi remoti informazioni, mascherare i dati sensibili di utenti esterni, esaminare i contenuti dei messaggi per potenziali minacce, memorizzare nella cache risposte comuni per migliorare le prestazioni e così via. Le norme possono Essere eseguita in modo condizionale in base ai contenuti o al contesto di un messaggio di richiesta o risposta. Ad esempio, è possibile eseguire un criterio di trasformazione per personalizzare un formato di risposta se di richiesta è stato inviato da uno smartphone.
sviluppatore postpaid
Uno sviluppatore a cui viene addebitato un importo mensile per l'utilizzo di prodotti basati su 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'API proxy è un livello di astrazione che pone in primo piano API servizio di backend e fornisce funzionalità a valore aggiunto come sicurezza, limitazione di frequenza, quote, analisi e altro ancora.
endpoint proxy
Un endpoint proxy definisce la modalità di interazione del proxy API con il client diverse applicazioni. 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: Crea 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 API offerti in un pacchetto API monetizzato.
controller di replica
Ripianifica i pod e gestisce la riparazione automatica per i pod.
resource, resource path
Concetto di RESTful, un percorso di 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 nel tuo cluster Kubernetes esistono nel piano di runtime. Questi servizi comunicano gli account di servizio con il piano di gestione.

Sono inclusi MART, Synchronizer, Message Processors, Cassandra e altri componenti.

Per ulteriori informazioni, consulta la sezione 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.

S

servizio

Un termine generale per le app containerizzate in esecuzione sul tuo cluster Kubernetes nel piano di runtime. Questi servizi includono MART, Sincronizzatore, Processori di messaggi e Cassandra,

Per ulteriori informazioni, consulta Informazioni sul piano di runtime.

Nodo stateful
Un nodo cluster che richiede spazio di archiviazione permanente per essere mantenuto stato. Consulta Configurare 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 configurazione ed eventi del deployment 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 archivia le proprie informazioni in un file system condiviso letto dal processore di messaggi. Questo verrà eseguito come DaemonSet application; non ha traffico API runtime e può sincronizzare per più ambienti da un unico processo o pod Kubernetes.

Per ulteriori informazioni, consulta la sezione Informazioni sul piano di runtime.

T

endpoint di destinazione

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: Modifica del target endpoint.

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 che una transazione API è monetizzata o meno. Questa variabile può essere utilizzata per eseguire l'override del comportamento predefinito basato sullo stato HTTP le API nel tuo codice. Vedi Variabili di monetizzazione.

U

UAP

Piattaforma di analisi unificata. 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 Raccolta dei dati sullo stato di debug, analisi e deployment.

V

versione
La versione dell'interfaccia API rivolta agli sviluppatori. Ad esempio, pivotaltracker.com/services/v3, or api.enterprise.apigee.com/v1. (Questo termine è diverso revision, ovvero il pacchetto di configurazione numerato e con controllo della versione e i criteri integrati in un proxy API. In breve, le interfacce API hanno delle versioni, mentre le API i proxy hanno revisioni.
volume
Spazio di archiviazione condiviso che può essere utilizzato da tutti le applicazioni all'interno di un pod.