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.
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
Na página Users, localize o usuário RAM de destino e clique em Add Permissions na coluna Actions.
-
Pesquise por
actiontraile 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.
NotaSe 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.
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
-
Baixe e instale o Python.
Baixe o Python 3.
-
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
No OpenAPI Explorer, acesse a URL de solicitação da operação LookupEvents.
A operação LookupEvents não tem parâmetros obrigatórios. Deixe-os em branco e clique em Initiate Call.
-
Clique em SDK Sample e, em seguida, clique em Python.
O código de exemplo para Python será exibido.
Clique em Download Complete Project.
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"
}