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 à partir d'équipements 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. (Facultatif) 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 de mesures et de données d'événement.

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 être destiné à un récepteur 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 disposer du Fabric Stream Subscription Managerrôle (AUTORISATION STREAM_SUBSCRIPTION CREATE AND READ). Contactez l'administrateur de votre entreprise ou l'administrateur IAM pour gérer les accès et les rôles.

• Envoyez vos informations d’identification utilisateur, votre identifiant client et votre secret client pour l’authentification OAuth2. Pour plus d'informations sur la manière d'authentifier vos demandes auprès du Equinix API, reportez-vous à la section authentification API.

Création de flux

Portal

1. Connectez-vous au Portail client > Tableau de bord Fabric .

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 également ajouter une description. L'identifiant de projet est automatiquement renseigné avec votre identifiant de projet actuel. Utilisez le sélecteur de contexte pour modifier les projets.

   

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 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 Portail client > Tableau de bord Fabric .

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

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 d'un flux pour afficher sa page Détails du flux, qui contient la description de votre flux et le journal d'activité .

L’onglet abonnements contient la liste d’abonnements pour les abonnements à ce flux, et l’onglet ressources 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}terminal.

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 la liste déroulante actions , cliquez sur Supprimer le flux de données .

Dans le BOX de confirmation, cliquez sur Oui, Supprimer.

API

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