ECS は、Elastic Network Interface (ENI) へのプライベート IP アドレスの割り当ておよび回収時に通知を生成します。これらの通知を購読することで、自動化、監査、構成の同期などに活用し、IP アドレスの変更を追跡できます。
イベントタイプ
以下の 4 種類のイベントがサポートされています:
| イベント | name 値 | トリガー |
|---|---|---|
| プライベート IPv4 アドレスの割り当て | NetworkInterface:PrivateIPAssigned | ENI へプライベート IPv4 アドレスが割り当てられたとき |
| プライベート IPv4 アドレスの回収 | NetworkInterface:PrivateIPUnassigned | プライマリ ENI またはセカンダリ ENI からプライベート IPv4 アドレスが回収されたとき |
| プライベート IPv6 アドレスの割り当て | NetworkInterface:PrivateIPv6Assigned | ENI へプライベート IPv6 アドレスが割り当てられたとき |
| プライベート IPv6 アドレスの回収 | NetworkInterface:PrivateIPv6Unassigned | ENI からプライベート IPv6 アドレスが回収されたとき |
name フィールドを使用してイベントタイプを識別し、アプリケーション内の適切な処理ロジックへルーティングしてください。
以下の操作によってトリガーされる IP アドレスの割り当ておよび回収イベントは、IP アドレス イベント通知ではなく、ENI イベント通知および vSwitch イベント通知として報告されます。詳細については、「ENI 操作イベント通知」および「vSwitch イベント通知」をご参照ください。
ENI イベント: ENI の作成、ENI の削除
vSwitch イベント:ECS インスタンスの仮想プライベートクラウド (VPC) の変更、ECS インスタンスのクラシックネットワークから VPC への移行、ゾーン間でのインスタンスタイプの変更、ECS インスタンスの vSwitch 変更(プライマリ ENI)
プライベート IPv4 アドレス割り当てイベントの通知
ENI へプライベート IPv4 アドレスが割り当てられると、name が NetworkInterface:PrivateIPAssigned に設定された通知が送信されます。
通知の例:
{
"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"]
}
}コンテンツ フィールド:
| フィールド | 説明 | 例 |
|---|---|---|
eniId | ENI の ID | eni-8vb1qotfplofaxcd**** |
primaryPrivateIp | プライマリプライベート IP アドレス | 192.168.XX.XX |
secondaryPrivateIps | セカンダリプライベート IP アドレス | ["192.168.XX.XX"] |
ipv4Prefixes | セカンダリプライベート IPv4 プレフィックス | ["192.168.XX.XX/14"] |
プライベート IPv4 アドレス回収イベントの通知
プライマリ ENI またはセカンダリ ENI からプライベート IPv4 アドレスが回収されると、name が NetworkInterface:PrivateIPUnassigned に設定された通知が送信されます。
通知の例:
{
"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"]
}
}content フィールド:
| フィールド | 説明 | 例 |
|---|---|---|
eniId | ENI の ID | eni-8vb1qotfplofaxcd**** |
primaryPrivateIp | プライマリプライベート IP アドレス | 192.168.XX.XX |
secondaryPrivateIps | セカンダリプライベート IP アドレス | ["192.168.XX.XX"] |
ipv4Prefixes | セカンダリプライベート IPv4 プレフィックス | ["192.168.XX.XX/14"] |
プライベート IPv6 アドレス割り当てイベントの通知
ENI へプライベート IPv6 アドレスが割り当てられると、name が NetworkInterface:PrivateIPv6Assigned に設定された通知が送信されます。
通知の例:
{
"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"]
}
}content フィールドの説明:
| フィールド | 説明 | 例 |
|---|---|---|
eniId | ENI の ID | eni-8vb1qotfplofaxcd**** |
ipv6s | IPv6 アドレス | ["2001:DB8:XXXX:23:8:800:200C:417A"] |
ipv6Prefixes | IPv6 プレフィックス | ["2001:DB8::/32"] |
プライベート IPv6 アドレス回収イベントの通知
ENI からプライベート IPv6 アドレスが回収されると、name が NetworkInterface:PrivateIPv6Unassigned に設定された通知が送信されます。
通知の例:
{
"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"]
}
}content フィールドの説明:
| フィールド | 説明 | 例 |
|---|---|---|
eniId | ENI の ID | eni-8vb1qotfplofaxcd**** |
ipv6s | IPv6 アドレス | ["2001:DB8:XXXX:23:8:800:200C:417A"] |
ipv6Prefixes | IPv6 プレフィックス | ["2001:DB8::/32"] |