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:
|
AttachNetworkInterface |
|
eniStatus |
ENI state. Valid values:
|
InUse |
|
result |
Operation result. Valid values:
|
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"] |