调用DescribeInstanceStatistics接口查询资产的风险统计信息。

调试

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

请求参数

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

要执行的操作。取值:DescribeInstanceStatistics

SourceIp String 1.2.XX.XX

访问源的IP地址。

Lang String zh

设置请求和接收消息的语言类型,默认为zh。取值:

  • zh:中文
  • en:英文
Uuid String 6690a46c-0edb-4663-a641-3629d1a9****

要查询的资产的UUID列表。多个UUID之间使用半角逗号(,)分隔。

您可以调用DescribeCloudCenterInstances接口获取资产实例的UUID。

From String sas

数据的请求来源。固定为sas,表示数据请求来源为云安全中心。

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

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

返回数据

名称 类型 示例值 描述
RequestId String 8F035A9D-D19F-5430-8CA5-1497991B7C61

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

Data Array of Data

资产风险的统计信息。

Account Integer 0

资产账号异常登录的数量。

AppNum Integer 1

资产中存在的应用漏洞的数量。

ScaNum Integer 1

资产中存在的中间件漏洞的数量。

Trojan Integer 1

资产中存在的木马的数量。

CveNum Integer 1

资产中存在的通用漏洞的数量。

EmgNum Integer 6

资产中存在的应急漏洞的数量。

Suspicious Integer 2

资产中存在的安全告警的数量。

CmsNum Integer 5

资产中存在的Web-CMS漏洞的数量。

Uuid String 6690a46c-0edb-4663-a641-3629d1a9****

资产实例的UUID。

Vul Integer 17

资产中存在的所有漏洞的总数量。

Health Integer 2

资产中存在的基线风险问题的数量。

SysNum Integer 3

资产中存在的Windows系统漏洞的数量。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeInstanceStatistics
&SourceIp=1.2.XX.XX
&Lang=zh
&Uuid=6690a46c-0edb-4663-a641-3629d1a9****
&From=sas
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeInstanceStatisticsResponse>
    <RequestId>8F035A9D-D19F-5430-8CA5-1497991B7C61</RequestId>
    <Data>
        <Account>0</Account>
        <AppNum>1</AppNum>
        <ScaNum>1</ScaNum>
        <Trojan>1</Trojan>
        <CveNum>1</CveNum>
        <EmgNum>6</EmgNum>
        <Suspicious>2</Suspicious>
        <CmsNum>5</CmsNum>
        <Uuid>6690a46c-0edb-4663-a641-3629d1a9****</Uuid>
        <Vul>17</Vul>
        <Health>2</Health>
        <SysNum>3</SysNum>
    </Data>
</DescribeInstanceStatisticsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "8F035A9D-D19F-5430-8CA5-1497991B7C61",
  "Data" : [ {
    "Account" : 0,
    "AppNum" : 1,
    "ScaNum" : 1,
    "Trojan" : 1,
    "CveNum" : 1,
    "EmgNum" : 6,
    "Suspicious" : 2,
    "CmsNum" : 5,
    "Uuid" : "6690a46c-0edb-4663-a641-3629d1a9****",
    "Vul" : 17,
    "Health" : 2,
    "SysNum" : 3
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission no permission 无此服务的访问权限。
500 ServerError ServerError 服务故障

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