Saltar al contenido principal

Eventos

Equinix proporciona datos de eventos en el portal del cliente y en el Equinix API para los siguientes activos:

  • Puertos - Eventos del ciclo de vida y eventos de arriba/abajo.
  • Enrutadores en la nube de Fabric: Eventos del ciclo de vida, estado de la sesión de BGP, estado de agregación de rutas y eventos de estado del filtro de rutas.
  • Servicios de Precision Time - Eventos del ciclo de vida
  • Conexiones virtuales - Los datos de eventos de aprovisionamiento/desaprovisionamiento están disponibles para conexiones en las que un puerto o enrutador en la nube es el A-Side. Los datos de eventos de fallo NO están disponibles para las conexiones de puerto a ETree, el router de nube a las conexiones de dispositivo virtual o el router de nube a las conexiones IPWAN.
  • Tokens de servicio - Eventos del ciclo de vida.
  • Perfiles de empresa - atributo de perfil, etiqueta y eventos del ciclo de vida.

Además, los eventos están disponibles a nivel de proyecto y organización.

  • Proyectos - Los datos de eventos del proyecto incluyen eventos de estado del ciclo de vida para todos los activos del proyecto. Cualquier cambio de estado en su activo, incluidos el aprovisionamiento, el desaprovisionamiento y los fallos, provoca que se envíe un evento. Los eventos del ciclo de vida están disponibles a nivel de proyecto para todos los activos anteriores, así como:

    • Acceso a Internet - Eventos del ciclo de vida, eventos de bloque de IP y eventos ASN.
    • Dispositivos virtuales de Network Edge: Eventos del ciclo de vida, lista de control de acceso (ACL), atributo del dispositivo, reinicio y eventos de grupo de enlaces de dispositivos (DLG).
    • Perfil de servicio - Eventos del ciclo de vida.

  • Eventos de organización - Estos eventos provienen del gestor de accesos y del gestor de recursos para informar a los administradores de la organización de los eventos de cambio que se producen dentro de la organización, como añadir o eliminar roles para los usuarios.

nota

También puede transmitir datos de eventos a recopiladores de datos de terceros, que admiten una gama más amplia de tipos de eventos y activos. Consulte la secciónDatos de eventos de streaming.

Ver eventos de activos específicos​

Puede ver o recuperar datos de eventos de activos específicos en el portal del cliente o el Equinix API. Para acceder a los datos de eventos de un activo, debe tener un rol que otorgue read permisos para ese activo.

Puertos​

  1. Inicie sesión en el portal del cliente y vaya a su inventario de puertos .

  2. Seleccione un puerto de la lista.

  3. En la página de detalles del puerto, haga clic en Eventos.

    Captura de pantalla de la pestaña Eventos de un puerto

Cloud Routers​

  1. Inicie sesión en el portal del cliente y vaya a su inventario de Cloud Router .

  2. Seleccione un router en la nube de la lista.

  3. En la página de detalles del router en la nube, haga clic en Eventos.

    Captura de pantalla de la pestaña de eventos de un router

Conexiones​

Los datos de eventos están disponibles para las conexiones virtuales en las que un puerto o enrutador en la nube es el A-Side.

  1. Inicie sesión en el portal del cliente y vaya a su inventario de conexiones .

  2. Seleccione una conexión de la lista

  3. En la página Detalles de la conexión, haga clic en Eventos.

    Captura de pantalla de la pestaña Eventos de una conexión

Precision Time​

  1. Inicie sesión en el portal del cliente y vaya a su inventario de Precision Time .

  2. Seleccione un servicio de hora de precisión de la lista.

  3. En la página de detalles del servicio, haga clic en Eventos.

Tokens de servicio​

Para ver los eventos de un token de servicio, envíe una GET solicitud al /fabric/v4/{asset}/{assetId}/cloudevents punto final. En la ruta:

  • Especifique el asset AS serviceTokens.
  • Especifique assetIDcomo UUID del token de servicio.

Utilice los parámetros opcionales fromDateTime y toDateTime de consulta para limitar sus resultados a un período de tiempo específico.

Ejemplo de solicitud 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>'

Perfiles de empresas​

Para ver los eventos de un perfil de empresa, envíe una GET solicitud al /fabric/v4/{asset}/{assetId}/cloudeventspunto final. En la ruta:

  • Especifique el asset AS companyProfiles.
  • Especifique assetIDcomo UUID del perfil de empresa.

Utilice los parámetros opcionales fromDateTime y toDateTime de consulta para limitar sus resultados a un período de tiempo específico.

Ejemplo de solicitud 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>'

Ver eventos del proyecto​

Los datos de eventos del proyecto incluyen eventos admitidos para todos los activos del proyecto, incluidos:

  • Puertos
  • Cloud Routers
  • Conexiones
  • Servicios de Precision Time
  • Perfiles de empresas
  • Tokens de servicio
  • Dispositivos virtuales
  • Servicios de acceso a Internet
  • Perfiles de servicio

Para ver los eventos de un proyecto, envíe una GET solicitud al /fabric/v4/{asset}/{assetId}/cloudevents punto final. En la ruta:

  • Especifique el asset AS projects.
  • Especifique el assetIDUUID AS del proyecto.

Utilice los parámetros opcionales fromDateTime y toDateTime de consulta para limitar sus resultados a un período de tiempo específico.

Ejemplo de solicitud 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>'

Ver eventos de la organización​

Para ver los eventos de una organización, envíe una GET solicitud al /fabric/v4/{asset}/{assetId}/cloudevents punto final. En la ruta:

  • Especifique el asset AS organizations.
  • Especifique el assetIDUUID AS de la organización.

Utilice los parámetros opcionales fromDateTime y toDateTime de consulta para limitar sus resultados a un período de tiempo específico.

Ejemplo de solicitud 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>'

Buscar eventos​

El Equinix API ofrece la capacidad de buscar datos de eventos para eventos que coincidan con criterios especificados. Actualmente, los tipos de activos admitidos para las llamadas a eventos en la nube son puertos, conexiones, enrutadores, áreas metropolitanas, organizaciones, etc. proyectos, dispositivos virtuales y perfiles de empresa.

Para buscar un activo en Cloud Events, envíe una POST solicitud al /fabric/v4/cloudevents/search punto final. Especifique sus criterios de búsqueda en el cuerpo de la solicitud. Además, el POST /fabric/v4/cloudevents/search punto final requiere que el sujeto tenga un UUID de recursos de primer nivel obligatorio.

Ejemplo de solicitud 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
    }
}'

Hay disponible una lista completa de los parámetros que se pueden buscar en la referencia de API .

Obtener detalles del evento​

Para obtener los detalles de un evento en la nube especificado, envíe una GET solicitud al /fabric/v4/cloudevents/<cloudEventId> punto final.

Ejemplo de solicitud cURL:

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

Transmisión de datos de eventos​

Equinix admite la transmisión de datos de eventos en streaming a una plataforma de recopilación de datos. Para configurar la recopilación de datos:

Para obtener una lista de eventos disponibles, consulte la lista de eventos admitidos . Cada tipo de evento tiene un esquema definido y todos nuestros esquemas y tipos de datos de eventos se publican en el /equinix/equinix-cloudeventsrepositorio de GitHub.

¿Le ha resultado útil esta página?