Supprimer une application

Cette page décrit les bonnes pratiques et fournit des instructions pour supprimer une application en toute sécurité.

Étapes à suivre pour supprimer une application

Les instructions suivantes concernent la Google Cloud console.

Console

Pour supprimer une application, procédez comme suit :

1. Dans la Google Cloud console, accédez à la Gemini Enterprise page.

   Gemini Enterprise

2. Pour l'application que vous souhaitez supprimer, cliquez sur , puis sur Supprimer.

3. Dans la boîte de dialogue Supprimer l'application ?, saisissez le nom de votre application, puis cliquez sur Confirmer.

Bonnes pratiques pour supprimer une application avec une stratégie IAM

La suppression d'une application est une action irréversible. Par conséquent, si votre application a configuré des contrôles d’accès, vous pouvez supprimer tous les utilisateurs de sa stratégie IAM avant de la supprimer. Pour ce faire, procédez comme suit :

1. Effacer la stratégie IAM : avant de supprimer l'application, effacez sa stratégie IAM pour supprimer l'accès des utilisateurs. Pour ce faire, définissez un tableau bindings vide.

   1. Obtenez la stratégie IAM actuelle de votre application à l'aide de la getIamPolicy méthode.

      REST

      Terme clé : dans Gemini Enterprise, le terme application peut être utilisé de manière interchangeable avec le terme moteur dans le contexte des API. Un moteur Gemini Enterprise est un moteur de recherche générique dans lequel le champ app_type est défini sur APP_TYPE_INTRANET.

      curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID:getIamPolicy"
      

      Remplacez les éléments suivants :

      • PROJECT_ID : l'ID du projet.
      • ENDPOINT_LOCATION : l'emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
        • us pour l'emplacement multirégional US
        • eu pour l'emplacement multirégional EU
        • global pour l'emplacement mondial
        Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
      • LOCATION: l'emplacement multirégional de votre data store : global, us ou eu
      • APP_ID: l'ID de l'application que vous souhaitez configurer.

      Remarque : Copiez la valeur etag de la réponse. Cette valeur est requise pour mettre à jour la stratégie IAM. La valeur etag change à chaque mise à jour de la stratégie.

      Exemple de commande et résultat

      curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      "https://global-discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app:getIamPolicy"
      
      {
        "version": 1,
        "etag": "1234567890"
      }
        

   2. Pour supprimer toutes les liaisons existantes, utilisez la setIamPolicy méthode avec un tableau bindings vide dans le corps de la requête.

      REST

      Terme clé : dans Gemini Enterprise, le terme application peut être utilisé de manière interchangeable avec le terme moteur dans le contexte des API. Un moteur Gemini Enterprise est un moteur de recherche générique dans lequel le champ app_type est défini sur APP_TYPE_INTRANET.

      curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
            "policy": {
              "etag": "ETAG",
              "bindings": []
            }
          }' \
      "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID:setIamPolicy"
      

      Remplacez les éléments suivants :

      • ETAG: la valeur etag que vous avez obtenue en réponse lorsque vous avez utilisé la méthode getIamPolicy.
      • PROJECT_ID : l'ID du projet.
      • ENDPOINT_LOCATION : l'emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
        • us pour l'emplacement multirégional US
        • eu pour l'emplacement multirégional EU
        • global pour l'emplacement mondial
        Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
      • LOCATION: l'emplacement multirégional de votre data store : global, us ou eu
      • APP_ID: l'ID de l'application que vous souhaitez configurer.

      Exemple de commande et résultat

      curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
            "policy": {
              "etag": "1234567890",
              "bindings": []
            }
          }' \
      "https://global-discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app:setIamPolicy"
      
      {
        "version": 1,
        "etag": "3456789012"
      }
        

2. Confirmer l'impact sur les utilisateurs : après avoir effacé la stratégie et laissé le temps de propagation, vérifiez que la révocation de l'accès n'a pas causé de problèmes involontaires pour les utilisateurs.

3. Supprimer l'application : une fois l'impact confirmé, procédez à la suppression de l'application comme décrit dans la section Étapes à suivre pour supprimer une application.