Kueri & Filter Insight Event dengan LookupInsightEvents API - ActionTrail - Alibaba Cloud - ActionTrail

Mengkueri peristiwa Insights.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
NextToken	string	No	Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda tidak perlu menentukan parameter ini untuk permintaan pertama. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai `NextToken`.	VjE6dLbnNpVmbz06****
MaxResults	string	No	Jumlah maksimum entri yang akan dikembalikan. Nilai yang valid: 1 hingga 50. Nilai default: 20.	20
StartTime	string	No	Awal rentang waktu untuk dikueri. Nilai default adalah tujuh hari sebelum waktu saat ini. Tentukan waktu dalam standar ISO 8601 dengan format `yyyy-MM-ddTHH:mm:ssZ`. Waktu harus dalam UTC. Catatan Rentang waktu maksimum yang dapat dikueri adalah 93 hari. Jika rentang waktu yang ditentukan lebih dari 93 hari, hanya peristiwa dari 93 hari terakhir yang dikembalikan.	2026-01-07T04:10:00Z
EndTime	string	No	Akhir rentang waktu untuk dikueri. Nilai default adalah waktu saat ini. Tentukan waktu dalam standar ISO 8601 dengan format `yyyy-MM-ddTHH:mm:ssZ`. Waktu harus dalam UTC.	2026-01-07T07:10:00Z
LookupAttribute	array<object>	No	Array kondisi filter. Catatan Anda dapat menentukan satu atau dua kondisi kueri. Untuk informasi lebih lanjut, lihat Batasan.
	object	No	Sebuah kondisi filter.
Key	string	No	Kunci atribut. Untuk informasi lebih lanjut tentang nilai yang valid, lihat Bagaimana cara mengonfigurasi parameter LookupAttribute saat memanggil LookupInsightEvents?	InsightType
Value	string	No	Nilai atribut. Untuk informasi lebih lanjut tentang nilai yang valid, lihat Bagaimana cara mengonfigurasi parameter LookupAttribute saat memanggil LookupInsightEvents?	IpInsight

Elemen respons

Element	Type	Description	Example
	object
Events	array<object>	Peristiwa Insights.
	object	Peristiwa 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	Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda tidak perlu menentukan parameter ini untuk permintaan pertama. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai `NextToken`.	VjE6bHJlTGoxdm1M****
RequestId	string	ID permintaan.	851038F3-33AB-4C49-97D7-6AB37D35****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.
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.
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.