4.2. 链接元素

访问 Entry Point 为 API 公开的所有资源集合提供了 链接 元素和 URI。每个集合都使用关系类型来识别客户端需要的 URI。

表 4.1. 可用的 relationship 类型
关系	Description
`功能`	Red Hat Virtualization Manager 支持的功能。
`DataCenters`	数据中心。
`clusters`	主机集群。
`networks`	虚拟网络.
`storagedomains`	存储域.
`主机`	主机.
`vms`	虚拟机.
`disks`	虚拟磁盘。
`templates`	模板.
`vmpools`	虚拟机池.
`domains`	身份服务域.
`groups`	导入的身份服务组。
`角色`	角色.
`users`	用户。
`tags`	标签。
`events`	事件。

图 4.1. API 入口点和 API 公开的资源集合之间的关系

备注

示例响应中显示的所有 URI 都图示。服务器返回的所有 URI 的格式是不透明。客户端通过入口点 URI 导航到特定资源，并使用关系类型来访问 URI。

服务器选择包含绝对 URI 或绝对路径 ^[3] 在 link 元素的 href 属性中，因此需要客户端来处理其中任何一个形式。

链接 元素还包含特定集合的一组 搜索 URI。这些 URI 使用 URI 模板 ^[4] 集成搜索查询。URI 模板的目的是使用查询参数的自然 HTTP 模式接受搜索表达式。客户端不需要之前了解 URI 结构。因此，客户端应将这些模板视为不透明的，并使用 URI 模板库来访问它们。

每个搜索查询 URI 模板都使用规则 "collection/search" 来标识。

^[3] 描述统一资源查找器通用语法的 RFC 为 URI 提供 Collected ABNF，它解释了这些表单之间的区别。

^[4] 描述 URI 模板格式的 Internet-Draft 位于 http://tools.ietf.org/html/draft-gregorio-uritemplate-03。