例如，GET/objects/networks/{objId} 需要特定对象的 ID。使用 GET/objects/networks 方法获取网络对象列表，然后查找要检查的对象 ID 值。请注意，在这种情况下，GET/object/networks 调用中返回的信息将与您在 GET/objects/network/{objId} 中看到的信息相同。请参阅查找对象 ID (objId) 和父 ID。

• objId - 如果 URL 中需要，则始终需要对象 ID。例如，900fac69-7d19-11e7-bf7b-d9417b20e59e。

• parentId - 父 ID 相当于对象 ID，但仅针对层次结构中较高的父级。例如，GET/policy/intrusion 返回入侵策略列表，而 GET/policy/intrusion/{parentId}/intrusionrules 返回这些策略之一中定义的规则。您将从 GET/policy/intrusion 中获取父 ID。

• 偏移 - 对于支持多个对象的资源，该选项表示从列表的什么位置开始返回对象。默认值 0 表示从列表的开头开始返回对象。

• 限制 - 响应中返回的最大对象数目。默认值为 10。最大限制为 1000；如果您输入了无效的值，则会自动更改为 1000。

• 排序 - 如何对响应中返回的对象进行排序。默认按照名称值的字母顺序排列。要更改排序，请在要排序的资源中输入属性名称。例如，可以在网络对象中使用排序=数值，对数值（即 IP 地址）属性进行排序。要按相反顺序排序，请加入减号，例如排序=-名称。

• 过滤器（并非适用于所有资源）- 仅返回与过滤条件匹配的项目。过滤值的格式为 {key}{operator}{value}，其中 key 为属性名称，value 为要过滤的字符串。项目之间没有空格。您可以过滤的字段在 API Explorer 中 filter 参数的说明中列出；每个对象的字段都不相同。如果对象支持过滤多个字段，可以在 filter 参数上添加多个分号分隔的值。例如，您可以对 GET /policy/intrusionpolicies/{parentId}/intrusionrules 过滤 gid:1;sid:105。允许使用以下运算符：

  • : 表示等于。例如，filter=name:Canada。

  • ! 表示不等于。例如，filter=name!Canada。

  • ~ 表示类似。例如，filter=name~United。

• filter=fts~string（并非适用于所有资源）- 仅返回与过滤条件匹配的项目。fts ~ 选项适用于全文本搜索。会在对象的所有属性中搜索此字符串。您可以包括部分字符串；可以使用星号 * 作为通配符，来匹配一个或多个字符。请勿输入以下字符，因为搜索字符串不支持这些字符：?~!{}<>:%。以下字符将被忽略：;#&。

  例如，您可以使用 GET /object/networks?filter=fts~10 来查找第一个八位组为 10. 的所有网络对象。请注意，系统需要 3-5 秒钟来将新创建或更新的对象添加到索引中，因此您需要先暂停一下，再开始对新增或更改的对象执行全文本搜索。

• filter=fetchZeroHitCount:{true | false}（仅可用于访问规则）- 如果指定 includeHitCounts=true，则可以使用此过滤器选项来纳入 (true) 或排除 (false) 未命中的规则，即命中计数为零的规则。默认值为 true。

• includeHitCounts（仅可用于访问规则）- 是否在策略中包含规则的命中计数信息。指定 includeHitCounts=true 可获取命中计数。指定 false（默认值）可排除命中计数。命中计数信息返回到返回对象的 hitCount 属性中。

• time_duration（仅适用于趋势报告）- 报告应包含过去的多少秒。例如，1800 返回过去 30 分钟的报告。

对于成功的调用（返回代码 200），响应正文包括一个对象或对象列表，具体取决于所进行的调用。有关响应的一般结构和内容的信息，请参阅尝试方法并解释结果。

GET 请求包括一个分页部分。如果对象多于为调用返回的对象，则 prev 值和 next 值指示如何获取上一组或下一组对象。count 值指示对象的总数。limit 值指示响应中返回的项数。offset 值指示返回对象的起始位置，其中 0 表示列表的开头。

"paging": {
    "prev": [],
    "next": [
      "https://ftd.example.com/api/fdm/最新/object/networks?limit=10&offset=10"
    ],
    "limit": 10,
    "offset": 0,
    "count": 22,
    "pages": 0
  }

• parentId - 包含此对象的父对象的 ID。例如，添加 SSL 规则时，SSL 解密策略的 ID。

• at - 插入对象的位置，针对驻留在按照顺序列表安排对象的父对象中的对象，例如 SSL 解密策略。使用整数指示位置，0 为列表的开端。默认将新对象添加到列表的末尾。

点击此框将 JSON 模型加载到 body 参数的“数值”(Value) 列中。例如，点击“POST /object/networks resource”框将加载以下正文：

{
  "name": "string",
  "description": "string",
  "subType": "HOST",
  "value": "string",
  "type": "networkobject"
}

对于枚举值，一定要在响应类 > 模型下读取允许的值。例如，通过填写值并更改子类型的默认值，可以为子网（而不是主机）地址创建一个网络对象：

{
  "name": "new_network_object",
  "description": "A subnet object created using the REST API.",
  "subType": "NETWORK",
  "value": "10.100.10.0/24",
  "type": "networkobject"
}

检查用于更新系统的 curl 命令。请注意附加报头。创建 API 客户端后，还需要纳入这些报头字段和值。例如，以下是创建示例对象的 curl 命令。请注意“内容类型”和“接受”报头。

