本文へスキップ

イベント

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

ストリーミング・ネットワーク・データには、以下のイベント・データが含まれます：

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

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

  • Fabric Cloud Routers - BGP セッション状態、ルート集約状態、ルートフィルター状態のイベント。

  • Network Edge仮想デバイス - アクセス制御リスト（ACL）、デバイス属性、リブート、デバイス・リンク・グループ（DLG）イベント。

  • プロジェクト - プロジェクトのイベントデータには、プロジェクト内のすべてのアセットのライフサイクル状態イベントが含まれます。プロビジョニング、デプロビジョニング、障害など、アセットのステータスが変更されると、イベントが送信されます。ライフサイクル イベントは、次の場合に利用できます：

    • ファブリックポート
    • ネットワークエッジ仮想デバイス
    • Fabric Cloudルーター
    • 精密時間
    • Internet Access
    • 仮想接続 - プロビジョニング／デプロビジョニング・イベント・データは、ポートまたはクラウド・ルーターが A 側の接続で利用できます。障害イベントデータは、ポートからETreeへの接続、クラウドルーターから仮想デバイスへの接続、クラウドルーターからIPWANへの接続では利用できません。

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

  • 企業プロファイル - プロファイル属性、タグ、ライフサイクルイベント。

対応イベントのリストを参照してください。

イベント形式​

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

イベントを見る​

カスタマーポータルでは、以下のイベントを閲覧できます：

  • ファブリックポート
  • Fabric Cloudルーター
  • Precision Timeサービス
  • ポートまたはクラウド・ルーターがa側となる仮想接続。

  1. カスタマーポータル > Fabric Dashboardにサインインします。

  2. ポート・インベントリ］、［ファブリック・クラウド・ルーター・インベントリ］、［精密時間インベントリ］、または［接続インベントリ］に移動します。

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

  4. アセットの詳細ページから_Events_をクリックします。

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

Equinix APIから個々のアセットに関するイベントを取得できます。APIでイベントデータを取得するには、まずストリームを作成し（api-managing-streams.mdx#creating-streams）、そのストリームにアセットをアタッチします（api-managing-assets.mdx）。

メモ

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

GET /fabric/v4/{asset}/{assetId}/cloudeventsとPOST /fabric/v4/cloudevents/search` では、現在のページネーションの上限が 100 に設定されています。

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

イベント情報​

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

サンプル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"
                }
            }
        }
    ]
}

イベントを検索します​

資産のクラウドイベントを検索するには、/fabric/v4/clouddevents/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"
                }
            }
        }

    ]
}

イベントの詳細を見る​

指定したクラウド イベントの詳細を取得するには、/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"
        }
    }
}

シンク統合でのイベントの受信​

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

サブスクリプションを作成](api-managing-subscriptions.mdx#creating-a-subscription)すると、シンクはイベントが発生するたびにイベントを受信します。

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

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

{ [-]
    _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接続で、BGPを有効または無効にした場合、シンクはイベントを受信します。

サブスクリプションがアクティブになったら、データコレクタにアクセスして、 index="<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
このページは役に立ちましたか？