更新事件备注
此方法用于为安全事件添加备注
重要提示
该方法已更新至1.1版本。1.0版本适用信息请参阅 本节内容 .
参数
|
参数 |
类型 |
可选 |
描述 |
|---|---|---|---|
|
|
字符串 |
否 |
目标事件的类型。可能取值:
|
|
|
字符串 |
否 |
事件ID,从事件推送详情中获取。该值对应
提示您可以通过以下步骤从 GravityZone 控制台获取特定事件的ID:
|
|
|
字符串 |
否 |
要包含在备注中的文本。 备注若该事件已存在关联备注,原有备注将被覆盖。 |
返回值
本方法返回一个布尔值,当
True
时表示备注分配成功。
示例
请求 :
{
"params": {
"incidentId" : "621342db44747b408b7edf65",
"type" : "extendedIncidents" 或 "incidents",
"note" : "随机备注"
},
"jsonrpc": "2.0",
"method": "updateIncidentNote",
"id": "0df7568c-59c1-48e0-a31b-18d83e6d9810"
}
响应 :
{
"id": "0df7568c-59c1-48e0-a31b-18d83e6d9810",
"jsonrpc": "2.0",
"result": true
}
版本1.0
参数
|
参数名 |
类型 |
可选性 |
说明 |
|---|---|---|---|
|
|
字符串 |
否 |
目标事件类型。可选值:
|
|
|
字符串 |
否 |
从事件推送详情中获取的事件ID,其值对应
|
|
|
字符串 |
否 |
需包含在备注中的文本内容。 注意若该事件已存在关联备注,原有备注将被覆盖。 |
返回值
本方法返回一个布尔值,当值为
真
若笔记分配成功且返回以下对象:
-
data,包含事件相关信息的对象。-
lastUpdated- 笔记修改时的时间戳。
-
示例
请求 :
{
"params": {
"incidentId" : "621342db44747b408b7edf65",
"type" : "extendedIncidents" 或 "incidents",
"note" : "随机备注"
},
"jsonrpc": "2.0",
"method": "updateIncidentNote",
"id": "0df7568c-59c1-48e0-a31b-18d83e6d9810"
}
响应 :
{
"id": "0df7568c-59c1-48e0-a31b-18d83e6d9810",
"jsonrpc": "2.0",
"result": {
"success": true
}
}