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 e risorse di base dell'API
Un'API è composta da un percorso di base e da un insieme di risorse (note anche come percorsi delle risorse). Per ogni API, definisci un singolo URL principale (chiamato anche percorso di base e più percorsi delle risorse. Un'API può essere considerata semplicemente un insieme di URI, che condividono tutti un percorso di base comune. Per semplificare la gestione delle API, Apigee aumenta questi URI non elaborati con nomi visualizzati e descrizioni.
Consumer API
Sinonimo di sviluppatore di app, che utilizza le API create da un provider di API.
Sviluppatore di API
Un software engineer 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) combinate con un piano di servizio e presentate agli sviluppatori in un pacchetto. Il prodotto API può anche includere alcuni metadati specifici della tua attività per il monitoraggio o l'analisi. È possibile monetizzare una o più risorse includendole in un prodotto API, che può quindi essere aggregata in un pacchetto API per la monetizzazione.
Provider API
Un provider di API crea API (utilizzando Apigee) per i consumer di API (sviluppatori di app).
Proxy API
Un proxy che funge da facciata per l'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 permettendo al contempo di innovare a livello perimetrale 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, lasciandoti la possibilità di 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 proprie app con un provider di API, ovvero il modo in cui gli sviluppatori di app ricevono le chiavi API di cui hanno bisogno per chiamare i proxy API del provider.
app
I tuoi 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 prodotti API revocando e aggiornando la chiave di un'app. Inoltre, puoi controllare l'accesso a gruppi 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 ibrido) Il repository di dati di runtime che archivia le configurazioni delle applicazioni, i contatori di quote distribuite, le chiavi API e i token OAuth per le applicazioni in esecuzione sul gateway.

Si tratta di uno StatefulSet che richiede un uso intensivo di risorse e dovrebbe trovarsi su un nodo worker separato dal processore di messaggi.

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

infrastruttura di gestione centrale (o piano)
Vedi il piano di gestione.
immagine container[ized]
Vedi immagine.
piano di controllo
Vedi il piano di gestione.

D

deploy

In Apigee, 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
Per sviluppatore si intende un ruolo che un utente Apigee può svolgere. In Apigee esistono due tipi di sviluppatori:
  • Sviluppatori di proxy API: possono creare i proxy API e applicare i criteri.
  • Gli sviluppatori di applicazioni possono creare applicazioni che utilizzano 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 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 tale sviluppatore.

E

ambiente

Un ambiente Apigee è un ambiente software isolato all'interno di un'organizzazione, in cui deploy dei proxy API. L'ambiente è in grado di scalare per soddisfare le esigenze dei proxy di cui è stato eseguito il deployment. All'interno di un'organizzazione puoi creare più ambienti.

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.

G

GCR
Repository di container di Google.
GKE
Google Kubernetes Engine. Un ambiente gestito da Google e pronto per la produzione dedicato al deployment di applicazioni containerizzate in Kubernetes. GKE ti consente 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 del saldo prepagato dello sviluppatore) impostato dalla monetizzazione.
Controller Ingress/Ingress
Un'app containerizzata che instrada il traffico dall'esterno del cluster ai servizi all'interno del cluster.

Mgl

KMS
Servizio di gestione delle chiavi. 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 API.
KVM
Mappa coppia chiave-valore. Una raccolta personalizzata di coppie chiave/valore criptate o non criptate. Per maggiori informazioni, consulta la sezione 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.

M

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). Funge da provider di API per l'API Apigee pubblica per accedere ai dati di runtime e gestirli.

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

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

nodo master
Termine Kubernetes per un nodo che include apiserver, cloud-controller-manager (CCM), scheduler e kube-controller-manager.
processore di messaggi

(Solo Apigee ibrido) Il processore di messaggi valuta una richiesta in entrata, esegue tutti i criteri di Apigee e chiama i sistemi di backend e altri sistemi per recuperare i dati. Una volta ricevute le risposte, il processore di messaggi formatta una risposta e la restituisce al client.

L'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 dati.

