Queries the security information about an asset, such as the security score and the numbers of protected and 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.

SourceIp String No 1.2.3.4

The source IP address of the request.

Lang String No zh

The natural language of the request and response. Valid values:

  • zh: Chinese
  • en: English

All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.

For more information about sample requests, see the "Examples" section of this topic.

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 in a timely manner.
  • 70 to 84: The assets are exposed to multiple security risks. We recommend that you reinforce your security system in a timely manner.
  • 69 or lower: The current security system is unable to protect the assets against intrusions. We recommend that you reinforce your security system in a timely manner.
Success Boolean true

Indicates whether the request is successful. Valid values:

  • true: successful
  • false: failed

Examples

Sample requests

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

Sample success responses

XML format

<DescribeSummaryInfoResponse>
      <AegisClientOnlineCount>114</AegisClientOnlineCount>
      <RequestId>E718E19A-4706-4ED0-9570-906724A89340</RequestId>
      <AegisClientOfflineCount>73</AegisClientOfflineCount>
      <SecurityScore>10</SecurityScore>
      <Success>true</Success>
</DescribeSummaryInfoResponse>

JSON format

{
	"AegisClientOnlineCount": 114,
	"RequestId": "E718E19A-4706-4ED0-9570-906724A89340",
	"AegisClientOfflineCount": 73,
	"SecurityScore": 10,
	"Success": true
}

Error codes

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