Batch Create Alerts¶

批量创建告警记录，一次最多创建 1000 条。

请求格式¶

POST https://{apigw-address}/alert-service/v2.1/alerts?action=batchCreate

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的组织 ID。如何获取 orgId 信息>>

请求参数（Body）¶

名称	必需/可选	数据类型	描述
alertVoList	必选	AlertVo 结构体数组	告警记录的信息。有关 AlertVo 结构体的定义，参见 AlertVo 结构体>>

AlertVo 结构体 ¶

名称	必需/可选	数据类型	描述
eventType	必需	Integer	`0`：通过规则触发的告警解除（历史告警） `1`：通过规则触发的告警开始（当前告警） `2`：通过接口创建的告警解除（历史告警） `3`：通过接口创建的告警开始（当前告警） `4`：离散告警（历史告警） `5`：乱序告警（历史告警）在 Batch Create Alerts 接口中，赋值仅支持 `2`、`3`、`4`。
orgId	可选	String	资产所属的组织 ID。
instanceId	必需	String	告警的实体，现阶段只有 asset，取值为 assetId。
metricId	必需	String	原始度量数据的 ID。
occurTime	必需	Long	告警发生的时间，以 UTC 时间表示，格式见 UTC 采用的 ISO8601 标准时间格式>>
localOccurTime	可选	String	告警发生的时间，以本地时间表示，格式见 localtime 采用的日期时间格式>>
recoverTime	当前告警（实时告警）：选填历史告警（恢复告警）：必填	Long	触发告警的异常状况恢复正常的时间，以 UTC 时间表示，格式见 UTC 采用的 ISO8601 标准时间格式>>
localRecoverTime	可选	String	触发告警的异常状况恢复正常的时间，以本地时间表示，格式见 localtime 采用的日期时间格式>>
recoverReason	可选	String	异常状况恢复的原因。
value	必需	String	告警产生时的度量值（metric value）。对于高级的告警功能，比如多测点告警或时序告警，赋值采用告警产生时对应 metric 的 value。
metricTags	可选	Map	原始度量数据的标签。Key 和 Value 为 String。标签的作用与表示方法>> 不同业务/系统会有不同的原始度量，定义的标签也会不同。EnOS 定义了如下标准标签（metricTags），其中使用“ __ ”作为前缀和后缀的标签是通用标签, 未包含“ __ ”的标签是业务相关的标签。 { __timezone__：时区 __instance__：实例标识符，对应参数 instanceId __metric__：度量指标标识符，对应参数 metricId __alias__：度量指标标识符（metricId）的别名 modelIdPath：模型路径 modelId：模型标识符 assetTreePath：资产树路径 assetTreePath_${treeId}：指定资产树标识符（treeId）的资产树路径 }
severityId	可选	String	告警级别编号。
severityDesc	可选	StringI18n	告警级别描述。结构参见国际化名称结构体。
typeId	可选	String	告警类型编号。
typeDesc	可选	StringI18n	告警类型描述。结构参见国际化名称结构体。
parentTypeId	可选	String	告警父类型编号。
parentTypeDesc	可选	StringI18n	告警父类型描述。结构参见国际化名称结构体。
content	可选	StringI18n	告警内容。结构参见国际化名称结构体。
ruleId	可选	String	告警规则编号。
ruleDesc	可选	StringI18n	告警规则描述。结构参见国际化名称结构体。
ruleTags	可选	Map	规则上的标签。
tags	可选	Map	标签，只支持全量更新。标签的作用与表示方法>>
inhibited	可选	Boolean	`true`：屏蔽 `false`：没被屏蔽

响应参数¶

名称	数据类型	描述
data	EnosBatchEachData 结构体数组	成功或失败消息列表。有关 EnosBatchEachData 结构体的定义，参见 EnosBatchEachData 结构体>>
successSize	Integer	成功数。
totalSize	Integer	总数。

EnosBatchEachData 结构体 ¶

名称	数据类型	描述
code	Integer	更新成功或失败的指示码： 0: 成功， -1: 失败。
msg	String	提示格式正确还是错误。
data	String	若创建成功，则为 `alertId`。若返回其他值，则为失败。

示例¶

请求示例¶

url: POST https://{apigw-address}/alert-service/v2.1/alerts?action=batchCreate&orgId=yourOrgId
method: POST
requestBody:
{
    "alertVoList":[
        {
            "eventType":3,
            "instanceId":"deviceId_37233",
            "metricId":"pointId_772",
            "occurTime":1547824973674,
            "localOccurTime":"2018-01-01 01:01:01",
            "recoverTime":1547824973674,
            "localRecoverTime":"2018-02-02 00:00:00",
            "recoverReason":"rpc",
            "value":"5",
            "metricTags":{
                "modelId":"modelId_11",
                "modelIdPath":"path"
            },
            "severityId":"42j",
            "severityDesc":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "typeId":"11d",
            "typeDesc":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "parentTypeId":"d1",
            "parentTypeDesc":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "content":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "ruleId":"5v7",
            "ruleDesc":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "ruleTags":{
                "color":"red",
                "category":"note"
            },
            "tags":{
                "de":"haha"
            },
            "inhibited":false
        },
        {
            "eventType":3,
            "instanceId":"deviceId_37233",
            "metricId":"pointId_772",
            "occurTime":1547824973674,
            "localOccurTime":"2018-01-01 01:01:01",
            "recoverTime":1547824973674,
            "localRecoverTime":"2018-02-02 00:00:00",
            "recoverReason":"rpc",
            "value":"5",
            "metricTags":{
                "modelId":"modelId_11",
                "modelIdPath":"path"
            },
            "severityId":"42j",
            "severityDesc":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "typeId":"11d",
            "typeDesc":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "parentTypeId":"d1",
            "parentTypeDesc":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "content":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "ruleId":"5v7",
            "ruleDesc":{
                "i18nValue":{
                    "en_US":"wow",
                    "zh_CN":""
                }
            },
            "ruleTags":{
                "color":"red",
                "category":"note"
            },
            "tags":{
                "de":"haha"
            },
            "inhibited":false
        }
    ]
}

返回示例¶

{
  "code":0,
  "msg":"OK",
  "requestId": "yourReportID",
  "data":[
    {
      "code":0,
      "msg":"format right",
      "data":"2020101011ee0917bcd4f740decfaba8f27613c5"
    },
    {
      "code":0,
      "msg":"format right",
      "data":"2020101011ee0917bcd4f740decfaba8f27613c5"
    }
  ],
  "successSize":2,
  "totalSize":2
}