Apigee-Organisation löschen

Diese Seite gilt für Apigee, aber nicht für Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Auf dieser Seite wird beschrieben, wie Sie eine Apigee-Organisation vollständig aus einem Google Cloud-Projekt löschen. Außerdem werden die nachfolgenden Schritte erläutert, die erforderlich sind, um Netzwerkressourcen freizugeben, die von Apigee nicht automatisch bereinigt werden. Die nach dem Löschen erforderliche Bereinigung hängt davon ab, wie die Organisation bereitgestellt wurde:

  • Organisationen, die mit aktiviertem VPC-Peering bereitgestellt wurden, haben auch eine Service Networking-VPC-Peering-Verbindung zwischen Ihrer VPC und dem Apigee-Mandantennetzwerk. Diese Verbindung und alle damit verbundenen reservierten Peering-Bereiche und VPC-Netzwerk bleiben nach dem Löschen der Organisation bestehen und müssen separat bereinigt werden, wenn Sie sie nicht mehr benötigen. Weitere Informationen finden Sie unter Nächste Schritte: Organisationen, die mit VPC-Peering bereitgestellt wurden.

  • Organisationen, die mit deaktiviertem VPC-Peering bereitgestellt wurden, verwenden Private Service Connect anstelle einer Dienstnetzwerkverbindung. Daher muss kein Ersteller-Peering entfernt werden. Sie müssen den Northbound-Private Service Connect-Load-Balancer, den Sie bei der Bereitstellung der Organisation erstellt haben, weiterhin löschen (Weiterleitungsregel, Ziel-HTTPS-Proxy, URL-Zuordnung, Backend-Dienst, PSC-Netzwerk-Endpunktgruppe, SSL-Zertifikat und reservierte IP-Adresse). Andernfalls fallen für die Weiterleitungsregel und die reservierte IP-Adresse weiterhin Kosten an. Weitere Informationen finden Sie unter Nächste Schritte: Ohne VPC-Peering bereitgestellte Organisationen.

Unter Vorbereitung wird beschrieben, wie Sie feststellen, in welche Kategorie Ihre Organisation fällt.

Hinweis

Erforderliche IAM-Berechtigungen

  • In der Apigee-Organisation (normalerweise APIGEE_PROJECT_ID): apigee.organizations.delete. Diese Berechtigung ist in der Rolle roles/apigee.admin enthalten, die im Leitfaden zu Apigee-Rollen als einzige Rolle beschrieben wird, mit der Organisationen erstellt, gelöscht oder aktualisiert werden können.

  • Wenn Ihre Organisation mit aktiviertem VPC-Peering bereitgestellt wurde und Sie die Dienstnetzwerkverbindung, den VPC-Peering-Bereich oder das VPC-Netzwerk wie unter Nächste Schritte: Organisationen, die mit VPC-Peering bereitgestellt wurden beschrieben bereinigen möchten, gilt Folgendes: im Projekt, das Inhaber des Peering-VPC-Netzwerks ist (das Netzwerkprojekt, das sich von Ihrem Apigee-Projekt in einer gemeinsam genutzten VPC unterscheiden kann), servicenetworking.services.deleteConnection, compute.globalAddresses.delete und compute.networks.delete.

Löschen Sie zuerst abhängige Ressourcen

Löschen Sie vor dem Löschen der Organisation die Ressourcen, die Sie zuerst entfernen müssen:

Sichere alle Daten, die du behalten möchtest.

Sichern Sie alle Daten oder Ressourcen auf Organisationsebene, die Sie später möglicherweise benötigen. Nach Ablauf des Aufbewahrungszeitraums können die in der Organisation gespeicherten Daten nicht mehr wiederhergestellt werden.

Prüfen, ob Ihre Organisation VPC-Peering verwendet

Die nach dem Löschen der Organisation erforderlichen Bereinigungsmaßnahmen hängen davon ab, ob die Organisation mit aktiviertem VPC-Peering bereitgestellt wurde. Lesen Sie die Konfiguration der Organisation mit der API organizations.get, bevor Sie sie löschen: 

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

Dieser und alle anderen Apigee-REST-Aufrufe auf dieser Seite richten sich an den globalen Endpunkt apigee.googleapis.com. Wenn sich Ihre Organisation in einer Region mit Datenstandort befindet, ersetzen Sie in jedem Beispiel den entsprechenden regionalen Endpunkt.

