跳至主内容

获取响应动作状态

可通过此方法查询响应动作的执行状态及结果

参数列表

参数

说明

请求包含

类型

取值

actionId

用于验证操作状态的ID。

必填

字符串

无附加取值。

返回值

属性

类型

描述

type

整数

表示所采取的操作类型及操作对象用户类型。

可能的操作：

  • 1 - 强制重置Office 365用户凭据。

  • 2 - 强制重置Active Directory用户凭据。

  • 3 - 禁用Active Directory用户。

  • 4 - 禁用Office 365用户。

  • 5 - 将Office 365用户标记为已泄露。

  • 6 - 删除Office 365用户的电子邮件账户。

  • 10 - 删除Office 365 OneDrive或SharePoint文件。

generatedOn

字符串

响应动作创建时的时间戳。

status

Integer

响应动作的状态。

可能取值：

  • 0 - 未开始

  • 1 - 待执行

  • 2 - 挂起

  • 3 - 执行中

  • 4 - 执行成功

  • 5 - 执行失败

  • 6 - 已驳回

  • 7 - 需外部操作

  • 8 - 外部已完成

errorId

String

若响应动作失败，错误消息的ID。

errorDescription

String

若响应动作失败，错误消息的描述。

incidentId

字符串

用户节点所属的事件ID（如存在）

companyId

字符串

执行响应操作的企业ID

userId

字符串

发起响应操作的用户ID

userName

字符串

发起响应操作的用户名

targetUserId

字符串

被实施响应操作的用户ID

targetUserName

字符串

被实施响应操作的用户名（如存在）

targetEmailId

字符串

被实施响应操作的电子邮件消息ID（如适用）

示例

请求 

{
     "params": {
         "actionId": "6912758f88df334ddbfb7e1a"
     },
     "jsonrpc": "2.0",
     "method": "getResponseActionStatus",
     "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
 }

响应 

{
     "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8",
     "jsonrpc": "2.0",
     "result": {
         "type": 5,
         "generatedOn": "2023-08-06T23:43:27",
         "status": 3,
         "errorId": null,
         "errorDescription": null,
         "incidentId": "6682758b1f3a95f78dd4cc08",
         "companyId": "5b680f6fb1a43d860a7b23c8",
         "userId": "66b9fd2985ecb7506a0ef3e3",
         "userName": "user@bitdefender.com",
         "targetUserId": "66b9fd2985ecb7506a0ef3ex",
         "targetUserName": "username",
         "targetEmailId": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
     }
 }
本节内容 :