.TH "GCLOUD_COMPUTE_TARGET\-GRPC\-PROXIES_CREATE" 1



.SH "NAME"
.HP
gcloud compute target\-grpc\-proxies create \- create a target gRPC proxy



.SH "SYNOPSIS"
.HP
\f5gcloud compute target\-grpc\-proxies create\fR \fINAME\fR \fB\-\-url\-map\fR=\fIURL_MAP\fR [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-validate\-for\-proxyless\fR] [\fB\-\-global\-url\-map\fR\ |\ \fB\-\-url\-map\-region\fR=\fIURL_MAP_REGION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fBgcloud compute target\-grpc\-proxies create\fR is used to create target gRPC
proxies. A target gRPC proxy is a component of load balancers intended for load
balancing gRPC traffic. Global forwarding rules reference a target gRPC proxy.
The Target gRPC proxy references a URL map which specifies how traffic routes to
gRPC backend services.



.SH "EXAMPLES"

If there is an already\-created URL map with the name URL_MAP, create a global
target gRPC proxy pointing to this map by running:

.RS 2m
$ gcloud compute target\-grpc\-proxies create PROXY_NAME \e
    \-\-url\-map=URL_MAP
.RE

To create a proxy with a textual description, run:

.RS 2m
$ gcloud compute target\-grpc\-proxies create PROXY_NAME \e
    \-\-url\-map=URL_MAP \-\-description="default proxy"
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fINAME\fR

Name of the target gRPC proxy to create.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-url\-map\fR=\fIURL_MAP\fR

A reference to a URL map resource. A URL map defines the mapping of URLs to
backend services. Before you can refer to a URL map, you must create the URL
map. To delete a URL map that a target proxy is referring to, you must first
delete the target gRPC proxy.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

An optional, textual description for the target gRPC proxy.

.TP 2m
\fB\-\-validate\-for\-proxyless\fR

If specified, configuration in the associated urlMap and the BackendServices is
checked to allow only the features that are supported in the latest release of
gRPC.

If unspecified, no such configuration checks are performed. This may cause
unexpected behavior in gRPC applications if unsupported features are configured.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-global\-url\-map\fR

If set, the URL map is global.

.TP 2m
\fB\-\-url\-map\-region\fR=\fIURL_MAP_REGION\fR

Region of the URL map to operate on. Overrides the default \fBcompute/region\fR
property value for this command invocation.


.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 "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha compute target\-grpc\-proxies create
.RE

.RS 2m
$ gcloud beta compute target\-grpc\-proxies create
.RE