gcloud-help/gcloud/alpha/compute/reservations/update

NAME
    gcloud alpha compute reservations update - update Compute Engine
        reservations

SYNOPSIS
    gcloud alpha 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
    (ALPHA) 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 alpha 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 alpha 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 alpha 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 alpha 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 alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. These variants are also available:

        $ gcloud compute reservations update

        $ gcloud beta compute reservations update