gcloud monitoring uptime update - update an existing uptime check or synthetic monitor

gcloud monitoring uptime updateCHECK_ID[--body=BODY--content-type=CONTENT_TYPE--custom-content-type=CUSTOM_CONTENT_TYPE--mask-headers=MASK_HEADERS--password=PASSWORD--path=PATH--pings-count=PINGS_COUNT--port=PORT--request-method=REQUEST_METHOD--service-agent-auth=SERVICE_AGENT_AUTH--username=USERNAME--validate-ssl=VALIDATE_SSL--add-status-classes=[status-class,…]    |--clear-status-classes=CLEAR_STATUS_CLASSES    |--remove-status-classes=[status-class,…]    |--set-status-classes=[status-class,…]    |--add-status-codes=[status-code,…]    |--clear-status-codes=CLEAR_STATUS_CODES    |--remove-status-codes=[status-code,…]    |--set-status-codes=[status-code,…]--update-headers=[KEY=VALUE,…]--clear-headers=CLEAR_HEADERS    |--remove-headers=[KEY,…]][--display-name=DISPLAY_NAME--period=PERIOD--timeout=TIMEOUT--add-regions=[region,…]    |--clear-regions=CLEAR_REGIONS    |--remove-regions=[region,…]    |--set-regions=[region,…]--update-user-labels=[KEY=VALUE,…]--clear-user-labels    |--remove-user-labels=[KEY,…]][--matcher-content=MATCHER_CONTENT :--matcher-type=MATCHER_TYPE [--json-path=JSON_PATH :--json-path-matcher-type=JSON_PATH_MATCHER_TYPE]][GCLOUD_WIDE_FLAG …]

Flags only apply to uptime checks unless noted that they apply to syntheticmonitors.

For information about the JSON/YAML format of an uptime check:https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.uptimeCheckConfigs

Uptime check or synthetic monitor resource - Name of the uptime check orsynthetic monitor to be updated. This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

• provide the argumentcheck_id on the command line with a fullyspecified name;
• provide the argument--project on the command line;
• set the propertycore/project.

This must be specified.

CHECK_ID

ID of the uptime check or synthetic monitor or fully qualified identifier forthe uptime check or synthetic monitor.

To set thecheck_id attribute:

• provide the argumentcheck_id on the command line.

Uptime check protocol settings.

--body=BODY

The request body associated with the HTTP POST request. Can only be set if--protocol ishttp orhttps.

--content-type=CONTENT_TYPE

The content type header to use for the check, defaults tounspecified. Can only be set if--protocol ishttp orhttps.

CONTENT_TYPE must be one of:

unspecified

Not specified

url-encoded

URL encoded

user-provided

User provided

--custom-content-type=CUSTOM_CONTENT_TYPE

A user-provided content type header to use for the check. Can only be set if--protocol ishttp orhttps.

--mask-headers=MASK_HEADERS

Whether to encrypt the header information, defaults tofalse. Canonly be set if--protocol ishttp orhttps.

--password=PASSWORD

The password to use when authenticating with the HTTP server. Can only be set if--protocol ishttp orhttps.

--path=PATH

The path to the page against which to run the check, defaults to/.Can only be set if--protocol ishttp orhttps.

--pings-count=PINGS_COUNT

Number of ICMP pings to send alongside the request.

--port=PORT

The port on the server against which to run the check. Defaults to80 when--protocol ishttp. Defaults to443 when--protocol ishttps. Required if--protocol istcp.

--request-method=REQUEST_METHOD

The HTTP request method to use, defaults toget. Can only be set if--protocol ishttp orhttps.

REQUEST_METHOD must be one of:

get

HTTP GET method

post

HTTP POST method

Uptime check service agent authorization.

--service-agent-auth=SERVICE_AGENT_AUTH

The type of authentication to use for the HTTP request. Can only be set if--protocol ishttps.

SERVICE_AGENT_AUTH must be (only one value issupported):

oidc-token

OIDC Token authentication

--username=USERNAME

The username to use when authenticating with the HTTP server. Can only be set if--protocol ishttp orhttps.

--validate-ssl=VALIDATE_SSL

Whether to include SSL certificate validation as a part of the uptime check,defaults tofalse. Can only be set if--protocol ishttp orhttps.

Uptime check status.

At most one of these can be specified:

Uptime check status classes.

At most one of these can be specified:

--add-status-classes=[status-class,…]

The list of HTTP status classes to add to the uptime check.status-class must be one of:

1xx

Any response code from 100-199 inclusive

2xx

Any response code from 200-299 inclusive

3xx

Any response code from 300-399 inclusive

4xx

Any response code from 400-499 inclusive

5xx

Any response code from 500-599 inclusive

any

Any response code

--clear-status-classes=CLEAR_STATUS_CLASSES

Clear all HTTP status classes on the uptime check. Setting this flag is the sameas selecting only the2xx status class.

--remove-status-classes=[status-class,…]

The list of HTTP status classes to remove from the uptime check.status-class must be one of:

1xx

Any response code from 100-199 inclusive

2xx

Any response code from 200-299 inclusive

3xx

Any response code from 300-399 inclusive

