调用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类型,操作前的参数。

newEntityoldEntity均使用JSON格式的字符串表述。不同操作类型(OpAtion)对应的操作参数不同。

OpAction11213时,操作参数的结构描述如下:

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

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

OpAction5时,操作参数的结构描述如下:

  • 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}}

OpAction8时,操作参数的结构描述如下:

  • instanceId:String类型,更换IP的ECS实例ID。

    示例:{"newEntity":{"instanceId":"i-wz9h6nc313zptbqn****"}}OpAction9时,操作参数的结构描述如下:

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

    示例:{"newEntity":{"actionMethod":"undo"}}OpAction10时,操作参数的结构描述如下:

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

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

OpAction11时,无操作参数,操作描述为空。

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"
        }
    ]
}

错误码

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