Questa pagina si applica ad Apigee, ma non ad Apigee ibrido.
Visualizza la documentazione di Apigee Edge.
Un'istanza è una macchina virtuale in cui sono archiviati il tuo progetto API e i relativi servizi. Le istanze corrispondono alle regioni. In genere, si inizia con una singola istanza e si aggiungono nuove istanze man mano che l'organizzazione si espande in più regioni. Questa sezione spiega come:
- Crea una nuova istanza.
- Collega o rimuovi gli ambienti da un'istanza.
- Modificare l'elenco dei progetti accettati
- Abilita o disabilita i log degli accessi in entrata per un'istanza.
- Elimina un'istanza.
Crea una nuova istanza
Per creare una nuova istanza, puoi utilizzare l'API Instances o la UI di Apigee. Ogni istanza richiede:
- la propria chiave di crittografia del disco per la rete. Apigee consiglia di creare anche un keyring separato per la nuova istanza. Per maggiori informazioni, consulta Informazioni sulle chiavi di crittografia Apigee.
- gli intervalli CIDR /22 e /28 non sovrapposti per il peering di rete. Gli intervalli non possono essere condivisi tra le istanze.
Apigee nella console Cloud
Per creare una nuova istanza in Apigee nella console Cloud:
- Apri https://console.cloud.google.com/apigee nel browser.
-
Seleziona Gestione > Istanze. Il riquadro Istanze mostra un elenco delle istanze esistenti.
-
Fai clic su + Crea. Potrebbe verificarsi un ritardo mentre l'interfaccia utente determina se la tua organizzazione dispone dei diritti appropriati per creare una nuova istanza.
Viene visualizzata la pagina Crea nuova istanza.
- Inserisci i dettagli della nuova istanza nei campi:
Campo Obbligatorio Descrizione Runtime hosting location
Obbligatorio Seleziona la regione in cui vuoi creare la nuova istanza. Non puoi creare una nuova istanza in una regione in cui ne esiste già un'istanza. Per saperne di più sull'utilizzo di più regioni, consulta Utilizzo di più regioni. Name
Obbligatorio Inserisci l'ID della nuova istanza.
Il valore predefinito è il nome della regione di hosting del runtime che hai selezionato, ma puoi cambiarlo con qualsiasi nome significativo che preferisci, a condizione di seguire le regole di denominazione:
- La lunghezza minima è di 2 caratteri.
- La lunghezza massima è di 32 caratteri.
- Utilizza solo lettere minuscole, numeri e trattini (seguendo il pattern
/^[a-z0-9\-]+$/
). - Deve iniziare con una lettera e non deve contenere cifre iniziali o trattini.
- Deve terminare con un numero o una lettera e non deve contenere trattini finali.
- Deve essere univoco in tutta l'organizzazione.
IP range allocation
Obbligatorio Specifica come vuoi allocare un intervallo IP. Scegli una delle seguenti opzioni:
- Automatico (consigliato): Apigee seleziona un intervallo CIDR disponibile con una dimensione del prefisso di /22. Non occorrono ulteriori interventi da parte tua.
- Personalizzato: nei casi d'uso avanzati, potrebbe essere necessario specificare esattamente l'intervallo IP che vuoi che Apigee utilizzi. In questi casi, devi specificare un intervallo IP personalizzato, che deve avere una dimensione del prefisso pari a /22. L'intervallo deve essere disponibile come parte di una connessione privata tra il progetto e Apigee.
Disk encryption key
Obbligatorio In Chiave di crittografia del disco, scegli una chiave di crittografia gestita dal cliente. Se una chiave esiste già, puoi sceglierla. La procedura guidata elenca tutte le chiavi nella stessa località della regione di hosting del runtime in tutti i keyring. Se una chiave non esiste o se non vuoi utilizzarne una esistente, puoi crearne una nuova dalla procedura guidata. Per creare una chiave:
- Fai clic su Crea chiave.
- Seleziona un keyring o, se non ne esiste uno, abilita Crea keyring e inserisci il nome di un keyring e scegli la posizione del keyring. I nomi dei keyring possono contenere lettere, numeri, trattini bassi (_) e trattini (-). I keyring non possono essere rinominati o eliminati.
- Fai clic su Continua.
- Crea una chiave. Inserisci un nome e un livello di protezione. Tieni presente che i nomi delle chiavi possono contenere lettere, numeri, trattini bassi (_) e trattini (-). Le chiavi non possono essere rinominate o eliminate. Per il livello di protezione, il Software è un'ottima scelta. Si tratta dello stesso valore predefinito utilizzato da Cloud KMS, ma se vuoi, puoi modificarlo.
- Fai clic su Continua e rivedi le selezioni.
- Fai clic su Crea.
- Fai clic su Concedi per concedere all'account di servizio l'autorizzazione a criptare/decriptare con la chiave selezionata.
Environments
Facoltativo Seleziona gli ambienti da collegare a questa istanza. Per farlo, fai clic sull'elenco a discesa Ambienti e seleziona le caselle di controllo accanto agli ambienti da collegare. Puoi farlo per tutti gli ambienti che vuoi. Quindi, fai clic su OK.
Tieni presente che gli ambienti di tutte le istanze vengono conteggiati nel numero totale di ambienti che puoi allocare. Per maggiori informazioni, consulta Informazioni sugli ambienti e sui gruppi di ambienti.
L'aggiunta di ambienti quando crei una nuova istanza è facoltativa. Se non li aggiungi ora, puoi utilizzare l'API Instances Attaching o la UI per aggiungerli e rimuoverli in un secondo momento. Vedi Collegare o rimuovere un ambiente.
Accepted projects
Facoltativo Fai clic su Aggiungi progetto accettato per selezionare uno o più progetti Cloud. I progetti selezionati possono connettersi in privato al collegamento al servizio per la tua istanza. Per impostazione predefinita, il progetto associato alla tua organizzazione Apigee è incluso in questo elenco. Enable logging
Facoltativo Fai clic sul pulsante di attivazione/disattivazione Abilita il logging per abilitare i log degli accessi in entrata di Cloud Logging per l'istanza. Questa funzionalità consente di visualizzare i log generati dai gateway in entrata nella tua infrastruttura Apigee, ad esempio un bilanciatore del carico delle applicazioni esterno o un gateway Anthos, per aiutarti a risolvere i problemi delle chiamate API Apigee. Per ulteriori informazioni, consulta Logging dei log degli accessi di Apigee.
Filter
Facoltativo Seleziona un codice di risposta HTTP dalla casella del codice di risposta per fungere da filtro per i log di accesso in entrata. Se vuoi includere tutti i log, indipendentemente dal codice di risposta HTTP, seleziona
None (all HTTP responses)
.Per creare un filtro personalizzato, seleziona
Custom
e inserisci il filtro nel seguente formato:status_code > XX && status code <= YY
Ad esempio:
status_code >= 500 && status_code < 504
Se la tua organizzazione non può creare una nuova istanza, contatta il team di vendita Apigee.
-
Fai clic su Crea.
Apigee avvia un'operazione a lunga esecuzione il cui completamento può richiedere almeno 20 minuti. Al termine, la nuova istanza verrà visualizzata nell'elenco delle istanze della UI Istanze.
API Apigee
Se è stato eseguito il provisioning di Apigee senza peering VPC, vedi Creare un'istanza di runtime nella procedura di provisioning del peering non VPC.
Se è stato eseguito il provisioning di Apigee con peering VPC, consulta Creare un'istanza di runtime nella procedura di provisioning del peering VPC.
Collega o rimuovi gli ambienti da un'istanza
Quando crei un ambiente utilizzando l'interfaccia utente di Apigee nella console Google Cloud, hai la possibilità di assegnare l'ambiente a un'istanza esistente. Per maggiori informazioni, consulta la sezione Creazione di un nuovo ambiente nella UI.
Se non hai collegato il tuo ambiente a un'istanza durante la creazione dell'ambiente o vuoi rimuovere un ambiente da un'istanza, puoi seguire questi passaggi. Per ulteriori informazioni su ambienti e istanze, consulta Ambienti e istanze.
Per collegare o rimuovere un ambiente da un'istanza utilizzando Apigee nella console Cloud:
- Apri https://console.cloud.google.com/apigee nel browser.
- Seleziona Gestione > Istanze.
Fai clic sull'istanza che vuoi modificare.
- Nella pagina Dettagli istanza, fai clic su Modifica.
- Nella pagina Modifica istanza, fai clic sul campo Ambienti (facoltativo) e seleziona l'ambiente da collegare all'istanza oppure deseleziona l'ambiente da rimuovere.
- Fai clic su Ok.
- Fai clic su Salva per salvare le modifiche.
Oltre a utilizzare l'interfaccia utente, puoi anche collegare gli ambienti a un'istanza mediante l'API per la creazione del collegamento delle istanze. Per un esempio, consulta Creare un ambiente nella documentazione sul provisioning della riga di comando.
Modifica l'elenco dei progetti accettati
Puoi aggiungere o rimuovere progetti dall'elenco Progetti accettati:
- Apri https://console.cloud.google.com/apigee nel browser.
- Seleziona Gestione > Istanze.
Fai clic sull'istanza che vuoi modificare.
- Nella pagina Dettagli istanza, fai clic su Modifica.
- Nella sezione Progetti accettati della pagina Modifica istanza, fai clic sull'icona di eliminazione accanto a un progetto per rimuoverlo. Per aggiungere un progetto, fai clic su Aggiungi progetto accettato e inserisci l'ID del progetto da aggiungere.
- Fai clic su Salva per salvare le modifiche.
Abilita o disabilita i log degli accessi in entrata per un'istanza
Dopo aver creato un'istanza, puoi abilitare e disabilitare i log degli accessi in entrata di Cloud Logging per l'istanza:
- Apri https://console.cloud.google.com/apigee nel browser.
- Seleziona Gestione > Istanze.
Fai clic sull'istanza che vuoi modificare.
- Nella pagina Dettagli istanza, fai clic su Modifica.
- Nella pagina Modifica istanza, fai clic sul pulsante di attivazione/disattivazione Abilita il logging per disabilitare la funzionalità.
- Fai clic su Salva per salvare le modifiche.
Elimina un'istanza
Puoi utilizzare https://console.cloud.google.com/apigee per eliminare un'istanza esistente, come descritto in questa sezione. In alternativa, puoi eliminare un'istanza utilizzando l'API Instances.
In una determinata regione Google Cloud può essere presente una sola istanza Apigee. Quando elimini un'istanza, questa viene completamente rimossa dalla relativa regione. Vedi anche installazione per più regioni.
I seguenti dati sono archiviati in un'istanza Apigee e verranno eliminati se elimini l'istanza:
Tipo di dati | Descrizione |
---|---|
Sistema di gestione delle chiavi (KMS) | I dati KMS includono prodotti API, sviluppatori, app per sviluppatori, token OAuth (inclusi token di accesso, token di aggiornamento e codici di autorizzazione) e chiavi API. Utilizza il criterio AccessEntity o l'API Apigee correlata per recuperare i dati che vuoi salvare. |
Mappa chiave-valore (KVM) | Tutti i dati che possono essere creati o gestiti con i criteri KVM. Consulta la sezione Recupero dei KVM. |
Quota | Definizioni di quota, bucket e contatori. |
Cache dell'ambiente | Tutti i dati memorizzati nella cache. |
Per eliminare un'istanza Apigee utilizzando l'interfaccia utente di Apigee nella console Cloud:
- Apri https://console.cloud.google.com/apigee nel browser.
-
Seleziona Gestione > Istanze.
- Fai clic sull'istanza che vuoi eliminare.
- Nella pagina Dettagli istanza, fai clic su Elimina.