调用GetSuspiciousStatistics接口查询一个或多个资产分组下的安全告警数量统计值。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetSuspiciousStatistics

要执行的操作。

取值:GetSuspiciousStatistics

GroupIdList String 9997897

指定要查询的资产分组ID。多个资产分组ID使用半角逗号(,)分隔。

说明 您可以调用DescribeAllGroups接口获取该参数。
SourceIp String 10.12.XX.XX

指定访问源的IP地址。

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
RemindCount Integer 0

告警级别为提醒的安全告警的数量。

RequestId String 84092B42-1A59-4F34-8DF8-1D93520990A5

阿里云为该请求生成的唯一标识符。

SeriousCount Integer 1

告警级别为紧急的安全告警的数量。

SuspiciousCount Integer 8

告警级别为可疑的安全告警的数量。

TotalCount Integer 9

安全告警的总数量。

示例

请求示例

http(s)://[Endpoint]/?Action=GetSuspiciousStatistics
&GroupIdList=9997897
&<公共请求参数>

正常返回示例

XML格式

<GetSuspiciousStatisticsResponse>
      <TotalCount>9</TotalCount>
      <RequestId>84092B42-1A59-4F34-8DF8-1D93520990A5</RequestId>
      <RemindCount>0</RemindCount>
      <SuspiciousCount>8</SuspiciousCount>
      <SeriousCount>1</SeriousCount>
</GetSuspiciousStatisticsResponse>

JSON格式

{
  "TotalCount": 9,
  "RequestId": "84092B42-1A59-4F34-8DF8-1D93520990A5",
  "RemindCount": 0,
  "SuspiciousCount": 8,
  "SeriousCount": 1
}

错误码

访问错误中心查看更多错误码。