Fehlerbehebung für ein Gerät oder eine Website mithilfe von APIs

Sie können die Fehlerbehebungs-API verwenden, um Fehler bei Geräten und Sites über ein externes Portal zu beheben.

Zu den Geräten, für die Sie eine Fehlerbehebung durchführen können, gehören Clients (kabelgebunden und drahtlos), Access Points (APs), Switches und WAN-Edges. Sie können die APIs auch zur Fehlerbehebung bei Problemen mit kabelgebundenen, drahtlosen und WAN-Verbindungen verwenden.

Um die Marvis-APIs nutzen zu können, müssen Sie über Folgendes verfügen:

• Ein gültiges Beobachter-API-Token.

• Marvis-Abonnement auf Organisationsebene.

• MAC-Adresse des Geräts (wenn Sie eine Fehlerbehebung bei einem Gerät durchführen möchten)

• Site-ID oder Sitename (wenn Sie Fehler bei einer Site beheben möchten)

Hier sind die Details der API-Abfragen:

• So beheben Sie Fehler bei einem Gerät:

  GET /api/v1/orgs/:org_id/troubleshoot?mac=:device_mac

  Wenn Sie den Hostnamen oder Benutzernamen des Geräts kennen, verwenden Sie die Such-API (/clients/search oder /devices/search), um die MAC-Adresse abzurufen.

  Sie können die site_id Option auch einschließen, wenn Sie möchten, dass die Fehlerbehebungsantwort für ein Gerät an einem bestimmten Standort abgerufen wird. Geben Sie die start Optionen und end an, wenn Sie die Fehlerbehebungsreaktion für einen bestimmten Zeitraum durchführen möchten.

• So beheben Sie Fehler bei einer Website:

  GET /api/v1/orgs/:org_id/troubleshoot?site_id=:siteid

  Sie können die Option auch einschließen type , wenn die Fehlerbehebung für ein bestimmtes Netzwerkproblem abgerufen werden soll – kabelgebunden, WAN oder drahtlos. Beachten Sie, dass der Standardtyp drahtlos ist. Wenn Sie nur über eine WAN- oder kabelgebundene Bereitstellung verfügen, stellen Sie sicher, dass Sie den Typ angeben. Geben Sie die start Optionen und end an, wenn Sie die Fehlerbehebungsreaktion für einen bestimmten Zeitraum durchführen möchten.

Die API-Abfrage ruft eine textbasierte Antwort ab, die die Problemkategorie, den Grund, die Beschreibung und (falls zutreffend) enthält. Hier sind einige Beispielergebnisse:

• Fehlerbehebung bei einem Gerät (drahtloser Client)

  https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?mac=50:xx:xx:xx:xx:c2

  

• Fehlerbehebung bei einem Gerät (kabelgebundener Client)

  https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?mac=3c:xx:xx:xx:xx:46

  

• Fehlerbehebung bei einem Standort (drahtlos)

  https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?site_id=978c48e6-6ef6-11e6-8bbf-02e208b2d34f

  

• Fehlerbehebung bei einem Standort (kabelgebunden)

  https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?site_id=978c48e6-6ef6-11e6-8bbf-02e208b2d34f&type=wired

  

• Fehlerbehebung an einem Standort (WAN)

  https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?site_id=978c48e6-6ef6-11e6-8bbf-02e208b2d34f&type=wan

  

Die API-Dokumentation finden Sie in der Mist API-Referenz. Weitere Informationen zur Fehlerbehebung mit Marvis finden Sie unter Fehlerbehebung bei der Organisation.