Suchen Sie in der Antwort nach dem Feld disableVpcPeering:

  • Wenn die Antwort "disableVpcPeering": true enthält, wurde die Organisation ohne VPC-Peering bereitgestellt. Nachdem Sie die Organisation gelöscht haben, folgen Sie der Anleitung unter Nächste Schritte: Ohne VPC-Peering bereitgestellte Organisationen.

  • Wenn das Feld false ist oder fehlt, wurde die Organisation mit VPC-Peering bereitgestellt. Notieren Sie sich die folgenden beiden zusätzlichen Werte aus derselben Antwort. Sie benötigen sie für die Bereinigung:

    • Das Feld authorizedNetwork, das das VPC-Netzwerk identifiziert, das mit Apigee verbunden ist. Sie wird in einer von zwei Formen angezeigt:
      • Ein vollständiger Ressourcenpfad projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, der sowohl das Netzwerkprojekt als auch den Netzwerknamen codiert. Dieses Format wird verwendet, wenn sich das Netzwerk in einem anderen Projekt als Ihre Apigee-Organisation befindet – am häufigsten in einer gemeinsam genutzten VPC, in der sich das Netzwerk im Hostprojekt befindet.
      • Nur ein Netzwerkname (z. B. apigee-network). Wenn nur der Name vorhanden ist, befindet sich das Netzwerk im selben Google Cloud-Projekt wie Ihre Apigee-Organisation. Behandeln Sie dieses Projekt (APIGEE_PROJECT_ID) für die Bereinigungsschritte als NETWORK_PROJECT_ID.
      authorizedNetwork wird nur für Organisationen mit VPC-Peering festgelegt.
    • Der Name der globalen Adresse, die Sie ursprünglich für den VPC-Peering-Bereich reserviert haben (z. B. apigee-range). Sie haben diese Adresse reserviert, als Sie die Organisation zum ersten Mal bereitgestellt haben.

    Nachdem Sie die Organisation gelöscht haben, folgen Sie der Anleitung unter Nächste Schritte: Mit VPC-Peering bereitgestellte Organisationen.

Apigee-Organisation löschen

Rufen Sie die API organizations.delete auf, um die Organisation zu löschen. Der Aufruf gibt einen Vorgang mit langer Ausführungszeit zurück und führt bei Evaluierungsorganisationen eine sofortige Löschung durch. Bei kostenpflichtigen Organisationen (Abo oder „Pay as you go“) wird ein vorläufiges Löschen gemäß dem Aufbewahrungszeitraum durchgeführt. 

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

Wenn Sie das minimale Aufbewahrungsfenster (24 Stunden) für eine kostenpflichtige Organisation verwenden möchten, hängen Sie den Suchparameter retention an: 

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

Die Antwort enthält einen Vorgang mit langer Ausführungszeit. Sie können ihn mit organizations.operations.get abfragen.

Nachtrag: Ohne VPC-Peering bereitgestellte Organisationen

Wenn das Feld disableVpcPeering der Organisation true ist, werden beim Löschen der Organisation keine Dienstnetzwerkressourcen freigegeben, da eine ohne VPC-Peering bereitgestellte Organisation nie eine Dienstnetzwerkverbindung hatte und kein Ersteller-Peering entfernt werden muss.

Sie müssen den Northbound-Load-Balancer von Private Service Connect löschen, den Sie bei der Bereitstellung der Organisation in Ihrem eigenen Projekt erstellt haben. Diese Ressourcen gehören nicht Apigee und organizations.delete veröffentlicht keine davon. Löschen Sie sie in umgekehrter Reihenfolge der Abhängigkeit:

  1. Weiterleitungsregel
  2. Ziel-HTTPS-Proxy
  3. URL-Zuordnung
  4. Backend-Dienst
  5. PSC-Netzwerk-Endpunktgruppe
  6. SSL-Zertifikat
  7. Reservierte IP-Adresse

Wenn die Bereinigung der Northbound-Verbindung abgeschlossen ist, fahren Sie mit Aufbewahrungszeitraum und erneute Bereitstellung fort.

Follow-up: Mit VPC-Peering bereitgestellte Organisationen

Durch das Löschen der Apigee-Organisation wird die VPC-Peering-Verbindung für das Dienstnetzwerk, die Sie bei der Bereitstellung der Organisation eingerichtet haben, nicht freigegeben. Die Verbindung verbleibt in Ihrem VPC-Netzwerk, zusammen mit dem reservierten Peering-Bereich und allen VPC-Netzwerken, die Sie dem Peering zugewiesen haben. Wenn Sie diese Ressourcen nicht mehr benötigen, führen Sie die Bereinigung gemäß den kanonischen Verfahren Zugriff auf private Dienste konfigurieren und Dienstnetzwerke durch. Im Rest dieses Abschnitts werden nur die Werte und Warnungen für den Apigee-Teardown aufgeführt.

Benötigte Werte erfassen

