Console
    Contact Us Start free

    Manage Cloud Assist investigations

    This page shows you how to review, modify, and delete existing Gemini Cloud Assist investigations .

    Before you begin

    1. In order to get the required permissions to work with existing investigations in a project, ask your administrator to grant you one of the following IAM roles:

      • If you want to view investigations, you should be granted the Investigation Viewer ( roles/geminicloudassist.investigationViewer ) IAM role on the project.

      • If you want to modify investigations, you should be granted the Investigation Editor ( roles/geminicloudassist.investigationEditor ) IAM role on the project. This role also lets you view investigations.

      • If you want to delete investigations, you should be granted the Investigation Admin ( roles/geminicloudassist.investigationAdmin ) IAM role on the project. This role also lets you modify and view investigations.

      To see the exact permissions that are required, expand the Required permissionssection:

      Required permissions

      • geminicloudassist.investigations.get
      • geminicloudassist.investigations.list
      • geminicloudassist.investigationRevisions.get
      • geminicloudassist.investigationRevisions.list
      • The following permissions are only required if you intend to modify an investigation:
        • geminicloudassist.investigationRevisions.create
        • geminicloudassist.investigationRevisions.run
      • The following permission is only required if you intend to delete an investigation:
        • geminicloudassist.investigations.delete

      You might be able to get these permissions with other predefined roles or custom roles .

    2. Have one or more investigations associated with your project. See Create an investigation for steps to create an investigation.

    List and view investigations

    To list and view investigations associated with your project that are in progress or complete, complete the following steps:

    Console

    1. Go to the Investigationspage.

      Go to Cloud Assist investigations

      The investigations page lists the available investigations and shows the status of each.

    2. Click the name of the investigation you want to review.

      For more information about the content of an investigation, see Review an investigation

    3. If you have edited and re-run the investigation , you can review earlier analyses for the investigation by clicking the Revisiondrop-down and selecting the revision you want to review.

    API

    1. Obtain an access token:

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

    2. Use the investigations.list method to list investigations associated with a project:

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

      Replace PROJECT_NAME with the name of the project whose investigations you want to list. For example, my-project .

    3. Use the investigations.get method to get the details of a specific investigation:

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

      Replace the following:

      • PROJECT_NAME : Enter the name of the project in which the investigation is stored. For example, my-project .

      • INVESTIGATION_NAME : Enter the string identifier of the investigation that you want to review. For example, 8622ceec-8204-4bcf-aa22-7166e674d429 .

    4. If you have edited and re-run the investigation , you can list the revisions associated with the investigation by using the investigationRevisions.list method , and you can review the information for a specific revision by using the investigationRevisions.get method ,

    Modify an investigation

    Console

    1. Go to the Investigationspage.

      Go to Cloud Assist investigations

      The investigations page lists the available investigations and shows the status of each.

    2. Click the name of the investigation you want to modify.

      The investigation details page opens.

    3. Click the Editbutton.

      The edit investigation page opens.

    4. Modify the details of the investigation as wanted, such as changing the description of the issue, the start time of the issue, or the relevant resources associated with the issue.

    5. Click Save and run.

      A new analysis occurs based on your updated information. It can take up to several minutes for the investigation to complete. You can check the status of the investigation by clicking the Notificationsbutton ( ).

    Delete an investigation

    To delete an investigation associated with your project, complete the following steps:

    Console

    1. Go to the Investigationspage.

      Go to Cloud Assist investigations

      The investigations page lists the available investigations and shows the status of each.

    2. Toggle the checkbox associated with the investigation you want to delete.

    3. Click Delete.

    4. In the dialog that appears, confirm you want to delete the investigation by clicking Delete.

    API

    1. Obtain an access token:

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

    2. Use the investigations.delete method to delete the investigation:

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

      Replace the following:

      • PROJECT_NAME : Enter the name of the project in which the investigation is stored. For example, my-project .

      • INVESTIGATION_NAME : Enter the string identifier of the investigation that you want to delete. For example, 8622ceec-8204-4bcf-aa22-7166e674d429 .

    What's next
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: