gcloud-help/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)
        [--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:

              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.

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 <a
        href="https://cloud.google.com/sdk/gcloud/reference/topic/datetimes"> $
        gcloud topic datetimes</a> for information on duration format.

         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 <a
        href="https://cloud.google.com/sdk/gcloud/reference/topic/datetimes"> $
        gcloud topic datetimes</a> 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 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
        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 <a
        href="https://cloud.google.com/sdk/gcloud/reference/topic/datetimes"> $
        gcloud topic datetimes</a> 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. This
    variant is also available:

        $ gcloud alpha compute advice calendar-mode