.TH "GCLOUD_ALPHA_COMPUTE_SNAPSHOT\-SETTINGS_UPDATE" 1



.SH "NAME"
.HP
gcloud alpha compute snapshot\-settings update \- update snapshot settings



.SH "SYNOPSIS"
.HP
\f5gcloud alpha compute snapshot\-settings update\fR [\fB\-\-access\-location\-policy\fR=\fIACCESS_LOCATION_POLICY\fR] [\fB\-\-add\-access\-locations\fR=[\fIADD_ACCESS_LOCATIONS\fR,...]] [\fB\-\-async\fR] [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-remove\-access\-locations\fR=[\fIREMOVE_ACCESS_LOCATIONS\fR,...]] [\fB\-\-storage\-location\-names\fR=[\fISTORAGE_LOCATION_NAMES\fR,...]] [\fB\-\-storage\-location\-policy\fR=\fISTORAGE_LOCATION_POLICY\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Update the snapshot settings of a project.



.SH "EXAMPLES"

To update the snapshot settings and set the storage location policy to the
nearest multi\-region as the source disk, run:

.RS 2m
$ gcloud alpha compute snapshot\-settings update \e
\-\-storage\-location\-policy=nearest\-multi\-region
.RE

To update the snapshot settings and set the storage location policy to the same
region as the source disk, run:

.RS 2m
$ gcloud alpha compute snapshot\-settings update \e
\-\-storage\-location\-policy=local\-region
.RE

To update the snapshot settings and set the storage location policy to store
snapshots in a specific location like \f5us\-west1\fR, run:

.RS 2m
$ gcloud alpha compute snapshot\-settings update \e
\-\-storage\-location\-policy=specific\-locations \e
\-\-storage\-location\-names=us\-west1
.RE



.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-access\-location\-policy\fR=\fIACCESS_LOCATION_POLICY\fR

The access location policy. ACCESS_LOCATION_POLICY must be one of: all\-regions,
specific\-regions.

.TP 2m
\fB\-\-add\-access\-locations\fR=[\fIADD_ACCESS_LOCATIONS\fR,...]

Access locations to add to snapshot settings

.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

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

region for regional snapshot settings

.TP 2m
\fB\-\-remove\-access\-locations\fR=[\fIREMOVE_ACCESS_LOCATIONS\fR,...]

Access locations to remove from snapshot settings

.TP 2m
\fB\-\-storage\-location\-names\fR=[\fISTORAGE_LOCATION_NAMES\fR,...]

The custom storage location that you specify for the project's snapshots. You
can specify only a single location. Use this flag only when you use the
specific\-locations value for the \f5\-\-storage\-location\-policy\fR flag. For
more information, refer to the snapshot settings documentation at
https://cloud.google.com/compute/docs/disks/snapshot\-settings.

.TP 2m
\fB\-\-storage\-location\-policy\fR=\fISTORAGE_LOCATION_POLICY\fR

The storage location policy. For more information, refer to the snapshot
settings documentation at
https://cloud.google.com/compute/docs/disks/snapshot\-settings.
STORAGE_LOCATION_POLICY must be one of: local\-region, nearest\-multi\-region,
specific\-locations.


.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 "API REFERENCE"

This command uses the compute/alpha or compute/beta or compute/v1 API. The full
documentation for this API can be found at: https://cloud.google.com/compute/



.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 snapshot\-settings update
.RE

.RS 2m
$ gcloud beta compute snapshot\-settings update
.RE