.TH "GCLOUD_ALPHA_COMPUTE_DISKS_ADD\-LABELS" 1



.SH "NAME"
.HP
gcloud alpha compute disks add\-labels \- add labels to Google Compute Engine persistent disks



.SH "SYNOPSIS"
.HP
\f5gcloud alpha compute disks add\-labels\fR \fIDISK_NAME\fR \fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...] [\fB\-\-region\fR=\fIREGION\fR\ |\ \fB\-\-zone\fR=\fIZONE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR \fBgcloud alpha compute disks add\-labels\fR adds labels to a
Google Compute Engine persistent disk.



.SH "EXAMPLES"

To add key\-value pairs \f5\fIk0\fR\fR=\f5\fIv0\fR\fR and
\f5\fIk1\fR\fR=\f5\fIv1\fR\fR to 'example\-disk'

.RS 2m
$ gcloud alpha compute disks add\-labels example\-disk \e
    \-\-labels=k0=v0,k1=v1
.RE

Labels can be used to identify the disk and to filter them. To find a disk
labeled with key\-value pair \f5\fIk1\fR\fR, \f5\fIv2\fR\fR

.RS 2m
$ gcloud alpha compute disks list \-\-filter='labels.k1:v2'
.RE

To list only the labels when describing a resource, use \-\-format

.RS 2m
$ gcloud alpha compute disks describe example\-disk \e
    \-\-format='default(labels)'
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIDISK_NAME\fR

Name of the disk to operate on.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

A list of labels to add.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Region of the disk to operate 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
\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\-\-zone\fR=\fIZONE\fR

Zone of the disk to operate on. If not specified and the
\f5\fIcompute/zone\fR\fR 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
\f5\fIcompute/zone\fR\fR property:

.RS 2m
$ gcloud config set compute/zone ZONE
.RE

A list of zones can be fetched by running:

.RS 2m
$ gcloud compute zones list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/zone
.RE

Alternatively, the zone can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_ZONE\fR\fR.


.RE
.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 disks add\-labels
.RE

.RS 2m
$ gcloud beta compute disks add\-labels
.RE