DescribeInstanceHistoryEvents - : Central de Documentação do Alibaba Cloud

É possível consultar eventos de sistema concluídos nos últimos 30 dias. Não há limite de período para consultar eventos de sistema não concluídos.
Também é permitido especificar InstanceEventCycleStatus para buscar eventos nos estados Scheduled, Executing ou Inquiring.

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 de requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeInstanceHistoryEvents	Operação a ser executada. Defina o valor como DescribeInstanceHistoryEvents.
RegionId	String	Sim	cn-hangzhou	ID da região do recurso. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
InstanceId	String	Não	i-uf678mass4zvr9n1****	ID da instância. Se este parâmetro não for especificado, o sistema consulta os eventos de todas as instâncias na região indicada.
EventCycleStatus	String	Não	Executed	Estado do ciclo de vida do evento de sistema. Este parâmetro só tem efeito quando InstanceEventCycleStatus.N não estiver especificado. Valores válidos: Scheduled Avoided Executing Executed Canceled Failed Inquiring
EventType	String	Não	SystemMaintenance.Reboot	Tipo do evento de sistema. Este parâmetro só tem efeito quando InstanceEventType.N não estiver especificado. Valores válidos: SystemMaintenance.Reboot: A instância foi reiniciada devido à manutenção do sistema. SystemMaintenance.Redeploy: A instância foi reimplantada devido à manutenção do sistema. SystemFailure.Reboot: A instância foi reiniciada devido a um erro do sistema. SystemFailure.Redeploy: A instância foi reimplantada devido a um erro do sistema. SystemFailure.Delete: A instância foi liberada devido a uma falha na criação. InstanceFailure.Reboot: A instância foi reiniciada devido a um erro da própria instância. InstanceExpiration.Stop: A instância por assinatura foi parada devido ao vencimento. InstanceExpiration.Delete: A instância por assinatura foi liberada devido ao vencimento. AccountUnbalanced.Stop: A instância de pagamento conforme o uso foi parada devido a pagamento em atraso. AccountUnbalanced.Delete: A instância de pagamento conforme o uso foi liberada devido a pagamento em atraso. Nota Para mais informações, consulte Visão geral. Os valores deste parâmetro aplicam-se apenas a eventos de sistema de instâncias, e não a eventos de sistema de discos.
NotBefore.Start	String	Não	2017-11-30T06:32:31Z	Início da janela de execução agendada do evento de sistema. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
NotBefore.End	String	Não	2017-12-01T06:32:31Z	Fim da janela de execução agendada do evento de sistema. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
EventPublishTime.Start	String	Não	2017-11-30T06:32:31Z	Início do intervalo de tempo para consultar eventos de sistema publicados. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
EventPublishTime.End	String	Não	2017-12-01T06:32:31Z	Fim do intervalo de tempo para consultar eventos de sistema publicados. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
ImpactLevel	String	Não	null	Nota Este parâmetro não está disponível publicamente.
PageNumber	Integer	Não	1	Número da página. A paginação começa em 1. Valor padrão: 1
PageSize	Integer	Não	10	Quantidade de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10.
ResourceType	String	Não	instance	Tipo de recurso. Valores válidos: instance: instância ECS. ddh: host dedicado. managehost: máquina física em um pool de hospedagem inteligente. Valor padrão: instance.
EventId.N	String	Não	e-uf64yvznlao4jl2c****	ID do evento de sistema N. Valores válidos de N: 1 a 100. Repita este parâmetro para passar múltiplos valores.
InstanceEventCycleStatus.N	String	Não	Executed	Estado do ciclo de vida do evento de sistema N. Valores válidos de N: 1 a 7. Repita este parâmetro para passar múltiplos valores. Valores válidos: Scheduled Avoided Executing Executed Canceled Failed Inquiring
InstanceEventType.N	String	Não	SystemMaintenance.Reboot	Tipo do evento de sistema N. Valores válidos de N: 1 a 30. Repita este parâmetro para passar múltiplos valores. Valores válidos: SystemMaintenance.Reboot: A instância foi reiniciada devido à manutenção do sistema. SystemMaintenance.Redeploy: A instância foi reimplantada devido à manutenção do sistema. SystemFailure.Reboot: A instância foi reiniciada devido a um erro do sistema. SystemFailure.Redeploy: A instância foi reimplantada devido a um erro do sistema. SystemFailure.Delete: A instância foi liberada devido a uma falha na criação. InstanceFailure.Reboot: A instância foi reiniciada devido a um erro da própria instância. InstanceExpiration.Stop: A instância por assinatura foi parada devido ao vencimento. InstanceExpiration.Delete: A instância por assinatura foi liberada devido ao vencimento. AccountUnbalanced.Stop: A instância de pagamento conforme o uso foi parada devido a pagamento em atraso. AccountUnbalanced.Delete: A instância de pagamento conforme o uso foi liberada devido a pagamento em atraso. Nota Para mais informações, consulte Visão geral. Os valores deste parâmetro aplicam-se apenas a eventos de sistema de instâncias, e não a eventos de sistema de discos.
ResourceId.N	String	Não	i-uf678mass4zvr9n1****	ID do recurso N. Valores válidos de N: 1 a 100. Repita este parâmetro para passar múltiplos valores. Valores válidos: Quando `ResourceType` for definido como instance, ResourceId.N especifica o ID da instância N. Quando `ResourceType` for definido como ddh, ResourceId.N especifica o ID do host dedicado N. Quando `ResourceType` for definido como managedhost, ResourceId.N especifica o ID da máquina física N de um pool de hospedagem inteligente. Se este parâmetro não for especificado, o sistema consulta os eventos de todos os recursos do tipo definido em `ResourceType` na região indicada por `RegionId`. Nota Recomendamos usar `ResourceId.N` para especificar um ou mais IDs de recursos. Caso especifique tanto `ResourceId.N` quanto `InstanceId`, `ResourceId.N` terá precedência por padrão.
Tag.N.Key	String	Não	TestKey	Chave da tag N do recurso.
Tag.N.Value	String	Não	TestValue	Valor da tag N do recurso.
ResourceGroupId	String	Não	rg-bp67acfmxazb4p****	ID do grupo de recursos ao qual o recurso pertence.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Integer	10	Quantidade de entradas por página.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da requisição.
PageNumber	Integer	1	Número da página.
TotalCount	Integer	2	Número total de instâncias retornadas.
InstanceSystemEventSet	Array of InstanceSystemEventType		Informações sobre os eventos de sistema da instância.
InstanceSystemEventType
EventId	String	e-uf64yvznlao4jl2c****	ID do evento de sistema.
EventPublishTime	String	2017-11-30T06:32:31Z	Hora de publicação do evento de sistema. Segue o padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.
EventFinishTime	String	2017-12-01T06:35:31Z	Hora de término do evento de sistema. Segue o padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.
ResourceType	String	instance	Tipo de recurso. Valores válidos: instance: instância ECS. ddh: host dedicado. managehost: máquina física em um pool de hospedagem inteligente.
ImpactLevel	String	100	Nível de impacto do evento de sistema.
NotBefore	String	2017-12-06T00:00:00Z	Hora de início agendada do evento de sistema. Segue o padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.
InstanceId	String	i-uf678mass4zvr9n1****	ID da instância.
Reason	String	System maintenance is scheduled due to ***.	Motivo pelo qual o evento de sistema foi agendado.
EventType	Object		Tipo do evento de sistema.
Name	String	InstanceExpiration.Stop	Nome do tipo de evento de sistema.
Code	Integer	34	Código do tipo de evento de sistema.
EventCycleStatus	Object		Estado do ciclo de vida do evento de sistema.
Name	String	Executed	Nome do estado do evento de sistema.
Code	Integer	0	Código do estado do evento de sistema.
ExtendedAttribute	Object		Atributo estendido do evento de sistema.
Device	String	/dev/vda	Nome do dispositivo do disco local.
DiskId	String	d-diskid1	ID do disco local.
InactiveDisks	Array of InactiveDisk		Informações sobre discos inativos que foram liberados e precisam ser limpos.
InactiveDisk
CreationTime	String	2018-11-30T06:32:31Z	Hora de criação do disco. Segue o padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.
DeviceSize	String	80	Tamanho do disco. Unidade: GiB.
DeviceCategory	String	cloud_efficiency	Categoria do disco. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD padrão. cloud_essd: SSD aprimorado (ESSD). local_ssd_pro: disco local com uso intensivo de I/O. local_hdd_pro: disco local com uso intensivo de throughput. ephemeral: disco local descontinuado. ephemeral_ssd: SSD local descontinuado.
DeviceType	String	data	Tipo do disco. Valores válidos: system: disco do sistema. data: disco de dados.
ReleaseTime	String	2019-11-30T06:32:31Z	Hora de liberação do disco. Segue o padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.
HostType	String	ddh	Tipo de host. Valores válidos: ddh: host dedicado. managehost: máquina física em um pool de hospedagem inteligente.
HostId	String	dh-bp1ewce1gk3iwv2****	ID do host.
MigrationOptions	Array of String	MigrationPlan	Solução de migração da instância. Valor válido: MigrationPlan, indicando que a migração das instâncias ocorre apenas por meio de planos de migração.
OnlineRepairPolicy	String	IsolateOnly	Política de reparo online para o disco danificado. Valor válido: IsolateOnly, indicando que discos danificados são isolados, mas não reparados.
Rack	String	A01	Número do rack da Cloud Box.
PunishType	String	ecs_message_alert	Tipo da penalidade.
PunishDomain	String	1228.test.com	Nome de domínio ilegal.
PunishUrl	String	http://1228.test.com/1	URL ilegal.
Code	String	PR111	Código da violação de segurança.
CanAccept	String	true	Indica se o evento pode ser tratado.
ResponseResult	String	true	Resultado da resposta do evento. Valores válidos: true: O evento foi tratado. false: Falha ao tratar o evento.

Exemplos

Exemplos de requisições

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>

Exemplos de respostas de sucesso

Formato XML

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>

Formato JSON

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	InvalidParameter	%s	Parâmetro inválido.
403	EventIdLimitExceeded	%s	Mais de 100 IDs de evento foram especificados.
403	InvalidParameter.TimeEndBeforeStart	%s	Parâmetro inválido. Certifique-se de que a hora final seja posterior à hora inicial.
403	OperationDenied.NotInWhiteList	%s	Você não tem autorização para executar esta operação. Tente novamente após receber a autorização.
404	MissingParameter	%s	Um parâmetro não foi especificado.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.