- NAME
-
- gcloud compute health-checks update grpc-with-tls - update a gRPC with TLS health check
- SYNOPSIS
-
-
gcloud compute health-checks update grpc-with-tlsNAME[--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION] [--enable-logging] [--grpc-service-name=GRPC_SERVICE_NAME] [--healthy-threshold=HEALTHY_THRESHOLD] [--timeout=TIMEOUT] [--unhealthy-threshold=UNHEALTHY_THRESHOLD] [--global|--region=REGION] [--port=PORT--use-serving-port] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
gcloud compute health-checks update grpc-with-tlsis used to update an existing gRPC with TLS health check. Only arguments passed in will be updated on the health check. Other attributes will remain unaffected. - POSITIONAL ARGUMENTS
-
-
NAME - Name of the gRPC with TLS health check to update.
-
- FLAGS
-
-
--check-interval=CHECK_INTERVAL - How often to perform a health check for an instance. For example, specifying
will run the check every 10 seconds. See $ gcloud topic datetimes for information on duration formats.10s -
--description=DESCRIPTION - A textual description for the gRPC with TLS health check. Pass in an empty string to unset.
-
--enable-logging - Enable logging of health check probe results to Stackdriver. Logging is disabled
by default.
Use --no-enable-logging to disable logging.
-
--grpc-service-name=GRPC_SERVICE_NAME - An optional gRPC service name string of up to 1024 characters to include in the gRPC health check request. Pass in an empty string to unset. Only ASCII characters are allowed.
-
--healthy-threshold=HEALTHY_THRESHOLD - The number of consecutive successful health checks before an unhealthy instance is marked as healthy.
-
--timeout=TIMEOUT - If Google Compute Engine doesn't receive a healthy response from the instance by
the time specified by the value of this flag, the health check request is
considered a failure. For example, specifying
will cause the check to wait for 10 seconds before considering the request a failure. See $ gcloud topic datetimes for information on duration formats.10s -
--unhealthy-threshold=UNHEALTHY_THRESHOLD - The number of consecutive health check failures before a healthy instance is marked as unhealthy.
- At most one of these can be specified:
-
--global - If set, the gRPC with TLS health check is global.
-
--region=REGION - Region of the gRPC with TLS health check to update. If not specified, you might
be prompted to select a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
property:compute/regiongcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionAlternatively, the region can be stored in the environment variable
.CLOUDSDK_COMPUTE_REGION
-
- These flags configure the port that the health check monitors.
-
--port=PORT - The TCP port number that this health check monitors.
-
--use-serving-port - If given, use the "serving port" for health checks:
- When health checking network endpoints in a Network Endpoint Group, use the port
specified with each endpoint.
--use-serving-portmust be used when using a Network Endpoint Group as a backend as this flag specifies theportSpecificationoption for a Health Check object. - When health checking other backends, use the port of the backend service.
- When health checking network endpoints in a Network Endpoint Group, use the port
specified with each endpoint.
-
- 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 helpfor details. - NOTES
- These variants are also available:
gcloud alpha compute health-checks update grpc-with-tlsgcloud beta compute health-checks update grpc-with-tlsgcloud preview compute health-checks update grpc-with-tls
gcloud compute health-checks update grpc-with-tls
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

