All Products
Search
Document Center

Elastic Compute Service:Overview of event notifications

Last Updated:Jan 30, 2024

This topic provides an overview of Elastic Compute Service (ECS) event notifications. Event notifications provide information about resource changes. Notifications can be sent for the following events: system events, including O&M events and exceptions, instance status changes, events in which data disks are attached or detached, and events in which snapshots are created. Event notifications allow you to configure message processing middleware for events to implement event-driven automated O&M in place of SDK polling.

Event notification name

After you configure notifications for events, you are notified when the events occur. The name field of a notification indicates the code name of the event. This field is in the <resource type>:<event>:<status> format.

  • <resource type>: the type of the ECS resource. Example values: Instance and Disk. Instance indicates ECS instances and Disk indicates Block Storage devices.

  • <event>: the name of the event. Example values: SystemMaintenance.Reboot, StateChange, PreemptibleInstanceInterruption, DiskOperationCompleted, and CreateSnapshotCompleted.

  • <status>: the status of the event. For information about the valid values of this field, see Overview.

    Note

    The <status> field is available only for system events that are related to instances and Block Storage devices.

Event notification format

After you configure event notifications, ECS notifies you based on the method that you specify. The following sample code provides an example of a non-customized event notification in the JSON format. This notification is sent for events in which the state of an ECS instance changes.

Note

If the notification method that you specify supports format conversion, the notification that you receive may be converted to other formats.

{
    "eventTime": "20181226T220114.058+0800",
    "id": "9435EAD6-3CF6-4494-8F7A-3A********77",
    "level": "INFO",
    "name": "Instance:StateChange",
    "product": "ECS",
    "regionId": "cn-hangzhou",
    "resourceId": "acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go",
    "userId": "169070********30",
    "ver": "1.0",
    "content": {
        "resourceId": "i-bp1ecr********5go2go",
        "resourceType": "ALIYUN::ECS::Instance",
        "state": "Stopping"
    }
}

The following table describes fixed top-level fields in a notification.

Field

Description

Example

id

The ID of the event.

9435EAD6-3CF6-4494-8F7A-3A********77

eventTime

The time when the event occurred. The time is displayed in UTC+8.

20181226T220114.058+0800

level

The level of the event. Valid values:

  • INFO

  • WARN

  • CRITICAL

INFO

name

The name of the event. For more information, see the Event notification name section.

Instance:StateChange

product

The name of the service. Set the value to ECS.

ECS

regionId

The ID of the region where the event occurred. For information about the valid values of this field, see Regions and zones.

cn-hangzhou

resourceId

The Alibaba Cloud Resource Name (ARN) of the resource.

acs:ecs:cn-hangzhou:169070********30:instance/i-bp1ecr********5go2go

userId

The ID of the Alibaba Cloud account.

169070********30

content

The event details. This field can contain one or more subfields. For more information about the subfields, see the following topics:

None