Un MP utilizza molte risorse e dovrebbe trovarsi su un nodo worker separato da Cassandra.

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

monetizzazione
Un componente di Apigee che offre un modo flessibile e facile da usare per monetizzare i prodotti API.
importo mensile utilizzato
Utilizzo totale da parte di uno sviluppatore in un determinato mese, che include commissione di configurazione + commissione di transazione + commissione 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 suddividere le risorse del cluster. Gli spazi dei nomi sono destinati ai 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

aggiustamento aperto
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 documenti di fatturazione finali.
Kubernetes open source
L'implementazione di riferimento di Kubernetes. Vedi Kubernetes. Il runtime ibrido di Apigee 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, tra cui proxy API, prodotti API, pacchetti API, app e sviluppatori. Questo 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 legata a un progetto Google Cloud. Puoi eseguire questa operazione quando crei l'organizzazione in un processo noto come provisioning.

Un'organizzazione Apigee non è uguale a un'organizzazione Google Cloud. Dove esiste la possibilità di ambiguità, questo documento deve specificare che l'organizzazione è un'organizzazione Apigee.

Per ulteriori informazioni, vedi 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 esegui il deployment. Un pod rappresenta un processo in esecuzione sul tuo cluster.
saldo prepagato
Un importo 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 con pagamento posticipato dal fornitore dell'API.
norme
Una fase di elaborazione eseguita come unità logica atomica riutilizzabile all'interno di un flusso API. I criteri tipici includono il routing delle richieste all'endpoint corretto, la trasformazione di un formato del messaggio, l'applicazione del controllo dell'accesso, la chiamata ai servizi remoti per ulteriori informazioni, il mascheramento dei 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, è possibile eseguire un criterio di trasformazione per personalizzare un formato di risposta se il messaggio di richiesta è stato inviato da uno smartphone.
sviluppatore con pagamento posticipato
Uno sviluppatore che riceve addebiti mensili 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 con pagamento posticipato o prepagato dal fornitore dell'API.
proxy
Anche proxy API. Un proxy API è un livello di astrazione che si limita alle API dei 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. Puoi configurare l'endpoint del proxy con un percorso base che fa parte dell'URL a cui risponde il proxy API. L'URL ha il formato https://hostname/basepath/pathsuffixes. Vedi Creare un proxy API.

R

piano tariffario
Una specifica di commissioni, altri addebiti e una quota di condivisione delle entrate per l'utilizzo di prodotti basati su API offerti in un pacchetto API monetizzato.
controller di replicazione
Ripianifica i pod e gestisce la riparazione automatica dei pod.
risorsa, percorso risorsa
Un concetto RESTful, un percorso 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 si distingue da versione, che è l'interfaccia API rivolta agli sviluppatori. Vedi la "versione" di seguito.
piano di runtime

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

Include MART, sincronizzatore, processori di messaggi, 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 area geografica. È possibile collegare uno o più ambienti a un'istanza di runtime, offrendo così disponibilità elevata per i proxy API tra regioni.

S

esterno

Termine generale per indicare le app containerizzate in esecuzione sul tuo cluster Kubernetes nel piano di runtime. Questi servizi includono MART, sincronizzatore, processori di messaggi e Cassandra.

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

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

Il sincronizzatore archivia le proprie informazioni in un file system condiviso letto dal 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/pod Kubernetes.

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

T

endpoint di destinazione

Un endpoint di destinazione definisce la modalità di interazione del proxy API 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 sulla connessione. Vedi 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">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 la pagina Variabili di monetizzazione.

U

Campagna universale per app

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

Per saperne di più, consulta Raccolta dei dati di debug, analisi e stato del deployment.

UDCA (UDCA)

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

Per saperne di più, consulta Raccolta dei dati di debug, analisi e stato del 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 si distingue da revision, che è il pacchetto numerato e con controllo della versione di configurazione e criteri in bundle in un proxy API. In breve, le interfacce API hanno più versioni, mentre i proxy API hanno delle revisioni.
volume
Spazio di archiviazione condiviso che può essere utilizzato da tutte le applicazioni containerizzate all'interno di un pod.