Passer au contenu principal

Événements

Equinix fournit des données sur les événements dans le Portail client et le Equinix API pour les ressources suivantes :

  • Ports - événements de cycle de vie et événements de mise en service/arrêt.
  • Routeurs Fabric Cloud : événements de cycle de vie, état de session BGP, état d'agrégation de routes et événements d'état de filtre de routes.
  • Services Precision Time - événements du cycle de vie
  • 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 défaillance ne sont PAS disponibles pour les connexions Port/etree, ni pour les connexions entre routeur cloud et dispositif virtuel.
  • Jetons de service - événements de cycle de vie.
  • Profils d'entreprise - attributs de profil, balises et événements du cycle de vie.

En outre, des événements sont disponibles au niveau du projet et de l'organisation.

  • Projets - les données d'événement de projet incluent les événements d'état de cycle de vie pour tous les équipements du projet. Tout changement d'état de votre équipement, y compris le provisionnement, le déprovisionnement et les défaillances, entraîne l'envoi d'un événement. Les événements de cycle de vie sont disponibles au niveau du projet pour tous les équipements ci-dessus, ainsi que :

    • Accès à Internet : événements de cycle de vie, événements de blocage IP et événements ASN.
    • Dispositifs virtuels Network Edge : événements de cycle de vie, liste de contrôle d'accès (ACL), attribut de dispositif, redémarrage et événements de groupe de liaison de dispositif (DLG).
    • Profil de service - événements de cycle de vie.

  • É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.

remarque

Vous pouvez également diffuser des données d'événements vers des collecteurs de données tiers qui prennent en charge un plus grand nombre de types d'événements et de ressources. Voir la sectionstreaming Event Data.

Affichage d'événements d'équipement spécifiques​

Vous pouvez afficher ou récupérer les données d'événement pour des équipements spécifiques dans le Portail client ou le Equinix API. Pour accéder aux données d’événement d’un équipement, vous devez disposer d’un rôle qui accorde read des autorisations pour cet équipement.

Ports​

  1. Connectez-vous au Portail client et accédez à votre inventaire de ports .

  2. Sélectionnez un port dans la liste.

  3. Sur la page de détails du port, cliquez sur événements.

    Capture d'écran de l'onglet événements d'un port

Routeurs cloud​

  1. Connectez-vous au Portail client et accédez à votre inventaire de routeurs cloud .

  2. Sélectionnez un routeur cloud dans la liste.

  3. Sur la page de détails du routeur cloud, cliquez sur événements.

    Capture d'écran de l'onglet Events d'un routeur

Connexions​

Les données d'événement sont disponibles pour les connexions virtuelles où un port ou un routeur cloud est le côté a.

  1. Connectez-vous au Portail client et accédez à votre inventaire Connections .

  2. Sélectionnez une connexion dans la liste

  3. Sur la page Détails de la connexion, cliquez sur événements.

    Capture d'écran de l'onglet événements d'une connexion

Precision Time​

  1. Connectez-vous au Portail client et accédez à votre inventaire Precision Time .

  2. Sélectionnez un service Precision Time dans la liste.

  3. Sur la page de détails du service, cliquez sur événements.

Jetons de service​

Pour afficher les événements d'un jeton de service, envoyez GETune demande au /fabric/v4/{asset}/{assetId}/cloudeventspoint final. Dans le chemin :

  • Spécifiez le asset comme serviceTokens.
  • Spécifiez le système assetID comme UUID du jeton de service.

Utilisez les paramètres facultatifs fromDateTime et toDateTime de requête pour limiter vos résultats à une période spécifique.

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

Profils d'entreprise​

Pour afficher les événements d'un profil d'entreprise, envoyez une GET demande au /fabric/v4/{asset}/{assetId}/cloudeventsterminal. Dans le chemin :

  • Spécifiez le asset comme companyProfiles.
  • Spécifiez le assetID comme UUID du profil d'entreprise.

Utilisez les paramètres facultatifs fromDateTime et toDateTime de requête pour limiter vos résultats à une période spécifique.

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

Affichage des événements du projet​

Les données des événements du projet incluent les événements pris en charge pour tous les équipements du projet, notamment :

  • Ports
  • Routeurs cloud
  • Connexions
  • Services de précision horaire
  • Profils d'entreprise
  • Jetons de service
  • Dispositifs virtuels
  • Services d'accès à Internet
  • Profils de service

Pour afficher les événements d'un projet, envoyez une GET demande au /fabric/v4/{asset}/{assetId}/cloudeventsnoeud final. Dans le chemin :

  • Spécifiez le asset comme projects.
  • Spécifiez le assetID comme UUID du projet.

Utilisez les paramètres facultatifs fromDateTime et toDateTime de requête pour limiter vos résultats à une période spécifique.

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

Affichage des événements de l'organisation​

Pour afficher les événements d'une organisation, envoyez une GET demande au /fabric/v4/{asset}/{assetId}/cloudeventspoint final. Dans le chemin :

  • Spécifiez le asset comme organizations.
  • Spécifiez le système assetID comme UUID de l'organisation.

Utilisez les paramètres facultatifs fromDateTime et toDateTime de requête pour limiter vos résultats à une période spécifique.

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

Rechercher des événements​

Le Equinix API permet de rechercher dans les données d'événements des événements correspondant à des critères spécifiés. Actuellement, les types d'équipements pris en charge pour les appels d'événements cloud sont les ports, les connexions, les routeurs, les métros, les organisations, projets, dispositifs virtuels et profils d'entreprise.

Pour rechercher un équipement dans les événements cloud, envoyez une POST demande au /fabric/v4/cloudevents/searchterminal. Indiquez vos critères de recherche dans le corps de la demande. En outre, le POST /fabric/v4/cloudevents/search point final exige que le sujet dispose d'un UUID de ressource de premier niveau obligatoire.

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
    }
}'

La liste complète des paramètres consultables est disponible dans la référence API .

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

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

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>'

Flux de données d'événement​

Equinix prend en charge le streaming des données d'événements vers une plateforme de collecte de données. Pour configurer la collecte de données :

Pour obtenir la liste des événements disponibles, reportez-vous à la liste des événements pris en charge . Chaque type d'événement a un schéma défini et tous nos schémas de données d'événement et types de données sont publiés dans le /equinix/equinix-cloudeventsréférentiel GitHub.

Cette page vous a-t-elle été utile ?