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’associer à un flux. Les ressources suivantes sont prises en charge:

Ports : utilisation de la bande passante de flux, mesures des erreurs et des pertes de paquets, événements de montée/descente et événements de cycle de vie.
Connexions : utilisation de la bande passante de flux, mesures des paquets perdus, événements de montée/descente et événements du cycle de vie.
Routeurs Fabric Cloud : diffusez les événements d'état BGP, les événements d'utilisation des quotas de routage et les événements de cycle de vie.
Dispositifs virtuels Network Edge - diffusez la liste de contrôle d'accès, l'attribut du dispositif, le redémarrage et les événements de groupe de liaison de dispositifs.
Interfaces de dispositifs virtuels Network Edge - diffuser les mesures de l'interface de dispositifs virtuels.
Metros - diffusez les mesures de latence des zones métropolitaines.
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, associez un projet à votre flux. Pour obtenir plus d'informations sur les projets, reportez-vous à la rubrique 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 attributions de rôles, associez une organisation à votre flux. Pour plus d'informations sur les organisations, reportez-vous à la rubrique gestion des organisations.
Profils d'entreprise : attribut de profil de flux, balise et événements de cycle de vie.

Pour plus d'informations, consultez les pagesmétriques et événements.

Conditions préalables

Pour associer 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 du cycle de vie, l'utilisateur doit disposer du Project Admin rôle.
Pour associer des organisations à un flux pour des événements d’attribution de rôle, de connexion utilisateur et de gestion des ressources, l’utilisateur doit disposer du Org Admin rôle. Pour associer des organisations à un flux pour l’attribution d’un rôle, l’utilisateur doit disposer du Org Admin rôle.
Si vous utilisez le API, soumettez vos identifiants 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.

Joindre des ressources dans le portail

Connectez-vous au Portail client > Tableau de bord Fabric .
Dans le menu observabilité, sélectionnez flux de données .
Cliquez sur le nom du flux auquel vous souhaitez ajouter des ressources.
Dans le menu déroulant actions , sélectionnez Ajouter des ressources.
Utilisez le menu répertoire de fichiers pour filtrer les types de ressources disponibles.
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 vérifier.
Consultez la liste des ressources à joindre au flux.
Cliquez sur Envoyer.

Joindre des actifs dans l'API

Pour associer un port à un flux, envoyez PUTune demande au /fabric/v4/streams/{streamId}/{asset}/{assetId}point final.

Reportez-vous aux exemples ci-dessous pour joindre une ressource à un flux pour les ressources prises 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"
}

Routeurs Fabric Cloud

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

Dispositifs virtuels Network Edge

Exemple de requête cURL:

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/devices/<deviceId>' \
-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/devices/e78f71ef-d82d-4fab-947b-7c95d153e362",
    "uuid": "e78f71ef-d82d-4fab-947b-7c95d153e362",
    "type": "VD",
    "metricsEnabled": false,
    "attachmentStatus": "ATTACHED"
}

Interfaces d'appareil Network Edge

Exemple de requête cURL:

curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/devices/<deviceId>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
-d '{
    "metricsEnabled": true,
    "interfaces": [
        {
            "id": 3
        },
        {
            "id": 4
        }
    ]
}'

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'entreprise

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
API

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

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

Capture d'écran de la liste des ressources

Pour obtenir les détails et le statut des pièces jointes d'un actif, envoyez GETune demande au fabric/v4/streams/{streamId}/{asset}/{assetId}terminal.

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
API

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

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

Suppression d'une capture d'écran de ressource

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

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

Conditions préalables​

Joindre des ressources dans le portail​

Joindre des actifs dans l'API​

Ports​

Connexions​

Routeurs Fabric Cloud​

Dispositifs virtuels Network Edge​

Interfaces d'appareil Network Edge​

Métros​

Projets​

Organisations​

Profils d'entreprise​

Affichage des ressources jointes​

Suppression d'une pièce jointe​

Conditions préalables

Joindre des ressources dans le portail

Joindre des actifs dans l'API

Ports

Connexions

Routeurs Fabric Cloud

Dispositifs virtuels Network Edge

Interfaces d'appareil Network Edge

Métros

Projets

Organisations

Profils d'entreprise

Affichage des ressources jointes

Suppression d'une pièce jointe