1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-13 08:27:05 +00:00
gcloud-help/gcloud/compute/reservations/sub-blocks/list
2025-07-17 11:02:31 +00:00

104 lines
3.9 KiB
Text

NAME
gcloud compute reservations sub-blocks list - list Compute Engine
reservation sub-blocks
SYNOPSIS
gcloud compute reservations sub-blocks list RESERVATION
--block-name=BLOCK_NAME [--zone=ZONE] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
gcloud compute reservations sub-blocks list displays all Compute Engine
reservation sub-blocks in an extended reservation's block.
EXAMPLES
To list all reservation sub-blocks in an extended reservation's block
my-block in table form, run:
$ gcloud compute reservations sub-blocks list extended-reservation \
--block-name=my-block --zone=us-central1-a --project=my-project
To list the URIs of all reservation blocks in an extended reservation, run:
$ gcloud compute reservations sub-blocks list extended-reservation \
--block-name=my-block --zone=us-central1-a \
--project=my-project --uri
POSITIONAL ARGUMENTS
RESERVATION
Name of the reservation to list.
REQUIRED FLAGS
--block-name=BLOCK_NAME
The name of the reservation block.
FLAGS
--zone=ZONE
Zone of the reservation to list. If not specified and the compute/zone
property isn't set, you might be prompted to select a zone (interactive
mode only).
To avoid prompting when this flag is omitted, you can set the
compute/zone property:
$ 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.
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filter EXPRESSION to each resource item to be listed.
If the expression evaluates True, then that item is listed. For more
details and examples of filter expressions, run $ gcloud topic filters.
This flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--limit=LIMIT
Maximum number of resources to list. The default is unlimited. This
flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--page-size=PAGE_SIZE
Some services group resource list output into pages. This flag
specifies the maximum number of resources per page. The default is
determined by the service if it supports paging, otherwise it is
unlimited (no paging). Paging may be applied before or after --filter
and --limit depending on the service.
--sort-by=[FIELD,...]
Comma-separated list of resource field key names to sort by. The
default order is ascending. Prefix a field with ``~'' for descending
order on that field. This flag interacts with other flags that are
applied in this order: --flatten, --sort-by, --filter, --limit.
--uri
Print a list of resource URIs instead of the default output, and change
the command output to a list of URIs. If this flag is used with
--format, the formatting is applied on this URI list. To display URIs
alongside other keys instead, use the uri() transform.
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
These variants are also available:
$ gcloud alpha compute reservations sub-blocks list
$ gcloud beta compute reservations sub-blocks list