Glossario

Questa pagina si applica a Apigee e Apigee ibrido.

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 è composta da un percorso di base e da un insieme di risorse (noti anche come percorsi delle risorse). Per ogni API devi definire un singolo URL principale (chiamato anche percorso di base e più percorsi delle risorse. Un'API può essere considerata semplicemente come un insieme di URI, che condividono tutti un percorso di base comune. Per semplificare la gestione delle API, Apigee incrementa questi URI non elaborati con nomi visualizzati e descrizioni.
API consumer
Sinonimo di sviluppatore di app, che utilizza le API create da un provider API.
Sviluppatore di API
Un ingegnere informatico 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 agli sviluppatori come bundle. Il prodotto API può anche includere alcuni metadati specifici della tua attività per il monitoraggio o l'analisi. Una o più risorse possono essere monetizzate includendole in un prodotto API, che a sua volta può essere abbinato a un pacchetto API per la monetizzazione.
Provider API
Un provider 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 l'API esistente, gli sviluppatori iniziano a chiamare la nuova API generata da Apigee. Questa interfaccia disaccoppia l'interfaccia pubblica dall'API di backend, proteggendo gli sviluppatori dalle modifiche al backend e consentendoti di innovare a livello perimetrale senza conseguenze per i 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 consente di esporre più interfacce alla stessa API, liberandoti di personalizzare la firma di un'API per soddisfare le esigenze di diverse 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 proprie app con un provider API, ed è così che ottengono le chiavi API necessarie per chiamare i proxy API del provider.
app
I tuoi sviluppatori utilizzano le app per accedere alle risorse nei tuoi prodotti basati su 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 ai 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 di 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 utilizza molte risorse e dovrebbe trovarsi su un nodo worker separato 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 deploy di un proxy API in un ambiente per renderlo accessibile ai client delle applicazioni su internet, pubblicamente o privatamente, a seconda della configurazione di rete.

sviluppatore
Uno sviluppatore è un ruolo che un utente Apigee potrebbe eseguire. In Apigee esistono due tipi di sviluppatori:
  • Sviluppatori di proxy API: creare i proxy API e applicare criteri.
  • Sviluppatori di applicazioni: creare applicazioni che utilizzano proxy API.
Piano tariffario per categoria di sviluppatori
Un piano tariffario valido per tutti gli sviluppatori di una categoria specifica e che sia disponibile per l'acquisto da parte di tutti gli sviluppatori della categoria in questione.
piano tariffario sviluppatore
Un piano tariffario applicabile a uno specifico sviluppatore e disponibile per l'acquisto solo da parte di tale sviluppatore.

E

ambiente

Un ambiente Apigee è un ambiente software isolato, all'interno di un'organizzazione, in cui deploy dei proxy API. L'ambiente può scalare 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 nel gruppo di ambienti.

limite esplicito
Vedi il 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 permette di iniziare a lavorare 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.
Controller in entrata/in entrata
Un'app containerizzata che instrada il traffico dall'esterno del cluster ai servizi all'interno del cluster.

Mgl

KMS
Key Management Service. Archivia, gestisce e presenta chiavi e token OAuth per criptare e decriptare il traffico. Il KMS di Apigee gestisce le chiavi per app, sviluppatori e prodotti basati su API.
KVM
Mappa dei valori chiave. Una raccolta personalizzata di coppie di stringhe chiave/valore criptata o non criptata. Per maggiori informazioni, consulta Utilizzo delle mappe chiave-valore.
Macchina di amministrazione Kubernetes
La macchina locale che utilizzi per eseguire i comandi sul tuo cluster Kubernetes. Questa macchina è in genere una macchina desktop che ha accesso alle tue VM Kubernetes.

Lun

piano di gestione
I servizi centrali ospitati da Google che comunicano con il piano di runtime tramite account di servizio.
MART

L'API per i dati di runtime interagisce con il datastore di runtime locale (Cassandra). Serve da provider di API per le API Apigee pubbliche per accedere ai dati di runtime e gestirli.

MART è un'applicazione stateless proprio come i processori di messaggi. È 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 processore di messaggi valuta una richiesta in entrata, 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.

MP è un deployment Kubernetes. È configurato per un singolo ambiente Apigee che rimanda a una sottodirectory con ambito all'interno del file system condiviso a cui fornisce dati dal programma di sincronizzazione.

Una MP utilizza molte risorse e deve trovarsi su un nodo worker separato da Cassandra.

Per ulteriori informazioni, consulta Informazioni sul piano di runtime.

monetizzazione
Un componente di Apigee che fornisce un modo flessibile e facile da usare per monetizzare i prodotti API.
importo mensile utilizzato
L'utilizzo totale da parte di uno sviluppatore per un determinato mese, che include la commissione di configurazione + la commissione di transazione + la tariffa ricorrente.
pagamenti mensili
I pagamenti ricorrenti effettuati da uno sviluppatore in base ai piani acquistati. I piani tariffari possono avere una tariffa ricorrente che viene 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 per cluster più grandi con molti utenti; i cluster più piccoli con solo decine di utenti non hanno in genere 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 i documenti di fatturazione finali non sono stati pubblicati.
Kubernetes open source
L'implementazione di riferimento di Kubernetes. Vedi Kubernetes. Il runtime di Apigee hybrid viene eseguito su Kubernetes open source e su versioni open source di Kubernetes conformi a CNCF.
organizzazione

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

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

Un'organizzazione Apigee non è uguale a un'organizzazione Google Cloud. In caso di possibilità di ambiguità, il presente documento deve specificare che l'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 crei o di cui esegui il deployment. Un pod rappresenta un processo in esecuzione sul cluster.
saldo prepagato
Un importo di denaro disponibile per uno sviluppatore prepagato che può pagare in anticipo per i pacchetti 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 prepagato 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 posticipato dal provider API.
norme
Un passaggio di elaborazione che viene eseguito come un'unità atomica riutilizzabile di logica all'interno di un flusso API. I criteri tipici includono il routing delle richieste all'endpoint corretto, la trasformazione di un formato di messaggio, l'applicazione del controllo dell'accesso, la chiamata ai servizi remoti per ulteriori informazioni, il mascheramento di dati sensibili di 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 un messaggio di richiesta o risposta. Ad esempio, un criterio di trasformazione può essere eseguito per personalizzare un formato di risposta se il messaggio di richiesta è stato inviato da uno smartphone.
sviluppatore con pagamento posticipato
Uno sviluppatore a cui viene addebitato un importo mensile per l'utilizzo di prodotti basati su API. Lo sviluppatore paga l'utilizzo dei prodotti basati su API in base ai termini di pagamento stabiliti dai piani tariffari. Agli sviluppatori viene assegnato lo stato con pagamento posticipato o prepagato dal fornitore dell'API.
proxy
Anche proxy API. Un proxy API è un livello di astrazione che è anteriore alle API dei tuoi 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 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 tariffe, degli 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.
risorsa, percorso risorsa
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 con controllo della versione di configurazione e criteri raggruppati in un proxy API. Questo termine è distinto dalla versione, che è l'interfaccia API rivolta agli sviluppatori. Vedi "versione" di seguito.
piano di runtime

I servizi ibridi Apigee che gestisci sul tuo cluster Kubernetes esistono all'interno del piano di runtime. Questi servizi comunicano tramite account di servizio con il piano di gestione.

Include MART, Sincronizzatore, Processori di messaggi, 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. È possibile collegare uno o più ambienti a un'istanza di runtime, fornendo così disponibilità elevata per i proxy API nelle regioni.

S

esterno

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

Per ulteriori informazioni, consulta Informazioni sul piano di runtime.

nodo stateful
Un nodo cluster che richiede l'archiviazione permanente per mantenere lo stato. Consulta Configurare pool di nodi dedicati.
nodo stateless
Un nodo cluster che non richiede l'archiviazione permanente. Consulta Configurare 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 ciascun ambiente. Scarica i metadati richiesti sui proxy di cui è stato eseguito il deployment, sui file di configurazione proxy e altro ancora nel piano di runtime.

Il sincronizzatore archivia le proprie informazioni in un file system condiviso che legge il processore di messaggi. Verrà eseguita come applicazione DaemonSet; non ha traffico API di runtime e può sincronizzare i dati per più ambienti da un singolo processo o pod Kubernetes.

Per ulteriori informazioni, 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. Devi configurare l'endpoint di destinazione per inoltrare le richieste al servizio di backend appropriato, definendo le impostazioni di sicurezza, il protocollo HTTP o HTTPS e altre informazioni di connessione. Consulta Modificare l'endpoint di destinazione.

ricaricare
L'azione intrapresa da uno sviluppatore prepagato per aggiungere fondi al saldo prepagato.
transazioni_success_def" id="transaction_success_def">transazione riuscita
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 sul codice di stato HTTP. Consulta Variabili di monetizzazione.

U

Campagna sperimentale

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

Per ulteriori informazioni, consulta Raccolta dei dati sullo stato di debug, analisi e deployment.

UDCA

Agente Universal Data Collection. Un servizio in esecuzione all'interno del pod di raccolta dati nel piano di runtime che estrae i dati sullo stato di analisi, debug e deployment e li invia alla campagna universale per app.

Per ulteriori informazioni, consulta Raccolta dei dati sullo stato di debug, analisi e deployment.

V

La versione dell'interfaccia API rivolta agli sviluppatori. Ad esempio, pivotaltracker.com/services/v3, or api.enterprise.apigee.com/v1. Questo termine è distinto da revision, che è il pacchetto numerato e con controllo della versione di configurazione e criteri integrati in un proxy API. In breve, le interfacce API hanno una versione, 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.