Bei den folgenden Bereinigungsschritten werden dieselben Werte verwendet, die in den Verfahren der verknüpften Leitfäden zu Service Networking und VPC verwendet werden. Bestimmen Sie jeden Wert einmal und legen Sie ihn dann als Shell-Variable fest, damit Sie die verknüpften Befehle unverändert kopieren können:

  • NETWORK_PROJECT_ID: das Projekt, zu dem das Peering-VPC-Netzwerk gehört. Dies ist nicht immer dasselbe wie Ihr Apigee-Dienstprojekt: In einer gemeinsam genutzten VPC befindet sich das Netzwerk im Hostprojekt. Leiten Sie ihn von dem authorizedNetwork-Wert ab, den Sie unter Prüfen, ob Ihre Organisation VPC-Peering verwendet notiert haben:

    • Wenn authorizedNetwork ein vollständiger Ressourcenpfad projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME ist, nehmen Sie NETWORK_PROJECT_ID aus diesem Pfad.
    • Wenn authorizedNetwork nur ein Netzwerkname ist (z. B. apigee-network), befindet sich das Netzwerk im selben Projekt wie die Apigee-Organisation. Verwenden Sie Ihr Apigee-Projekt (APIGEE_PROJECT_ID).

  • NETWORK_NAME: Der Name des VPC-Netzwerk (z. B. apigee-network). Übernehmen Sie ihn aus dem vollständigen Pfad in authorizedNetwork oder verwenden Sie den reinen Wert, wenn authorizedNetwork nur ein Name ist.

  • APIGEE_RANGE_NAME: Der Name der globalen Adresse, die bei der Bereitstellung der Organisation für den VPC-Peering-Bereich zugewiesen wurde (z. B. apigee-range). Die reservierten Bereiche, die mit dem Peering verknüpft sind, finden Sie in der Liste reservedPeeringRanges, die von gcloud services vpc-peerings list zurückgegeben wird.

  • NETWORK_PROJECT_NUMBER: die numerische Projektnummer für NETWORK_PROJECT_ID. Die Service Networking REST API erfordert die Projektnummer (nicht die Projekt-ID) im Feld consumerNetwork:

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

Wenn in einem verknüpften Verfahren nach einem Netzwerk, Netzwerkprojekt oder Nutzernetzwerk gefragt wird, ersetzen Sie diese Werte.

Warnungen, die für einen Apigee-Teardown gelten

Bereinigung abschließen

Folgen Sie den verlinkten Verfahren und ersetzen Sie die Variablen aus Erforderliche Werte erfassen:

  • Löschen Sie die Dienstnetzwerkverbindung. Folgen Sie der Anleitung unter Private Verbindung löschen. Da Sie die Apigee-Organisation bereits unter Apigee-Organisation löschen gelöscht haben, ist die Voraussetzung des Leitfadens zum Entfernen der Dienstinstanz für Evaluierungsorganisationen erfüllt, die sofort gelöscht werden. Bei kostenpflichtigen Organisationen wird die Verbindung vorläufig gelöscht. Das Löschen der Verbindung ist erst nach Ablauf des Aufbewahrungszeitraums erfolgreich. Weitere Informationen finden Sie unter Aufbewahrungszeitraum und erneute Bereitstellung. Sie können die Organisation auch mit ?retention=MINIMUM löschen, um den Zeitraum auf 24 Stunden zu verkürzen. Wenn Sie im Rahmen des Verfahrens nach dem Netzwerk und dem Netzwerkprojekt gefragt werden, verwenden Sie NETWORK_NAME und NETWORK_PROJECT_ID. Wenn Sie im zugrunde liegenden REST-Aufruf services.connections.deleteConnection nach consumerNetwork gefragt werden, verwenden Sie projects/NETWORK_PROJECT_NUMBER/global/networks/NETWORK_NAME.

  • (Optional) Geben Sie den reservierten Peering-Bereich frei. Folgen Sie der Anleitung unter Zugewiesenen IP-Adressbereich löschen und verwenden Sie dabei APIGEE_RANGE_NAME und NETWORK_PROJECT_ID. Der reservierte Bereich ist eine kundeneigene Ressource, die nach dem Löschen der Apigee-Organisation und der Service Networking-Verbindung erhalten bleibt. Wenn Sie sie beibehalten, wird kein Google Cloud-Dienst beeinträchtigt.

  • (Optional) VPC-Netzwerk löschen Wenn Sie den Northbound-Traffic über eine verwaltete Instanzgruppe oder einen internen Load Balancer in diesem Netzwerk weitergeleitet haben, löschen Sie diese Ressourcen zuerst. Andernfalls schlägt das Löschen des Netzwerks mit einem Fehler aufgrund einer abhängigen Ressource fehl: Weiterleitungsregel, Ziel-Proxy, URL-Zuordnung, Backend-Dienst, verwaltete Instanzgruppe, Instanzvorlage, Systemdiagnose, Firewallregeln und reservierte Adresse. Folgen Sie dann der Anleitung unter Netzwerk löschen im Leitfaden zu VPC-Netzwerken und verwenden Sie NETWORK_NAME und NETWORK_PROJECT_ID.

Aufbewahrungsdauer und erneute Bereitstellung

Wie in der Referenz zu organizations.delete dokumentiert:

  • Apigee löscht Evaluierungsorganisationen sofort.
  • Apigee löscht kostenpflichtige Organisationen (Abo oder „Pay as you go“) vorläufig mit einem Standardaufbewahrungszeitraum von 7 Tagen. Während des Aufbewahrungszeitraums können Sie die Organisation wiederherstellen, indem Sie ein Support-Ticket bei Apigee einreichen. Wenn Sie ?retention=MINIMUM bei der Löschanfrage übergeben, wird das Zeitfenster auf 24 Stunden verkürzt.
  • Sie können eine Apigee-Organisation während des Aufbewahrungszeitraums nicht im selben Google Cloud-Projekt neu erstellen.

Nächste Schritte

Apigee-Referenzen:

Referenzen zu Service Networking und Zugriff auf private Dienste: