Documentation Oracle Cloud Infrastructure

Suppression d'une passerelle d'API

Découvrez comment supprimer des passerelles d'API que vous avez créées précédemment avec le service API Gateway.

Après avoir créé une passerelle d'API, vous pouvez décider que la passerelle d'API n'est plus requise. Vous pouvez supprimer une passerelle d'API du service API Gateway, à condition qu'elle ne comporte aucun déploiement d'API.

Les passerelles d'API supprimées restent affichées dans la console pendant 90 jours, avec le statut Supprimé. Au bout des 90 jours, les passerelles d'API supprimées ne sont plus affichées.

    1. Sur la page de liste Passerelles, recherchez la passerelle d'API à supprimer. Si vous avez besoin d'aide pour rechercher la page de liste ou la passerelle d'API, reportez-vous à Liste des passerelles d'API.
    2. Dans le menu Actions (trois points) de la passerelle d'API, sélectionnez Supprimer.

      La passerelle d'API est définitivement enlevée. Vous ne pouvez pas supprimer une passerelle d'API si elle comporte encore des déploiements d'API. Vous devez d'abord supprimer les déploiements d'API.

  • Pour supprimer des passerelles d'API à l'aide de l'interface de ligne de commande, procédez comme suit :

    1. Configurez votre environnement client de façon à pouvoir utiliser l'interface de ligne de commande (Configuration de l'environnement client pour utiliser l'interface de ligne de commande pour le développement de passerelle d'API).

    2. Pour supprimer une passerelle d'API existante, procédez comme suit :

      1. Ouvrez une invite de commande et exécutez oci api-gateway gateway delete pour supprimer la passerelle d'API :

        oci api-gateway gateway delete --gateway-id <gateway-ocid>

        où :

        • <gateway-ocid> est l'OCID de la passerelle d'API à supprimer. Pour déterminer l'OCID de la passerelle d'API, reportez-vous à Liste des passerelles d'API.

        Par exemple :

        oci api-gateway gateway delete --gateway-id ocid1.apigateway.oc1..aaaaaaaab______hga

        Vous ne pouvez pas supprimer une passerelle d'API si elle comporte encore des déploiements d'API (y compris des déploiements d'API qui sont dans des compartiments différents de la passerelle d'API elle-même). Vous devez d'abord supprimer les déploiements d'API.

        La réponse à la commande inclut les éléments suivants :

        • Etat de cycle de vie (par exemple, DELETED ou FAILED).
        • ID de la demande de travail utilisée pour supprimer la passerelle d'API (les détails des demandes de travail sont disponibles pendant sept jours après leur fin, leur annulation ou leur échec).

        Pour que la commande attende que la passerelle d'API soit supprimée (ou que la demande ait échoué) avant de renvoyer le contrôle, incluez l'un des paramètres suivants ou les deux :

        • --wait-for-state DELETED
        • --wait-for-state FAILED

        Par exemple :

        oci api-gateway gateway delete --gateway-id ocid1.apigateway.oc1..aaaaaaaab______hga --wait-for-state DELETED

      2. (Facultatif) Pour afficher le statut de la demande de travail qui supprime la passerelle d'API, saisissez ce qui suit :

        oci api-gateway work-request get --work-request-id <work-request-ocid>

      3. (Facultatif) Pour afficher les journaux de la demande de travail qui supprime la passerelle d'API, saisissez ce qui suit :

        oci api-gateway work-request-log list --work-request-id <work-request-ocid>

      4. (Facultatif) Si la demande de travail qui supprime la passerelle d'API échoue et que vous voulez consulter les journaux d'erreurs, saisissez ce qui suit :

        oci api-gateway work-request-error --work-request-id <work-request-ocid>

      5. (Facultatif) Pour vérifier que la passerelle d'API a été supprimée, entrez la commande suivante et assurez-vous que l'état de cycle de vie de la passerelle d'API est défini sur DELETED :

        oci api-gateway gateway get --gateway-id <gateway-ocid>

    Pour plus d'informations sur l'utilisation de l'interface de ligne de commande, reportez-vous à Interface de ligne de commande (CLI). Afin d'obtenir la liste complète des indicateurs et des options disponibles pour les commandes de l'interface de ligne de commande, reportez-vous à Aide relative à l'interface de ligne de commande.

  • Exécutez l'opération DeleteGateway pour supprimer une passerelle d'API.