熟悉 Django Web 界面。
瞻博网络 Mist API 基于 Django 表述性状态转移 (REST) 框架构建。此架构允许可浏览的 API,这意味着您可以直接从 Web 浏览器与 API 进行交互。此 API 使您和其他用户能够在 API 内执行 CRUD作,从而提高可用性和灵活性。从某种意义上说,Django 接口就像一个 RESTful 客户端。此函数对于在单个 API 对象上执行 CRUD作非常方便。
要对配置对象进行更改,您必须登录到瞻博网络 Mist 门户并知道该对象的 URL API 路径。有关更改对象的详细信息和参数,请参阅 API 文档 。您将找到所有可用对象的 URL API 路径。
此任务将引导您了解如何从接入点(接入点)获取设备信息并直接从 Django 界面重命名接入点。
要使用 Django Web 界面进行 API 更改:
- 登录瞻博网络 Mist 门户。
- 打开特定设备的 API URL:https://<api-端点>/api/v1/sites/<site_id>/devices?name=<device name>。设备名称区分大小写。
注意:
重复使用代码块时,请将占位符值替换为实际值,例如 API 令牌、组织 ID、站点 ID、接入点名称等。
在这种情况下,URL 将如下所示(省略部分site_id):
https://{api-host}/api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices?name=TEST-rename
浏览器通过 Django 界面发出以下命令:
GET /api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices?name=TEST-rename
瞻博网络 Mist 为每台设备分配一个唯一标识符,该标识符通常基于MAC 地址 (00000000-0000-0000-1000-<device_mac>)。在设备 API 的上下文中,它称为 id。您需要引用 id 接入点,以便 API 知道要重命名的特定设备。
- 要进行更改,请在 API 调用中插入设备 ID (
id) 并将其显示在浏览器中。
新通话将如下所示:
https://{api-host}/api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices/00000000-0000-0000-1000-5c5b3xxxxxxx
输出与上一个请求相同;但是,现在,API 上下文使您能够根据而不是
id 名称对特定设备进行更改。请注意缺少将“[ ]”括号。
- 在内容输入框中输入 JavaScript 对象标记 (JSON) 格式的文本,用于预期的接入点重命名调用。无需包含唯一设备 ID (
id),因为id上下文存在于 URL 中。
- 完成后,按
PUT 将请求推送至瞻博网络 Mist。结果应如下所示,表示接入点已重命名:
{
"id": "00000000-0000-0000-1000-5c5b3xxxxxx",
"name": "RENAMED",
"site_id": "c1947558-268d-4d31-xxxx-xxxxxxxxxxxx",
"org_id": "3f12cb79-fb5e-4d4b-xxxx-xxxxxxxxxxxx",
"created_time": 1685989351,
"modified_time": 1686321430,
"map_id": null,
"mac": "5c5b3xxxxxxxx",
"serial": "A07451xxxxxxx",
"model": "AP43",
"hw_rev": "C02",
"type": "ap",
"tag_uuid": "3f12cb79-fb5e-4d4b-xxxx-xxxxxxxxxxxxxx",
"tag_id": 3056xxx,
"evpntopo_id": null,
"deviceprofile_id": null
}
有关更多信息,请参阅 API 文档站点的站点部分。