Create History Alert¶

Create a new history alert. Except for the mandatory verification, there is no need to verify the legality of other parameters. The parameters used by users such as contentId would not be maintained on the EnOS Cloud. The inserted alert with the same assetId, measurepointId and occurTime will be as updated only.

Operation Permissions¶

Required Authorization	Required Operation Permission
orgId	Full Access

Request Format¶

POST https://{apigw-address}/event-service/v2.1/history-alerts?action=create

Request Parameters (URI)¶

Name	Location (Path/Query)	Required or Not	Data Type	Description
orgId	Query	true	String	Organization ID which the asset belongs to. How to get orgId>>

Request Parameters (Body)¶

Name	Required or Not	Data Type	Description
historyAlertList	true	HistoryAlert struct	History alert. See HistoryAlert Struct

HistoryAlert Struct¶

Note

In the following non-required fields, you must provide measurepointId or deviceStatus to trigger the alert.

Name	Required or Not	Data Type	Description
assetId	true	String	Asset ID. How to get assetId>>
modelId	true	String	ID of the model applicable for the alert. How to get modelID>>
modelIdPath	false	String	Model path
measurepointId	false	String	Asset measurement point. How to get pointId>>
deviceStatus	false	String	Device status, such as “offline”. For more information, see Setting State-based Alerts>>
value	true	Object	Measurement point value
occurTime	true	Long	Occurrence time in UTC format. For time formats, see ISO8601 Standard Time Formats Used by UTC>>
localOccurTime	false	String	Occurrence time in local format. For time formats, see Data and Time Formats Used by Localtime>>
recoverTime	true	Long	Recovery time in UTC format. For time formats, see ISO8601 Standard Time Formats Used by UTC>>
localRecoverTime	false	String	Recovery time in local format. For time formats, see Data and Time Formats Used by Localtime>>
recoverReason	false	String	Recovery reason
severityId	false	String	Alert severity ID
severityDesc	false	StringI18n	Alert severity description
typeId	false	String	Alert type ID
typeDesc	false	StringI18n	Alert type description
subTypeId	false	String	Alert sub-type ID
subTypeDesc	false	StringI18n	Alert sub-type description
contentId	false	String	Alert content ID
contentDesc	false	StringI18n	Alert content description
tags	false	tags data type	Tags

Response Parameters¶

Name	Data Type	Description
eventId	String	Alert ID

Sample¶

Request Sample¶

POST https://{apigw-address}/event-service/v2.1/history-alerts?action=create&orgId=1c499110e8800000
{
  "historyAlert": {
     "assetId": "qu5TmJRj",
     "modelId": "Inverter_Model",
     "modelIdPath": "/Inverter_Model",
     "measurepointId": "power",
     "value": "3.5559796405967736",
     "occurTime": 1559304899404,
     "localOccurTime": "2019-06-01 02:14:59",
     "recoverTime": 1559304900404,
     "localRecoverTime": "2019-06-01 12:14:59",
         "severityId": "alert_001",
     "severityDesc": {
        "defaultValue": "Warn",
         "i18nValue": {
             "en_US": "alert",
             "zh_CN": "alert"
         }
     },
     "typeId": "errorType",
     "typeDesc": {
        "defaultValue": "Warn",
         "i18nValue": {
             "en_US": "login failed",
             "zh_CN": "登录失败"
         }
     },
     "contentId": "planetTemperature",
     "contentDesc": {
        "defaultValue": "the temperature is too high",
         "i18nValue": {
             "en_US": "the temperature is too high",
             "zh_CN": "温度过高"
         }
     },
     "tags": {
         "Tag666": "63253w532",
         "Tag888": "63253w532888",
         "Tag": "1111"
     }
  }
}

Return sample¶

{
    "code": 0,
    "msg": "OK",
    "requestId": "4873095e-621d-4cfd-bc2c-edb520f574ea",
    "eventId": "20191101479fb7810c81a0cfe08f3552db40e546"
}