All Products
Search
Document Center

Elastic Compute Service:IP address event notifications

Last Updated:May 07, 2025

You can subscribe to notifications for IP address assignment events and IP address reclamation events.

Events

The following IP address event notifications are supported:

Note

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.

Notifications for private IPv4 address assignment events

When a private IPv4 address is assigned to an 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 private IPv4 address is reclaimed from a primary or 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"]