AUF DIESER SEITE
API mit Wired Assurance
Es gibt hauptsächlich drei Haupt-URI-Endpunkte, die in Bezug auf Wired Assurance von Interesse sind:
-
Netzwerkvorlagen
-
Website-Einstellungen
-
Switch-Einstellungen
Netzwerkvorlagen
Die Dokumentation befindet sich hier direkt unter RF-Vorlagen: https://api.mist.com/api/v1/docs/Org#rf-template
-
Netzwerkvorlage erstellen
-
BEITRAG: https://api.mist.com/api/v1/orgs/:org_id/networktemplates
-
Nutzlast: JSON-formatierte Nutzlast
-
Erforderlich: Name
-
-
Liste der Netzwerkvorlagen abrufen
-
GET: /api/v1/orgs/:org_id/networktemplates
-
Nutzlast: Keine
-
Filter: id, name
-
-
Netzwerkvorlage abrufen
-
GET: /api/v1/orgs/:org_id/networktemplates/:networktemplate_id
-
Nutzlast: Keine
-
-
Netzwerkvorlage aktualisieren
- PUT: /api/v1/orgs/:org_id/networktemplates/:networktemplate_id
- Nutzlast: JSON-formatierte Nutzlast (nur Änderungen/Ergänzungen erforderlich)
-
Netzwerkvorlage löschen
- LÖSCHEN: /api/v1/orgs/:org_id/networktemplates/:networktemplate_id
- Nutzlast: Keine
Website-Einstellungen
Die Dokumentation finden Sie hier: https://api.mist.com/api/v1/docs/Site#site-setting
-
Abrufen von Websiteeinstellungen
*Umfasst sowohl schaltende als auch nicht schaltende Einstellungen*
- GET: /api/v1/sites/:site_id/setting
- Nutzlast: Keine
- Aktualisieren der Site-Einstellungen:
- PUT: /api/v1/sites/:site_id/setting
- Nutzlast: JSON-formatierte Nutzlast (nur Änderungen/Ergänzungen erforderlich)
- Um diese Site mit einer Vorlage zu verknüpfen, fügen Sie den Schlüssel "networktemplate_id" mit dem Wert der ID für die anzuwendende Netzwerkvorlage hinzu.
- Hinweis: Es gibt kein POST oder DELETE für Site-Einstellungen. Die einzige Möglichkeit, Websiteeinstellungen zu erstellen, besteht darin, eine neue Website zu erstellen, und die einzige aktuelle Möglichkeit, sie zu löschen, besteht darin, die Website zu löschen.
Switch-Einstellungen
Switch-Einstellungen
Die Dokumentation finden Sie hier: https://api.mist.com/api/v1/docs/Site#device
- Abrufen der Switch-Einstellungen:
- GET: /api/v1/sites/:site_id/devices/:d evice_id
- Nutzlast: Keine
- Switch-Einstellungen aktualisieren:
- PUT: /api/v1/sites/:site_id/devices/:d evice_id
- Nutzlast: JSON-formatierte Nutzlast (nur Änderungen/Ergänzungen erforderlich)
- Zurücksetzen der Schaltereinstellungen:
- POST: /api/v1/sites/:site_id/devices/:d evice_id
- Nutzlast: Keine oder JSON
- Dadurch wird die in den Switch-Einstellungen definierte Konfiguration effektiv gelöscht und entweder durch nichts oder durch das ersetzt, was in der Nutzlast übergeben wird. Ideal, wenn Sie es vermasselt haben und die Einstellungen zurücksetzen müssen, bevor Sie sie neu konfigurieren.
- HINWEIS: Dies fehlt derzeit in der API-Dokumentation. Wir arbeiten derzeit daran, es wieder hinzuzufügen. Sie finden es im Django-API-Browser.
-
Abrufen von Switch-Konfigurationsbefehlen:
Dadurch werden die Konfigurationssatzbefehle zurückgegeben, die Mist per Push an den Switch überträgt. Beachten Sie, dass dies nicht die grundlegende Konnektivität (Brownfield-Konfigurations-Snippet oder Greenfield-Konfiguration) umfasst, sondern nur die Einstellungen, die über die Vorlagen-/Standort-/Switch-Konfiguration von Mist übertragen werden.
- GET: /api/v1/sites/:site_id/devices/:d evice_id/config_cmd
- Nutzlast: Keine
- Sehr nützlich sowohl für Brownfield-Bereitstellungen als auch beim Erlernen und Testen von EX in Mist.
API-Anwendungsfälle
Quelle der Wahrheit
Mit der Weiterentwicklung des Netzwerkbetriebs wird die Source of Truth (SoT) zu einem immer wichtigeren Konstrukt. Diese SoTs ermöglichen es uns, zu beschreiben, wie das Netzwerk in einer externen Softwareanwendung konfiguriert werden soll, und diese SoT direkt mit Mist kommunizieren zu lassen, um sie zu konfigurieren.
Die Quelle der Wahrheit kann etwas so Einfaches wie eine Reihe von YAML- oder JSON-Datendateien oder so ausgeklügelte dedizierte Anwendungen wie Netbox oder NSOT sein. Die Konfiguration von Sites und Switches über die API auf der Grundlage von Daten im SoT bietet ein gewisses Maß an Kontrolle und kann die Konfiguration über Standorte und Geräte hinweg konsistent halten.
Serviceorientierte Konfiguration
Das Änderungsmanagement ist ein großer Teil des Netzwerkbetriebs. Manuelle Änderungen sind sowohl fehleranfällig als auch zeitaufwändig. Die Integration des Änderungsmanagements in ITSM-Plattformen wie ServiceNow trägt dazu bei, häufige Änderungsmanagementanforderungen zu vereinfachen, indem Änderungen durch ordnungsgemäße Änderungsmanagementprozesse fließen lassen und der menschliche Fehler bei der Durchführung der Änderungen reduziert wird. Die API für Wired Assurance ermöglicht diese Integrationen zwischen ITSM-Plattformen und der kabelgebundenen Netzwerkkonfiguration.
Anhaltende Bemühungen
Während die API uns einige unmittelbare Möglichkeiten bietet, EX-Switching programmgesteuert zu konfigurieren, schreitet die Arbeit an zusätzlichen Funktionen bereits voran. Zum Beispiel die Automatisierung der Migration von Cisco IOS-Konfigurationen sowie die automatisierte Migration bestehender Juniper EX-Konfigurationen auf die Mist-Plattform unter Verwendung vorhandener Softwarebibliotheken und Open-Source-Tools.