File: //snap/google-cloud-cli/current/help/man/man1/gcloud_alpha_compute_networks_subnets_describe.1
.TH "GCLOUD_ALPHA_COMPUTE_NETWORKS_SUBNETS_DESCRIBE" 1
.SH "NAME"
.HP
gcloud alpha compute networks subnets describe \- describe a Compute Engine subnetwork
.SH "SYNOPSIS"
.HP
\f5gcloud alpha compute networks subnets describe\fR \fINAME\fR [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-view\fR=\fIVIEW\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
\fB(ALPHA)\fR \fBgcloud alpha compute networks subnets describe\fR displays all
data associated with a Compute Engine subnetwork.
.SH "EXAMPLES"
To display all data associated with subnetwork subnet\-1, run:
.RS 2m
$ gcloud alpha compute networks subnets describe subnet\-1
.RE
.SH "POSITIONAL ARGUMENTS"
.RS 2m
.TP 2m
\fINAME\fR
Name of the subnetwork to describe.
.RE
.sp
.SH "FLAGS"
.RS 2m
.TP 2m
\fB\-\-region\fR=\fIREGION\fR
Region of the subnetwork to describe. 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\-\-view\fR=\fIVIEW\fR
Specifies the information to include in the output. \fIVIEW\fR must be (only one
value is supported):
.RS 2m
.TP 2m
\fBWITH_UTILIZATION\fR
Output includes the IP address utilization data of all subnetwork ranges,
showing total allocated and free IPv4 and IPv6 IP addresses.
.RE
.sp
.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 alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:
.RS 2m
$ gcloud compute networks subnets describe
.RE
.RS 2m
$ gcloud beta compute networks subnets describe
.RE