通過LookupInsightEvents API查詢和過濾洞察事件 - Action Trail

查詢Insight事件。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱	類型	必填	描述	樣本值
NextToken	string	否	分頁遊標。用於請求下一頁檢索的結果。首次請求時置空。後續請求時傳入上一次響應返回的`NextToken`值。	VjE6dLbnNpVmbz06****
MaxResults	string	否	允許返回的最大結果數目。取值範圍：1~50（包含）。預設值：20。	20
StartTime	string	否	檢索事件的開始時間，預設為目前時間 7 天前的時間點。日期格式按照 ISO8601 標準，並使用 UTC 時間。格式為：`yyyy-MM-ddTHH:mm:ssZ`。說明若時間跨度小於 93 天，查詢範圍內的時間。跨度超過 93 天時，只查詢 93 天的內容。	2026-01-07T04:10:00Z
EndTime	string	否	檢索事件的結束時間，預設為目前時間點。日期格式按照 ISO8601 標準，並使用 UTC 時間。格式為：`yyyy-MM-ddTHH:mm:ssZ`。	2026-01-07T07:10:00Z
LookupAttribute	array<object>	否	檢索條件數組。說明一次只能指定一個或兩個檢索條件，參考限制說明。
	object	否	檢索條件。
Key	string	否	檢索條件的 Key。取值請參見：調用 LookupInsightEvents 介面檢索 Insights 事件時如何設定 LookupAttribute 參數。	InsightType
Value	string	否	檢索條件的 Value。取值請參見：調用 LookupInsightEvents 介面檢索 Insights 事件時如何設定 LookupAttribute 參數。	IpInsight

返回參數

名稱	類型	描述	樣本值
	object
Events	array<object>	Insight 事件對象列表。
	object	Insight 事件對象。	{ "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	當符合查詢條件的資料未讀取完時，服務端會返回`NextToken`，此時可以使用`NextToken`繼續讀取後面的資料。第一次查詢不需要提供這個參數。	VjE6bHJlTGoxdm1M****
RequestId	string	請求 ID。	851038F3-33AB-4C49-97D7-6AB37D35****

樣本

正常返回樣本

JSON格式

{
  "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****"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.	簽名不匹配。請檢查AcceseKey ID和AccessKey Secret是否正確；檢查簽名方法是否正確。詳細資料參見“簽名機制”。
400	InvalidParameterCombination	The end time must be later than the start time.	結束時間必須晚於開始時間。
400	InvalidQueryParameter	The specified query parameter is invalid.	無效的查詢參數。
400	InvalidParameterDateOutOfRange	Query time range exceeds 30 days.	查詢時間範圍超出30天。
400	InvalidParameterEndTime	The specified EndTime is invalid.	無效的參數EndTime。
400	InvalidParameterStartTime	The specified StartTime is invalid.	無效的參數StartTime。
400	InvalidParameterStartTimeExceedsCurrent	The StartTime exceeds the current time. Use GMT time format for queries.	開始時間超過目前時間，請使用標準GMT時間查詢。
400	InvalidParameterStartTimeOutOfDate	The StartTime exceeds the limit of 90 days.	開始時間超出90天限制。
400	InvalidTimeRangeException	The end time must be later than the start time. The time span cannot exceed 30 days.	結束時間應晚於開始時間，且時間跨度不能超過30天。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。