调用DescribeHoneyPotSuspStatistics接口查询安全告警数排名前5的VPC或资产信息。

调试

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

请求参数

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

需要执行的操作。

取值:DescribeHoneyPotSuspStatistics

From String honeypot

指定发起请求的来源,固定值为honeypot

StatisticsDays Integer 30

指定需要查询的数据的时间范围。单位为天。

StatisticsKeyType String vpcInstanceId

指定需要查询的资产类型。取值:

  • vpcInstanceId:VPC实例
  • uuid:服务器

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

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

返回数据

名称 类型 示例值 描述
RequestId String 9E3969FA-5ACC-4256-9FDE-BB6918CD0410

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

SuspHoneyPotStatisticsResponse Array of SuspHoneyPotStatisticsResponse

安全告警数排名前5的VPC或资产信息列表。

Count Integer 8793

当前资产上发生的安全告警总数。

InstanceId String i-p0whhoba24wd28p8****

服务器实例ID。

说明 仅请求参数StatisticsKeyType指定为uuid时,会返回该参数。
InstanceName String abc-launch-advisor

服务器名称。

说明 仅请求参数StatisticsKeyType指定为uuid时,会返回该参数。
Type String vpcInstanceId

查询的资产类型。取值:

  • vpcInstanceId:VPC实例
  • uuid:服务器
VpcId String vpc-p0wwdsuutdyu1ygkt****

VPC实例ID。

说明 仅请求参数StatisticsKeyType指定为vpcInstanceId时,会返回该参数。
VpcName String abc01

VPC实例名称。

说明 仅请求参数StatisticsKeyType指定为vpcInstanceId时,会返回该参数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeHoneyPotSuspStatistics
&From=honeypot
&StatisticsDays=30
&StatisticsKeyType=vpcInstanceId
&<公共请求参数>

正常返回示例

XML 格式

<DescribeHoneyPotSuspStatisticsResponse>
      <RequestId>9E3969FA-5ACC-4256-9FDE-BB6918CD0410</RequestId>
      <SuspHoneyPotStatisticsResponse>
            <Type>vpcInstanceId</Type>
            <VpcId>vpc-p0wwdsuutdyu1ygkt****</VpcId>
            <VpcName>abc01</VpcName>
            <Count>8793</Count>
      </SuspHoneyPotStatisticsResponse>
      <SuspHoneyPotStatisticsResponse>
            <Type>vpcInstanceId</Type>
            <VpcId>vpc-p0w7awhd40ryx4et4****</VpcId>
            <VpcName>abc02</VpcName>
            <Count>1055</Count>
      </SuspHoneyPotStatisticsResponse>
      <SuspHoneyPotStatisticsResponse>
            <Type>vpcInstanceId</Type>
            <VpcId>vpc-p0wg4tyhsy8aqowfc****</VpcId>
            <VpcName>abc03</VpcName>
            <Count>230</Count>
      </SuspHoneyPotStatisticsResponse>
      <SuspHoneyPotStatisticsResponse>
            <Type>vpcInstanceId</Type>
            <VpcId>vpc-p0wjjpui2gerjmn2w****</VpcId>
            <VpcName>abc04</VpcName>
            <Count>91</Count>
      </SuspHoneyPotStatisticsResponse>
      <SuspHoneyPotStatisticsResponse>
            <Type>vpcInstanceId</Type>
            <VpcId>vpc-p0wx2k7kcfue7zoib****</VpcId>
            <VpcName>abc05</VpcName>
            <Count>85</Count>
      </SuspHoneyPotStatisticsResponse>
</DescribeHoneyPotSuspStatisticsResponse>

JSON 格式

{

    "RequestId": "9E3969FA-5ACC-4256-9FDE-BB6918CD0410",
    "SuspHoneyPotStatisticsResponse": [{
            "Type": "vpcInstanceId",
            "VpcId": "vpc-p0wwdsuutdyu1ygkt****",
            "VpcName": "abc01",
            "Count": 8793
        },
        {
            "Type": "vpcInstanceId",
            "VpcId": "vpc-p0w7awhd40ryx4et4****",
            "VpcName": "abc02",
            "Count": 1055
        },
        {
            "Type": "vpcInstanceId",
            "VpcId": "vpc-p0wg4tyhsy8aqowfc****",
            "VpcName": "abc03",
            "Count": 230
        },
        {
            "Type": "vpcInstanceId",
            "VpcId": "vpc-p0wjjpui2gerjmn2w****",
            "VpcName": "abc04",
            "Count": 91
        },
        {
            "Type": "vpcInstanceId",
            "VpcId": "vpc-p0wx2k7kcfue7zoib****",
            "VpcName": "abc05",
            "Count": 85
        }
    ]
}

错误码

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