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] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) Update Compute Engine reservations.

EXAMPLES

To add my-project 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=my-project --zone=us-central1-a

To remove my-project 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=my-project --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=my-project --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.

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