.TH "GCLOUD_PRIVATECA_CERTIFICATES_REVOKE" 1



.SH "NAME"
.HP
gcloud privateca certificates revoke \- revoke a certificate



.SH "SYNOPSIS"
.HP
\f5gcloud privateca certificates revoke\fR (\fB\-\-certificate\fR=\fICERTIFICATE\fR\ |\ \fB\-\-serial\-number\fR=\fISERIAL_NUMBER\fR) [\fB\-\-reason\fR=\fIREASON\fR;\ default="unspecified"] [\fB\-\-issuer\-pool\fR=\fIISSUER_POOL\fR\ :\ \fB\-\-issuer\-location\fR=\fIISSUER_LOCATION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Revokes the given certificate for the given reason.



.SH "EXAMPLES"

To revoke the 'frontend\-server\-tls' certificate due to key compromise:

.RS 2m
$ gcloud privateca certificates revoke \e
    \-\-certificate=frontend\-server\-tls \-\-issuer\-pool=my\-pool \e
    \-\-issuer\-location=us\-west1 \-\-reason=key_compromise
.RE

To revoke the a certificate with the serial number
\'7dc1d9186372de2e1f4824abb1c4c9e5e43cbb40' due to a newer one being issued:

.RS 2m
$ gcloud privateca certificates revoke \e
    \-\-serial\-number=7dc1d9186372de2e1f4824abb1c4c9e5e43cbb40 \e
    \-\-issuer\-pool=my\-pool \-\-issuer\-location=us\-west1 \e
    \-\-reason=superseded
.RE



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

The certificate identifier.

Exactly one of these must be specified:


.RS 2m
.TP 2m

Certificate resource \- The certificate to revoke. 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 "\(bu" 2m
provide the argument \f5\-\-certificate\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(bu" 2m
set the property \f5core/project\fR.
.RE
.sp

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

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


.RS 2m
.TP 2m
\fB\-\-certificate\fR=\fICERTIFICATE\fR

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

To set the \f5certificate\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-certificate\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m
\fB\-\-serial\-number\fR=\fISERIAL_NUMBER\fR

The serial number of the certificate.


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-reason\fR=\fIREASON\fR; default="unspecified"

Revocation reason to include in the CRL. \fIREASON\fR must be one of:
\fBaffiliation\-changed\fR, \fBattribute\-authority\-compromise\fR,
\fBcertificate\-authority\-compromise\fR, \fBcertificate\-hold\fR,
\fBcessation\-of\-operation\fR, \fBkey\-compromise\fR,
\fBprivilege\-withdrawn\fR, \fBunspecified\fR, \fBsuperseded\fR.

.TP 2m

Issuing CA pool resource \- The issuing CA pool of the certificate to revoke.
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 \f5\-\-issuer\-pool\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


.RS 2m
.TP 2m
\fB\-\-issuer\-pool\fR=\fIISSUER_POOL\fR

ID of the Issuing CA pool or fully qualified identifier for the Issuing CA pool.

To set the \f5pool\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-issuer\-pool\fR on the command line.
.RE
.sp

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

.TP 2m
\fB\-\-issuer\-location\fR=\fIISSUER_LOCATION\fR

The location of the Issuing CA pool.

To set the \f5issuer\-location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-issuer\-pool\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-issuer\-location\fR on the command line;
.IP "\(bu" 2m
set the property \f5privateca/location\fR.
.RE
.sp


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