API avec Wired Assurance
Il existe principalement trois principaux points de terminaison d’URI d’intérêt en ce qui concerne Wired Assurance :
-
Modèles réseau
-
Paramètres du site
-
Paramètres du commutateur
Modèles réseau
La documentation se trouve juste en dessous des modèles RF ici : https://api.mist.com/api/v1/docs/Org#rf-template
-
Créer un modèle de réseau
-
POSTE : https://api.mist.com/api/v1/orgs/:org_id/networktemplates
-
Charge utile : charge utile au format JSON
-
Obligatoire : nom
-
-
Obtenir la liste des modèles réseau
-
GET : /api/v1/orgs/ :org_id/networktemplates
-
Charge utile : Aucune
-
Filtres : id, nom
-
-
Obtenir un modèle de réseau
-
GET : /api/v1/orgs/ :org_id/networktemplates/ :networktemplate_id
-
Charge utile : Aucune
-
-
Mettre à jour le modèle de réseau
- PUT : /api/v1/orgs/ :org_id/networktemplates/ :networktemplate_id
- Charge utile : charge utile au format JSON (seules les modifications/ajouts sont nécessaires)
-
Supprimer un modèle de réseau
- SUPPRIMER : /api/v1/orgs/ :org_id/networktemplates/ :networktemplate_id
- Charge utile : Aucune
Paramètres du site
La documentation se trouve ici : https://api.mist.com/api/v1/docs/Site#site-setting
-
Obtenir les paramètres du site
*Comprend les paramètres liés à la commutation et à la non-commutation*
- GET : /api/v1/sites/ :site_id/setting
- Charge utile : Aucune
- Mettre à jour les paramètres du site :
- PUT : /api/v1/sites/ :site_id/setting
- Charge utile : charge utile au format JSON (seules les modifications/ajouts sont nécessaires)
- Pour lier ce site à un modèle, ajoutez la clé « networktemplate_id » avec la valeur de l’ID du modèle de réseau à appliquer.
- Remarque : Il n’y a pas de POST ou de DELETE pour les paramètres du site. La seule façon de créer des paramètres de site est de créer un nouveau site, et la seule façon actuelle de les supprimer est de supprimer le site.
Paramètres du commutateur
Paramètres du commutateur
La documentation se trouve ici : https://api.mist.com/api/v1/docs/Site#device
- Obtenir les paramètres du commutateur :
- GET : /api/v1/sites/ :site_id/devices/:d evice_id
- Charge utile : Aucune
- Mettre à jour les paramètres du commutateur :
- PUT : /api/v1/sites/ :site_id/devices/:d evice_id
- Charge utile : charge utile au format JSON (seules les modifications/ajouts sont nécessaires)
- Réinitialiser les paramètres du commutateur :
- POST : /api/v1/sites/ :site_id/devices/:d evice_id
- Charge utile : Aucune ou JSON
- Cela supprime effectivement la configuration définie dans les paramètres du commutateur et la remplace soit par rien, soit par ce qui est transmis dans la charge utile. Idéal si vous vous êtes trompé et que vous devez réinitialiser les paramètres avant de reconfigurer.
- REMARQUE : cette option est actuellement absente de la documentation de l’API. Nous travaillons actuellement à sa réintégration. Vous pouvez le trouver dans le navigateur de l’API de django.
-
Obtenir les commandes de configuration du commutateur :
Cela renvoie les commandes de l’ensemble de configuration que Mist enverra au commutateur. Notez que cela n’inclut pas la connectivité de base (extrait de configuration Brownfield ou configuration Greenfield), mais uniquement les paramètres envoyés via la configuration Modèle/Site/Commutateur de Mist.
- GET : /api/v1/sites/ :site_id/devices/:d evice_id/config_cmd
- Charge utile : Aucune
- Très utile pour les déploiements sur site existant, ainsi que pour l’apprentissage et les tests d’EX dans Mist.
Cas d’utilisation des API
Source de vérité
À mesure que les opérations réseau évoluent, la source de vérité (SoT) devient un concept de plus en plus important. Ces SoT nous permettent de décrire la configuration du réseau dans une application logicielle externe, puis de les faire communiquer directement avec Mist pour le configurer.
La source de vérité peut être quelque chose d’aussi simple qu’un ensemble de fichiers de données YAML ou JSON ou aussi sophistiqué que des applications dédiées telles que Netbox ou NSOT. La configuration des sites et des commutateurs via l’API basée sur les données du SoT offre un certain niveau de contrôle et permet de maintenir la cohérence de la configuration entre les sites et les appareils.
Configuration orientée services
La gestion des changements occupe une grande place dans les opérations réseau. Les modifications manuelles sont à la fois sujettes aux erreurs et chronophages. L’intégration de la gestion des changements dans des plateformes ITSM telles que ServiceNow permet de simplifier les demandes courantes de gestion des changements en laissant les modifications passer par des processus de gestion des changements appropriés et en réduisant les erreurs humaines lors des modifications. L’API de Wired Assurance permet ces intégrations entre les plates-formes ITSM et la configuration du réseau filaire.
Poursuite des efforts
Bien que l’API nous offre des opportunités immédiates de configurer EX Switching, les travaux sont déjà en cours pour ajouter des fonctionnalités. Par exemple, automatiser la migration des configurations Cisco IOS ainsi que la migration automatisée des configurations Juniper EX existantes vers la plate-forme Mist à l’aide de bibliothèques logicielles et d’outils open source existants.