/config/alert/reporter/mail

The configuration for reporting alerts via email server. If alert reporting via web server is enabled (/config/alert/reporter/web/uri is not empty), reporting via email server is disabled.

Get /config/alert/reporter/mail

SecurityApiKey
Request
query Parameters
max-depth
integer >= 1

Limit output depth of the response. See Max-Depth.

Example: max-depth=2
filter
string

Response filter string. See Filter-Spec.

Example: filter={foo,bar}
Responses
200

Normal response.

401

Unauthorized response.

get/config/alert/reporter/mail
Request samples
Response samples
application/json
{
  • "result": {
    },
  • "error": "Error message (present if an error occurred)."
}

Replace /config/alert/reporter/mail

SecurityApiKey
Request
Request Body schema: application/json
server
string (configAlertReporterMailServer)

The hostname of a mail server that speaks the SMTP protocol. If this is set to an empty string, the meter will attempt to deliver mail directly to the destination host. Many Internet service providers block direct mail delivery, so leaving this string empty generally results in alert emails getting blocked.

user
string (configAlertReporterMailUser)

The user name to provide to the email server for authentication purposes.

password
string (configAlertReporterMailPassword)

The password to provide to the email server for authentication purposes.

This resource is write-only.

from-address
string (configAlertReporterMailFromAddress)

The "From" email address to use when sending an email alert. If set to an empty string, the email server will use a default address.

Array of objects (configAlertReporterMailTo)

The email destinations to send the alerts to.

Responses
200

Normal response.

401

Unauthorized response.

put/config/alert/reporter/mail
Request samples
application/json
{ }
Response samples
application/json
{
  • "status": "OK",
  • "error": "Error message (present if an error occurred)."
}

Update /config/alert/reporter/mail

SecurityApiKey
Request
Request Body schema: application/json
server
string (configAlertReporterMailServer)

The hostname of a mail server that speaks the SMTP protocol. If this is set to an empty string, the meter will attempt to deliver mail directly to the destination host. Many Internet service providers block direct mail delivery, so leaving this string empty generally results in alert emails getting blocked.

user
string (configAlertReporterMailUser)

The user name to provide to the email server for authentication purposes.

password
string (configAlertReporterMailPassword)

The password to provide to the email server for authentication purposes.

This resource is write-only.

from-address
string (configAlertReporterMailFromAddress)

The "From" email address to use when sending an email alert. If set to an empty string, the email server will use a default address.

Array of objects (configAlertReporterMailTo)

The email destinations to send the alerts to.

Responses
200

Normal response.

401

Unauthorized response.

post/config/alert/reporter/mail
Request samples
application/json
{ }
Response samples
application/json
{
  • "status": "OK",
  • "error": "Error message (present if an error occurred)."
}

Delete /config/alert/reporter/mail

Reset to default (email reporting disabled).

SecurityApiKey
Responses
200

Normal response.

401

Unauthorized response.

delete/config/alert/reporter/mail
Request samples
Response samples
application/json
{
  • "status": "OK",
  • "error": "Error message (present if an error occurred)."
}