Interroger les événements historiques - - Centre de documentation Alibaba Cloud

La fonctionnalité d'historique des événements permet de consulter les événements survenus dans une région sur une plage de temps donnée. Les événements historiques incluent la création d'instances et la modification des paramètres. Pour plus d'informations, consultez Afficher l'historique des événements d'une instance ApsaraDB RDS .

Avant d'appeler cette opération, assurez-vous que la fonctionnalité d'historique des événements est activée. Sinon, l'appel échouera.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeEvents	Opération à effectuer. Définissez la valeur sur DescribeEvents.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir les ID des régions.
StartTime	String	No	2019-06-11T15:00:00Z	Début de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 : yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
EndTime	String	No	2019-06-12T15:00:00Z	Fin de la plage de temps à interroger. L'heure de fin doit être postérieure à l'heure de début. Spécifiez l'heure au format ISO 8601 : yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
PageSize	Integer	No	30	Nombre d'entrées à renvoyer par page. Valeurs valides : 30 50 100 Valeur par défaut : 30.
PageNumber	Integer	No	1	Numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1.

Paramètres de réponse

Parameter	Type	Example	Description
PageNumber	Integer	1	Numéro de la page renvoyée.
RequestId	String	A103039D-B1B2-4C57-B989-7D7C0DA95426	ID de la requête.
PageSize	Integer	30	Nombre d'entrées renvoyées par page.
TotalRecordCount	Integer	40	Nombre total d'entrées renvoyées.
EventItems	Array of EventItems		Détails des événements.
EventItems
EventName	String	ModifySecurityIPList	Nom de l'événement. Pour plus d'informations, consultez Afficher l'historique des événements d'une instance ApsaraDB RDS .
EventTime	String	2019-08-20T01:08:22Z	Heure de survenue de l'événement.
EventUserType	String	SYSTEM	Type d'utilisateur ayant exécuté l'événement.
EventRecordTime	String	2019-08-20T01:12:49Z	Heure d'enregistrement de l'événement. Cette heure est légèrement postérieure à celle de la survenue de l'événement.
CallerUid	Long	22973492	ID de l'utilisateur ayant exécuté l'événement.
RegionId	String	cn-hangzhou	ID de région de l'instance.
EventId	Integer	11000053	ID de l'événement.
EventType	String	NetworkManagement	Type de l'événement. Pour plus d'informations, consultez Afficher l'historique des événements d'une instance ApsaraDB RDS .
ResourceType	String	instance	Type de ressource associée à l'événement. Ce paramètre prend uniquement en charge les instances.
EventPayload	String	{\"Domain\": \"rds-inc-share.aliyuncs.com\", \"Api\": \"ReleaseInstancePublicConnection\"}	Paramètres de requête ou de contexte de l'événement.
EventReason	String	FROM_USER	Source de l'événement. Pour plus d'informations, consultez Afficher l'historique des événements d'une instance ApsaraDB RDS .
ResourceName	String	rm-bp1z3065m9976ix8a	Nom de la ressource associée à l'événement. Ce paramètre prend uniquement en charge les ID d'instance.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=DescribeEvents
&Region=cn-hangzhou
&StartTime=2019-08-20T01:30:00Z
&EndTime=2019-08-20T01:35:00Z
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeEventsResponse>
    <EventItems>
        <EventItems>
            <EventName>ModifySecurityIPList</EventName>
            <EventUserType>SYSTEM</EventUserType>
            <ResourceType>instance</ResourceType>
            <EventPayload/>
            <EventTime>2019-08-20T01:33:43Z</EventTime>
            <RegionId>cn-hangzhou</RegionId>
            <EventRecordTime>2019-08-20T01:33:57Z</EventRecordTime>
            <EventReason>FROM_SYSTEM</EventReason>
            <EventId>11000048</EventId>
            <ResourceName>rm-bpxxxxxxx</ResourceName>
            <EventType>SecurityManagement</EventType>
            <CallerUid>25421491**********</CallerUid>
        </EventItems>
        <EventItems>
            <EventName>ModifySecurityIPList</EventName>
            <EventUserType>SYSTEM</EventUserType>
            <ResourceType>instance</ResourceType>
            <EventPayload/>
            <EventTime>2019-08-20T01:33:43Z</EventTime>
            <RegionId>cn-hangzhou</RegionId>
            <EventRecordTime>2019-08-20T01:33:57Z</EventRecordTime>
            <EventReason>FROM_SYSTEM</EventReason>
            <EventId>11000047</EventId>
            <ResourceName>rm-bpxxxxxxx</ResourceName>
            <EventType>SecurityManagement</EventType>
            <CallerUid>22973492**********</CallerUid>
        </EventItems>
    </EventItems>
    <TotalRecordCount>2</TotalRecordCount>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <RequestId>B5FF9EE6-830E-4DBE-8498-9890A62D2875</RequestId>
</DescribeEventsResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "EventItems" : {
    "EventItems" : [ {
      "EventName" : "ModifySecurityIPList",
      "EventUserType" : "SYSTEM",
      "ResourceType" : "instance",
      "EventPayload" : "",
      "EventTime" : "2019-08-20T01:33:43Z",
      "RegionId" : "cn-hangzhou",
      "EventRecordTime" : "2019-08-20T01:33:57Z",
      "EventReason" : "FROM_SYSTEM",
      "EventId" : 11000048,
      "ResourceName" : "rm-bpxxxxxxx",
      "EventType" : "SecurityManagement",
      "CallerUid" : "25421491**********"
    }, {
      "EventName" : "ModifySecurityIPList",
      "EventUserType" : "SYSTEM",
      "ResourceType" : "instance",
      "EventPayload" : "",
      "EventTime" : "2019-08-20T01:33:43Z",
      "RegionId" : "cn-hangzhou",
      "EventRecordTime" : "2019-08-20T01:33:57Z",
      "EventReason" : "FROM_SYSTEM",
      "EventId" : 11000047,
      "ResourceName" : "rm-bpxxxxxxx",
      "EventType" : "SecurityManagement",
      "CallerUid" : "22973492**********"
    } ]
  },
  "TotalRecordCount" : 2,
  "PageNumber" : 1,
  "PageSize" : 2,
  "RequestId" : "B5FF9EE6-830E-4DBE-8498-9890A62D2875"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidStartTime.Format	Specified start time is not valid.	L'heure de début spécifiée n'est pas valide.
400	InvalidParameterCombination	The end time must be greater than the start time	L'heure de fin doit être postérieure à l'heure de début.
400	RegionNotSupport	The region is not supported.	L'opération n'est pas prise en charge dans la région.

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