You can call this operation to query risk information about an asset.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeInstanceStatistics

The operation that you want to perform. Set the value to DescribeInstanceStatistics.

From String Yes sas

The source of the data. Set the value to sas.

Uuid String Yes ["a51cec37-ed73-4c53-b467-***"]

The IDs of the assets. Assets IDs are unique. Separate multiple IDs with commas (,).

Note To query the risk information about an asset, you must provide the ID of the asset. You can call the DescribeCloudCenterInstances operation to query the asset ID.
Lang String No zh

The language of the request and response. Valid values:

  • zh: Chinese
  • en: English
SourceIp String No 1.2.3.4

The source IP address of the request.

Response parameters

Parameter Type Example Description
Data Array

The risk information about the asset.

Account Integer 1

The type of the asset group.

  • 0: default group
  • 1: other groups
AppNum Integer 0

The number of application vulnerabilities.

CmsNum Integer 2

The number of web CMS vulnerabilities.

CveNum Integer 1

The number of Linux software vulnerabilities.

EmgNum Integer 0

The number of emergent vulnerabilities.

Health Integer 1

The number of issues detected by the baseline check.

Suspicious Integer 2

The number of alerts.

SysNum Integer 1

The number of Windows OS vulnerabilities.

Trojan Integer 1

The number of Trojans.

Uuid String  us1233******

The ID of the asset. Asset IDs are unique.

Vul Integer 4

The total number of vulnerabilities: CveNum + EmgNum + SysNum + CmsNum + AppNum

RequestId String 7E0618A9-D5EF-4220-9471-C42B5E92719F

The ID of the request.

Examples

Sample requests


http(s)://[Endpoint]/? Action=DescribeInstanceStatistics
&<Common request parameters>

Sample success responses

XML format

<DescribeInstanceStatistics>
  <Data>
        <SysNum>1</SysNum>
        <Uuid>a51cec37-ed73-4c53-b467-***</Uuid>
        <CveNum>1</CveNum>
        <Suspicious>1</Suspicious>
        <Trojan>0</Trojan>
        <Account>0</Account>
        <CmsNum>1</CmsNum>
        <EmgNum>1</EmgNum>
        <Health>0</Health>
        <AppNum>1</AppNum>
        <Vul>5</Vul>
  </Data>
  <Data>
        <SysNum>2</SysNum>
        <Uuid>33f107a3-4653-4228-a428-***</Uuid>
        <CveNum>1</CveNum>
        <Suspicious>2</Suspicious>
        <Trojan>0</Trojan>
        <Account>0</Account>
        <CmsNum>1</CmsNum>
        <EmgNum>2</EmgNum>
        <Health>0</Health>
        <AppNum>1</AppNum>
        <Vul>7</Vul>
  </Data>
  <RequestId>44AE72D4-2DDF-4CEC-9957-64C470CC90FC</RequestId>
</DescribeInstanceStatistics>

JSON format

{
	"Data":[
		{
			"Uuid":"a51cec37-ed73-4c53-b467-***",
			"SysNum":1,
			"CveNum":1,
			"Trojan":0,
			"Suspicious":1,
			"Account":0,
			"CmsNum":1,
			"Health":0,
			"EmgNum":1,
			"AppNum":1,
			"Vul":5
		},
		{
			"Uuid":"33f107a3-4653-4228-a428-***",
			"SysNum":2,
			"CveNum":1,
			"Trojan":0,
			"Suspicious":2,
			"Account":0,
			"CmsNum":1,
			"Health":0,
			"EmgNum":2,
			"AppNum":1,
			"Vul":7
		}
	],
	"RequestId":"44AE72D4-2DDF-4CEC-9957-64C470CC90FC"
}

Error codes

For a list of error codes, visit the API Error Center.