Gestión de flujos

Un flujo es una entidad lógica creada a través de las API de gestión de flujos. Le permite organizar los datos de telemetría de activos que comparten el mismo conjunto de suscripciones.

1. Crear una secuencia

2. Suscríbase al canal.

3. Adjunte activos a la secuencia.

4. (Opcional) Crear reglas de alerta para definir condiciones específicas para activar notificaciones o acciones basadas en métricas y datos de eventos.

Limitaciones

Los flujos tienen las siguientes limitaciones:

• Hay un límite de 5 flujos por proyecto.
• Sólo puede adjuntar una Organización a un Flujo.
• Sólo puede adjuntar 5 activos del Proyecto a un Flujo.
• Puede crear hasta 3 suscripciones por transmisión. Cada suscripción debe ser para un sumidero diferente.
• Puede adjuntar 50 activos por flujo.
• Puede crear hasta 50 reglas de alerta de métricas por flujo.

Requisitos previos

• Para crear flujos, debe tener el Fabric Stream Subscription Managerrol (CREACIÓN Y LECTURA DE PERMISOS STRAM_SUBSCRIPTION). Póngase en contacto con el administrador de su empresa o con el administrador de IAM para gestionar el acceso y los roles.

• Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte Autenticación de API para obtener más información sobre cómo autenticar sus solicitudes en Equinix API.

Creación de flujos

Portal

1. Inicie sesión en el portal del cliente > Panel de control de Fabric .

2. En el menú Observabilidad, seleccione Flujos de datos .

   

3. En los detalles del flujo de datos , dé un nombre a su flujo. Opcionalmente, añada una descripción. El ID del proyecto se rellena automáticamente con su ID de proyecto actual. Utilice el Switcher de contexto para cambiar proyectos.

   

4. Haga clic en Crear flujo de datos .

API

Envíe una POST solicitud al /fabric/v4/streams punto final para crear una transmisión.

Ejemplo de solicitud cURL:

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams' \  
-H 'Content-Type: application/json' \  
-H 'Authorization: Bearer <Bearer Token>' \  
-d '{  
    "type": "TELEMETRY_STREAM",  
    "name": "splunk1",  
    "description": "subscription 1",  
    "project": {
        "projectId": "<projectId>"  
    }  
}'  

Respuesta de muestra:

{  
    "uuid": "241372e9-79c9-4ef8-b77a-8b8176c2098b4",  
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4",  
    "type": "TELEMETRY_STREAM",  
    "name": "splunk1",  
    "description": "subscription 1",  
    "project": {  
        "projectId": "<projectId>"  
    },  
    "enabled": true,  
    "state": "PROVISIONING",  
    "assetsCount": 0,  
    "streamSubscriptionsCount": 0,  
    "changelog": {  
        "createdBy": "testuser",  
        "createdDateTime": "2024-08-12T21:14:17.689103902Z"  
    }  
}

Ver sus transmisiones

Portal

1. Inicie sesión en el portal del cliente > Panel de control de Fabric .

2. En el menú Observabilidad, seleccione Flujos de datos .

La tabla muestra sus flujos de datos, su estado, cuántas suscripciones hay al flujo y cuántos recursos ha añadido al flujo.

Haga clic en un nombre de la transmisión para ver su página de detalles de la transmisión, que contiene la descripción de su transmisión y el registro de actividad .

La pestaña Suscripciones contiene la lista de suscripciones para las suscripciones a esta secuencia, y la pestaña Recursos contiene la lista de recursos para los recursos añadidos a esta secuencia.

API

Para obtener los detalles de una transmisión, envíe una GET solicitud al /fabric/v4/streams/{stream_id} punto final.

Ejemplo de solicitud cURL:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4' \  
-H 'Content-Type: application/json' \  
-H 'Authorization: Bearer <Bearer Token>'

Respuesta de muestra:

{  
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4",
    "uuid": "241372e9-79c9-4ef8-b77a-8b8176c2098b4",  
    "type": "STREAM_SUSBSCRIPTION",  
    "name": "splunk1",  
    "description": "subscription 1",  
    "project": {  
        "projectId": "<projectId>"  
    },  
    "enabled": true,  
    "state": "PROVISIONED",  
    "changelog": {  
        "createdBy": "testuser",  
        "createdDateTime": "2024-08-12T21:14:17.689104Z"  
    }  
}

Borrar flujos

Portal

Para eliminar una secuencia, haga clic en un nombre de la secuencia para ver su página de detalles de la secuencia. En el menú desplegable Acciones, haga clic en Eliminar flujo de datos .

En el BOX de confirmación, haga clic en Sí, Eliminar.

API

Para eliminar una secuencia, envíe una DELETE solicitud al /fabric/v4/streams/{stream_id} punto final. Ejemplo de solicitud cURL:

curl -X 'DELETE' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4' \  
-H 'Content-Type: application/json' \  
-H 'Authorization: Bearer <Bearer Token>'