调用DescribeSummaryInfo接口查询资产的安全评分、已防护资产数量和未防护资产数量。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeSummaryInfo |
需要执行的操作。 取值:DescribeSummaryInfo。 |
SourceIp | String | 否 | 1.2.3.4 |
访问源的IP地址。 |
Lang | String | 否 | zh |
请求和接收消息的语言类型。取值:
|
调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数。
调用API的请求格式,请参见本文示例中的请求示例。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
AegisClientOfflineCount | Integer | 12 |
未防护资产的数量。 |
AegisClientOnlineCount | Integer | 127 |
已防护资产的数量。 |
RequestId | String | D40198E1-6EA8-482E-B3C7-D9573D75C0CA |
阿里云为该请求生成的唯一标识符。 |
SecurityScore | Integer | 44 |
资产的安全分值。以下是分值区间和资产安全状态的对应关系:
|
Success | Boolean | true |
接口调用是否成功。取值:
|
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeSummaryInfo
&<公共请求参数>
正常返回示例
XML
格式
<DescribeSummaryInfoResponse>
<AegisClientOnlineCount>114</AegisClientOnlineCount>
<RequestId>E718E19A-4706-4ED0-9570-906724A89340</RequestId>
<AegisClientOfflineCount>73</AegisClientOfflineCount>
<SecurityScore>10</SecurityScore>
<Success>true</Success>
</DescribeSummaryInfoResponse>
JSON
格式
{
"AegisClientOnlineCount": 114,
"RequestId": "E718E19A-4706-4ED0-9570-906724A89340",
"AegisClientOfflineCount": 73,
"SecurityScore": 10,
"Success": true
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交