4.2. 连接项

访问进入点会获得 API 可以使用的资源集合的 link（连接）项和 URI，每个集合都使用关系类型来指定客户端需要的 URI。

表 4.1. 有效的关系类型

关系	描述
`capabilities`	支持的 Red Hat Enterprise Virtualization Manager 能力。
`datacenters`	数据中心
`clusters`	主机集群
`networks`	虚拟网络
`storagedomains`	存储域
`hosts`	主机
`vms`	虚拟机
`disks`	虚拟机磁盘
`templates`	模板
`vmpools`	虚拟机池
`domains`	服务域
`groups`	导入的服务组
`roles`	角色
`users`	用户
`tags`	标签
`events`	事件

图 4.1. API 进入点和 API 访问的资源集合的关系

注意

这个实例中所使用的 URI 只作为演示，服务器实际返回的 URI 的格式会和实例中的 URI 不同。客户端通过进入点指定资源，并使用关系类型访问 URI。

服务器会在 link 项的 href 属性中使用绝对 URI 或绝对路径 ^[3]，所以客户端需要支持这两种形式。

link 项也为特定集合包括了一组 search URI，这些 URI 使用 URI 模板^[4] 来集成搜索查询。URI 模板的目的是接受使用查询参数的自然 HTTP 特征的查询表述。客户端不需要预先知道 URI 的结构，但是需要使用 URI 模板库来访问这些模板。

每个搜索查询 URI 模板都使用关系类型来代表（格式是 "collection/search"）。

表 4.2. 与搜索查询 URI 相关的关系

^[3] The RFC describing Uniform Resource Locator Generic Syntax provides a Collected ABNF for URI that explains the difference between these forms.

^[4] The Internet-Draft describing the format of a URI Template is available at http://tools.ietf.org/html/draft-gregorio-uritemplate-03.

Select Your Language