mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-11 15:39:42 +00:00
gcloud: Wed May 7 10:56:18 UTC 2025
This commit is contained in:
Automated
parent
b03a332ad8
commit
dfebca5b6c
222 changed files with 6775 additions and 1046 deletions
194
gcloud/beta/compute/advice/calendar-mode
Normal file
194
gcloud/beta/compute/advice/calendar-mode
Normal file
|
|
@ -0,0 +1,194 @@
|
|||
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
|
||||
|
||||
29
gcloud/beta/compute/advice/help
Normal file
29
gcloud/beta/compute/advice/help
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
NAME
|
||||
gcloud beta compute advice - provides recommendation on optimal allocation
|
||||
of resources according to a flexible specifications
|
||||
|
||||
SYNOPSIS
|
||||
gcloud beta compute advice COMMAND [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
(BETA) Provides recommendation on optimal allocation of resources according
|
||||
to a flexible specifications.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --help.
|
||||
|
||||
Run $ gcloud help for details.
|
||||
|
||||
COMMANDS
|
||||
COMMAND is one of the following:
|
||||
|
||||
calendar-mode
|
||||
(BETA) Recommends the optimal time window and zone for Future
|
||||
Reservations.
|
||||
|
||||
NOTES
|
||||
This command is currently in beta and might change without notice. This
|
||||
variant is also available:
|
||||
|
||||
$ gcloud alpha compute advice
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue