Borra una aplicación

En esta página, se describen las prácticas recomendadas y las instrucciones para borrar una app de forma segura.

Pasos para borrar una app

Las siguientes instrucciones son para la Google Cloud consola.

Console

Para borrar una app, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página Gemini Enterprise.

   Gemini Enterprise

2. En la app que quieres borrar, haz clic y, luego, en Borrar.

3. En el diálogo ¿Borrar la app? , ingresa el nombre de la app y, luego, haz clic en Confirmar.

Prácticas recomendadas para borrar una app con una política de IAM

Borrar una app es una acción irreversible. Por lo tanto, si tu app tiene controles de acceso configurados, puedes quitar a todos los usuarios de su política de IAM antes de borrarla. Sigue estos pasos:

1. Borra la política de IAM: Antes de borrar la app, borra su política de IAM para quitar el acceso del usuario. Para ello, configura un array bindings vacío.

   1. Obtén la política de IAM actual de tu app con el getIamPolicy método.

      REST

      Término clave: En Gemini Enterprise, el término app se puede usar indistintamente con el término motor en el contexto de las APIs. Un motor de Gemini Enterprise es un motor de búsqueda genérico en el que el campo app_type se establece en 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"
      

      Reemplaza lo siguiente:

      • PROJECT_ID: el ID de tu proyecto.
      • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
        • us para la multirregión de EE.UU.
        • eu para la multirregión de la UE
        • global para la ubicación global
        Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
      • LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
      • APP_ID: Es el ID de la app que quieres configurar.

      Nota: Copia el valor etag de la respuesta. Este valor es necesario para actualizar la política de IAM. El valor etag cambia con cada actualización de la política.

      Ejemplo de comando y resultado

      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. Para quitar todas las vinculaciones existentes, usa el setIamPolicy método con un array bindings vacío en el cuerpo de la solicitud.

      REST

      Término clave: En Gemini Enterprise, el término app se puede usar indistintamente con el término motor en el contexto de las APIs. Un motor de Gemini Enterprise es un motor de búsqueda genérico en el que el campo app_type se establece en 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"
      

      Reemplaza lo siguiente:

      • ETAG: Es el valor etag que obtuviste como respuesta cuando usaste el método getIamPolicy.
      • PROJECT_ID: el ID de tu proyecto.
      • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
        • us para la multirregión de EE.UU.
        • eu para la multirregión de la UE
        • global para la ubicación global
        Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
      • LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
      • APP_ID: Es el ID de la app que quieres configurar.

      Ejemplo de comando y resultado

      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. Confirma el impacto del usuario: Después de borrar la política y permitir el tiempo de propagación, confirma que la revocación del acceso no haya causado problemas no deseados para los usuarios.

3. Borra la app: Después de confirmar el impacto, procede con borrar la app como se describe en la sección Pasos para borrar una app.