Elimina un'organizzazione Apigee

Questa pagina si applica ad Apigee, ma non ad Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questa pagina spiega come eliminare completamente un'organizzazione Apigee da un progetto Google Cloud, inclusi i passaggi successivi necessari per rilasciare le risorse di networking che Apigee non pulisce autonomamente. La pulizia post-eliminazione da eseguire dipende dal modo in cui è stato eseguito il provisioning dell'organizzazione:

• Le organizzazioni di cui è stato eseguito il provisioning con il peering VPC abilitato hanno anche una connessione di peering VPC di Service Networking tra il tuo VPC e la rete tenant Apigee. La connessione e l'intervallo di peering riservato e la rete VPC associati rimangono invariati dopo l'eliminazione dell'organizzazione e devono essere eliminati separatamente se non sono più necessari. Consulta Follow up: organizzazioni di cui è stato eseguito il provisioning con il peering VPC.

• Le organizzazioni di cui è stato eseguito il provisioning con il peering VPC disabilitato utilizzano Private Service Connect anziché una connessione di networking dei servizi, quindi non è necessario rimuovere il peering del producer. Devi comunque eliminare il bilanciatore del carico Private Service Connect in entrata che hai creato durante il provisioning dell'organizzazione (regola di forwarding, proxy HTTPS di destinazione, mappa URL, servizio di backend, gruppo di endpoint di rete PSC, certificato SSL e indirizzo IP riservato), altrimenti la regola di forwarding e l'indirizzo IP riservato continueranno a generare addebiti. Consulta Passaggio successivo: organizzazioni di cui è stato eseguito il provisioning senza peering VPC.

La sezione Prima di iniziare mostra come determinare la categoria in cui rientra la tua organizzazione.

Avviso: l'eliminazione di un'organizzazione Apigee è un'azione distruttiva. Tutte le risorse all'interno dell'organizzazione, inclusi proxy API, ambienti, gruppi di ambienti, sviluppatori, app, prodotti API, keystore, mappe chiave-valore e istanze, vengono rimosse. Per le organizzazioni a pagamento, l'eliminazione è un'eliminazione temporanea con una finestra di conservazione (consulta Finestra di conservazione e nuovo provisioning); per le organizzazioni di valutazione, l'eliminazione è immediata. Per il comportamento completo, consulta organizations.delete. L'eliminazione non può essere annullata dopo la scadenza della finestra di conservazione.

Prima di iniziare

Autorizzazioni IAM obbligatorie

• Nell'organizzazione Apigee (in genere APIGEE_PROJECT_ID): apigee.organizations.delete. Questa autorizzazione è inclusa nel ruolo roles/apigee.admin, che la guida ai ruoli Apigee descrive come l'unico ruolo che può creare, eliminare o aggiornare le organizzazioni.

• Inoltre, se è stato eseguito il provisioning della tua organizzazione con il peering VPC abilitato e prevedi di eseguire la pulizia della connessione di networking dei servizi, dell'intervallo di peering VPC o della rete VPC come descritto in Passaggi successivi: organizzazioni di cui è stato eseguito il provisioning con il peering VPC, nel progetto proprietario della rete VPC in peering (il progetto di rete, che potrebbe essere diverso dal tuo progetto Apigee in una configurazione VPC condiviso), servicenetworking.services.deleteConnection, compute.globalAddresses.delete e compute.networks.delete.

Elimina prima le risorse dipendenti

Prima di eliminare l'organizzazione, elimina le risorse che Apigee richiede di rimuovere per prime:

• Elimina tutte le istanze Apigee associate all'organizzazione. Consulta Elimina un'istanza gestita.

• Elimina tutti i collegamenti degli endpoint associati all'organizzazione. Consulta Eliminazione di un collegamento dell'endpoint.

Esegui il backup dei dati che vuoi conservare

Esegui il backup di tutti i dati o le risorse con ambito a livello di organizzazione di cui potresti aver bisogno in un secondo momento. Una volta trascorso il periodo di conservazione, i dati archiviati nell'organizzazione non sono recuperabili.

Determina se la tua organizzazione utilizza il peering VPC

