GetInsightsEventsCount-阿里云帮助中心

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. The date format follows the ISO 8601 standard and uses UTC. The format is `yyyy-MM-ddTHH:mm:ssZ`. Note If Date, StartTime, and EndTime are all 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 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. The date format follows the ISO 8601 standard and uses UTC. The format is `yyyy-MM-ddTHH:mm:ssZ`.	2025-12-01T02:00:00Z

Response elements

Element	Type	Description	Example
	object
Data	array<object>	The list of returned data.
	object	The returned data object.
Count	integer	The number of 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 call events. PolicyChangeInsight: Permission change events. PasswordChangeInsight: Password change events. TrailConcealmentInsight: Trail concealment events.	IpInsight
RegionId	string	The region ID.	cn-hangzhou
NextToken	string	If the results are not fully returned, the server provides a `NextToken`. Use this token to retrieve the next page of results. Do not provide this parameter for the first query.	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 for a complete list.

Release notes

See Release Notes for a complete list.