DescribeApisecStatistics - 查询API安全检测统计信息

更新时间:
复制 MD 格式

查询API安全风险或安全事件的检测统计信息。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-waf:DescribeApisecStatistics

get

*全部资源

*

  • acs:ResourceGroupId
无

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

是

WAF 实例的 ID。

说明

您可以调用 DescribeInstance 查询当前 WAF 实例的 ID。

waf_v2_public_cn-uax***b09

Type

string

否

检测统计类型。取值:

  • risk:表示风险影响统计。

  • event:表示攻击影响统计。

risk

ClusterId

string

否

混合云集群 ID。

说明

只针对混合云场景,您可以调用 DescribeHybridCloudClusters 获取混合云集群信息。

428

RegionId

string

否

WAF 实例所属地域。取值:

  • cn-hangzhou:表示中国内地。

  • ap-southeast-1:表示非中国内地。

cn-hangzhou

ResourceManagerResourceGroupId

string

否

阿里云资源组 ID。

rg-aek2***uwbs5q

StartTime

integer

否

查询的开始时间,格式为 Unix 时间戳(UTC 时间),单位为秒。

1668496310

EndTime

integer

否

查询的结束时间,格式为 Unix 时间戳(UTC 时间),单位为秒。

1726113600

UserStatusList

array

否

检测统计的状态列表。

string

否

统计的风险或安全事件的状态。

说明

您可以查看 DescribeApisecAbnormals 、 DescribeApisecEvents 的入参 UserStatus 获取支持风险和安全事件支持的状态取值。

toBeConfirmed

返回参数

名称

类型

描述

示例值

object

请求结果。

RequestId

string

请求 ID。

221F0F14-54C6-59A1-9967-72***81B61A

Data

object

统计结果。

High

integer

高危数量。

135

ToBeFixed

integer

待修复数量。

3

Ignore

integer

已忽略数量。

3

TodayTotal

string

今日新增总数量。

3

TodayMedium

string

今日新增中危数量。

0

TodayHigh

string

今日新增高危数量。

3

Low

integer

低危数量。

160

Medium

integer

中危数量。

27

Total

integer

总数。

说明

出参 High、Medium、Low 的总和。

322

TodayLow

integer

今日新增低危数量。

0

ToBeConfirmed

integer

待确认数量。

295

Api

integer

API 数量。

202

Confirmed

integer

已确认数量。

11

Domain

integer

域名数量。

22

Fixed

integer

已修复(人工验证)数量。

13

Actioned

integer

已处置数量。

1

ToBeVerified

integer

待系统验证的数量。

2

NotFixed

integer

验证未修复的数量。

0

SystemFixed

integer

已修复(系统验证)数量。

1

Account

integer

账号数量。

1

示例

正常返回示例

JSON格式

{
  "RequestId": "221F0F14-54C6-59A1-9967-72***81B61A",
  "Data": {
    "High": 135,
    "ToBeFixed": 3,
    "Ignore": 3,
    "TodayTotal": "3",
    "TodayMedium": "0",
    "TodayHigh": "3",
    "Low": 160,
    "Medium": 27,
    "Total": 322,
    "TodayLow": 0,
    "ToBeConfirmed": 295,
    "Api": 202,
    "Confirmed": 11,
    "Domain": 22,
    "Fixed": 13,
    "Actioned": 1,
    "ToBeVerified": 2,
    "NotFixed": 0,
    "SystemFixed": 1,
    "Account": 1
  }
}

错误码

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

变更历史

更多信息,参考变更详情。