Verwenden Sie die Django-Weboberfläche, um API-Änderungen vorzunehmen

Machen Sie sich mit der Django-Weboberfläche vertraut.

Die Juniper Mist-API basiert auf einem Django Representational State Transfer (REST)-Framework. Diese Architektur ermöglicht eine durchsuchbare API, was bedeutet, dass Sie direkt über einen Webbrowser mit APIs interagieren können. Diese API ermöglicht eine erhöhte Benutzerfreundlichkeit und Flexibilität, indem sie es Ihnen und anderen Benutzern ermöglicht, CRUD-Vorgänge innerhalb der API auszuführen. In gewisser Weise verhält sich die Django-Schnittstelle wie ein RESTful-Client. Diese Funktion ist praktisch, um CRUD-Vorgänge für ein einzelnes API-Objekt auszuführen.

Um eine Änderung an einem Konfigurationsobjekt vornehmen zu können, müssen Sie beim Juniper Mist-Portal angemeldet sein und den URL-API-Pfad des Objekts kennen. In der API-Dokumentation finden Sie Details und Parameter zum Ändern von Objekten. Sie finden die URL-API-Pfade für alle verfügbaren Objekte.

In dieser Aufgabe erfahren Sie, wie Sie Geräteinformationen von einem Access Point (AP) abrufen und den AP direkt über die Django-Schnittstelle umbenennen.

So verwenden Sie die Django-Weboberfläche, um API-Änderungen vorzunehmen:

Melden Sie sich beim Juniper Mist Portal an.
Öffnen Sie die API-URL für ein bestimmtes Gerät: https://<api-endpoint>/api/v1/sites/<site_id>/devices?name=<Gerätename>. Beim Gerätenamen wird zwischen Groß- und Kleinschreibung unterschieden.

Anmerkung:
Ersetzen Sie bei der Wiederverwendung von Codeblöcken Platzhalterwerte durch tatsächliche Werte, z. B. Ihr API-Token, Ihre Unternehmens-ID, Ihre Standort-ID, Ihren AP-Namen usw.
In diesem Fall sieht die URL wie folgt aus (Teile der site_id werden weggelassen):

https://{api-host}/api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices?name=TEST-rename

Der Browser gibt den folgenden Befehl über die Django-Schnittstelle aus:
Juniper Mist weist jedem Gerät eine eindeutige Kennung zu, die in der Regel auf der MAC-Adresse (00000000-0000-0000-1000-<device_mac>) basiert. Im Kontext der Geräte-API heißt idsie . Sie müssen den AP mit referenzieren id , damit die API weiß, welches Gerät genau umbenannt werden soll.
Um die Änderung vorzunehmen, fügen Sie die Geräte-ID (id) in den API-Aufruf ein und zeigen Sie sie im Browser an.
Der neue Aufruf sieht folgendermaßen aus:
https://api.mist.com/api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices/00000000-0000-0000-1000-5c5b3xxxxxxx
Die Ausgabe ist die gleiche wie bei der vorherigen Anforderung. Der API-Kontext ermöglicht es Ihnen jetzt, eine Änderung an dem spezifischen Gerät vorzunehmen, basierend auf dem id und nicht auf dem Namen. Beachten Sie das Fehlen von einschließenden "[ ]"-Klammern.
Geben Sie den JSON-formatierten Text (JavaScript Object Notation) für den beabsichtigten AP-Umbenennungsaufruf in das Eingabefeld Inhalt ein. Sie müssen die eindeutige Geräte-ID ()id nicht angeben, da der id Kontext in der URL vorhanden ist.

Wenn Sie fertig sind, drücken Sie diese TastePUT, um die Anforderung an Juniper Mist zu senden. Die Ergebnisse sollten wie folgt aussehen, um anzuzeigen, dass der AP umbenannt wurde:

Weitere Informationen finden Sie im Abschnitt "Site" der Website für die API-Dokumentation.

Verwenden Sie die Django-Weboberfläche, um API-Änderungen vorzunehmen

Zugehörige Dokumentation