Eventos

Supervise los datos de eventos y actividades específicos de sus activos casi en tiempo real utilizando flujos de eventos.

Los datos de red de streaming incluyen datos de eventos para lo siguiente:

Puertos - eventos arriba/abajo.
Conexiones - arriba/abajo y eventos de cambio de atributo.
Routers Cloud de Fabric - Estado de sesión BGP, estado de agregación de rutas y eventos de estado de filtro de ruta.
Dispositivos virtuales de borde de red: Lista de control de acceso (ACL), atributo de dispositivo, reinicio y eventos de grupo de enlaces de dispositivos (DLG).
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, incluyendo aprovisionamiento, desaprovisionamiento y fallos, da como resultado un evento que se envía. Los eventos del ciclo de vida están disponibles para:
- Puertos de Fabric
- Dispositivos virtuales de Network Edge
- Fabric Cloud Routers
- Precision Time
- Internet Access
- Conexiones virtuales: Los datos de eventos de aprovisionamiento/desaprovisionamiento están disponibles para las conexiones donde un puerto o router de nube es el lado A. Los datos de eventos de fallo NO están disponibles para conexiones de puerto a ETree, router de nube a conexiones de dispositivo virtual o router de nube a conexiones IPWAN.
Eventos de organización: Estos eventos son del administrador de acceso y del administrador de recursos para informar a los administradores de la organización de los eventos de cambio que ocurren dentro de la organización, como agregar o eliminar roles para los usuarios.
Perfiles de la compañía - atributo del perfil, etiqueta, y eventos del ciclo de vida.

Consulte la lista de eventos soportados .

Formato del evento

Nuestros eventos utilizan la especificación CloudEvents para dar formato a todos nuestros datos de eventos. Todos nuestros esquemas de datos de eventos y tipos de datos se publican en el /equinix/equinix-cloudeventsrepositorio de GitHub.

Ver eventos

Puede ver eventos en el Portal del cliente para:

Puertos de Fabric
Fabric Cloud Routers
Servicio de Precision Time
Conexiones virtuales donde un puerto o router de nube es el lado A.

Inicie sesión en el Portal del cliente > Fabric Dashboard.
Navegue a su Inventario de puertos, su Inventario de router de la nube de Fabric, su Inventario de tiempo de precisión o su Inventario de conexiones.
Seleccione un puerto, un router en la nube, un servicio de tiempo de precisión o una conexión virtual.
En la página de detalles del activo, haga clic en Eventos.

Visualización de eventos desde la API

Puede recuperar eventos para activos individuales desde la API de Equinix.

nota

Cada llamada requiere permisos de lectura para el activo. Actualmente, los tipos de activos soportados para llamadas de eventos en la nube son puertos, conexiones, routers, metros, organizaciones, etc. proyectos, dispositivos virtuales y perfiles de empresa.

El límite de paginación actual se establece en 100 para GET /fabric/v4/{asset}/{assetId}/cloudevents y POST /fabric/v4/cloudevents/search.

Además, el POST /fabric/v4/cloudevents/search endpoint requiere que el sujeto tenga un recurso UUID de primer nivel obligatorio.

Consigue eventos

Para obtener los eventos de Cloud para un activo, envía una GET solicitud al /fabric/v4/{asset}/{assetId}/cloudevents endpoint. Especifique el tipo de activo y el ID en la ruta. Utilice los parámetros opcionales fromDateTime y toDateTime de consulta para limitar sus resultados a un período de tiempo específico.

Solicitud de curl de muestra:

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

Respuesta de muestra:

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

Eventos de búsqueda

Para buscar un activo en Cloud Events, envía una POST solicitud al /fabric/v4/cloudevents/search endpoint. Especifique sus criterios de búsqueda en el cuerpo de la solicitud.

Solicitud de curl de muestra:

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

Una lista completa de parámetros de búsqueda está disponible en la API Reference.

Respuesta de muestra:

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

    ]
}

Obtener detalles del evento

Para obtener los detalles de un evento de Cloud específico, envía una GET solicitud al /fabric/v4/cloudevents/<cloudEventId> endpoint.

Solicitud de curl de muestra:

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

Respuesta de muestra:

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

Recepción de eventos en una integración de fregadero

Una vez que haya creado una secuencia y haya agregado activos a esa secuencia, puede crear una suscripción para que los eventos se envíen al recopilador de datos de terceros que elija suscribiéndose a la secuencia.

Una vez que creas una suscripción, tu fregadero recibe eventos cada vez que ocurren.

Por ejemplo, si adjuntó un proyecto a su flujo, puede ver los eventos del ciclo de vida del activo para todos los activos admitidos en su proyecto cada vez que cree o elimine un activo.

Por lo tanto, si inicia sesión en el Portal del cliente y crea un puerto, conexión, token de servicio, red, etc., su fregadero recibe un evento:

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

Otro ejemplo, para su conexión de FCR a puerto configurada con el protocolo de enrutamiento Direct y BGP y que habilite o deshabilite BGP, su sink recibe un evento.

Una vez que tus suscripciones estén activas, puedes ir a tu recopilador de datos y buscar usando index="<name_of_splunk_hec>". Esta búsqueda debe devolver los datos de eventos relevantes recopilados por 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

Formato del evento​

Ver eventos​

Visualización de eventos desde la API​

Consigue eventos​

Eventos de búsqueda​

Obtener detalles del evento​

Recepción de eventos en una integración de fregadero​

Formato del evento

Ver eventos

Visualización de eventos desde la API

Consigue eventos

Eventos de búsqueda

Obtener detalles del evento

Recepción de eventos en una integración de fregadero