Console
    Start free

    gcloud beta compute advice calendar-mode

    NAME
    gcloud beta compute advice calendar-mode - recommends the optimal time window and zone for Future Reservations
    SYNOPSIS
    gcloud beta compute advice calendar-mode ([ --chip-count = CHIP_COUNT --tpu-version = TPU_VERSION : --workload-type = WORKLOAD_TYPE ]     | [ --machine-type = MACHINE_TYPE --vm-count = VM_COUNT : --local-ssd =[ interface = INTERFACE ], [ size = SIZE ]]) [ --duration-range =[ max = MAX ], [ min = MIN ]] [ --end-time-range =[ from = FROM ], [ to = TO ]] [ --location-policy =[ ZONE = POLICY , …]] [ --region = REGION ] [ --start-time-range =[ from = FROM ], [ to = TO ]] [ GCLOUD_WIDE_FLAG … ]
    DESCRIPTION
    (BETA) Recommends the optimal time window and zone for Future Reservations.
    EXAMPLES
    To request an advice for a future reservation of 8 a3-highgpu-8g VMs, run: 
     gcloud  
beta  
compute  
advice  
calendar-mode  
 --region 
 = 
fake-region  
 --machine-type 
 = 
a3-megagpu-8g  
 --vm-count 
 = 
 8 
  
 --duration-range 
 = 
 min 
 = 
7d,max = 
14d  
 --start-time-range 
 = 
 from 
 = 
 2025 
-02-20,to = 
 2025 
-03-25  
 --end-time-range 
 = 
 from 
 = 
 2025 
-02-20,to = 
 2025 
-03-25

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

     gcloud  
beta  
compute  
advice  
calendar-mode  
 --region 
 = 
fake-region  
 --location-policy 
 = 
fake-zone-1 = 
DENY,fake-zone-2 = 
ALLOW  
 --tpu-version 
 = 
V5E  
 --chip-count 
 = 
 16 
  
 --workload-type 
 = 
BATCH  
 --duration-range 
 = 
 min 
 = 
30d,max = 
90d  
 --start-time-range 
 = 
 from 
 = 
 2025 
-02-25,to = 
 2025 
-06-25  
 --end-time-range 
 = 
 from 
 = 
 2025 
-02-25,to = 
 2025 
-06-25
    REQUIRED FLAGS
    Specify  
the  
properties  
of  
the  
resources  
that  
you  
want  
to  
view  
the  
availability  
of.
     Exactly one of these must be specified: 
    You  
must  
define  
the  
version  
and  
number  
of  
TPUs  
to  
reserve.
    --chip-count = CHIP_COUNT
    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.

    --tpu-version = TPU_VERSION
    The version of Cloud TPU to reserve. TPU_VERSION must be one of:
    TPU7X
    Cloud TPU v7x
    V5E
    Cloud TPU v5e Lite
    V5P
    Cloud TPU v5p
    V6E
    Cloud TPU v6e
    This flag argument must be specified if any of the other arguments in this group are specified.
    --workload-type = WORKLOAD_TYPE
    Type of the workload that will be running on the reserved TPUs. WORKLOAD_TYPE must be one of:
    BATCH
    Reserved resources will be optimized for BATCH workloads that handle large amounts of data in single or multiple operations, such as ML training workloads.
    SERVING
    Reserved resources will be optimized for SERVING workloads that handle concurrent requests and require minimal network latency, such as ML inference.
    Define  
individual  
instance  
properties  
 for 
  
the  
specific  
SKU  
reservation.
    --machine-type = MACHINE_TYPE
    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 custom-number_of_CPUs-amount_of_memory -for example, custom-32-29440 .

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

    --vm-count = VM_COUNT
    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.

    --local-ssd =[ interface = INTERFACE ],[ size = SIZE ]
    Manage the size and the interface of local SSD to use. See https://cloud.google.com/compute/docs/disks/local-ssd for more information.
    interface
    The kind of disk interface exposed to the VM for this SSD. The only valid value is nvme .
    size
    The size of the local SSD in base-2 GB.
    OPTIONAL FLAGS
    --duration-range =[ max = MAX ],[ min = MIN ]
    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 30m for a duration of 30 minutes or specify 1d2h3m4s for a duration of 1 day, 2 hours, 3 minutes, and 4 seconds.

    See $ gcloud topic datetimes for information on duration formats.

    min
    The minimum duration of the Future Reservation.
    max
    The maximum duration of the Future Reservation.

    Example:

    gcloud  
compute  
advice  
calendar-mode  
--duration-range = 
 min 
 = 
24h,max = 
72h
    --end-time-range =[ from = FROM ],[ to = TO ]
    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.

    from
    The earliest possible end time for the reservation.
    to
    The latest possible end time for the reservation.

    Example:

    gcloud  
compute  
advice  
calendar-mode  
--end-time-range = 
 from 
 = 
 2024 
-08-01T00:00:00Z,to = 
 2024 
-08-02T00:00:00Z
    --location-policy =[ ZONE = POLICY ,…]
    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 allow and deny . Default for zones if left unspecified is allow .

    Example:

    gcloud  
compute  
advice  
calendar-mode  
--location-policy = 
us-central1-a = 
allow,us-central1-b = 
deny
    --region = REGION
    Region of the resources to get advice on. 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 compute/region property:

      gcloud  
config  
 set 
 
  
compute/region  
REGION

    A list of regions can be fetched by running:

      gcloud  
compute  
regions  
list

    To unset the property, run:

      gcloud  
config  
 unset 
 
  
compute/region

    Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION .

    --start-time-range =[ from = FROM ],[ to = TO ]
    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.

    from
    The earliest possible start time for the reservation.
    to
    The latest possible start time for the reservation.

    Example:

    gcloud  
compute  
advice  
calendar-mode  
--start-time-range = 
 from 
 = 
 2024 
-08-01T00:00:00Z,to = 
 2024 
-08-02T00:00:00Z
    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  
advice  
calendar-mode 
 

      gcloud  
alpha  
compute  
advice  
calendar-mode 
 

      gcloud  
preview  
compute  
advice  
calendar-mode
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: