.TH "GCLOUD_ALPHA_STORAGE_HMAC_UPDATE" 1



.SH "NAME"
.HP
gcloud alpha storage hmac update \- change the status of a service account HMAC



.SH "SYNOPSIS"
.HP
\f5gcloud alpha storage hmac update\fR \fIACCESS_ID\fR (\fB\-\-activate\fR\ |\ \fB\-\-deactivate\fR) [\fB\-\-etag\fR=\fIETAG\fR,\ \fB\-e\fR\ \fIETAG\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR \fBgcloud alpha storage hmac update\fR sets the state of the
specified key. Valid state arguments are \f5\fIACTIVE\fR\fR and
\f5\fIINACTIVE\fR\fR. To set a key to state \f5\fIDELETED\fR\fR, use \fBgcloud
alpha storage hmac delete\fR on an \f5\fIINACTIVE\fR\fR key. If an etag is set
in the command, it will only succeed if the provided etag matches the etag of
the stored key.



.SH "EXAMPLES"

To activate an HMAC key:

.RS 2m
$ gcloud alpha storage hmac update GOOG56JBMFZX6PMPTQ62VD2 \-\-activate
.RE

To set the state of an HMAC key to \f5\fIINACTIVE\fR\fR provided its etag is
\f5\fIM42da=\fR\fR:

.RS 2m
$ gcloud alpha storage hmac update GOOG56JBMFZX6PMPTQ62VD2 \e
    \-\-deactivate \-\-etag=M42da=
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIACCESS_ID\fR

Access ID for HMAC key to update.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-activate\fR

Sets the state of the specified key to \f5\fIACTIVE\fR\fR.

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

Sets the state of the specified key to \f5\fIINACTIVE\fR\fR.


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-etag\fR=\fIETAG\fR, \fB\-e\fR \fIETAG\fR

If provided, the update will only be performed if the specified etag matches the
etag of the stored key.


.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. This variant is also available:

.RS 2m
$ gcloud storage hmac update
.RE