Événements

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

Les données du réseau de diffusion en continu incluent les données d'événements pour les éléments suivants:

Ports - événements de montée/descente.
Connexions - événements de montée/descente et de changement d'attribut.
Routeurs Fabric Cloud - Événements relatifs à l'état de la session BGP, à l'état de l'agrégation des routes et à l'état du filtre de route.
Périphériques virtuels de périphérie de réseau - Événements de liste de contrôle d'accès (ACL), d'attribut de périphérique, de redémarrage et de groupe de liaison de périphériques (DLG).
Projets - Les données d'événements de projet incluent les événements du cycle de vie de toutes les ressources du projet. Tout changement d'état d'une ressource, y compris la mise en service, la mise hors service et les pannes, entraîne l'envoi d'un événement. Les événements du cycle de vie sont disponibles pour:
- Ports Fabric
- Dispositifs virtuels Network Edge
- Routeurs Fabric Cloud
- Heure de précision
- Accès Internet
- Connexions virtuelles: les données d'approvisionnement/déprovisionnement sont disponibles pour les connexions où un port ou un routeur cloud est le côté A. Les données d'échec ne sont PAS disponibles pour les connexions port vers ETree, routeur cloud vers périphérique virtuel ou routeur cloud vers IPWAN.
Événements d'organisation - Ces événements proviennent du gestionnaire d'accès et du gestionnaire de ressources pour informer les administrateurs de l'organisation des événements de changement 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 du cycle de vie.

Consultez la liste des [événements pris en charge.

Format de l'événement

Nos événements utilisent la spécification CloudEvents pour formater toutes nos données événementielles. L'ensemble de nos schémas et types de données événementielles 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
Routeurs Fabric Cloud
Services de précision horaire
Connexions virtuelles où un port ou un routeur infonuagique est le côté A.

Connectez-vous au [Portail client Tableau de bord Fabric.
Accédez à votre Inventaire des ports, à votre Inventaire des routeurs Fabric Cloud, à votre Inventaire de l'heure de précision ou à votre Inventaire des connexions.
Sélectionnez un port, un routeur infonuagique, un service Precision Time ou une connexion virtuelle.
Sur la page de détails de l'actif, cliquez sur Événements.

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

Vous pouvez récupérer les événements relatifs à chaque ressource via l'API Equinix. Pour que les données d'événement soient disponibles dans l'API, vous devez d'abord créer un flux et associer les ressources à ce flux.

remarque

Chaque appel nécessite des autorisations de lecture pour la ressource. Actuellement, les types de ressources pris en charge pour les appels d'événements infonuagiques sont les ports, les connexions, les routeurs, les réseaux métropolitains, les organisations, les projets, les périphériques 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.

De plus, le point de terminaison POST /fabric/v4/cloudevents/search exige que le sujet possède un UUID de ressource de premier niveau obligatoire.

Obtenir des événements

Pour obtenir les événements cloud d'une ressource, envoyez une requête GET au point de terminaison /fabric/v4/{asset}/{assetId}/cloudevents. Précisez le type et l'ID de la ressource dans le chemin. Utilisez les paramètres de requête facultatifs fromDateTime et toDateTime pour affiner les 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 une ressource dans Cloud Events, envoyez une requête POST au point de terminaison /fabric/v4/cloudevents/search. Précisez 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 consultables est disponible dans la Référence API.

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écifique, 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 ressources à 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 en vous abonnant au flux.

Une fois que vous créez un abonnement, votre récepteur reçoit des événements chaque fois qu'ils se produisent.

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

Donc, si 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

Un autre exemple, pour votre connexion FCR vers port configurée avec le protocole de routage direct et BGP et que vous activez ou désactivez BGP, votre récepteur reçoit un événement.

Une fois vos abonnements actifs, vous pouvez accéder à votre collecteur de données et effectuer une recherche à l'aide de l'index="<name_of_splunk_hec> Cette recherche devrait renvoyer les données d'événements pertinentes recueillies 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