NAME

gcloud privateca certificates revoke - revoke a certificate

SYNOPSIS

gcloud privateca certificates revoke (--certificate=CERTIFICATE : --serial-number=SERIAL_NUMBER) [--reason=REASON; default="unspecified"] [--issuer-pool=ISSUER_POOL : --issuer-location=ISSUER_LOCATION] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

Revokes the given certificate for the given reason.

EXAMPLES

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

$ gcloud privateca certificates revoke \ --certificate=frontend-server-tls --issuer-pool=my-pool \ --issuer-location=us-west1 --reason=key_compromise

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

$ gcloud privateca certificates revoke \ --serial-number=7dc1d9186372de2e1f4824abb1c4c9e5e43cbb40 \ --issuer-pool=my-pool --issuer-location=us-west1 \ --reason=superseded

REQUIRED FLAGS

The certificate identifier.

Exactly one of these must be specified:

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 project attribute:

  • provide the argument --certificate on the command line with a fully specified name;

  • provide the argument --project on the command line;

  • set the property core/project. To set the issuer-location attribute:

  • provide the argument --certificate on the command line with a fully specified name;

  • set the property privateca/location. To set the issuer-pool attribute:

  • provide the argument --certificate on the command line with a fully specified name.

--certificate=CERTIFICATE

ID of the certificate or fully qualified identifier for the certificate. To set the certificate attribute:

provide the argument --certificate on the command line.

--serial-number=SERIAL_NUMBER

The serial number of the certificate.

OPTIONAL FLAGS

--reason=REASON; default="unspecified"

Revocation reason to include in the CRL. REASON must be one of: affiliation-changed, attribute-authority-compromise, certificate-authority-compromise, certificate-hold, cessation-of-operation, key-compromise, privilege-withdrawn, unspecified, superseded.

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 project attribute:

provide the argument --issuer-pool on the command line with a fully specified name;

provide the argument --project on the command line;

set the property core/project.

--issuer-pool=ISSUER_POOL

ID of the Issuing CA pool or fully qualified identifier for the Issuing CA pool. To set the pool attribute:

  • provide the argument --issuer-pool on the command line.

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

--issuer-location=ISSUER_LOCATION

The location of the Issuing CA pool. To set the issuer-location attribute:

  • provide the argument --issuer-pool on the command line with a fully specified name;

  • provide the argument --issuer-location on the command line;

  • set the property privateca/location.

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 $ gcloud help for details.

NOTES

This variant is also available:

$ gcloud beta privateca certificates revoke