You can call this operation to query the security score of assets, the number of protected assets, and the number of unprotected assets.

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 DescribeSummaryInfo

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

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
AegisClientOfflineCount Integer 12

The number of unprotected assets.

AegisClientOnlineCount Integer 127

The number of protected assets.

RequestId String D40198E1-6EA8-482E-B3C7-D9573D75C0CA

The ID of the request.

SecurityScore Integer 44

The security score of assets. Valid values:

  • 95 to 100: The assets are secure.
  • 85 to 94: The assets are exposed to a few security risks. We recommend that you reinforce your security system as soon as possible.
  • 70 to 84: The assets are exposed to many security risks. We recommend that you reinforce your security system as soon as possible.
  • 69 or lower: The currenct security system is unable to protect the assets against hacker intrusions. We recommend that you reinforce your security system as soon as possible.
Success Boolean true

Indicates whether the call is successful.

Examples

Sample requests


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

Sample success responses

XML format

<DescribeSummaryInfo>
  <SecurityScore>44</SecurityScore>
  <AegisClientOnlineCount>127</AegisClientOnlineCount>
  <RequestId>D40198E1-6EA8-482E-B3C7-D9573D75C0CA</RequestId>
  <Success>true</Success>
  <AegisClientOfflineCount>12</AegisClientOfflineCount>
</DescribeSummaryInfo>

JSON format

{
	"AegisClientOnlineCount":127,
	"SecurityScore":44,
	"RequestId":"D40198E1-6EA8-482E-B3C7-D9573D75C0CA",
	"Success":true,
	"AegisClientOfflineCount":12
}

Error codes

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