DescribeInstanceHistoryEvents - - Centre de documentation Alibaba Cloud

Vous pouvez interroger les événements système terminés au cours des 30 derniers jours. Aucune limite de temps ne s'applique à l'interrogation des événements système non terminés.
Spécifiez le paramètre InstanceEventCycleStatus pour interroger les événements système dont l'état est Scheduled (Planifié), Executing (En cours d'exécution) ou Inquiring (En cours d'enquête).

Débogage

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

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeInstanceHistoryEvents	L'opération que vous souhaitez effectuer. Définissez la valeur sur DescribeInstanceHistoryEvents.
RegionId	String	Yes	cn-hangzhou	L'ID de région de la ressource. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
InstanceId	String	No	i-uf678mass4zvr9n1****	L'ID de l'instance. Si ce paramètre n'est pas spécifié, les événements système de toutes les instances de la région spécifiée sont interrogés.
EventCycleStatus	String	No	Executed	L'état du cycle de vie de l'événement système. Ce paramètre prend effet uniquement lorsque InstanceEventCycleStatus.N n'est pas spécifié. Valeurs valides : Scheduled Avoided Executing Executed Canceled Failed Inquiring
EventType	String	No	SystemMaintenance.Reboot	Le type de l'événement système. Ce paramètre prend effet uniquement lorsque InstanceEventType.N n'est pas spécifié. Valeurs valides : SystemMaintenance.Reboot : L'instance est redémarrée en raison d'une maintenance système. SystemMaintenance.Redeploy : L'instance est redéployée en raison d'une maintenance système. SystemFailure.Reboot : L'instance est redémarrée en raison d'une erreur système. SystemFailure.Redeploy : L'instance est redéployée en raison d'une erreur système. SystemFailure.Delete : L'instance est libérée en raison d'un échec de création d'instance. InstanceFailure.Reboot : L'instance est redémarrée en raison d'une erreur d'instance. InstanceExpiration.Stop : L'instance par abonnement est arrêtée en raison de l'expiration. InstanceExpiration.Delete : L'instance par abonnement est libérée en raison de l'expiration. AccountUnbalanced.Stop : L'instance prépayée est arrêtée en raison d'un paiement en souffrance. AccountUnbalanced.Delete : L'instance prépayée est libérée en raison d'un paiement en souffrance. Remarque Pour plus d'informations, consultez la page Overview. Les valeurs de ce paramètre s'appliquent uniquement aux événements système d'instance, et non aux événements système de disque.
NotBefore.Start	String	No	2017-11-30T06:32:31Z	Le début de la fenêtre d'exécution planifiée de l'événement système. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
NotBefore.End	String	No	2017-12-01T06:32:31Z	La fin de la fenêtre d'exécution planifiée de l'événement système. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
EventPublishTime.Start	String	No	2017-11-30T06:32:31Z	Le début de la plage de temps pour l'interrogation des événements système publiés. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
EventPublishTime.End	String	No	2017-12-01T06:32:31Z	La fin de la plage de temps pour l'interrogation des événements système publiés. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
ImpactLevel	String	No	null	Remarque Ce paramètre n'est pas disponible publiquement.
PageNumber	Integer	No	1	Le numéro de page. La pagination commence à la page 1. Valeur par défaut : 1
PageSize	Integer	No	10	Le nombre d'entrées par page. Valeurs valides : 1 à 100. Valeur par défaut : 10.
ResourceType	String	No	instance	Le type de ressource. Valeurs valides : instance : instance ECS. ddh : hôte dédié. managehost : machine physique dans un pool d'hébergement intelligent. Valeur par défaut : instance.
EventId.N	String	No	e-uf64yvznlao4jl2c****	L'ID de l'événement système N. Valeurs valides de N : 1 à 100. Vous pouvez répéter ce paramètre pour transmettre plusieurs valeurs.
InstanceEventCycleStatus.N	String	No	Executed	L'état du cycle de vie de l'événement système N. Valeurs valides de N : 1 à 7. Vous pouvez répéter ce paramètre pour transmettre plusieurs valeurs. Valeurs valides : Scheduled Avoided Executing Executed Canceled Failed Inquiring
InstanceEventType.N	String	No	SystemMaintenance.Reboot	Le type de l'événement système N. Valeurs valides de N : 1 à 30. Vous pouvez répéter ce paramètre pour transmettre plusieurs valeurs. Valeurs valides : SystemMaintenance.Reboot : L'instance est redémarrée en raison d'une maintenance système. SystemMaintenance.Redeploy : L'instance est redéployée en raison d'une maintenance système. SystemFailure.Reboot : L'instance est redémarrée en raison d'une erreur système. SystemFailure.Redeploy : L'instance est redéployée en raison d'une erreur système. SystemFailure.Delete : L'instance est libérée en raison d'un échec de création d'instance. InstanceFailure.Reboot : L'instance est redémarrée en raison d'une erreur d'instance. InstanceExpiration.Stop : L'instance par abonnement est arrêtée en raison de l'expiration. InstanceExpiration.Delete : L'instance par abonnement est libérée en raison de l'expiration. AccountUnbalanced.Stop : L'instance prépayée est arrêtée en raison d'un paiement en souffrance. AccountUnbalanced.Delete : L'instance prépayée est libérée en raison d'un paiement en souffrance. Remarque Pour plus d'informations, consultez la page Overview. Les valeurs de ce paramètre s'appliquent uniquement aux événements système d'instance, et non aux événements système de disque.
ResourceId.N	String	No	i-uf678mass4zvr9n1****	L'ID de la ressource N. Valeurs valides de N : 1 à 100. Vous pouvez répéter ce paramètre pour transmettre plusieurs valeurs. Valeurs valides : Lorsque `ResourceType` est défini sur instance, ResourceId.N spécifie l'ID de l'instance N. Lorsque `ResourceType` est défini sur ddh, ResourceId.N spécifie l'ID de l'hôte dédié N. Lorsque `ResourceType` est défini sur managedhost, ResourceId.N spécifie l'ID de la machine physique N d'un pool d'hébergement intelligent. Si ce paramètre n'est pas spécifié, les événements système de toutes les ressources du type spécifié par `ResourceType` dans la région spécifiée par `RegionId` sont interrogés. Remarque Nous vous recommandons d'utiliser `ResourceId.N` pour spécifier un ou plusieurs ID de ressource. Si vous spécifiez à la fois `ResourceId.N` et `InstanceId`, `ResourceId.N` est prioritaire par défaut.
Tag.N.Key	String	No	TestKey	La clé du tag N de la ressource.
Tag.N.Value	String	No	TestValue	La valeur du tag N de la ressource.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	L'ID du groupe de ressources auquel appartient la ressource.

Paramètres de réponse

Parameter	Type	Example	Description
PageSize	Integer	10	Le nombre d'entrées par page.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	L'ID de la requête.
PageNumber	Integer	1	Le numéro de page.
TotalCount	Integer	2	Le nombre total d'instances renvoyées.
InstanceSystemEventSet	Array of InstanceSystemEventType		Les informations relatives aux événements système d'instance.
InstanceSystemEventType
EventId	String	e-uf64yvznlao4jl2c****	L'ID de l'événement système.
EventPublishTime	String	2017-11-30T06:32:31Z	L'heure de publication de l'événement système. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
EventFinishTime	String	2017-12-01T06:35:31Z	L'heure de fin de l'événement système. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
ResourceType	String	instance	Le type de ressource. Valeurs valides : instance : instance ECS. ddh : hôte dédié. managehost : machine physique dans un pool d'hébergement intelligent.
ImpactLevel	String	100	Le niveau d'impact de l'événement système.
NotBefore	String	2017-12-06T00:00:00Z	L'heure de début planifiée de l'événement système. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
InstanceId	String	i-uf678mass4zvr9n1****	L'ID de l'instance.
Reason	String	System maintenance is scheduled due to ***.	La raison pour laquelle l'événement système a été planifié.
EventType	Object		Le type de l'événement système.
Name	String	InstanceExpiration.Stop	Le nom du type d'événement système.
Code	Integer	34	Le code du type d'événement système.
EventCycleStatus	Object		L'état du cycle de vie de l'événement système.
Name	String	Executed	Le nom de l'état de l'événement système.
Code	Integer	0	Le code de l'état de l'événement système.
ExtendedAttribute	Object		L'attribut étendu de l'événement système.
Device	String	/dev/vda	Le nom du périphérique du disque local.
DiskId	String	d-diskid1	L'ID du disque local.
InactiveDisks	Array of InactiveDisk		Les informations sur les disques inactifs qui ont été libérés et doivent être effacés.
InactiveDisk
CreationTime	String	2018-11-30T06:32:31Z	L'heure de création du disque. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
DeviceSize	String	80	La taille du disque. Unité : GiB.
DeviceCategory	String	cloud_efficiency	La catégorie du disque. Valeurs valides : cloud : disque basique. cloud_efficiency : disque ultra. cloud_ssd : SSD standard. cloud_essd : SSD amélioré (ESSD). local_ssd_pro : disque local à forte intensité d'E/S. local_hdd_pro : disque local à forte intensité de débit. ephemeral : disque local retiré. ephemeral_ssd : SSD local retiré.
DeviceType	String	data	Le type de disque. Valeurs valides : system : disque système. data : disque de données.
ReleaseTime	String	2019-11-30T06:32:31Z	L'heure de libération du disque. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
HostType	String	ddh	Le type d'hôte. Valeurs valides : ddh : hôte dédié. managehost : machine physique dans un pool d'hébergement intelligent.
HostId	String	dh-bp1ewce1gk3iwv2****	L'ID de l'hôte.
MigrationOptions	Array of String	MigrationPlan	La solution de migration de l'instance. Valeur valide : MigrationPlan, qui indique que les instances ne peuvent être migrées qu'à l'aide de plans de migration.
OnlineRepairPolicy	String	IsolateOnly	La politique de réparation en ligne pour le disque endommagé. Valeur valide : IsolateOnly, qui indique que les disques endommagés sont isolés mais non réparés.
Rack	String	A01	Le numéro de rack du Cloud Box.
PunishType	String	ecs_message_alert	Le type de pénalité.
PunishDomain	String	1228.test.com	Le nom de domaine illégal.
PunishUrl	String	http://1228.test.com/1	L'URL illégale.
Code	String	PR111	Le code de la violation de sécurité.
CanAccept	String	true	Indique si l'événement peut être traité.
ResponseResult	String	true	Le résultat de la réponse de l'événement. Valeurs valides : true : L'événement a été traité. false : Le traitement de l'événement a échoué.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=DescribeInstanceHistoryEvents
&RegionId=cn-hangzhou
&InstanceId=i-uf678mass4zvr9n1****
&EventId.1=e-uf64yvznlao4jl2c****
&InstanceEventCycleStatus.1=Executed
&EventCycleStatus=Executed
&InstanceEventType.1=SystemMaintenance.Reboot
&NotBefore.Start=2017-11-30T06:32:31Z
&NotBefore.End=2017-12-01T06:32:31Z
&PageNumber=1
&PageSize=1
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<DescribeInstanceHistoryEventsResponse>
    <PageSize>10</PageSize>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>2</TotalCount>
    <InstanceSystemEventSet>
        <EventId>e-uf64yvznlao4jl2c****</EventId>
        <EventPublishTime>2017-11-30T06:32:31Z</EventPublishTime>
        <EventFinishTime>2017-12-01T06:35:31Z</EventFinishTime>
        <ResourceType>instance</ResourceType>
        <ImpactLevel>100</ImpactLevel>
        <NotBefore>2017-12-06T00:00:00Z</NotBefore>
        <InstanceId>i-uf678mass4zvr9n1****</InstanceId>
        <Reason>System maintenance is scheduled due to ***.</Reason>
        <EventType>
            <Name>InstanceExpiration.Stop</Name>
            <Code>34</Code>
        </EventType>
        <EventCycleStatus>
            <Name>Executed</Name>
            <Code>0</Code>
        </EventCycleStatus>
        <ExtendedAttribute>
            <Device>/dev/vda</Device>
            <DiskId>d-diskid1</DiskId>
            <InactiveDisks>
                <CreationTime>2018-11-30T06:32:31Z</CreationTime>
                <DeviceSize>80</DeviceSize>
                <DeviceCategory>cloud_efficiency</DeviceCategory>
                <DeviceType>data</DeviceType>
                <ReleaseTime>2019-11-30T06:32:31Z</ReleaseTime>
            </InactiveDisks>
            <HostType>ddh</HostType>
            <HostId>dh-bp1ewce1gk3iwv2****</HostId>
            <MigrationOptions>MigrationOptions</MigrationOptions>
            <OnlineRepairPolicy>IsolateOnly</OnlineRepairPolicy>
            <Rack>cb-f8z7yvzgwfkl90h****0</Rack>
        </ExtendedAttribute>
    </InstanceSystemEventSet>
</DescribeInstanceHistoryEventsResponse>

JSON format

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

{
  "PageSize" : 10,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber" : 1,
  "TotalCount" : 2,
  "InstanceSystemEventSet" : [ {
    "EventId" : "e-uf64yvznlao4jl2c****",
    "EventPublishTime" : "2017-11-30T06:32:31Z",
    "EventFinishTime" : "2017-12-01T06:35:31Z",
    "ResourceType" : "instance",
    "ImpactLevel" : "100",
    "NotBefore" : "2017-12-06T00:00:00Z",
    "InstanceId" : "i-uf678mass4zvr9n1****",
    "Reason" : "System maintenance is scheduled due to ***.",
    "EventType" : {
      "Name" : "InstanceExpiration.Stop",
      "Code" : 34
    },
    "EventCycleStatus" : {
      "Name" : "Executed",
      "Code" : 0
    },
    "ExtendedAttribute" : {
      "Device" : "/dev/vda",
      "DiskId" : "d-diskid1",
      "InactiveDisks" : [ {
        "CreationTime" : "2018-11-30T06:32:31Z",
        "DeviceSize" : "80",
        "DeviceCategory" : "cloud_efficiency",
        "DeviceType" : "data",
        "ReleaseTime" : "2019-11-30T06:32:31Z"
      } ],
      "HostType" : "ddh",
      "HostId" : "dh-bp1ewce1gk3iwv2****",
      "MigrationOptions" : [ "MigrationOptions" ],
      "OnlineRepairPolicy" : "IsolateOnly",
      "Rack" : "cb-f8z7yvzgwfkl90h****0"
    }
  } ]
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
403	InvalidParameter	%s	Paramètre non valide.
403	EventIdLimitExceeded	%s	Plus de 100 ID d'événement sont spécifiés.
403	InvalidParameter.TimeEndBeforeStart	%s	Paramètre non valide. Assurez-vous que l'heure de fin est postérieure à l'heure de début.
403	OperationDenied.NotInWhiteList	%s	Vous n'êtes pas autorisé à effectuer cette opération. Réessayez après avoir obtenu l'autorisation.
404	MissingParameter	%s	Un paramètre n'est pas spécifié.

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur de service.