GetDataTrend - Security Center - Alibaba Cloud Documentation Center

Queries the security operations trends of the vulnerabilities, alerts, and baseline risks.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
BizTypes	string	Yes	The type of the security data that you want to query. Valid values: HC_NEW: the number of new baseline risks. HC_OPERATE: the number of handled baseline risks. VUL_NEW: the number of new vulnerabilities. VUL_OPERATE: the number of handled vulnerabilities. SUSP_NEW: the number of new alerts. SUSP_OPERATE: the number of handled alerts.	HC_NEW,HC_OPERATE
StartTimestamp	long	Yes	The beginning of the time range to query. The value is a UNIX timestamp. Unit: milliseconds.	1687334501000
EndTimestamp	long	Yes	The end of the time range to query. The value is a UNIX timestamp. Unit: milliseconds.	1721923200000
Interval	integer	Yes	The interval of the data that you want to query. Unit: milliseconds. Note The minimum value is 1000.	86400000

Response parameters

Parameter	Type	Description	Example
	object	PlainResult
Data	object	The response parameters.
DateList	array	The statistical timestamps of the trend data.
DateList	integer	The statistical timestamp of the trend data. Unit: seconds.	1721404800
DateStrList	array	The statistical dates and time for the trend data.
DateStrList	string	The statistical time and date of the trend data. Note The value is in the yyyy-MM-dd HH:mm:ss format.	2024-01-01 00:00:00
ItemList	array<object>	The returned data.
ItemList	object	The returned data.
KeyName	string	The type of the security data. Valid values: HC_NEW: the number of new baseline risks. HC_OPERATE: the number of handled baseline risks. VUL_NEW: the number of new vulnerabilities. VUL_OPERATE: the number of handled vulnerabilities. SUSP_NEW: the number of new alerts. SUSP_OPERATE: the number of handled alerts.	HC_NEW
CountList	array	The statistical values of the trend data.
CountList	long	The statistical value of the trend data.	10
RequestId	string	The request ID.	1383B0DB-D5D6-4B0C-9E6B-75939C8E****

Examples

Sample success responses

JSONformat

{
  "Data": {
    "DateList": [
      1721404800
    ],
    "DateStrList": [
      "2024-01-01 00:00:00"
    ],
    "ItemList": [
      {
        "KeyName": "HC_NEW",
        "CountList": [
          10
        ]
      }
    ]
  },
  "RequestId": "1383B0DB-D5D6-4B0C-9E6B-75939C8E****"
}

Error codes

HTTP status code	Error code	Error message	Description
400	IllegalParam	Illegal param	-
403	NoPermission	caller has no permission	You are not authorized to do this operation.
500	ServerError	ServerError	-

For a list of error codes, visit the Service error codes.