Manage Cloud Assist investigations

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

Before you begin

In order to get the required permissions for viewing investigations in a project, ask your administrator to grant you the Investigation Viewer (roles/geminicloudassist.investigationViewer) IAM role on the project. If you also want to modify or delete investigations in your project, ask your administrator to grant you the Investigation Admin (roles/geminicloudassist.investigationAdmin) IAM role instead.

To see the exact permissions that are required, expand the Required permissions section:
Required permissions
- geminicloudassist.investigations.get
- geminicloudassist.investigations.list
- geminicloudassist.investigationRevisions.get
- geminicloudassist.investigationRevisions.list
- geminicloudassist.investigations.delete
  - This permission is only required if you intend to delete an investigation.
You might be able to get these permissions with other predefined roles or custom roles.
Have one or more investigations associated with your project. See Create an investigation for steps to create an investigation.

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

Go to the Investigations page.

Go to Cloud Assist investigations

The investigations page lists the available investigations and shows the status of each.
Click the name of the investigation you want to review.

For more information about the content of an investigation, see Review an investigation
If you have edited and re-run the investigation, you can review earlier analyses for the investigation by clicking the Revision drop-down and selecting the revision you want to review.

Obtain an access token:
```
TOKEN=$(gcloud auth print-access-token)
```
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.
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.
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,

Go to the Investigations page.

Go to Cloud Assist investigations

The investigations page lists the available investigations and shows the status of each.
Click the name of the investigation you want to modify.

The investigation details page opens.
Click the Edit button.

The edit investigation page opens.
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.
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 Notifications button ().

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

Go to the Investigations page.

Go to Cloud Assist investigations

The investigations page lists the available investigations and shows the status of each.
Toggle the checkbox associated with the investigation you want to delete.
Click Delete.
In the dialog that appears, confirm you want to delete the investigation by clicking Delete.