- release_tracks: [ALPHA, BETA]

  help_text:
    brief: Update a restore.
    description: |
      Update a Backup for GKE restore.

      ## EXAMPLES

      To update a restore ``my-restore'' in project ``my-project'' in location ``us-central1'' under restore plan ``my-restore-plan'' to add new description, run:

        $ {command} my-restore --project=my-project --location=us-central1 --restore-plan=my-restore-plan --description="New description"

  request:
    collection: gkebackup.projects.locations.restorePlans.restores
    api_version: v1

  async:
    collection: gkebackup.projects.locations.operations

  arguments:
    resource:
      help_text: |
        Name of the restore to update. The name may be provided either as a relative name, e.g.
        `projects/<project>/locations/<location>/restorePlans/<restorePlan>/restores/<restore>`
        or as a single ID name (with the parent resources provided via options or through
        properties), e.g.
        `RESTORE --project=<project> --location=<location> --restore-plan=<restore-plan>`.
      spec: !REF googlecloudsdk.command_lib.container.backup_restore.resources:restore

    params:
    - _REF_: googlecloudsdk.command_lib.container.backup_restore.flags:restore_etag
    - arg_name: description
      api_field: restore.description
      type: str
      help_text: |
        Optional text description for the restore.

    labels:
      api_field: restore.labels

  update:
    read_modify_update: true