Notification

Retrieve system notification settings

get

Retrieve details of system notification settings.

Authorizations

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /api/admin/notification HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "server": "text",
  "port": 80,
  "reply_to": "text",
  "username": "text",
  "auth": "LOGIN",
  "enable_tls_ssl": true,
  "enable_starttls_auto": true,
  "recipients": "text",
  "hard_disk_threshold": 0.9,
  "notify_hard_disk_exceeded_threshold": true,
  "cpu_threshold": 0.9,
  "notify_cpu_exceeded_threshold": true,
  "memory_threshold": 0.9,
  "notify_memory_exceeded_threshold": true,
  "notify_ip_blocked": true,
  "notify_license_limited": true,
  "notify_service_disconnected": true,
  "notify_push_certs_update_failed": true
}

Update system notification settings

post

Update system notification settings.

Authorizations

Body

serverstringoptional

SMTP server used for sending mails.

portinteger · int32 · max: 65535optional

A port number is a 16-bit unsigned integer, thus ranging from 0 to 65535. For TCP, port number 0 is reserved and cannot be used, while for UDP, the source port is optional and a value of zero means no port

Example: 80

reply_tostringoptional

A Reply-To address is identified by inserting the Reply-To header in your email.
It is the email address that the reply message is sent when you want the reply to go to an email address that is different than the From: address.

usernamestring · max: 128optional

Username or email address.

passwordstringoptional

Password for email account.

authstring · enumoptional

The authorization protocols.
Can be either:

• LOGIN: Use LOGIN authorization protocol.
• PLAIN Use PLAIN authorization protocol.

Available options:

enable_tls_sslbooleanoptional

Whether to enable TLS/SSL.

Default: true

enable_starttls_autobooleanoptional

Whether StartTLS is automatically enabled.

Default: true

recipientsstringoptional

Comma-separated list of email address that should receive notifications.
Allow up to 15 email addresses.

hard_disk_thresholdnumber · doubleoptional

The hard disk threshold for email warning.

Example: 0.9

notify_hard_disk_exceeded_thresholdbooleanoptional

Send a notification email when specified hard disk threshold is exceeded.

Default: false

cpu_thresholdnumber · doubleoptional

The CPU threshold for email warning.

Example: 0.9

notify_cpu_exceeded_thresholdbooleanoptional

Send a notification email when specified CPU threshold is exceeded.

Default: false

memory_thresholdnumber · doubleoptional

The memory threshold for email warning.

Example: 0.9

notify_memory_exceeded_thresholdbooleanoptional

Send an email notification when specified memory threshold is exceeded.

Default: false

notify_ip_blockedbooleanoptional

Send a notification email when ip blocked.

Default: false

notify_license_limitedbooleanoptional

Send a notification email when license limit reached.

Default: false

notify_service_disconnectedbooleanoptional

Send a notification email when some service disconnected.

Default: false

notify_push_certs_update_failedbooleanoptional

Send a notification email when push notification certificates update failed.

Default: false

Responses

post

HTTPcURLJavaScriptPython

POST /api/admin/notification HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 484

{
  "server": "text",
  "port": 80,
  "reply_to": "text",
  "username": "text",
  "password": "text",
  "auth": "LOGIN",
  "enable_tls_ssl": true,
  "enable_starttls_auto": true,
  "recipients": "text",
  "hard_disk_threshold": 0.9,
  "notify_hard_disk_exceeded_threshold": true,
  "cpu_threshold": 0.9,
  "notify_cpu_exceeded_threshold": true,
  "memory_threshold": 0.9,
  "notify_memory_exceeded_threshold": true,
  "notify_ip_blocked": true,
  "notify_license_limited": true,
  "notify_service_disconnected": true,
  "notify_push_certs_update_failed": true
}

No Content