Python SDK調用樣本 - ActionTrail

本文以Python SDK為例，為您介紹如何通過Action TrailOpenAPI調用LookupEvents介面查詢Action Trail事件的詳情。

步驟一：查看OpenAPI文檔

在調用OpenAPI前，建議您先閱讀對應的介面文檔LookupEvents，瞭解調用該介面所需要的參數和許可權，更多資訊請參見API概覽。

步驟二：建立RAM使用者並完成授權

身份

您可以使用阿里雲帳號（主帳號）、RAM使用者、RAM角色調用該介面。關於各種身份的差異，請參見身份。

本樣本中，使用RAM使用者調用介面。

登入RAM存取控制，建立一個RAM使用者。具體操作，請參見建立RAM使用者。

憑證

進入到對應的RAM使用者詳情頁，在認證管理頁簽下的使用者AccessKey地區，單擊建立AccessKey，建立一個新的AccessKey。具體操作，請參見建立AccessKey。

重要

RAM使用者的AccessKey Secret只在建立時顯示，不支援查看，請注意儲存。

授權

訪問RAM使用者列表，單擊目標RAM使用者操作列的添加許可權。
在文字框中輸入關鍵字actiontrail進行搜尋，根據最小授權原則，選擇對應權限原則。
- AliyunActionTrailFullAccess：管理Action Trail（ActionTrail）的許可權。
- AliyunActionTrailReadOnlyAccess：唯讀訪問Action Trail（ActionTrail）的許可權。
說明
如果系統策略不能滿足您的需求，您可以建立自訂策略。更多資訊，請參見建立自訂權限原則和授權資訊。
本文樣本選擇AliyunActionTrailReadOnlyAccess系統策略。
單擊確認新增授權，完成授權操作。

步驟三：調用OpenAPI

本文以Python SDK調用OpenAPI，其他語言SDK的用法類似。更多資訊，請參見Action TrailSDK。您也可根據業務的實際需要選擇其他調用方式，更多調用方法請參見調用方式。

準備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"
}