Domain name for API request: csip.intl.tencentcloudapi.com.
This API is used to query the host vulnerability risk event list and return basic vulnerability information, instance information, risk status, and latest scan time by risk record dimension.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: DescribeHostVulRiskEventList. |
| Version | Yes | String | Common Params. The value used for this API: 2022-11-21. |
| Region | No | String | Common Params. This parameter is not required. |
| Offset | No | Integer | Pagination offset. |
| Limit | No | Integer | Number of returned items per page. |
| Filters.N | No | Array of Filters | Filter.Name supported by Filter criteria: VulName - fuzzy matching, search by vulnerability Name. Category - exact matching, Filter by vulnerability Category: LINUX-LINUX software vulnerability, WINDOWS-WINDOWS system patch vulnerability, WEB_CMS-WEB-CMS vulnerability, APPLICATION-APPLICATION vulnerability, EMERGENCY-URGENT vulnerability. RiskStatus - exact matching, Filter by risk status: PENDING-PENDING, HANDLED-processed, FIXED-FIXED, SCANNING-rechecking, IGNORED-IGNORED, NOT_REQUIRED-no action is REQUIRED, DELETED-DELETED, FIXING-in remediation, NEED_REBOOT-FIXED PENDING restart, FIX_FAILED-FIX failure. Level - exact matching, Filter by vulnerability severity Level: UNKNOWN-unavailable, LOW-LOW risk, MEDIUM-MEDIUM risk, HIGH-HIGH risk, CRITICAL-CRITICAL. CVSSLevel - exact matching, compatible field, equivalent to Level. VPRLevel - exact matching, Filter by VPR repair priority: DEFERRABLE-DEFERRABLE repair, PLANNED-PLANNED repair, SOON-repair as SOON as possible, URGENT-URGENT repair. - exact matching, Filter by vulnerability ID. InstanceID - exact matching, Filter by CVM instance ID. InstanceID - exact matching, compatible field, equivalent to InstanceID. UUID - exact matching, Filter by host security UUID. LatestScanTimeStart - range matching, latest scan time start, format: YYYY-MM-DD HH:MM:ss. LatestScanTimeEnd - range matching, latest scan time end, format: YYYY-MM-DD HH:MM:ss |
| Order | No | String | Sorting order. |
| By | No | String | Sorting field |
| MemberId.N | No | Array of String | Group Account Member ID |
| Parameter Name | Type | Description |
|---|---|---|
| List | Array of HostVulRiskEventItem | Host vulnerability risk event list |
| TotalCount | Integer | Total number of entries that meet the criteria |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: csip.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeHostVulRiskEventList
<Common request parameters>
{
"Offset": 0,
"Limit": 10,
"MemberId": [
"mem-tencent-*********f66e429"
]
}{
"Response": {
"List": [
{
"UUID": "8f3c4c74-8cc9-4ddf-b66f-2d20f1a9a001",
"RiskID": 1000000000001,
"VulID": 12345,
"VulName": "OpenSSL remote code execution vulnerability",
"CVEID": "CVE-2024-12345",
"Category": "LINUX",
"Level": "HIGH",
"VPRLevel": "URGENT",
"CheckMethod": "POC",
"RiskStatus": "PENDING",
"SupportFix": true,
"LatestScanTime": "2026-09-18T06:00:00+08:00",
"InstanceID": "ins-5ijxpaa6",
"AppID": 1251234567
}
],
"TotalCount": 1,
"RequestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
There is no error code related to the API business logic. For other error codes, please see Common Error Codes.
피드백