EDB Postgres Enterprise Manager REST APIs v10.0: Alerts v10.2

get__alert_config_global_

Code samples

GET /alert/config/global/

Gets Alerts for global level.

Parameters

NameInTypeRequiredDescription
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_global_

Code samples

POST /alert/config/global/

Creates Alert for global level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_global_{alert_id}

Code samples

GET /alert/config/global/{alert_id}

Gets Alerts for global level by alert_id.

Parameters

NameInTypeRequiredDescription
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_global_{alert_id}

Code samples

PUT /alert/config/global/{alert_id}

Updates Alert for global level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_global_{alert_id}

Code samples

DELETE /alert/config/global/{alert_id}

Deletes the Alert object.

Parameters

NameInTypeRequiredDescription
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication

get__alert_config_agent_{agent_id}

Code samples

GET /alert/config/agent/{agent_id}

Gets Alerts for agent level by agent_id.

Parameters

NameInTypeRequiredDescription
agent_idpathintegertrueAgent ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_agent_{agent_id}

Code samples

POST /alert/config/agent/{agent_id}

Creates Alert for agent level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
agent_idpathintegertrueAgent ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_agent_{agent_id}_{alert_id}

Code samples

GET /alert/config/agent/{agent_id}/{alert_id}

Gets Alerts for agent level by agent_id and alert_id.

Parameters

NameInTypeRequiredDescription
agent_idpathintegertrueAgent ID
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_agent_{agent_id}_{alert_id}

Code samples

PUT /alert/config/agent/{agent_id}/{alert_id}

Updates Alert for agent level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
agent_idpathintegertrueAgent ID
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_agent_{agent_id}_{alert_id}

Code samples

DELETE /alert/config/agent/{agent_id}/{alert_id}

Deletes the Alert object.

Parameters

NameInTypeRequiredDescription
agent_idpathintegertrueAgent ID
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}

Code samples

GET /alert/config/server/{server_id}

Gets Alerts for server level by server_id.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_server_{server_id}

Code samples

POST /alert/config/server/{server_id}

Creates Alert for server level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_{alert_id}

Code samples

GET /alert/config/server/{server_id}/{alert_id}

Gets Alerts for server level by server_id and alert_id.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_server_{server_id}_{alert_id}

Code samples

PUT /alert/config/server/{server_id}/{alert_id}

Updates Alert for server level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_server_{server_id}_{alert_id}

Code samples

DELETE /alert/config/server/{server_id}/{alert_id}

Deletes the Alert object.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}

Gets Alerts for database level by server_id and database_name.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase Name
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_server_{server_id}_database_{database_name}

Code samples

POST /alert/config/server/{server_id}/database/{database_name}

Creates Alert for database level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase Name
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_{alert_id}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/{alert_id}

Gets Alerts for database level by server_id, database_name, and alert_id.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_server_{server_id}_database_{database_name}_{alert_id}

Code samples

PUT /alert/config/server/{server_id}/database/{database_name}/{alert_id}

Updates Alert for database level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_server_{server_id}_database_{database_name}_{alert_id}

Code samples

DELETE /alert/config/server/{server_id}/database/{database_name}/{alert_id}

Deletes the Alert object.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}

Gets Alerts for schema level by server_id, database_name, and schema_name.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase Name
schema_namepathstringtrueSchema Name
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}

Code samples

POST /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}

Creates Alert for schema level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase Name
schema_namepathstringtrueSchema Name
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_{alert_id}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/{alert_id}

Gets Alerts for schema level by server_id, database_name, schema_name, and alert_id.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_{alert_id}

Code samples

PUT /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/{alert_id}

Updates Alert for schema level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_{alert_id}

Code samples

DELETE /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/{alert_id}

Deletes the Alert object.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_table_{table_name}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/table/{table_name}

Gets Alerts for table level by server_id, database_name, schema_name, and table_name.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
table_namepathstringtrueTable name
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_table_{table_name}

Code samples

POST /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/table/{table_name}

Creates Alert for table level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
table_namepathstringtrueTable name
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_table_{table_name}_{alert_id}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/table/{table_name}/{alert_id}

