Track Security Events with GetInsightsEventsCount - ActionTrail

Queries the number of Insights events for the current account.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
Date	string	No	The date to query. The format is `yyyy-MM-dd`.	2026-01-07
EndTime	string	No	The end of the time range to query. Specify the time in the ISO 8601 standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in UTC. Note If Date, StartTime, and EndTime are all left empty, the system queries the number of events in the last 24 hours. If Date is specified, the StartTime and EndTime parameters are ignored. The system queries the number of events on the specified date. If Date is left empty and both StartTime and EndTime are specified, the system queries the number of events in the specified time range.	2026-01-07T06:00:00Z
StartTime	string	No	The beginning of the time range to query. Specify the time in the ISO 8601 standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in UTC.	2025-12-01T02:00:00Z

Response elements

Element	Type	Description	Example
	object
Data	array<object>	The information about the Insights events.
	object	The information about the Insights event.
Count	integer	The number of Insights events.	3
InsightType	string	The type of the Insights event. Valid values: IpInsight: IP request events. ApiCallRateInsight: High-risk API call events. ApiErrorRateInsight: API error events. AkInsight: AccessKey pair call events. PolicyChangeInsight: Permission change events. PasswordChangeInsight: Password change events. TrailConcealmentInsight: Trail concealment events.	IpInsight
RegionId	string	The region ID.	cn-hangzhou
NextToken	string	The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the first request. You must specify the token that is obtained from the previous query as the value of `NextToken`.	VjE6bHJlTGoxdm1M****
RequestId	string	The request ID.	4ABAEA6E-C740-5CE2-A003-643E5519****

Examples

Success response

JSON format

{
  "Data": [
    {
      "Count": 3,
      "InsightType": "IpInsight",
      "RegionId": "cn-hangzhou"
    }
  ],
  "NextToken": "VjE6bHJlTGoxdm1M****",
  "RequestId": "4ABAEA6E-C740-5CE2-A003-643E5519****"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidTimeRangeException	The end time must be later than the start time. The time span cannot exceed 30 days.	The end time must be greater than the start time.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.