メインコンテンツに移動

イベント

Equinixは、カスタマーポータルおよびEquinix APIで、以下のアセットのイベントデータを提供します。

  • ポート-ライフサイクルイベントおよびアップ/ダウンイベント。
  • Fabric Cloud Router -ライフサイクルイベント、BGPセッションステータス、ルートアグリゲーション状態、ルートフィルター状態イベント。
  • Precision Timeサービス-ライフサイクルイベント
  • 仮想接続-ポートまたはクラウドルーターがAサイドの接続では、イベントデータのプロビジョニング/プロビジョニング解除を利用できます。ポートからETreeへの接続、クラウドルーターから仮想デバイスへの接続、またはクラウドルーターからIPWANへの接続では、障害イベントデータを利用できません。
  • サービストークン-ライフサイクルイベント。
  • 企業プロファイル - プロファイル属性、タグ、ライフサイクルイベント。

さらに、イベントはプロジェクトおよび組織レベルで利用できます。

  • プロジェクト-プロジェクトイベントデータには、プロジェクト内のすべてのアセットのライフサイクル状態イベントが含まれます。プロビジョニング、プロビジョニング解除、障害など、アセットのステータスが変更されると、イベントが送信されます。ライフサイクルイベントは、上記のすべてのアセットおよび以下について、プロジェクトレベルで利用できます。

    • インターネットアクセス-ライフサイクルイベント、IPブロックイベント、ASNイベント。
    • Network Edge仮想デバイス-ライフサイクルイベント、アクセスコントロールリスト(ACL)、デバイス属性、再起動、およびデバイスリンクグループ(DLG)イベント。
    • サービスプロファイル-ライフサイクルイベント。

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

メモ

イベントデータをサードパーティのデータコレクタにストリーミングすることもできます。サードパーティのデータコレクタは、より広範なイベントタイプとアセットをサポートしています。「ストリーミングイベントデータ」セクションを参照してください。

特定のアセットイベントの表示​

カスタマーポータルまたはEquinix APIで特定のアセットのイベントデータを表示または取得できます。アセットのイベントデータにアクセスするには、そのアセットの権限を付与する役割が必要です。read

ポート​

  1. カスタマーポータルにサインインし、ポートインベントリに移動します。

  2. リストからポートを選択します。

  3. ポートの詳細ページで、イベントをクリックします。

    ![ポートの[イベント]タブのスクリーンショット

クラウドルーター​

  1. カスタマーポータルにサインインし、クラウドルーターインベントリに移動します。

  2. リストからクラウドルーターを選択します。

  3. クラウドルーターの詳細ページで、_イベントを_クリックします。

    ![ルーターの[イベント]タブのスクリーンショット

接続​

イベントデータは、ポートまたはクラウドルーターがAサイドの仮想接続で利用できます。

  1. カスタマーポータルにサインインし、接続インベントリに移動します。

  2. リストから接続を選択

  3. _[接続の詳細]_ページで、[イベント]をクリックします。

    ![接続の[イベント]タブのスクリーンショット

Precision Time​

  1. カスタマーポータルにサインインし、Precision Timeインベントリに移動します。

  2. リストからPrecision Timeサービスを選択します。

  3. サービスの詳細ページで、イベントをクリックします。

サービストークン​

サービストークンのイベントを表示するには、エンドポイントにリクエストを/fabric/v4/{asset}/{assetId}/cloudevents送信します。GET経路内：

  • としてを指定します。asset``serviceTokens
  • サービストークンのUUIDとしてを指定します。assetID

オプションのおよびtoDateTimeクエリパラメータを使用して、fromDateTime結果を特定の期間に絞り込みます。

サンプルcURLリクエスト：

curl -X GET 'https://api.equinix.com/fabric/v4/serviceTokens/<asset_id>/cloudevents?fromDateTime=<date_time>&toDateTime=<date_time>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

会社概要​

会社プロファイルのイベントを表示するには、エンドポイントにリクエストを/fabric/v4/{asset}/{assetId}/cloudevents送信します。GET経路内：

  • としてを指定します。asset``companyProfiles
  • 会社プロファイルのUUIDとしてを指定します。assetID

オプションのおよびtoDateTimeクエリパラメータを使用して、fromDateTime結果を特定の期間に絞り込みます。

サンプルcURLリクエスト：

curl -X GET 'https://api.equinix.com/fabric/v4/companyProfiles/<asset_id>/cloudevents?fromDateTime=<date_time>&toDateTime=<date_time>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

プロジェクトイベントの表示​

プロジェクトイベントデータには、プロジェクト内のすべてのアセットでサポートされているイベントが含まれます。これには以下が含まれます。

  • ポート
  • クラウドルーター
  • 接続
  • Precision Timeサービス
  • 会社概要
  • サービストークン
  • 仮想デバイス
  • インターネットアクセスサービス
  • サービスプロファイル

プロジェクトのイベントを表示するには、エンドポイントにリクエストを/fabric/v4/{asset}/{assetId}/cloudevents送信します。GET経路内：

  • としてを指定します。asset``projects
  • プロジェクトのUUIDとしてを指定します。assetID

オプションのおよびtoDateTimeクエリパラメータを使用して、fromDateTime結果を特定の期間に絞り込みます。

サンプルcURLリクエスト：

curl -X GET 'https://api.equinix.com/fabric/v4/projects/<asset_id>/cloudevents?fromDateTime=<date_time>&toDateTime=<date_time>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

組織イベントの表示​

組織のイベントを表示するには、エンドポイントにリクエストを/fabric/v4/{asset}/{assetId}/cloudevents送信します。GET経路内：

  • としてを指定します。asset``organizations
  • 組織のUUIDとしてを指定します。assetID

オプションのおよびtoDateTimeクエリパラメータを使用して、fromDateTime結果を特定の期間に絞り込みます。

サンプルcURLリクエスト：

curl -X GET 'https://api.equinix.com/fabric/v4/organizations/<asset_id>/cloudevents?fromDateTime=<date_time>&toDateTime=<date_time>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

イベントを検索します​

Equinix APIでは、指定された条件に一致するイベントデータを検索できます。現在、クラウドイベントコールでサポートされているアセットタイプは、ポート、接続、ルーター、都市圏、組織、プロジェクト、仮想デバイス、会社プロファイル。

クラウドイベントでアセットを検索するには、エンドポイントにリクエストを/fabric/v4/cloudevents/search送信します。POSTリクエストの本文で検索条件を指定します。さらに、POST /fabric/v4/cloudevents/searchエンドポイントでは、サブジェクトに必須の第1レベルのリソースUUIDが必要です。

サンプル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リファレンス』を参照してください。

イベントの詳細を見る​

指定されたクラウドイベントの詳細を取得するには、エンドポイントにリクエストを/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>'

ストリーミングイベントデータ​

Equinixは、データ収集プラットフォームへのイベントデータのストリーミングをサポートしています。データ収集を設定するには：

利用可能なイベントのリストについては、サポートされているイベントのリストを参照してください。各イベントタイプには定義されたスキーマがあり、すべてのイベントデータスキーマとデータタイプはGitHubリポジトリで公開されています。/equinix/equinix-cloudevents

このページは役に立ちましたか？