ActionTrail Python SDK 呼び出し例 - LookupEvents - ActionTrail - Alibaba Cloud ドキュメントセンター

ActionTrail Python SDK を使用して LookupEvents API を呼び出し、監査イベントを検索します。

ステップ1：API ドキュメントの確認

パラメータと権限については、「LookupEvents」をご参照ください。すべての操作は、「API 概要」に記載されています。

ステップ2：RAM ユーザーの作成と承認

アイデンティティ

この操作は、Alibaba Cloud アカウント (ルートアカウント)、RAM ユーザー、および RAM ロールをサポートしています。これらの違いについては、「アイデンティティ」をご参照ください。

この例では、[RAM ユーザー]を使用します。

RAM コンソールにログインし、RAM ユーザーを作成します。詳細については、「RAM ユーザーの作成」をご参照ください。

認証情報

対象の [RAM ユーザー]の詳細ページで、認証管理 タブをクリックします。[ユーザー AccessKey] セクションで、AccessKey の作成 をクリックしてアクセスキーペアを作成します。詳細については、「アクセスキーペアの作成」をご参照ください。

重要

AccessKey シークレットは作成時にのみ表示され、後から取得することはできません。安全な場所に保管してください。

権限

[ユーザー] ページで、対象の RAM ユーザーを見つけ、操作列の 権限の追加 をクリックします。
actiontrail を検索し、最小権限の原則に基づいてポリシーを選択します。
- AliyunActionTrailFullAccess：ActionTrail の完全な管理権限を付与します。
- AliyunActionTrailReadOnlyAccess：ActionTrail の読み取り専用権限を付与します。
説明
システムポリシーで要件を満たせない場合は、カスタムポリシーを作成します。詳細については、「カスタムポリシーの作成」および「承認」をご参照ください。

この例では、AliyunActionTrailReadOnlyAccess システムポリシーを使用します。
[OK] をクリックします。

ステップ3：API の呼び出し

この例では Python SDK を使用します。他の SDK でも手順は同様です。詳細については、「ActionTrail SDK」および「メソッドの呼び出し」をご参照ください。

Python 環境の準備

Python をダウンロードしてインストールします。

Python 3 をダウンロードします。
Python のバージョンを確認します。
- Linux および macOS
  
  ターミナルを開き、python --version を実行します。
- Windows
  - Python のインストールディレクトリで、python.exe をダブルクリックします。
  - [コマンドプロンプト] を開きます。
    
    Win+R キーを押し、実行ダイアログボックスを開き、python と入力して決定をクリックします。

環境変数の設定

この例では、認証情報のハードコーディングを避けるため、AccessKey を環境変数に格納します。詳細については、「AccessKey の環境変数の設定」をご参照ください。

依存関係のインストール

pip install alibabacloud_credentials
pip install alibabacloud_actiontrail20200706==2.1.0
pip install alibabacloud_tea_console

サンプルコードのダウンロード

OpenAPI Explorer で、LookupEvents API のリクエスト URL に移動します。
LookupEvents API には必須パラメータはありません。空のままにして [呼び出しの開始] をクリックします。
[SDK サンプル] タブをクリックし、次に [Python] タブをクリックします。

タブに Python のサンプルコードが表示されます。
[完全なプロジェクトをダウンロード] をクリックします。
パッケージを展開し、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"
}