4xx

Any response code from 400-499 inclusive

5xx

Any response code from 500-599 inclusive

any

Any response code

--set-status-classes=[status-class,…]

List of HTTP status classes. The uptime check will only pass if the responsecode is contained in this list.

status-class must be one of:

1xx

Any response code from 100-199 inclusive

2xx

Any response code from 200-299 inclusive

3xx

Any response code from 300-399 inclusive

4xx

Any response code from 400-499 inclusive

5xx

Any response code from 500-599 inclusive

any

Any response code

Uptime check status codes.

At most one of these can be specified:

--add-status-codes=[status-code,…]

The list of HTTP status codes to add to the uptime check.

--clear-status-codes=CLEAR_STATUS_CODES

Clear all HTTP status codes on the uptime check. Setting this flag is the sameas selecting only the2xx status class.

--remove-status-codes=[status-code,…]

The list of HTTP status codes to remove from the uptime check.

--set-status-codes=[status-code,…]

List of HTTP status codes. The uptime check will only pass if the response codeis present in this list.

Uptime check headers.

--update-headers=[KEY=VALUE,…]

The list of headers to add to the uptime check. Any existing headers withmatching "key" are overridden by the provided values.

Uptime check remove headers.

At most one of these can be specified:

--clear-headers=CLEAR_HEADERS

Clear all headers on the uptime check.

--remove-headers=[KEY,…]

The list of header keys to remove from the uptime check.

Settings.

--display-name=DISPLAY_NAME

The display name for the uptime check or synthetic monitor.

--period=PERIOD

The time between uptime check or synthetic monitor executions in minutes,defaults to1. Can be set for synthetic monitors.

PERIOD must be one of:

1

One minute

10

Ten minutes

15

Fifteen minutes

5

Five minutes

--timeout=TIMEOUT

The maximum amount of time in seconds to wait for the request to complete,defaults to60. Can be set for synthetic monitors.

Uptime check selected regions.

At most one of these can be specified:

--add-regions=[region,…]

The list of regions to add to the uptime check.regionmust be one of:

asia-pacific

asia-southeast1

europe

europe-west1

south-america

southamerica-east1

usa-iowa

us-central1

usa-oregon

us-west1

usa-virginia

us-east4

--clear-regions=CLEAR_REGIONS

Clear all regions on the uptime check. This setting acts the same as if allavailable regions were selected.

--remove-regions=[region,…]

The list of regions to remove from the uptime check.region must be one of:

asia-pacific

asia-southeast1

europe

europe-west1

south-america

southamerica-east1

usa-iowa

us-central1

usa-oregon

us-west1

usa-virginia

us-east4

--set-regions=[region,…]

The list of regions from which the check is run. At least 3 regions must beselected.

region must be one of:

asia-pacific

asia-southeast1

europe

europe-west1

south-america

southamerica-east1

usa-iowa

us-central1

usa-oregon

us-west1

usa-virginia

us-east4

User labels. Can be set for synthetic monitors.

--update-user-labels=[KEY=VALUE,…]

List of label KEY=VALUE pairs to update. If a label exists, its value ismodified. Otherwise, a new label is created.

Keys must start with a lowercase character and contain only hyphens(-), underscores (_), lowercase characters, andnumbers. Values must contain only hyphens (-), underscores(_), lowercase characters, and numbers.

At most one of these can be specified:

--clear-user-labels

Remove all labels. If--update-user-labels is also specified then--clear-user-labels is applied first.

For example, to remove all labels:

gcloudmonitoringuptimeupdate--clear-user-labels

To remove all existing labels and create two new labels,foo andbaz:

gcloudmonitoringuptimeupdate--clear-user-labels--update-user-labelsfoo=bar,baz=qux

--remove-user-labels=[KEY,…]

List of label keys to remove. If a label does not exist it is silently ignored.If--update-user-labels is also specified then--update-user-labels is applied first.

Uptime check matcher settings.

--matcher-content=MATCHER_CONTENT

String, regex or JSON content to match.

This flag argument must be specified if any of the other arguments in this groupare specified.

--matcher-type=MATCHER_TYPE

The type of content matcher that is applied to the server output, defaults tocontains-string.

MATCHER_TYPE must be one of:

contains-string

Response contains string

matches-json-path

Response matches at JSONPath

matches-regex

Response matches regex

not-contains-string

Response does not contain string

not-matches-json-path

Response does not match at JSONPath

not-matches-regex

Response does not match regex

Uptime check matcher settings for JSON responses.

--json-path=JSON_PATH

JSONPath within the response output pointing to the expected content to match.Only used if--matcher-type ismatches-json-path ornot-matches-json-path.

This flag argument must be specified if any of the other arguments in this groupare specified.

--json-path-matcher-type=JSON_PATH_MATCHER_TYPE

The type of JSONPath match that is applied to the JSON output, defaults toexact-match. Only used if--matcher-type ismatches-json-path ornot-matches-json-path.

JSON_PATH_MATCHER_TYPE must be one of:

exact-match

Response matches exact string at JSONPath

regex-match

Response matches regex at JSONPath

Run$gcloud help for details.