- 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
,…]] [--reservation-sharing-policy
=RESERVATION_SHARING_POLICY
] [--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
-
- 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.
- 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.
--reservation-sharing-policy
=RESERVATION_SHARING_POLICY
-
The reservation sharing policy to use for this reservation.
RESERVATION_SHARING_POLICY
must be one of:ALLOW_ALL
- The reservation can be shared with Google Cloud services.
DISALLOW_ALL
- The reservation won't be shared with Google Cloud services. If you omit this flag during creation, the default value is DISALLOW_ALL.
- If this reservation is shared (--share-setting is not local), provide a list of all of the specific projects that this reservation is shared with. List must contain project IDs or project numbers.
--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
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zone
To avoid prompting when this flag is omitted, you can set the
property:compute/zone
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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-20 UTC.