mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 18:45:13 +00:00
97 lines
3.6 KiB
Text
97 lines
3.6 KiB
Text
NAME
|
|
gcloud privateca certificates export - export a pem-encoded certificate to
|
|
a file
|
|
|
|
SYNOPSIS
|
|
gcloud privateca certificates export
|
|
(CERTIFICATE
|
|
: --issuer-location=ISSUER_LOCATION --issuer-pool=ISSUER_POOL)
|
|
--output-file=OUTPUT_FILE [--include-chain] [GCLOUD_WIDE_FLAG ...]
|
|
|
|
EXAMPLES
|
|
To export a single pem-encoded certificate to a file, run the following:
|
|
|
|
$ gcloud privateca certificates export my-cert \
|
|
--issuer-pool=my-pool --issuer-location=us-west1 \
|
|
--output-file=cert.pem
|
|
|
|
To export a pem-encoded certificate along with its issuing chain in the
|
|
same file, run the following:
|
|
|
|
$ gcloud privateca certificates export my-cert \
|
|
--issuer-pool=my-pool --issuer-location=us-west1 \
|
|
--include-chain --output-file=chain.pem
|
|
|
|
You can omit the --issuer-location flag in both of the above examples if
|
|
you've already set the privateca/location property. For example:
|
|
|
|
$ gcloud config set privateca/location us-west1
|
|
|
|
The following is equivalent to the first example above.
|
|
|
|
$ gcloud privateca certificates export my-cert \
|
|
--issuer-pool=my-pool --output-file=cert.pem
|
|
|
|
The following is equivalent to the second example above.
|
|
|
|
$ gcloud privateca certificates export my-cert \
|
|
--issuer-pool=my-pool --include-chain --output-file=chain.pem
|
|
|
|
POSITIONAL ARGUMENTS
|
|
CERTIFICATE resource - The certificate to export. 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 CERTIFICATE on the command line with a fully
|
|
specified name;
|
|
◆ provide the argument --project on the command line;
|
|
◆ set the property core/project.
|
|
|
|
This must be specified.
|
|
|
|
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.
|
|
|
|
This positional argument must be specified if any of the other
|
|
arguments in this group are specified.
|
|
|
|
--issuer-location=ISSUER_LOCATION
|
|
The location of the CERTIFICATE.
|
|
|
|
To set the issuer-location attribute:
|
|
▸ provide the argument CERTIFICATE on the command line with a fully
|
|
specified name;
|
|
▸ provide the argument --issuer-location on the command line;
|
|
▸ set the property privateca/location.
|
|
|
|
--issuer-pool=ISSUER_POOL
|
|
The parent CA Pool of the CERTIFICATE.
|
|
|
|
To set the issuer-pool attribute:
|
|
▸ provide the argument CERTIFICATE on the command line with a fully
|
|
specified name;
|
|
▸ provide the argument --issuer-pool on the command line.
|
|
|
|
REQUIRED FLAGS
|
|
--output-file=OUTPUT_FILE
|
|
The path where the resulting PEM-encoded certificate will be written.
|
|
|
|
OPTIONAL FLAGS
|
|
--include-chain
|
|
Whether to include the certificate's issuer chain in the exported file.
|
|
If this is set, the resulting file will contain the pem-encoded
|
|
certificate and its issuing chain, ordered from leaf to root.
|
|
|
|
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.
|