gcloud beta gemini cloud-assist investigations create

NAME
gcloud beta gemini cloud-assist investigations create - create a new investigation
SYNOPSIS
gcloud beta gemini cloud-assist investigations create [INVESTIGATION] --issue=ISSUE [--end-time=END_TIME] [--resources=[RESOURCE,…]] [--start-time=START_TIME] [--title=TITLE] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA) Shows metadata for the newly created investigation after creation.

This command can fail for the following reasons:

  • The chosen investigation ID, if specified, already exists.
  • The active account does not have permission to create investigations in the project.
EXAMPLES
The following command creates a new investigation with the ID and some basic information example-foo-bar-1: 
gcloud beta gemini cloud-assist investigations create example-foo-bar-1 --title="Example Investigation" --issue="I
have a problem" --start-time=2025-07-10
POSITIONAL ARGUMENTS
Investigation resource - The investigation name to create. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument investigation on the command line with a fully specified name;
  • The default is - with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument investigation on the command line with a fully specified name;
  • The default is - with a fully specified name;
  • The default is global.
[INVESTIGATION]
ID of the investigation or fully qualified identifier for the investigation.

To set the investigation attribute:

  • provide the argument investigation on the command line;
  • The default is -.
REQUIRED FLAGS
--issue=ISSUE
A description of the issue you are investigating, or an error log.
OPTIONAL FLAGS
--end-time=END_TIME
The estimated end time of the issue you are investigating.
--resources=[RESOURCE,…]
A list of resources relevant to the investigation
--start-time=START_TIME
The estimated start time of the issue you are investigating.
--title=TITLE
The desired title of the resulting investigation.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES
This command is currently in beta and might change without notice.