.TH "GCLOUD_BETA_COMPUTE_ADVICE_CALENDAR\-MODE" 1



.SH "NAME"
.HP
gcloud beta compute advice calendar\-mode \- recommends the optimal time window and zone for Future Reservations



.SH "SYNOPSIS"
.HP
\f5gcloud beta compute advice calendar\-mode\fR ([\fB\-\-chip\-count\fR=\fICHIP_COUNT\fR\ \fB\-\-tpu\-version\fR=\fITPU_VERSION\fR\ :\ \fB\-\-workload\-type\fR=\fIWORKLOAD_TYPE\fR]\ |\ \fB\-\-machine\-type\fR=\fIMACHINE_TYPE\fR\ \fB\-\-vm\-count\fR=\fIVM_COUNT\fR) [\fB\-\-duration\-range\fR=[\fImax\fR=\fIMAX\fR],[\fImin\fR=\fIMIN\fR]] [\fB\-\-end\-time\-range\fR=[\fIfrom\fR=\fIFROM\fR],[\fIto\fR=\fITO\fR]] [\fB\-\-location\-policy\fR=[\fIZONE\fR=\fIPOLICY\fR,...]] [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-start\-time\-range\fR=[\fIfrom\fR=\fIFROM\fR],[\fIto\fR=\fITO\fR]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Recommends the optimal time window and zone for Future
Reservations.



.SH "EXAMPLES"

To request an advice for a future reservation of 8 a3\-highgpu\-8g VMs, run:

.RS 2m
$ gcloud beta compute advice calendar\-mode \-\-region=fake\-region \e
    \-\-machine\-type=a3\-megagpu\-8g \-\-vm\-count=8 \e
    \-\-duration\-range=min=7d,max=14d \e
    \-\-start\-time\-range=from=2025\-02\-20,to=2025\-03\-25 \e
    \-\-end\-time\-range=from=2025\-02\-20,to=2025\-03\-25
.RE

To request advice for a future reservation of 512 v5e TPUs, run:

.RS 2m
$ gcloud beta compute advice calendar\-mode \-\-region=fake\-region \e
    \-\-location\-policy=fake\-zone\-1=DENY,fake\-zone\-2=ALLOW \e
    \-\-tpu\-version=V5E \-\-chip\-count=16 \-\-workload\-type=BATCH \e
    \-\-duration\-range=min=30d,max=90d \e
    \-\-start\-time\-range=from=2025\-02\-25,to=2025\-06\-25 \e
    \-\-end\-time\-range=from=2025\-02\-25,to=2025\-06\-25
.RE



.SH "REQUIRED FLAGS"

.RS 2m
Specify the properties of the resources that you want to view the availability of.
.RE


Exactly one of these must be specified:


.RS 2m
You must define the version and number of TPUs to reserve.
.RE



.RS 2m
.TP 2m
\fB\-\-chip\-count\fR=\fICHIP_COUNT\fR

The number of chips to check for availability.

This flag argument must be specified if any of the other arguments in this group
are specified.

.RS 2m
.TP 2m
\fB\-\-tpu\-version\fR=\fITPU_VERSION\fR

The version of Cloud TPU to reserve. \fITPU_VERSION\fR must be one of:

.RS 2m
.TP 2m
\fBV5E\fR
Cloud TPU v5e Lite
.RS 2m
.TP 2m
\fBV5P\fR
Cloud TPU v5p
.TP 2m
\fBV6E\fR
Cloud TPU v6e
.RE
.sp


This flag argument must be specified if any of the other arguments in this group
are specified.

.TP 2m
\fB\-\-workload\-type\fR=\fIWORKLOAD_TYPE\fR

Type of the workload that will be running on the reserved TPUs.
\fIWORKLOAD_TYPE\fR must be one of:

.RS 2m
.TP 2m
\fBBATCH\fR
Reserved resources will be optimized for BATCH workloads that handle large
amounts of data in single or multiple operations, such as ML training workloads.
.TP 2m
\fBSERVING\fR
Reserved resources will be optimized for SERVING workloads that handle
concurrent requests and require minimal network latency, such as ML inference.
.RE
.sp


.RE
.RE
.sp
.RS 2m
Define individual instance properties for the specific SKU reservation.
.RE



.RS 2m
.TP 2m
\fB\-\-machine\-type\fR=\fIMACHINE_TYPE\fR

The type of machine (name only) that has a fixed number of vCPUs and a fixed
amount of memory. You can also specify a custom machine type by using the
pattern \f5custom\-number_of_CPUs\-amount_of_memory\fR\-for example,
\f5custom\-32\-29440\fR.

This flag argument must be specified if any of the other arguments in this group
are specified.

.RS 2m
.TP 2m
\fB\-\-vm\-count\fR=\fIVM_COUNT\fR

The number of instances to check for availability.

This flag argument must be specified if any of the other arguments in this group
are specified.


.RE
.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-duration\-range\fR=[\fImax\fR=\fIMAX\fR],[\fImin\fR=\fIMIN\fR]

A duration range for the duration of the Future Reservation. Defined as a list
of key\-value pairs.

The key is either "min" or "max", and the value is a duration in seconds. For
example, specify \f530m\fR for a duration of 30 minutes or specify
\f51d2h3m4s\fR for a duration of 1 day, 2 hours, 3 minutes, and 4 seconds.

See $ gcloud topic datetimes for information on duration formats.

.RS 2m
.TP 2m
\fBmin\fR
The minimum duration of the Future Reservation.
.TP 2m
\fBmax\fR
The maximum duration of the Future Reservation.

Example:

.RS 2m
gcloud compute advice calendar\-mode \-\-duration\-range=min=24h,max=72h
.RE

.RE
.sp
.TP 2m
\fB\-\-end\-time\-range\fR=[\fIfrom\fR=\fIFROM\fR],[\fIto\fR=\fITO\fR]

A time range for the end time of the Future Reservation. Defined as a list of
key\-value pairs.

The key is either "from" or "to", and the value is a datetime. See $ gcloud
topic datetimes for information on time formats.

.RS 2m
.TP 2m
\fBfrom\fR
The earliest possible end time for the reservation.
.TP 2m
\fBto\fR
The latest possible end time for the reservation.

Example:

.RS 2m
gcloud compute advice calendar\-mode \-\-end\-time\-range=from=2024\-08\-01T00:00:00Z,to=2024\-08\-02T00:00:00Z
.RE

.RE
.sp
.TP 2m
\fB\-\-location\-policy\fR=[\fIZONE\fR=\fIPOLICY\fR,...]

Policy for which zones to include or exclude when looking for the optimal time
window and zone for Future Reservations within a region. Policy is defined as a
list of key\-value pairs, with the key being the zone name, and value being the
applied policy. Available policies are \f5allow\fR and \f5deny\fR. Default for
zones if left unspecified is \f5allow\fR.

Example:

.RS 2m
gcloud compute advice calendar\-mode \-\-location\-policy=us\-central1\-a=allow,us\-central1\-b=deny
.RE

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Region of the to None. If not specified, you might be prompted to select a
region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.

.TP 2m
\fB\-\-start\-time\-range\fR=[\fIfrom\fR=\fIFROM\fR],[\fIto\fR=\fITO\fR]

A time range for the start time of the Future Reservation. Defined as a list of
key\-value pairs.

The key is either "from" or "to", and the value is a datetime. See $ gcloud
topic datetimes for information on time formats.

.RS 2m
.TP 2m
\fBfrom\fR
The earliest possible start time for the reservation.
.TP 2m
\fBto\fR
The latest possible start time for the reservation.

Example:

.RS 2m
gcloud compute advice calendar\-mode \-\-start\-time\-range=from=2024\-08\-01T00:00:00Z,to=2024\-08\-02T00:00:00Z
.RE


.RE
.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

This command is currently in beta and might change without notice. This variant
is also available:

.RS 2m
$ gcloud alpha compute advice calendar\-mode
.RE