LookupEvents - ActionTrail: Central de Documentação do Alibaba Cloud

Esta operação permite consultar eventos históricos com um limite de duas solicitações por segundo.

Nota: Evite chamar esta operação com frequência. Crie uma trilha para enviar eventos ao Log Service e consulte eventos históricos quase em tempo real usando o recurso de consumo de logs em tempo real do Log Service.

Para mais informações, consulte Crie uma trilha de conta única, Crie uma trilha de várias contas e Assinatura e consumo em tempo real.

Nota

A operação LookupEvents da API do ActionTrail versão 2017-12-04 será descontinuada. Recomendamos usar a operação LookupEvents da API do ActionTrail versão 2020-07-06. Para mais informações, consulte

LookupEvents

.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	LookupEvents	A operação a ser executada. Defina o valor como LookupEvents.
Event	String	Não	AD9CD9DA-EC2D-4EB7-A817-C0442A94****	O ID do evento.
Request	String	Não	AD9CD9DA-EC2D-4EB7-A817-C0442A94****	O ID da solicitação.
EventType	String	Não	ConsoleSignin	O tipo do evento. Valores válidos: ApiCall: indica uma chamada de API. ConsoleOperation: indica uma operação no Alibaba Cloud Management Console. AliyunServiceEvent: indica uma operação executada automaticamente por um serviço da Alibaba Cloud. PasswordReset: indica uma redefinição de senha. ConsoleSignin: indica um login no Alibaba Cloud Management Console. ConsoleSignout: indica um logoff do Alibaba Cloud Management Console.
ServiceName	String	Não	AsaSub	O nome do serviço da Alibaba Cloud.
EventName	String	Não	ConsoleSignin	O nome do evento.
User	String	Não	yanjie.wyj	O nome do usuário RAM que executa a operação.
ResourceType	String	Não	Instance	O tipo do recurso.
ResourceName	String	Não	i-bp14664y88udkt45****	O nome do recurso.
EventRW	String	Não	Write	O tipo de leitura/gravação do evento. Valores válidos: Read: indica um evento de leitura. Write: indica um evento de gravação. Este é o valor padrão. All: indica eventos de leitura e gravação.
EventAccessKeyId	String	Não	LTAI4FoDkCf4DU1bic1V****	O AccessKey ID usado no evento.
NextToken	String	Não	20	O token usado para solicitar a próxima página de resultados da consulta. Nota Os parâmetros da solicitação devem ser idênticos aos da última solicitação.
MaxResults	String	Não	20	O número máximo de entradas a serem retornadas. Valores válidos: 0 a 50.
StartTime	String	Não	2020-06-15T14:00:00Z	O início do intervalo de tempo da consulta. O padrão é sete dias antes do horário atual. Especifique o horário no padrão ISO 8601, em UTC. Formato: `YYYY-MM-DDThh:mm:ssZ`. Nota O intervalo máximo é de 30 dias. É possível consultar eventos gerados nos últimos 90 dias.
EndTime	String	Não	2020-06-22T14:00:00Z	O fim do intervalo de tempo da consulta. O padrão é o horário atual. Especifique o horário no padrão ISO 8601, em UTC. Formato: `YYYY-MM-DDThh:mm:ssZ`. Nota O intervalo máximo é de 30 dias. É possível consultar eventos gerados nos últimos 90 dias.

Para mais informações sobre os campos em um log de eventos, consulte Referência de log de eventos do ActionTrail.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Events	List	AD9CD9DA-EC2D-4EB7-A817-C0442A94****	Os eventos retornados.
NextToken	String	1	O token usado para retornar a próxima página de resultados da consulta. Nota Este parâmetro não é retornado se não houver mais resultados.
StartTime	String	2020-07-15T14:00:00Z	O início do intervalo de tempo em que os eventos foram consultados.
EndTime	String	2020-07-22T14:00:00Z	O fim do intervalo de tempo em que os eventos foram consultados.
RequestId	String	FD79665A-CE8B-49D4-82E6-5EE2E0E791DD	O ID da solicitação.

