.TH "GCLOUD_PRIVATECA_SUBORDINATES_DESCRIBE" 1



.SH "NAME"
.HP
gcloud privateca subordinates describe \- get metadata for a subordinate certificate authority



.SH "SYNOPSIS"
.HP
\f5gcloud privateca subordinates describe\fR (\fICERTIFICATE_AUTHORITY\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR\ \fB\-\-pool\fR=\fIPOOL\fR) [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Returns metadata for the given certificate authority.



.SH "EXAMPLES"

To get metadata for the subordinate CA 'server\-tls\-1' in CA Pool 'my\-pool'
and location 'us\-west1':

.RS 2m
$ gcloud privateca subordinates describe server\-tls\-1 \e
    \-\-location=us\-west1 \-\-pool=my\-pool
.RE

To download the PEM\-encoded CA certificate chain for the 'server\-tls\-1' CA in
location 'us\-west1' to a file called 'server\-tls\-1.crt':

.RS 2m
$ gcloud privateca subordinates describe server\-tls\-1 \e
    \-\-location=us\-west1 \-\-pool=my\-pool \e
    \-\-format="value(pemCaCertificates)" > ./server\-tls\-1.crt
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

CERTIFICATE AUTHORITY resource \- The certificate authority for which to obtain
metadata. 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 \f5certificate_authority\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

This must be specified.


.RS 2m
.TP 2m
\fICERTIFICATE_AUTHORITY\fR

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

To set the \f5certificate_authority\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5certificate_authority\fR on the command line.
.RE
.sp

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

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

The location of the CERTIFICATE_AUTHORITY.

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

.TP 2m
\fB\-\-pool\fR=\fIPOOL\fR

The ID of the CA Pool.

To set the \f5pool\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5certificate_authority\fR on the command line with a
fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-pool\fR on the command line.
.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.



.SH "API REFERENCE"

This command uses the \fBprivateca/v1\fR API. The full documentation for this
API can be found at: https://cloud.google.com/