1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 10:35:03 +00:00
gcloud-help/gcloud/privateca/certificates/revoke
2024-01-10 10:17:49 +00:00

107 lines
4.1 KiB
Text

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.