Eliminare un'app

Questa pagina descrive le best practice e le istruzioni per eliminare un'app in sicurezza.

Passaggi per eliminare un'app

Le seguenti istruzioni sono relative alla console Google Cloud .

Console

Per eliminare un'app:

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Per l'app che vuoi eliminare, fai clic su , quindi su Elimina.

3. Nella finestra di dialogo Vuoi eliminare l'app?, inserisci il nome dell'app e poi fai clic su Conferma.

Best practice per l'eliminazione di un'app con una policy IAM

L'eliminazione di un'app è un'azione irreversibile. Pertanto, se la tua app ha controlli degli accessi configurati, puoi rimuovere tutti gli utenti dalla sua policy IAM prima di eliminarla. Segui questi passaggi:

1. Cancella la policy IAM: prima di eliminare l'app, cancella la relativa policy IAM per rimuovere l'accesso degli utenti. Puoi farlo impostando un array bindings vuoto.

   1. Recupera l'attuale policy IAM della tua app utilizzando il metodo getIamPolicy.

      REST

      Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine engine nel contesto delle API. Un motore di Gemini Enterprise è un motore di ricerca generico in cui il campo app_type è impostato su 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"
      

      Sostituisci quanto segue:

      • PROJECT_ID: l'ID progetto.
      • ENDPOINT_LOCATION: la località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
        • us per la multi-regione Stati Uniti
        • eu per la multi-regione UE
        • global per la località globale
        Per saperne di più, consulta Specifica una multi-regione per il datastore.
      • LOCATION: la località multiregionale del datastore: global, us o eu
      • APP_ID: l'ID dell'app che vuoi configurare.

      Nota: copia il valore etag dalla risposta. Questo valore è obbligatorio per aggiornare la policy IAM. Il valore etag cambia a ogni aggiornamento della policy.

      Esempio di comando e risultato

      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. Per rimuovere tutte le associazioni esistenti, utilizza il metodo setIamPolicy con un array bindings vuoto nel corpo della richiesta.

      REST

      Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine engine nel contesto delle API. Un motore di Gemini Enterprise è un motore di ricerca generico in cui il campo app_type è impostato su 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"
      

      Sostituisci quanto segue:

      • ETAG: il valore etag ottenuto come risposta quando hai utilizzato il metodo getIamPolicy.
      • PROJECT_ID: l'ID progetto.
      • ENDPOINT_LOCATION: la località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
        • us per la multi-regione Stati Uniti
        • eu per la multi-regione UE
        • global per la località globale
        Per saperne di più, consulta Specifica una multi-regione per il datastore.
      • LOCATION: la località multiregionale del datastore: global, us o eu
      • APP_ID: l'ID dell'app che vuoi configurare.

      Esempio di comando e risultato

      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. Conferma l'impatto sugli utenti: dopo aver cancellato la policy e aver atteso il tempo di propagazione, verifica che la revoca dell'accesso non abbia causato problemi imprevisti per gli utenti.

3. Elimina l'app: dopo aver confermato l'impatto, procedi con l'eliminazione dell'app come descritto nella sezione Passaggi per eliminare un'app.