本文へスキップ

イベント

イベントストリームを使用して、アセットから特定のイベントおよびアクティビティデータをほぼリアルタイムで監視する。

ストリーミングネットワークデータには、次のイベントデータが含まれる。

  • ポート-アップ/ダウンイベント。

  • 接続-アップ/ダウンおよび属性変更イベント。

  • Fabric Cloud Routers：BGPセッションステータス、ルート集約ステート、およびルートフィルタステートイベント。

  • ネットワークエッジ仮想デバイス-アクセスコントロールリスト（ACL）、デバイス属性、リブート、およびデバイスリンクグループ（DLG）イベント。

  • プロジェクト-プロジェクトイベントデータには、プロジェクト内のすべてのアセットのライフサイクルステートイベントが含まれる。プロビジョニング、プロビジョニング解除、障害など、アセットのステータス変更が発生すると、イベントが送信される。ライフサイクルイベントは、

    • Fabricポート
    • Network Edge仮想デバイス
    • Fabric Cloud Router
    • Precision Time
    • インターネットアクセス
    • 仮想接続-ポートまたはクラウドルーターがA側である接続では、イベントデータのプロビジョニング/プロビジョニング解除を行うことができる。ポートからETreeへの接続、クラウドルーターから仮想デバイスへの接続、またはクラウドルーターからipwanへの接続では、障害イベントデータが使用できない。

  • 組織イベント-アクセスマネージャとリソースマネージャからのイベントで'ユーザーのロールの追加や削除など'組織内で発生する変更イベントを組織管理者に通知する

  • 会社プロファイル-プロファイル属性、タグ、およびライフサイクルイベント。

サポートされているイベントのリストを参照する。

イベント形式​

イベントCloudEvents仕様を使用して、すべてのイベントデータをフォーマットする。すべてのイベントデータスキーマとデータ型はGitHubリポジトリで公開されている。/equinix/equinix-cloudevents

イベントを見る​

カスタマーポータルでは、次のイベントを表示できる。

  • Fabricポート
  • Fabric Cloud Router
  • Precision Timeサービス
  • ポートまたはクラウドルータがA側である仮想接続。

  1. ［カスタマーポータル］>［Fabricダッシュボード］にログインします。

  2. YOUR_Port Inventory_、YOUR_Fabric Cloud Router Inventory_、YOUR_Precision Time Inventory_、またはYOUR_Connections Inventory_に移動する。

  3. ポート、クラウドルーター、Precision Timeサービス、または仮想接続を選択する。

  4. アセットの詳細ページで、_Events_をクリックする。

APIからイベントを表示する​

Equinix APIから個々のアセットのイベントを取得できる。

メモ

各呼び出しには、アセットの読み取り権限が必要である。現在、クラウドイベントコールでサポートされているアセットタイプは、ポート、接続、ルーター、メトロ、組織、プロジェクト、仮想デバイス、企業プロファイル。

およびの現在のページネーション制限は100に設定されている。GET /fabric/v4/{asset}/{assetId}/cloudevents``POST /fabric/v4/cloudevents/search

さらに、POST /fabric/v4/cloudevents/searchエンドポイントは、必須の第1レベルのリソースUUIDを持つことをサブジェクトに要求する。

イベントを取得​

アセットのCloud Eventsを取得するには、エンドポイントにリクエストを/fabric/v4/{asset}/{assetId}/cloudevents送信する。GETパスにアセットタイプとIDを指定する。オプションのAND toDateTimeクエリパラメータを使用して、fromDateTime結果を特定の期間に絞り込む。

cURLリクエストの例：

curl -X GET 'https://api.equinix.com/fabric/v4/routers/<routerId>/cloudevents?fromDateTime=2025-04-15T17:31:00.000Z&toDateTime=2025-05-15T17:31:00.000Z' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

応答の例：

