Glossario

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 e risorse dell'API
Un'API è costituita da un percorso di base e da un insieme di risorse (noti anche come percorsi delle risorse). Per ogni API, definisci un singolo URL radice (chiamato anche percorso di base) e più percorsi delle risorse. Puoi considerare un'API semplicemente come un insieme di URI, tutti con un percorso di base comune. Per semplificare la gestione delle API, Apigee aumenta questi URI non elaborati con nomi visualizzati e descrizioni.
API consumer
Sinonimo di sviluppatore di app, che utilizza le API create da un fornitore di API.
Sviluppatore di API
Un ingegnere software in un'organizzazione di provider 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 agli sviluppatori come bundle. Il prodotto API può includere anche alcuni metadati specifici per la tua attività per il monitoraggio o l'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) da utilizzare per i consumatori di API (sviluppatori di app).
Proxy API
Un proxy che funge da facciata per la tua API esistente. Anziché chiamare l'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 e consentendoti di innovare all'edge senza influire sui team di sviluppo interni. Man mano che 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, dandoti la libertà 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 provider API, in questo modo ottengono le chiavi API necessarie per chiamare i proxy API del provider.
app
Gli sviluppatori utilizzano le app per accedere alle risorse nei 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. Puoi controllare l'accesso ai bundle di risorse revocando o eliminando l'accesso ai prodotti in un'app.

B

dettagli del saldo
Per uno sviluppatore prepagato, il saldo nel suo account.

C

Cassandra

(Solo Apigee Hybrid) Il repository di dati di runtime che archivia le configurazioni delle applicazioni, i contatori di quote distribuiti, 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 separato dal processore di messaggi.

Per saperne di più, consulta Informazioni sul piano di runtime.

infrastruttura (o piano) di gestione centrale
Vedi management plane.
immagine containerizzata
Vedi l'immagine.
control plane
Vedi management plane.

D

deploy

In Apigee, esegui il deployment di un proxy API in un ambiente per renderlo accessibile ai client applicazione su internet, pubblicamente o privatamente, a seconda della configurazione di rete.

sviluppatore
Uno sviluppatore si riferisce a un ruolo che un utente Apigee può svolgere. Esistono due tipi di sviluppatori in Apigee:
  • Sviluppatori di proxy API: creano i proxy API e applicano i criteri.
  • Sviluppatori di applicazioni: creano applicazioni che utilizzano i proxy API.
Piano tariffario per categoria di sviluppatori
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 sviluppatori
Un piano tariffario che si applica a uno sviluppatore specifico ed è disponibile per l'acquisto solo da parte di questo sviluppatore.

E

ambiente

Un ambiente Apigee è un ambiente software isolato, all'interno di un'organizzazione, in cui esegui il deployment dei proxy API. L'ambiente può essere scalato per soddisfare le esigenze dei proxy lì implementati. 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 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 del 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. Archivia, gestisce e presenta chiavi e token OAuth per criptare e decriptare il traffico. Apigee KMS 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 saperne di più, consulta Utilizzo delle mappe chiave-valore.
Macchina di amministrazione Kubernetes
La macchina locale che utilizzi per eseguire comandi sul cluster Kubernetes. Questa macchina è in genere un computer desktop 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 service account.
MART

L'API per i dati di runtime interagisce con il datastore di runtime locale (Cassandra). Funge da fornitore di API per l'API Apigee pubblica per accedere ai dati di runtime e gestirli.

MART è un'applicazione stateless proprio come i processori di messaggi. È un'app containerizzata Kubernetes.

Per saperne di più, 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 processore di messaggi valuta una richiesta in entrata, esegue qualsiasi criterio Apigee e chiama i sistemi di backend e altri sistemi per recuperare i dati. Una volta ricevute queste risposte, ilprocessore di messaggir formatta una risposta e la restituisce al client.

Il MP è un deployment Kubernetes. È configurato per un singolo ambiente Apigee, che punta a una sottodirectory con ambito 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 separato da Cassandra.

Per saperne di più, consulta Informazioni sul piano di runtime.

monetizzazione
Un componente di Apigee che fornisce un modo semplice da usare e flessibile per monetizzare i prodotti API.
importo mensile utilizzato
L'utilizzo totale di uno sviluppatore per un determinato mese, che include la tariffa di configurazione + la tariffa di transazione + la tariffa ricorrente.
pagamenti mensili
I pagamenti ricorrenti effettuati da uno sviluppatore in base ai piani acquistati. I piani tariffari possono prevedere una tariffa ricorrente addebitata a uno sviluppatore ogni mese, indipendentemente dall'utilizzo.

N

spazio dei nomi
Cluster virtuali utilizzati per dividere le risorse del cluster. Gli spazi dei nomi sono destinati a cluster più grandi con molti utenti; i cluster più piccoli con solo decine di utenti in genere non hanno bisogno di spazi dei nomi.

O

apri aggiustamento
Un aggiustamento non ancora applicato nei documenti di fatturazione pubblicati.
mese di fatturazione aperto
Un mese di calendario completo per il quale non sono stati pubblicati i documenti di fatturazione finali.
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 contenitore per tutte le entità in un account Apigee, inclusi proxy API, prodotti API, pacchetti API, app e sviluppatori. Questo documento utilizza in modo intercambiabile i termini organizzazione Apigee o organizzazione abilitata all'ibrido.