Exemplos

Exemplo de solicitação

http(s)://[Endpoint]/? Action=LookupEvents
&<Common request parameters>

Exemplo de resposta de sucesso

Formato JSON

{
    "RequestId": "AB6843AF-C07E-4B59-BBF8-A0CEB785E6A2",
    "NextToken": "2",
    "EndTime": "2020-11-26T01:30:39Z",
    "Events": [
        {
            "eventId": "96.227_1606286128938_****",
            "eventVersion": "1",
            "errorMessage": "success",
            "eventSource": "signin.aliyun.com",
            "sourceIpAddress": "42.120.XX.XX",
            "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.86 Safari/537.36",
            "eventType": "ConsoleSignin",
            "userIdentity": {
                "accountId": "159498693826****",
                "principalId": "24611178745315****",
                "type": "ram-user",
                "userName": "wb-bx66****"
            },
            "serviceName": "AasSub",
            "additionalEventData": {
                "callbackUrl": "https://api.aliyun.com/new?spm=a2c1g.8271268.10000.9.2d59df259iBwq1",
                "mfaChecked": "false"
            },
            "requestId": "96.227_1606286128938_2847",
            "eventTime": "2020-11-25T06:35:29Z",
            "acsRegion": "cn-hangzhou",
            "eventName": "ConsoleSignin"
        },
        {
            "eventId": "132.20_1606132532480_****",
            "eventVersion": "1",
            "errorMessage": "success",
            "eventSource": "signin.aliyun.com",
            "sourceIpAddress": "42.120.XX.XX",
            "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.75 Safari/537.36",
            "eventType": "ConsoleSignin",
            "userIdentity": {
                "accountId": "159498693826****",
                "principalId": "26855899827085****",
                "type": "ram-user",
                "userName": "yuge.****"
            },
            "serviceName": "AasSub",
            "additionalEventData": {
                "callbackUrl": "https://home.console.alibabacloud.com/",
                "mfaChecked": "false"
            },
            "requestId": "132.20_1606132532480_7292",
            "eventTime": "2020-11-23T11:55:32Z",
            "acsRegion": "cn-hangzhou",
            "eventName": "ConsoleSignin"
        }
    ],
    "StartTime": "2020-11-19T01:31:09Z"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.	A mensagem de erro retornada porque a assinatura da solicitação não está em conformidade com os padrões da Alibaba Cloud. Verifique se o AccessKey ID e o AccessKey secret são válidos e se o método de assinatura é adequado. Para mais informações, consulte Assinaturas de solicitação.
400	InvalidParameterCombination	The end time must be later than the start time.	A mensagem de erro retornada porque o fim do intervalo de tempo é anterior ou igual ao início.
400	InvalidQueryParameter	The specified query parameter is invalid.	A mensagem de erro retornada porque os parâmetros de solicitação especificados são inválidos.
400	InvalidParameterDateOutOfRange	Query time range exceeds 30 days.	A mensagem de erro retornada porque o intervalo de tempo especificado excede 30 dias.
400	InvalidParameterEndTime	The specified EndTime is invalid.	A mensagem de erro retornada porque o valor do parâmetro EndTime é inválido.
400	InvalidParameterStartTime	The specified StartTime is invalid.	A mensagem de erro retornada porque o valor do parâmetro StartTime é inválido.
400	InvalidParameterStartTimeExceedsCurrent	The StartTime exceeds the current time. Use GMT time format for queries.	A mensagem de erro retornada porque o início do intervalo de tempo é posterior ao horário atual. Especifique um intervalo de tempo válido em GMT.
400	InvalidParameterStartTimeOutOfDate	The StartTime exceeds the limit of 90 days.	A mensagem de erro retornada porque o início do intervalo de tempo está há mais de 90 dias antes do horário atual.
400	InvalidTimeRangeException	The end time must be later than the start time. The time span cannot exceed 30 days.	A mensagem de erro retornada porque o intervalo de tempo especificado é inválido. O fim do intervalo deve ser posterior ao início e o intervalo não pode exceder 30 dias.

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.