.TH "GCLOUD_AUTH_REVOKE" 1



.SH "NAME"
.HP
gcloud auth revoke \- revoke access credentials for an account



.SH "SYNOPSIS"
.HP
\f5gcloud auth revoke\fR [\fIACCOUNTS\fR\ ...] [\fB\-\-all\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Revokes credentials for the specified user accounts, service accounts or
external accounts (workload identity pools).

When given a user account, this command revokes the user account token on the
server. If the revocation is successful, or if the token has already been
revoked, this command removes the credential from the local machine.

When given a service account, this command does not revoke the service account
token on the server because service account tokens are not revocable. Instead,
it will print a warning and remove the credential from the local machine. When
used with a service account, this command has only a local effect and the key
associated with the service account is not deleted. This can be done by
executing \f5gcloud iam service\-accounts keys delete\fR after \f5revoke\fR.

When given an external account (workload identity pool), whether impersonated or
not, the command does not revoke the corresponding token on the server because
these tokens are not revocable. The underlying external credentials (OIDC, AWS,
etc.) used to generate these access tokens have to be revoked too, but gcloud
has no control over that. Instead, it will print a warning and remove the
credential from the local machine.

If no account is specified, this command revokes credentials for the currently
active account, effectively logging out of that account. If \-\-all is given,
the behaviors described above apply individually to each account in the list.

You can revoke credentials when you want to prevent gcloud and other Google
Cloud CLI tools from using the specified account. You do not need to revoke
credentials to switch between accounts.



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
[\fIACCOUNTS\fR ...]

Accounts whose credentials are to be revoked.


.RE
.sp

.SH "FLAGS"

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

Revoke credentials for all accounts.


.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 auth revoke
.RE

.RS 2m
$ gcloud beta auth revoke
.RE