{
    "pagination": {
        "offset": 0,
        "limit": 20,
        "total": 4,
        "next": null,
        "previous": null
    },
    "data": [
        {
            "specversion": "1.0",
            "source": "https://api.equinix.com/fabric/v4/events",
            "id": "7e5c0bbe-98e7-4486-b760-fdc39807da5e",
            "time": "2025-04-30T01:43:13Z",
            "type": "equinix.fabric.router.state.deprovisioned",
            "subject": "/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
            "dataschema": "https://equinix.github.io/equinix-cloudevents/jsonschema/equinix/fabric/v1/ChangeEvent.json",
            "datacontenttype": "application/json",
            "severitynumber": "9",
            "severitytext": "INFO",
            "equinixproject": "<projectId>",
            "authtype": "system",
            "authid": "equinix",
            "data": {
                "message": "router named FCR-NAME state changed to deprovisioned",
                "resource": {
                    "href": "https://api.equinix.com/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
                    "uuid": "89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
                    "type": "XF_ROUTER",
                    "name": "FCR-NAME",
                    "state": "DEPROVISIONED"
                },
                "auth": {
                    "type": "system",
                    "id": "equinix"
                }
            }
        },
        {
            "specversion": "1.0",
            "source": "https://api.equinix.com/fabric/v4/events",
            "id": "a6dc56f2-af4e-40c0-9910-4850459f8559",
            "time": "2025-04-30T01:43:11Z",
            "type": "equinix.fabric.router.state.deprovisioning",
            "subject": "/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
            "dataschema": "https://equinix.github.io/equinix-cloudevents/jsonschema/equinix/fabric/v1/ChangeEvent.json",
            "datacontenttype": "application/json",
            "severitynumber": "9",
            "severitytext": "INFO",
            "equinixproject": "<projectId>",
            "authtype": "user",
            "authid": "12345",
            "data": {
                "message": "router named FCR-NAME state changed to deprovisioning",
                "resource": {
                    "href": "https://api.equinix.com/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
                    "uuid": "89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
                    "type": "XF_ROUTER",
                    "name": "FCR-NAME",
                    "state": "DEPROVISIONING"
                },
                "auth": {
                    "type": "user",
                    "id": "12345",
                    "name": "user1 user1",
                    "email": "user1@test.com"
                }
            }
        },
        {
            "specversion": "1.0",
            "source": "https://api.equinix.com/fabric/v4/events",
            "id": "1e4b57d5-97e4-4370-b675-625cd0ed0a4e",
            "time": "2025-04-30T01:43:06Z",
            "type": "equinix.fabric.router.state.provisioned",
            "subject": "/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
            "dataschema": "https://equinix.github.io/equinix-cloudevents/jsonschema/equinix/fabric/v1/ChangeEvent.json",
            "datacontenttype": "application/json",
            "severitynumber": "9",
            "severitytext": "INFO",
            "equinixproject": "<projectId>",
            "authtype": "system",
            "authid": "equinix",
            "data": {
                "message": "Router named FCR-NAME successfully provisioned",
                "resource": {
                    "href": "https://api.equinix.com/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
                    "uuid": "89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
                    "type": "XF_ROUTER",
                    "name": "FCR-NAME",
                    "state": "PROVISIONED"
                },
                "auth": {
                    "type": "system",
                    "id": "equinix"
                }
            }
        },
        {
            "specversion": "1.0",
            "source": "https://api.equinix.com/fabric/v4/events",
            "id": "1aa36503-c8f8-4c9c-a52c-06ed67f92a2d",
            "time": "2025-04-30T01:43:05Z",
            "type": "equinix.fabric.router.state.provisioning",
            "subject": "/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
            "dataschema": "https://equinix.github.io/equinix-cloudevents/jsonschema/equinix/fabric/v1/ChangeEvent.json",
            "datacontenttype": "application/json",
            "severitynumber": "9",
            "severitytext": "INFO",
            "equinixproject": "<projectId>",
            "authtype": "user",
            "authid": "12345",
            "data": {
                "message": "router named FCR-NAME state changed to provisioning",
                "resource": {
                    "href": "https://api.equinix.com/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
                    "uuid": "89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
                    "type": "XF_ROUTER",
                    "name": "FCR-NAME",
                    "state": "PROVISIONING"
                },
                "auth": {
                    "type": "user",
                    "id": "12345",
                    "name": "user1 user1",
                    "email": "user1@test.com"
                }
            }
        }
    ]
}

