NAME

gcloud alpha compute target-grpc-proxies create - create a target gRPC proxy

SYNOPSIS

gcloud alpha compute target-grpc-proxies create NAME --url-map=URL_MAP [--description=DESCRIPTION] [--validate-for-proxyless] [--global-url-map | --url-map-region=URL_MAP_REGION] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) gcloud alpha compute target-grpc-proxies create 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.

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:

$ gcloud alpha compute target-grpc-proxies create PROXY_NAME \ --url-map=URL_MAP

To create a proxy with a textual description, run:

$ gcloud alpha compute target-grpc-proxies create PROXY_NAME \ --url-map=URL_MAP --description="default proxy"

POSITIONAL ARGUMENTS

NAME

Name of the target gRPC proxy to create.

REQUIRED FLAGS

--url-map=URL_MAP

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.

OPTIONAL FLAGS

--description=DESCRIPTION

An optional, textual description for the target gRPC proxy.

--validate-for-proxyless

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.

At most one of these can be specified:
--global-url-map

If set, the URL map is global.

--url-map-region=URL_MAP_REGION

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

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 command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. These variants are also available:

$ gcloud compute target-grpc-proxies create

$ gcloud beta compute target-grpc-proxies create