gcloud-help/gcloud/beta/compute/reservations/update

NAME
    gcloud beta compute reservations update - update Compute Engine
        reservations

SYNOPSIS
    gcloud beta compute reservations update RESERVATION
        [--add-share-with=PROJECT,[PROJECT,...]]
        [--remove-share-with=PROJECT,[PROJECT,...]]
        [--share-with=SHARE_WITH,[SHARE_WITH,...]] [--vm-count=VM_COUNT]
        [--zone=ZONE]
        [--delete-after-duration=DELETE_AFTER_DURATION
          | --delete-at-time=DELETE_AT_TIME | --disable-auto-delete]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Update Compute Engine reservations.

EXAMPLES
    To add project-1,project-2,project-3 to the list of projects that are
    shared with a Compute Engine reservation, my-reservation in zone:
    us-central1-a, run:

        $ gcloud beta compute reservations update my-reservation \
          --add-share-with=project-1,project-2,project-3 \
          --zone=us-central1-a

    To remove project-1,project-2,project-3 from the list of projects that are
    shared with a Compute Engine reservation, my-reservation in zone:
    us-central1-a, run:

        $ gcloud beta compute reservations update my-reservation \
          --remove-share-with=project-1,project-2,project-3 \
          --zone=us-central1-a

    To update the entire list of projects that are shared with a Compute Engine
    reservation, my-reservation in zone: us-central1-a, run:

        $ gcloud beta compute reservations update my-reservation \
          --share-with=project-1,project-2,project-3 --zone=us-central1-a

    To update the number of reserved VM instances to 500 for a Compute Engine
    reservation, my-reservation in zone: us-central1-a, run:

        $ gcloud beta compute reservations update my-reservation \
          --zone=us-central1-a --vm-count=500

POSITIONAL ARGUMENTS
     RESERVATION
        Name of the reservation to update.

FLAGS
     --add-share-with=PROJECT,[PROJECT,...]
        A list of specific projects to add to the list of projects that this
        reservation is shared with. List must contain project IDs or project
        numbers.

     --remove-share-with=PROJECT,[PROJECT,...]
        A list of specific projects to remove from the list of projects that
        this reservation is shared with. List must contain project IDs or
        project numbers.

     --share-with=SHARE_WITH,[SHARE_WITH,...]
        If this reservation is shared (--share-setting is not local), provide a
        list of all of the specific projects or folders that this reservation
        is shared with. List must contain project IDs or project numbers or
        folder IDs.

     --vm-count=VM_COUNT
        The number of VM instances that are allocated to this reservation. The
        value of this field must be an int in the range [1, 1000].

     --zone=ZONE
        Zone of the reservation to update. If not specified and the
        compute/zone property isn't set, you might be prompted to select a zone
        (interactive mode only).

        To avoid prompting when this flag is omitted, you can set the
        compute/zone property:

            $ gcloud config set compute/zone ZONE

        A list of zones can be fetched by running:

            $ gcloud compute zones list

        To unset the property, run:

            $ gcloud config unset compute/zone

        Alternatively, the zone can be stored in the environment variable
        CLOUDSDK_COMPUTE_ZONE.

     Manage auto-delete properties for reservations.

     At most one of these can be specified:

       --delete-after-duration=DELETE_AFTER_DURATION
          Automatically deletes the reservations after a specified number of
          days, hours, minutes, or seconds from its creation. For example,
          specify 30m for 30 minutes, or 1d2h3m4s for 1 day, 2 hours, 3
          minutes, and 4 seconds. For more information, see $ gcloud topic
          datetimes.

       --delete-at-time=DELETE_AT_TIME
          Automatically deletes the reservation at a specific time from its
          creation. The specified time must be an RFC3339 timestamp, which must
          be formatted as "YYYY-MM-DDTHH:MM:SSZ" where YYYY = year, MM = month,
          DD = day, HH = hours, MM = minutes, SS = seconds, and Z = time zone
          in Coordinated Universal Time (UTC). For example, specify
          2021-11-20T07:00:00Z.

       --disable-auto-delete
          Disables the auto-delete setting for the reservation.

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. These
    variants are also available:

        $ gcloud compute reservations update

        $ gcloud alpha compute reservations update