使用DescribeOpEntities查询DDoS原生防护的操作日志-DDoS防护-阿里云

查询DDoS原生防护的操作日志。

接口说明

本接口用于分页查询 DDoS 原生防护的操作日志。

QPS 限制

本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用将会被限流，这可能影响您的业务，请合理调用。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
yundun-antiddosbag:DescribeOpEntities	get	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
CurrentPage	integer	是	分页查询时，设置当前页面的页码。	1
PageSize	integer	是	分页查询时，设置每页包含操作日志的数量。最大值：50。	10
StartTime	long	是	设置开始时间，查询在 StartTime 后产生的操作日志。使用时间戳表示，单位：毫秒。	1609430400000
EndTime	long	是	设置结束时间，查询在 EndTime 前产生的操作日志。使用时间戳表示，单位：毫秒。	1640880000000
OrderBy	string	否	设置操作日志的排序字段。取值固定为 opdate，表示按照操作时间排序。	opdate
OrderDir	string	否	设置操作日志的排序方式。取值： ASC：表示按照正序排序。 DESC：表示按照倒序排序。默认：DESC	ASC
InstanceId	string	否	要查询的 DDoS 原生防护实例的 ID。说明您可以调用 DescribeInstanceList 查询所有 DDoS 原生防护实例的 ID。	ddosbgp-cn-n6w1r7nz****
ResourceGroupId	string	否	DDoS 原生防护实例在资源管理服务中所属的资源组 ID。不设置该参数表示默认资源组。	rg-acfm2pz25js****
RegionId	string	否	DDoS 原生防护实例所在地域 ID。说明您可以调用 DescribeRegions 查询 DDoS 原生防护支持的所有地域 ID。	cn-hangzhou
OpAction	integer	否	操作类型。取值： 3：绑定 IP。 4：解绑 IP。 5：降级。 6：解除黑洞。 7：重置解黑洞次数。 8：恢复弹性。 9：添加资产组。 10：删除资产组。 11：开启日 95 带宽。 12：开启月 95 带宽。 13：定期切换日月带宽 95 模式。 14：关闭日 95 带宽。 15：关闭月 95 带宽。 16：欠费关闭弹性业务带宽。 17：过期关闭弹性业务带宽。	3

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

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

返回参数

名称	类型	描述	示例值
	object
TotalCount	integer	查询到的操作日志的总数量。	1
RequestId	string	本次请求的 ID。	52C8ECB0-0B1A-4E66-A31C-B6A855120E82
OpEntities	array<object>	操作日志的详情列表。
OpEntity	object	操作日志对象。
EntityType	integer	操作对象类型。取值固定为 1，表示 DDoS 原生防护实例。	1
EntityObject	string	操作对象，即 DDoS 原生防护实例的 ID。	ddosbgp-cn-n6w1r7nz****
OpAction	integer	操作类型。取值： 3：表示为 DDoS 原生防护实例添加防护 IP。 4：表示为 DDoS 原生防护实例解绑防护 IP。 5：表示为 DDoS 原生防护实例降配。 6：表示解除黑洞。 7：表示重置解除黑洞次数。 8：表示恢复弹性防护。	8
GmtCreate	long	日志的创建时间。使用时间戳表示，单位：毫秒。	1635818114000
OpAccount	string	执行本次操作的阿里云账号 ID。说明如果取值为 system，表示本次操作由 DDoS 原生防护服务自动执行。	171986973287****
OpDesc	string	操作详情。使用 JSON 结构体转换的字符串表示。JSON 结构体包含以下字段： entity：Object 类型 \| 表示操作对象。根据操作类型（OpAction）不同，entity 包含的字段不同。具体说明如下： OpAction 为 3（表示添加防护 IP）时，entity 包含以下字段： ips：Array 类型 \| 表示绑定到原生防护实例防护的公网 IP 资产列表。 OpAction 为 4（表示解绑防护 IP）时，entity 包含以下字段： ips：Array 类型 \| 表示从原生防护实例解除防护的公网 IP 资产列表。 OpAction 为 5（表示实例降配）时，entity 包含以下字段： baseBandwidth：Integer 类型 \| 表示基础防护带宽，单位：Gbps。 elasticBandwidth：Integer 类型 \| 表示弹性防护带宽，单位：Gbps。 opSource：Integer 类型 \| 操作来源，取值固定为 1（表示由 DDoS 原生防护服务自动执行本次操作）。 OpAction 为 6（表示解除黑洞）时，entity 包含以下字段： ips：Array 类型 \| 表示解除黑洞状态的公网 IP 资产列表。 OpAction 为 7（表示重置解除黑洞次数）时，entity 为空。 OpAction 为 8（表示实恢复弹性防护）时，entity 包含以下字段： baseBandwidth：Integer 类型 \| 表示基础防护带宽，单位：Gbps。 elasticBandwidth：Integer 类型 \| 表示弹性防护带宽，单位：Gbps。	{"entity":{"baseBandwidth":20,"elasticBandwidth":20}}

示例

正常返回示例

JSON格式

{
  "TotalCount": 1,
  "RequestId": "52C8ECB0-0B1A-4E66-A31C-B6A855120E82",
  "OpEntities": [
    {
      "EntityType": 1,
      "EntityObject": "ddosbgp-cn-n6w1r7nz****",
      "OpAction": 8,
      "GmtCreate": 1635818114000,
      "OpAccount": "171986973287****",
      "OpDesc": "{\"entity\":{\"baseBandwidth\":20,\"elasticBandwidth\":20}}"
    }
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-12-11	OpenAPI 描述信息更新	查看变更详情
2024-11-14	OpenAPI 入参发生变更	查看变更详情