dcloud monitoring checks update

Change an uptime check; changing what it requests starts it over as pending

IAM monitoring:UpdateCheckChanges state

Synopsis

dcloud monitoring checks update id [flags]

Arguments

  • <id>Required

    string

    Also accepted as --id. Constraints: uuid

Flags

  • --nameOptional

    string

    Unique in the organization (409 when taken), up to 128 characters; unchanged when omitted

  • --typeOptional

    enum

    http or keyword; unchanged when omitted. Switching to http without a keyword drops the keyword; changing it starts the check over as pending

    One of: http, keyword

  • --urlOptional

    string

    http:// or https:// on a public address, any port except 25, 465 and 587; unchanged when omitted. changing it starts the check over as pending; 409 when the new host is already requested 6 times a minute

  • --methodOptional

    enum

    GET or HEAD (a keyword check uses GET); unchanged when omitted, changing it starts the check over as pending

    One of: GET, HEAD

  • --expected-status-minOptional

    number

    Lowest status that counts as up, 100–599; unchanged when omitted, changing it starts the check over as pending

    Constraints: integer

  • --expected-status-maxOptional

    number

    Highest status that counts as up, 100–599, not below the minimum; unchanged when omitted, changing it starts the check over as pending

    Constraints: integer

  • --keywordOptional

    string

    Keyword checks only: the text looked for, up to 200 characters; unchanged when omitted, changing it starts the check over as pending

    May be null.

  • --keyword-modeOptional

    enum

    contains or not_contains; unchanged when omitted, changing it starts the check over as pending

    One of: contains, not_contains

    May be null.

  • --timeout-msOptional

    number

    Milliseconds, 1000–30000; unchanged when omitted

    Constraints: integer

  • --interval-secondsOptional

    number

    60, 120, 300, 600, 900, 1800 or 3600; unchanged when omitted. 409 when it would take the host over 6 requests a minute

    Constraints: integer

  • --follow-redirectsOptional

    boolean (--follow-redirects / --no-follow-redirects)

    Follow up to 5 redirects; unchanged when omitted, changing it starts the check over as pending

  • --verify-tlsOptional

    boolean (--verify-tls / --no-verify-tls)

    Fail on an invalid certificate; unchanged when omitted, changing it starts the check over as pending

  • --failure-thresholdOptional

    number

    Failed runs in a row before DOWN, 1–5; unchanged when omitted

    Constraints: integer

  • --confirmationsOptional

    number

    Locations that must fail in one run, 1–3; unchanged when omitted

    Constraints: integer

  • --alert-on-regionalOptional

    boolean (--alert-on-regional / --no-alert-on-regional)

    Treat one failing location as failed; unchanged when omitted

  • --notify-emailsOptional

    array of string

    Up to 10 addresses mailed on DOWN and UP; replaces the list, unchanged when omitted

  • --webhook-urlOptional

    string

    https URL on a public address, POSTed on DOWN and UP; null removes it, unchanged when omitted

    May be null.

Example

dcloud monitoring checks update id

Generated from the API description, the same one the API checks requests against and the CLI is built from.