.TH "GCLOUD_ALPHA_MONITORING_SNOOZES_UPDATE" 1



.SH "NAME"
.HP
gcloud alpha monitoring snoozes update \- updates a snooze



.SH "SYNOPSIS"
.HP
\f5gcloud alpha monitoring snoozes update\fR \fISNOOZE\fR [\fB\-\-snooze\-from\-file\fR=\fIPATH_TO_FILE\fR] [\fB\-\-fields\fR=[\fIfield\fR,...]\ |\ \fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR\ \fB\-\-end\-time\fR=\fIEND_TIME\fR\ \fB\-\-start\-time\fR=\fISTART_TIME\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Update a snooze.

If \f5\-\-snooze\-from\-file\fR is specified, then the update rules depend on
the value of the (optional) \f5\-\-fields\fR flag:

.RS 2m
.IP "\(bu" 2m
If \f5\-\-fields\fR is specified, then only the specified fields of the snooze
are updated.
.IP "\(bu" 2m
Else, all fields of the snooze are replaced. The updated snooze can be modified
further using the flags from the Snooze Settings group below.
.RE
.sp

Otherwise, the snooze will be updated with the values specified in the flags
from the Snooze Settings group.

For information about the JSON/YAML format of a snooze:
https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.snoozes



.SH "EXAMPLES"

To update a snooze time interval with command\-line options, run:

.RS 2m
$ gcloud alpha monitoring snoozes update MY\-SNOOZE \e
    \-\-start\-time=START_TIME \-\-end\-time=END_TIME
.RE

To update a snooze display name with a file, run:

.RS 2m
$ gcloud alpha monitoring snoozes update \e
    \-\-snooze\-from\-file=MY\-FILE \-\-fields=display_name
.RE

Sample contents of MY\-FILE:

.RS 2m
criteria:
  policies:
  \- projects/MY\-PROJECT/alertPolicies/MY\-POLICY
interval:
  startTime: '2024\-03\-01T08:00:00Z'
  endTime: '2024\-03\-08T04:59:59.500Z'
displayName: New Snooze with New Display Name
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Snooze resource \- Name of the Snooze to be updated. This represents a Cloud
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5snooze\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fISNOOZE\fR

ID of the Snooze or fully qualified identifier for the Snooze.

To set the \f5snooze\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5snooze\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-snooze\-from\-file\fR=\fIPATH_TO_FILE\fR

The path to a JSON or YAML file containing the snooze. Use a full or relative
path to a local file containing the value of snooze.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-fields\fR=[\fIfield\fR,...]

The list of fields to update. Must specify \f5\-\-snooze\-from\-file\fR if using
this flag.

.TP 2m

Snooze Settings. If any of these are specified, they will overwrite fields in
the \f5\-\-snooze\-from\-file\fR flags if specified.


.RS 2m
.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

The display name for the Snooze.

.TP 2m
\fB\-\-end\-time\fR=\fIEND_TIME\fR

The start time for the Snooze.

.TP 2m
\fB\-\-start\-time\fR=\fISTART_TIME\fR

The start time for the Snooze.


.RE
.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 monitoring snoozes update
.RE

.RS 2m
$ gcloud beta monitoring snoozes update
.RE