イベントを検索​

Cloud Eventsでアセットを検索するには、エンドポイントにリクエストを/fabric/v4/cloudevents/search送信する。POSTリクエストの本文に検索条件を指定する。

cURLリクエストの例：

curl -X POST 'https://api.equinix.com/fabric/v4/cloudevents/search' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $TOKEN' \
-d '{
    "filter": {
        "and": [
            {
                "property": "/type",
                "operator": "IN",
                "values": [
                    "equinix.network_edge.device.*"
                ]
            },
            {
                "property": "/subject",
                "operator": "IN",
                "values": [
                    "/ne/v1/devices/903bb0ad-65cd-422c-94d3-a506cce0a36a*"
                ]
            },
            {
                "property": "/time",
                "operator": "BETWEEN",
                "values": [
                    "2025-08-15T17:31:00.000Z",
                    "2025-08-25T17:31:00.000Z"
                ]
            }
        ]
    },
    "pagination": {
        "offset": 0,
        "limit": 20
    }
}'

検索可能なパラメータの完全なリストはAPIリファレンスにある。

応答の例：

{
    "pagination": {
        "offset": 0,
        "limit": 20,
        "total": 2
    },
    "data": [
        {
            "specversion": "1.0",
            "source": "https://api.equinix.com/fabric/v4/cloudevents",
            "id": "54ebab18-5e38-46bf-af00-cdbd0bbf7207",
            "time": "2025-08-27T20:18:47.300Z",
            "type": "equinix.network_edge.device.attribute.changed",
            "subject": "/ne/v1/devices/903bb0ad-65cd-422c-94d3-a506cce0a36a",
            "datacontenttype": "application/json",
            "severitynumber": "9",
            "severitytext": "INFO",
            "equinixproject": "4565754-1e33-4dfd-b7c8-0383259cf754",
            "authtype": "user",
            "authid": "132343",
            "data": {
                "message": "Device Name changed to New-device",
                "resource": {
                    "name": "Network-edge device",
                    "status": "PROVISIONED",
                    "uuid": "df23bb0ad-65cd-422c-94d3-a506cce0a36a",
                    "type": "DEVICE"
                },
                "authcontext": {
                    "type": "user",
                    "id": "132343",
                    "name": "Test User",
                    "email": "user@test.com"
                }
            }
        },
        {
            "specversion": "1.0",
            "source": "https://api.equinix.com/fabric/v4/cloudevents",
            "id": "71ab91ec-ef19-4def-85f3-1fcac99681c4",
            "time": "2025-08-14T19:12:04.726Z",
            "type": "equinix.network_edge.device.state.provisioned",
            "subject": "/ne/v1/devices/903bb0ad-65cd-422c-94d3-a506cce0a36a",
            "datacontenttype": "application/json",
            "severitynumber": "9",
            "severitytext": "INFO",
            "equinixproject": "4565754-1e33-4dfd-b7c8-0383259cf754",
            "authtype": "system",
            "authid": "equinix",
            "data": {
                "message": "Device status changed",
                "resource": {
                    "name": "Network-edge device",
                    "status": "PROVISIONED",
                    "uuid": "903bb0ad-65cd-422c-94d3-a506cce0a36a",
                    "type": "DEVICE"
                },
                "authcontext": {
                    "type": "user",
                    "id": "132343",
                    "name": "Test User",
                    "email": "user@test.com"
                }
            }
        }

    ]
}

