Gestionar investigaciones de Cloud Assist

En esta página se explica cómo revisar, modificar y eliminar investigaciones de Gemini Cloud Assist.

Antes de empezar

  1. Para obtener los permisos necesarios para trabajar con investigaciones de un proyecto, pide a tu administrador que te conceda uno de los siguientes roles de gestión de identidades y accesos:

    • Si quieres ver las investigaciones, debes tener el rol de gestión de identidades y accesos Lector de investigaciones (roles/geminicloudassist.investigationViewer) en el proyecto.

    • Si quieres modificar investigaciones, debes tener el rol de gestión de identidades y accesos Editor de investigaciones (roles/geminicloudassist.investigationEditor) en el proyecto. Este rol también te permite ver investigaciones.

    • Si quieres eliminar investigaciones, debes tener el rol de gestión de identidades y accesos Administrador de investigaciones (roles/geminicloudassist.investigationAdmin) en el proyecto. Este rol también te permite modificar y ver investigaciones.

    Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

    Permisos obligatorios

    • geminicloudassist.investigations.get
    • geminicloudassist.investigations.list
    • geminicloudassist.investigationRevisions.get
    • geminicloudassist.investigationRevisions.list
    • Los siguientes permisos solo son necesarios si tiene intención de modificar una investigación:
      • geminicloudassist.investigationRevisions.create
      • geminicloudassist.investigationRevisions.run
    • El siguiente permiso solo es necesario si tiene intención de eliminar una investigación:
      • geminicloudassist.investigations.delete

    Puede que puedas obtener estos permisos con otros roles predefinidos o roles personalizados.

  2. Tener una o varias investigaciones asociadas a tu proyecto. Consulta los pasos para crear una investigación en el artículo Crear una investigación.

Mostrar y ver investigaciones

Para ver una lista de las investigaciones asociadas a tu proyecto que están en curso o completadas, sigue estos pasos:

Consola

  1. Ve a la página Investigaciones.

    Ir a Cloud Assist Investigations

    En la página de investigaciones se muestran las investigaciones disponibles y el estado de cada una.

  2. Haga clic en el nombre de la investigación que quiera revisar.

    Para obtener más información sobre el contenido de una investigación, consulta el artículo Revisar una investigación.

  3. Si has editado y vuelto a ejecutar la investigación, puedes consultar los análisis anteriores de la investigación haciendo clic en el menú desplegable Revisión y seleccionando la revisión que quieras consultar.

API

  1. Obtén un token de acceso:

    TOKEN=$(gcloud auth print-access-token)

  2. Usa el método investigations.list para enumerar las investigaciones asociadas a un proyecto:

    curl -X GET \
      -H "Authorization: Bearer $TOKEN" \
      "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations"
    

    Sustituye PROJECT_NAME por el nombre del proyecto cuyas investigaciones quieras enumerar. Por ejemplo, my-project.

  3. Usa el método investigations.get para obtener los detalles de una investigación específica:

    curl -X GET \
      -H "Authorization: Bearer $TOKEN" \
      "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations/INVESTIGATION_NAME"
    

    Haz los cambios siguientes:

    • PROJECT_NAME: Introduce el nombre del proyecto en el que se almacena la investigación. Por ejemplo, my-project.

    • INVESTIGATION_NAME: introduce el identificador de cadena de la investigación que quieras revisar. Por ejemplo, 8622ceec-8204-4bcf-aa22-7166e674d429.

  4. Si has editado y vuelto a ejecutar la investigación, puedes enumerar las revisiones asociadas a la investigación mediante el método investigationRevisions.list y consultar la información de una revisión concreta mediante el método investigationRevisions.get.

Modificar una investigación

Consola

  1. Ve a la página Investigaciones.

    Ir a Cloud Assist Investigations

    En la página de investigaciones se muestran las investigaciones disponibles y el estado de cada una.

  2. Haz clic en el nombre de la investigación que quieras modificar.

    Se abrirá la página de detalles de la investigación.

  3. Haz clic en el botón Editar.

    Se abrirá la página de edición de la investigación.

  4. Modifica los detalles de la investigación como quieras, por ejemplo, cambiando la descripción del problema, la hora de inicio o los recursos relevantes asociados al problema.

  5. Haga clic en Guardar y ejecutar.

    Se realiza un nuevo análisis en función de la información actualizada. La investigación puede tardar varios minutos en completarse. Para consultar el estado de la investigación, haz clic en el botón Notificaciones ().

Eliminar una investigación

Para eliminar una investigación asociada a tu proyecto, sigue estos pasos:

Consola

  1. Ve a la página Investigaciones.

    Ir a Cloud Assist Investigations

    En la página de investigaciones se muestran las investigaciones disponibles y el estado de cada una.

  2. Activa la casilla asociada a la investigación que quieras eliminar.

  3. Haz clic en Eliminar.

  4. En el cuadro de diálogo que aparece, confirma que quieres eliminar la investigación haciendo clic en Eliminar.

API

  1. Obtén un token de acceso:

    TOKEN=$(gcloud auth print-access-token)

  2. Usa el método investigations.delete para eliminar la investigación:

    curl -X DELETE \
      -H "Authorization: Bearer $TOKEN" \
      "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations/INVESTIGATION_NAME"
    

    Haz los cambios siguientes:

    • PROJECT_NAME: Introduce el nombre del proyecto en el que se almacena la investigación. Por ejemplo, my-project.

    • INVESTIGATION_NAME: introduce el identificador de cadena de la investigación que quieras eliminar. Por ejemplo, 8622ceec-8204-4bcf-aa22-7166e674d429.

Siguientes pasos