Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Verwenden Sie das Django-Webinterface, um API-Änderungen vorzunehmen

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

Die Juniper Mist Systems 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 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 zum Ausführen von CRUD-Operationen für ein einzelnes API-Objekt.

Um eine Änderung an einem Konfigurationsobjekt vorzunehmen, müssen Sie beim Juniper Mist Systems 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.

Diese Aufgabe führt Sie durch das Abrufen von Geräteinformationen von einem Access Point (AP) und das Umbenennen des AP direkt über die Django-Schnittstelle.

So verwenden Sie die Django-Webschnittstelle, um API-Änderungen vorzunehmen:

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

    Ersetzen Sie bei der Wiederverwendung von Codeblöcken Platzhalterwerte durch tatsächliche Werte, z. B. API-Token, Organisations-ID, Standort-ID, AP-Name usw.

    In diesem Fall sieht die URL so 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 Systems weist jedem Gerät eine eindeutige Kennung zu, die in der Regel auf der MAC-Adresse basiert (00000000-0000-0000-1000-<device_mac>). Im Kontext der Geräte-API heißt ides . Sie müssen auf den AP id verweisen, damit die API weiß, welches Gerät umbenannt werden soll.

  3. Um die Änderung vorzunehmen, fügen Sie die Geräte-ID (id) in den API-Aufruf ein und zeigen Sie sie im Browser an.
    Die neue Ausschreibung sieht folgendermaßen aus:

    https://{api-host}/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 jedoch, eine Änderung an dem spezifischen Gerät basierend auf dem id und nicht auf dem Namen vorzunehmen. Beachten Sie das Fehlen von umschließenden "[ ]"-Klammern.
  4. Geben Sie den JSON-formatierten Text (JavaScript Object Notation) in das Eingabefeld Inhalt für den beabsichtigten Umbenennungsaufruf des AP ein. Sie müssen die eindeutige Geräte-ID (id) nicht angeben, da der id Kontext in der URL vorhanden ist.
  5. Wenn Sie fertig sind, drücken Sie die EingabePUT, um sie an Juniper Mist Systems zu senden. Die Ergebnisse sollten wie folgt aussehen und darauf hinweisen, dass der AP umbenannt wurde:

    Weitere Informationen finden Sie im Abschnitt Website der Website der API-Dokumentationswebsite.

Zugehörige Dokumentation