Gestion des actifs

Pour afficher ou diffuser des données, des mesures et des événements à partir d'un actif, vous devez d'abord l'attacher à un flux. Les actifs suivants sont pris en charge :

• Ports - utilisation de la bande passante, mesures des erreurs et des paquets abandonnés, événements de montée/descente et événements du cycle de vie.
• Connections - utilisation de la bande passante, mesures des paquets perdus, événements de montée/descente et événements du cycle de vie.
• Fabric Cloud Router - streamer les événements d'état BGP, les événements d'utilisation de quota de route et les événements de cycle de vie.
• Périphériques virtuels de Network Edge - flux d'événements de liste de contrôle d'accès, d'attribut de périphérique, de redémarrage et de groupe de liaison de périphérique.
• Metros - mesure de la latence des réseaux métropolitains.
• Projets - Pour afficher tous les événements de votre projet, y compris les événements de changement d'état et les événements de cycle de vie des actifs de votre projet, attachez un projet à votre flux. Pour plus d'informations sur les projets, consultez Managing Projects.
• Organisations - Pour afficher les événements d'organisation, notamment les événements du cycle de vie des projets et les événements de gestion des identités et des accès tels que les attributions de rôles, attachez une organisation à votre flux. Pour plus d'informations sur les organisations, consultez Managing Organizations.
• Profils d'entreprise - flux d'attributs de profil, de balises et d'événements de cycle de vie.

Pour plus d'informations, consultez les pages Metrics et Events.

Conditions préalables

• Pour attacher des actifs (Port, Connexions, etc.) à un flux, l'utilisateur doit avoir au moins le rôle Viewer sur cet actif.

• Pour attacher des projets à un flux pour les événements de provisionnement du cycle de vie, l'utilisateur doit avoir le rôle Project Admin.

• Pour attacher des organisations à un flux pour l'attribution de rôles, la connexion des utilisateurs et les événements de gestion des ressources, l'utilisateur doit avoir le rôle Org Admin. Pour attacher des organisations à un flux pour l'attribution de rôles, l'utilisateur doit avoir le rôle Org Admin.

• Si vous utilisez l'API, soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour plus d'informations sur l'authentification de vos demandes à l'API Equinix.

Joindre des ressources dans le portail

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

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

   

3. Cliquez sur le Nom du flux auquel vous souhaitez ajouter des ressources.

4. Dans le menu déroulant Actions, sélectionnez Add Resources.

   

5. Utilisez le menu File Directory pour filtrer les types de ressources disponibles.

6. Sélectionnez la ou les ressources spécifiques à ajouter au flux. Les ressources ajoutées envoient des données d'événement et si vous souhaitez également envoyer des métriques, activez la case Enable Metrics (Activer les métriques). Une fois que vous avez sélectionné les ressources souhaitées, cliquez sur Review.

   

7. Veuillez examiner la liste des ressources à joindre au flux.

   

8. Cliquez sur Soumettez.

Joindre des ressources dans l'API

Pour attacher un port à un flux, envoyez une requête PUT au point de terminaison /fabric/v4/streams/{streamId}/{asset}/{assetId}.

Reportez-vous aux exemples ci-dessous pour attacher un bien à un flux pour les biens pris en charge.

Ports

Exemple de requête cURL :

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/ports/<portId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "metricsEnabled": true
}'

Exemple de réponse :

{
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
    "uuid": "dee885d7-a845-4873-8774-f83012e7a",
    "type": "XF_PORT",
    "metricsEnabled": true,
    "attachmentStatus": "ATTACHING"
}

Connexions

Exemple de requête cURL :

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/connections/<connectionId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "metricsEnabled": true
}'

Exemple de réponse :

{
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/connections/dee885d7-a845-4873-8774-f83012e7a",
    "uuid": "dee885d7-a845-4873-8774-f83012e7a",
    "type": "IP_VC",
    "metricsEnabled": true,
    "attachmentStatus": "ATTACHING"
}

Fabric Cloud Router (routeurs)

Exemple de requête cURL :

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/routers/<routerId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "metricsEnabled": false
}'

Exemple de réponse :

{
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/routers/dee885d7-a845-4873-8774-f83012e7a",
    "uuid": "dee885d7-a845-4873-8774-f83012e7a",
    "type": "XF_ROUTER",
    "metricsEnabled": false,
    "attachmentStatus": "ATTACHED"
}