Gets Alerts for table level by server_id, database_name, schema_name, table_name, and alert_id.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase Name
schema_namepathstringtrueSchema name
table_namepathstringtrueTable name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_table_{table_name}_{alert_id}

Code samples

PUT /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/table/{table_name}/{alert_id}

Updates Alert for table level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
table_namepathstringtrueTable name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_table_{table_name}_{alert_id}

Code samples

DELETE /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/table/{table_name}/{alert_id}

Deletes the Alert object.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
table_namepathstringtrueTable name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_index_{index_name}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/index/{index_name}

Gets Alerts for index level by server_id, database_name, schema_name, and index_name.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
index_namepathstringtrueIndex name
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_index_{index_name}

Code samples

POST /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/index/{index_name}

Create Alert for index level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
index_namepathstringtrueIndex name
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_index_{index_name}_{alert_id}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/index/{index_name}/{alert_id}

Gets Alerts for index level by server_id, database_name, schema_name, index_name, and alert_id.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
index_namepathstringtrueIndex name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_index_{index_name}_{alert_id}

Code samples

PUT /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/index/{index_name}/{alert_id}

Updates Alert for index level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
index_namepathstringtrueIndex name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_index_{index_name}_{alert_id}

Code samples

DELETE /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/index/{index_name}/{alert_id}

Deletes the Alert object.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
index_namepathstringtrueIndex name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_sequence_{sequence_name}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/sequence/{sequence_name}

Gets Alerts for sequence level by server_id, database_name, schema_name, and sequence_name.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
sequence_namepathstringtrueSequence name
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_sequence_{sequence_name}

Code samples

POST /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/sequence/{sequence_name}

Creates Alert for sequence level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
sequence_namepathstringtrueSequence Name
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_sequence_{sequence_name}_{alert_id}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/sequence/{sequence_name}/{alert_id}

Gets Alerts for sequence level by server_id, database_name, schema_name, sequence_name, and alert_id.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
sequence_namepathstringtrueSequence name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_sequence_{sequence_name}_{alert_id}

Code samples

PUT /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/sequence/{sequence_name}/{alert_id}

Updates Alert for sequence level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
sequence_namepathstringtrueSequence name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_sequence_{sequence_name}_{alert_id}

Code samples

DELETE /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/sequence/{sequence_name}/{alert_id}

Delete the Alert object.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
sequence_namepathstringtrueSequence name
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_function_{function_name}_args_{function_arguments}_

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/function/{function_name}/args/{function_arguments}/

Gets Alerts for function level by server_id, database_name, schema_name, and function_name.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
function_namepathstringtrueFunction name
function_argumentspathstringtrueComma-separated list of function arguments.
X-Auth-TokenheaderstringtrueToken of authorization
Detailed descriptions

function_arguments: Comma-separated list of function arguments.

Note: Provide space if no function argument

Example responses

