1. Interface Description
Interface request domain name: cwp.api3.convergecloud.com.
This API is used to get the security event statistics.
Default interface request rate limit: 20 times per second.
Interface update time: 2022-05-20 15:12:33.
The interface is both signature verification and authentication.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: DescribeSecurityTrends |
| Version | Yes | No | String | Public parameter, The value of this interface: 2018-02-28 |
| Region | No | No | String | Public parameter,Regional information This interface does not need to pass this parameter. |
| BeginDate | Yes | No | Date | Start time, such as 2021-07-10. Example: 2021-07-10 |
| EndDate | Yes | No | Date | End time, such as 2021-07-10. Example: 2021-09-10 |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| BaseLines | Array of SecurityTrend | Statistics about baseline vulnerabilities. Example:View |
| BruteAttacks | Array of SecurityTrend | Statistics about password cracking events. Example:View |
| CyberAttacks | Array of SecurityTrend | Statistics about cyberattacks. Example:View |
| HighRiskBashs | Array of SecurityTrend | Statistics about high-risk commands. Example:View |
| MaliciousRequests | Array of SecurityTrend | Statistics about malicious requests. Example:View |
| Malwares | Array of SecurityTrend | Statistics about trojan events. Example:View |
| NonLocalLoginPlaces | Array of SecurityTrend | Statistics about logins from unusual locations. Example:View |
| PrivilegeEscalations | Array of SecurityTrend | Statistics about local privilege escalation. Example:View |
| ReverseShells | Array of SecurityTrend | Statistics about reverse shells. Example:View |
| Vuls | Array of SecurityTrend | Statistics about vulnerabilities. Example:View |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| InternalError | Internal error. |
| InvalidParameter.InvalidFormat | Incorrect parameter format. |
| MissingParameter | Missing parameter. |
| InvalidParameter.IllegalRequest | Invalid request. |
| InvalidParameter.DateRange | The time range format is incorrect. |
| InvalidParameter | Invalid parameter. |
| InvalidParameterValue | The parameter value is invalid. |