调用DescribeOpEntities查询DDoS高防（新BGP）的操作日志。

说明 该接口仅适用于DDoS高防（新BGP）服务。

操作日志的类型包括：设置实例弹性防护规格、执行黑洞解封、设置区域封禁、抵扣抗D包、更换ECS IP、清空全量日志等。

调试

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

请求参数

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

要执行的操作。取值：DescribeOpEntities
EndTime Long 是 1583683200000

查询结束时间。时间戳格式，单位：毫秒。

说明 查询时间的跨度不允许超过30天。
PageNumber Integer 是 1

分页查询请求时返回的页码。例如，查询第一页的返回结果，则填写1。

PageSize Integer 是 10

页面显示的记录数量。最大值：50。

StartTime Long 是 1582992000000

查询开始时间。时间戳格式，单位：毫秒。

说明 查询时间的跨度不允许超过近30天。
RegionId String 否 cn-hangzhou

DDoS高防服务地域ID。取值：cn-hangzhou，表示DDoS高防（新BGP）服务。

ResourceGroupId String 否 default

DDoS高防实例在资源管理产品中所属的资源组ID。默认为空，即属于默认资源组。
EntityType Integer 否 1

使用操作对象筛选结果，传入要查询的操作对象的类型。取值：

  • 1：DDoS高防IP
  • 2：DDoS高防抗D包
  • 3：ECS实例
  • 4：全量日志
EntityObject String 否 203.***.***.132

使用操作对象筛选结果，传入要查询的操作对象。

返回数据

名称 类型 示例值 描述
OpEntities Array

操作日志记录。
EntityObject String 203.***.***.132

操作对象。
EntityType Integer 1

操作对象的类型。取值：

  • 1：DDoS高防IP
  • 2：DDoS高防抗D包
  • 3：ECS实例
  • 4：全量日志
GmtCreate Long 1584451769000

操作时间。时间戳格式，单位：毫秒。
OpAccount String 128965410602****

执行操作的阿里云账号ID。
OpAction Integer 9

操作类型。取值：

  • 1：设置弹性防护带宽
  • 5：抵扣抗D包
  • 8：更换ECS IP
  • 9：执行黑洞解封
  • 10：设置区域封禁
  • 11：清空全量日志
  • 12：降级实例规格，表示实例到期或账号存在欠费时，降低弹性防护带宽
  • 13：恢复实例规格，表示实例续费或账号欠费结清时，恢复弹性防护带宽
OpDesc String {"newEntity":{"actionMethod":"undo"}}

操作的描述信息，使用JSON格式的字符串表述，具体结构如下。

  • newEntity：String类型，操作后的参数。
  • oldEntity：String类型，操作前的参数。

newEntity和oldEntity均使用JSON格式的字符串表述。不同操作类型（OpAtion）对应的操作参数不同。

OpAction为1、12、13时，操作参数的结构描述如下：

  • elasticBandwidth：Integer类型，弹性防护带宽值，单位：Gbps。

    示例：{"newEntity":{"elasticBandwidth":300},"oldEntity":{"elasticBandwidth":300}}

OpAction为5时，操作参数的结构描述如下：

  • bandwidth：Integer类型，弹性防护带宽，单位：Gbps。
  • count：Integer类型，抗D包数量。
  • deductCount：Integer类型，抵扣的抗D包数量。
  • expireTime：Long类型，抗D包的到期时间。时间戳格式，单位：毫秒。
  • instanceId：String类型，DDoS高防实例ID。

  • peakFlow：Integer类型，峰值流量，单位：bps。

    示例：{"newEntity":{"bandwidth":100,"count":4,"deductCount":1,"expireTime":1616299196000,"instanceId":"ddoscoo-cn-v641kpmq****","peakFlow":751427000}}

OpAction为8时，操作参数的结构描述如下：

  • instanceId：String类型，更换IP的ECS实例ID。

    示例：{"newEntity":{"instanceId":"i-wz9h6nc313zptbqn****"}}OpAction为9时，操作参数的结构描述如下：

  • actionMethod：String类型，操作方法。取值：undo，表示解除黑洞。

    示例：{"newEntity":{"actionMethod":"undo"}}OpAction为10时，操作参数的结构描述如下：

  • actionMethod：String类型，操作方法。取值：
    • do：开启封禁流量
    • undo：取消封禁流量
  • lines：Array类型，要封禁的线路类型。取值：
    • ct：电信海外

    • cut：联通海外

      示例：{"newEntity":{"actionMethod":"undo","lines":["ct"]}}

OpAction为11时，无操作参数，操作描述为空。

RequestId String FB24D70C-71F5-4000-8CD8-22CDA0C53CD1

本次请求的ID。
TotalCount Long 1

操作记录的总数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeOpEntities
&EndTime=1583683200000
&PageNumber=1
&PageSize=10
&StartTime=1582992000000
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeOpEntitiesResponse>
	  <TotalCount>1</TotalCount>
	  <RequestId>FB24D70C-71F5-4000-8CD8-22CDA0C53CD1</RequestId>
	  <OpEntities>
		    <EntityType>1</EntityType>
		    <GmtCreate>1584451769000</GmtCreate>
		    <OpAccount>128965410602****</OpAccount>
		    <OpDesc>
			      <newEntity>
				        <actionMethod>undo</actionMethod>
			      </newEntity>
		    </OpDesc>
		    <OpAction>9</OpAction>
		    <EntityObject>203.***.***.132</EntityObject>
	  </OpEntities>
</DescribeOpEntitiesResponse>

JSON 格式 

{
    "TotalCount": 1,
    "RequestId": "FB24D70C-71F5-4000-8CD8-22CDA0C53CD1",
    "OpEntities": [
        {
            "EntityType": 1,
            "GmtCreate": 1584451769000,
            "OpAccount": "128965410602****",
            "OpDesc": {
                "newEntity": {
                    "actionMethod": "undo"
                }
            },
            "OpAction": 9,
            "EntityObject": "203.***.***.132"
        }
    ]
}

错误码

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