熟悉 Django Web 界面。
Juniper Mist API 建立在 Django 表述性状态转移 (REST) 框架之上。此体系结构允许使用可浏览的 API,这意味着您可以直接从 Web 浏览器与 API 进行交互。此 API 使您和其他用户能够在 API 中执行 CRUD作,从而提高可用性和灵活性。从某种意义上说,Django 界面就像一个 RESTful 客户端。此函数对于对单个 API 对象执行 CRUD作非常方便。
若要对配置对象进行更改,必须登录到Juniper Mist门户并知道该对象的 URL API 路径。有关更改对象的详细信息和参数,请参阅 API 文档 。您将找到所有可用对象的 URL API 路径。
此任务将指导您完成如何从接入点 (AP) 获取设备信息并直接从 Django 界面重命名 AP。
要使用 Django Web 界面进行 API 更改:
- 登录到 Juniper Mist 门户。
- 打开特定设备的 API URL:https://<api-endpoint>/api/v1/sites/<site_id>/devices?name=<device name>。设备名称区分大小写。
注意:
重复使用代码块时,请将占位符值替换为实际值,例如 API 令牌、组织 ID、站点 ID、AP 名称等。
在本例中,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
Juniper Mist 为每台设备分配一个唯一标识符,该标识符通常基于MAC 地址 (00000000-0000-0000-1000-<device_mac>)。在设备 API 的上下文中,它称为 id。您需要引用 AP id ,以便 API 知道要重命名哪个特定设备。
- 要进行更改,请将设备 ID (
id) 插入到 API 调用中,并在浏览器中显示。
新调用将如下所示:
https://api.mist.com/api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices/00000000-0000-0000-1000-5c5b3xxxxxxx
输出与上一个请求相同;但是,API 上下文现在允许您基于名称
id (而不是名称)对特定设备进行更改。请注意,没有将“[ ]”括起来。
- 在内容输入框中输入预期接入点重命名调用的 JavaScript 对象标记 (JSON) 格式的文本。您不需要包含唯一设备 ID (
id),因为id上下文存在于 URL 中。
- 完成后,按
PUT 将请求推送到Juniper Mist。结果应如下所示,表示 AP 已重命名:
{
"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 文档站点的站点部分。