Skip to content

保存的过滤器

在NetBox中对对象列表进行过滤时,用户可以保存应用的过滤器以供将来使用。这对于涉及多个离散过滤器的复杂过滤策略非常方便。例如,您可能希望找到特定区域内所有计划中的设备,并且这些设备具有特定的平台。一旦将所需的过滤器应用于对象列表,只需创建一个具有名称和可选描述的保存的过滤器。然后,这个过滤器可以直接用于未来的查询,通过UI和REST API都可以使用。

字段

名称

过滤器的人类友好名称。

Slug

在应用过程中将引用此过滤器的唯一标识符(例如?filter=my-slug)。

用户

拥有此过滤器的用户。通过UI创建保存的过滤器时,当前用户将自动分配,不能更改。

权重

用于覆盖按名称对过滤器按字母顺序排序的数值权重。具有较低权重的保存过滤器将在具有较高权重的过滤器之前列出。

启用

确定此过滤器是否可用。禁用的过滤器不会出现在UI中的选项中,但它们将包含在API结果中。

共享

确定此过滤器是否供所有用户或仅供其所有者使用。请注意,禁用此字段不会隐藏过滤器,使其对其他用户不可见;它只是在UI对象列表视图的可用过滤器列表中排除。

参数

在过滤器处于活动状态时要应用的查询参数。必须将它们指定为JSON数据。例如,URL查询字符串

?status=active&region_id=51&tag=alpha&tag=bravo

在JSON中表示为

{
  "tag": ["alpha", "bravo"],
  "status": "active",
  "region_id": 51
}