Skip to main content

É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 réseau de diffusion en continu incluent les données d'événements pour les éléments suivants :

  • Ports - événements haut/bas.

  • Connexions - événements Up/Down et de modification d'attribut.

  • Routeurs Fabric Cloud : événements d'état de session BGP, d'état d'agrégation de routes et d'état de filtre de routes.

  • Périphériques virtuels de périphérie réseau : liste de contrôle d'accès (ACL), attribut de périphérique, redémarrage et événements de groupe de liaison entre périphériques (DLG).

  • Projets - les données d'événement de projet incluent les événements d'état de cycle de vie pour toutes les ressources du projet. Tout changement d'état de votre ressource, y compris le provisionnement, le déprovisionnement et les échecs, entraîne l'envoi d'un événement. Les événements de cycle de vie sont disponibles pour :

    • Ports Fabric
    • Dispositifs virtuels Network Edge
    • Fabric Cloud Router
    • Precision Time
    • Internet Access
    • Connexions virtuelles : les données d'événements de provisionnement/déprovisionnement sont disponibles pour les connexions où un port ou un routeur cloud est le côté A. Les données d'événement de panne NE sont PAS disponibles pour les connexions Port vers etree, routeur cloud vers périphérique virtuel ou routeur cloud vers IPWAN.

  • Événements de l'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 : attribut de profil, balise et événements de cycle de vie.

Reportez-vous à 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 d'événements. Tous nos schémas de données d'événements et types de données sont publiés dans le /equinix/equinix-cloudeventsréférentiel GitHub.

Afficher l'événement​

Vous pouvez afficher les événements dans le Portail clients pour :

  • Ports Fabric
  • Fabric Cloud Router
  • Service Precision Time
  • Connexions virtuelles où un port ou un routeur cloud est le côté A.

  1. Connectez-vous au Portail clients > Tableau de bord Fabric.

  2. Accédez à votre inventaire de ports, votre inventaire de routeurs Cloud Fabric, votre inventaire de temps de précision ou votre inventaire de connexions.

  3. Sélectionnez un port, un routeur cloud, un service Precision Time ou une connexion virtuelle.

  4. Dans la page de détails de la ressource, cliquez sur Evénements.

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

Vous pouvez récupérer des événements pour des ressources individuelles à partir de l'API Equinix.

note

Chaque appel nécessite des autorisations de lecture pour la ressource. 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, projets, périphériques virtuels et profils d'entreprise.

La limite de pagination actuelle est définie sur 100 pour GET /fabric/v4/{asset}/{assetId}/cloudevents et POST /fabric/v4/cloudevents/search.

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

Obtenir des événements​

Pour obtenir les événements Cloud d'une ressource, envoyez une GET demande au /fabric/v4/{asset}/{assetId}/cloudeventsnoeud final. Spécifiez le type de ressource et l'ID dans le chemin. Utilisez les paramètres facultatifs fromDateTime et toDateTime de requête pour limiter vos résultats à une période spécifique.

Exemple de demande de 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 les événements Cloud, envoyez POSTune demande au /fabric/v4/cloudevents/searchnoeud final. Spécifiez vos critères de recherche dans le corps de la demande.

Exemple de demande de 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écifié, envoyez une GET requête au /fabric/v4/cloudevents/<cloudEventId>noeud final.

Exemple de demande de 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 des événements soient envoyés au collecteur de données tiers de votre choix en vous abonnant au flux.

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

Par exemple, si vous avez attaché un projet à votre flux, vous pouvez afficher les événements de 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.

Ainsi, si vous vous connectez au Portail clients et créez un port, une connexion, un jeton de service, un réseau, etc., votre évier 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 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 aller dans votre collecteur de données et effectuer une recherche en utilisant index="<name_of_splunk_hec>". Cette recherche devrait renvoyer les données pertinentes de l'événement 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
Cette page vous a-t-elle été utile ?