API を使用したデバイスまたはサイトのトラブルシューティング

トラブルシューティング API を使用して、外部ポータルからデバイスやサイトのトラブルシューティングを行うことができます。

トラブルシューティングできるデバイスには、クライアント(有線および無線)、アクセスポイント(AP)、スイッチ、WANエッジが含まれます。APIを使用して、有線、無線、WANの問題についてサイトのトラブルシューティングを行うこともできます。

Marvis APIを使用するには、以下が必要です。

API クエリの詳細は次のとおりです。

デバイスのトラブルシューティングを行うには:

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

デバイスのホスト名またはユーザー名がわかっている場合は、検索API(/clients/search または /devices/search)を使用してMACアドレスを取得します。

また、特定のサイト内のデバイスのトラブルシューティング応答を取得する場合は、 site_id オプションを含めることもできます。特定の期間のトラブルシューティング対応が必要な場合は、 start オプションと end オプションを含めます。
サイトのトラブルシューティングを行うには:

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

また、特定のネットワークの問題(有線、WAN、無線)のトラブルシューティング応答を取得する場合は、 type オプションを含めることもできます。デフォルトのタイプはワイヤレスであることに注意してください。WANまたは有線のみの展開がある場合は、必ずタイプを指定してください。特定の期間のトラブルシューティング対応が必要な場合は、 start オプションと end オプションを含めます。

API クエリは、問題のカテゴリ、理由、説明、推奨事項 (該当する場合) を含むテキストベースの応答を取得します。結果の例を次に示します。

デバイスのトラブルシューティング(ワイヤレスクライアント)

https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?mac=50:xx:xx:xx:xx:c2
デバイスのトラブルシューティング(有線クライアント)

https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?mac=3c:xx:xx:xx:xx:46
サイトのトラブルシューティング(ワイヤレス)

https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?site_id=978c48e6-6ef6-11e6-8bbf-02e208b2d34f
サイトのトラブルシューティング(有線)

https://api.mist.com/api/v1/orgs/9777c1a0-6ef6-11e6-8bbf-02e208b2d34f/troubleshoot?site_id=978c48e6-6ef6-11e6-8bbf-02e208b2d34f&type=wired
サイトのトラブルシューティング(WAN)

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

API ドキュメントを表示するには、 Mist API リファレンスを参照してください。Marvisを使用したトラブルシューティングの詳細については、「組織のトラブルシューティング」を参照してください。