Per installare e utilizzare Apigee o Apigee hybrid, devi disporre di un'organizzazione Apigee associata a un progetto Google Cloud. Lo fai quando crei l'organizzazione in un processo noto come provisioning.

Un'organizzazione Apigee non è la stessa di un'organizzazione Google Cloud. Nei casi in cui esiste la possibilità di ambiguità, questo documento deve specificare che l'organizzazione è un'organizzazione Apigee.

Per saperne di più, consulta 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 crei o di cui esegui il deployment. Un pod rappresenta un processo in esecuzione sul tuo cluster.
saldo prepagato
Un importo disponibile per uno sviluppatore prepagato per pagare in anticipo i pacchetti API.
prepaid developer
Uno sviluppatore che paga in anticipo l'utilizzo di un prodotto API. I fondi vengono detratti dal saldo prepagato dello sviluppatore quando viene utilizzato il prodotto API. Lo sviluppatore deve mantenere un saldo prepagato sufficiente per acquistare il prodotto API. Agli sviluppatori viene assegnato lo stato prepagato o postpagato dal fornitore dell'API.
policy
Un passaggio di elaborazione che viene eseguito come unità di logica atomica e riutilizzabile all'interno di un flusso API. I criteri tipici includono l'instradamento delle richieste all'endpoint corretto, la trasformazione di un formato del messaggio, l'applicazione del controllo dell'accesso, la chiamata di servizi remoti per ulteriori informazioni, la mascheratura dei dati sensibili per gli 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. Le norme possono essere eseguite in modo condizionale in base al contenuto 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 il messaggio di richiesta è stato inviato da uno smartphone.
postpaid developer
Uno sviluppatore a cui viene addebitato un costo 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. Agli sviluppatori viene assegnato lo stato postpagato o prepagato dal fornitore di API.
proxy
Vedi anche proxy API. Un proxy API è un livello di astrazione che funge da frontend per le API del 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 il modo in cui il proxy API interagisce con le applicazioni client. Configura l'endpoint proxy con un basepath 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, degli altri addebiti e della quota di condivisione delle entrate per l'utilizzo di prodotti API offerti in un pacchetto API monetizzato.
controller di replica
Ripianifica i pod e gestisce l'autoriparazione dei pod.
risorsa, percorso della risorsa
Un concetto 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 si distingue da versione, che è l'interfaccia API rivolta agli sviluppatori. Vedi "versione" di seguito.
piano di runtime

I servizi Apigee hybrid che gestisci sul tuo cluster Kubernetes esistono all'interno del piano di runtime. Questi servizi comunicano tramite service account con il management plane.

Include MART, Synchronizer, Message Processors, Cassandra e altri componenti.

Per saperne di più, 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, fornendo così un'alta disponibilità per i proxy API in tutte le regioni.

S

servizio

Un termine generale per le app containerizzate in esecuzione sul cluster Kubernetes nel piano di runtime. Questi servizi includono MART, Synchronizer, Message Processors e Cassandra.

Per saperne di più, consulta Informazioni sul piano di runtime.

nodo stateful
Un nodo del cluster che richiede uno spazio di archiviazione permanente per mantenere lo stato. Consulta Configurazione dei pool di nodi dedicati.
nodo stateless
Un nodo del cluster che non richiede spazio di archiviazione permanente. Consulta Configurazione dei pool di nodi dedicati.
Sincronizzatore

Un servizio del piano di runtime che esegue il polling del piano di gestione per la configurazione e gli eventi di deployment per ogni ambiente. Scarica i metadati richiesti sui proxy di cui è stato eseguito il deployment, i file di configurazione del proxy e altro ancora nel piano di runtime.

Synchronizer memorizza le informazioni su un file system condiviso che processore di messaggi legge. 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 saperne di più, consulta Informazioni sul piano di runtime.

T

endpoint di destinazione

Un endpoint di destinazione definisce il modo in cui il proxy API interagisce con i servizi di backend. Configuri l'endpoint di destinazione per 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 dell'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 ignorare il comportamento predefinito basato sul codice di stato HTTP. Vedi Variabili di monetizzazione.

U

UAP

Piattaforma di analisi unificata. Un servizio Apigee nel piano di gestione che elabora i dati in entrata di analisi, debug e stato del deployment e li rende disponibili tramite la UI ibrida di Apigee o le API Apigee.

Per ulteriori informazioni, consulta Raccolta dei dati di debug, analisi e stato dell'implementazione.

UDCA

Universal Data Collection Agent. Un servizio in esecuzione all'interno del pod di raccolta dei dati nel piano di runtime che estrae i dati di analisi, debug e stato di deployment e li invia a UAP.

Per ulteriori informazioni, consulta Raccolta dei dati di debug, analisi e stato dell'implementazione.

V

Versione
La versione dell'interfaccia API rivolta agli sviluppatori. Ad esempio, pivotaltracker.com/services/v3, or api.enterprise.apigee.com/v1. Questo termine si distingue da revision, ovvero il pacchetto numerato e controllato dalla versione di configurazione e delle norme raggruppate 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 containerizzate all'interno di un pod.