All Products
Search
Document Center

:DescribeInstanceHistoryEvents

Last Updated:May 22, 2026

Mengkueri event sistem dari instance Elastic Compute Service (ECS). Secara default, hanya event sistem yang tidak aktif yang dikueri.

  • Anda dapat mengkueri event sistem yang telah selesai dalam 30 hari terakhir. Tidak ada batasan rentang waktu untuk mengkueri event sistem yang belum selesai.
  • Anda juga dapat menentukan InstanceEventCycleStatus untuk mengkueri event sistem dengan status Scheduled, Executing, atau Inquiring.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter Type Wajib Contoh Deskripsi
Action String Ya DescribeInstanceHistoryEvents

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeInstanceHistoryEvents.

RegionId String Ya cn-hangzhou

ID wilayah resource. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

InstanceId String Tidak i-uf678mass4zvr9n1****

ID instans. Jika parameter ini tidak ditentukan, event sistem dari semua instans di wilayah yang ditentukan akan dikueri.

EventCycleStatus String Tidak Executed

Status siklus hidup event sistem. Parameter ini hanya berlaku jika InstanceEventCycleStatus.N tidak ditentukan. Nilai yang valid:

  • Scheduled
  • Avoided
  • Executing
  • Executed
  • Canceled
  • Failed
  • Inquiring
EventType String Tidak SystemMaintenance.Reboot

Jenis event sistem. Parameter ini hanya berlaku jika InstanceEventType.N tidak ditentukan. Nilai yang valid:

  • SystemMaintenance.Reboot: Instans direstart karena maintenance sistem.
  • SystemMaintenance.Redeploy: Instans diredploy karena maintenance sistem.
  • SystemFailure.Reboot: Instans direstart karena error sistem.
  • SystemFailure.Redeploy: Instans diredploy karena error sistem.
  • SystemFailure.Delete: Instans dilepas karena kegagalan pembuatan instans.
  • InstanceFailure.Reboot: Instans direstart karena error instans.
  • InstanceExpiration.Stop: Instans subscription dihentikan karena kedaluwarsa.
  • InstanceExpiration.Delete: Instans subscription dilepas karena kedaluwarsa.
  • AccountUnbalanced.Stop: Instans pay-as-you-go dihentikan karena pembayaran tertunda.
  • AccountUnbalanced.Delete: Instans pay-as-you-go dilepas karena pembayaran tertunda.
Catatan Untuk informasi selengkapnya, lihat Overview. Nilai parameter ini hanya berlaku untuk event sistem instans, bukan untuk event sistem disk.
NotBefore.Start String Tidak 2017-11-30T06:32:31Z

Awal jendela eksekusi terjadwal event sistem. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

NotBefore.End String Tidak 2017-12-01T06:32:31Z

Akhir jendela eksekusi terjadwal event sistem. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

EventPublishTime.Start String Tidak 2017-11-30T06:32:31Z

Awal rentang waktu untuk mengkueri event sistem yang telah dipublikasikan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

EventPublishTime.End String Tidak 2017-12-01T06:32:31Z

Akhir rentang waktu untuk mengkueri event sistem yang telah dipublikasikan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

ImpactLevel String Tidak null
Catatan Parameter ini tidak tersedia untuk umum.
PageNumber Integer Tidak 1

Nomor halaman. Halaman dimulai dari halaman 1.

Nilai default: 1

PageSize Integer Tidak 10

Jumlah entri per halaman. Nilai yang valid: 1 hingga 100.

Nilai default: 10.

ResourceType String Tidak instance

Jenis resource. Nilai yang valid:

  • instance: ECS instance.
  • ddh: dedicated host.
  • managehost: physical machine in a smart hosting pool.

Nilai default: instance.

EventId.N String Tidak e-uf64yvznlao4jl2c****

ID event sistem N. Nilai N yang valid: 1 hingga 100. Anda dapat mengulangi parameter ini untuk meneruskan beberapa nilai.

InstanceEventCycleStatus.N String Tidak Executed

Status siklus hidup event sistem N. Nilai N yang valid: 1 hingga 7. Anda dapat mengulangi parameter ini untuk meneruskan beberapa nilai. Nilai yang valid:

  • Scheduled
  • Avoided
  • Executing
  • Executed
  • Canceled
  • Failed
  • Inquiring
InstanceEventType.N String Tidak SystemMaintenance.Reboot

Jenis event sistem N. Nilai N yang valid: 1 hingga 30. Anda dapat mengulangi parameter ini untuk meneruskan beberapa nilai. Nilai yang valid:

  • SystemMaintenance.Reboot: Instans direstart karena maintenance sistem.
  • SystemMaintenance.Redeploy: Instans diredploy karena maintenance sistem.
  • SystemFailure.Reboot: Instans direstart karena error sistem.
  • SystemFailure.Redeploy: Instans diredploy karena error sistem.
  • SystemFailure.Delete: Instans dilepas karena kegagalan pembuatan instans.
  • InstanceFailure.Reboot: Instans direstart karena error instans.
  • InstanceExpiration.Stop: Instans subscription dihentikan karena kedaluwarsa.
  • InstanceExpiration.Delete: Instans subscription dilepas karena kedaluwarsa.
  • AccountUnbalanced.Stop: Instans pay-as-you-go dihentikan karena pembayaran tertunda.
  • AccountUnbalanced.Delete: Instans pay-as-you-go dilepas karena pembayaran tertunda.
Catatan Untuk informasi selengkapnya, lihat Overview. Nilai parameter ini hanya berlaku untuk event sistem instans, bukan untuk event sistem disk.
ResourceId.N String Tidak i-uf678mass4zvr9n1****

