mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 10:35:03 +00:00
113 lines
4.8 KiB
Text
113 lines
4.8 KiB
Text
NAME
|
|
gcloud privateca certificates list - list certificates within a project
|
|
|
|
SYNOPSIS
|
|
gcloud privateca certificates list
|
|
[--issuer-pool=ISSUER_POOL --location=LOCATION] [--filter=EXPRESSION]
|
|
[--limit=LIMIT] [--page-size=PAGE_SIZE; default=100]
|
|
[--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
List certificates within a project. Note that listing certificates accross
|
|
locations is not supported.
|
|
|
|
EXAMPLES
|
|
To list all Certificates issued by a given CA pool, run:
|
|
|
|
$ gcloud privateca certificates list --issuer-pool=my-pool \
|
|
--location=us-west1
|
|
|
|
To list all Certificates issued by all CA pools in a location, run:
|
|
|
|
$ gcloud privateca certificates list --location=us-west1
|
|
|
|
To list all Certificates issued directly under a CA, run:
|
|
|
|
$ gcloud privateca certificates list --issuer-pool=my-pool \
|
|
--location=us-west1 \
|
|
--filter="issuer_certificate_authority='projects/1234567890/loca\
|
|
tions/us-west1/caPools/my-pool/certificateAuthorities/my-ca'"
|
|
|
|
You can omit the --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 list --issuer-pool=my-pool
|
|
|
|
# The following is equivalent to the second example above.
|
|
$ gcloud privateca certificates list
|
|
|
|
FLAGS
|
|
CA POOL resource - The issuing CA pool. If this is omitted, Certificates
|
|
issued by all CA pools in the given location will be listed. 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;
|
|
◆ defaults to all CA pools in the given location 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 CA_POOL or fully qualified identifier for the CA_POOL. To
|
|
set the pool attribute:
|
|
▸ provide the argument --issuer-pool on the command line;
|
|
▸ defaults to all CA pools in the given location.
|
|
|
|
--location=LOCATION
|
|
The location of the CA_POOL. To set the location attribute:
|
|
▸ provide the argument --issuer-pool on the command line with a
|
|
fully specified name;
|
|
▸ defaults to all CA pools in the given location with a fully
|
|
specified name;
|
|
▸ provide the argument --location on the command line;
|
|
▸ set the property privateca/location.
|
|
|
|
LIST COMMAND FLAGS
|
|
--filter=EXPRESSION
|
|
Apply a Boolean filter EXPRESSION to each resource item to be listed.
|
|
If the expression evaluates True, then that item is listed. For more
|
|
details and examples of filter expressions, run $ gcloud topic filters.
|
|
This flag interacts with other flags that are applied in this order:
|
|
--flatten, --sort-by, --filter, --limit.
|
|
|
|
--limit=LIMIT
|
|
Maximum number of resources to list. The default is unlimited. This
|
|
flag interacts with other flags that are applied in this order:
|
|
--flatten, --sort-by, --filter, --limit.
|
|
|
|
--page-size=PAGE_SIZE; default=100
|
|
Some services group resource list output into pages. This flag
|
|
specifies the maximum number of resources per page. The default is 100.
|
|
Paging may be applied before or after --filter and --limit depending on
|
|
the service.
|
|
|
|
--sort-by=[FIELD,...]
|
|
Comma-separated list of resource field key names to sort by. The
|
|
default order is ascending. Prefix a field with ``~'' for descending
|
|
order on that field. This flag interacts with other flags that are
|
|
applied in this order: --flatten, --sort-by, --filter, --limit.
|
|
|
|
--uri
|
|
Print a list of resource URIs instead of the default output, and change
|
|
the command output to a list of URIs. If this flag is used with
|
|
--format, the formatting is applied on this URI list. To display URIs
|
|
alongside other keys instead, use the uri() transform.
|
|
|
|
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 list
|
|
|