uptimerobot.monitor.edit: Edit a monitor
In uptimeRobot: Access the UptimeRobot Ping API

Description Usage Arguments Details Value Author(s) Examples

uptimerobot.monitor.edit edits the properties for an existing monitor.

uptimerobot.monitor.edit(api.key, id, friendly.name = NULL, url = NULL,
  activate = TRUE, subtype = NULL, port = NULL, interval = NULL,
  keyword.type = NULL, keyword.value = NULL, HTTP.username = NULL,
  HTTP.password = NULL, alert.contacts = NULL)

`api.key`	string with a valid key for connecting to Uptimerobot API.
`id`	numeric or integer with the ID of the monitor to edit.
`friendly.name`	string the friendly (screen) name of the monitor.
`url`	string with the URL/IP of the monitor.
`activate`	logical to set the status of the monitor. Set to `TRUE` to start the monitor or `FALSE` to put it in paused state.
`subtype`	string used only for "Port monitoring" to set which pre-defined port/service is monitored or if a custom port is monitored. You can use both the friendly name (string) or the index (integer) here.
`port`	string used only for "Port monitoring" to set the port monitored.
`interval`	integer with the interval for the monitoring check (in minutes).
`keyword.type`	required string in Keyword monitoring".
`keyword.value`	string with the value of the keyword (required for keyword monitoring).
`HTTP.username`	string used for password-protected web pages (HTTP Basic Auth). Set to empty string to erase the current username. Available for HTTP and keyword monitoring.
`HTTP.password`	string used for password-protected web pages (HTTP Basic Auth). Set to empty string to erase the current password.Available for HTTP and keyword monitoring.
`alert.contacts`	character vector or data frame with the IDs to alert each with their threshold and recurrence values.

If a property has not to be updated, just omit it from the parameters or set to NA. To erase the value of a property, set it to an empty string, ie "", instead (not NA or NULL!).

The type of a monitor can not be edited (like changing a HTTP monitor into a Port monitor).

The alert contacts are whom to be notified when the monitor goes up/down.

Multiple alert contact IDs can be sent in a character vector or in a data frame. If you pass alert contact IDs in a vector, each element must be formatted in the form <id>_<threshold>_<recurrence> (note the underscores). If you prefer to format it as a data.frame, it must have these three columns: id, threshold, recurrence, numeric or integer. Order of the columns doesn't matter.

Please note that thresholds and recurrences can be omitted (default to zero) and, as they are only available in the Pro Plan, they are always 0 in the Free Plan.

The function returns TRUE in case success. An error is thrown otherwise.

Gabriele Baldassarre

## Not run: 
 # Let's assume the api.key is available into the environment variable KEY
 api.key <- Sys.getenv("KEY", "")

 # Create a monitor and get its monitor.id
 monitor.id <- uptimerobot.monitor.new(api.key,
   friendly.name="Open Analytics",
   url="https://gabrielebaldassarre.com", type="http"
 )

 # Change the friendly name of the monitor
  if(uptimerobot.monitor.edit(api.key,
     monitor.id,
     friendly.name="Open Analytics - gabrielebaldassarre.com"
  ){
   message("Monitor has been successfully edited!")
 }

 # Delete the just-made monitor
 if(uptimerobot.monitor.delete(api.key, monitor.id){
   message("Monitor has been successfully deleted!")
 }

## End(Not run)