本文以Python SDK為例,為您介紹如何通過操作審計OpenAPI調用LookupEvents接口查詢操作審計事件的詳情。
步驟一:查看OpenAPI文檔
在調用OpenAPI前,建議您先閱讀對應的接口文檔LookupEvents,了解調用該接口所需要的參數和權限,更多信息請參見API概覽。
步驟二:創建RAM用戶并完成授權
身份
您可以使用阿里云賬號(主賬號)、RAM用戶、RAM角色調用該接口。關于各種身份的差異,請參見身份。
本示例中,使用RAM用戶調用接口。
憑證
進入到對應的RAM用戶詳情頁,在認證管理頁簽下的用戶AccessKey區域,單擊創建AccessKey,創建一個新的AccessKey。具體操作,請參見創建AccessKey。
RAM用戶的AccessKey Secret只在創建時顯示,不支持查看,請注意保存。
授權
訪問RAM用戶列表,單擊目標RAM用戶操作列的添加權限。
在文本框中輸入關鍵字
actiontrail
進行搜索,根據最小授權原則,選擇對應權限策略。AliyunActionTrailFullAccess:管理操作審計(ActionTrail)的權限。
AliyunActionTrailReadOnlyAccess:只讀訪問操作審計(ActionTrail)的權限。
本文示例選擇AliyunActionTrailReadOnlyAccess系統策略。
單擊確認新增授權,完成授權操作。
步驟三:調用OpenAPI
本文以Python SDK調用OpenAPI,其他語言SDK的用法類似。更多信息,請參見操作審計SDK。您也可根據業務的實際需要選擇其他調用方式,更多調用方法請參見調用方式。
準備Python環境
下載并安裝Python。
Python 3的下載地址,請參見Python 3。
查看Python版本。
Linux和macOS系統
打開終端,輸入
python --version
。Windows系統
在Python的安裝路徑下,雙擊python.exe。
打開命令提示符頁面。
通過鍵盤快捷鍵Win+R打開運行對話框,輸入命令python,單擊確定。
配置環境變量
為避免將AccessKey硬編碼到業務代碼中帶來的安全風險,本示例采用配置環境變量的方法管理AccessKey。關于環境變量的詳細配置,請參見配置AccessKey環境變量。
安裝依賴
pip install alibabacloud_credentials
pip install alibabacloud_actiontrail20200706==2.1.0
pip install alibabacloud_tea_console
下載示例代碼
在OpenAPI門戶,訪問LookupEvents接口的調試地址。
LookupEvents接口無必填參數,可以不填寫,直接單擊發起調用。
先單擊SDK示例頁簽,再單擊Python頁簽。
獲取Python語言的SDK示例。
單擊下載完整工程,下載示例代碼包。
在本地解壓進入alibabacloud_sample目錄。
運行代碼
執行以下命令:
python sample.py
得到如下輸出結果:
{
"EndTime": "2023-07-11T08:13:04Z",
"NextToken": "eyJhY2NvdW50IjoiMTY5ODI3MjMyODU0ODQ2NyIsImV2ZW50SWQiOiJFNTdGNjFGRS04RjdCLTVDRjAtODA3Ni03NjAwNEQyMkMxQTYiLCJsb2dJZCI6IjQ1LTE2OTgyNzIzMjg1NDg0NjciLCJ0aW1lIjoxNjg5MDYzMTE2MD****",
"RequestId": "7743F214-925E-5602-936C-3CCCD5FBACD8",
"Events": [
{
"eventId": "33859C72-1C50-55B3-A857-27FAA358****",
"eventVersion": 1,
"eventSource": "actiontrail.cn-hangzhou.aliyuncs.com",
"requestParameters": {
"AcsProduct": "Actiontrail",
"UserAgent": "Workbench/1.0",
"ClientPort": 11880,
"Region": "cn-hangzhou"
},
"sourceIpAddress": "192.168.XX.XX",
"userAgent": "api.aliyun.com",
"eventRW": "Read",
"eventType": "ApiCall",
"userIdentity": {
"sessionContext": {
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2023-07-11T08:12:34Z"
}
},
"accountId": "169827232854****",
"principalId": "169827232854****",
"type": "root-account",
"userName": "root"
},
"serviceName": "Actiontrail",
"additionalEventData": {
"CallerBid": "2****"
},
"apiVersion": "2020-07-06",
"requestId": "33859C72-1C50-55B3-A857-27FAA358641C",
"eventTime": "2023-07-11T08:12:34Z",
"isGlobal": false,
"acsRegion": "cn-hangzhou",
"eventName": "LookupEvents"
}
],
"StartTime": "2023-07-04T08:13:34Z"
}