Tous les produits
Search
Centre de documentation

ActionTrail:Exemple d'appel avec le SDK Python

Dernière mise à jour :Aug 09, 2026

Utilisez l'opération LookupEvents via le SDK Python ActionTrail pour interroger les événements d'audit.

Étape 1 : Consulter la documentation de l'API

Consultez la référence de l'opération LookupEvents pour connaître les paramètres et les autorisations nécessaires. La liste complète des opérations figure dans la section Présentation de l'API.

Étape 2 : Créer et autoriser un utilisateur RAM

Identité

Les comptes Alibaba Cloud (comptes racine), les utilisateurs RAM et les rôles RAM peuvent effectuer cette opération. Pour plus d'informations, consultez la rubrique Identité.

Cet exemple utilise un RAM User.

Connectez-vous à la console RAM et créez un utilisateur RAM. Consultez la procédure Créer un utilisateur RAM.

Identifiants

Sur la page des détails de l'RAM User cible, cliquez sur l'onglet Authentication. Dans la section User AccessKey, cliquez sur Create AccessKey pour générer une paire de clés AccessKey. Consultez la procédure Créer une paire de clés AccessKey.

Important

Le secret AccessKey n'est affiché qu'une seule fois lors de sa création et ne peut pas être récupéré ultérieurement. Conservez-le en toute sécurité.

Autorisation

  1. Sur la page Users, repérez l'utilisateur RAM cible et cliquez sur Add Permissions dans la colonne Actions.

  2. Recherchez actiontrail et sélectionnez une stratégie en appliquant le principe du moindre privilège.

    • AliyunActionTrailFullAccess : accorde des autorisations de gestion complètes pour ActionTrail.

    • AliyunActionTrailReadOnlyAccess : accorde des autorisations en lecture seule pour ActionTrail.

    Remarque

    Si les stratégies système sont insuffisantes, créez une stratégie personnalisée. Consultez les rubriques Créer une stratégie personnalisée et Autorisation.

    Cet exemple utilise la stratégie système AliyunActionTrailReadOnlyAccess.

  3. Cliquez sur OK.

Étape 3 : Appeler l'API

Cet exemple utilise le SDK Python. Le processus est similaire pour les autres SDK. Pour télécharger les SDK, consultez la page SDK ActionTrail. Pour plus de détails sur l'utilisation, consultez la rubrique Méthodes d'appel.

Préparer l'environnement Python

  1. Téléchargez et installez Python.

    Téléchargez Python 3.

  2. Vérifiez votre version de Python.

    • Linux et macOS

      Ouvrez un terminal et exécutez la commande python --version.

    • Windows

      • Dans le répertoire d'installation de Python, double-cliquez sur python.exe.

      • Ouvrez l'Invite de commandes.

        Appuyez sur Win+R pour ouvrir la boîte de dialogue Run, saisissez python, puis cliquez sur Confirm.

Configurer les variables d'environnement

Stockez la paire de clés AccessKey dans des variables d'environnement afin d'éviter de coder en dur les identifiants. Consultez la procédure Configurer les variables d'environnement AccessKey.

Installer les dépendances

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

Télécharger l'exemple de code

  1. Dans OpenAPI Explorer, accédez à l'URL de requête de l'opération LookupEvents.

  2. L'opération LookupEvents ne nécessite aucun paramètre obligatoire. Laissez les champs vides et cliquez sur Initiate Call.

  3. Cliquez sur l'onglet SDK Sample, puis sur l'onglet Python.

    L'exemple de code Python s'affiche.

  4. Cliquez sur Download Complete Project.

  5. Extrayez le package et ouvrez le répertoire alibabacloud_sample.

Exécuter le code

Exécutez la commande suivante :

python sample.py

Exemple de sortie :

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