请求结构
请求结构:
请求将作为 HTTPS 请求采用如下所示形式的统一资源标识符 (URI) 发送到 Firepower 管理中心:
https://<management_center_IP_or_name>:<https_port>/<object_URL>/object_UUIDoptions
其中:
-
是 Firepower 管理中心的 IP 地址或完全限定域名<management_center_IP_or_name>
-
是 Firepower 管理中心用于 HTTPS 连接的端口号。此端口始终为 443。<https_port>
-
是所需资源的特定 URL。这些 URL 对于每个资源都是唯一的,如下所示。<object_URL>
-
是随请求一起提供的选项。选项可用于修改输出和过滤结果。options
-
许多 URL 都包含一个或多个必须指定的 UUID。大多数 URI 都包括可以在身份验证令牌中找到的域 UUID。当删除或修改对象时,或请求有关特定对象的信息时,URI 将以对象 UUID 结束。{UUID}
可用的请求方法如下:
-
- 从指定对象检索数据。GET 是只读操作。GET
-
- 将提供的信息添加到指定对象;如果对象不存在,则返回 404 Resource Not Found 错误消息。PUT
注
当前,可使用 PUT 创建新对象,但此功能可能会在以后的版本中被删除。使用 POST 创建新对象,并使用 PUT 修改现有对象。
-
- 使用提供的信息创建对象。POST 操作之后应执行由要创建的 JSON 对象(括在大括号中)组成的负载:POST
{object]
注
您可以使用的最大规则数取决于设备的内存。未设置限制,因为复杂的规则会使用更多内存。有关规则性能和优化准则,请参阅《Firepower 管理中心配置指南》。
-
- 删除指定对象。DELETE
-
- 不支持。PATCH
API 支持几乎所有请求的查询参数。对于 GET 请求,可以使用以下查询参数来控制返回的对象数和分页数:
-
- 这是一个 True/False 值,指示您是获得了列表中某个项目的完整列表还是仅获得了参考。有些字段只有在此标记设为 true 时才会显示。expanded
-
- 指示列表中要开始的位置。offset
-
- 指示要在页面中检索的项目数。limit
API 支持根据请求传递的查询参数进行过滤。可以根据模型中的特定属性来进行过滤。可用于过滤的参数因对象而异,如以下请求所示。