.TH "GCLOUD_KMS_KEYS_SET\-ROTATION\-SCHEDULE" 1



.SH "NAME"
.HP
gcloud kms keys set\-rotation\-schedule \- update the rotation schedule for a key



.SH "SYNOPSIS"
.HP
\f5gcloud kms keys set\-rotation\-schedule\fR (\fIKEY\fR\ :\ \fB\-\-keyring\fR=\fIKEYRING\fR\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-next\-rotation\-time\fR=\fINEXT_ROTATION_TIME\fR] [\fB\-\-rotation\-period\fR=\fIROTATION_PERIOD\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Updates the rotation schedule for the given key. The schedule automatically
creates a new primary version for the key according to the
\f5\-\-next\-rotation\-time\fR and \f5\-\-rotation\-period\fR flags.

The flag \f5\-\-next\-rotation\-time\fR must be in ISO or RFC3339 format, and
\f5\-\-rotation\-period\fR must be in the form INTEGER[UNIT], where units can be
one of seconds (s), minutes (m), hours (h) or days (d).

Key rotations performed manually via \f5update\-primary\-version\fR and the
version \f5create\fR do not affect the stored \f5\-\-next\-rotation\-time\fR.



.SH "EXAMPLES"

The following command sets a 30 day rotation period for the key named
\f5frodo\fR within the keyring \f5fellowship\fR and location \f5global\fR
starting at the specified time:

.RS 2m
$ gcloud kms keys set\-rotation\-schedule frodo \-\-location=global \e
    \-\-keyring=fellowship \-\-rotation\-period=30d \e
    \-\-next\-rotation\-time=2017\-10\-12T12:34:56.1234Z
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Key resource \- The KMS key resource. The arguments in this group can be used to
specify the attributes of this 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 \f5key\fR on the command line with a fully specified name;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIKEY\fR

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

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

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-keyring\fR=\fIKEYRING\fR

The KMS keyring of the key.

To set the \f5keyring\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5key\fR on the command line with a fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-keyring\fR on the command line.
.RE
.sp

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

The Google Cloud location for the key.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5key\fR on the command line with a fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-next\-rotation\-time\fR=\fINEXT_ROTATION_TIME\fR

Next automatic rotation time of the key. See $ gcloud topic datetimes for
information on time formats.

.TP 2m
\fB\-\-rotation\-period\fR=\fIROTATION_PERIOD\fR

Automatic rotation period of the key. See $ gcloud topic datetimes for
information on duration formats.


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

These variants are also available:

.RS 2m
$ gcloud alpha kms keys set\-rotation\-schedule
.RE

.RS 2m
$ gcloud beta kms keys set\-rotation\-schedule
.RE