All Products
Search
Document Center

Elastic Compute Service:ENI event notifications

Last Updated:Jul 17, 2026

Receive event notifications when ENI create, delete, attach, or detach operations complete.

ENI operation completion events

An ENI operation completion event requires all these conditions:

  • The ENI operation completion event feature is in invitational preview.

  • The operation object is a secondary ENI.

    ENIs are classified as primary and secondary. Events are generated only for secondary ENI operations. See Overview of ENIs.

  • The operation request succeeds.

    An event is generated only when the request succeeds without errors. For example, each ECS instance has an ENI attachment limit. If you exceed this limit, the operation fails with an error in the ECS console and no event is generated. The error code is EniPerInstanceLimitExceeded.

When an ENI operation completes, an event notification is sent to the user who initiated it.

  • If the ENI is a managed ENI, the event notification is sent to the Alibaba Cloud service that initiated the operation.

  • If the ENI is a standard ENI, the notification is sent to the user who initiated the operation, such as attaching, detaching, or deleting the ENI.

Set up ENI operation completion event notifications in EventBridge and Cloud Monitor to receive results by email or DingTalk chatbot. Use notification content to retrieve ENI information and automate processing. See Subscribe to ECS system event notifications and Elastic Compute Service events.

Example ENI operation completion event in JSON format:

{
    "id":"2256A988-0B26-4E2B-820A-8B********A5",
    "product":"ECS",
    "resourceId":"acs:ecs:cn-hangzhou:169070********30:eni/eni-8vb1qo********cdeg2n",
    "level":"INFO",
    "name":"NetworkInterface:NetworkInterfaceOperateCompleted",
    "userId":"169070********30",
    "eventTime":"20190409T121826.922+0800",
    "regionId":"cn-hangzhou",
    "content":{
        "eniId":"eni-8vb1qo********cdeg2n",
        "operation":"AttachNetworkInterface",
        "eniStatus":"InUse",
        "result":"success",
        "requestId":"59701492-A8F2-3375-B0B9-D9********27",
        "primaryPrivateIp": "192.168.XX.XX",
        "secondaryPrivateIps": ["192.168.XX.XX","192.168.XX.XX"],
        "ipv4Prefixes": ["192.168.XX.XX/24"],
        "ipv6s": ["2001:DB8:XXXX:23:8:800:200C:417A"],
        "ipv6Prefixes": ["2001:DB8::/32"]
    }
}

Fields in the `content` object:

Field Name

Description

Example

eniId

ENI ID.

eni-8vb1qo********cdeg2n

operation

Operation type. Valid values:

  • CreateNetworkInterface: Create an ENI.

  • AttachNetworkInterface: Attach an ENI.

  • DetachNetworkInterface: Detach an ENI.

  • DeleteNetworkInterface: Delete an ENI.

AttachNetworkInterface

eniStatus

ENI state. Valid values:

  • Available: The ENI can be attached to an instance.

  • InUse: Attached to an instance.

  • Detaching: Being detached from an instance.

  • Deleting: Being deleted.

  • Deleted: The ENI has been deleted.

  • CreateFailed: Creation failed.

InUse

result

Operation result. Valid values:

  • success: Operation succeeded. Event level: INFO.

  • failed: Operation failed. Event level: WARN.

success

requestId

Request ID of the operation.

59701492-A8F2-3375-B0B9-D9********27

primaryPrivateIp

Primary private IP address.

192.168.XX.XX

secondaryPrivateIps

Secondary private IP addresses.

["192.168.XX.XX"]

ipv4Prefixes

IPv4 prefixes.

["192.168.XX.XX/14"]

ipv6s

IPv6 addresses.

2001:DB8:XXXX:23:8:800:200C:417A

ipv6Prefixes

IPv6 prefixes.

["2001:DB8::/32"]