ID resource N. Nilai N yang valid: 1 hingga 100. Anda dapat mengulangi parameter ini untuk meneruskan beberapa nilai. Nilai yang valid:

  • Ketika ResourceType diatur ke instance, ResourceId.N menentukan ID instans N.
  • Ketika ResourceType diatur ke ddh, ResourceId.N menentukan ID dedicated host N.
  • Ketika ResourceType diatur ke managedhost, ResourceId.N menentukan ID physical machine N dari smart hosting pool.

Jika parameter ini tidak ditentukan, event sistem dari semua resource jenis yang ditentukan oleh ResourceType di wilayah yang ditentukan oleh RegionId akan dikueri.

Catatan Kami menyarankan agar Anda menggunakan ResourceId.N untuk menentukan satu atau beberapa ID resource. Jika Anda menentukan ResourceId.N dan InstanceId, ResourceId.N akan didahulukan secara default.
Tag.N.Key String Tidak TestKey

Kunci tag N dari resource.

Tag.N.Value String Tidak TestValue

Nilai tag N dari resource.

ResourceGroupId String Tidak rg-bp67acfmxazb4p****

ID kelompok sumber daya tempat resource tersebut berada.

Parameter respons

Parameter Type Contoh Deskripsi
PageSize Integer 10

Jumlah entri per halaman.

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID permintaan.

PageNumber Integer 1

Nomor halaman.

TotalCount Integer 2

Total jumlah instans yang dikembalikan.

InstanceSystemEventSet Array of InstanceSystemEventType

Informasi tentang event sistem instans.

InstanceSystemEventType
EventId String e-uf64yvznlao4jl2c****

ID event sistem.

EventPublishTime String 2017-11-30T06:32:31Z

Waktu event sistem dipublikasikan. Waktu mengikuti standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

EventFinishTime String 2017-12-01T06:35:31Z

Waktu event sistem berakhir. Waktu mengikuti standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

ResourceType String instance

Jenis resource. Nilai yang valid:

  • instance: ECS instance.
  • ddh: dedicated host.
  • managehost: physical machine in a smart hosting pool.
ImpactLevel String 100

Tingkat dampak event sistem.

NotBefore String 2017-12-06T00:00:00Z

Waktu mulai terjadwal event sistem. Waktu mengikuti standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

InstanceId String i-uf678mass4zvr9n1****

ID instans.

Reason String System maintenance is scheduled due to ***.

Alasan event sistem dijadwalkan.

EventType Object

Jenis event sistem.

Name String InstanceExpiration.Stop

Nama jenis event sistem.

Code Integer 34

Kode jenis event sistem.

EventCycleStatus Object

Status siklus hidup event sistem.

Name String Executed

Nama status event sistem.

Code Integer 0

Kode status event sistem.

ExtendedAttribute Object

Atribut tambahan event sistem.

Device String /dev/vda

Nama perangkat disk lokal.

DiskId String d-diskid1

ID disk lokal.

InactiveDisks Array of InactiveDisk

Informasi tentang disk tidak aktif yang telah dilepas dan harus dibersihkan.

InactiveDisk
CreationTime String 2018-11-30T06:32:31Z

Waktu disk dibuat. Waktu mengikuti standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

DeviceSize String 80

Ukuran disk. Satuan: GiB.

DeviceCategory String cloud_efficiency

Kategori disk. Nilai yang valid:

  • cloud: basic disk.
  • cloud_efficiency: ultra disk.
  • cloud_ssd: standard SSD.
  • cloud_essd: enhanced SSD (ESSD).
  • local_ssd_pro: I/O-intensive local disk.
  • local_hdd_pro: throughput-intensive local disk.
  • ephemeral: retired local disk.
  • ephemeral_ssd: retired local SSD.
DeviceType String data

Jenis disk. Nilai yang valid:

  • system: system disk.
  • data: data disk.
ReleaseTime String 2019-11-30T06:32:31Z

Waktu disk dilepas. Waktu mengikuti standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

HostType String ddh

Jenis host. Nilai yang valid:

  • ddh: Dedicated Host.
  • managehost: mesin fisik dalam smart hosting pool.
HostId String dh-bp1ewce1gk3iwv2****

ID host.

MigrationOptions Array of String MigrationPlan

Solusi migrasi instans. Nilai yang valid: MigrationPlan, yang menunjukkan bahwa instans hanya dapat dimigrasikan dengan menggunakan rencana migrasi.

OnlineRepairPolicy String IsolateOnly

Kebijakan perbaikan online untuk disk yang rusak. Nilai yang valid: IsolateOnly, yang menunjukkan bahwa disk yang rusak diisolasi tetapi tidak diperbaiki.

Rack String A01

Nomor rak cloud box.

PunishType String ecs_message_alert

Jenis sanksi.

PunishDomain String 1228.test.com

Nama domain ilegal.

PunishUrl String http://1228.test.com/1

URL ilegal.

Code String PR111

Kode pelanggaran keamanan.

CanAccept String true

Menunjukkan apakah event dapat ditangani.

ResponseResult String true

Hasil respons event. Nilai yang valid:

  • true: Event telah ditangani.
  • false: Gagal menangani event.

Contoh

Contoh permintaan

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>

Contoh respons sukses

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

Kode kesalahan

Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
403 InvalidParameter %s Parameter tidak valid.
403 EventIdLimitExceeded %s Lebih dari 100 ID event ditentukan.
403 InvalidParameter.TimeEndBeforeStart %s Parameter tidak valid. Pastikan waktu akhir lebih lambat dari waktu mulai.
403 OperationDenied.NotInWhiteList %s Anda tidak diizinkan melakukan operasi ini. Coba lagi setelah Anda mendapatkan izin.
404 MissingParameter %s Parameter tidak ditentukan.

Untuk daftar kode kesalahan, lihat Service error codes.