All Products
Search
Document Center

Elastic Compute Service:DescribeInstanceHistoryEvents

Last Updated:Jun 30, 2026

Mengkueri informasi peristiwa sistem untuk Instans tertentu dengan memanggil operasi DescribeInstanceHistoryEvents. Anda dapat menentukan parameter seperti InstanceId dan EventType. Secara default, operasi ini mengkueri peristiwa sistem historis dalam status tidak aktif.

Deskripsi operasi

  • Anda dapat mengkueri peristiwa sistem historis yang telah selesai dari 30 hari terakhir. Tidak ada batas waktu untuk mengkueri peristiwa sistem yang belum selesai.

  • Jika EventCycleStatus maupun InstanceEventCycleStatus tidak ditentukan, hasil kueri hanya mencakup peristiwa sistem dalam status Avoided, Executed, Canceled, dan Failed secara default.

  • Dengan menentukan parameter InstanceEventCycleStatus, Anda juga dapat mengkueri peristiwa sistem dalam status Scheduled, Executing, dan Inquiring.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:DescribeInstanceHistoryEvents

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah Sumber daya. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

cn-hangzhou

RegionId

string

Yes

ID wilayah Sumber daya. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

cn-hangzhou

InstanceId

string

No

ID Instans. Jika Anda tidak menentukan ID Instans, peristiwa sistem dari semua Instans di wilayah yang ditentukan akan dikueri.

i-uf678mass4zvr9n1****

EventCycleStatus

string

No

Status siklus hidup peristiwa sistem. EventCycleStatus hanya berlaku jika InstanceEventCycleStatus.N tidak ditentukan. Nilai valid:

  • Scheduled: Peristiwa menunggu untuk dieksekusi.

  • Avoided: Peristiwa telah dihindari.

  • Executing: Peristiwa sedang dieksekusi.

  • Executed: Peristiwa telah dieksekusi.

  • Canceled: Peristiwa telah dibatalkan.

  • Failed: Eksekusi peristiwa gagal.

  • Inquiring: Peristiwa sedang ditanyakan.

Executed

EventType

string

No

Tipe peristiwa sistem. EventType hanya berlaku jika InstanceEventType.N tidak ditentukan. Nilai valid:

  • SystemMaintenance.Reboot: Instans dimulai ulang karena pemeliharaan sistem.

  • SystemMaintenance.Redeploy: Instans dideploy ulang karena pemeliharaan sistem.

  • SystemFailure.Reboot: Instans dimulai ulang karena error sistem.

  • SystemFailure.Redeploy: Instans dideploy ulang karena error sistem.

  • SystemFailure.Delete: Instans dihapus karena kegagalan pembuatan Instans.

  • InstanceFailure.Reboot: Instans dimulai ulang karena error Instans.

  • InstanceExpiration.Stop: Instans dihentikan karena masa langganan berakhir.

  • InstanceExpiration.Delete: Instans dihapus karena masa langganan berakhir.

  • AccountUnbalanced.Stop: Instans pay-as-you-go dihentikan karena pembayaran tertunda.

  • AccountUnbalanced.Delete: Instans pay-as-you-go dihapus karena pembayaran tertunda.

Catatan

Untuk informasi lebih lanjut mengenai tipe peristiwa, lihat Ikhtisar peristiwa sistem. Nilai parameter ini harus berupa peristiwa sistem Instans, bukan peristiwa sistem disk.

SystemMaintenance.Reboot

NotBefore.Start

string

No

Awal rentang waktu saat peristiwa sistem dijadwalkan untuk dieksekusi. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

2017-11-30T06:32:31Z

NotBefore.End

string

No

Akhir rentang waktu saat peristiwa sistem dijadwalkan untuk dieksekusi. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

2017-12-01T06:32:31Z

EventPublishTime.Start

string

No

Awal rentang waktu saat peristiwa sistem diterbitkan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

2017-11-30T06:32:31Z

EventPublishTime.End

string

No

Akhir rentang waktu saat peristiwa sistem diterbitkan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

2017-12-01T06:32:31Z

ImpactLevel

string

No

Catatan

Parameter ini belum tersedia.

null

PageNumber

integer

No

Catatan

Parameter ini akan dihapus. Gunakan MaxResults atau NextToken untuk kueri berhalaman sebagai gantinya.

1

PageSize

integer

No

Catatan

Parameter ini akan dihapus. Gunakan MaxResults atau NextToken untuk kueri berhalaman sebagai gantinya.

10

ResourceType

string

No

Tipe resource. Nilai valid:

  • instance: Instans ECS.

  • ddh: host khusus.

  • managedhost: mesin fisik dalam kolam sumber daya terkelola penuh cerdas.

Nilai default: instance.

instance

EventId

array

No

Satu atau beberapa ID peristiwa sistem. Nilai valid untuk N: 1 hingga 100. Tentukan beberapa nilai dalam format daftar berulang.

e-uf64yvznlao4jl2c****

string

No

Satu atau beberapa ID peristiwa sistem. Nilai valid untuk N: 1 hingga 100. Tentukan beberapa nilai dalam format daftar berulang.

e-uf64yvznlao4jl2c****

InstanceEventCycleStatus

array

No

Satu atau beberapa status siklus hidup peristiwa sistem. Nilai valid untuk N: 1 hingga 7. Tentukan beberapa nilai dalam format daftar berulang. Nilai valid:

  • Scheduled: Peristiwa menunggu untuk dieksekusi.

  • Avoided: Peristiwa telah dihindari.

  • Executing: Peristiwa sedang dieksekusi.

  • Executed: Peristiwa telah dieksekusi.

  • Canceled: Peristiwa telah dibatalkan.

  • Failed: Eksekusi peristiwa gagal.

  • Inquiring: Peristiwa sedang ditanyakan.

Executed

string

No

Satu atau beberapa status siklus hidup peristiwa sistem. Nilai valid untuk N: 1 hingga 7. Tentukan beberapa nilai dalam format daftar berulang. Nilai valid:

  • Scheduled: Peristiwa menunggu untuk dieksekusi.

  • Avoided: Peristiwa telah dihindari.

  • Executing: Peristiwa sedang dieksekusi.

  • Executed: Peristiwa telah dieksekusi.

  • Canceled: Peristiwa telah dibatalkan.

  • Failed: Eksekusi peristiwa gagal.

  • Inquiring: Peristiwa sedang ditanyakan.

Executed

InstanceEventType

array

No

Satu atau beberapa tipe peristiwa sistem. Nilai valid untuk N: 1 hingga 30. Tentukan beberapa nilai dalam format daftar berulang. Nilai valid:

  • SystemMaintenance.Reboot: Instans dimulai ulang karena pemeliharaan sistem.

  • SystemMaintenance.Redeploy: Instans dideploy ulang karena pemeliharaan sistem.

  • SystemFailure.Reboot: Instans dimulai ulang karena error sistem.

  • SystemFailure.Redeploy: Instans dideploy ulang karena error sistem.

  • SystemFailure.Delete: Instans dihapus karena kegagalan pembuatan Instans.

  • InstanceFailure.Reboot: Instans dimulai ulang karena error Instans.

  • InstanceExpiration.Stop: Instans dihentikan karena masa langganan berakhir.

  • InstanceExpiration.Delete: Instans dihapus karena masa langganan berakhir.

  • AccountUnbalanced.Stop: Instans pay-as-you-go dihentikan karena pembayaran tertunda.

  • AccountUnbalanced.Delete: Instans pay-as-you-go dihapus karena pembayaran tertunda.

Catatan

Untuk informasi lebih lanjut mengenai tipe peristiwa, lihat Ikhtisar peristiwa sistem. Nilai parameter ini harus berupa peristiwa sistem Instans, bukan peristiwa sistem disk.

SystemMaintenance.Reboot

string

No

Satu atau beberapa tipe peristiwa sistem. Nilai valid untuk N: 1 hingga 30. Tentukan beberapa nilai dalam format daftar berulang. Nilai valid:

  • SystemMaintenance.Reboot: Instans dimulai ulang karena pemeliharaan sistem.

  • SystemMaintenance.Redeploy: Instans dideploy ulang karena pemeliharaan sistem.

  • SystemFailure.Reboot: Instans dimulai ulang karena error sistem.

  • SystemFailure.Redeploy: Instans dideploy ulang karena error sistem.

  • SystemFailure.Delete: Instans dihapus karena kegagalan pembuatan Instans.

  • InstanceFailure.Reboot: Instans dimulai ulang karena error Instans.

  • InstanceExpiration.Stop: Instans dihentikan karena masa langganan berakhir.

  • InstanceExpiration.Delete: Instans dihapus karena masa langganan berakhir.

  • AccountUnbalanced.Stop: Instans pay-as-you-go dihentikan karena pembayaran tertunda.

  • AccountUnbalanced.Delete: Instans pay-as-you-go dihapus karena pembayaran tertunda.

Catatan

Untuk informasi lebih lanjut mengenai tipe peristiwa, lihat Ikhtisar peristiwa sistem. Nilai parameter ini harus berupa peristiwa sistem Instans, bukan peristiwa sistem disk.

SystemMaintenance.Reboot

ResourceId

array

No

Satu atau beberapa ID resource. Nilai valid untuk N: 1 hingga 100. Tentukan beberapa nilai dalam format daftar berulang. Nilai valid:

  • Saat ResourceType=instance, ID resource adalah ID Instans ECS.

  • Saat ResourceType=ddh, ID resource adalah ID host khusus.

  • Saat ResourceType=managedhost, ID resource adalah ID mesin fisik dalam kolam sumber daya terkelola penuh cerdas.

Jika Anda tidak menentukan parameter ini, peristiwa sistem dari semua resource dengan tipe resource (ResourceType) yang ditentukan di wilayah (RegionId) yang ditentukan akan dikueri.

Catatan

Gunakan ResourceId.N untuk menentukan satu atau beberapa ID resource. Jika Anda menentukan ResourceId.N dan InstanceId, ResourceId.N akan diutamakan secara default.

i-uf678mass4zvr9n1****

string

No

Satu atau beberapa ID resource. Nilai valid untuk N: 1 hingga 100. Tentukan beberapa nilai dalam format daftar berulang. Nilai valid:

  • Saat ResourceType=instance, ID resource adalah ID Instans ECS.

  • Saat ResourceType=ddh, ID resource adalah ID host khusus.

  • Saat ResourceType=managedhost, ID resource adalah ID mesin fisik dalam kolam sumber daya terkelola penuh cerdas.

Jika Anda tidak menentukan parameter ini, peristiwa sistem dari semua resource dengan tipe resource (ResourceType) yang ditentukan di wilayah (RegionId) yang ditentukan akan dikueri.

Catatan

Gunakan ResourceId.N untuk menentukan satu atau beberapa ID resource. Jika Anda menentukan ResourceId.N dan InstanceId, ResourceId.N akan diutamakan secara default.

i-uf678mass4zvr9n1****

Tag

array<object>

No

Daftar tag yang didukung oleh peristiwa sistem.

object

No

Daftar tag yang didukung oleh peristiwa sistem.

Key

string

No

Kunci tag Sumber daya.

TestKey

Value

string

No

Nilai tag Sumber daya.

TestValue

ResourceGroupId

string

No

ID kelompok sumber daya tempat resource berada.

rg-bp67acfmxazb4p****

NextToken

string

No

Token kueri. Atur parameter ini ke nilai NextToken yang dikembalikan dalam pemanggilan API sebelumnya.

f1c9fa9de5752***

MaxResults

integer

No

Jumlah entri maksimum per halaman untuk kueri berhalaman. Nilai valid: 10 hingga 100.

Nilai default:

  • Saat nilai pengaturan lebih besar dari 0 tetapi kurang dari 10, nilai default adalah 10.

  • Saat nilai pengaturan lebih besar dari 100, nilai default adalah 100.

100

Elemen respons

Element

Type

Description

Example

object

Informasi peristiwa sistem dari Instans yang dikueri.

PageSize

integer

Jumlah entri per halaman sesuai yang ditentukan di permintaan.

Catatan
  • Saat Anda menggunakan parameter MaxResults dan NextToken untuk kueri berhalaman, nilai parameter PageSize yang dikembalikan tidak memiliki arti.

  • Parameter ini akan dihapus. Gunakan NextToken dan MaxResults untuk kueri berhalaman sebagai gantinya.

10

RequestId

string

ID permintaan.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

PageNumber

integer

Nomor halaman daftar peristiwa Instans.

Catatan
  • Saat Anda menggunakan parameter MaxResults dan NextToken untuk kueri berhalaman, nilai parameter PageNumber yang dikembalikan tidak memiliki arti.

  • Parameter ini akan dihapus. Gunakan NextToken dan MaxResults untuk kueri berhalaman sebagai gantinya.

1

TotalCount

integer

Jumlah total peristiwa Instans.

Catatan

Saat Anda menggunakan parameter MaxResults dan NextToken untuk kueri berhalaman, nilai parameter TotalCount yang dikembalikan tidak memiliki arti.

2

InstanceSystemEventSet

object

InstanceSystemEventType

array<object>

Array peristiwa sistem Instans historis.

array<object>

Peristiwa sistem Instans historis.

EventId

string

ID peristiwa sistem.

e-uf64yvznlao4jl2c****

EventPublishTime

string

Waktu saat peristiwa sistem diterbitkan. Waktu ditampilkan dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu dalam UTC.

2017-11-30T06:32:31Z

EventFinishTime

string

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

2017-12-01T06:35:31Z

ResourceType

string

Tipe resource. Nilai valid:

  • instance: Instans ECS.

  • ddh: Host khusus.

  • managedhost: Mesin fisik dalam kolam sumber daya terkelola penuh yang cerdas.

instance

ImpactLevel

string

Tingkat dampak.

100

NotBefore

string

Waktu eksekusi terjadwal peristiwa sistem. Waktu ditampilkan dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu dalam UTC.

2017-12-06T00:00:00Z

InstanceId

string

ID instans

i-uf678mass4zvr9n1****

Reason

string

Alasan terjadinya peristiwa sistem.

System maintenance is scheduled due to ***.

EventType

object

Tipe peristiwa sistem.

Name

string

Nama tipe peristiwa sistem.

InstanceExpiration.Stop

Code

integer

Kode tipe peristiwa sistem.

34

EventCycleStatus

object

Status siklus hidup peristiwa sistem.

Name

string

Nama status peristiwa sistem.

Executed

Code

integer

Kode status peristiwa sistem.

0

ExtendedAttribute

object

Atribut tambahan peristiwa.

Device

string

Nama perangkat disk lokal.

/dev/vda

DiskId

string

ID disk lokal.

d-diskid1

InactiveDisks

object

InactiveDisk

array<object>

Daftar disk tidak aktif atau disk lokal yang telah dilepas tetapi belum dibersihkan.

object

Informasi mengenai disk tidak aktif atau disk lokal yang telah dilepas tetapi belum dibersihkan.

CreationTime

string

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

2018-11-30T06:32:31Z

DeviceSize

string

Ukuran disk atau disk lokal. Unit: GiB.

80

DeviceCategory

string