200 Response
[
  {
    "id": 0,
    "alert_name": "string",
    "alert_template": 0,
    "description": "string",
    "enabled": true,
    "history_retention": 0,
    "frequency_min": 0,
    "operator": "string",
    "low_threshold_value": 0,
    "medium_threshold_value": 0,
    "high_threshold_value": 0,
    "send_email": true,
    "all_alert_enable": true,
    "email_group_id": 0,
    "low_alert_enable": true,
    "low_email_group_id": 0,
    "med_alert_enable": true,
    "med_email_group_id": 0,
    "high_alert_enable": true,
    "high_email_group_id": 0,
    "send_trap": true,
    "snmp_trap_version": 0,
    "low_send_trap": true,
    "med_send_trap": true,
    "high_send_trap": true,
    "params": [],
    "execute_script": true,
    "execute_script_on_clear": true,
    "execute_script_on_pem_server": true,
    "script_code": "string",
    "submit_to_nagios": true,
    "override_default_config": true,
    "send_notification": true,
    "low_webhook_ids": [
      0
    ],
    "med_webhook_ids": [
      0
    ],
    "high_webhook_ids": [
      0
    ],
    "cleared_webhook_ids": [
      0
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseInline

Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[Alert]falsenonenone
» idintegerfalsenoneAlert ID. NOTE: This property is not applicable for a POST request.
» alert_namestringfalsenoneName of the alert. NOTE: This property is a mandatory parameter for a POST request.
» alert_templateintegerfalsenoneID of the alert template. This property must be a positive integer value. NOTE: It is a mandatory parameter for a POST request.
» descriptionstringfalsenonenone
» enabledbooleanfalsenoneDetermines whether this alert is enabled/disabled. NOTE: This property is a mandatory parameter for a POST request.
» history_retentionintegerfalsenoneSpecifies how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: This property is a mandatory parameter for a POST request.
» frequency_minintegerfalsenoneDefines in minutes how frequently the alert must be checked on a PEM database server. Possible values are from 1 to 65534. NOTE: This property is a mandatory parameter for a POST request.
» operatorstringfalsenoneDefines the operator for checking threshold values. Valid strings are ">" and "<". NOTE: This property is a mandatory parameter for a POST request.
» low_threshold_valuenumberfalsenoneThreshold value for triggering the low alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» medium_threshold_valuenumberfalsenoneThreshold value for triggering the medium alert. This property can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» high_threshold_valuenumberfalsenoneThreshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request.
» send_emailbooleanfalsenoneDetermines whether to send an email when the state of the alert changes.
» all_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'email_group_id' when the state of the alert changes.
» email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes.
» low_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'low_email_group_id' when the state of the alert is set to LOW.
» low_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to LOW.
» med_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'medium_email_group_id' when the state of the alert is set to MEDIUM.
» med_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when state of the alert changes to MEDIUM.
» high_alert_enablebooleanfalsenoneDetermines whether to send an email notification to the group specified by the parameter 'high_email_group_id' when the state of the alert is set to HIGH.
» high_email_group_idintegerfalsenoneDefines the email group to which email notification are sent when the state of the alert changes to HIGH.
» send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes.
» snmp_trap_versionintegerfalsenoneDefines the SNMP trap version. Supported SNMP trap versions are 1, 2 or 3
» low_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notifications when the state of the alert changes to LOW.
» med_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to MEDIUM.
» high_send_trapbooleanfalsenoneDetermines whether to send SNMP trap notification when the state of the alert changes to HIGH.
» params[AlertParams]falsenoneList of parameter/value pairs to be used by the alert template for checking alerts. NOTE: The alert template requires the all parameter to be defined.
»» paramnamestringfalsenoneName of the parameter. NOTE: This property must present on the alert template parameter list.Example:
»» paramvaluestringfalsenoneValue for the given parameter
» execute_scriptbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert changes to LOW/MEDIUM/HIGH.
» execute_script_on_clearbooleanfalsenoneDetermines whether to execute the provided script if the state of the alert is cleared.
» execute_script_on_pem_serverbooleanfalsenoneDetermines whether to execute the provided script on the PEM host or the host where the agent is monitoring the object.
» script_codestringfalsenoneThe shell or batch script to be executed. Please read the documentation for detailed information.
» submit_to_nagiosbooleanfalsenoneDetermines whether to send notification to the nagios when the state of the alert changes.
» override_default_configbooleanfalsenoneDetermines whether to override the default webhook configuration.
» send_notificationbooleanfalsenoneDetermines whether to enable the webhook send notification.
» low_webhook_ids[integer]falsenoneWebhook IDs for which low alerts are configured
» med_webhook_ids[integer]falsenoneWebhook IDs for which medium alerts are configured
» high_webhook_ids[integer]falsenoneWebhook IDs for which high alerts are configured
» cleared_webhook_ids[integer]falsenoneWebhook IDs for which cleared alerts are configured
Enumerated Values
PropertyValue
paramnameExclude tables smaller than
paramnamemount point
paramnameHost IP Address
paramnameTime interval to monitor
paramnameTime since idle
paramnamePer CPU utilization (K%)
Info

This operation does not require authentication

post__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_function_{function_name}_args_{function_arguments}_

Code samples

POST /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/function/{function_name}/args/{function_arguments}/

Creates Alert for function level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
function_namepathstringtrueFunction name
function_argumentspathstringtrueComma-separated list of function arguments.
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone
Detailed descriptions

function_arguments: Comma-separated list of function arguments.

Note: Provide space if no function argument

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

get__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_function_{function_name}_args_{function_arguments}_{alert_id}

Code samples

GET /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/function/{function_name}/args/{function_arguments}/{alert_id}

Gets Alerts for function level by server_id, database_name, schema_name, function_name, and alert_id.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
function_namepathstringtrueFunction name
function_argumentspathstringtrueComma-separated list of function arguments.
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
Detailed descriptions

function_arguments: Comma-separated list of function arguments.

Note: Provide space if no function argument

Example responses

200 Response
{
  "id": 0,
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "send_email": true,
  "all_alert_enable": true,
  "email_group_id": 0,
  "low_alert_enable": true,
  "low_email_group_id": 0,
  "med_alert_enable": true,
  "med_email_group_id": 0,
  "high_alert_enable": true,
  "high_email_group_id": 0,
  "send_trap": true,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": true,
  "low_webhook_ids": [
    0
  ],
  "med_webhook_ids": [
    0
  ],
  "high_webhook_ids": [
    0
  ],
  "cleared_webhook_ids": [
    0
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKSuccessful responseAlert
Info

This operation does not require authentication

put__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_function_{function_name}_args_{function_arguments}_{alert_id}

Code samples

PUT /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/function/{function_name}/args/{function_arguments}/{alert_id}

Updates Alert for function level.

Body parameter

{
  "alert_name": "string",
  "alert_template": 0,
  "description": "string",
  "enabled": true,
  "history_retention": 0,
  "frequency_min": 0,
  "operator": "string",
  "low_threshold_value": 0,
  "medium_threshold_value": 0,
  "high_threshold_value": 0,
  "all_alert_enable": true,
  "email_group_id": 1,
  "low_alert_enable": true,
  "low_email_group_id": 1,
  "med_alert_enable": true,
  "med_email_group_id": 1,
  "high_alert_enable": true,
  "high_email_group_id": 1,
  "send_trap": false,
  "snmp_trap_version": 0,
  "low_send_trap": true,
  "med_send_trap": true,
  "high_send_trap": true,
  "params": [],
  "execute_script": true,
  "execute_script_on_clear": true,
  "execute_script_on_pem_server": true,
  "script_code": "string",
  "submit_to_nagios": true,
  "override_default_config": true,
  "send_notification": false,
  "low_webhook_ids": [],
  "med_webhook_ids": [],
  "high_webhook_ids": [],
  "cleared_webhook_ids": []
}

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
function_namepathstringtrueFunction name
function_argumentspathstringtrueComma-separated list of function arguments.
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
bodybodyAlertPayloadtruenone
Detailed descriptions

function_arguments: Comma-separated list of function arguments.

Note: Provide space if no function argument

Example responses

Responses

StatusMeaningDescriptionSchema
200OKStatus 200None

Response Schema

Info

This operation does not require authentication

delete__alert_config_server_{server_id}_database_{database_name}_schema_{schema_name}_function_{function_name}_args_{function_arguments}_{alert_id}

Code samples

DELETE /alert/config/server/{server_id}/database/{database_name}/schema/{schema_name}/function/{function_name}/args/{function_arguments}/{alert_id}

Deletes the Alert object.

Parameters

NameInTypeRequiredDescription
server_idpathintegertrueServer ID
database_namepathstringtrueDatabase name
schema_namepathstringtrueSchema name
function_namepathstringtrueFunction name
function_argumentspathstringtrueComma-separated list of function arguments.
alert_idpathintegertrueAlert ID
X-Auth-TokenheaderstringtrueToken of authorization
Detailed descriptions

function_arguments: Comma-separated list of function arguments.

Note: Provide space if no function argument

Example responses

Responses

StatusMeaningDescriptionSchema
200OKSuccessful deletionNone

Response Schema

Info

This operation does not require authentication