Administra las investigaciones de Cloud Assist

En esta página, se muestra cómo revisar, modificar y borrar las investigaciones de Gemini Cloud Assist existentes.

Antes de comenzar

  1. Para obtener los permisos necesarios para trabajar con las investigaciones existentes en un proyecto, pídele a tu administrador que te otorgue uno de los siguientes roles de IAM:

    • Si quieres ver las investigaciones, se te debe otorgar el rol de IAM de Visualizador de investigaciones (roles/geminicloudassist.investigationViewer) en el proyecto.

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

    • Si quieres borrar investigaciones, se te debe otorgar el rol de IAM de 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 son necesarios, expande la sección Permisos necesarios:

    Permisos necesarios

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

    Puedes obtener estos permisos con otros roles predefinidos o roles personalizados.

  2. Tener una o más investigaciones asociadas a tu proyecto Consulta Crea una investigación para conocer los pasos para crear una investigación.

Cómo enumerar y ver investigaciones

Para enumerar y ver las investigaciones asociadas con tu proyecto que están en curso o completadas, completa los siguientes pasos:

Console

  1. Ve a la página Investigaciones.

    Ir a las investigaciones de Cloud Assist

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

  2. Haz clic en el nombre de la investigación que deseas revisar.

    Para obtener más información sobre el contenido de una investigación, consulta Cómo revisar una investigación.

  3. Si editaste y volviste a ejecutar la investigación, puedes revisar los análisis anteriores de la investigación haciendo clic en el menú desplegable Revisión y seleccionando la revisión que deseas revisar.

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 con un proyecto:

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

    Reemplaza PROJECT_NAME por el nombre del proyecto cuyas investigaciones deseas 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"

    Reemplaza lo siguiente:

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

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

  4. Si editaste y volviste a ejecutar la investigación, puedes enumerar las revisiones asociadas a la investigación con el método investigationRevisions.list y revisar la información de una revisión específica con el método investigationRevisions.get.

Cómo modificar una investigación

Console

  1. Ve a la página Investigaciones.

    Ir a las investigaciones de Cloud Assist

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

  2. Haz clic en el nombre de la investigación que deseas 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 desees, por ejemplo, cambia la descripción del problema, la hora de inicio o los recursos relevantes asociados con el problema.

  5. Haz clic en Guardar y ejecutar.

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

Borra una investigación

Para borrar una investigación asociada a tu proyecto, completa los siguientes pasos:

Console

  1. Ve a la página Investigaciones.

    Ir a las investigaciones de Cloud Assist

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

  2. Activa la casilla de verificación asociada con la investigación que deseas borrar.

  3. Haz clic en Borrar.

  4. En el cuadro de diálogo que aparece, haz clic en Borrar para confirmar que deseas borrar la investigación.

API

  1. Obtén un token de acceso:

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

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

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

    Reemplaza lo siguiente:

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

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

¿Qué sigue?