You can subscribe to notifications for IP address assignment events and IP address reclamation events.
Events
The following IP address event notifications are supported:
The private IPv4 or IPv6 address assignment events and reclamation events that are generated in the following scenarios are not displayed in the IP address event notifications, but are displayed in the notifications for elastic network interface (ENI) events and vSwitch events. For more information, see ENI operation event notifications and vSwitch event notifications.
Scenarios in which IP address events are displayed in ENI event notifications: An ENI is created or deleted.
Scenarios in which IP address events are displayed in vSwitch event notifications:
An Elastic Compute Service (ECS) instance is migrated from the classic network to a virtual private cloud (VPC).
The instance type of an ECS instance is changed across zones.
The VPC or vSwitch of an ECS instance is changed.
An ECS instance is transferred from one account to another account.
Notifications for private IPv4 address assignment events
When a secondary private IPv4 address is assigned to a primary ENI, a primary private IPv4 address is assigned to a secondary ENI, or a secondary private IPv4 address is assigned to a secondary ENI, a notification is sent for the IPv4 address assignment event to notify you of the details of the private IPv4 address. The following sample code provides an example of a notification for an IPv4 address assignment event:
{
"id":"2256A988-0B26-4E2B-820A-8B********A5",
"product":"ECS",
"resourceId":"acs:ecs:cn-hangzhou:169070********30:eni/eni-8vb1qo********cdeg2n",
"level":"INFO",
"name":"NetworkInterface:PrivateIPAssigned",
"userId":"169070********30",
"eventTime":"20230409T121826.922+0800",
"regionId":"cn-hangzhou",
"content":{
"eniId":"eni-8vb1qo********cdeg2n",
"primaryPrivateIp":"192.168.XX.XX",
"secondaryPrivateIps":["192.168.XX.XX"],
"ipv4Prefixes":["192.168.XX.XX/14"]
}
}The following table describes the fields that are contained in the content parameter.
Field | Description | Example |
eniId | The ID of the ENI. | eni-8vb1qotfplofaxcd**** |
primaryPrivateIp | The primary private IP address. | 192.168.XX.XX |
secondaryPrivateIps | The secondary private IP addresses. | ["192.168.XX.XX"] |
ipv4Prefixes | The secondary private IP prefixes. | ["192.168.XX.XX/14"] |
Notifications for private IPv4 address reclamation events
When a secondary private IPv4 address is reclaimed from a primary ENI, a primary private IPv4 address is reclaimed from a secondary ENI, or a secondary private IPv4 address is reclaimed from a secondary ENI, a notification is sent for the IPv4 address reclamation event to notify you of the details of the private IPv4 address. The following sample code provides an example of a notification for an IPv4 address reclamation event:
{
"id":"2256A988-0B26-4E2B-820A-8B********A5",
"product":"ECS",
"resourceId":"acs:ecs:cn-hangzhou:169070********30:eni/eni-8vb1qo********cdeg2n",
"level":"INFO",
"name":"NetworkInterface:PrivateIPUnassigned",
"userId":"169070********30",
"eventTime":"20230409T121826.922+0800",
"regionId":"cn-hangzhou",
"content":{
"eniId":"eni-8vb1qo********cdeg2n",
"primaryPrivateIp":"192.168.XX.XX",
"secondaryPrivateIps":["192.168.XX.XX"],
"ipv4Prefixes":["192.168.XX.XX/14"]
}
}The following table describes the fields that are contained in the content parameter.
Field | Description | Example |
eniId | The ID of the ENI. | eni-8vb1qotfplofaxcd**** |
primaryPrivateIp | The primary private IP address. | 192.168.XX.XX |
secondaryPrivateIps | The secondary private IP addresses. | ["192.168.XX.XX"] |
ipv4Prefixes | The secondary private IP prefixes. | ["192.168.XX.XX/14"] |
Notifications for private IPv6 address assignment events
When a private IPv6 address is assigned to an ENI, a notification is sent for the IPv6 address assignment event to notify you of the details of the private IPv6 address. The following sample code provides an example of a notification for an IPv6 address assignment event:
{
"id":"2256A988-0B26-4E2B-820A-8B********A5",
"product":"ECS",
"resourceId":"acs:ecs:cn-hangzhou:169070********30:eni/eni-8vb1qo********cdeg2n",
"level":"INFO",
"name":"NetworkInterface:PrivateIPv6Assigned",
"userId":"169070********30",
"eventTime":"20230409T121826.922+0800",
"regionId":"cn-hangzhou",
"content":{
"eniId":"eni-8vb1qo********cdeg2n",
"ipv6s":"2001:DB8:XXXX:23:8:800:200C:417A",
"ipv6Prefixes":["2001:DB8::/32"]
}
}The following table describes the fields that are contained in the content parameter.
Field | Description | Example |
eniId | The ID of the ENI. | eni-8vb1qotfplofaxcd**** |
ipv6s | The IPv6 addresses. | ["2001:DB8:XXXX:23:8:800:200C:417A"] |
ipv6Prefixes | The IPv6 prefixes. | ["2001:DB8::/32"] |
Notifications for private IPv6 address reclamation events
When a private IPv6 address is reclaimed from an ENI, a notification is sent for the IPv6 address reclamation event to notify you of the details of the private IPv6 address. The following sample code provides an example of a notification for an IPv6 address reclamation event:
{
"id":"2256A988-0B26-4E2B-820A-8B********A5",
"product":"ECS",
"resourceId":"acs:ecs:cn-hangzhou:169070********30:eni/eni-8vb1qo********cdeg2n",
"level":"INFO",
"name":"NetworkInterface:PrivateIPv6Unassigned",
"userId":"169070********30",
"eventTime":"20230409T121826.922+0800",
"regionId":"cn-hangzhou",
"content":{
"eniId":"eni-8vb1qo********cdeg2n",
"ipv6s":"2001:DB8:XXXX:23:8:800:200C:417A",
"ipv6Prefixes":["2001:DB8::/32"]
}
}The following table describes the fields that are contained in the content parameter.
Field | Description | Example |
eniId | The ID of the ENI. | eni-8vb1qotfplofaxcd**** |
ipv6s | The IPv6 addresses. | ["2001:DB8:XXXX:23:8:800:200C:417A"] |
ipv6Prefixes | The IPv6 prefixes. | ["2001:DB8::/32"] |