Gérer les actifs

Pour afficher ou diffuser des données, des métriques et des événements à partir d’une ressource, vous devez d’abord l’associer à un flux. Les ressources suivantes sont prises en charge :

• Ports - utilisation de la bande passante de flux, erreurs et métriques de paquets perdus, événements up/down et événements de cycle de vie.
• Connexions - utilisation de la bande passante de flux, mesures de paquets abandonnés, événements Up/Down et événements de cycle de vie.
• Fabric Cloud Routers - diffusez les événements d'état BGP, les événements d'utilisation des quotas de route et les événements de cycle de vie.
• Périphériques virtuels de périphérie réseau - flux de liste de contrôle d'accès, attribut de périphérique, redémarrage et événements de groupe Device Link.
• Metros - Stream Metro latence Metrics.
• 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 gestion des projets.
• Organisations - pour afficher les événements d'organisation, y compris 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 affectations de rôles, associez une organisation à votre flux. Pour plus d'informations sur les organisations, consultez gestion des organisations.
• Profils d'entreprise - attribut de profil de flux, balise et événements de cycle de vie.

Pour plus d'informations, reportez-vous aux pagesmétriques et événements.

Conditions préalables

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

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

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

• Si vous utilisez l'API, 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.

Association de ressources dans le portail

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

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

   

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

4. Dans le menu déroulant actions, sélectionnez Ajouter des ressources.

   

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 Activer les métriques. Une fois que vous avez sélectionné les ressources souhaitées, cliquez sur Review.

   

7. Examinez la liste des ressources à joindre au flux.

   

8. Cliquez sur Soumettre

Attachement de ressources dans l'API

Pour attacher un port à un flux, envoyez PUTune requête au /fabric/v4/streams/{streamId}/{asset}/{assetId}noeud final.

Reportez-vous aux exemples ci-dessous pour attacher une ressource à un flux pour les ressources prises en charge.

Ports

Exemple de demande de 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 demande de 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

Exemple de demande de 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"
}

Périphériques virtuels Network Edge

Exemple de demande de 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"
}

Zones métropolitaines

Exemple de demande de 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 demande de 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 demande de 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"
}

Profil d’entreprise

Exemple de demande de 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 attachées

Portal

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

Dans la page Stream Details, cliquez sur Resources pour afficher la Resource List.

API

Pour obtenir les détails et l'état des pièces jointes d'une ressource, envoyez une GET demande au fabric/v4/streams/{streamId}/{asset}/{assetId}noeud final.

Exemple de demande de 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 de ressource

Portal

Pour supprimer une ressource d'un flux, sélectionnez le flux dans votre inventaire des flux de données. Dans la page Stream Details, cliquez sur Resources pour afficher la Resource List.

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

API

Pour supprimer une ressource jointe, envoyez DELETEune demande au fabric/v4/streams/{streamId}/{asset}/{assetId}noeud final.

Exemple de demande de 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"
}