Gestión de flujos

Una secuencia es una entidad lógica creada a través de las API de gestión de secuencias. Le permite organizar los datos de telemetría de los 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) Cree 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 flujo. Cada suscripción debe ser para un fregadero 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 rol Fabric Stream Subscription Manager (STREAM_SUBSCRIPTION PERMISSION CREATE AND READ). 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 la API para obtener más información sobre cómo autenticar sus solicitudes a la API de Equinix.

Creación de flujos

Portal

1. Acceda al [Customer Portal > Fabric Dashboard.

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 Identificador del proyecto se rellena automáticamente con su ID de proyecto actual. Utilice el Conmutador de contexto para cambiar de Proyecto.

   

4. Haga clic en Crear flujo de datos.

API

Envíe una solicitud POST al punto final /fabric/v4/streams para crear un Stream.

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. Acceda al [Customer Portal > Fabric Dashboard.

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 flujo para ver su página Detalles del flujo, que contiene la descripción de su flujo y el Registro de actividad.

La pestaña Subscriptions contiene la Lista de suscripciones para las suscripciones a este flujo, y la pestaña Resources contiene la Lista de recursos para los recursos añadidos a este flujo.

API

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

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 un flujo, haga clic en el Nombre del flujo para ver su página Detalles del flujo. En el menú desplegable Acciones, haga clic en Eliminar flujo de datos.

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

API

Para eliminar un flujo, envíe una solicitud DELETE al punto final /fabric/v4/streams/{stream_id}. 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>'