La pulizia successiva che devi eseguire dopo l'eliminazione dell'organizzazione dipende dal fatto che sia stato eseguito il provisioning dell'organizzazione con il peering VPC abilitato. Leggi la configurazione dell'organizzazione con l'API organizations.get prima di eliminarla:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

Questa e tutte le altre chiamate REST Apigee in questa pagina hanno come target l'endpoint globale apigee.googleapis.com. Se la tua organizzazione si trova in una regione di residenza dei dati, sostituisci l'endpoint regionale corrispondente in ogni esempio.

Nota importante sull'utilizzo per la residenza dei dati: per supportare la residenza dei dati, quando esegui il provisioning o utilizzi Apigee devi utilizzare un endpoint regionale. Per saperne di più, consulta Utilizza gli endpoint regionali per la residenza dei dati.

Cerca il campo disableVpcPeering nella risposta:

• Se la risposta contiene "disableVpcPeering": true, è stato eseguito il provisioning dell'organizzazione senza peering VPC. Dopo aver eliminato l'organizzazione, segui i passaggi descritti in Passaggi successivi: organizzazioni di cui è stato eseguito il provisioning senza peering VPC.

• Se il campo è false o assente, è stato eseguito il provisioning dell'organizzazione con il peering VPC. Registra i seguenti due valori aggiuntivi dalla stessa risposta; ti serviranno durante la pulizia:

  • Il campo authorizedNetwork, che identifica la rete VPC in peering con Apigee. Viene visualizzato in una di queste due forme:
    • Un percorso completo della risorsa projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, che codifica sia il progetto di rete sia il nome della rete. Questo modulo viene utilizzato quando la rete si trova in un progetto diverso dalla tua organizzazione Apigee, più comunemente in una configurazione VPC condiviso, in cui la rete si trova nel progetto host.
    • Solo un nome di rete (ad esempio apigee-network). Se è presente solo il nome, la rete si trova nello stesso progetto Google Cloud della tua organizzazione Apigee. Tratta questo progetto (APIGEE_PROJECT_ID) come NETWORK_PROJECT_ID per i passaggi di pulizia.
    Tieni presente che authorizedNetwork è impostato solo sulle organizzazioni con peering VPC.
  • Il nome dell'indirizzo globale che hai prenotato originariamente per l'intervallo di peering VPC (ad esempio apigee-range). Hai prenotato questo indirizzo quando hai eseguito il provisioning dell'organizzazione per la prima volta.

  Dopo aver eliminato l'organizzazione, segui i passaggi descritti in Passaggi successivi: organizzazioni di cui è stato eseguito il provisioning con il peering VPC.

Elimina l'organizzazione Apigee

Chiama l'API organizations.delete per eliminare l'organizzazione. La chiamata restituisce un'operazione a lunga esecuzione ed esegue un'eliminazione immediata per le organizzazioni di valutazione; per le organizzazioni a pagamento (abbonamento o pagamento a consumo), esegue un'eliminazione temporanea soggetta alla finestra di conservazione.

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

Per utilizzare la finestra di conservazione minima (24 ore) per un'organizzazione a pagamento, aggiungi il parametro di query retention:

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION?retention=MINIMUM"

La risposta contiene un'operazione a lunga esecuzione. Puoi eseguire il polling con organizations.operations.get.

Follow up: organizzazioni di cui è stato eseguito il provisioning senza peering VPC

Se il campo disableVpcPeering dell'organizzazione è true, l'eliminazione dell'organizzazione non rilascia risorse di Service Networking, perché un'organizzazione di cui è stato eseguito il provisioning senza peering VPC non ha mai avuto una connessione di Service Networking e non esiste un peering del producer da rimuovere.

Devi comunque eliminare il bilanciatore del carico Private Service Connect northbound che hai creato nel tuo progetto quando hai eseguito il provisioning dell'organizzazione. Queste risorse non sono di proprietà di Apigee e organizations.delete non ne rilascia alcuna. Eliminale in ordine inverso di dipendenza:

1. Regola di forwarding
2. Proxy HTTPS di destinazione
3. Mappa URL
4. Servizio di backend
5. Gruppo di endpoint di rete PSC
6. Certificato SSL
7. Indirizzo IP riservato