Appareils virtuels Network Edge

Exemple de requête cURL :

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/networkEdgeDevices/<networkEdgeDeviceId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "metricsEnabled": false
}'

Exemple de réponse :

{
    "href": "https://api.equinix.com/fabric/v4/streams/41372e9-79c9-4ef8-b77a-8b8176c2098b4/networkEdgeDevices/e78f71ef-d82d-4fab-947b-7c95d153e362",
    "uuid": "e78f71ef-d82d-4fab-947b-7c95d153e362",
    "type": "VD",
    "metricsEnabled": false,
    "attachmentStatus": "ATTACHED"
}

Métros

Exemple de requête cURL :

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/metros/<metroCode>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "metricsEnabled": true
}'

Exemple de réponse :

{
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/metros/SV",
    "uuid": "SV",
    "type": "XF_METRO",
    "metricsEnabled": true,
    "attachmentStatus": "ATTACHED"
}

Projets

Exemple de requête cURL :

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/projects/<projectId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "includes": ["*"],
    "metricsEnabled": true
}'

Exemple de réponse :

{
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/projects/dee885d7-a845-4873-8774-f83012e7a",
    "uuid": "dee885d7-a845-4873-8774-f83012e7a",
    "type": "PROJECT",
    "metricsEnabled": true ,
    "attachmentStatus": "ATTACHED"
}

Organisations

Exemple de requête cURL :

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/organizations/<organizationId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "includes": ["*"],
    "metricsEnabled": true
}'

Exemple de réponse :

{
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/organizations/dee885d7-a845-4873-8774-f83012e7a",
    "uuid": "dee885d7-a845-4873-8774-f83012e7a",
    "type": "ORGANIZATION",
    "metricsEnabled": true,
    "attachmentStatus": "ATTACHED"
}

Profils d'entreprises

Exemple de requête cURL :

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/companyProfiles/<companyProfileId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "metricsEnabled": false
}'

Exemple de réponse :

{
    "href": "https://api.equinix.com/fabric/v4/streams/41372e9-79c9-4ef8-b77a-8b8176c2098b4/companyProfiles/12345918-3333-2222-1111-12345ae12345",
    "uuid": "12345918-3333-2222-1111-12345ae12345",
    "type": "COMPANY_PROFILE",
    "metricsEnabled": false,
    "attachmentStatus": "ATTACHED"
}

Affichage des ressources jointes

Portal

Pour afficher la liste des ressources que vous avez ajoutées à un flux, sélectionnez ce flux dans votre Inventaire des flux de données.

Sur la page Détails du flux, cliquez sur Ressources pour afficher la Liste des ressources.

API

Pour obtenir les détails et l'état de la pièce jointe d'un actif, envoyez une requête GET au point de terminaison fabric/v4/streams/{streamId}/{asset}/{assetId}.

Exemple de requête cURL :

curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/657400f8-d360-11e9-bb65-2a2ae2dbcce5/ports/757400f8-d360-11e9-bb65-2a2ae2dbcce6' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Exemple de réponse :

{
      "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
      "uuid": "dee885d7-a845-4873-8774-f83012e7a",
      "metricsEnabled": true,
      "attachmentStatus": "ATTACHED"
}

Suppression d'une pièce jointe

Portal

Pour supprimer une ressource d'un flux, sélectionnez le flux dans votre Inventaire des flux de données. Sur la page Détails du flux, cliquez sur Ressources pour afficher la Liste des ressources.

Dans le menu d'options de la ressource, cliquez sur Supprimer la ressource.

API

Pour supprimer une pièce jointe, envoyez une requête DELETE au point de terminaison fabric/v4/streams/{streamId}/{asset}/{assetId}.

Exemple de requête cURL :

curl -X 'DELETE' 'https://api.equinix.com/fabric/v4/streams/657400f8-d360-11e9-bb65-2a2ae2dbcce5/ports/757400f8-d360-11e9-bb65-2a2ae2dbcce6' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Exemple de réponse :

{
      "href": "https://api.equinix.com/fabric/v4/stream/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
      "uuid": "dee885d7-a845-4873-8774-f83012e7a",
      "metricsEnabled": true,
      "attachmentStatus": "DETACHING"
}