Supprimer une application

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

Étapes à suivre pour supprimer une application

Les instructions suivantes concernent la console Google Cloud .

Console

Pour supprimer une application, procédez comme suit :

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

   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 règle 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 règle IAM avant de supprimer l'application. Pour ce faire :

1. Effacez 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 méthode getIamPolicy.

      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 dont 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 : par l'ID du projet.
      • ENDPOINT_LOCATION : région multirégionale pour votre requête API. Spécifiez l'une des valeurs suivantes :
        • us pour la multirégion des États-Unis
        • eu pour la multirégion de l'UE
        • global pour l'emplacement "Global"
        Pour en savoir plus, consultez Spécifier une multirégion pour votre datastore.
      • LOCATION : région multirégionale de votre data store : global, us ou eu
      • APP_ID : ID de l'application que vous souhaitez configurer.

      Remarque : Copiez la valeur etag à partir 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 méthode setIamPolicy 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 dont 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 : valeur etag obtenue en réponse lorsque vous avez utilisé la méthode getIamPolicy.
      • PROJECT_ID : par l'ID du projet.
      • ENDPOINT_LOCATION : région multirégionale pour votre requête API. Spécifiez l'une des valeurs suivantes :
        • us pour la multirégion des États-Unis
        • eu pour la multirégion de l'UE
        • global pour l'emplacement "Global"
        Pour en savoir plus, consultez Spécifier une multirégion pour votre datastore.
      • LOCATION : région multirégionale de votre data store : global, us ou eu
      • APP_ID : 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. Confirmez l'impact sur les utilisateurs : après avoir supprimé la règle et laissé le temps de propagation, vérifiez que la révocation de l'accès n'a pas entraîné de problèmes inattendus pour les utilisateurs.

3. Supprimez l'application : une fois que vous avez confirmé l'impact, supprimez l'application comme décrit dans la section Étapes à suivre pour supprimer une application.