HEX
Server: Apache/2.4.65 (Ubuntu)
System: Linux ielts-store-v2 6.8.0-1036-gcp #38~22.04.1-Ubuntu SMP Thu Aug 14 01:19:18 UTC 2025 x86_64
User: root (0)
PHP: 7.2.34-54+ubuntu20.04.1+deb.sury.org+1
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,
Upload Files
File: //snap/google-cloud-cli/current/lib/surface/gemini/cloud_assist/investigations/update.py
# -*- coding: utf-8 -*- #
# Copyright 2025 Google LLC. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Command to create a new investigation."""

from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals

import datetime

from googlecloudsdk.api_lib.gemini_cloud_assist import args as gca_args
from googlecloudsdk.api_lib.gemini_cloud_assist import util as gca_util
from googlecloudsdk.calliope import arg_parsers
from googlecloudsdk.calliope import base
from googlecloudsdk.core.util import times


@base.DefaultUniverseOnly
class Create(base.Command):
  r"""Update an existing investigation.

  Shows metadata for the investigation after updating.

  This command can fail for the following reasons:
  * The investigation ID doesn't exist.
  * The active account does not have permission to update the investigation.
  * The investigation is currently running.

  ## EXAMPLES

  The following command updates title, text description, resources, and start
  time of the existing investigation with the name`example-foo-bar-1`:

    $ {command} example-foo-bar-1 --title="Example Investigation" \
        --issue="I have a problem" --start-time=2025-07-10
  """

  @staticmethod
  def Args(parser):
    gca_args.AddInvestigationResourceArg(
        parser, verb="to update", required=True, allow_no_id=False
    )
    parser.display_info.AddFormat("value(investigation_markdown_detailed())")
    parser.add_argument(
        "--issue",
        required=False,
        help=(
            "A description of the issue you are investigating, or an error log."
        ),
    )

    start_time_group = parser.add_mutually_exclusive_group(sort_args=False)
    start_time_group.add_argument(
        "--start-time",
        required=False,
        type=times.ParseDateTime,
        help="The estimated start time of the issue you are investigating.",
    )
    start_time_group.add_argument(
        "--clear-start-time",
        required=False,
        action="store_true",
        help="Clear the start time of the investigation.",
    )

    end_time_group = parser.add_mutually_exclusive_group(sort_args=False)
    end_time_group.add_argument(
        "--end-time",
        required=False,
        type=times.ParseDateTime,
        help="The estimated end time of the issue you are investigating.",
    )
    end_time_group.add_argument(
        "--clear-end-time",
        required=False,
        action="store_true",
        help="Clear the end time of the investigation.",
    )

    title_group = parser.add_mutually_exclusive_group(sort_args=False)
    title_group.add_argument(
        "--title",
        required=False,
        help="The desired title of the resulting investigation.",
    )
    title_group.add_argument(
        "--clear-title",
        required=False,
        action="store_true",
        help="Clear the title of the investigation.",
    )

    resources_group = parser.add_mutually_exclusive_group(sort_args=False)
    resources_group.add_argument(
        "--resources",
        required=False,
        metavar="RESOURCE",
        type=arg_parsers.ArgList(),
        help="A list of resources relevant to the investigation",
    )
    resources_group.add_argument(
        "--clear-resources",
        required=False,
        action="store_true",
        help="Clear the resources of the investigation.",
    )

  def Run(self, args):
    investigation_ref = args.CONCEPTS.investigation.Parse()
    updated_investigation = gca_util.UpdateInvestigation(
        investigation_ref,
        "" if args.clear_title else args.title,
        args.issue,
        datetime.datetime.min if args.clear_start_time else args.start_time,
        datetime.datetime.max if args.clear_end_time else args.end_time,
        [] if args.clear_resources else args.resources,
    )
    return gca_util.RunInvestigationRevisionBlocking(
        updated_investigation.revision
    )