LookupEvents - ActionTrail - Centre de documentation Alibaba Cloud

Lors de l'appel à cette opération pour interroger les événements historiques, le débit est limité à deux requêtes par seconde.

Remarque : Évitez d'appeler fréquemment cette opération. Créez une piste (trail) pour acheminer les événements vers Log Service. Vous pourrez ainsi interroger les événements historiques en temps quasi réel grâce à la fonctionnalité de consommation de journaux en temps réel de Log Service.

Pour plus d'informations, consultez les rubriques Créer une piste pour un seul compte, Créer une piste multi-comptes et Abonnement et consommation en temps réel.

Remarque

L'opération LookupEvents de l'API ActionTrail version 2017-12-04 n'est plus disponible. Nous vous recommandons d'utiliser l'opération LookupEvents de l'API ActionTrail version 2020-07-06. Pour plus d'informations, consultez la rubrique

LookupEvents

.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	LookupEvents	Opération à effectuer. Spécifiez la valeur LookupEvents.
Event	String	Non	AD9CD9DA-EC2D-4EB7-A817-C0442A94****	ID de l'événement.
Request	String	Non	AD9CD9DA-EC2D-4EB7-A817-C0442A94****	ID de la requête.
EventType	String	Non	ConsoleSignin	Type de l'événement. Les valeurs valides sont : ApiCall : appel d'API. ConsoleOperation : opération effectuée dans la console Alibaba Cloud Management Console. AliyunServiceEvent : opération exécutée automatiquement par un service Alibaba Cloud. PasswordReset : réinitialisation de mot de passe. ConsoleSignin : connexion à la console Alibaba Cloud Management Console. ConsoleSignout : déconnexion de la console Alibaba Cloud Management Console.
ServiceName	String	Non	AsaSub	Nom du service Alibaba Cloud.
EventName	String	Non	ConsoleSignin	Nom de l'événement.
User	String	Non	yanjie.wyj	Nom de l'utilisateur RAM qui appelle l'opération.
ResourceType	String	Non	Instance	Type de ressource.
ResourceName	String	Non	i-bp14664y88udkt45****	Nom de la ressource.
EventRW	String	Non	Write	Type de lecture/écriture de l'événement. Les valeurs valides sont : Read : événement de lecture. Write : événement d'écriture. Il s'agit de la valeur par défaut. All : événements de lecture et d'écriture.
EventAccessKeyId	String	Non	LTAI4FoDkCf4DU1bic1V****	AccessKey ID utilisé dans l'événement.
NextToken	String	Non	20	Jeton utilisé pour demander la page suivante des résultats de requête. Remarque Les paramètres de requête doivent être identiques à ceux de la dernière requête.
MaxResults	String	Non	20	Nombre maximal d'entrées à renvoyer. Valeurs valides : 0 à 50.
StartTime	String	Non	2020-06-15T14:00:00Z	Début de la plage de temps à interroger. La valeur par défaut correspond à sept jours avant l'heure actuelle. Spécifiez l'heure au format ISO 8601. L'heure doit être exprimée en UTC. Format : `YYYY-MM-DDThh:mm:ssZ`. Remarque La plage de temps maximale est de 30 jours. Vous pouvez interroger les événements générés au cours des 90 derniers jours.
EndTime	String	Non	2020-06-22T14:00:00Z	Fin de la plage de temps à interroger. La valeur par défaut correspond à l'heure actuelle. Spécifiez l'heure au format ISO 8601. L'heure doit être exprimée en UTC. Format : `YYYY-MM-DDThh:mm:ssZ`. Remarque La plage de temps maximale est de 30 jours. Vous pouvez interroger les événements générés au cours des 90 derniers jours.

Pour plus d'informations sur les champs d'un journal d'événements, consultez la rubrique Référence des journaux d'événements ActionTrail.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Events	List	AD9CD9DA-EC2D-4EB7-A817-C0442A94****	Événements renvoyés.
NextToken	String	1	Jeton utilisé pour renvoyer la page suivante des résultats de requête. Remarque Ce paramètre n'est pas renvoyé s'il n'y a plus de résultats à retourner.
StartTime	String	2020-07-15T14:00:00Z	Début de la plage de temps durant laquelle les événements ont été interrogés.
EndTime	String	2020-07-22T14:00:00Z	Fin de la plage de temps durant laquelle les événements ont été interrogés.
RequestId	String	FD79665A-CE8B-49D4-82E6-5EE2E0E791DD	ID de la requête.

Exemples

Exemple de requête

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

Exemple de réponse réussie

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

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.	La signature de la requête n'est pas conforme aux normes d'Alibaba Cloud. Vérifiez que l'AccessKey ID et l'AccessKey secret sont valides et que la méthode de signature est appropriée. Pour plus d'informations, consultez Signatures de requête.
400	InvalidParameterCombination	The end time must be later than the start time.	La fin de la plage de temps est antérieure ou égale au début.
400	InvalidQueryParameter	The specified query parameter is invalid.	Les paramètres de requête spécifiés ne sont pas valides.
400	InvalidParameterDateOutOfRange	Query time range exceeds 30 days.	La plage de temps spécifiée dépasse 30 jours.
400	InvalidParameterEndTime	The specified EndTime is invalid.	La valeur du paramètre EndTime n'est pas valide.
400	InvalidParameterStartTime	The specified StartTime is invalid.	La valeur du paramètre StartTime n'est pas valide.
400	InvalidParameterStartTimeExceedsCurrent	The StartTime exceeds the current time. Use GMT time format for queries.	Le début de la plage de temps est postérieur à l'heure actuelle. Spécifiez une plage de temps valide au format GMT.
400	InvalidParameterStartTimeOutOfDate	The StartTime exceeds the limit of 90 days.	Le début de la plage de temps remonte à plus de 90 jours avant l'heure actuelle.
400	InvalidTimeRangeException	The end time must be later than the start time. The time span cannot exceed 30 days.	La plage de temps spécifiée n'est pas valide. La fin de la plage de temps doit être postérieure au début et la plage de temps ne doit pas dépasser 30 jours.

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.