1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-16 20:36:39 +00:00
gcloud-help/gcloud/beta/compute/health-checks/update/https
2022-03-01 04:29:52 +00:00

144 lines
5.4 KiB
Text

NAME
gcloud beta compute health-checks update https - update a HTTPS health
check
SYNOPSIS
gcloud beta compute health-checks update https NAME
[--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION]
[--enable-logging] [--healthy-threshold=HEALTHY_THRESHOLD]
[--host=HOST] [--proxy-header=PROXY_HEADER]
[--request-path=REQUEST_PATH] [--response=RESPONSE] [--timeout=TIMEOUT]
[--unhealthy-threshold=UNHEALTHY_THRESHOLD]
[--global | --region=REGION]
[--port=PORT --port-name=PORT_NAME --use-serving-port]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute health-checks update https is used to update an
existing HTTPS health check. Only arguments passed in will be updated on
the health check. Other attributes will remain unaffected.
POSITIONAL ARGUMENTS
NAME
Name of the HTTPS health check to update.
FLAGS
--check-interval=CHECK_INTERVAL
How often to perform a health check for an instance. For example,
specifying 10s will run the check every 10 seconds. See $ gcloud topic
datetimes for information on duration formats.
--description=DESCRIPTION
A textual description for the HTTPS 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.
--healthy-threshold=HEALTHY_THRESHOLD
The number of consecutive successful health checks before an unhealthy
instance is marked as healthy.
--host=HOST
The value of the host header used in this HTTP health check request.
The host header is empty by default. When empty, the health check will
set the host header to the IP address of the backend VM or endpoint.
You can set the host header to an empty value to return to this default
behavior.
--proxy-header=PROXY_HEADER
The type of proxy protocol header to be sent to the backend.
PROXY_HEADER must be one of:
NONE
No proxy header is added.
PROXY_V1
Adds the header "PROXY UNKNOWN\r\n".
--request-path=REQUEST_PATH
The request path that this health check monitors. For example,
/healthcheck.
--response=RESPONSE
When empty, status code of the response determines health. When not
empty, presence of specified string in first 1024 characters of
response body determines health. Only ASCII characters allowed.
--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 10s will
cause the check to wait for 10 seconds before considering the request a
failure. See $ gcloud topic datetimes for information on duration
formats.
--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 HTTPS health check is global.
--region=REGION
Region of the HTTPS 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
compute/region property:
$ gcloud config set compute/region REGION
A list of regions can be fetched by running:
$ gcloud compute regions list
To unset the property, run:
$ gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable
CLOUDSDK_COMPUTE_REGION.
These flags configure the port that the health check monitors. If both
--port and --port-name are specified, --port takes precedence.
--port=PORT
The TCP port number that this health check monitors.
--port-name=PORT_NAME
The port name that this health check monitors. By default, this is
empty. Setting this to an empty string will clear any existing
port-name value.
--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-port must be used when using a Network Endpoint Group
as a backend as this flag specifies the portSpecification option
for a Health Check object.
▸ When health checking other backends, use the port or named port
of the backend service.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute health-checks update https
$ gcloud alpha compute health-checks update https