Update Alert Type


更新告警类型。需要校验的字段为 typeId。如果告警类型已经有了父告警类型(parentTypeId)或不是一个子类型,则该父告警类型不能被修改。

请求格式

POST https://{apigw-address}/event-service/v2.1/alert-types?action=update

请求参数(URI)

名称

位置(Path/Query)

必需/可选

数据类型

描述

orgId

Query

必需

String

资产所属的组织 ID。如何获取 orgId 信息>>

isPatchUpdate

Query

必需

Boolean

是否全量更新。 当其值为 true 时,只更新参数中指定字段的值; 当其值为 false 时,更新所有字段的值,即未指定值的字段将被置空。

请求参数(Body)

名称

必需/可选

数据类型

描述

type

必需

GenerateType 结构体

告警类型,其结构参见 GenerateType 结构体

GenerateType 结构体

名称

必需/可选

数据类型

描述

typeId

必需

String

告警类型编号

typeDesc

必需

StringI18n

国际化告警类型描述,其中 default 必填。其结构参见 国际化名称结构体

tags

可选

tags 数据类型

告警类型的标签。标签的作用与表示方法>>

parentTypeId

可选

String

父告警类型编号。只有在告警类型是另一类型的子类型时才能使用。

示例

请求示例

url: https://{apigw-address}/event-service/v2.1/alert-types?action=update&orgId=yourOrgId&isPatchUpdate=false
method: POST
requestBody:
{
  "action": "update",
    "type":{
        "typeId":"planetTemperature",
        "typeDesc":{
            "defaultValue":"OverLimit",
            "parentTypeId":"parent",
            "i18nValue":{
                "en_US":"OverLimit",
                "zh_CN":"超限"
            }
        },
        "tags":{
            "year":"2000",
            "author":"cshan"
        },
    "parentTypeId": "chenchen_test_documentation"
    }
}

返回示例

{
    "code": 0,
    "msg": "OK",
    "requestId": "4873095e-621d-4cfd-bc2c-edb520f574ea",
    "data": null
}

SDK 示例


你可以在 Github 上获取告警引擎的 SDK 示例: