Elastic Compute Service:Berlangganan event Cloud Assistant

Deskripsi event

Perintah dan skrip memerlukan waktu untuk dieksekusi. Event status tugas Cloud Assistant membantu Anda melacak penyelesaian tugas. Anda dapat menggunakan event ini untuk tujuan berikut:

• Menerima notifikasi saat tugas Cloud Assistant gagal atau selesai. Notifikasi ini dapat digunakan untuk peringatan atau tindakan lanjutan.

• Polling menghabiskan kuota panggilan API Anda. Untuk menghindarinya, gunakan langganan event sebagai gantinya.

• Cegah gangguan akibat rilis aplikasi, yang dapat terjadi selama proses polling panjang. Penggunaan event menyederhanakan alur kerja Anda.

Kondisi pemicu dan batasan

Kondisi pemicu: Saat Anda memanggil operasi RunCommand atau InvokeCommand untuk menjalankan tugas, Cloud Assistant memantau status tugas tersebut. Event status tugas dikirim saat tugas selesai.

Batasan:

• Event status tugas Cloud Assistant hanya dikirim saat tugas pada instans ECS memasuki salah satu status akhir berikut (InvocationStatus):

  • Aborted: Tugas gagal dikirim.

  • Success: Tugas berhasil.

  • Failed: Tugas gagal.

  • Invalid: Konten tugas tidak valid.

  • Timeout: Waktu eksekusi tugas habis.

  • Cancelled: Tugas dibatalkan.

  • Terminated: Tugas dihentikan.

• Operasi DescribeInvocations dan DescribeInvocationResults mengembalikan data dalam format array<object>. Namun, event status tugas melaporkan status satu tugas pada satu instans, bukan beberapa tugas sekaligus.

Field event

Deskripsi event

Heartbeat Cloud Assistant merupakan salah satu cara untuk menentukan status sistem operasi instans. Heartbeat pertama menandakan kapan sistem operasi telah dimulai. Informasi ini dapat digunakan untuk memeriksa kesehatan instans atau menentukan waktu tepat untuk mengirim perintah Cloud Assistant.

Menggunakan event heartbeat pertama alih-alih melakukan polling operasi DescribeCloudAssistantStatus menyelesaikan permasalahan berikut:

• Mem-polling DescribeCloudAssistantStatus untuk memeriksa apakah status telah berubah menjadi true cukup kompleks. Interval polling yang tidak tepat dapat menghasilkan terlalu banyak permintaan, sehingga memicu pembatasan kecepatan atau memberi beban pada sistem.

• Waktu startup sistem operasi instans dapat sangat bervariasi. Beberapa instans Windows bisa memakan waktu hingga 5 menit untuk dimulai, sehingga sulit mengontrol durasi total polling.

• Status yang dikembalikan oleh DescribeCloudAssistantStatus dapat mengalami keterlambatan. Terdapat jeda 2 menit antara saat heartbeat berhenti dan saat status berubah. Hal ini menyulitkan DescribeCloudAssistantStatus untuk mendeteksi restart instans.

Kondisi pemicu dan batasan

Kondisi pemicu: Saat Cloud Assistant melaporkan heartbeat, event heartbeat pertama dikirim jika terdeteksi bahwa ini adalah heartbeat pertama setelah client Cloud Assistant dimulai.

Batasan versi Cloud Assistant:

• Instans Windows: Versi Cloud Assistant Agent harus lebih baru dari 1.0.0.149.

• Instans Linux: Versi Cloud Assistant Agent harus lebih baru dari 1.0.2.569.

Versi Cloud Assistant yang lebih lama tidak melaporkan heartbeat setiap menit atau tidak melaporkan field indeks. Akibatnya, versi tersebut tidak dapat mengidentifikasi secara akurat heartbeat pertama setelah startup. Versi lama ini tidak didukung.

Field event

Deskripsi event

• Saat Anda menjalankan perintah, maksimal 24 KB output perintah disimpan. Output yang melebihi batas ini akan dipotong.

• Jika Anda ingin mendapatkan output lengkap atau menyimpan output secara persisten, Anda dapat mengonfigurasi agar output dikirimkan ke path Object Storage Service (OSS) saat eksekusi perintah mencapai status akhir.

• Anda dapat menggunakan event ini untuk tujuan berikut:

  • Menerima notifikasi dan detail tentang pengiriman output. Saat Anda menerima notifikasi sukses, Anda dapat mengunduh file output dari Bucket OSS yang sesuai. Hal ini menghindari polling operasi DescribeInvocations untuk mendapatkan hasil dan meningkatkan efisiensi.

  • Saat pengiriman gagal, Anda dapat memperoleh alasan kegagalan secara detail dari event tersebut.

Kondisi pemicu dan batasan

Kondisi pemicu: Saat Anda menggunakan RunCommand atau InvokeCommand untuk menjalankan tugas dan menentukan parameter OssOutputDelivery yang valid, event ini dikirim saat tugas mencapai status akhir.

Batasan:

• Event dikirim hanya saat tugas pada instans memasuki salah satu status akhir berikut (InvocationStatus):

  • Aborted: Tugas gagal dikirim.

  • Success: Tugas berhasil.

  • Failed: Tugas gagal.

  • Invalid: Konten tugas tidak valid.

  • Timeout: Waktu eksekusi tugas habis.

  • Cancelled: Tugas dibatalkan.

  • Terminated: Tugas dihentikan.

Batasan versi Cloud Assistant:

• Instans Windows: Versi Cloud Assistant Agent harus lebih baru dari 2.1.4.1007.

• Instans Linux: Versi Cloud Assistant Agent harus lebih baru dari 2.2.4.1007.

Field event

Deskripsi event

• Cloud Assistant Agent secara otomatis memeriksa pembaruan versi setiap 30 menit secara default.

• Berlangganan event notifikasi kegagalan upgrade untuk segera mengetahui alasan dan solusi kegagalan, sehingga mempermudah troubleshooting.

Deskripsi field event

Deskripsi kode kesalahan

Kode kesalahan memiliki awalan AgentUpdateFailure:. Tabel berikut menjelaskan kode kesalahan tersebut.

Contoh JSON event

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2026-02-28T03:30:00+08:00",
    "type": "ecs:CloudAssistant:UpdateFailed",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2026-02-28T03:30:01Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "instanceId": "i-bp114***************",
        "currentVersion": "2.2.3.529",
        "expectedVersion": "2.2.4.1007",
        "errorCode": "AgentUpdateFailure:DownloadPackageFailed:NetworkTimeout",
        "errorInfo": "The aliyun service network is blocked.",
        "occurrenceTime": "2026-02-28T03:30:00Z"
    }
}

Deskripsi event

• Cloud Assistant Agent secara otomatis memeriksa pembaruan versi setiap 30 menit secara default.

• Berlangganan event notifikasi keberhasilan upgrade untuk tetap mengetahui status upgrade, sehingga mempermudah troubleshooting.

Deskripsi field event

Contoh JSON event

{
    "id": "f1e2d3c4-b5a6-7890-abcd-123456****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2026-02-28T03:30:00+08:00",
    "type": "ecs:CloudAssistant:UpdateCompleted",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2026-02-28T03:30:01Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "instanceId": "i-bp114***************",
        "currentVersion": "2.2.4.1007",
        "occurrenceTime": "2026-02-28T03:30:00Z"
    }
}