Kategori disk atau disk lokal. Nilai valid:

  • cloud: disk dasar.

  • cloud_efficiency: disk ultra.

  • cloud_ssd: SSD standar.

  • cloud_essd: SSD Perusahaan (ESSD).

  • local_ssd_pro: disk lokal intensif I/O.

  • local_hdd_pro: disk lokal intensif throughput.

  • ephemeral: (pensiun) disk lokal.

  • ephemeral_ssd: (pensiun) SSD lokal.

cloud_efficiency

DeviceType

string

Tipe disk atau disk lokal. Nilai valid:

  • system: disk sistem.

  • data: disk data.

data

ReleaseTime

string

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

2019-11-30T06:32:31Z

HostType

string

Tipe host. Nilai valid:

  • ddh: Host khusus.

  • managedhost: Mesin fisik dalam kolam sumber daya terkelola penuh yang cerdas.

ddh

HostId

string

ID host.

dh-bp1ewce1gk3iwv2****

MigrationOptions

object

MigrationOption

array

Opsi migrasi instans. Saat ini, hanya MigrationOptions (migrasi menggunakan rencana migrasi) yang didukung.

string

Opsi migrasi instans. Saat ini, hanya MigrationPlan (migrasi menggunakan rencana migrasi) yang didukung.

MigrationPlan

OnlineRepairPolicy

string

Kebijakan perbaikan daring untuk disk yang rusak. Nilai valid: IsolateOnly, yang menunjukkan bahwa hanya mengisolasi disk yang rusak yang didukung dan memperbaiki disk yang rusak tidak didukung.

IsolateOnly

Rack

string

Nomor rak CloudBox.

A01

PunishType

string

Tipe penalti.

ecs_message_alert

PunishDomain

string

Nama domain yang melanggar kebijakan keamanan.

1228.test.com

PunishUrl

string

URL yang melanggar kebijakan keamanan.

http://1228.test.com/1

Code

string

Kode pelanggaran keamanan.

PR111

CanAccept

string

Apakah peristiwa dapat ditangani.

true

ResponseResult

string

Hasil tanggapan peristiwa. Nilai valid:

  • true: Tanggapan peristiwa berhasil.

  • false: Tanggapan peristiwa gagal.

true

MetricValue

string

Nilai data deret waktu.

18000

MetricName

string

Nama data deret waktu.

in_mbps

InitialNotBefore

string

2026-06-22T00:00:00Z

ReasonCode

string

Kode kategori alasan terjadinya peristiwa sistem.

VPCMigrationEcs

NextToken

string

Token kueri yang dikembalikan dalam pemanggilan ini.

Catatan

Saat Anda menggunakan parameter MaxResults dan NextToken untuk kueri berhalaman dan NextToken tidak dikembalikan, tidak ada data lagi yang tersedia.

f1c9fa9de5752***

Contoh

Respons sukses

JSONformat

{
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 2,
  "InstanceSystemEventSet": {
    "InstanceSystemEventType": [
      {
        "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": {
            "InactiveDisk": [
              {
                "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": {
            "MigrationOption": [
              "MigrationPlan"
            ]
          },
          "OnlineRepairPolicy": "IsolateOnly",
          "Rack": "A01",
          "PunishType": "ecs_message_alert",
          "PunishDomain": "1228.test.com",
          "PunishUrl": "http://1228.test.com/1",
          "Code": "PR111",
          "CanAccept": "true",
          "ResponseResult": "true",
          "MetricValue": "18000",
          "MetricName": "in_mbps",
          "InitialNotBefore": "2026-06-22T00:00:00Z"
        },
        "ReasonCode": "VPCMigrationEcs"
      }
    ]
  },
  "NextToken": "f1c9fa9de5752***"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

403 InvalidParameter %s
403 EventIdLimitExceeded %s
403 InvalidParameter.TimeEndBeforeStart %s
403 OperationDenied.NotInWhiteList %s
404 MissingParameter %s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.