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 consola de Google Cloud .

Console

Para borrar una app, sigue estos pasos:

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

   Gemini Enterprise

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

3. En el cuadro de diálogo ¿Quieres 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 de los usuarios. Para ello, configura un array bindings vacío.

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

      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 multirregión 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 multirregión 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 deseas configurar.

      Nota: Copia el valor etag de la respuesta. Este valor es obligatorio para actualizar la política de IAM. El valor de 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 método setIamPolicy 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 de etag que obtuviste como respuesta cuando usaste el método getIamPolicy.
      • PROJECT_ID: el ID de tu proyecto.
      • ENDPOINT_LOCATION: Es la multirregión 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 multirregión 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 deseas 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 en los usuarios: 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, continúa con la eliminación de la app como se describe en la sección Pasos para borrar una app.