Attenzione: se lasci la regola di forwarding e l'indirizzo IP riservato, continueranno a essere addebitati costi e l'indirizzo riservato continuerà a occupare la quota di IP globali del tuo progetto. Il gruppo di endpoint di rete PSC rimane puntato a un collegamento di servizio eliminato e deve essere ripulito esplicitamente.

Al termine della pulizia del traffico in entrata, vai alla sezione Finestra di conservazione e nuovo provisioning.

Follow up: organizzazioni di cui è stato eseguito il provisioning con il peering VPC

Importante: questo argomento si applica solo alle organizzazioni create con il peering VPC abilitato. Consulta anche Opzioni di networking di Apigee.

L'eliminazione dell'organizzazione Apigee non rilascia la connessione in peering VPC di networking dei servizi stabilita durante il provisioning dell'organizzazione. La connessione rimane nella tua rete VPC, insieme all'intervallo di peering riservato e a qualsiasi rete VPC che hai dedicato al peering. Se non hai più bisogno di queste risorse, completa la pulizia seguendo le procedure canoniche Configura l'accesso privato ai servizi e Service Networking. Il resto di questa sezione fornisce solo i valori e gli avvisi specifici per un teardown di Apigee.

Raccogli i valori necessari

I seguenti passaggi di pulizia riutilizzano lo stesso gruppo di valori da inserire nelle procedure delle guide collegate di Networking dei servizi e VPC. Determina ogni valore una volta, quindi impostalo come variabile di shell in modo da poter copiare i comandi collegati alla lettera:

• NETWORK_PROJECT_ID: il progetto proprietario della rete VPC in peering. Non sempre coincide con il tuo progetto di servizio Apigee: in una configurazione VPC condiviso, la rete si trova nel progetto host. Derivalo dal valore authorizedNetwork che hai registrato in Determina se la tua organizzazione utilizza il peering VPC:

  • Se authorizedNetwork è un percorso completo della risorsa projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, prendi NETWORK_PROJECT_ID da quel percorso.
  • Se authorizedNetwork è solo un nome di rete (ad esempio apigee-network), la rete si trova nello stesso progetto dell'organizzazione Apigee; utilizza il tuo progetto Apigee (APIGEE_PROJECT_ID).

• NETWORK_NAME: il nome della rete VPC (ad esempio, apigee-network). Prendilo dal percorso completo in authorizedNetwork o utilizza il valore nudo quando authorizedNetwork è solo un nome.

• APIGEE_RANGE_NAME: il nome dell'indirizzo globale allocato per l'intervallo di peering VPC (ad esempio, apigee-range) quando è stato eseguito il provisioning dell'organizzazione. Puoi visualizzare gli intervalli prenotati collegati al peering nell'elenco reservedPeeringRanges restituito da gcloud services vpc-peerings list.

• NETWORK_PROJECT_NUMBER: il numero di progetto numerico per NETWORK_PROJECT_ID. L'API REST Service Networking richiede il numero di progetto (non l'ID progetto) nel campo consumerNetwork:

  gcloud projects describe NETWORK_PROJECT_ID \
    --format="value(projectNumber)"

Ogni volta che una procedura collegata richiede una rete, un progetto di rete o una rete consumer, sostituisci questi valori.

Avvisi relativi a un teardown di Apigee

La connessione di networking dei servizi e l'intervallo di peering prenotato possono essere condivisi con altri servizi Google Cloud. Ogni servizio Google Cloud sulla rete che utilizza l'accesso privato ai servizi (Cloud SQL, Memorystore, AlloyDB, Filestore e Apigee) condivide una connessione Service Networking per VPC e può condividere gli intervalli allocati al suo interno. L'eliminazione della connessione rimuove il peering del producer per tutti questi servizi e il rilascio di un intervallo recupera lo spazio IP che potrebbero ancora utilizzare.

Prima di rilasciare una delle due risorse, utilizza Quanto spazio della mia allocazione viene utilizzato? nella guida Configura l'accesso privato ai servizi per verificare chi la sta utilizzando. Se non puoi confermare che solo Apigee ha utilizzato la risorsa, lasciala invariata.

