LookupInsightEventsCount API によるインサイトイベントのクエリとフィルタリング - ActionTrail

Insight イベントをクエリします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
NextToken	string	任意	ページングに使用されるトークンです。最初のリクエストでは、このパラメーターを空のままにします。後続のリクエストでは、このパラメーターを前の応答から返された `NextToken` の値に設定して、結果の次のページを取得します。	VjE6dLbnNpVmbz06****
MaxResults	string	任意	返す結果の最大数です。有効な値：1～50。デフォルト値：20。	20
StartTime	string	任意	クエリする時間範囲の開始時刻です。デフォルト値は、現在の時刻の 7 日前です。時刻は UTC で、`yyyy-MM-ddTHH:mm:ssZ` 形式である必要があります。説明クエリできる最大時間範囲は 93 日間です。指定された時間範囲が 93 日間を超える場合、過去 93 日間のイベントのみが返されます。	2026-01-07T04:10:00Z
EndTime	string	任意	クエリする時間範囲の終了時刻です。デフォルト値は現在の時刻です。時刻は UTC で、`yyyy-MM-ddTHH:mm:ssZ` 形式である必要があります。	2026-01-07T07:10:00Z
LookupAttribute	array<object>	任意	クエリ条件の配列です。説明 1 つまたは 2 つのクエリ条件を指定できます。詳細については、「制限事項」をご参照ください。
	object	任意	クエリ条件です。
Key	string	任意	クエリ条件のキーです。有効な値の詳細については、「LookupAttribute パラメーターを設定して Insight イベントをクエリする」をご参照ください。	InsightType
Value	string	任意	クエリ条件の値です。有効な値の詳細については、「LookupAttribute パラメーターを設定して Insight イベントをクエリする」をご参照ください。	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` が返されます。このトークンを後続の呼び出しで使用して、結果の次のページを取得します。	VjE6bHJlTGoxdm1M****
RequestId	string	リクエスト ID です。	851038F3-33AB-4C49-97D7-6AB37D35****

例

成功レスポンス

JSONJSON

{
  "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 ステータスコード	エラーコード	エラーメッセージ	説明
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。