LookupInsightEvents - ActionTrail - Centro de documentación de Alibaba Cloud

Consulta eventos de Insights.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
NextToken	string	No	El token de paginación que se utiliza en la siguiente solicitud para recuperar una nueva página de resultados. No necesita especificar este parámetro en la primera solicitud. Debe especificar el token obtenido de la consulta anterior como valor de `NextToken`.	VjE6dLbnNpVmbz06****
MaxResults	string	No	El número máximo de entradas a devolver. Valores válidos: 1 a 50. Valor predeterminado: 20.	20
StartTime	string	No	El inicio del intervalo de tiempo a consultar. El valor predeterminado es siete días antes de la hora actual. Especifique la hora en formato ISO 8601 con el patrón `yyyy-MM-ddTHH:mm:ssZ`. La hora debe estar en UTC. Nota El intervalo de tiempo máximo que se puede consultar es de 93 días. Si el intervalo de tiempo especificado supera los 93 días, solo se devuelven los eventos de los últimos 93 días.	2026-01-07T04:10:00Z
EndTime	string	No	El fin del intervalo de tiempo a consultar. El valor predeterminado es la hora actual. Especifique la hora en formato ISO 8601 con el patrón `yyyy-MM-ddTHH:mm:ssZ`. La hora debe estar en UTC.	2026-01-07T07:10:00Z
LookupAttribute	array<object>	No	Una matriz de condiciones de filtro. Nota Puede especificar una o dos condiciones de consulta. Para obtener más información, consulte Limitaciones.
	object	No	Una condición de filtro.
Key	string	No	La clave del atributo. Para obtener más información sobre los valores válidos, consulte ¿Cómo configuro el parámetro LookupAttribute al llamar a LookupInsightEvents?	InsightType
Value	string	No	El valor del atributo. Para obtener más información sobre los valores válidos, consulte ¿Cómo configuro el parámetro LookupAttribute al llamar a LookupInsightEvents?	IpInsight

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
Events	array<object>	Los eventos de Insights.
	object	El evento de Insights.	{ "eventId": "408ACD94-4531-4D66-BA14-1F7248AC**", "eventCategory": "Insight", "sharedEventId": "55CF0739-97D8-4221-A6BE-8E60E746", "eventVersion": "1", "eventTime": "2026-01-07T05:40:00Z", "insightDetails": { "insightContext": { "attributions": [ { "insight": [ { "average": 3, "value": "AlibabaCloud API Workbench" } ], "attribute": "userAgent" }, { "insight": [ { "average": 3, "value": "20376656170607**" } ], "attribute": "principalId" }, { "insight": [ { "average": 3, "value": "Actiontrail/EnableInsight" } ], "attribute": "apiRelated" }, { "insight": [ { "average": 3, "value": "null" } ], "attribute": "errorCode" } ], "statistics": { "insight": { "average": 3, "predict": 0 }, "insightDuration": 1, "baseline": { "threshold": 0.6 }, "insightCount": 3 } }, "state": "Start", "insightType": "IpInsight", "insightObject": "xxx.xxx.xxx.xxx" }, "acsRegion": "cn-qingdao", "eventType": "ActionTrailInsight" }
NextToken	string	El token de paginación que se utiliza en la siguiente solicitud para recuperar una nueva página de resultados. No necesita especificar este parámetro en la primera solicitud. Debe especificar el token obtenido de la consulta anterior como valor de `NextToken`.	VjE6bHJlTGoxdm1M****
RequestId	string	El ID de la solicitud.	851038F3-33AB-4C49-97D7-6AB37D35****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Events": [
    {
      "eventId": "408ACD94-4531-4D66-BA14-1F7248AC****",
      "eventCategory": "Insight",
      "sharedEventId": "55CF0739-97D8-4221-A6BE-8E60E746****",
      "eventVersion": "1",
      "eventTime": "2026-01-07T05:40:00Z",
      "insightDetails": {
        "insightContext": {
          "attributions": [
            {
              "insight": [
                {
                  "average": 3,
                  "value": "AlibabaCloud API Workbench"
                }
              ],
              "attribute": "userAgent"
            },
            {
              "insight": [
                {
                  "average": 3,
                  "value": "20376656170607****"
                }
              ],
              "attribute": "principalId"
            },
            {
              "insight": [
                {
                  "average": 3,
                  "value": "Actiontrail/EnableInsight"
                }
              ],
              "attribute": "apiRelated"
            },
            {
              "insight": [
                {
                  "average": 3,
                  "value": "null"
                }
              ],
              "attribute": "errorCode"
            }
          ],
          "statistics": {
            "insight": {
              "average": 3,
              "predict": 0
            },
            "insightDuration": 1,
            "baseline": {
              "threshold": 0.6
            },
            "insightCount": 3
          }
        },
        "state": "Start",
        "insightType": "IpInsight",
        "insightObject": "xxx.xxx.xxx.xxx"
      },
      "acsRegion": "cn-qingdao",
      "eventType": "ActionTrailInsight"
    }
  ],
  "NextToken": "VjE6bHJlTGoxdm1M****",
  "RequestId": "851038F3-33AB-4C49-97D7-6AB37D35****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.	The request signature does not conform to Alibaba Cloud standards.
400	InvalidParameterCombination	The end time must be later than the start time.	The end time must be greater than the start time.
400	InvalidQueryParameter	The specified query parameter is invalid.	The specified query parameter is not valid.
400	InvalidParameterDateOutOfRange	Query time range exceeds 30 days.
400	InvalidParameterEndTime	The specified EndTime is invalid.
400	InvalidParameterStartTime	The specified StartTime is invalid.
400	InvalidParameterStartTimeExceedsCurrent	The StartTime exceeds the current time. Use GMT time format for queries.
400	InvalidParameterStartTimeOutOfDate	The StartTime exceeds the limit of 90 days.
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.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.