Gestion des flux

Un flux est une entité logique créée via les API de gestion des flux. Il vous permet d'organiser les données de télémétrie provenant d'actifs qui partagent le même ensemble d'abonnements.

1. Créer un flux

2. Veuillez vous abonner au flux.

3. Joignez des ressources au flux.

4. (En option) Créez des règles d'alerte pour définir des conditions spécifiques de déclenchement de notifications ou d'actions basées sur des métriques et des données d'événements.

Limites

Les flux ont les limitations suivantes :

• Il y a une limite de 5 flux par projet.
• Vous ne pouvez rattacher qu'une seule organisation à un flux.
• Vous ne pouvez attacher que 5 actifs de projet à un flux.
• Vous pouvez créer jusqu'à 3 abonnements par flux. Chaque abonnement doit correspondre à un puits différent.
• Vous pouvez joindre 50 actifs par flux.
• Vous pouvez créer jusqu'à 50 règles d'alerte par flux.

Conditions préalables

• Pour créer des flux, vous devez avoir le rôle Fabric Stream Subscription Manager (STREAM_SUBSCRIPTION PERMISSION CREATE AND READ). Contactez l'administrateur de votre entreprise ou l'administrateur IAM pour gérer les accès et les rôles.

• Soumettez vos informations d'identification, votre ID client et votre secret client pour l'authentification OAuth2. Reportez-vous à API Authentication pour plus d'informations sur l'authentification de vos demandes à l'API Equinix.

Création de flux

Portal

1. Connectez-vous au [Customer Portal] (https://portal.equinix.com/fabric) > Fabric Dashboard.

2. Dans le menu Observabilité, sélectionnez Data Streams.

   

3. Dans la section Data Stream Details, donnez un nom à votre flux. Vous pouvez également ajouter une description. L'ID du projet est complété automatiquement par votre ID de projet actuel. Utilisez le Context Switcher pour changer de projet.

   

4. Cliquez sur Create Data Stream.

API

Envoyez une requête POST au point de terminaison /fabric/v4/streams pour créer un Stream.

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

Exemple de réponse :

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

Affichage de vos flux

Portal

1. Connectez-vous au [Customer Portal] (https://portal.equinix.com/fabric) > Fabric Dashboard.

2. Dans le menu Observabilité, sélectionnez Data Streams.

Le tableau répertorie vos flux de données, leur statut, le nombre d'abonnements au flux et le nombre de ressources que vous avez ajoutées au flux.

Cliquez sur le Nom du flux pour afficher la page Détails du flux, qui contient la description de votre flux et le Journal d'activité.

L'onglet Subscriptions contient la Liste des abonnements pour les abonnements à ce flux, et l'onglet Resources contient la Liste des ressources pour les ressources ajoutées à ce flux.

API

Pour obtenir les détails d'un flux, envoyez une requête GET au point de terminaison /fabric/v4/streams/{stream_id}.

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

Exemple de réponse :

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

Suppression de flux

Portal

Pour supprimer un flux, cliquez sur le Nom du flux pour afficher sa page Détails du flux. Dans le menu déroulant Actions, cliquez sur Supprimer le flux de données.

Dans la boîte de confirmation, cliquez sur Yes, Delete.

API

Pour supprimer un flux, envoyez une requête DELETE au point de terminaison /fabric/v4/streams/{stream_id}. Exemple de requête 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>'