curl -X POST --header 'Content-Type: application/json' \
   --header 'Accept: application/json' -d '{ \ 
   "name": "new_network_object", \ 
   "description": "A subnet object created using the REST API.", \ 
   "subType": "NETWORK", \ 
   "value": "10.100.10.0/24", \ 
   "type": "networkobject" \ 
 }' 'https://ftd.example.com/api/fdm/最新/object/networks'

在成功的调用中（返回代码 200），响应正文包含创建的完整对象，包括系统生成的其他值，例如 version 和 id 。版本和 ID 尤为重要，因为后续使用 PUT 更改对象时需要提供这类信息。有关响应的一般结构和内容的信息，请参阅尝试方法并解释结果。

响应正文还包括 links/self 值（这是所创建对象的 URL）。例如，以下是示例对象的响应正文。

{
  "version": "f6d8da48-7ed5-11e7-9bfd-d96183b5f5f1",
  "name": "new_network_object",
  "description": "A subnet object created using the REST API.",
  "subType": "NETWORK",
  "value": "10.100.10.0/24",
  "isSystemDefined": false,
  "id": "f6d8da49-7ed5-11e7-9bfd-27136f5686ad",
  "type": "networkobject",
  "links": {
    "self": "https://ftd.example.com/api/fdm/最新/object/networks/
f6d8da49-7ed5-11e7-9bfd-27136f5686ad"
  }
}

• objId - 对象的 id 值。例如，900fac69-7d19-11e7-bf7b-d9417b20e59e。

• parentId - 针对驻留在其他对象中的对象，包含此对象的父对象的 ID。例如，修改 SSL 规则时，SSL 解密策略的 ID。

• at - 插入对象的位置，针对驻留在按照顺序列表安排对象的父对象中的对象，例如 SSL 解密策略。使用整数指示位置，0 为列表的开端。默认将对象添加到列表的末尾。

点击此框将 JSON 模型加载到 body 参数的“数值”(Value) 列中。例如，点击“PUT/object/networks resource”框加载以下正文。请注意，这与同一资源的 POST 版本稍有不同：PUT 正文包括 version 属性。

{
  "version": "string",
  "name": "string",
  "description": "string",
  "subType": "HOST",
  "value": "string",
  "type": "networkobject"
}

一定要复制不希望更改的旧值。

对于枚举值，一定要在响应类 > 模型下读取允许的值。除非要将对象更改为其他子类型，否则请重复旧值。例如，网络对象的默认 PUT 模型具有 subType 的 HOST，但如果要更改子网对象，请确保将 subType 更改为“网络”。

例如，要更新网络对象中的子网 IP 地址，请对除 value 之外的所有属性重复所有旧值。在 value 中输入新的子网地址。

{
  "version": "f6d8da48-7ed5-11e7-9bfd-d96183b5f5f1",
  "name": "new_network_object",
  "description": "A subnet object created using the REST API.",
  "subType": "NETWORK",
  "value": "10.100.11.0/24",
  "type": "networkobject",
}

检查用于更新系统的 curl 命令。请注意附加报头。创建 API 客户端后，还需要纳入这些报头字段和值。例如，以下是用于更新示例对象的 curl 命令。请注意“内容类型”和“接受”报头。

curl -X PUT --header 'Content-Type: application/json' \
--header 'Accept: application/json' -d '{ \ 
   "version": "f6d8da48-7ed5-11e7-9bfd-d96183b5f5f1", \ 
   "name": "new_network_object", \ 
   "description": "A subnet object created using the REST API.", \ 
   "subType": "NETWORK", \ 
   "value": "10.100.11.0/24", \ 
   "type": "networkobject" \ 
 }' 'https://ftd.example.com/api/fdm/最新/object/
networks/f6d8da49-7ed5-11e7-9bfd-27136f5686ad'

对于成功的调用（返回代码 200），响应正文包括已更新的完整对象。请注意，版本值会更改，但对象 ID（以及链接/自身）保持不变。每次修改对象时，版本都会更改。有关响应的一般结构和内容的信息，请参阅尝试方法并解释结果。

例如，以下是用于更新示例对象的响应正文。

{
  "version": "96f5f3cc-7ede-11e7-9bfd-9b7d8a92863f",
  "name": "new_network_object",
  "description": "A subnet object created using the REST API.",
  "subType": "NETWORK",
  "value": "10.100.11.0/24",
  "isSystemDefined": false,
  "id": "f6d8da49-7ed5-11e7-9bfd-27136f5686ad",
  "type": "networkobject",
  "links": {
    "self": "https://ftd.example.com/api/fdm/最新/object/networks/
f6d8da49-7ed5-11e7-9bfd-27136f5686ad"
  }
}

如果该对象位于容器内，您还需要在 parentId 字段输入父对象的 ID。

检查用于从系统中删除对象的 curl 命令。请注意附加报头。创建 API 客户端后，还需要纳入这些报头字段和值。例如，以下是用于删除示例对象的 curl 命令。注意“接受”报头。

curl -X DELETE --header 'Accept: application/json' 
'https://ftd.example.com/api/fdm/最新/object/
networks/f6d8da49-7ed5-11e7-9bfd-27136f5686ad'

对于成功的调用（返回代码 204“无内容”），将得到一个空的响应正文。这是预期结果。