Completa la pulizia

Segui le procedure collegate, sostituendo le variabili di Raccogli i valori necessari:

• Elimina la connessione di Service Networking. Segui Elimina una connessione privata. Poiché hai già eliminato l'organizzazione Apigee in Elimina l'organizzazione Apigee, il prerequisito della guida per la rimozione dell'istanza di servizio è soddisfatto per le organizzazioni di valutazione, che vengono eliminate immediatamente. Per le organizzazioni a pagamento, l'eliminazione è un'eliminazione temporanea e l'eliminazione della connessione va a buon fine solo una volta trascorso il periodo di conservazione. Consulta Periodo di conservazione e nuovo provisioning o elimina l'organizzazione con ?retention=MINIMUM per ridurre il periodo a 24 ore. Quando la procedura richiede la rete e il progetto di rete, utilizza NETWORK_NAME e NETWORK_PROJECT_ID; quando la chiamata REST services.connections.deleteConnection sottostante richiede consumerNetwork, utilizza projects/NETWORK_PROJECT_NUMBER/global/networks/NETWORK_NAME.

• (Facoltativo) Rilascia l'intervallo di peering riservato. Segui Elimina un intervallo di indirizzi IP allocato, utilizzando APIGEE_RANGE_NAME e NETWORK_PROJECT_ID. L'intervallo riservato è una risorsa di proprietà del cliente che persiste dopo l'eliminazione dell'organizzazione Apigee e della connessione Service Networking. Lasciarlo invariato non interrompe alcun servizio Google Cloud.

• (Facoltativo) Elimina la rete VPC. Se hai instradato il traffico verso nord tramite un gruppo di istanze gestite o un bilanciatore del carico interno in questa rete, elimina prima queste risorse, altrimenti l'eliminazione della rete non va a buon fine con un errore di risorsa dipendente: regola di forwarding, proxy di destinazione, mappa URL, servizio di backend, gruppo di istanze gestite, template di istanza, controllo di integrità, regole firewall e indirizzo riservato. Quindi, segui la procedura per eliminare una rete nella guida alle reti VPC, utilizzando NETWORK_NAME e NETWORK_PROJECT_ID.

Nota: se l'eliminazione della connessione non riesce e viene visualizzato l'errore "Le risorse del producer di servizi sono ancora in uso", significa che un altro producer di accesso privato ai servizi su questa rete sta ancora utilizzando la connessione o che la tua organizzazione Apigee si trova ancora nella finestra di conservazione e le risorse lato producer non sono ancora state rilasciate completamente. Nel primo caso, utilizza Quanto spazio della mia allocazione viene utilizzato? per identificare il producer e non forzare l'eliminazione. Nel secondo caso, attendi che trascorra la finestra di conservazione (o elimina l'organizzazione con ?retention=MINIMUM per ridurre la finestra a 24 ore) prima di riprovare.

Periodo di conservazione e nuovo provisioning

Come documentato nel riferimento organizations.delete:

• Apigee elimina immediatamente le organizzazioni di valutazione.
• Apigee elimina temporaneamente le organizzazioni a pagamento (con abbonamento o pagamento a consumo) con un periodo di conservazione predefinito di 7 giorni. Durante la finestra di conservazione, puoi ripristinare l'organizzazione inviando un ticket di assistenza ad Apigee. Se passi ?retention=MINIMUM nella richiesta di eliminazione, la finestra viene ridotta a 24 ore.
• Non puoi ricreare un'organizzazione Apigee nello stesso progetto Google Cloud durante la finestra di conservazione.

Passaggi successivi

Riferimenti Apigee:

• Introduzione al provisioning di Apigee
• Opzioni di networking di Apigee (peering VPC e Private Service Connect)
• Informazioni sugli intervalli di peering
• Utilizzo di reti VPC condivise

Riferimenti a Service Networking e accesso privato ai servizi:

• Panoramica dell'accesso privato ai servizi
• Configura l'accesso privato ai servizi
• Inizia a utilizzare Service Networking
• Riferimento API Service Networking: services.connections
• Network Analyzer: riepilogo dell'utilizzo degli indirizzi IP di accesso privato ai servizi