Gestion des flux

Un flux est une entité logique créée via les API Stream Management. Il vous permet d'organiser les données de télémétrie à partir d'actifs partageant le même ensemble d'abonnements.

1. Créer un flux

2. Abonnez-vous au Stream.

3. Joignez des ressources au flux.

4. (Optional) créez des règles d'alerte pour définir des conditions spécifiques pour le déclenchement de notifications ou d'actions en fonction des mesures et des données d'événement.

Limitée

Les flux présentent les limitations suivantes :

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

Conditions préalables

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

• Soumettez vos informations d'identification utilisateur, ID client et secret client pour l'authentification OAuth2. Reportez-vous à authentification API pour plus d'informations sur l'authentification de vos requêtes auprès de l'API Equinix.

Création de flux

Portal

1. Connectez-vous au Portail clients > Fabric Dashboard.

2. Dans le menu observabilité, sélectionnez flux de données.

   

3. Dans les Détails du flux de données, donnez un nom à votre flux. Vous pouvez éventuellement ajouter une description. Le Project ID est automatiquement renseigné avec votre ID de projet actuel. Utilisez Context Switcher pour changer de projet.

   

4. Cliquez sur créer un flux de données.

API

Envoyez une POST demande au /fabric/v4/streamspoint de terminaison pour créer un flux.

Exemple de demande de 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 Portail clients > Fabric Dashboard.

2. Dans le menu observabilité, sélectionnez flux de données.

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

Cliquez sur un nom de flux pour afficher sa 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 GET demande au /fabric/v4/streams/{stream_id}point de terminaison.

Exemple de demande de 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 un nom du flux pour afficher sa page Détails du flux. Dans la liste déroulante actions, cliquez sur Supprimer le flux de données.

Dans la boîte de dialogue de confirmation, cliquez sur Oui, Supprimer.

API

Pour supprimer un flux, envoyez DELETEune demande au /fabric/v4/streams/{stream_id}noeud final. Exemple de demande de 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>'