調用LookupEvents介面檢索歷史事件。
使用LookupEvents檢索歷史事件時,每秒鐘最多調用兩次。
注意:請勿頻繁調用該介面。您可以建立跟蹤,將事件投遞到Log ServiceSLS,通過SLS的即時消費功能來近即時地檢索歷史事件。
說明 該介面(2017-12-04版本API LookupEvents介面)即將下線,推薦您使用2020-07-06版本API。更多資訊,請參見LookupEvents。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
| Action | String | 是 | LookupEvents | 要執行的操作,取值:LookupEvents。 |
| Event | String | 否 | AD9CD9DA-EC2D-4EB7-A817-C0442A94**** | 事件ID。 |
| Request | String | 否 | AD9CD9DA-EC2D-4EB7-A817-C0442A94**** | 請求ID。 |
| EventType | String | 否 | ConsoleSignin | 事件類型,取值:
|
| ServiceName | String | 否 | AsaSub | 雲端服務名稱。 |
| EventName | String | 否 | ConsoleSignin | 事件名稱。 |
| User | String | 否 | yanjie.wyj | 調用者名稱,即RAM使用者。 |
| ResourceType | String | 否 | Instance | 資源類型。 |
| ResourceName | String | 否 | i-bp14664y88udkt45**** | 資源名稱。 |
| EventRW | String | 否 | Write | 請求事件的讀寫類型,取值:
|
| EventAccessKeyId | String | 否 | LTAI4FoDkCf4DU1bic1V**** | 要檢索事件的AccessKey ID。 |
| NextToken | String | 否 | 20 | 用於請求下一頁檢索的結果。 說明 請求參數必須保證和上次請求一致。 |
| MaxResults | String | 否 | 20 | 允許返回的最大結果數目。 取值範圍:0~50個。 |
| StartTime | String | 否 | 2020-06-15T14:00:00Z | 檢索事件的開始時間,預設為目前時間7天前的時間點。日期格式按照ISO8601標準,並使用UTC時間。格式為: 說明 支援最長90天內,跨度不超過30天的事件檢索。 |
| EndTime | String | 否 | 2020-06-22T14:00:00Z | 檢索事件的結束時間,預設為目前時間點。日期格式按照ISO8601標準,並使用UTC時間。格式為: 說明 支援最長90天內,跨度不超過30天的事件檢索。 |
Event內的子欄位說明,請參見操作事件結構定義。
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| EndTime | String | 2020-07-22T14:00:00Z | 檢索到事件的結束時間。 |
| NextToken | String | 1 | 返回下一頁的檢索結果。 說明 若無更多結果,則不返回此欄位。 |
| RequestId | String | FD79665A-CE8B-49D4-82E6-5EE2E0E791DD | 請求ID。 |
| Events | Array of Object | AD9CD9DA-EC2D-4EB7-A817-C0442A94**** | 檢索到的事件列表。 |
| StartTime | String | 2020-07-15T14:00:00Z | 檢索到事件的開始時間。 |
樣本
請求樣本
http(s)://[Endpoint]/?Action=LookupEvents
&<公用請求參數>
正常返回樣本
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<LookupEventsResponse>
<RequestId>AB6843AF-C07E-4B59-BBF8-A0CEB785E6A2</RequestId>
<NextToken>2</NextToken>
<EndTime>2020-11-26T01:30:39Z</EndTime>
<Events>
<eventId>96.227_1606286128938_****</eventId>
<eventVersion>1</eventVersion>
<errorMessage>success</errorMessage>
<eventSource>signin.aliyun.com</eventSource>
<sourceIpAddress>42.120.XX.XX</sourceIpAddress>
<userAgent>Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.86 Safari/537.36</userAgent>
<eventType>ConsoleSignin</eventType>
<userIdentity>
<accountId>159498693826****</accountId>
<principalId>24611178745315****</principalId>
<type>ram-user</type>
<userName>alice</userName>
</userIdentity>
<serviceName>AasSub</serviceName>
<additionalEventData>
<callbackUrl>https://api.aliyun.com/new?spm=a2c1g.8271268.10000.9.2d59df259iBwq1</callbackUrl>
<mfaChecked>false</mfaChecked>
</additionalEventData>
<requestId>96.227_1606286128938_2847</requestId>
<eventTime>2020-11-25T06:35:29Z</eventTime>
<acsRegion>cn-hangzhou</acsRegion>
<eventName>ConsoleSignin</eventName>
</Events>
<Events>
<eventId>132.20_1606132532480_****</eventId>
<eventVersion>1</eventVersion>
<errorMessage>success</errorMessage>
<eventSource>signin.aliyun.com</eventSource>
<sourceIpAddress>42.120.XX.XX</sourceIpAddress>
<userAgent>Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.75 Safari/537.36</userAgent>
<eventType>ConsoleSignin</eventType>
<userIdentity>
<accountId>159498693826****</accountId>
<principalId>26855899827085****</principalId>
<type>ram-user</type>
<userName>yuge.****</userName>
</userIdentity>
<serviceName>AasSub</serviceName>
<additionalEventData>
<callbackUrl>https://home.console.alibabacloud.com/</callbackUrl>
<mfaChecked>false</mfaChecked>
</additionalEventData>
<requestId>132.20_1606132532480_7292</requestId>
<eventTime>2020-11-23T11:55:32Z</eventTime>
<acsRegion>cn-hangzhou</acsRegion>
<eventName>ConsoleSignin</eventName>
</Events>
<StartTime>2020-11-19T01:31:09Z</StartTime>
</LookupEventsResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "AB6843AF-C07E-4B59-BBF8-A0CEB785E6A2",
"NextToken" : "2",
"EndTime" : "2020-11-26T01:30:39Z",
"Events" : [ {
"eventId" : "96.227_1606286128938_****",
"eventVersion" : "1",
"errorMessage" : "success",
"eventSource" : "signin.aliyun.com",
"sourceIpAddress" : "42.120.XX.XX",
"userAgent" : "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.86 Safari/537.36",
"eventType" : "ConsoleSignin",
"userIdentity" : {
"accountId" : "159498693826****",
"principalId" : "24611178745315****",
"type" : "ram-user",
"userName" : "alice"
},
"serviceName" : "AasSub",
"additionalEventData" : {
"callbackUrl" : "https://api.aliyun.com/new?spm=a2c1g.8271268.10000.9.2d59df259iBwq1",
"mfaChecked" : "false"
},
"requestId" : "96.227_1606286128938_2847",
"eventTime" : "2020-11-25T06:35:29Z",
"acsRegion" : "cn-hangzhou",
"eventName" : "ConsoleSignin"
}, {
"eventId" : "132.20_1606132532480_****",
"eventVersion" : "1",
"errorMessage" : "success",
"eventSource" : "signin.aliyun.com",
"sourceIpAddress" : "42.120.XX.XX",
"userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.75 Safari/537.36",
"eventType" : "ConsoleSignin",
"userIdentity" : {
"accountId" : "159498693826****",
"principalId" : "26855899827085****",
"type" : "ram-user",
"userName" : "yuge.****"
},
"serviceName" : "AasSub",
"additionalEventData" : {
"callbackUrl" : "https://home.console.alibabacloud.com/",
"mfaChecked" : "false"
},
"requestId" : "132.20_1606132532480_7292",
"eventTime" : "2020-11-23T11:55:32Z",
"acsRegion" : "cn-hangzhou",
"eventName" : "ConsoleSignin"
} ],
"StartTime" : "2020-11-19T01:31:09Z"
}
錯誤碼
| HttpCode | 錯誤碼 | 錯誤資訊 | 描述 |
| 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天。 |
訪問錯誤中心查看更多錯誤碼。