Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

使用 Django Web 界面进行 API 更改

瞻博网络 Mist API 基于 Django 具象状态传输 (REST) 框架构建。此体系结构允许使用可浏览的 API。此 API 使您和其他用户能够在 API 中执行 CRUD 操作,从而提高可用性和灵活性。从某种意义上说,Django 接口就像一个 RESTful 客户端。此函数便于对单个 API 对象执行 CRUD 操作。

要对配置对象进行更改,您必须登录到瞻博网络 Mist 门户并知道该对象的 URL API 路径。有关更改对象的详细信息和参数,请参阅 API 文档。您将找到所有可用对象的 URL API 路径。

此任务将引导您了解如何从接入点 (AP) 获取设备信息并直接从 Django 界面重命名 AP。

要使用 Django Web 界面进行 API 更改,请执行以下操作:

  1. 登录瞻博网络 Mist 门户。
  2. 打开特定设备的 API URL:https://<api-endpoint>/api/v1/sites/<site_id>/devices?name=<device name>。设备名称区分大小写。
    注意:

    将占位符替换为正确的 API 终结点、站点 ID 和设备名称。

    在这种情况下,URL 将如下所示(省略部分site_id):

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

    浏览器通过 Django 界面发出以下命令:

    瞻博网络 Mist 为每个设备分配一个唯一标识符,该标识符通常基于 MAC 地址 (00000000-0000-0000-1000-<device_mac>)。在设备 API 的上下文中,它称为 id。您需要使用 引用 id AP,以便 API 知道要重命名哪个特定设备。

  3. 要进行更改,请将设备 ID (id) 插入 API 调用并在浏览器中显示。
    新调用将如下所示:

    https://api.mist.com/api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices/00000000-0000-0000-1000-5c5b3xxxxxxx

    输出与上一个请求相同;但是,API 上下文现在允许您根据 而不是 id 名称对特定设备进行更改。请注意缺少将“[ ]”括起来的括号。
  4. 在内容输入框中输入 JavaScript 对象表示法 (JSON) 格式的文本,用于预期的 AP 重命名呼叫。您不需要包含唯一的设备 ID (id),因为id上下文存在于 URL 中。
  5. 完成后,按将PUT请求推送至瞻博网络 Mist。结果应如下所示,表示 AP 已重命名:

    有关详细信息,请参阅 API 文档站点的“站点”部分。