Evénements

Surveillez les événements spécifiques et les données d'activité de vos actifs en temps quasi réel à l'aide de flux d'événements.

Les données de réseau en continu comprennent des données d'événements pour les éléments suivants :

Ports - événements de montée/descente.
Connexions - événements de changement d'attribut et de montée/descente.
Fabric Cloud Router - Événements relatifs à l'état de la session BGP, à l'état de l'agrégation des routes et à l'état du filtrage des routes.
Périphériques virtuels Network Edge - Liste de contrôle d'accès (ACL), attribut de périphérique, redémarrage et événements DLG (Device Link Group).
Projets - Les données relatives aux événements du projet comprennent les événements relatifs à l'état du cycle de vie de tous les actifs du projet. Tout changement d'état de votre ressource, y compris le provisionnement, le déprovisionnement et les défaillances, entraîne l'envoi d'un événement. Les événements du cycle de vie sont disponibles pour :
- Ports Fabric
- Appareils virtuels Network Edge
- Fabric Cloud Router (routeurs)
- Temps de précision
- Accès à l'internet
- Connexions virtuelles - Les données relatives aux événements de provisionnement/déprovisionnement sont disponibles pour les connexions où un port ou un routeur en nuage est le côté A. Les données relatives aux événements de défaillance ne sont PAS disponibles pour les connexions entre ports et ETree, entre routeurs en nuage et dispositifs virtuels, ou entre routeurs en nuage et IPWAN.
Événements de l'organisation - Ces événements proviennent du gestionnaire d'accès et du gestionnaire de ressources et informent les administrateurs de l'organisation des changements qui se produisent au sein de l'organisation, tels que l'ajout ou la suppression de rôles pour les utilisateurs.
Profils d'entreprise - attributs de profil, balises et événements de cycle de vie.

Reportez-vous à la liste des [événements pris en charge] (https://github.com/equinix/equinix-cloudevents).

Format de l'événement

Nos événements utilisent la spécification CloudEvents pour formater toutes nos données d'événements. Tous nos schémas et types de données d'événements sont publiés dans le dépôt GitHub /equinix/equinix-cloudevents.

Affichage des événements

Vous pouvez consulter les événements dans le portail client pour :

Ports Fabric
Fabric Cloud Router (routeurs)
Services de Precision Time
Connexions virtuelles où un port ou un routeur en nuage est le côté a.

Connectez-vous au [Customer Portal] (http://portal.equinix.com) > Fabric Dashboard.
Naviguez jusqu'à votre Inventaire des ports, votre Inventaire des routeurs de nuages de fibres, votre Inventaire du temps de précision ou votre Inventaire des connexions.
Sélectionnez un port, un routeur cloud, un service Precision Time ou une connexion virtuelle.
Sur la page de détail de l'actif, cliquez sur Events.

Affichage des événements à partir de l'API

Vous pouvez récupérer des événements pour des ressources individuelles à partir de l'API d'Equinix. Pour que les données d'événement soient disponibles dans l'API, vous devez d'abord créer un flux et attacher des actifs à ce flux.

note

Chaque appel nécessite des autorisations de lecture pour le bien. Actuellement, les types d'actifs pris en charge pour les appels d'événements cloud sont les ports, les connexions, les routeurs, les métros, les organisations, les projets, les dispositifs virtuels et les profils d'entreprise.

La limite de pagination actuelle est fixée à 100 pour GET /fabric/v4/{asset}/{assetId}/cloudevents et POST /fabric/v4/cloudevents/search.

En outre, le point de terminaison POST /fabric/v4/cloudevents/search exige que le sujet ait un UUID de ressource de premier niveau obligatoire.

Obtenir des événements

Pour obtenir les événements cloud d'un actif, envoyez une requête GET au point de terminaison /fabric/v4/{asset}/{assetId}/cloudevents. Spécifiez le type et l'identifiant de l'actif dans le chemin d'accès. Utilisez les paramètres de requête facultatifs fromDateTime et toDateTime pour limiter vos résultats à une période spécifique.

Exemple de requête 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>'

Exemple de réponse :

{
    "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"
                }
            }
        }
    ]
}

Rechercher des événements

Pour rechercher les événements cloud d'un actif, envoyez une requête POST au point de terminaison /fabric/v4/cloudevents/search. Spécifiez vos critères de recherche dans le corps de la requête.

Exemple de requête 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
    }
}'

Une liste complète des paramètres de recherche est disponible dans la [Référence API] (/api-catalog/fabricv4/#tag/Cloud-Events/operation/searchCloudEvents).

Exemple de réponse :

{
    "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"
                }
            }
        }

    ]
}

Obtenir les détails de l'événement

Pour obtenir les détails d'un événement cloud spécifié, envoyez une requête GET au point de terminaison /fabric/v4/cloudevents/<cloudEventId>.

Exemple de requête cURL :

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

Exemple de réponse :

{
    "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"
        }
    }
}

Réception d'événements dans une intégration de récepteur

Une fois que vous avez créé un flux et ajouté des actifs à ce flux, vous pouvez créer un abonnement pour que les événements soient envoyés à votre [collecteur de données tiers de votre choix] (integratewithsink.md) en vous abonnant au flux.

Une fois que vous avez [créé un abonnement] (api-managing-subscriptions.mdx#creating-a-subscription), votre puits reçoit des événements chaque fois qu'ils se produisent.

Par exemple, si vous avez associé un projet à votre flux, vous pouvez afficher les événements du cycle de vie de toutes les ressources prises en charge dans votre projet chaque fois que vous créez ou supprimez une ressource.

Ainsi, lorsque vous vous connectez au portail client et créez un port, une connexion, un jeton de service, un réseau, etc., votre récepteur reçoit un événement :

{ [-]
    _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

Autre exemple, pour votre connexion FCR à Port configurée avec Direct et le protocole de routage BGP et si vous activez ou désactivez BGP, votre puits reçoit un événement.

Une fois que vos abonnements sont actifs, vous pouvez vous rendre dans votre collecteur de données et effectuer une recherche en utilisant index="<name_of_splunk_hec>". Cette recherche devrait renvoyer les données d'événements pertinentes collectées par 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

Format de l'événement​

Affichage des événements​

Affichage des événements à partir de l'API​

Obtenir des événements​

Rechercher des événements​

Obtenir les détails de l'événement​

Réception d'événements dans une intégration de récepteur​

Format de l'événement

Affichage des événements

Affichage des événements à partir de l'API

Obtenir des événements

Rechercher des événements

Obtenir les détails de l'événement

Réception d'événements dans une intégration de récepteur