Todos os produtos
Search
Central de documentação

ActionTrail:Exemplo de chamada do SDK Python

Última atualização: Jul 20, 2026

Use o SDK Python do ActionTrail para chamar a operação LookupEvents e consultar eventos de auditoria.

Etapa 1: Consultar a documentação da API

Consulte a referência da operação LookupEvents para verificar parâmetros e permissões. Todas as operações estão listadas na API overview.

Etapa 2: Criar e autorizar um usuário RAM

Identidade

Esta operação é compatível com contas Alibaba Cloud (contas raiz), usuários RAM e funções RAM. Para mais detalhes, consulte Identity.

Este exemplo usa um RAM User.

Acesse o console RAM e crie um usuário RAM. Consulte Create a RAM user.

Credencial

Na página de detalhes do RAM User desejado, clique em Authentication. Na seção User AccessKey, clique em Create AccessKey para gerar um par de AccessKey. Consulte Create an AccessKey pair.

Importante

O AccessKey secret é exibido apenas uma vez durante a criação e não pode ser recuperado posteriormente. Armazene-o com segurança.

Permissão

  1. Na página Users, localize o usuário RAM de destino e clique em Add Permissions na coluna Actions.

  2. Pesquise por actiontrail e selecione uma política com base no princípio de menor privilégio.

    • AliyunActionTrailFullAccess: concede permissões totais de gerenciamento do ActionTrail.

    • AliyunActionTrailReadOnlyAccess: concede permissões somente leitura para o ActionTrail.

    Nota

    Se as políticas do sistema forem insuficientes, crie uma política personalizada. Consulte Create a custom policy e Authorization.

    Este exemplo usa a política de sistema AliyunActionTrailReadOnlyAccess.

  3. Clique em OK.

Etapa 3: Chamar a API

Este exemplo usa o SDK Python. Outros SDKs seguem um processo semelhante. Para baixar os SDKs, consulte SDK do ActionTrail. Para obter detalhes de uso, consulte Call methods.

Preparar o ambiente Python

  1. Baixe e instale o Python.

    Baixe o Python 3.

  2. Verifique a versão do Python instalada.

    • Linux e macOS

      Abra um terminal e execute python --version.

    • Windows

      • No diretório de instalação do Python, clique duas vezes em python.exe.

      • Abra o Prompt de Comando.

        Pressione Win+R para abrir a caixa de diálogo Run, insira python e clique em Confirm.

Configurar variáveis de ambiente

Armazene o par de AccessKey em variáveis de ambiente para evitar codificar credenciais diretamente no código. Consulte Configure AccessKey environment variables.

Instalar dependências

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

Baixar o código de exemplo

  1. No OpenAPI Explorer, acesse a URL de solicitação da operação LookupEvents.

  2. A operação LookupEvents não tem parâmetros obrigatórios. Deixe-os em branco e clique em Initiate Call.

  3. Clique em SDK Sample e, em seguida, clique em Python.

    O código de exemplo para Python será exibido.

  4. Clique em Download Complete Project.

  5. Extraia o pacote e abra o diretório alibabacloud_sample.

Executar o código

Execute o seguinte comando:

python sample.py

Saída de exemplo:

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