イベントの詳細を取得​

指定したCloud Eventの詳細を取得するには、エンドポイントにリクエストを/fabric/v4/cloudevents/<cloudEventId>送信する。GET

cURLリクエストの例：

curl -X GET 'https://api.equinix.com/fabric/v4/cloudevents/<cloudEventId>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

応答の例：

{
    "specversion": "1.0",
    "source": "https://api.equinix.com/fabric/v4/events",
    "id": "a6dc56f2-af4e-40c0-9910-4850459f8559",
    "time": "2025-04-30T01:43:11Z",
    "type": "equinix.fabric.router.state.deprovisioning",
    "subject": "/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
    "dataschema": "https://equinix.github.io/equinix-cloudevents/jsonschema/equinix/fabric/v1/ChangeEvent.json",
    "datacontenttype": "application/json",
    "severitynumber": "9",
    "severitytext": "INFO",
    "equinixproject": "<projectId>",
    "authtype": "user",
    "authid": "12345",
    "data": {
        "message": "router named FCR-NAME state changed to deprovisioning",
        "resource": {
            "href": "https://api.equinix.com/fabric/v4/routers/89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
            "uuid": "89b6af8b-21b9-4e20-ab88-2e6e89b68e1d",
            "type": "XF_ROUTER",
            "name": "FCR-NAME",
            "state": "DEPROVISIONING"
        },
        "auth": {
            "type": "user",
            "id": "12345",
            "name": "user1 user1",
            "email": "user1@test.com"
        }
    }
}

シンクインテグレーションでイベントを受信する​

ストリームを作成し、そのストリームにアセットを追加したら、ストリームをサブスクライブすることで、選択したサードパーティのデータコレクターにイベントを送信するサブスクリプションを作成できる。

サブスクリプションを作成すると、シンクはイベントが発生するたびにイベントを受け取る。

たとえば、プロジェクトをストリームに添付した場合、アセットを作成または削除するたびに、プロジェクト内のサポートされているすべてのアセットのアセットライフサイクルイベントを表示できる。

カスタマーポータルにサインインして、ポート、接続、サービストークン、ネットワークなどを作成すると、シンクがイベントを受信した場合：

{ [-]
    _source: https://api.equinix.com/fabric/v4/cloudevents
    data: { [-]
        message: Router named router-name state changed to provisioning
        resource:[+]
        }
    }
    equinixproject: 377533000114703
    id: d2bb7d5d-3e7b-4638-9023-acdb08cc38a4
    severitynumber: 9
    severitytext: INFO
    subject: /fabric/v4/routers/3cbd8a7f-6878-4492-88a9-1a8be65cc461
    time: 2025-02-04T01:43:45Z
    type: equinix.fabric.router.state.provisioning

Show as raw text
host = http-inputs-<host>.splunkcloud.com
source = Equinix
source = https://api.equinix.com/fabric/v4/cloudevents

別の例として、直接ルーティングプロトコルとBGPルーティングプロトコルで設定されたFCR to Port ConnectionでBGPをイネーブルまたはディセーブルにすると、シンクはイベントを受信する。

購読がアクティブになったら、データコレクターに行き、<name_of_splunk_hec>"を使用して検索できる。この検索では、Splunkによって収集された関連イベントデータが返される。

{ [-]
   _source: https://api.equinix.com/fabric/v4/cloudevents
   equinixmessage: Virtual port status changed to UP
   id: 5345e011-4478-484b-beb4-38c940ff2f9e
   severitynumber: 9
   severitytext: INFO
   subject: /fabric/v4/ports/c4d85dbe-f965-9659-f7e0-306a5c00af26
   time: 2024-07-26T12:31:53.975Z
   type: equinix.fabric.port.status.up
}
Show as raw text
host = http-inputs-equinix-digin.splunkcloud.com
source = Equinix
sourcetype = _json
このページは役に立ちましたか？