Supprimer une organisation Apigee

Cette page s'applique à Apigee, mais pas à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Cette page explique comment supprimer complètement une organisation Apigee d'un projet Google Cloud, y compris les étapes de suivi nécessaires pour libérer les ressources réseau qu'Apigee ne nettoie pas de lui-même. Le nettoyage après suppression que vous devez effectuer dépend de la manière dont l'organisation a été provisionnée :

  • Les organisations provisionnées avec l'appairage de VPC activé disposent également d'une connexion d'appairage de VPC Service Networking entre votre VPC et le réseau du locataire Apigee. Cette connexion, ainsi que toute plage d'appairage réservée et tout réseau VPC qui lui sont associés, restent en place après la suppression de l'organisation et doivent être nettoyés séparément si vous n'en avez plus besoin. Consultez Suivi : organisations provisionnées avec l'appairage de VPC.

  • Les organisations provisionnées avec l'appairage de VPC désactivé utilisent Private Service Connect au lieu d'une connexion Service Networking. Il n'y a donc pas d'appairage de producteur à supprimer. Vous devez toujours supprimer l'équilibreur de charge Private Service Connect northbound que vous avez créé lors du provisionnement de l'organisation (règle de transfert, proxy HTTPS cible, mappage d'URL, service de backend, groupe de points de terminaison du réseau PSC, certificat SSL et adresse IP réservée). Sinon, la règle de transfert et l'adresse IP réservée continuent d'engendrer des frais. Consultez Suivi : organisations provisionnées sans appairage de VPC.

La section Avant de commencer explique comment déterminer la catégorie à laquelle appartient votre organisation.

Avant de commencer

Autorisations IAM requises

  • Sur l'organisation Apigee (généralement APIGEE_PROJECT_ID) : apigee.organizations.delete. Cette autorisation est incluse dans le rôle roles/apigee.admin, que le guide sur les rôles Apigee décrit comme le seul rôle permettant de créer, supprimer ou mettre à jour des organisations.

  • De plus, si votre organisation a été provisionnée avec l'appairage de VPC activé et que vous prévoyez de nettoyer la connexion de mise en réseau de services, la plage d'appairage de VPC ou le réseau VPC comme décrit dans Suivi : organisations provisionnées avec l'appairage de VPC, sur le projet propriétaire du réseau VPC appairé (le projet réseau, qui peut différer de votre projet Apigee dans une configuration de VPC partagé), servicenetworking.services.deleteConnection, compute.globalAddresses.delete et compute.networks.delete.

Supprimez d'abord les ressources dépendantes

Avant de supprimer l'organisation, supprimez les ressources qu'Apigee vous demande de supprimer en premier :

Sauvegardez les données que vous souhaitez conserver.

Sauvegardez toutes les données ou ressources au niveau de l'organisation dont vous pourriez avoir besoin ultérieurement. Une fois la période de conservation écoulée, les données stockées dans l'organisation ne sont pas récupérables.

Déterminer si votre organisation utilise l'appairage de VPC

Le nettoyage que vous devez effectuer après la suppression de l'organisation dépend de l'activation ou non de l'appairage de VPC lors du provisionnement de l'organisation. Lisez la configuration de l'organisation avec l'API organizations.get avant de la supprimer : 

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

Cet appel REST Apigee et tous les autres appels REST Apigee de cette page ciblent le point de terminaison mondial apigee.googleapis.com. Si votre organisation se trouve dans une région de résidence des données, remplacez le point de terminaison régional correspondant dans chaque exemple.

Recherchez le champ disableVpcPeering dans la réponse :

  • Si la réponse contient "disableVpcPeering": true, l'organisation a été provisionnée sans appairage de VPC. Après avoir supprimé l'organisation, suivez les instructions de la section Suivi : organisations provisionnées sans appairage de VPC.

  • Si le champ est défini sur false ou absent, l'organisation a été provisionnée avec l'appairage de VPC. Enregistrez les deux valeurs supplémentaires suivantes à partir de la même réponse. Vous en aurez besoin lors du nettoyage :

    • Le champ authorizedNetwork, qui identifie le réseau VPC appairé à Apigee. Il se présente sous l'une des deux formes suivantes :
      • Un chemin d'accès complet à la ressource projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, qui encode à la fois le projet réseau et le nom du réseau. Ce format est utilisé lorsque le réseau se trouve dans un projet différent de votre organisation Apigee, le plus souvent dans une configuration de VPC partagé, où le réseau se trouve dans le projet hôte.
      • Uniquement un nom de réseau (par exemple, apigee-network). Lorsque seul le nom est présent, le réseau se trouve dans le même projet Google Cloud que votre organisation Apigee. Traitez ce projet (APIGEE_PROJECT_ID) comme NETWORK_PROJECT_ID pour les étapes de nettoyage.
      Notez que authorizedNetwork n'est défini que sur les organisations appairées au VPC.
    • Nom de l'adresse globale que vous avez initialement réservée pour la plage d'appairage de VPC (par exemple, apigee-range). Vous avez réservé cette adresse lors du provisionnement initial de l'organisation.

    Après avoir supprimé l'organisation, suivez les instructions de la section Suivi : organisations provisionnées avec l'appairage de VPC.

Supprimer l'organisation Apigee

Appelez l'API organizations.delete pour supprimer l'organisation. L'appel renvoie une opération de longue durée et, pour les organisations d'évaluation, effectue une suppression immédiate. Pour les organisations payantes (abonnement ou paiement à l'usage), il effectue une suppression réversible soumise à la période de conservation. 

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

Pour utiliser la période de conservation minimale (24 heures) pour une organisation payante, ajoutez le paramètre de requête retention : 

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

La réponse contient une opération de longue durée. Vous pouvez l'interroger avec organizations.operations.get.

Suivi : organisations provisionnées sans appairage de VPC

Si le champ disableVpcPeering de l'organisation est défini sur true, la suppression de l'organisation ne libère aucune ressource Service Networking, car une organisation provisionnée sans appairage de VPC n'a jamais eu de connexion Service Networking, et il n'y a pas d'appairage de producteur à supprimer.

Vous devez toujours supprimer l'équilibreur de charge Private Service Connect northbound que vous avez créé dans votre propre projet lorsque vous avez provisionné l'organisation. Ces ressources n'appartiennent pas à Apigee, et organizations.delete n'en publie aucune. Supprimez-les dans l'ordre inverse de la dépendance :

  1. Règle de transfert
  2. Proxy HTTPS cible
  3. Mappage d'URL
  4. Service de backend
  5. Groupe de points de terminaison du réseau PSC
  6. Certificat SSL
  7. Adresse IP réservée

Une fois le nettoyage northbound terminé, passez à la section Fenêtre de conservation et reprovisionnement.

Suivi : organisations provisionnées avec l'appairage de VPC

La suppression de l'organisation Apigee ne libère pas la connexion d'appairage de réseaux VPC de mise en réseau de services que vous avez établie lors du provisionnement de l'organisation. La connexion reste sur votre réseau VPC, ainsi que la plage d'appairage réservée et tout réseau VPC que vous avez dédié à l'appairage. Si vous n'avez plus besoin de ces ressources, effectuez le nettoyage en suivant les procédures canoniques Configurer l'accès aux services privés et Mise en réseau des services. Le reste de cette section ne fournit que les valeurs et les avertissements spécifiques à un démontage Apigee.

Collecter les valeurs dont vous avez besoin

Les étapes de nettoyage suivantes réutilisent les mêmes valeurs à insérer dans les procédures des guides Service Networking et VPC associés. Déterminez chaque valeur une fois, puis définissez-la en tant que variable d'interface système afin de pouvoir copier les commandes associées telles quelles :

  • NETWORK_PROJECT_ID : projet propriétaire du réseau VPC appairé. Il ne s'agit pas toujours de votre projet de service Apigee : dans une configuration de VPC partagé, le réseau se trouve dans le projet hôte. Dérivez-la de la valeur authorizedNetwork que vous avez enregistrée dans Déterminer si votre organisation utilise l'appairage de VPC :

    • Si authorizedNetwork est un chemin d'accès complet à la ressource projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, prenez NETWORK_PROJECT_ID à partir de ce chemin d'accès.
    • Si authorizedNetwork n'est qu'un nom de réseau (par exemple, apigee-network), le réseau se trouve dans le même projet que l'organisation Apigee. Utilisez votre projet Apigee (APIGEE_PROJECT_ID).

  • NETWORK_NAME : nom du réseau VPC (par exemple, apigee-network). Récupérez-le à partir du chemin d'accès complet dans authorizedNetwork ou utilisez la valeur brute lorsque authorizedNetwork n'est qu'un nom.

  • APIGEE_RANGE_NAME : nom de l'adresse globale allouée à la plage d'appairage de VPC (par exemple, apigee-range) lors du provisionnement de l'organisation. Vous pouvez voir les plages réservées associées à l'appairage dans la liste reservedPeeringRanges renvoyée par gcloud services vpc-peerings list.

  • NETWORK_PROJECT_NUMBER : numéro de projet numérique pour NETWORK_PROJECT_ID. L'API REST Service Networking nécessite le numéro de projet (et non l'ID du projet) dans le champ consumerNetwork :

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

Chaque fois qu'une procédure associée demande un réseau, un projet réseau ou un réseau client, remplacez ces valeurs.

Avertissements s'appliquant à un démontage Apigee

Terminer le nettoyage

Suivez les procédures associées en remplaçant les variables de la section Collecter les valeurs dont vous avez besoin :

  • Supprimez la connexion de mise en réseau de services. Suivez les instructions de la section Supprimer une connexion privée. Comme vous avez déjà supprimé l'organisation Apigee dans Supprimer l'organisation Apigee, la condition préalable du guide concernant la suppression de l'instance de service est remplie pour les organisations d'évaluation, qui sont supprimées immédiatement. Pour les organisations payantes, la suppression est une suppression réversible, et la suppression de la connexion ne réussit qu'une fois la période de conservation écoulée (voir Période de conservation et reprovisionnement), ou supprimez l'organisation avec ?retention=MINIMUM pour réduire la période à 24 heures. Lorsque la procédure demande le réseau et le projet de réseau, utilisez NETWORK_NAME et NETWORK_PROJECT_ID. Lorsque l'appel REST services.connections.deleteConnection sous-jacent demande consumerNetwork, utilisez projects/NETWORK_PROJECT_NUMBER/global/networks/NETWORK_NAME.

  • (Facultatif) Libérez la plage d'appairage réservée. Suivez la procédure Supprimer une plage d'adresses IP allouée en utilisant APIGEE_RANGE_NAME et NETWORK_PROJECT_ID. La plage réservée est une ressource appartenant au client qui persiste après la suppression de l'organisation Apigee et de la connexion Service Networking. La laisser en place ne perturbe aucun service Google Cloud.

  • (Facultatif) Supprimez le réseau VPC. Si vous avez acheminé le trafic vers le nord via un groupe d'instances géré ou un équilibreur de charge interne dans ce réseau, supprimez d'abord ces ressources. Sinon, la suppression du réseau échouera avec une erreur de ressource dépendante : règle de transfert, proxy cible, mappage d'URL, service de backend, groupe d'instances géré, modèle d'instance, vérification de l'état d'état, règles de pare-feu et adresse réservée. Suivez ensuite les instructions de la section Supprimer un réseau du guide sur les réseaux VPC, en utilisant NETWORK_NAME et NETWORK_PROJECT_ID.

Période de conservation et reprovisionnement

Comme indiqué dans la documentation de référence sur organizations.delete :

  • Apigee supprime immédiatement les organisations d'évaluation.
  • Apigee supprime de manière réversible les organisations payantes (abonnement ou paiement à l'usage) avec une période de conservation par défaut de sept jours. Pendant la période de conservation, vous pouvez restaurer l'organisation en envoyant une demande d'assistance à Apigee. La transmission de ?retention=MINIMUM lors de la requête de suppression réduit la période à 24 heures.
  • Vous ne pouvez pas recréer une organisation Apigee dans le même projet Google Cloud pendant la période de conservation.

Étapes suivantes

Références Apigee :

Références sur Service Networking et l'accès aux services privés :